fmeobjects.FMEClothoid

`FMEClothoid.boundingBox`()	This method returns the bounding box of the geometry.
`FMEClothoid.boundingCube`()	This method returns the bounding cube of the geometry.
`FMEClothoid.bounds`()	Returns the bounds of the geometry.
`FMEClothoid.clearMeasures`()	Remove all measures from the geometry.
`FMEClothoid.copyAttributesFromFeature`(...)	Copies all the attributes from the given feature to traits on this geometry, if they match the (optional) regular expression.
`FMEClothoid.copyNameFromGeometry`(sourceGeometry)	Copies the name of the 'sourceGeometry' onto this geometry.
`FMEClothoid.copyTraitsFromGeometry`(...)	Copies all the traits from the given geometry that match the (optional) regular expression.
`FMEClothoid.copyTraitsToFeature`(destFeature, ...)	Copies all the traits from this geometry to attributes on the given feature, if they match the (optional) regular expression.
`FMEClothoid.deleteName`()	Deletes the geometry's name.
`FMEClothoid.force2D`()	Reduces the geometry to 2D.
`FMEClothoid.force3D`(newZ)	This sets the geometry's dimension to 3D.
`FMEClothoid.getArea`()	Area calculation.
`FMEClothoid.getAsLine`()	Returns the curve as a line.
`FMEClothoid.getAsLineFixedArcSamples`(numSamples)	Returns a copy of this curve as a line.
`FMEClothoid.getEndCurvature`()	Returns the end curvature (in local coordinates) of the clothoid.
`FMEClothoid.getEndPoint`()	Returns the end point of this curve.
`FMEClothoid.getLength`(threeD)	Returns the length of the curve.
`FMEClothoid.getLocalEndZ`()	Returns the elevation (in local coordinates) of the clothoid's end coordinate.
`FMEClothoid.getLocalLength`()	Returns the length (in local coordinates) of the clothoid.
`FMEClothoid.getLocalStartCoordXY`()	Returns the XY (in local coordinates) of the clothoid's start coordinate.
`FMEClothoid.getLocalStartCoordXYZ`()	Returns the XYZ (in local coordinates) of the clothoid's start coordinate.
`FMEClothoid.getMeasureNames`()	Retrieve the names of the measures on this geometry.
`FMEClothoid.getMeasureValues`(measureName)	Return the values of the given measure.
`FMEClothoid.getName`()	This routine retrieves the 'name' of this geometry as a `str`.
`FMEClothoid.getStartCurvature`()	Returns the start curvature (in local coordinates) of the clothoid.
`FMEClothoid.getStartDirection`()	Returns the start angle (in degrees of the local coordinates) of the clothoid.
`FMEClothoid.getStartPoint`()	Returns the start point of this curve.
`FMEClothoid.getTrait`(traitName)	Retrieves the geometry trait value of the specified trait name.
`FMEClothoid.getTraitNames`()	Retrieve the names of the traits on this geometry.
`FMEClothoid.getTraitNullMissingAndType`(traitName)	This method returns a tuple of a boolean, indicating if the trait is null, a boolean, indicating if the trait is missing, and an integer representing the type of the trait.
`FMEClothoid.getTraitType`(traitName)	Returns the type of given trait.
`FMEClothoid.getTransformationMatrix`()	Gets this clothoid's transformation matrix.
`FMEClothoid.hasMeasures`()	Check if this geometry or any sub part of this geometry has measures.
`FMEClothoid.hasName`()	Returns whether or not the geometry has a name.
`FMEClothoid.hasTransformationMatrix`()	This method determines if the clothoid has a transformation matrix or not.
`FMEClothoid.is3D`()	Returns whether or not the geometry is 3D.
`FMEClothoid.isClosed`(threeD)	Returns `True` if the start and end points have identical coordinate values.
`FMEClothoid.isCollection`()	Check if the geometry is an aggregate or multi-part collection.
`FMEClothoid.isLinear`()	Returns `True` if and only if this curve contains only lines.
`FMEClothoid.measureExists`(measureName)	Returns `True` if the specified measure exists and `False` otherwise.
`FMEClothoid.offset`(offsetPoint)	Offsets the geometry by the coords specified by 'offsetPoint'.
`FMEClothoid.removeDuplicates`(checkZ)	Removes any adjacent duplicate points.
`FMEClothoid.removeMeasure`(measureName)	Remove the specified measure if it exists.
`FMEClothoid.removeTraits`(regexp)	This method has 4 modes:
`FMEClothoid.removeTransformationMatrix`()	Resets the transformation matrix to the identity.
`FMEClothoid.renameMeasure`(oldMeasureName, ...)	Renames the measure specified by 'oldMeasureName' to the new name, specified by 'newMeasureName'.
`FMEClothoid.reverse`()	This reverses the order of the curve's points.
`FMEClothoid.rotate2D`(center, angle)	Rotate the curve counterclockwise around the 'center' point by the specified 'angle' (in degrees).
`FMEClothoid.scale`(xScale, yScale, zScale)	Scale the feature by the given amounts.
`FMEClothoid.setEndCurvature`(endCurvature)	Sets the end curvature (in local coordinates) of the clothoid.
`FMEClothoid.setEndPoint`(point)	Changes the existing end point of this curve.
`FMEClothoid.setLength`(localLength)	Sets the length (in local coordinates) of the clothoid.
`FMEClothoid.setLocalEndZ`(localEndZ)	Sets the local end elevation of the clothoid.
`FMEClothoid.setLocalStartCoordXY`(xCoord, yCoord)	Sets the XY (in local coordinates) of the clothoid's start coordinate.
`FMEClothoid.setLocalStartCoordXYZ`(xCoord, ...)	Sets the XYZ (in local coordinates) of the clothoid's start coordinate.
`FMEClothoid.setMeasure`(measureName, ...)	Assign the given values to the specified measure.
`FMEClothoid.setName`(name)	Sets the geometry's name with a `str`.
`FMEClothoid.setStartCurvature`(startCurvature)	Sets the start curvature (in local coordinates) of the clothoid.
`FMEClothoid.setStartDirection`(startDirection)	Sets the start angle (in degrees of the local coordinates) of the clothoid.
`FMEClothoid.setStartPoint`(point)	Changes the existing start point of this curve.
`FMEClothoid.setTrait`(traitName, traitValue)	Sets a geometry trait with the specified value.
`FMEClothoid.setTraitNullWithType`(traitName, ...)	This method supplies a null trait value with a type to the geometry.
`FMEClothoid.setTransformationMatrix`(...)	Sets this clothoid's transformation matrix, replacing the existing matrix if it exists.
`FMEClothoid.snip`(measureType, measure3D, ...)	Take a description of start and end positions (either as a measured 2D/3D distance, percentage, or normalized distance from the beginning, or a vertex index), and chop off only the portion between these positions.
`FMEClothoid.snipByPoints`(startPoint, endPoint)	Snip off the portion between two points.

