pygplates.ResolvedTopologicalLine

class pygplates.ResolvedTopologicalLine

Bases: pygplates.ReconstructionGeometry

The geometry of a topological line feature resolved to a geological time.

The resolve_topologies() function can be used to generate ResolvedTopologicalLine 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`()	Returns the feature associated with this `ResolvedTopologicalLine`.
`get_geometry_sub_segments`()	Same as `get_line_sub_segments()`.
`get_line_sub_segments`()	Returns the `sub-segments` that make up the line of this resolved topological line.
`get_property`()	Returns the feature property containing the topological line property associated with this `ResolvedTopologicalLine`.
`get_reconstruction_time`()	Returns the reconstruction time that this instance was created at.
`get_resolved_feature`()	Returns a feature containing the resolved line geometry.
`get_resolved_geometry`()	Same as `get_resolved_line()`.
`get_resolved_line`()	Returns the resolved line geometry.

get_feature()

Returns the feature associated with this ResolvedTopologicalLine.

Return type: Feature

Note

The returned feature is what was used to generate this ResolvedTopologicalLine via resolve_topologies().

See also

get_resolved_feature()

get_geometry_sub_segments(): Same as get_line_sub_segments().

get_line_sub_segments()

Returns the sub-segments that make up the line of this resolved topological line.

Return type: list of ResolvedTopologicalSubSegment

To get a list of the unreversed sub-segment geometries:

sub_segment_geometries = []
for sub_segment in resolved_topological_line.get_line_sub_segments():
    sub_segment_geometries.append(sub_segment.get_resolved_geometry())

To get a list of sub-segment geometries with points in the same order as this topological line:

sub_segment_geometries = []
for sub_segment in resolved_topological_line.get_line_sub_segments():
    sub_segment_geometry = sub_segment.get_resolved_geometry()
    if sub_segment.was_geometry_reversed_in_topology():
        # Create a new sub-segment polyline with points in reverse order.
        sub_segment_geometry = pygplates.PolylineOnSphere(sub_segment_geometry[::-1])
    sub_segment_geometries.append(sub_segment_geometry)

The following is essentially equivalent to get_resolved_line() (except rubber banding points, if any, between adjacent sub-segments are included below but not in get_resolved_line()):

def get_resolved_line(resolved_topological_line):

    resolved_line_points = []
    for sub_segment in resolved_topological_line.get_line_sub_segments():
        sub_segment_points = sub_segment.get_resolved_geometry().get_points()
        if sub_segment.was_geometry_reversed_in_topology():
            # Reverse the sub-segment points.
            sub_segment_points = sub_segment_points[::-1]
        resolved_line_points.extend(sub_segment_points)

    return pygplates.PolylineOnSphere(resolved_line_points)

get_property()

Returns the feature property containing the topological line property associated with this ResolvedTopologicalLine.

Return type: Property

This is the Property that the get_resolved_line() and get_resolved_geometry() are obtained from.

get_resolved_feature()

Returns a feature containing the resolved line geometry.

Return type: Feature

The returned feature contains the static resolved geometry. Unlike get_feature() it cannot be used to generate a ResolvedTopologicalLine via resolve_topologies().

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 topologies are resolved (not reconstructed).