expasc - Export variable data in ASCII format

SYNOPSIS

expasc  [ parameter=value ... ]  [ inputfile outputfile ]
expasc  [ parameter=value ... ]  [ inputfile ... directory ]

Parameters are: include_vars, all_same_dim, bad_string, list_dims.

DESCRIPTION

expasc exports TeraScan dataset variable data to ASCII UNIX disk files. Dataset definitions are not exported.

Output data can be sorted by element or by leading dimension:

by element  - <var 1 elem 1> <var 2 elem 1> ...
              <var 1 elem 2> <var 2 elem 2> ...
              ...

by lead dim - <var 1 row 1 data> <var 2 row 1 data> ...
              <var 1 row 2 data> <var 2 row 2 data> ...
              ...

In the first case, all exported variables must have the same dimensions. In the latter case, all exported variables must have the same leading dimension.

Variable scale and offset attributes are automatically applied prior to output.

Variables with units of std_date and std_time are converted to yyyymmdd and hhmmss, respectively.

Data values on a given text line are separated by tabs.

PARAMETERS

include_vars

Specifies the list of variables to export. If the list is preceded by a minus sign, all variables except those listed will be exported. Wildcards * and ? are allowed. The default is to export all variables.

all_same_dim

Specifies whether or not one element for each variable is output per line. Otherwise, all elements corresponding to a given leading dimension index are output on the same line. See above. Valid responses are [yes, no]. The default is yes.

bad_string

OPTIONAL. Specifies the string used for bad (missing) data output. Valid responses are strings no longer than 31 characters. The default is ***.

list_dims

Specifies whether or not each line of output data is to be preceded by corresponding 1-relative dimension indexes. If all_same_dim=yes, indexes for each dimension will be shown. Otherwise, only the index of the leading dimension will be shown. Valid responses are [yes, no]. The default is yes.

EXAMPLES

The following exports all variables in new7 starting with the letters av, writing one line per element to the output file.

temp [10] % expasc new7 exp
include_vars   : char(255) ? [] av*
all_same_dim   : char(  3) ? [yes]
list_dims      : char(  3) ? [yes]

temp [1] % cat exp
1       1       7.2     34.03
1       2       6.99    33.85
1       3       7.1     32.8
1       4       7.2     33.15
:

SEE ALSO

expbin, impasc, impbin, impbin1, printvar

NOTES

A better name for the all_same_dim parameter is line_per_elem. See printvar.

Exporting image variables with all_same_dim=no will create ASCII files with incredibly long lines.