class FMEClothoid

FME Clothoid Class

Create an instance of an clothoid geometry object.

init(startPoint, endPoint, tranformationMatrix, localStartCoord, localEndZ, startDirection, startCurvature, endCurvature, localLength)

Creates a clothoid. The startPoint and endPoint are optional and can be specified as None.

The transformation matrix can be used to place the clothoid in a custom orientation and location as follows:

Pick three orthogonal unit vectors V1, V2, V3 which represents the X, Y, and Z axes of the orientation, and a vector v4 that represents the offset of the arc. Then, the transformation matrix is of the form: [[V1x,V1y,V1z,0x],[V2x,V2y,V2z,0x],[V3x,V3y,V3z,0x],[0,0,0,1]]

The matrix can be any kind of affine transformation matrix. Only three rows are expected in the input array, as a bottom row of [ 0 0 0 1 ] is assumed.

Parameters:

startPoint (FMEPoint) – The start point of the clothoid. It is optional and can be specified as None.
endPoint (FMEPoint) – The end point of the clothoid. It is optional and can be specified as None.
transformationMatrix (list[list[float]]) – The transformation matrix to apply to the created clothoid, formatted [[dddd][dddd][dddd]]. Only three rows are expected in the input array, as a bottom row of [ 0 0 0 1 ] is assumed.
localStartCoord (tuple[float]) – The XYZ (in local coordinates) of the clothoid’s start coordinate in the form (x, y, z).
localEndZ (float) – The elevation (in local coordinates) of the clothoid’s end coordinate.
startDirection (float) – The start angle (in degrees of the local coordinates) of the clothoid.
startCurvature (float) – The start curvature (in local coordinates) of the clothoid.
endCurvature (float) – The end curvature (in local coordinates) of the clothoid.
localLength (float) – The length (in local coordinates) of the clothoid.

