Group (All javadoc for netcdf-java version 4.6.22-SNAPSHOT)

java.lang.Object
- ucar.nc2.CDMNode
- - ucar.nc2.Group

All Implemented Interfaces:

AttributeContainer
```
public class Group
extends CDMNode
implements AttributeContainer
```
A Group is a logical collection of Variables. The Groups in a Dataset form a hierarchical tree, like directories on a disk. A Group has a name and optionally a set of Attributes. There is always at least one Group in a dataset, the root Group, whose name is the empty string.
Immutable if setImmutable() was called.

Field Summary

Fields
Modifier and Type	Field and Description
`protected java.util.List<Attribute>`	`attributes`
`protected java.util.List<Dimension>`	`dimensions`
`protected java.util.List<EnumTypedef>`	`enumTypedefs`
`protected java.util.List<Group>`	`groups`
`protected NetcdfFile`	`ncfile`
`protected java.util.List<Attribute>`	`specials`
`protected java.util.List<Variable>`	`variables`

Fields inherited from class ucar.nc2.CDMNode
annotations, dodsname, group, immutable, parentstruct, shortName, sort

Constructor Summary

Constructors
Constructor and Description

Group(NetcdfFile ncfile, Group parent, java.lang.String shortName)
Constructor

Constructors
Constructor and Description
`Group(NetcdfFile ncfile, Group parent, java.lang.String shortName)` Constructor

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addAll(java.lang.Iterable<Attribute> atts)` Add all; replace old if has same name
`Attribute`	`addAttribute(Attribute att)` Add new Attribute; replace old if has same name.
`void`	`addDimension(Dimension d)` Add a shared Dimension
`boolean`	`addDimensionIfNotExists(Dimension d)`
`void`	`addEnumeration(EnumTypedef e)` Add an Enumeration
`void`	`addGroup(Group g)` Add a nested Group
`void`	`addVariable(Variable v)` Add a Variable
`Group`	`commonParent(Group other)` Get the common parent of this and the other group.
`boolean`	`equals(java.lang.Object oo)` Instances which have same name and parent are equal.
`Attribute`	`findAttribute(java.lang.String name)` Find an Attribute in this Group by its name.
`Attribute`	`findAttributeIgnoreCase(java.lang.String name)` Find an Attribute in this Group by its name, ignore case.
`Dimension`	`findDimension(java.lang.String name)` Retrieve a Dimension using its (short) name.
`Dimension`	`findDimensionLocal(java.lang.String name)` Retrieve a Dimension using its (short) name, in this group only
`EnumTypedef`	`findEnumeration(java.lang.String name)` Find an Enumeration Typedef using its (short) name.
`Group`	`findGroup(java.lang.String groupShortName)` Retrieve the Group with the specified (short) name.
`Variable`	`findVariable(java.lang.String varShortName)` Find the Variable with the specified (short) name in this group.
`Variable`	`findVariableOrInParent(java.lang.String varShortName)` Find the Variable with the specified (short) name in this group or a parent group.
`java.util.List<Attribute>`	`getAttributes()` Get the set of attributes contained directly in this Group.
`java.util.List<Dimension>`	`getDimensions()` Get the Dimensions contained directly in this group.
`java.util.List<EnumTypedef>`	`getEnumTypedefs()` Get the enumerations contained directly in this group.
`java.util.List<Group>`	`getGroups()` Get the Groups contained directly in this Group.
`java.lang.String`	`getNameAndAttributes()` Get String with name and attributes.
`NetcdfFile`	`getNetcdfFile()` Get the owning NetcdfFile
`java.lang.String`	`getShortName()` Get the "short" name, unique within its parent Group.
`java.util.List<Variable>`	`getVariables()` Get the Variables contained directly in this group.
`int`	`hashCode()` Override Object.hashCode() to implement equals.
`void`	`hashCodeShow(Indent indent)`
`boolean`	`isParent(Group other)` Is this a parent of the other Group?
`boolean`	`isRoot()` Is this the root group?
`Group`	`makeRelativeGroup(NetcdfFile ncf, java.lang.String path, boolean ignorelast)` Create groups to ensure path is defined
`boolean`	`remove(Attribute a)` Remove an Attribute : uses the attribute hashCode to find it.
`boolean`	`remove(Dimension d)` Remove an Dimension : uses the dimension hashCode to find it.
`boolean`	`remove(Group g)` Remove an Attribute : uses the Group hashCode to find it.
`boolean`	`remove(Variable v)` Remove a Variable : uses the variable hashCode to find it.
`boolean`	`removeDimension(java.lang.String dimName)` remove a Dimension using its name, in this group only
`boolean`	`removeVariable(java.lang.String shortName)` remove a Variable using its (short) name, in this group only
`Group`	`setImmutable()` Make this immutable.
`java.lang.String`	`setName(java.lang.String shortName)` Set the short name, converting to valid CDM object name if needed.
`void`	`setParentGroup(Group parent)` Set the Group's parent Group
`java.lang.String`	`toString()`
`java.lang.String`	`writeCDL(boolean strict)` CDL representation.
`protected void`	`writeCDL(java.util.Formatter out, Indent indent, boolean strict)`

Methods inherited from class ucar.nc2.CDMNode
annotate, getAnnotation, getAnnotations, getDODSName, getFullName, getFullNameEscaped, getGroup, getImmutable, getName, getParentGroup, getParentStructure, getSort, isMemberOfStructure, localhash, setDODSName, setImmutable, setParentStructure, setShortName, setSort, unwrap

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - ncfile
```
protected NetcdfFile ncfile
```
  - variables
```
protected java.util.List<Variable> variables
```
  - dimensions
```
protected java.util.List<Dimension> dimensions
```
  - groups
```
protected java.util.List<Group> groups
```
  - attributes
```
protected java.util.List<Attribute> attributes
```
  - specials
```
protected java.util.List<Attribute> specials
```
  - enumTypedefs
```
protected java.util.List<EnumTypedef> enumTypedefs
```
- Constructor Detail
  - Group
```
public Group(NetcdfFile ncfile,
             Group parent,
             java.lang.String shortName)
