CmUtils::File::Ipfiel

Routines for reading and writing ipfiel files.

VERSION

0.5 (12 October 2000) 0.6 (08 August 2001) 0.7 (11 December 2003)

CHANGES

version 0.6 - added necessary field validity check for writing Ipfiel files JMB

version 0.7 - GBS moved CMISS::File:: routines to CmUtils::File:: and CmUtils::Objects::

SUBROUTINES

readIpfiel

PARAMETERS
(filename)
USAGE
  $group = readIpfiel("newfile");
FUNCTION

Returns a NodeGroup read from filename (or filename.ipfiel). Creates a new FieldSet for each type of versioning in the file, but only one FieldSet if there are no versions.

Creates a Field named field and creates components name c1..cn. Handles versions and derivatives. Does not cope well with malformed files :-(

writeIpfiel

PARAMETERS
(filename, group, options)
USAGE
  $options{nodes} = $group->getNodes(10..20);
  writeIpfiel($filename, $group, \%options);
FUNCTION
Writes a NodeGroup to an ipfiel file. Options are passed through the options hash to control the subset of the NodeGroup which will be printed.
OPTIONS
nodes
A array of node structures which will be output. A number of routines are available to get nodes from a group (e.g. getNodes. See CmUtils::Objects::NodeGroup). If not set, all nodes will be printed.
fields
An field name which will be printed. If not set, the "field" field will be printed if it exists. Only one field may be printed to an ipfiel file. Each component is printed as a spearate field variable.
noDerivatives
Set this option to suppress printing of nodal derivatives.
noVersions
Set this option to suppress printing of multiple versions - only the first will be printed. (not yet implemented)