cmCombine - combines several CMISS format files into one
1.0 (28 February 2001)
The routines in this package can be called in several ways.
1/ From the shell prompt, call as cmCombine, or one of the aliases for specific filetypes. Prefix options with '-'. e.g.
cmCombine -output file.ipdata old*ipdata # creates file.ipdata
2/ From a Perl script, or from inside CMISS, load this module (with optional flags):
use CmUtils::CmCombine; # loads cmCombine() use CmUtils::CmCombine qw(:all); # loads all routines use CmUtils::CmCombine qw(:combineExnode); # combineExnode()
Options and filenames can then be specified in several ways.
a) as a string equivalent to a command line
combineExnode("-renumber -output file.exnode file1.exnode file2.exnode"); # create file.exnode
b) as options and filenames
cmCombine("-output","file.ipdata",@ipfiles);
c) as a hash array of options, followed by a list of files
$options->{-renumber} = 1; $options->{-offset} = 1000; $options->{-reduce} = 5; $options->{-output} = "newfile.exnode"; cmCombine($options, @files);
$options = {-output => $newfile}; combineIpdata($options, @ipfiles);
cmCombine combines a set of CMISS format files into a single file. All files must be of the same format. If the option renumber is used, then nodes are sequentially renumbered, from offset or zero. A new group name can be given with the name option. The reduce option allows a specified reduction in the data.
The following subroutines are available if cmCombine is used as a module. Parameters may include an options hash, followed by a list of filenames.
cmCombine($options, @files);