Return type:

FMEClothoid

Returns:

An instance of a Clothoid Geometry object.

init(clothoid)

Create a copy of the passed in clothoid geometry object.

Parameters:: clothoid (FMEClothoid) – The clothoid geometry object to create a copy of.
Return type:: FMEClothoid
Returns:: An instance of a Clothoid Geometry object.

__init__(*args, **kwargs)

boundingBox()

This method returns the bounding box of the geometry.

Return type:: tuple[tuple[float]]
Returns:: The bounding box of the Geometry, in the form ((minx, miny), (maxx, maxy)).

boundingCube()

This method returns the bounding cube of the geometry.

Return type:: tuple[tuple[float]]
Returns:: The bounding box of the Geometry, in the form ((minx, miny, minz), (maxx, maxy, maxz)).

bounds()

Returns the bounds of the geometry.

Return type:: tuple[FMEPoint]
Returns:: The min point and max point of the bounds. None is returned if the geometry contains no points.

clearMeasures()

Remove all measures from the geometry.

Return type:: None

copyAttributesFromFeature(sourceFeature, overwriteExisting, regexp, prefix)

Copies all the attributes from the given feature to traits on this geometry, if they match the (optional) regular expression.

Parameters:

sourceFeature (FMEFeature) – The feature to copy attributes from.
overwriteExisting (bool) – Existing traits will be overwritten only if overwriteExisting is True.
regexp (str) – (Optional) The regular expression to match the attributes against. If regexp is not specified, then all attributes will be copied.
prefix (str) – (Optional) The prefix is put on all the trait names as they are copied. If it is not specified, a prefix will not be added to the trait names.

Return type:

None

copyNameFromGeometry(sourceGeometry)

Copies the name of the ‘sourceGeometry’ onto this geometry. If ‘sourceGeometry’s name is blank or None, this geometry’s name will become None.

Parameters:: sourceGeometry (FMEGeometry) – The geometry to copy the name from.
Return type:: None

copyTraitsFromGeometry(sourceGeometry, overwriteExisting, regexp, prefix)

Copies all the traits from the given geometry that match the (optional) regular expression.

Parameters:

sourceGeometry (FMEGeometry) – The geometry to copy traits from.
overwriteExisting (bool) – Existing traits will be overwritten only if overwriteExisting is True.
regexp (str) – (Optional) The regular expression to match the traits against. If regexp is not specified, or is an empty string, then all traits will be copied.
prefix (str) – (Optional) The prefix is put on all the trait names as they are copied. If it is not specified, a prefix will not be added to the trait names.

Return type:

None

copyTraitsToFeature(destFeature, overwriteExisting, regexp, prefix)

Copies all the traits from this geometry to attributes on the given feature, if they match the (optional) regular expression.

Parameters:

destFeature (FMEFeature) – The feature to copy traits to.
overwriteExisting (bool) – Existing attributes will be overwritten only if overwriteExisting is True.
regexp (str) – (Optional) The regular expression to match the traits against. If regexp is not specified, or is an empty string, then all traits will be copied.
prefix (str) – (Optional) The prefix is put on all the attribute names as they are copied. If it is not specified, a prefix will not be added to the attribute names.

Return type:

None

deleteName()

Deletes the geometry’s name. If a name existed prior to this call then True is returned; otherwise False is returned.

Return type:: bool
Returns:: Returns a boolean indicating whether or not the name existed before deletion.

force2D()

Reduces the geometry to 2D.

Return type:: None

force3D(newZ)

This sets the geometry’s dimension to 3D. All Z values are set to the value passed in, even if the geometry is already 3D.

Parameters:: newZ (float) – The new Z value.
Return type:: None

getArea()

Area calculation.

