Child pages
  • NCSS subset parameters table (old)

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

--> BBOX provided must intersect or be contained into the declared???

NCSS Use Cases and Request Strings for Grid Requests

Single Variable Requests

Note that these single variable requests can be easily extended to multivariable request by simply passing a comma separated list of variables in the var= parameter. Please note that variables in the list must have the same vertical coordinate when using the vertCoord parameter (requesting data from a single vertical level) - if they do not have the same vertical coordinate, then the data returned will be incorrect (yes, you will get numbers, but they will not all be contained on the level you are requesting).

Basic Request:

"Give me all of the data for the variable Temperature_pressure"

Most simple request: ?var=Temperature_pressure

var

Spatial

Horizontal Stride

Temporal

Temporal Stride

Vertical Coordinate

Temperature_pressure

 

 

 

 

 

 

 

 

 

 

 

Temperature_pressure

spatial=all

- OR -

north=90.0000&
west=0.0000&
east=-0.5000&
south=-90.0000

(Using full grid bounds)



- OR -

net set

temporal=all

- OR -

time_start=YYYY-MM-DDThh:mm:ss.sTZD& 
time_end=YYYY-MM-DDThh:mm:ss.sTZD

(Using full temporal bounds)

1

- OR -

not set

not set

* blank cells indicates parameter is not set (i.e. horStride=) or is not included in request string

Single variable request within a bounding box:

"Give me all of the data for the variable Temperature_pressure from the Global GFS model over the state of Colorado"

Most simple request: ?var=Temperature_pressure&north=41&west=-109.05&east=-102.05&south=37

var

Spatial

Horizontal Stride

Temporal

Temporal Stride

Vertical Coordinate

Temperature_pressure

north=41&
west=-109.05&
east=-102.05&
south=37

 

 

 

 

 

 

 

 

 

 

Temperature_pressure

north=41&
west=-109.05&
east=-102.05&
south=37

1

- OR -

not set

temporal=all

- OR -

time_start=YYYY-MM-DDThh:mm:ss.sTZD& 
time_end=YYYY-MM-DDThh:mm:ss.sTZD

(Using full temporal bounds)

1

- OR -

not set

not set

Single variable request with an even horizontal stride across the entire grid:

"Give me the variable Temperature_pressure for every 5th data point on the grid (deltax = deltay = 5), on all vertical levels (if any exist)"
Most simple request: ?var=Temperature_pressure&horStride=5

var

Spatial

Horizontal Stride

Temporal

Temporal Stride

Vertical Coordinate

Temperature_pressure

 

Wiki Markup
5 \[integer > 0\]

 

 

 

 

 

 

 

 

 

Temperature_pressure

spatial=all

- OR -

north=90.0000&
west=0.0000&
east=-0.5000&
south=-90.0000

(Using full grid bounds)

Wiki Markup
5 \[integer > 0\]

temporal=all 

- OR -

time_start=YYYY-MM-DDThh:mm:ss.sTZD& 
time_end=YYYY-MM-DDThh:mm:ss.sTZD

(Using full temporal bounds)



- OR -

not set

not set

Single variable request with an even horizontal stride inside a bounding box:

"Give me every 5th data point in (deltas = deltay = 5), on all vertical levels (if any exist), from the Global GFS model over the state of Colorado"

Most simple request: ?var=Temperature_pressure&north=41&west=-109.05&east=-102.05&south=37&horStride=5

var

Spatial

Horizontal Stride

Temporal

Temporal Stride

Vertical Coordinate

Temperature_pressure

north=41&
west=-109.05&
east=-102.05&
south=37

Wiki Markup
 5 \[integer > 0\]

 

 

 

 

 

 

 

 

 

Temperature_pressure

north=41&
west=-109.05&
east=-102.05&
south=37


Wiki Markup
5 \[integer > 0\]

temporal=all 

- OR -

time_start=YYYY-MM-DDThh:mm:ss.sTZD& 
time_end=YYYY-MM-DDThh:mm:ss.sTZD

(Using full temporal bounds)



- OR -

not set

not set

Single variable request with on a particular vertical level:

"Give me all of the data for the variable Temperature_pressure at 1000 mb"

Most simple request: ?var=Temperature_pressure&vertCoord=1000

var

Spatial

Horizontal Stride

Temporal

Temporal Stride

Vertical Coordinate

Temperature_pressure

 

 

 

 

1000*

 

 

 

 

 

 

Temperature_pressure

spatial=all

- OR -

north=90.0000&
west=0.0000&
east=-0.5000&
south=-90.0000

(Using full grid bounds)


1

- OR -

not set

temporal=all 

- OR -

time_start=YYYY-MM-DDThh:mm:ss.sTZD& 
time_end=YYYY-MM-DDThh:mm:ss.sTZD

(Using full temporal bounds)



- OR -

not set

vertical level (value
must be in the same units used
in the dataset)

* note that the vertical level value must be in the same units used in the dataset - in this example we assume millibars but you will need to check the dataset description to be sure.