fmeobjects.FMEOrientedArc
This method returns the bounding box of the geometry. 

This method returns the bounding cube of the geometry. 

Returns the bounds of the geometry. 

Remove all measures from the geometry. 

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

Copies the name of the 'sourceGeometry' onto this geometry. 

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

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

Deletes the geometry's name. 

Reduces the geometry to 2D. 


This sets the geometry's dimension to 3D. 
Returns the 

Area calculation. 

Returns the curve as a line. 

Returns a copy of this curve as a line. 

Returns the end point of this curve. 


Returns the length of the curve. 
Retrieve the names of the measures on this geometry. 


Return the values of the given measure. 
This routine retrieves the 'name' of this geometry as a 

Returns the start point of this curve. 


Retrieves the geometry trait value of the specified trait name. 
Retrieve the names of the traits on this geometry. 

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. 


Returns the type of given trait. 
Gets this oriented arc's transformation matrix. 

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

Returns whether or not the geometry has a name. 

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

Returns whether or not the geometry is 3D. 


Returns 
Check if the geometry is an aggregate or multipart collection. 

Returns 


Returns 

Offsets the geometry by the coords specified by 'offsetPoint'. 

Removes any adjacent duplicate points. 

Remove the specified measure if it exists. 

This method has 4 modes: 
Resets the transformation matrix to the identity. 


Renames the measure specified by 'oldMeasureName' to the new name, specified by 'newMeasureName'. 
This reverses the order of the curve's points. 


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

Scale the feature by the given amounts. 

Sets the arc of this oriented arc. 
Sets the arc of this oriented arc. 


Changes the existing end point of this curve. 

Assign the given values to the specified measure. 

Sets the geometry's name with a 

Changes the existing start point of this curve. 

Sets a geometry trait with the specified value. 
This method supplies a null trait value with a type to the geometry. 

Sets this oriented arc's transformation matrix, replacing the existing matrix if it exists. 


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. 

Snip off the portion between two points. 
 class FMEOrientedArc
FME Oriented Arc Class
Create an instance of an Oriented Arc geometry object.
init(arc, startCoord, endCoord, tranformationMatrix)
Creates an oriented arc using an arc, a start coordinate, a end coordinate, and a transformation matrix. The startCoord and endCoord are optional and can be specified as
None
.The transformation matrix can be used to place the oriented arc 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. The end result of this call will be forced to 3D if the input arc is 3D.
 Parameters
box – The arc to use for creating the oriented arc.
startCoord (tuple[float] or None) – The start coordinate of the oriented arc in the form (x, y, z). The z is not required and will be ignored when the input arc is 2D. This is optional and can be specified as
None
.endCoord (tuple[float] or None) – The end coordinate of the oriented arc in the form (x, y, z). The z is not required and will be ignored when the input arc is 2D. This is optional and can be specified as
None
.transformationMatrix (list[list[float]]) – The transformation matrix to apply to the created oriented arc, formatted [[dddd][dddd][dddd]]. Only three rows are expected in the input array, as a bottom row of [ 0 0 0 1 ] is assumed.
 Return type
 Returns
An instance of an Oriented Arc Geometry object.
init(orientedArc)
Create a copy of the passed in Oriented Arc geometry object.
 Parameters
orientedArc (FMEOrientedArc) – The Oriented Arc geometry object to create a copy of.
 Return type
 Returns
An instance of an Oriented Arc Geometry object.
 __init__(*args, **kwargs)
 boundingBox()
This method returns the bounding box of the geometry.
 boundingCube()
This method returns the bounding cube of the geometry.
 bounds()
Returns the bounds of the geometry.
 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 becomeNone
. 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; otherwiseFalse
is returned. Return type
 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
 getArcInLocalCoordinates()
Returns the
FMEArc
contained within this oriented arc, in local coordinates. Return type
 Returns
The arc contained with this oriented arc.
 Raises
FMEException – An exception is raised if an error occurred.
 getAsLine()
Returns the curve as a line.
 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 directivekFMEDegreesPerEdge
, which defaults to 5.
 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.
 getMeasureNames()
Retrieve the names of the measures on this geometry.
 Return type
 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
, andFMECompositeSurface
, 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
 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 returnNone
if it did not have a name associated with it. Return type
str or None
 Returns
The geometry’s name.
 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.
 getTraitNames()
Retrieve the names of the traits on this geometry.
 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 isFalse
. The second boolean isTrue
if ‘traitName’ maps to a no value on the geometry. Otherwise it isFalse
. 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
.
 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
.
 getTransformationMatrix()
Gets this oriented arc’s transformation matrix. If the oriented arc 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 ].
 hasMeasures()
Check if this geometry or any sub part of this geometry has measures.
 hasName()
Returns whether or not the geometry has a name.
 hasTransformationMatrix()
This method determines if the oriented arc has a transformation matrix or not.
 is3D()
Returns whether or not the geometry is 3D.
 Return type
 Returns
Returns
True
if the geometry is 3D andFalse
otherwise. ForFMENull
, this method will always returnTrue
. ForFMEAggregate
,FMEMultiPoint
,FMEMultiArea
,FMEMultiText
andFMEMultiCurve
, this method will returnTrue
if any one of the subparts is 3D. If the collection is empty or all of its members are 2D, this method will returnFalse
.
 isClosed(threeD)
Returns
True
if the start and end points have identical coordinate values. If ‘threeD’ isTrue
, the z coordinate of the start and end points will be compared. This does not take measures into consideration.
 isCollection()
Check if the geometry is an aggregate or multipart collection.
 measureExists(measureName)
Returns
True
if the specified measure exists andFalse
otherwise. If the ‘measureName’ parameter is not specified then the default measure is checked.
 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 multisurface will remove all traits at the root level of the multisurface, 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’.
 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
 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
 Return type
None
 Raises
FMEException – An exception is raised if an error occurred.
 setArc(arc, transformationMatrix)
Sets the arc of this oriented arc. The input arc should be planar. The existing arc will be replaced and the transformation matrix will be reset to the given value. To leave the transformation matrix in place and modify the arc’s local coordinates only, use setArcInLocalCoordinates(). If the input arc is
None
, then an exception will be raised. Parameters
 Return type
None
 Raises
FMEException – An exception is raised if an error occurred.
 setArcInLocalCoordinates(arc)
Sets the arc of this oriented arc. The input arc should be planar. If the input arc is
None
, then an exception will be raised. Parameters
arc (FMEArc) – The arc to set on this oriented arc.
 Return type
None
 Raises
FMEException – An exception is raised if an error occurred.
 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.
 setMeasure(measureName, startPointValue, endPointValue)
Assign the given values to the specified measure. This will create the measure if it doesn’t already exist.
 setName(name)
Sets the geometry’s name with a
str
. By supplying a blank name as input, this method will act asdeleteName()
. Parameters
name (str) – The geometry’s new name.
 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.
 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
.
 setTransformationMatrix(transformationMatrix)
Sets this oriented arc’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.
 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
orSNIP_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
 Return type
None
 Raises
FMEException – An exception is raised if an error occurred.