Hosted by CU logo University of Colorado
Boulder
Powered by ESGF-CoG logo
Welcome, Guest. | Login | Create Account
OpenClimateGIS logo
You are at the CoG-CU node
 

Example URLs (NCPP Tech Demo 2012-10-29)

These URLs are not "live" in the sense that they rely on a local server and copy of OCGIS. If you happen to a have a development server accessible at the proper IP address and with OCGIS installed, then they will work. These are URL formats for OCGIS v0.01a.

Inspect a dataset returning a plain text description of the dimensions identified by OCGIS and a dump of its attributes, variables, and dimensions.

(1) http://127.0.0.1:8000/inspect/uid/none?uri=/usr/local/climate_data/CanCM4/tasmin_day_CanCM4_decadal2000_r2i1p1_20010101-20101231.nc

 
A "snippet" is small chunk of the dataset useful for quickly examining spatial relationships and ensuring the data is readable and returned in the expected format.
 
(2) http://127.0.0.1:8000/snippet/uid/5/variable/tasmin?prefix=snippet_tasmin
(This is equivalent to "wget -O snippet_tasmin.zip http://127.0.0.1:8000/snippet/uid/5/variable/tasmin".)
 
Some common shapefile-based geometric datasets are accessible by OCGIS. Users will be able to upload their own datasets.
 
(3) http://127.0.0.1:8000/shp/co_watersheds
(4) http://127.0.0.1:8000/shp/state_boundaries
 
These are snippets bounded by a selection geometry.
 
(5) http://127.0.0.1:8000/snippet/uid/5/variable/tasmin?prefix=snippet_co_watersheds&space=co_watersheds
(6) http://127.0.0.1:8000/snippet/uid/5/variable/tasmin?prefix=snippet_state_boundaries&space=state_boundaries
 
The common form of a typical subset URL with a bounding box (min_x|min_y|max_x|max_y):
 
(7) http://127.0.0.1:8000/uid/5/variable/tasmin/level/none/time/none/space/-109.06128|36.94111|-101.9751|41.07107/operation/clip/aggregate/true/output/keyed?prefix=tasmin_CanCM4_co_bb
 
Same request but replacing the selection box with a CO watershed geometries (HUC8):
 
(8) http://127.0.0.1:8000/uid/5/variable/tasmin/level/none/time/none/space/co_watersheds/operation/clip/aggregate/true/output/keyed?prefix=tasmin_CanCM4
 
Changing the output format to "meta" results in a plain text description of the operations OCGIS will perform. No data is touched. This is a calculation URL. By using "meta", the operations are certain to at least be interpreted by OCGIS.
 
(9) http://127.0.0.1:8000/uid/6/variable/tasmin/level/none/time/none/space/co_watersheds/operation/clip/aggregate/true/output/meta?prefix=calc_tasmin_CanCM4&
calc=max_cons~max_cons_lte_0c_tasmin!threshold~273.175!operation~lte|mean~mean_tasmin|std~std_tasmin|min~min_tasmin|max~max_tasmin&calc_grouping=month|year&calc_raw=false
 
URL shorteners are okay.
 
(10) http://goo.gl/ilt9X
 
This URL will perform computations and return data in a keyed format. Keyed formats maximize data reduction by generating files containing unique values. No data is unnecessarily replicated.
 
(11) http://127.0.0.1:8000/uid/6/variable/tasmin/level/none/time/none/space/co_watersheds/operation/clip/aggregate/true/output/keyed?prefix=calc_tasmin_CanCM4&calc=max_cons~max_cons_lte_0c_tasmin!threshold~273.175!operation~lte|mean~mean_tasmin|std~std_tasmin|min~min_tasmin|max~max_tasmin&calc_grouping=month|year&calc_raw=false
 
A URL for a multivariate heat index calculation.
 
(12) http://127.0.0.1:8000/uid/4|9/variable/tas|rhs/level/none/time/none/space/state_boundaries/operation/intersects/aggregate/false/output/meta?calc=heat_index~hi!tas~tas!rhs~rhs!units~K&calc_grouping=day|month|year
Last Update: Oct. 29, 2012, 1:14 p.m. by Allyn Treshansky