ToBeReviewed/LECTURE/
read_ncdf.pro
Reading function for the file net_cdf.
This program is less universal than ncdf_lec (it appeal to declared
variables in common.pro) but it is very easier to be used. It considerate
the declaration of the different zooms which have been defined
(ixminmesh...premierx...), the declaration of the variable key_shift...
To put it in a nutshell, the result of read_ncdf can be directly used in plt...
This is also this program which is used by default in our reading widgets.
read_ncdf
Reading
result = read_ncdf(name, beginning, ending, compatibility, BOXZOOM=BOXZOOM, FILENAME=string, PARENTIN=PARENTIN, TIMESTEP=TIMESTEP, TIMEVAR=string, TOUT=TOUT, NOSTRUCT=NOSTRUCT, CONT_NOFILL=CONT_NOFILL, INIT=INIT, GRID=GRID, FBASE2TBASE=FBASE2TBASE, _EXTRA=_EXTRA)
Return value
Structure readable by litchamp.pro or an array if NOSTRUCT is activated.
Parameters
name
in
required
type: string
It define the field to be read.
beginning
in
required
Relative with the time axis.
These can be
- 2 date of the type yyyymmdd and in this case, we select dates
which are included between these two dates.
- 2 indexes which define between which and which time step we have
to extract the temporal dimension.
ending
in
required
Relative with the time axis.
See BEGINNING.
compatibility
in
required
Useless
Keywords
BOXZOOM
Contain the boxzoom on which we have to do the reading
FILENAME
type: string
It contains he file's name.
PARENTIN
TIMESTEP
We activate to specify that BEGINNING and ENDING refer to indexes
of the time axis and not to dates
TIMEVAR
type: string
It define the name of the variable that
contains the time axis. This keyword can be useful if there
is no unlimited dimension or if the time axis selected by default
(the first 1D array with unlimited dimension) is not the good one.
TOUT
We activate it if we want to read the file on the whole domain without
considerate the sub-domain defined by the boxzoom or
lon1,lon2,lat1,lat2,vert1,vert2.
NOSTRUCT
We activate it if we do not want that read_ncdf send back a structure
but only the array referring to the field.
CONT_NOFILL
INIT
To call automatically initncdf, filename and thus
redefine all the grid parameters
GRID
='[UTVWF]' to specify the type of grid. Default is (1)
based on the name of the file if the file ends by
GRID[._][TUVFW].NC (not case sensible) or (2) T if case (1)
is not found.
FBASE2TBASE
_EXTRA
Used to pass your keywords
Version history
Version
$Id: read_ncdf.pro 157 2006-08-21 09:01:50Z navarro $
History
Sebastien Masson (smasson@lodyc.jussieu.fr)
15/10/1999
Known issues
Restrictions
The field must have a temporal dimension.
Other attributes
Uses routines
common.pro
Produced by IDLdoc 2.0 on Tue Aug 29 14:50:06 2006.