gplately.reconstruct_points

gplately.reconstruct_points(lons: list[float], lats: list[float], model_name: str, times: float | list[float], pids: int | list[int] | None = None, valid_time: tuple[float, float] | list[tuple[float, float]] | None = None, anchor_plate_id: int = 0, ignore_valid_time: bool = False, reverse: bool = False)[source]

Reconstruct points to the given time(s).

Parameters:

  • lons (a list of float) – The longitudes of points.

  • lats (a list of float) – The latitudes of points.

  • model_name (str) – The plate model name.

  • times (float or a list of float) – The reconstruction time(s)

  • pids (a list of int, int or None, optional, default=None) – Allow user to provide plate IDs to speed up the reconstruction. If user provided pids without valid_time. The reconstruction will not consider the valid time range, same as ignore_valid_time.

  • valid_time (tuple of 2, a list of tuple of 2, or None, optional, default=None) – Allow user to provide valid times for points.

  • anchor_plate_id (int, optional, default=0) – The anchor plate ID.

  • ignore_valid_time (bool, optional default=False) – If True, reconstruct the points without considering the valid time range.

  • reverse (bool, optional, default=False) – If True, do reverse reconstruction to present-day (0Ma). The reverse reconstruction works only with a single reconstruction time.

Returns:

The returned dict contains:

  • lons

  • lats

  • pids (plate IDs)

  • begin_times

  • end_times

  • time (the reconstruction time)

Return type:

A list of dict.