```
    Constructor
    
    Parameters:
    
    ncfile - NetcdfFile owns this Group
    
    parent - parent of Group. If null, this is the root Group.
    
    shortName - short name of Group.
- Method Detail
  - isRoot
```
public boolean isRoot()
```
    Is this the root group?
    
    Returns:
    
    true if root group
  - getShortName
```
public java.lang.String getShortName()
```
    Get the "short" name, unique within its parent Group.
    
    Overrides:
    
    getShortName in class CDMNode
    
    Returns:
    
    group short name
  - getVariables
```
public java.util.List<Variable> getVariables()
```
    Get the Variables contained directly in this group.
    
    Returns:
    
    List of type Variable; may be empty, not null.
  - findVariable
```
public Variable findVariable(java.lang.String varShortName)
```
    Find the Variable with the specified (short) name in this group.
    
    Parameters:
    
    varShortName - short name of Variable within this group.
    
    Returns:
    
    the Variable, or null if not found
  - findVariableOrInParent
```
public Variable findVariableOrInParent(java.lang.String varShortName)
```
    Find the Variable with the specified (short) name in this group or a parent group.
    
    Parameters:
    
    varShortName - short name of Variable.
    
    Returns:
    
    the Variable, or null if not found
  - getGroups
```
public java.util.List<Group> getGroups()
```
    Get the Groups contained directly in this Group.
    
    Returns:
    
    List of type Group; may be empty, not null.
  - getNetcdfFile
```
public NetcdfFile getNetcdfFile()
```
    Get the owning NetcdfFile
    
    Returns:
    
    owning NetcdfFile.
  - findGroup
```
public Group findGroup(java.lang.String groupShortName)
```
    Retrieve the Group with the specified (short) name.
    
    Parameters:
    
    groupShortName - short name of the nested group you are looking for.
    
    Returns:
    
    the Group, or null if not found
  - getDimensions
```
public java.util.List<Dimension> getDimensions()
```
    Get the Dimensions contained directly in this group.
    
    Returns:
    
    List of type Dimension; may be empty, not null.
  - getEnumTypedefs
```
public java.util.List<EnumTypedef> getEnumTypedefs()
```
    Get the enumerations contained directly in this group.
    
    Returns:
    
    List of type EnumTypedef; may be empty, not null.
  - findDimension
```
public Dimension findDimension(java.lang.String name)
```
    Retrieve a Dimension using its (short) name. If it doesnt exist in this group, recursively look in parent groups.
    
    Parameters:
    
    name - Dimension name.
    
    Returns:
    
    the Dimension, or null if not found
  - findDimensionLocal
```
public Dimension findDimensionLocal(java.lang.String name)
```
    Retrieve a Dimension using its (short) name, in this group only
    
    Parameters:
    
    name - Dimension name.
    
    Returns:
    
    the Dimension, or null if not found
  - getAttributes
```
public java.util.List<Attribute> getAttributes()
```
    Get the set of attributes contained directly in this Group.
    
    Specified by:
    
    getAttributes in interface AttributeContainer
    
    Returns:
    
    immutable List of type Attribute; may be empty, not null.
  - addAll
```
public void addAll(java.lang.Iterable<Attribute> atts)
```
    Add all; replace old if has same name
    
    Specified by:
    
    addAll in interface AttributeContainer
  - findAttribute
```
public Attribute findAttribute(java.lang.String name)
```
    Find an Attribute in this Group by its name.
    
    Parameters:
    
    name - the name of the attribute.
    
    Returns:
    
    the attribute, or null if not found
  - findAttributeIgnoreCase
```
public Attribute findAttributeIgnoreCase(java.lang.String name)
```
    Find an Attribute in this Group by its name, ignore case.
    
    Parameters:
    
    name - the name of the attribute
    
    Returns:
    
    the attribute, or null if not found
  - findEnumeration
```
public EnumTypedef findEnumeration(java.lang.String name)
```
    Find an Enumeration Typedef using its (short) name. If it doesnt exist in this group, recursively look in parent groups.
    
    Parameters:
    
    name - Enumeration name.
    
    Returns:
    
    the Enumeration, or null if not found
  - commonParent
```
public Group commonParent(Group other)
```
    Get the common parent of this and the other group. Cant fail, since the root group is always a parent of any 2 groups.
    
    Parameters:
    
    other - the other group
    
    Returns:
    
    common parent of this and the other group
  - isParent
```
public boolean isParent(Group other)
```
    Is this a parent of the other Group?
    
    Parameters:
    
    other - another Group
    
    Returns:
    
    true is it is equal or a parent
  - getNameAndAttributes
```
public java.lang.String getNameAndAttributes()
```
    Get String with name and attributes. Used in short descriptions like tooltips.
    
    Returns:
    
    name and attributes String.
  - writeCDL
```
public java.lang.String writeCDL(boolean strict)
```
    CDL representation.
    
    Parameters:
    
    strict - if true, write in strict adherence to CDL definition.
    
    Returns:
    
    CDL representation.
  - writeCDL
```
protected void writeCDL(java.util.Formatter out,
                        Indent indent,
                        boolean strict)
