Versions Compared

Key

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

Table of Contents
typeflat
separatorpipe

MARS

...

Specifies the desired sub-area of the data to be extractedretrieved.

area=<value>

For If specified for fields, the specification of the area keyword requests a will trigger some post-processing. The input fields to this operation can be

  • spherical harmonics
  • regular lat/lon grids
  • global regular Gaussian grids
  • global reduced Gaussian grids, including the octahedral reduced Gaussian grid
  • wave fields

The As the target field needs to be gridded and it should therefore be specified in the same request using the keyword grid. 

A horizontal sub-area is in general defined by a list of its latitude/longitude coordinates North/West/South/East in decimal degrees. If South > North, the values are automatically swapped and a warning issued. Latitude/longitude coordinates must be given as signed numbers as follows:

  • Northern Latitudes latitudes (north of the equator) must be given as positive numbers
  • Southern Latitudes latitudes (south of the equator) must be given as negative  numbers
  • Eastern longitudes (east of the 0 degree meridian) must be given as positive numbers
  • Western longitudes (east west of the 0 degree meridian) must be given as negative numbers

...

valuecomment
North/West/South/East

latitude/longitude coordinates of sub-area

Especifies the European area 73.5/-27/33/45
G specifies  the global area  90/0/-90/360 (default)

If the longitude values overlap, the most eastern line of points will not be returned, e.g.

AREA=90/-180/-90/180, 
GRID=0.5/0.5

will return a field with the boundaries 90/-180/-90/179.5. 

Areas can be defined to wrap around the globe, e.g. in order to retrieve all longitudes but Europe one would specify area=75/60/10/-20.

MARS (with MIR) can work with also supports shifted grids, with no point at latitude=0, longitude=0, e.g. 

AREA=89.5/0.5/-89.5/359.5, 
GRID=1.0/1.0

This is done automatically provided the differences between N-S and E-W limits are both divisible by the corresponding grid increments without remainder. Shifted Grid

...

In cases where the differences between N-S and E-W limits are not divisible by the corresponding increments without remainder, MARS starts from the user-specified south-west corner and goes up to (but does not exceed) the north-east corner.  For example, a request specifying:

AREA=55.5/0.5/45.0/5.0, 
GRID=1.0/1.0

retrieves AREA=55.0/0.5/45.0/4.5 with the northern and eastern boundaries adjusted so that the area returned lies within that specified by the request and includes a point at latitude=0, longitude=0.

...

Area examples

area=90/-180/-90/180

area=90/0/-90/360
Image Added

area=75/-25/10/60

area=75/-15/30/42.5

area=73.5/-27/33/45 (equivalent to area=E)


area=40/-20/-40/60

area=50/-135/-60/-30

area=40/60/-60/180

...
area=74/60/10/-20,
grid=1/1,
frame=3,

...

specifies a frame three grid points wide with the outer limits 74/60/10/-20 and inner limits 72/58/8/-18.


For observations, the area keyword is used as a filter. 

Dissemination

The keyword is used as with MARS, but mandatory in dissemination.


Excerpt Include
Keywords in MARS and Dissemination requests
Keywords in MARS and Dissemination requests
nopaneltrue

...