<<prev file | next file >>    view single page | view frames    summary: fields | routine    details: routine

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.

topread_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

Statistics

McCabe cyclic 116
McCabe essential 1
McCabe modular design 1
Produced by IDLdoc 2.0.