Reconstruct Points

Reconstruct Points(Location Coordinates)

Description:

Reconstruct the geographic locations from present day coordinates back to their paleo-positions. Each location will be assigned a plate id and moved back in time using the chosen reconstruction model. http GET request to reconstruct points

Endpoint:

https://gws.gplates.org/reconstruct/reconstruct_points/

Parameters:

points : list of points lon,lat comma separated coordinates of points to be reconstructed [Required]

anchor_plate_id : integer value for reconstruction anchor plate id [default=0]

time : time for reconstruction [required]

model : name for reconstruction model [defaults to default model from web service settings]

pids : specify plate id for each point to improve performance

pid : specify plate id to improve performance. all points use the same plate id

reverse : the flag to control the direction of reconstruction. If this flag is in the url, the function will calculate the present-day coordinates of the given paleo-coordinates.

fc : feature collection. If this flag exists, the function will return a GeoJSON feature collection.

return_null_points : If this flag exists, the function will return null points. The null points happen when the present-day location does not exist back in the given time. Note: The return data will NOT be in a valid GeoJSON format.

ignore_valid_time : if this flag presents itself, the reconstruction will ignore the "valid time" constraint and will always return coordiates, even the coordiates do not make sense(out of valid time). Use with caution.

Returns:

Reconstructed coordinates in GeoJSON format.

Examples:

E1: Reconstruct two coordinates((lon:95,lat:54)(lon:142,lat:-33)) back to 140 million years ago using the "SETON2012" reconstruction model. The function returns the reconstructed coordinates in the valid GeoJSON format.

Return: {"type":"MultiPoint","coordinates":[[84.99,59.26],[123.37,-65.76]]}

E2: Reverse reconstruct the two paloe-coordinates ((lon:84.99,lat:59.26)(lon:123.37,lat:-65.76)) to present day.

Return: {"type":"MultiPoint","coordinates":[[95.01,54.00],[142.00,-33.00]]}

E3: Return GeoJSON feature collection. The function will not only return the paleo-coordinates, but also the time period in which the location exists.

Return: {"type":"FeatureCollection","features":[{"type":"Feature","geometry":{"type":"Point","coordinates":[84.99,59.26]},"properties":{"valid_time":[600.0,"distant future"]}}]}

E4: Return null points. The null points happen when the present-day locations do not exist back in the given time. The return data will NOT be in a valid GeoJSON format, although the it is valid JSON.

Return: {"type":"MultiPoint","coordinates":[[-56.84,47.13],null,[89.38,52.58]]}

E5: Return 999.99 for the invalid points. The invalid points happen when the present-day locations do not exist back in the given time. The return data will be in a valid GeoJSON format.

Return: {"type":"MultiPoint","coordinates":[[-56.84,47.13],[999.99,999.99],[89.38,52.58]]}

E6: Use POST to reconstruct a large number of locations. See the example at https://github.com/GPlates/gplates-web-service/blob/master/python/gplatesws.ipynb

E7: Provide plate ID to improve performance. All points use the same pid.

Return: {"type": "MultiPoint", "coordinates": [[110.4975, 29.7166], [123.374, -65.7611]]}

E8: Provide plate IDs to improve performance. One pid for each point.

Return: {"type": "MultiPoint", "coordinates": [[110.4975, 29.7166], [-164.6523, -52.7301]]}

Reconstruct Motion Path

Reconstruct Static Plate Polygons