```
  - setParentGroup
```
public void setParentGroup(Group parent)
```
    Set the Group's parent Group
    
    Overrides:
    
    setParentGroup in class CDMNode
    
    Parameters:
    
    parent - parent group.
  - setName
```
public java.lang.String setName(java.lang.String shortName)
```
    Set the short name, converting to valid CDM object name if needed.
    
    Parameters:
    
    shortName - set to this value
    
    Returns:
    
    valid CDM object name
  - addAttribute
```
public Attribute addAttribute(Attribute att)
```
    Add new Attribute; replace old if has same name.
    
    Specified by:
    
    addAttribute in interface AttributeContainer
    
    Parameters:
    
    att - add this Attribute.
    
    Returns:
    
    the added attribute
  - addDimension
```
public void addDimension(Dimension d)
```
    Add a shared Dimension
    
    Parameters:
    
    d - add this Dimension
  - addDimensionIfNotExists
```
public boolean addDimensionIfNotExists(Dimension d)
```
  - addGroup
```
public void addGroup(Group g)
```
    Add a nested Group
    
    Parameters:
    
    g - add this Group.
  - addEnumeration
```
public void addEnumeration(EnumTypedef e)
```
    Add an Enumeration
    
    Parameters:
    
    e - add this Enumeration.
  - addVariable
```
public void addVariable(Variable v)
```
    Add a Variable
    
    Parameters:
    
    v - add this Variable.
  - remove
```
public boolean remove(Attribute a)
```
    Remove an Attribute : uses the attribute hashCode to find it.
    
    Parameters:
    
    a - remove this Attribute.
    
    Returns:
    
    true if was found and removed
  - remove
```
public boolean remove(Dimension d)
```
    Remove an Dimension : uses the dimension hashCode to find it.
    
    Parameters:
    
    d - remove this Dimension.
    
    Returns:
    
    true if was found and removed
  - remove
```
public boolean remove(Group g)
```
    Remove an Attribute : uses the Group hashCode to find it.
    
    Parameters:
    
    g - remove this Group.
    
    Returns:
    
    true if was found and removed
  - remove
```
public boolean remove(Variable v)
```
    Remove a Variable : uses the variable hashCode to find it.
    
    Parameters:
    
    v - remove this Variable.
    
    Returns:
    
    true if was found and removed
  - removeDimension
```
public boolean removeDimension(java.lang.String dimName)
```
    remove a Dimension using its name, in this group only
    
    Parameters:
    
    dimName - Dimension name.
    
    Returns:
    
    true if dimension found and removed
  - removeVariable
```
public boolean removeVariable(java.lang.String shortName)
```
    remove a Variable using its (short) name, in this group only
    
    Parameters:
    
    shortName - Variable name.
    
    Returns:
    
    true if Variable found and removed
  - setImmutable
```
public Group setImmutable()
```
    Make this immutable.
    
    Returns:
    
    this
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object oo)
```
    Instances which have same name and parent are equal.
    
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Override Object.hashCode() to implement equals.
    
    Overrides:
    
    hashCode in class java.lang.Object
  - hashCodeShow
