fmeobjects.FMEMultiPoint

|
This appends the point to the multi point. |
|
This appends the multi point passed in to the multi point. |
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. |
Area calculation. |
|
Retrieve the names of the measures on this geometry. |
|
This routine retrieves the 'name' of this geometry as a |
|
|
This method returns the point at the given index. |
|
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. |
Check if this geometry or any sub part of this geometry has measures. |
|
Returns whether or not the geometry has a name. |
|
Returns whether or not the geometry is 3D. |
|
Check if the geometry is an aggregate or multi-part collection. |
|
|
Returns |
This returns the number of points that make up this multi point. |
|
|
Offsets the geometry by the coords specified by 'offsetPoint'. |
This removes and returns the last point of the multi point. |
|
|
Removes the measure with name 'measureName' if supplied, or the default measure, if there is one. |
|
This method has 4 modes: |
|
Renames the measure specified by 'oldMeasureName' to the new name, specified by 'newMeasureName'. |
|
The angle is CCW up from the horizontal and is measured in degrees. |
|
Applies a scale factor to the multi point. |
|
Sets the geometry's name with a |
|
Sets a geometry trait with the specified value. |
This method supplies a null trait value with a type to the geometry. |
- class FMEMultiPoint
__decIterRef__(args),
__incIterRef__(args),
FME Multi-Point Class
Create an instance of a Multi-Point geometry object.
init()
Default FMEMultiPoint constructor.
- Return type
- Returns
An instance of a
MultiPoint
geometry object.
init(multiPoint)
Create a copy of the passed in Multi-Point geometry object.
- Parameters
multiPoint (FMEMultiPoint) – The Multi-Point geometry object to create a copy of.
- Return type
- Returns
An instance of a MultiPoint Geometry object.
- __init__(*args, **kwargs)
- appendPart(point)
This appends the point to the multi point. If
None
is passed in, nothing will be appended. All points in the multi point will be forced to have the same dimension. If any 3D points exist, all 2D points will be converted to 3D with a default Z value of 0.0.- Parameters
point (FMEPoint) – The point to be appended.
- Return type
None
- Raises
FMEException – An exception is raised if an error occurred.
- appendParts(multiPoint)
This appends the multi point passed in to the multi point. If
None
is passed in, nothing will be appended.- Parameters
multiPoint (FMEMultiPoint) – The multi point to be appended.
- Return type
None
- Raises
FMEException – An exception is raised if an error occurred.
- 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
- 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.
- 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.
- getPartAt(index)
This method returns the point at the given index.
None
is returned if the index is out of range.- Parameters
index (int) – The index of the point part to return.
- Return type
FMEPoint or None
- Returns
The point at the given index.
- 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
.
- hasMeasures()
Check if this geometry or any sub part of this geometry has measures.
- hasName()
Returns whether or not the geometry has a name.
- 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 sub-parts is 3D. If the collection is empty or all of its members are 2D, this method will returnFalse
.
- isCollection()
Check if the geometry is an aggregate or multi-part 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.
- numParts()
This returns the number of points that make up this multi point.
- Return type
- Returns
The number of points in multi point.
- offset(offsetPoint)
Offsets the geometry by the coords specified by ‘offsetPoint’.
- Parameters
offsetPoint (FMEPoint) – The point to offset the coordinates of the geometry by.
- Return type
None
- Raises
FMEException – An exception is raised if an error occurred.
- removeLastPart()
This removes and returns the last point of the multi point. If there are no points in the multi point, it will return
None
.- Return type
FMEPoint or None
- Returns
The last point of the multi point.
- Raises
FMEException – An exception is raised if an error occurred.
- removeMeasure(measureName)
Removes the measure with name ‘measureName’ if supplied, or 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
- renameMeasure(oldMeasureName, newMeasureName)
Renames the measure specified by ‘oldMeasureName’ to the new name, specified by ‘newMeasureName’.
- rotate2D(center, angle)
The angle is CCW up from the horizontal and is measured in degrees.
- Parameters
- Return type
None
- Raises
FMEException – An exception is raised if an error occurred.
- scale(xscale, yscale, zscale)
Applies a scale factor to the multi point. The ‘zscale’ is ignored if geometry is 2D.
- Parameters
- Return type
None
- Raises
FMEException – An exception is raised if an error occurred.
- 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
- 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
.