.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "HDF5::Group 3pm"
.TH HDF5::Group 3pm "2011-04-21" "perl v5.14.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
PDL::IO::HDF5::Group \- PDL::IO::HDF5 Helper Object representing HDF5 groups.
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This is a helper-object used by \s-1PDL::IO::HDF5\s0 to interface with \s-1HDF5\s0 format's group objects.
Information on the \s-1HDF5\s0 Format can be found
at the \s-1NCSA\s0's web site at http://hdf.ncsa.uiuc.edu/ .
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
See \s-1PDL::IO::HDF5\s0
.SH "MEMBER DATA"
.IX Header "MEMBER DATA"
.IP "\s-1ID\s0" 1
.IX Item "ID"
\&\s-1ID\s0 number given to the group by the \s-1HDF5\s0 library
.IP "name" 1
.IX Item "name"
Name of the group. (Absolute to the root group '/'. e.g. /maingroup/subgroup)
.IP "parent" 1
.IX Item "parent"
Ref to parent object (file or group) that owns this group.
.IP "fileObj" 1
.IX Item "fileObj"
Ref to the \s-1PDL::IO::HDF5\s0 object that owns this object.
.SH "METHODS"
.IX Header "METHODS"
####\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.SS "new"
.IX Subsection "new"
PDL::IO::HDF5::Group Constructor \- creates new object
.PP
\&\fBUsage:\fR
.PP
This object will usually be created using the calling format detailed in the \s-1SYNOPSIS\s0. The 
following syntax is used by the \s-1PDL::IO::HDF5\s0 object to build the object.
.PP
.Vb 6
\&   $a = new PDL::IO::HDF5:Group( name => $name, parent => $parent,
\&                              fileObj => $fileObj );
\&        Args:
\&        $name                           Name of the group (relative to the parent)
\&        $parent                         Parent Object that owns this group
\&        $fileObj                        PDL::HDF (Top Level) object that owns this group.
.Ve
.SS "\s-1DESTROY\s0"
.IX Subsection "DESTROY"
\&\s-1PDL::IO::HDF5\s0 Destructor \- Closes the HDF5::Group Object.
.PP
\&\fBUsage:\fR
.PP
.Vb 1
\&   No Usage. Automatically called
.Ve
.SS "attrSet"
.IX Subsection "attrSet"
Set the value of an attribute(s)
.PP
Attribute types supported are null-terminated strings and \s-1PDL\s0 matrices
.PP
\&\fBUsage:\fR
.PP
.Vb 7
\&   $group\->attrSet( \*(Aqattr1\*(Aq => \*(Aqattr1Value\*(Aq,
\&                    \*(Aqattr2\*(Aq => \*(Aqattr2 value\*(Aq, 
\&                    \*(Aqattr3\*(Aq => $pdl,
\&                    .
\&                    .
\&                    .
\&                   );
.Ve
.PP
Returns undef on failure, 1 on success.
.SS "attrGet"
.IX Subsection "attrGet"
Get the value of an attribute(s)
.PP
Currently the only attribute types supported are null-terminated strings.
.PP
\&\fBUsage:\fR
.PP
.Vb 1
\&   my @attrs = $group\->attrGet( \*(Aqattr1\*(Aq, \*(Aqattr2\*(Aq);
.Ve
.SS "attrDel"
.IX Subsection "attrDel"
Delete attribute(s)
.PP
\&\fBUsage:\fR
.PP
.Vb 6
\&   $group\->attrDel( \*(Aqattr1\*(Aq, 
\&                    \*(Aqattr2\*(Aq,
\&                    .
\&                    .
\&                    .
\&                   );
.Ve
.PP
Returns undef on failure, 1 on success.
.SS "attrs"
.IX Subsection "attrs"
Get a list of all attribute names in a group
.PP
\&\fBUsage:\fR
.PP
.Vb 1
\&   @attrs = $group\->attrs;
.Ve
.SS "dataset"
.IX Subsection "dataset"
Open an existing or create a new dataset in a group.
.PP
\&\fBUsage:\fR
.PP
.Vb 1
\&   $dataset = $group\->dataset(\*(Aqnewdataset\*(Aq);
.Ve
.PP
Returns undef on failure, 1 on success.
.SS "datasets"
.IX Subsection "datasets"
Get a list of all dataset names in a group. (Relative to the current group)
.PP
\&\fBUsage:\fR
.PP
.Vb 1
\&   @datasets = $group\->datasets;
.Ve
.SS "group"
.IX Subsection "group"
Open an existing or create a new group in an existing group.
.PP
\&\fBUsage:\fR
.PP
.Vb 1
\&   $newgroup = $oldgroup\->group("newgroup");
.Ve
.PP
Returns undef on failure, 1 on success.
.SS "groups"
.IX Subsection "groups"
Get a list of all group names in a group. (Relative to the current group)
.PP
\&\fBUsage:\fR
.PP
.Vb 1
\&   @groupNames = $group\->groups;
.Ve
.SS "_buildAttrIndex"
.IX Subsection "_buildAttrIndex"
Internal Recursive Method to build the attribute index hash
for the object
.PP
For the purposes of indexing groups by their attributes, the attributes are 
applied hierarchial. i.e. any attributes of the higher level groups are assumed to be 
apply for the lower level groups.
.PP
\&\fBUsage:\fR
.PP
.Vb 1
\&   $group\->_buildAttrIndex($index, $currentAttrs);
\&
\&    
\& Input/Output:
\&
\&         $index:        Total Index hash ref
\&         $currentAttrs: Hash refs of the attributes valid 
\&                        for the current group.
.Ve
.SS "IDget"
.IX Subsection "IDget"
Returns the \s-1HDF5\s0 library \s-1ID\s0 for this object
.PP
\&\fBUsage:\fR
.PP
.Vb 1
\& my $ID = $groupObj\->IDget;
.Ve
.SS "nameGet"
.IX Subsection "nameGet"
Returns the \s-1HDF5\s0 Group Name for this object. (Relative to the root group)
.PP
\&\fBUsage:\fR
.PP
.Vb 1
\& my $name = $groupObj\->nameGet;
.Ve