assemble [ parameter=value ... ] [ inputfile ... outputfile ]
Parameters are: include_vars, extend_names, instantiate, keep_hist.
The function assemble takes variables from multiple TeraScan datasets and combines them into a single 'assembled' dataset. Variables can either be linked or copied. (See subset.) The user can specify which variables to include.
If variables from two input datasets have the same named dimension (e.g., line), the size of that dimension must be the same in both datasets.
You can choose to let assemble rename conflicting variable names by adding an extension to each name containing the name of the input file.
The variables to include in the assembled file. If the list is prefixed with a minus sign, the listed variables are excluded from the assembly. Wildcards * and ? are allowed.
The default is to include all variables.
extends the name by adding the name of the input file to the varaible name. This avoids name conflicts between variables.
Valid responses are [yes, no]. The default is yes.
Whether to instantiate (copy the variable data) to the assembled file. If no, the assembled file contains pointers to the input files. This saves disk space.
Valid responses are [yes, no]. The default is no.
OPTIONAL. If keep_hist=yes, then the command and input file histories are appended to the output file history (see audit and hist). This is the usual case with most TeraScan functions. However, since the number of input files in this case is presumed large, this would result in a very large history attribute, and, by default, the history is not appended for this function.
Valid responses are [yes, no]. The default is no. This parameter can only be set by an explicit specification on the command line.
The following example takes all GOES-7 images with the .reg extension and creates a file called g7.assemble containing the variable vas_visible of each input file. The variable is given an extension for each file. g7.assemble contains pointers to variables in the original files.
temp% assemble in/out files : char(255) ? g7.*.reg g7.assemble include_vars : char(255) ? [] vas_visible extend_names : char( 3) ? [yes] instantiate : char( 3) ? [no]
Last Update: $Date: 1998/05/28 19:48:28 $