Return type:: float
Returns:: The calculated area.

getAsLine()

Returns the curve as a line.

Return type:: FMELine
Returns:: The curve as a FMELine object.

getAsLineFixedArcSamples(numSamples)

Returns a copy of this curve as a line. All arcs are approximated with the number of points given by ‘numSamples’. If ‘numSamples’ is 0, the number points will first be determined by the value of kFMEStrokeMaxDeviationValue directive in mapping file, which denotes the maximum deviation of the arc from the line. In the absence of this directive or the value of this directive is smaller than or equal to 0, the number points will be determined by the arc’s sweep angle and the value of the mapping file directive kFMEDegreesPerEdge, which defaults to 5.

Parameters:: numSamples (int) – The number of points to approximate the arc with.
Return type:: FMELine
Returns:: The curve as a FMELine object.

getEndCurvature()

Returns the end curvature (in local coordinates) of the clothoid.

Return type:: float
Returns:: The end curvature (in local coordinates) of the clothoid.

getEndPoint()

Returns the end point of this curve. An error is returned and None is returned if this curve has no point to return.

Return type:: FMEPoint or None
Returns:: The end point of the curve, or None if there is no point to return.
Raises:: FMEException – An exception is raised if an error occurred.

getLength(threeD)

Returns the length of the curve. If ‘threeD’ is True, this returns the 3D length of the curve, otherwise this returns the 2D length.

Parameters:: threeD (bool) – Whether to calculate the 2D or 3D length.
Return type:: float
Returns:: The length of the curve.

getLocalEndZ()

Returns the elevation (in local coordinates) of the clothoid’s end coordinate. If the clothoid is 2D, the z value will be given as NaN.

Return type:: float
Returns:: The elevation (in local coordinates) of the clothoid’s end coordinate.

getLocalLength()

Returns the length (in local coordinates) of the clothoid.

Return type:: float
Returns:: The length (in local coordinates) of the clothoid.

getLocalStartCoordXY()

Returns the XY (in local coordinates) of the clothoid’s start coordinate.

Return type:: tuple[float]
Returns:: The XY (in local coordinates) of the clothoid’s start coordinate.

getLocalStartCoordXYZ()

Returns the XYZ (in local coordinates) of the clothoid’s start coordinate.

Return type:: tuple[float]
Returns:: The XYZ (in local coordinates) of the clothoid’s start coordinate.

getMeasureNames()

Retrieve the names of the measures on this geometry.

Return type:: tuple[str]
Returns:: Return a tuple storing the names of the measures on this geometry. This will return an empty tuple if there are no measures. For FMEAggregate, FMEMultiSurface, and FMECompositeSurface, this will return the union of all measure names of all of its parts.

getMeasureValues(measureName)

Return the values of the given measure.

Parameters:: measureName (str) – The name of the measure whose value is to be returned.
Return type:: tuple[float]
Returns:: The values of the named measure in the form (start_point_value, end_point_value)
Raises:: FMEException – An exception is raised if the measure name does not exist.

getName()

This routine retrieves the ‘name’ of this geometry as a str. This will return None if it did not have a name associated with it.

Return type:: str or None
Returns:: The geometry’s name.

getStartCurvature()

Returns the start curvature (in local coordinates) of the clothoid.

Return type:: float
Returns:: The start curvature (in local coordinates) of the clothoid.

getStartDirection()

Returns the start angle (in degrees of the local coordinates) of the clothoid.

Return type:: float
Returns:: The start angle (in degrees of the local coordinates) of the clothoid.

getStartPoint()

Returns the start point of this curve. An error is returned and None is returned if this curve has no point to return.

Return type:: FMEPoint or None
Returns:: The start point of the curve, or None if there is no point to return.
Raises:: FMEException – An exception is raised if an error occurred.

getTrait(traitName)

Retrieves the geometry trait value of the specified trait name. Null trait values will be returned as an empty string. Binary blob traits are returned as a bytearray.

None is returned when the trait is not found on the geometry.

Parameters:: traitName (str) – The name of the geometry trait.
Return type:: bool, int, float, str, bytearray, bytes or None
Returns:: The trait value.
Raises:: FMEException – An exception is raised if there was a problem in retrieving the trait value.

