NAME

raw2wasp - Transform and write a raw data volume into a NetCDF WASP file.

SYNOPSIS

raw2wasp [options] waspfile datafile

DESCRIPTION

raw2wasp reads a 3D or 2D volume of data from disk, wavelet transforms the data, and stores it in file waspfile. The data volume must be stored on disk as a contiguous array of unformatted binary floating point values (32bit precision by default) with no header or trailer information. The dimensions of the raw data volume must match those specified in waspfile. The file indicated by waspfile must be a valid WASP file created, for example, by the waspcreate command.

OPTIONS

-debug

Enable diagnostics.

-varname <name>

This option specifies name of the variable that the raw data volume corresponds too. The name must match either a 2D or 3D variable name in the WASP indicated by waspfile. If name matches a 2D variable, a 2D slice of data expected to be contained in datafile. If name matches a 3D variable, raw2wasp will attempt to read a 3D data volume from datafile. The dimensions of the volume/slice contained in datafile must match those of the corresponding variable defined in waspfile.

-type <type>

Primitive data type of the data stored in datafile. Supported values are 'float32', 'float64', and 'int32'.

-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 all refinement levels are output. This option can be used to reduce the refinement levels output. A value 0 implies coarsest, 1 => next refinement, and so on. The value -1 is synonymous with the highest refinement level available.

-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 platforms the number of processors available is the result of the system call, sysconf(_SC_NPROCESSORS_ONLN).

EXAMPLES

The command

waspcreate -dimlens 256:256:256 -dimnames Nz:Ny:Nx vx:NC_FLOAT:3:Nz:Ny:Nx

followed by

raw2wasp -varname vx test.nc vx.float

would transform the volume stored in the file vx.float and write it into the WASP file associated with the test.nc file. This assumes that the array stored in file vx.float has dimensions 256x256x256 and the elements are stored as 32-bit floats.

SEE ALSO

waspcreate, wasp2raw

HISTORY

Last updated on $Date$