pygplates.ResolvedTopologicalLine

class pygplates.ResolvedTopologicalLine

Bases: ReconstructionGeometry

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

TopologicalModel, TopologicalSnapshot or resolve_topologies() 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_geometry_point_features`()	Returns the source feature associated with each point in the `resolved geometry points`.
`get_resolved_geometry_point_velocities`(...)	Returns the velocities of the `resolved geometry points`.
`get_resolved_geometry_points`()	Returns the points of the `resolved geometry`.
`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 TopologicalModel, TopologicalSnapshot or 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 TopologicalModel, TopologicalSnapshot or 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_geometry_point_features()

Returns the source feature associated with each point in the resolved geometry points.

Return type:: list of Feature

The motion of each point in the resolved geometry is determined by its source feature. And the source features are the building blocks from which topologies are assembled and resolved.

To associate each source feature with its point (in a resolved topological line):

points = resolved_topological_line.get_resolved_geometry_points()
point_features = resolved_topological_line.get_resolved_geometry_point_features()

points_and_features = zip(points, point_features)

for point, feature in points_and_features:
  ...

Added in version 1.0.

get_resolved_geometry_point_velocities([velocity_delta_time=1.0][, velocity_delta_time_type=pygplates.VelocityDeltaTimeType.t_plus_delta_t_to_t][, velocity_units=pygplates.VelocityUnits.kms_per_my][, earth_radius_in_kms=pygplates.Earth.mean_radius_in_kms])

Returns the velocities of the resolved geometry points.

Parameters:

velocity_delta_time (float) – The time delta used to calculate velocities (defaults to 1 Myr).
velocity_delta_time_type (VelocityDeltaTimeType.t_plus_delta_t_to_t, VelocityDeltaTimeType.t_to_t_minus_delta_t or VelocityDeltaTimeType.t_plus_minus_half_delta_t) – How the two velocity times are calculated relative to the reconstruction time. This includes [t+dt, t], [t, t-dt] and [t+dt/2, t-dt/2]. Defaults to [t+dt, t].
velocity_units (VelocityUnits.kms_per_my or VelocityUnits.cms_per_yr) – whether to return velocities as kilometres per million years or centimetres per year (defaults to kilometres per million years)
earth_radius_in_kms (float) – the radius of the Earth in kilometres (defaults to pygplates.Earth.mean_radius_in_kms)

Return type:

list of Vector3D

To associate each velocity with its point (in a resolved topological line):

points = resolved_topological_line.get_resolved_geometry_points()
point_velocities = resolved_topological_line.get_resolved_geometry_point_velocities()

points_and_velocities = zip(points, point_velocities)

for point, velocity in points_and_velocities:
  ...

Added in version 0.50.

get_resolved_geometry_points()

Returns the points of the resolved geometry.

Return type:: list of PointOnSphere

This method is essentially equivalent to:

def get_resolved_geometry_points(resolved_topological_line):
    return resolved_topological_line.get_resolved_geometry().get_points()

See also

GeometryOnSphere.get_points()

Added in version 0.50.

get_resolved_line()

Returns the resolved line geometry.

Return type:: PolylineOnSphere