getTraitNames()

Retrieve the names of the traits on this geometry.

Return type:: tuple[str]
Returns:: Return a tuple storing the names of the traits on this geometry. This will return an empty tuple if there are no traits. For all collections and containers, this will only return the names of traits on the outermost object only.

getTraitNullMissingAndType(traitName)

This method returns a tuple of a boolean, indicating if the trait is null, a boolean, indicating if the trait is missing, and an integer representing the type of the trait. The first boolean is True if ‘traitName’ maps to a null trait value on the geometry. Otherwise it is False. The second boolean is True if ‘traitName’ maps to a no value on the geometry. Otherwise it is False. If the trait is absent, FME_ATTR_UNDEFINED is returned for the type.

The possible trait types are FME_ATTR_UNDEFINED, FME_ATTR_BOOLEAN, FME_ATTR_INT8, FME_ATTR_UINT8, FME_ATTR_INT16, FME_ATTR_UINT16, FME_ATTR_INT32, FME_ATTR_UINT32, FME_ATTR_REAL32, FME_ATTR_REAL64, FME_ATTR_REAL80, FME_ATTR_STRING, FME_ATTR_ENCODED_STRING, FME_ATTR_INT64, FME_ATTR_UINT64.

Parameters:: traitName (str) – The trait’s name.
Return type:: tuple[bool, bool, int]
Returns:: A tuple of 2 boolean values the first indicating whether or not the value of the trait is null, the second indicating whether or not the trait is missing, and an integer representing the trait type.

getTraitType(traitName)

Returns the type of given trait. If the trait cannot be found, FME_ATTR_UNDEFINED will be returned.

Returns one of FME_ATTR_UNDEFINED, FME_ATTR_BOOLEAN, FME_ATTR_INT8, FME_ATTR_UINT8, FME_ATTR_INT16, FME_ATTR_UINT16, FME_ATTR_INT32, FME_ATTR_UINT32, FME_ATTR_REAL32, FME_ATTR_REAL64, FME_ATTR_REAL80, FME_ATTR_STRING, FME_ATTR_ENCODED_STRING, FME_ATTR_INT64, FME_ATTR_UINT64.

Parameters:: traitName (str) – The trait’s name.
Return type:: int
Returns:: The trait type.

getTransformationMatrix()

Gets this clothoid’s transformation matrix. If the clothoid does not have such a matrix, an identity matrix is returned. Only the top three rows of the matrix will be returned, as the bottom row is always [ 0 0 0 1 ].

Return type:: list[list[float]]
Returns:: The clothoid’s transformation matrix, formatted [[dddd][dddd][dddd]].

hasMeasures()

Check if this geometry or any sub part of this geometry has measures.

Return type:: bool
Returns:: True if this geometry or any sub part of this geometry has measures, False otherwise.

hasName()

Returns whether or not the geometry has a name.

Return type:: bool
Returns:: Returns True if the geometry has a name and False otherwise.

hasTransformationMatrix()

This method determines if the clothoid has a transformation matrix or not.

Return type:: bool
Returns:: Returns True if this clothoid has a transformation matrix, and False otherwise.

is3D()

Returns whether or not the geometry is 3D.

Return type:: bool
Returns:: Returns True if the geometry is 3D and False otherwise. For FMENull, this method will always return True. For FMEAggregate, FMEMultiPoint, FMEMultiArea, FMEMultiText and FMEMultiCurve, this method will return True if any one of the sub-parts is 3D. If the collection is empty or all of its members are 2D, this method will return False.

isClosed(threeD)

Returns True if the start and end points have identical coordinate values. If ‘threeD’ is True, the z coordinate of the start and end points will be compared. This does not take measures into consideration.

Parameters:: threeD (bool) – Whether to compare the z coordinate value.
Return type:: bool
Returns:: True if the start and end point have identical coordinate values, False otherwise.

isCollection()

Check if the geometry is an aggregate or multi-part collection.

Return type:: bool
Returns:: True if the geometry is an aggregate or multi-part collection.

isLinear()

Returns True if and only if this curve contains only lines.

Return type:: bool
Returns:: True if the curve contains only lines, False otherwise.

