ucar.nc2.dataset
Class StructurePseudoDS

java.lang.Object
  ucar.nc2.Variable
      ucar.nc2.Structure
          ucar.nc2.dataset.StructureDS
              ucar.nc2.dataset.StructurePseudoDS

All Implemented Interfaces:

java.lang.Comparable<VariableSimpleIF>, Enhancements, VariableEnhanced, ProxyReader, VariableIF, VariableSimpleIF

Direct Known Subclasses:

StructurePseudo2Dim

public class StructurePseudoDS
extends StructureDS

Make a collection of variables with the same outer dimension into a fake Structure. Its fake because the variables are not stored contiguously.

  so
   var1(dim, other);
   var2(dim, other);
   var3(dim, other);
 becomes
   struct {
     var1(other);
     var2(other);
     var3(other);
   } name(dim);
 

Author:

caron

Field Summary

Fields inherited from class ucar.nc2.Variable

defaultCoordsSizeToCache, defaultSizeToCache

Constructor Summary

StructurePseudoDS(NetcdfDataset ncfile, Group group, java.lang.String shortName, java.util.List<java.lang.String> varNames, Dimension outerDim)
Make a Structure out of all Variables with the named dimension as their outermost dimension, or from a list named Variables, each has the same named outermost dimension.

Method Summary

Array	reallyRead(Variable mainv, CancelTask cancelTask) public by accident, do not call directly.
Array	reallyRead(Variable mainv, Section section, CancelTask cancelTask) public by accident, do not call directly.
boolean	removeMemberVariable(Variable v) Remove a Variable : uses the Variable name to find it.
Structure	select(java.util.List<java.lang.String> memberNames) Create a subset of the Structure consisting only of the given member variables

Methods inherited from class ucar.nc2.dataset.StructureDS

addCoordinateSystem, clearCoordinateSystems, enhance, getCoordinateSystems, getDescription, getOriginalDataType, getOriginalName, getOriginalVariable, getUnitsString, removeCoordinateSystem, setName, setOriginalVariable, setUnitsString

Methods inherited from class ucar.nc2.Structure

addMemberVariable, calcElementSize, findVariable, getElementSize, getNameAndAttributes, getNumberOfMemberVariables, getStructureIterator, getStructureIterator, getVariableNames, getVariables, isCaching, isSubset, makeStructureMembers, readStructure, readStructure, readStructure, replaceMemberVariable, select, setCaching, setImmutable, setMemberVariables, setParentGroup

Methods inherited from class ucar.nc2.Variable

addAttribute, compareTo, createNewCache, equals, findAttribute, findAttributeIgnoreCase, findDimensionIndex, getAttributes, getDataType, getDimension, getDimensions, getDimensionsAll, getDimensionsString, getEnumTypedef, getName, getNameAndDimensions, getNameAndDimensions, getNameAndDimensions, getNameAndDimensions, getNameAndDimensions, getNameAndDimensions, getNameEscaped, getParentGroup, getParentStructure, getProxyReader, getRanges, getRank, getShape, getShape, getShapeAll, getShapeAsSection, getShortName, getSize, getSizeToCache, getSPobject, hasCachedData, hashCode, invalidateCache, isCoordinateVariable, isImmutable, isMemberOfStructure, isMetadata, isScalar, isUnknownLength, isUnlimited, isUnsigned, isVariableLength, lookupEnumString, read, read, read, read, read, readScalarByte, readScalarDouble, readScalarFloat, readScalarInt, readScalarLong, readScalarShort, readScalarString, readToByteChannel, remove, removeAttribute, removeAttributeIgnoreCase, resetDimensions, resetShape, section, section, setCachedData, setCachedData, setDataType, setDimension, setDimensions, setDimensions, setDimensionsAnonymous, setElementSize, setEnumTypedef, setIsScalar, setParentStructure, setProxyReader, setSizeToCache, setSPobject, slice, toString, toStringDebug, writeCDL

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface ucar.nc2.VariableIF

findAttribute, findAttributeIgnoreCase, findDimensionIndex, getAttributes, getDataType, getDimension, getDimensions, getDimensionsAll, getElementSize, getName, getNameAndDimensions, getNameEscaped, getParentGroup, getParentStructure, getRanges, getRank, getShape, getShapeAsSection, getShortName, getSize, isCoordinateVariable, isMemberOfStructure, isMetadata, isScalar, isUnlimited, isUnsigned, isVariableLength, read, read, read, read, readScalarByte, readScalarDouble, readScalarFloat, readScalarInt, readScalarLong, readScalarShort, readScalarString, section, toStringDebug

Methods inherited from interface java.lang.Comparable

compareTo

Constructor Detail

StructurePseudoDS

public StructurePseudoDS(NetcdfDataset ncfile,
                         Group group,
                         java.lang.String shortName,
                         java.util.List<java.lang.String> varNames,
                         Dimension outerDim)

Make a Structure out of all Variables with the named dimension as their outermost dimension, or from a list named Variables, each has the same named outermost dimension.

Parameters:

ncfile - part of this file

group - part of this group

shortName - short name of this Structure

varNames - limited to these variables, all must have dim as outer dimension. If null, use all Variables with that outer dimension

outerDim - existing, outer dimension

Method Detail

select

public Structure select(java.util.List<java.lang.String> memberNames)

Description copied from class: Structure

Create a subset of the Structure consisting only of the given member variables

Overrides:

select in class StructureDS

Parameters:

memberNames - list of Variable names, already a member

Returns:

Structure containing just those members

removeMemberVariable

public boolean removeMemberVariable(Variable v)

Description copied from class: Structure

Remove a Variable : uses the Variable name to find it.

Overrides:

removeMemberVariable in class Structure

Parameters:

v - remove this variable as a member of this structure

Returns:

true if was found and removed

reallyRead

public Array reallyRead(Variable mainv,
                        CancelTask cancelTask)
                 throws java.io.IOException

Description copied from class: Variable

public by accident, do not call directly.

Specified by:

reallyRead in interface ProxyReader

Overrides:

reallyRead in class StructureDS

Parameters:

mainv - the client Variable

cancelTask - user may cancel

Returns:

Array

Throws:

java.io.IOException - on error

reallyRead

public Array reallyRead(Variable mainv,
                        Section section,
                        CancelTask cancelTask)
                 throws java.io.IOException,
                        InvalidRangeException

Description copied from class: Variable

public by accident, do not call directly.

Specified by:

reallyRead in interface ProxyReader

Overrides:

reallyRead in class StructureDS

Parameters:

mainv - the client Variable

section - the section of data to read.

cancelTask - user may cancel

Returns:

Array

Throws:

java.io.IOException - on error

InvalidRangeException - if section has incorrect rank or illegal shape.