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]

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.

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. Available Reconstruction Models

URL: https://gws.gplates.org/reconstruct/reconstruct_points/?points=95,54,142,-33&time=140&model=SETON2012

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.

URL: https://gws.gplates.org/reconstruct/reconstruct_points/?points=84.99,59.26,123.37,-65.76&time=140&model=SETON2012&reverse

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.

URL: https://gws.gplates.org/reconstruct/reconstruct_points/?points=95,54&time=140&model=SETON2012&fc

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.

https://gws.gplates.org/reconstruct/reconstruct_points/?points=-100,50,160,10,100,50&time=100&model=PALEOMAP&return_null_points

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.

https://gws.gplates.org/reconstruct/reconstruct_points/?points=-100,50,160,10,100,50&time=100&model=PALEOMAP

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