CmUtils::CmCombine

cmCombine - combines several CMISS format files into one

VERSION

1.0 (28 February 2001)

USAGE

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);

SYNOPSIS of cmCombine

cmCombine
[-help] [-man] [-verbose] [-name GroupName] [-format format] [-renumber [-offset Offset]] [-output FileName] [-reduce Number] filename(s)
-help
-man
-verbose
-name GroupName
New group name to give file.
-format format
File format. Automatically determined from filename if not specified.
-renumber
Renumber nodes sequentially.
-offset Offset
Start numbering from Offset+1.
-output FileName
New filename - otherwise prints to STDOUT.
-reduce Number
Reduce points by a factor. (2=> every other point etc)
filename(s)
File(s) to combine. Must specify at least one file.

DESCRIPTION

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.

SUBROUTINES

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);

cmCombine

combineExdata

combineIpdata

combineExnode

combineIpnode