Welcome to the Onshape forum! Ask questions and join in the discussions about everything Onshape.

**First time visiting? Here are some places to start:**

- Looking for a certain topic? Check out the categories filter or use Search (upper right).
- Need support? Ask a question to our Community Support category.
- Please submit support tickets for bugs but you can request improvements in the Product Feedback category.
- Be respectful, on topic and if you see a problem, Flag it.

If you would like to contact our Community Manager personally, feel free to send a private message or an email.

Options

# "normalize" documentation

brooke_spreen
Member, Developers Posts:

**115**✭✭✭It looks like the documentation for the function "normalize" has been updated recently. I find it rather difficult to interpret.....if I had not used it several times in the past, it would be difficult to figure out which function would give me the Direction of a vector. This could maybe use some clarification? Perhaps "returns Direction" instead of "returns Vector" in the first line of documentation?

Design Engineer | Anerdgy AG

0

## Comments

1,221✭✭✭✭✭115✭✭✭127✭✭✭The normalize function does not give you the "direction" of a vector, a vector is a direction. The resulting vector is in the same direction, but the magnitude is 1 (unitless).

Normalizing is a common mathematical term, just as dot product and cross products are.

Types such as "line" specify direction to differentiate between the two vectors in the definition, one for a point and one for a direction. Both are vectors that could be normalized. Vector is the data type, direction is the purpose.

115✭✭✭is3dDirection (value) predicate

True for a unitless 3D

`Vector`

that is normalized (i.e. has length`1`

)EXAMPLE

1,221✭✭✭✭✭115✭✭✭