CmUtils::File::Ipfibr

Routines for reading and writing ipfibr 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 Ipfibr files JMB

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

SUBROUTINES

readIpfibr

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

Returns a NodeGroup read from filename (or filename.ipfibr). 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 fibres and creates components named fibre,imbrication,sheet. Handles versions and derivatives. Does not cope well with malformed files :-(

writeIpfibr

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