pygplates.ResolvedTopologicalSection

class pygplates.ResolvedTopologicalSection

Bases: instance

The sequence of shared sub-segments 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 sub-segments.

ResolvedTopologicalLine is excluded since it does not have a boundary.

TopologicalModel, TopologicalSnapshot or resolve_topologies() can be used to generate resolved topology boundaries (ResolvedTopologicalBoundary and ResolvedTopologicalNetwork) and ResolvedTopologicalSection instances.

__init__(): Raises an exception This class cannot be instantiated from Python

Methods

`__init__`	Raises an exception This class cannot be instantiated from Python
`get_feature`()	Same as `get_topological_section_feature()`.
`get_shared_sub_segments`()	Returns a list of sub-segments on this topological section that are shared by one or more resolved topologies.
`get_topological_section`()	Returns the topological section.
`get_topological_section_feature`()	Returns the feature referenced by the topological section.
`get_topological_section_geometry`()	Returns the topological section geometry.

get_feature(): Same as get_topological_section_feature().

Warning

The geometry in the feature is present day geometry - it is NOT reconstructed.

See ResolvedTopologicalSharedSubSegment.get_resolved_feature() (via get_shared_sub_segments()) for a resolved feature containing reconstructed geometry.

get_shared_sub_segments()

Returns a list of sub-segments on this topological section that are shared by one or more resolved topologies.

Return type:: list of ResolvedTopologicalSharedSubSegment

Note

The order of returned sub-segments is from the start to the end of this topological section geometry. In other words, the first sub-segment will be at (or near) the start of the section geometry and the last sub-segment will be at (or near) the end of the section geometry.

Get the length of the shared sub-segments of a resolved topological section:

length = 0
for shared_sub_segment in resolved_topological_section.get_shared_sub_segments():
    length += shared_sub_segment.get_resolved_geometry().get_arc_length()

length_in_kms = length * pygplates.Earth.mean_radius_in_kms

Note

The returned objects are ResolvedTopologicalSharedSubSegment instances, not ResolvedTopologicalSubSegment instances.

ResolvedTopologicalSubSegment instances are not shared by one or more resolved topologies - each instance is associated with a single resolved topology.

get_topological_section()

Returns the topological section.

Return type:: ReconstructionGeometry

Note

This represents the entire geometry of the topological section, not just the parts that contribute to resolved topological boundaries.

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.