add comments

This commit is contained in:
Teodora Iulia Craciun 2026-08-15 23:40:54 +02:00
parent 9f71fa38a2
commit 98b3793446

View File

@ -12,13 +12,13 @@ zero_vector = Vector(0,0)
def main() -> None: def main() -> None:
print("Hello Teodora!") print("Hello Teodora!")
displacement = displacementVector(current_pos, target_pos) # define function displacement displacement = displacementVector(current_pos, target_pos)
print(displacement) print(displacement)
distance = length(displacement) ## define function distance distance = length(displacement)
print(distance) print(distance)
direction = safe_normalize(displacement, 0.001) # define function safe normalisation direction = safe_normalize(displacement, 2) # minimum distance = 0.001
print(direction) print(direction)
@ -30,7 +30,7 @@ def displacementVector(current_pos, target_pos):
return displacementVector return displacementVector
## distance between two positions ## distance between two positions
# Euclidian norm # Euclidian norm measures vector length
def length(vector: Vector) -> float: def length(vector: Vector) -> float:
squared_x = vector.x*vector.x squared_x = vector.x*vector.x
@ -38,7 +38,7 @@ def length(vector: Vector) -> float:
squared_x + squared_y squared_x + squared_y
return math.sqrt(squared_x + squared_y) return math.sqrt(squared_x + squared_y)
# safe normalisation ## safe normalisation (keep the direction while ignoring the distance)
# The minimum-distance check also prevents division by zero. # The minimum-distance check also prevents division by zero.
def safe_normalize(vector: Vector, minimum_distance: float) -> Vector: def safe_normalize(vector: Vector, minimum_distance: float) -> Vector:
@ -47,6 +47,6 @@ def safe_normalize(vector: Vector, minimum_distance: float) -> Vector:
if vector_length < minimum_distance: if vector_length < minimum_distance:
return zero_vector return zero_vector
einheitsVector = Vector(vector.x / vector_length, vector.y / vector_length) einheitsVector = Vector(vector.x / vector_length, vector.y / vector_length) # unit vector
return einheitsVector return einheitsVector