```
public void hashCodeShow(Indent indent)
```
    Specified by:
    
    hashCodeShow in class CDMNode
  - makeRelativeGroup
```
public Group makeRelativeGroup(NetcdfFile ncf,
                               java.lang.String path,
                               boolean ignorelast)
```
    Create groups to ensure path is defined
    
    Parameters:
    
    ncf - the containing netcdf file object
    
    path - the path to the desired group
    
    ignorelast - true => ignore last element in the path
    
    Returns:
    
    the Group, or null if not found

Class Group

Field Summary

Fields inherited from class ucar.nc2.CDMNode

Constructor Summary

Method Summary

Methods inherited from class ucar.nc2.CDMNode

Methods inherited from class java.lang.Object

Field Detail

ncfile

variables

dimensions

groups

attributes

specials

enumTypedefs

Constructor Detail

Group

Method Detail

isRoot

getShortName

getVariables

findVariable

findVariableOrInParent

getGroups

getNetcdfFile

findGroup

getDimensions

getEnumTypedefs

findDimension

findDimensionLocal

getAttributes

addAll

findAttribute

findAttributeIgnoreCase

findEnumeration

commonParent

isParent

getNameAndAttributes

writeCDL

writeCDL

setParentGroup

setName

addAttribute

addDimension

addDimensionIfNotExists

addGroup

addEnumeration

addVariable

remove

remove

remove

remove

removeDimension

removeVariable

setImmutable

toString

equals

hashCode

hashCodeShow

makeRelativeGroup