pygplates.ResolvedTopologicalBoundary

class pygplates.ResolvedTopologicalBoundary

Bases: pygplates.ReconstructionGeometry

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

The resolve_topologies() function can be used to generate ResolvedTopologicalBoundary 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_boundary_sub_segments()

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

get_feature()

Returns the feature associated with this ResolvedTopologicalBoundary.

get_geometry_sub_segments()

Same as get_boundary_sub_segments().

get_property()

Returns the feature property containing the topological boundary property associated with this ResolvedTopologicalBoundary.

get_reconstruction_time()

Returns the reconstruction time that this instance was created at.

get_resolved_boundary()

Returns the resolved boundary geometry.

get_resolved_feature()

Returns a feature containing the resolved boundary geometry.

get_resolved_geometry()

Same as get_resolved_boundary().

get_boundary_sub_segments()

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

Return type

list of ResolvedTopologicalSubSegment

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

sub_segment_geometries = []
for sub_segment in resolved_topological_boundary.get_boundary_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 boundary:

sub_segment_geometries = []
for sub_segment in resolved_topological_boundary.get_boundary_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_boundary() (except rubber banding points, if any, between adjacent sub-segments are included below but not in get_resolved_boundary()):

def get_resolved_boundary(resolved_topological_boundary):

    resolved_boundary_points = []
    for sub_segment in resolved_topological_boundary.get_boundary_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_boundary_points.extend(sub_segment_points)

    return pygplates.PolygonOnSphere(resolved_boundary_points)
get_feature()

Returns the feature associated with this ResolvedTopologicalBoundary.

Return type

Feature

Note

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

get_geometry_sub_segments()

Same as get_boundary_sub_segments().

get_property()

Returns the feature property containing the topological boundary property associated with this ResolvedTopologicalBoundary.

Return type

Property

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

get_resolved_boundary()

Returns the resolved boundary geometry.

Return type

PolygonOnSphere

get_resolved_feature()

Returns a feature containing the resolved boundary geometry.

Return type

Feature

The returned feature contains the static resolved geometry. Unlike get_feature() it cannot be used to generate a ResolvedTopologicalBoundary 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_boundary().