NAME

wasp2raw - Inverse transform a variable found in a NetCDF WASP file and store the results in output file as a raw binary array.

SYNOPSIS

wasp2raw [options] waspfile datafile

DESCRIPTION

wasp2raw extracts a variable from the WASP file waspfile, decompresses the variable (if compressed), and stores the results in the file indicated by datafile. The data are written as a contiguous array of unformatted binary floating point values. The X dimension varies fastest, followed by Y, then Z. Data are written at 32 bit precision in the native format of the machine where wasp2raw is run.

OPTIONS

-varname <name>

This option specifies name of the variable to extract.

-lod <n>

Compressed variables are stored with a finite number of fixed refinement levels determined by the number of compression ratios specified in the waspfile file. By default the maximum refinement level is output. This option can be used to reduce the refinement level output. A value 0 implies coarsest, 1 => next refinement, and so on. The value -1 is synonymous with the highest refinement level available.

-level <level>

Compressed variables in a WASP file are represented by a multiresolution hierarchy. This option specifies which level in the hierarchy to extract the variable from. A value of 0, the default, indicates the coarsest level in hierarchy. A value of 1 implies the first refinement level, and so on. The special value, -1, is synonymous with the native data resolution, whatever level that may be.

-nthreads <n>

This option can be used to specify the number of execution threads to be employed when transforming data. The default value of n is 0, which causes the application to query the operating system to find the number of processors available, and then use that value. For most platformsthe number of processors available is the result of the system call, sysconf(_SC_NPROCESSORS_ONLN).

-start <start>

A colon-delimited NetCDF style start coordinate vector used to select an offset into the array. This option together with the -count option can be used to restrict output to a rectangular subset of the array.

-count <count>

A colon-delimited NetCDF style count coordinate vector used to specify dimensions of a subset of the array to output. This option together with the -count option can be used to restrict output to a rectangular subset of the array.

-type <type>

Primitive data type of the data to be output to datafile. Supported values are 'float32', 'float64', and 'int32'.

EXAMPLES

The command

wasp2raw -varname vx test.nc vx.float

would reconstruct the variable with name vx from the file indicated by foo.nc, and write the results to the file vx.float. The data would be extracted at their native grid resolution, and maximum refinement level.

The command

wasp2raw -lod 0 -varname vx foo.wasp vx.float

would perform identically to the one above except that the coarsest approximation would be extracted for variable vx.

SEE ALSO

waspcreate, raw2wasp

An Overview of VAPOR Data Collections

HISTORY

Last updated on $Date$