measureExists(measureName)

Returns True if the specified measure exists and False otherwise. If the ‘measureName’ parameter is not specified then the default measure is checked.

Parameters:: measureName (str) – (Optional) The measure’s name.
Return type:: bool
Returns:: Boolean indicating whether or not the measure exists.

offset(offsetPoint)

Offsets the geometry by the coords specified by ‘offsetPoint’.

Parameters:: offsetPoint (FMEPoint) – The FMEPoint to offset the curve by.
Return type:: None
Raises:: FMEException – An exception is raised if an error occurred.

removeDuplicates(checkZ)

Removes any adjacent duplicate points. If ‘checkZ’ is True, x, y, and z coordinates are checked, otherwise only x and y are.

Parameters:: checkZ (bool) – Whether to check the z coordinate.
Return type:: None

removeMeasure(measureName)

Remove the specified measure if it exists. If the measure name, is not provided remove the default measure, if there is one.

Parameters:: measureName (str) – (Optional) The name of the measure to remove.
Return type:: None

removeTraits(regexp)

This method has 4 modes:

Remove all traits at the top level: regex == NULL

Remove some traits at the top level: regex == <string>

Remove all traits at all levels: regex == kFME_RecurseAll

Remove some traits at all levels: regex == kFME_RecurseSome <string>

For example, specifying regex == NULL for a multi-surface will remove all traits at the root level of the multi-surface, whereas specifying regex == kFME_RecurseSome <string> will remove all traits from all levels of the multi surface that match <string>. If <string> is an illegal regular expression, no traits will be removed.

Return type:: None

removeTransformationMatrix()

Resets the transformation matrix to the identity.

Return type:: None

renameMeasure(oldMeasureName, newMeasureName)

Renames the measure specified by ‘oldMeasureName’ to the new name, specified by ‘newMeasureName’.

Parameters:

oldMeasureName (str) – The original name of the measure.
newMeasureName (str) – The new name of the measure.

Return type:

None

reverse()

This reverses the order of the curve’s points.

Return type:: None

rotate2D(center, angle)

Rotate the curve counterclockwise around the ‘center’ point by the specified ‘angle’ (in degrees).

Parameters:

center (FMEPoint) – The center point of the curve.
angle (float) – The angle by which the curve is rotated.

Return type:

None

Raises:

FMEException – An exception is raised if an error occurred.

scale(xScale, yScale, zScale)

Scale the feature by the given amounts.

Parameters:

xScale (float) – The value to scale x by.
yScale (float) – The value to scale y by.
zScale (float) – (Optional) The value to scale z by. (Default value is 1.0)

Return type:

None

Raises:

FMEException – An exception is raised if an error occurred.

setEndCurvature(endCurvature)

Sets the end curvature (in local coordinates) of the clothoid. This will recompute the end point.

Parameters:: endCurvature (float) – The end curvature (in local coordinates) of the clothoid.
Return type:: None

setEndPoint(point)

Changes the existing end point of this curve. If there are no points on the curve, this method does nothing.

Parameters:: point (FMEPoint) – The point to set at the end of the curve.
Return type:: None
Raises:: FMEException – An exception is raised if an error occurred.

setLength(localLength)

Sets the length (in local coordinates) of the clothoid. This will recompute the end point.

Parameters:: localLength (float) – The length (in local coordinates) of the clothoid.
Return type:: None

setLocalEndZ(localEndZ)

Sets the local end elevation of the clothoid.

Parameters:: localEndZ (float) – The elevation (in local coordinates) of the clothoid’s end coordinate.
Return type:: None

setLocalStartCoordXY(xCoord, yCoord)

Sets the XY (in local coordinates) of the clothoid’s start coordinate. This will recompute the end point.

Parameters:

xCoord (float) – The X coordinate value (in local coordinates) of the clothoid’s start coordinate.
yCoord (float) – The Y coordinate value (in local coordinates) of the clothoid’s start coordinate.

Return type:

None

setLocalStartCoordXYZ(xCoord, yCoord, zCoord)

Sets the XYZ (in local coordinates) of the clothoid’s start coordinate. This will recompute the end point.

Parameters:

