pygplates.ResolvedTopologicalSection

class pygplates.ResolvedTopologicalSection

Bases: Boost.Python.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.

The resolve_topologies() function 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().

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

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.
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 parts that contribute to resolved topological boundaries.

get_topological_section_geometry()

Returns the topological section geometry.

Return type:PolylineOnSphere

Note

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