CmUtils::File::Ipnode

Routines for reading and writing ipnode 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 Ipnode files JMB

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

SUBROUTINES

readIpnode

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

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

Assigns a focus to the NodeGroup if it is present (for prolate coordinates).

Creates a Field named coordinates and reads in the number of coordinates (components), and derivatives. Does not cope well with malformed files :-(

writeIpnode

PARAMETERS
(filename, group, options)
USAGE
  $options{nodes} = $group->getNodes(10..20);
  writeIpnode($filename, $group, \%options);
FUNCTION
Writes a NodeGroup to an ipnode 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 "coordinates" field will be printed if it exists. Only one field may be printed to an ipnode file.
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)