xCoord (float) – The X coordinate value (in local coordinates) of the clothoid’s start coordinate.
yCoord (float) – The Y coordinate value (in local coordinates) of the clothoid’s start coordinate.
zCoord (float) – The Z coordinate value (in local coordinates) of the clothoid’s start coordinate.

Return type:

None

setMeasure(measureName, startPointValue, endPointValue)

Assign the given values to the specified measure. This will create the measure if it doesn’t already exist.

Parameters:

measureName (str) – The name of the measure whose value is to be set or created.
startPointValue (float) – The start point value of the measure.
endPointValue (float) – The end point value of the measure.

Return type:

None

setName(name)

Sets the geometry’s name with a str. By supplying a blank name as input, this method will act as deleteName().

Parameters:: name (str) – The geometry’s new name.
Return type:: None

setStartCurvature(startCurvature)

Sets the start curvature (in local coordinates) of the clothoid. This will recompute the end point.

Parameters:: startCurvature (float) – The start curvature (in local coordinates) of the clothoid.
Return type:: None

setStartDirection(startDirection)

Sets the start angle (in degrees of the local coordinates) of the clothoid. This will recompute the end point.

Parameters:: startDirection (float) – The start angle (in degrees of the local coordinates) of the clothoid.
Return type:: None

setStartPoint(point)

Changes the existing start point of this curve. If there are no points on the curve, this method does nothing.

Parameters:: point (FMEPoint) – The point to set at the start of the curve.
Return type:: None
Raises:: FMEException – An exception is raised if an error occurred.

setTrait(traitName, traitValue)

Sets a geometry trait with the specified value. If the geometry trait already exists, its value and type will be changed. The following type numeric mappings are used:

PyInt ==> FME_Int32

PyFloat ==> FME_Real64

PyLong ==> FME_Int64

Binary values are to be specified as bytearray values or bytes values.

Parameters:

traitName (str) – The name of the geometry trait.
traitValue (bool, int, float, str, bytearray, or bytes) – The value of the geometry trait.

Return type:

None

setTraitNullWithType(traitName, traitType)

This method supplies a null trait value with a type to the geometry. If a trait with the same name already exists, it is overwritten.

Trait type must be one of FME_ATTR_UNDEFINED, FME_ATTR_BOOLEAN, FME_ATTR_INT8, FME_ATTR_UINT8, FME_ATTR_INT16, FME_ATTR_UINT16, FME_ATTR_INT32, FME_ATTR_UINT32, FME_ATTR_REAL32, FME_ATTR_REAL64, FME_ATTR_REAL80, FME_ATTR_STRING, FME_ATTR_ENCODED_STRING, FME_ATTR_INT64, FME_ATTR_UINT64.

Parameters:

traitName (str) – The trait’s name.
traitType (int) – An integer representing the trait type.

Return type:

None

setTransformationMatrix(transformationMatrix)

Sets this clothoid’s transformation matrix, replacing the existing matrix if it exists. Only three rows are expected in the input array, as a bottom row of [ 0 0 0 1 ] is assumed.

Parameters:: transformationMatrix (list[list[float]]) – The transformation matrix, formatted [[dddd][dddd][dddd]].
Return type:: None

snip(measureType, measure3D, startLocation, endLocation)

Take a description of start and end positions (either as a measured 2D/3D distance, percentage, or normalized distance from the beginning, or a vertex index), and chop off only the portion between these positions. If the start and end positions are the same, keep two same points.

Parameters:

measureType (int) – The measure type to use. Must be on of: SNIP_DISTANCE, SNIP_PERCENTAGE, SNIP_VERTEX or SNIP_POINT.
measure3D (bool) – Whether to measure the 2D or 3D distance.
startLocation (float) – The start location.
endLocation (float) – The end location.

Return type:

None

Raises:

FMEException – An exception is raised if an error occurred.

snipByPoints(startPoint, endPoint)

Snip off the portion between two points. If these points are not on this line, replaced with nearest points which are exactly on the line. If the start and end point are the same, keep two same points.

Parameters:

startPoint (FMEPoint) – The start point.
endPoint (FMEPoint) – The end point.

Return type:

None

Raises:

FMEException – An exception is raised if an error occurred.