pygplates.ResolvedTopologicalSharedSubSegment

class pygplates.ResolvedTopologicalSharedSubSegment

Bases: Boost.Python.instance

The shared subset of vertices of a reconstructed topological section that uniquely contribute to the boundaries of one or more resolved topologies.

Note

Only ResolvedTopologicalBoundary and ResolvedTopologicalNetwork have boundaries and hence will share ResolvedTopologicalSharedSubSegment instances.
ResolvedTopologicalLine is excluded since it does not have a boundary.

The resolve_topologies() function can be used to generate resolved topology boundaries (ResolvedTopologicalBoundary and ResolvedTopologicalNetwork) and the shared ResolvedTopologicalSharedSubSegment instances.

Note

Each ResolvedTopologicalSharedSubSegment instance can be shared by one or more resolved topologies.
In contrast, a ResolvedTopologicalSubSegment instance belongs to a single resolved topology.
__init__()

Raises an exception This class cannot be instantiated from Python

Methods

__init__ Raises an exception
get_feature() Same as get_topological_section_feature().
get_geometry() Same as get_resolved_geometry().
get_resolved_feature() Returns a feature containing the resolved sub-segment geometry.
get_resolved_geometry() Returns the geometry containing the shared sub-segment vertices.
get_sharing_resolved_topologies() Returns a list of resolved topologies sharing this sub-segment.
get_sharing_resolved_topology_geometry_reversal_flags() Returns a list of flags indicating whether a copy of the sub-segment geometry was reversed when contributing to each resolved topology sharing this sub-segment.
get_topological_section() Returns the topological section that the shared sub-segment was obtained from.
get_topological_section_feature() Returns the feature referenced by the topological section.
get_topological_section_geometry() Returns the topological section geometry that the shared sub-segment was obtained from.
get_feature()

Same as get_topological_section_feature().

get_geometry()

Same as get_resolved_geometry().

get_resolved_feature()

Returns a feature containing the resolved sub-segment geometry.

Return type:Feature

The returned feature contains the resolved geometry.

Note

The returned feature does not contain present-day geometry as is typical of most GPlates features.
In this way the returned feature is similar to a GPlates reconstruction export.

Note

The returned feature should not be reverse reconstructed to present day because the topological section might be a ResolvedTopologicalLine which is a topology and topologies are resolved (not reconstructed).

get_resolved_geometry()

Returns the geometry containing the shared sub-segment vertices.

Return type:PolylineOnSphere

Note

These are the unreversed vertices. They are in the same order as the geometry of get_topological_section_geometry().

get_sharing_resolved_topologies()

Returns a list of resolved topologies sharing this sub-segment.

Return type:list of ReconstructionGeometry

Note

The resolved topologies (that share this sub-segment) can be ResolvedTopologicalBoundary and ResolvedTopologicalNetwork.
ResolvedTopologicalLine is excluded since it does not have a boundary.
get_sharing_resolved_topology_geometry_reversal_flags()

Returns a list of flags indicating whether a copy of the sub-segment geometry was reversed when contributing to each resolved topology sharing this sub-segment.

Return type:list of bool

Note

The returned list is in the same order (and has the same number of elements) as the list of sharing resolved topologies returned in get_sharing_resolved_topologies().

sharing_resolved_topologies = shared_sub_segment.get_sharing_resolved_topologies()
geometry_reversal_flags = shared_sub_segment.get_sharing_resolved_topology_geometry_reversal_flags()
for index in range(len(sharing_resolved_topologies)):
    sharing_resolved_topology = sharing_resolved_topologies[index]
    geometry_reversal_flag = geometry_reversal_flags[index]
get_topological_section()

Returns the topological section that the shared sub-segment was obtained from.

Return type:ReconstructionGeometry

Note

This represents the entire geometry of the topological section, not just the part that contributes to the shared sub-segment.

Note

This topological section can be either a ReconstructedFeatureGeometry or a ResolvedTopologicalLine.
The resolved topologies that share the topological section can be ResolvedTopologicalBoundary and ResolvedTopologicalNetwork.
get_topological_section_feature()

Returns the feature referenced by the topological section.

Return type:Feature

Note

The geometry in the returned feature represents the entire geometry of the topological section, not just the part that contributes to the shared sub-segment.

get_topological_section_geometry()

Returns the topological section geometry that the shared sub-segment was obtained from.

Return type:PolylineOnSphere

Note

This is the entire geometry of the topological section, not just the part that contributes to the shared sub-segment.

Previous topic

pygplates.ResolvedTopologicalSection

Next topic

pygplates.calculate_velocities

This Page