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).

See also

get_feature()

get_resolved_geometry()

Same as get_resolved_line().

get_resolved_line()

Returns the resolved line geometry.

Return type:PolylineOnSphere