concatenate [ parameter=value ... ] [ inputfile ... outputfile ]
Parameters are: include_vars, along_dim_name, along_dim, keep_hist.
The function concatenate joins all the included variables from the input files along one dimension and places the newly dimensioned variables in the output file.
The variables to include in the assembled file. If the list is preceded by a hyphen, followed by a space, then the variables in the list are excluded from the assembled file, and all other variables in the input files are included.
Valid responses are any variable names in the input files, properly delimited (space or comma). The default is to include all variables.
The name of the dimension along which concatenate will join variables.
This parameter is OPTIONAL; it will not be used unless it is set to a non-blank value on the command line.
The dimension along which concatenate will join variables.
Valid responses are [1 to number-of-dimensions]. The default is 1.
This parameter is not used if along_dim_name is used.
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 value is no. This parameter can only be set by an explicit specification on the command line.
This is a printout of two datasets before concatenate has been performed.
zeus% printvar dummy2 dummy3 include_vars : char(255) ? [] line_per_elem : char( 3) ? [yes] n list_dims : char( 3) ? [yes] n printout : char( 3) ? [no] Printvar dummy2 Page 1 x 1 2 3 4 5 2 3 4 5 6 3 4 5 6 7 4 5 6 7 8 ^L Printvar dummy3 Page 1 x 255 255 255 255 255 255 3 4 5 255 255 4 5 6 255 255 255 255 255 255
Now we will concatenate the files along the first dimension. This will stack the files.
zeus% concatenate dummy2 dummy3 dummy4 include_vars : char(255) ? [] x along_dim : int ? [1]
This is a printout of the stacked data.
zeus% printvar dummy4 include_vars : char(255) ? [] line_per_elem : char( 3) ? [yes] n list_dims : char( 3) ? [yes] n printout : char( 3) ? [no] Printvar dummy4 Page 1 x 1 2 3 4 5 2 3 4 5 6 3 4 5 6 7 4 5 6 7 8 255 255 255 255 255 255 3 4 5 255 255 4 5 6 255 255 255 255 255 255
Now we will concatenate the files along the second dimension. This will concatenate the files side by side.
zeus% concatenate dummy2 dummy3 dummy5 include_vars : char(255) ? [] x along_dim : int ? [1] 2
This is the printout of the side by side data.
zeus% printvar dummy5 include_vars : char(255) ? [] line_per_elem : char( 3) ? [yes] n list_dims : char( 3) ? [yes] n printout : char( 3) ? [no] Printvar dummy5 Page 1 x 1 2 3 4 5 255 255 255 255 255 2 3 4 5 6 255 3 4 5 255 3 4 5 6 7 255 4 5 6 255 4 5 6 7 8 255 255 255 255 255
Last Update: $Date: 1999/05/12 16:49:54 $