us.ihmc.euclid.referenceFrame.interfaces.FrameVector3DReadOnly Maven / Gradle / Ivy

Go to download
package us.ihmc.euclid.referenceFrame.interfaces;

import us.ihmc.euclid.referenceFrame.ReferenceFrame;
import us.ihmc.euclid.tuple3D.interfaces.Vector3DReadOnly;

/**
 * Read-only interface for a 3D vector expressed in a given reference frame.
 * 
 * In addition to representing a {@link Vector3DReadOnly}, a {@link ReferenceFrame} is associated to
 * a {@code FrameVector3DReadOnly}. This allows, for instance, to enforce, at runtime, that
 * operations on vectors occur in the same coordinate system.
 * 
 * 
 * Because a {@code FrameVector3DReadOnly} extends {@code Vector3DReadOnly}, it is compatible with
 * methods only requiring {@code Vector3DReadOnly}. However, these methods do NOT assert that the
 * operation occur in the proper coordinate system. Use this feature carefully and always prefer
 * using methods requiring {@code FrameVector3DReadOnly}.
 * 
 */
public interface FrameVector3DReadOnly extends Vector3DReadOnly, FrameTuple3DReadOnly
{
   /**
    * Calculates and returns the angle in radians from this frame vector to {@code other}.
    * 
    * The computed angle is in the range [0; pi].
    * 
    *
    * @param other the other frame vector used to compute the angle. Not modified.
    * @return the value of the angle from this frame vector to {@code other}.
    */
   default double angle(FrameVector3DReadOnly other)
   {
      checkReferenceFrameMatch(other);
      return Vector3DReadOnly.super.angle(other);
   }
}