Reconstruct

michaelchin edited this page Oct 30, 2018 · 4 revisions

The 'reconstruct' functions provide the basic reconstruction functionality familiar from the GPlates GUI. These include the ability to

  • return standard reconstructed features (e.g. coastlines, isochrons, tectonic block outlines) from one of the reconstruction models available from the web service)
  • reconstruct point coordinates provided as part of the http request
  • generate features that track the reconstructed motion of plates through time

Reconstruct Points(Location Coordinates)

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. The return data will not be valid GeoJSON.

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 valid GeoJSON.

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]]}

reconstruct/coastlines

http GET request to retrieve reconstructed coastline polygons

usage

http-address-to-gws/reconstruct/coastlines/plate_id=*anchor_plate_id*&time=*reconstruction_time*&model=*reconstruction_model*

parameters:

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]

returns:

json containing reconstructed coastline features


reconstruct/static_polygons

http GET request to retrieve reconstructed static polygons

usage

http-address-to-gws/reconstruct/static_polygons/plate_id=*anchor_plate_id*&time=*reconstruction_time*&model=*reconstruction_model*

parameters:

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]

returns:

json containing reconstructed coastline features


reconstruct/motion_path

http GET request to retrieve reconstructed static polygons

usage

http-address-to-gws>/reconstruct/motion_path/seedpoints=*points*&timespec=*time_list*&fixplate=*fixed_plate_id*&movplate=*moving_plate_id*&time=*reconstruction_time*&model=*reconstruction_model*

seedpoints : integer value for reconstruction anchor plate id [required]

timespec : specification for times for motion path construction, in format 'mintime,maxtime,increment' [defaults to '0,100,10']

time : time for reconstruction [default=0]

fixplate : integer plate id for fixed plate [default=0]

movplate : integer plate id for moving plate [required]

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

returns:

json containing reconstructed motion path features


reconstruct/reconstruct_feature_collection

http GET request to reconstruct a geojson feature. Each feature will be assigned a plate id and moved back in time using the given reconstruction model. Input must be specified as geojson in the http string, and reconstructed features will be returned in GeoJSON format.

[TODO - currently the 'time' parameter is actually specified as 'geologicage', need to make consistent with other apps]

usage

http-address-to-gws>/reconstruct/reconstruct_feature_collection/?time=*reconstruction_time*&feature_collection=*geojson*&idfield=*id_field_name*

parameters:

points : geojson feature collection to be reconstructed [Required]

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

geologicage : time for reconstruction [required]

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

returns:

reconstructed geojson feature collection

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.