ucar.nc2
Class Sequence

java.lang.Object
  ucar.nc2.Variable
      ucar.nc2.Structure
          ucar.nc2.Sequence

All Implemented Interfaces:

java.lang.Comparable<VariableSimpleIF>, VariableIF, VariableSimpleIF

public class Sequence
extends Structure

Sequence is a one-dimensional Structure with indeterminate length. The only data access is through getStructureIterator().

Since:

Feb 23, 2008

Author:

caron

Nested Class Summary

Nested classes/interfaces inherited from class ucar.nc2.Structure

Structure.Iterator

Nested classes/interfaces inherited from class ucar.nc2.Variable

Variable.Cache

Field Summary

Fields inherited from class ucar.nc2.Structure

isSubset, memberHash, members

Fields inherited from class ucar.nc2.Variable

attributes, cache, dataType, debugCaching, defaultSizeToCache, dimensions, elementSize, group, hashCode, isMetadata, isVariableLength, ncfile, parent, postReader, preReader, shape, shapeAsSection, shortName, sizeToCache, spiObject

Constructor Summary

Sequence(NetcdfFile ncfile, Group group, Structure parent, java.lang.String shortName)

Method Summary

Array	read() UnsupportedOperation
Array	read(int[] origin, int[] shape) UnsupportedOperation
Array	read(java.util.List<Range> ranges) UnsupportedOperation
Array	read(Section section) UnsupportedOperation
Array	read(java.lang.String sectionSpec) UnsupportedOperation
StructureData	readStructure() UnsupportedOperation
StructureData	readStructure(int index) UnsupportedOperation
ArrayStructure	readStructure(int start, int count) UnsupportedOperation
Variable	section(Section subsection) UnsupportedOperation
Variable	slice(int dim, int value) UnsupportedOperation

Methods inherited from class ucar.nc2.Structure

addMemberVariable, calcElementSize, calcStructureSize, copy, findVariable, getElementSize, getNameAndAttributes, getStructureIterator, getStructureIterator, getVariableNames, getVariables, isCaching, isSubset, makeStructureMembers, removeMemberVariable, replaceMemberVariable, select, select, setCaching, setImmutable, setMemberVariables, setParentGroup, writeCDL

Methods inherited from class ucar.nc2.Variable

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

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Sequence

public Sequence(NetcdfFile ncfile,
                Group group,
                Structure parent,
                java.lang.String shortName)

Method Detail

read

public Array read(int[] origin,
                  int[] shape)
           throws java.io.IOException,
                  InvalidRangeException

UnsupportedOperation

Specified by:

read in interface VariableIF

Overrides:

read in class Variable

Parameters:

origin - int array specifying the starting index. If null, assume all zeroes.

shape - int array specifying the extents in each dimension. This becomes the shape of the returned Array.

Returns:

the requested data in a memory-resident Array

Throws:

java.lang.UnsupportedOperationException

java.io.IOException

InvalidRangeException

read

public Array read(java.lang.String sectionSpec)
           throws java.io.IOException,
                  InvalidRangeException

UnsupportedOperation

Specified by:

read in interface VariableIF

Overrides:

read in class Variable

Parameters:

sectionSpec - specification string, eg "1:2,10,:,1:100:10". May optionally have ().

Returns:

the requested data in a memory-resident Array

Throws:

java.lang.UnsupportedOperationException

java.io.IOException

InvalidRangeException

See Also:

for sectionSpec syntax

read

public Array read(java.util.List<Range> ranges)
           throws java.io.IOException,
                  InvalidRangeException

UnsupportedOperation

Overrides:

read in class Variable

Parameters:

ranges - list of Range specifying the section of data to read.

Returns:

the requested data in a memory-resident Array

Throws:

java.lang.UnsupportedOperationException

java.io.IOException - if error

InvalidRangeException - if ranges is invalid

See Also:

Variable.read(Section)

read

public Array read(Section section)
           throws java.io.IOException,
                  InvalidRangeException

UnsupportedOperation

Specified by:

read in interface VariableIF

Overrides:

read in class Variable

Parameters:

section - list of Range specifying the section of data to read. Must be null or same rank as variable. If list is null, assume all data. Each Range corresponds to a Dimension. If the Range object is null, it means use the entire dimension.

Returns:

the requested data in a memory-resident Array

Throws:

java.lang.UnsupportedOperationException

java.io.IOException - if error

InvalidRangeException - if section is invalid

read

public Array read()
           throws java.io.IOException

UnsupportedOperation

Specified by:

read in interface VariableIF

Overrides:

read in class Variable

Returns:

the requested data in a memory-resident Array.

Throws:

java.lang.UnsupportedOperationException

java.io.IOException

readStructure

public StructureData readStructure()
                            throws java.io.IOException

UnsupportedOperation

Overrides:

readStructure in class Structure

Returns:

StructureData for a scalar

Throws:

java.lang.UnsupportedOperationException

java.io.IOException - on read error

readStructure

public StructureData readStructure(int index)
                            throws java.io.IOException,
                                   InvalidRangeException

UnsupportedOperation

Overrides:

readStructure in class Structure

Parameters:

index - index into 1D array

Returns:

ith StructureData

Throws:

java.lang.UnsupportedOperationException

java.io.IOException - on read error

InvalidRangeException - if index out of range

readStructure

public ArrayStructure readStructure(int start,
                                    int count)
                             throws java.io.IOException,
                                    InvalidRangeException

UnsupportedOperation

Overrides:

readStructure in class Structure

Parameters:

start - start at this index

count - return this many StructureData

Returns:

the StructureData recordsfrom start to start+count-1

Throws:

java.lang.UnsupportedOperationException

java.io.IOException - on read error

InvalidRangeException - if start, count out of range

slice

public Variable slice(int dim,
                      int value)
               throws InvalidRangeException

UnsupportedOperation

Overrides:

slice in class Variable

Parameters:

dim - which dimension to fix

value - at what index value

Returns:

a new Variable which is a logical slice of this Variable.

Throws:

java.lang.UnsupportedOperationException

InvalidRangeException - if dimension or value is illegal

section

public Variable section(Section subsection)
                 throws InvalidRangeException

UnsupportedOperation

Overrides:

section in class Variable

Parameters:

subsection - Section of this variable. Each Range in the section corresponds to a Dimension, and specifies the section of data to read in that Dimension. A Range object may be null, which means use the entire dimension.

Returns:

a new Variable which is a logical section of this Variable.

Throws:

java.lang.UnsupportedOperationException

InvalidRangeException - if section not compatible with shape