Vector3DReadOnly (euclid-core 0.5.1 API)

All Superinterfaces:

Tuple3DReadOnly

All Known Subinterfaces:

Vector3DBasics

All Known Implementing Classes:

Vector3D, Vector3D32
```
public interface Vector3DReadOnly
extends Tuple3DReadOnly
```
Read-only interface for a 3 dimensional vector.
A 3D vector represents a physical quantity with a magnitude and a direction. For instance, it can be used to represent a 3D velocity, force, or translation from one 3D point to another.

Although a point and vector hold onto the same type of information, the distinction is made between them as they represent different geometry objects and are typically not handled the same way:
- a point represents the coordinate of a location in space. A notable difference with a vector is that the distance between two points has a physical meaning. When a point is transformed with a homogeneous transformation matrix, a point's coordinates are susceptible to be scaled, rotated, and translated.
- a vector is not constrained to a location in space. Instead, a vector represents some physical quantity that has a direction and a magnitude such as: a velocity, a force, the translation from one point to another, etc. When a vector is transformed with a homogeneous transformation matrix, its components are susceptible to be scaled and rotated, but never to be translated.

Method Summary

All Methods Instance Methods Default Methods
Modifier and Type	Method and Description
`default double`	`angle(Vector3DReadOnly other)` Calculates and returns the angle in radians from this vector to `other`.
`default double`	`dot(Vector3DReadOnly other)` Calculates and returns the value of the dot product of this vector with `other`.
`default boolean`	`geometricallyEquals(Vector3DReadOnly other, double epsilon)` Tests if `this` and `other` represent the same vector 3D to an `epsilon`.
`default double`	`length()` Calculates and returns the magnitude of this vector.
`default double`	`lengthSquared()` Calculates and returns the square of the magnitude of this vector.

Methods inherited from interface us.ihmc.euclid.tuple3D.interfaces.Tuple3DReadOnly
containsNaN, epsilonEquals, equals, get, get, get, get, get, get, get, getElement, getElement32, getX, getX32, getY, getY32, getZ, getZ32

- Method Detail
  - length
```
default double length()
```
    Calculates and returns the magnitude of this vector.
    length = √(x² + y² + z²)
    
    Returns:
    
    the magnitude of this vector.
  - lengthSquared
```
default double lengthSquared()
```
    Calculates and returns the square of the magnitude of this vector.
    length² = x² + y² + z²
    
    This method is usually preferred over length() when calculation speed matters and knowledge of the actual magnitude does not, i.e. when comparing several vectors by theirs magnitude.
    
    Returns:
    
    the square of the magnitude of this vector.
  - dot
```
default double dot(Vector3DReadOnly other)
```
    Calculates and returns the value of the dot product of this vector with other.
    For instance, the dot product of two vectors p and q is defined as:
    p . q = ∑_i=1:3(p_i * q_i)
    
    Parameters:
    
    other - the other vector used for the dot product. Not modified.
    
    Returns:
    
    the value of the dot product.
  - angle
```
default double angle(Vector3DReadOnly other)
```
    Calculates and returns the angle in radians from this vector to other.
    The computed angle is in the range [0; pi].
    
    Parameters:
    
    other - the other vector used to compute the angle. Not modified.
    
    Returns:
    
    the value of the angle from this vector to other.
  - geometricallyEquals
```
default boolean geometricallyEquals(Vector3DReadOnly other,
                                    double epsilon)
```
    Tests if this and other represent the same vector 3D to an epsilon.
    Two vectors are considered geometrically equal if the length of their difference is less than or equal to epsilon.
    
    Note that this.geometricallyEquals(other, epsilon) == true does not necessarily imply this.epsilonEquals(other, epsilon) and vice versa.
    
    Parameters:
    
    other - the other vector 3D to compare against this. Not modified.
    
    epsilon - the maximum length of the difference vector can be for the two vectors to be considered equal.
    
    Returns:
    
    true if the two vectors represent the same geometry, false otherwise.

Interface Vector3DReadOnly

Method Summary

Methods inherited from interface us.ihmc.euclid.tuple3D.interfaces.Tuple3DReadOnly

Method Detail

length

lengthSquared

dot

angle

geometricallyEquals