Class TLcdGML31Clothoid

All Implemented Interfaces:
ILcdDataObject, ILcdBounded, ILcdCurve, ILcdShape, ILcdCloneable, ILcdDeepCloneable, ILcdFeatured, ILcdSelfDescribedFeatured, Serializable, Cloneable

public class TLcdGML31Clothoid extends TLcdGML31AbstractCurveSegment
A clothoid, or Cornu's spiral, is plane curve whose curvature is a fixed function of its length. In suitably chosen co-ordinates it is given by Fresnel's integrals. x(t) = 0-integral-t cos(AT*T/2)dT y(t) = 0-integral-t sin(AT*T/2)dT This geometry is mainly used as a transition curve between curves of type straight line to circular arc or circular arc to circular arc. With this curve type it is possible to achieve a C2-continous transition between the above mentioned curve types. One formula for the Clothoid is A*A = R*t where A is constant, R is the varying radius of curvature along the the curve and t is the length along and given in the Fresnel integrals.
Since:
10.0
See Also:
  • Field Details

    • REF_LOCATION_PROPERTY

      public static final TLcdDataProperty REF_LOCATION_PROPERTY
      Data property that maps to the refLocation element. The possible values for this property are instances of RefLocation.
    • SCALE_FACTOR_PROPERTY

      public static final TLcdDataProperty SCALE_FACTOR_PROPERTY
      Data property that maps to the scaleFactor element. The possible values for this property are instances of double.
    • START_PARAMETER_PROPERTY

      public static final TLcdDataProperty START_PARAMETER_PROPERTY
      Data property that maps to the startParameter element. The possible values for this property are instances of double.
    • END_PARAMETER_PROPERTY

      public static final TLcdDataProperty END_PARAMETER_PROPERTY
      Data property that maps to the endParameter element. The possible values for this property are instances of double.
    • NUM_DERIVATIVE_INTERIOR_PROPERTY

      public static final TLcdDataProperty NUM_DERIVATIVE_INTERIOR_PROPERTY
      Data property that maps to the numDerivativeInterior attribute. The possible values for this property are instances of long.
    • NUM_DERIVATIVES_AT_END_PROPERTY

      public static final TLcdDataProperty NUM_DERIVATIVES_AT_END_PROPERTY
      Data property that maps to the numDerivativesAtEnd attribute. The possible values for this property are instances of long.
    • NUM_DERIVATIVES_AT_START_PROPERTY

      public static final TLcdDataProperty NUM_DERIVATIVES_AT_START_PROPERTY
      Data property that maps to the numDerivativesAtStart attribute. The possible values for this property are instances of long.
  • Constructor Details

    • TLcdGML31Clothoid

      public TLcdGML31Clothoid()
    • TLcdGML31Clothoid

      public TLcdGML31Clothoid(TLcdDataType aType)
  • Method Details

    • getRefLocation

      public TLcdGML31Clothoid.RefLocation getRefLocation()
      Returns the value of the property that maps to the refLocation element.
      Returns:
      the value of the REF_LOCATION_PROPERTY property.
    • setRefLocation

      public void setRefLocation(TLcdGML31Clothoid.RefLocation aValue)
      Sets the value of the property that maps to the refLocation element.
      Parameters:
      aValue - the value to set for the REF_LOCATION_PROPERTY property.
    • getScaleFactor

      public double getScaleFactor()
      Returns the value of the property that maps to the scaleFactor element.

      The element gives the value for the constant in the Fresnel's integrals.

      Returns:
      the value of the SCALE_FACTOR_PROPERTY property.
    • setScaleFactor

      public void setScaleFactor(double aValue)
      Sets the value of the property that maps to the scaleFactor element.

      The element gives the value for the constant in the Fresnel's integrals.

      Parameters:
      aValue - the value to set for the SCALE_FACTOR_PROPERTY property.
    • getStartParameter

      public double getStartParameter()
      Returns the value of the property that maps to the startParameter element.

      The startParameter is the arc length distance from the inflection point that will be the start point for this curve segment. This shall be lower limit used in the Fresnel integral and is the value of the constructive parameter of this curve segment at its start point. The startParameter can either be positive or negative. NOTE! If 0.0 (zero), lies between the startParameter and the endParameter of the clothoid, then the curve goes through the clothoid's inflection point, and the direction of its radius of curvature, given by the second derivative vector, changes sides with respect to the tangent vector. The term length distance for the

      Returns:
      the value of the START_PARAMETER_PROPERTY property.
    • setStartParameter

      public void setStartParameter(double aValue)
      Sets the value of the property that maps to the startParameter element.

      The startParameter is the arc length distance from the inflection point that will be the start point for this curve segment. This shall be lower limit used in the Fresnel integral and is the value of the constructive parameter of this curve segment at its start point. The startParameter can either be positive or negative. NOTE! If 0.0 (zero), lies between the startParameter and the endParameter of the clothoid, then the curve goes through the clothoid's inflection point, and the direction of its radius of curvature, given by the second derivative vector, changes sides with respect to the tangent vector. The term length distance for the

      Parameters:
      aValue - the value to set for the START_PARAMETER_PROPERTY property.
    • getEndParameter

      public double getEndParameter()
      Returns the value of the property that maps to the endParameter element.

      The endParameter is the arc length distance from the inflection point that will be the end point for this curve segment. This shall be upper limit used in the Fresnel integral and is the value of the constructive parameter of this curve segment at its start point. The startParameter can either be positive or negative.

      Returns:
      the value of the END_PARAMETER_PROPERTY property.
    • setEndParameter

      public void setEndParameter(double aValue)
      Sets the value of the property that maps to the endParameter element.

      The endParameter is the arc length distance from the inflection point that will be the end point for this curve segment. This shall be upper limit used in the Fresnel integral and is the value of the constructive parameter of this curve segment at its start point. The startParameter can either be positive or negative.

      Parameters:
      aValue - the value to set for the END_PARAMETER_PROPERTY property.
    • getNumDerivativeInterior

      public long getNumDerivativeInterior()
      Returns the value of the property that maps to the numDerivativeInterior attribute.

      The attribute "numDerivativesInterior" specifies the type of continuity that is guaranteed interior to the curve. The default value of "0" means simple continuity, which is a mandatory minimum level of continuity. This level is referred to as "C 0 " in mathematical texts. A value of 1 means that the function and its first derivative are continuous at the appropriate end point: "C 1 " continuity. A value of "n" for any integer means the function and its first n derivatives are continuous: "C n " continuity. NOTE: Use of these values is only appropriate when the basic curve definition is an underdetermined system. For example, line string segments cannot support continuity above C 0 , since there is no spare control parameter to adjust the incoming angle at the end points of the segment. Spline functions on the other hand often have extra degrees of freedom on end segments that allow them to adjust the values of the derivatives to support C 1 or higher continuity.

      Returns:
      the value of the NUM_DERIVATIVE_INTERIOR_PROPERTY property.
    • setNumDerivativeInterior

      public void setNumDerivativeInterior(long aValue)
      Sets the value of the property that maps to the numDerivativeInterior attribute.

      The attribute "numDerivativesInterior" specifies the type of continuity that is guaranteed interior to the curve. The default value of "0" means simple continuity, which is a mandatory minimum level of continuity. This level is referred to as "C 0 " in mathematical texts. A value of 1 means that the function and its first derivative are continuous at the appropriate end point: "C 1 " continuity. A value of "n" for any integer means the function and its first n derivatives are continuous: "C n " continuity. NOTE: Use of these values is only appropriate when the basic curve definition is an underdetermined system. For example, line string segments cannot support continuity above C 0 , since there is no spare control parameter to adjust the incoming angle at the end points of the segment. Spline functions on the other hand often have extra degrees of freedom on end segments that allow them to adjust the values of the derivatives to support C 1 or higher continuity.

      Parameters:
      aValue - the value to set for the NUM_DERIVATIVE_INTERIOR_PROPERTY property.
    • getNumDerivativesAtEnd

      public long getNumDerivativesAtEnd()
      Returns the value of the property that maps to the numDerivativesAtEnd attribute.

      The attribute "numDerivativesAtEnd" specifies the type of continuity between this curve segment and its successor. If this is the last curve segment in the curve, one of these values, as appropriate, is ignored. The default value of "0" means simple continuity, which is a mandatory minimum level of continuity. This level is referred to as "C 0 " in mathematical texts. A value of 1 means that the function and its first derivative are continuous at the appropriate end point: "C 1 " continuity. A value of "n" for any integer means the function and its first n derivatives are continuous: "C n " continuity. NOTE: Use of these values is only appropriate when the basic curve definition is an underdetermined system. For example, line string segments cannot support continuity above C 0 , since there is no spare control parameter to adjust the incoming angle at the end points of the segment. Spline functions on the other hand often have extra degrees of freedom on end segments that allow them to adjust the values of the derivatives to support C 1 or higher continuity.

      Returns:
      the value of the NUM_DERIVATIVES_AT_END_PROPERTY property.
    • setNumDerivativesAtEnd

      public void setNumDerivativesAtEnd(long aValue)
      Sets the value of the property that maps to the numDerivativesAtEnd attribute.

      The attribute "numDerivativesAtEnd" specifies the type of continuity between this curve segment and its successor. If this is the last curve segment in the curve, one of these values, as appropriate, is ignored. The default value of "0" means simple continuity, which is a mandatory minimum level of continuity. This level is referred to as "C 0 " in mathematical texts. A value of 1 means that the function and its first derivative are continuous at the appropriate end point: "C 1 " continuity. A value of "n" for any integer means the function and its first n derivatives are continuous: "C n " continuity. NOTE: Use of these values is only appropriate when the basic curve definition is an underdetermined system. For example, line string segments cannot support continuity above C 0 , since there is no spare control parameter to adjust the incoming angle at the end points of the segment. Spline functions on the other hand often have extra degrees of freedom on end segments that allow them to adjust the values of the derivatives to support C 1 or higher continuity.

      Parameters:
      aValue - the value to set for the NUM_DERIVATIVES_AT_END_PROPERTY property.
    • getNumDerivativesAtStart

      public long getNumDerivativesAtStart()
      Returns the value of the property that maps to the numDerivativesAtStart attribute.

      The attribute "numDerivativesAtStart" specifies the type of continuity between this curve segment and its predecessor. If this is the first curve segment in the curve, one of these values, as appropriate, is ignored. The default value of "0" means simple continuity, which is a mandatory minimum level of continuity. This level is referred to as "C 0 " in mathematical texts. A value of 1 means that the function and its first derivative are continuous at the appropriate end point: "C 1 " continuity. A value of "n" for any integer means the function and its first n derivatives are continuous: "C n " continuity. NOTE: Use of these values is only appropriate when the basic curve definition is an underdetermined system. For example, line string segments cannot support continuity above C 0 , since there is no spare control parameter to adjust the incoming angle at the end points of the segment. Spline functions on the other hand often have extra degrees of freedom on end segments that allow them to adjust the values of the derivatives to support C 1 or higher continuity.

      Returns:
      the value of the NUM_DERIVATIVES_AT_START_PROPERTY property.
    • setNumDerivativesAtStart

      public void setNumDerivativesAtStart(long aValue)
      Sets the value of the property that maps to the numDerivativesAtStart attribute.

      The attribute "numDerivativesAtStart" specifies the type of continuity between this curve segment and its predecessor. If this is the first curve segment in the curve, one of these values, as appropriate, is ignored. The default value of "0" means simple continuity, which is a mandatory minimum level of continuity. This level is referred to as "C 0 " in mathematical texts. A value of 1 means that the function and its first derivative are continuous at the appropriate end point: "C 1 " continuity. A value of "n" for any integer means the function and its first n derivatives are continuous: "C n " continuity. NOTE: Use of these values is only appropriate when the basic curve definition is an underdetermined system. For example, line string segments cannot support continuity above C 0 , since there is no spare control parameter to adjust the incoming angle at the end points of the segment. Spline functions on the other hand often have extra degrees of freedom on end segments that allow them to adjust the values of the derivatives to support C 1 or higher continuity.

      Parameters:
      aValue - the value to set for the NUM_DERIVATIVES_AT_START_PROPERTY property.