ucar.nc2.dataset

Class StructurePseudoDS

java.lang.Object

ucar.nc2.CDMNode

ucar.nc2.Variable

ucar.nc2.Structure

ucar.nc2.dataset.StructureDS

ucar.nc2.dataset.StructurePseudoDS

All Implemented Interfaces:

java.lang.Comparable<VariableSimpleIF>, java.lang.Iterable<Attribute>, AttributeContainer, Enhancements, VariableEnhanced, ProxyReader, 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);
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	StructurePseudoDS.Builder<T extends StructurePseudoDS.Builder<T>>

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

Variable.Cache

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.util.Set<NetcdfDataset.Enhance>	enhanceScaleMissing
protected java.util.List<Variable>	orgVariables

Fields inherited from class ucar.nc2.dataset.StructureDS

orgName, orgVar, proxy

Fields inherited from class ucar.nc2.Structure

isSubset, members

Fields inherited from class ucar.nc2.Variable

attributes, cache, dataType, debugCaching, defaultCoordsSizeToCache, defaultSizeToCache, dimensions, elementSize, hashCode, isVariableLength, ncfile, permitCaching, proxyReader, shape, sizeToCache, spiObject

Fields inherited from class ucar.nc2.CDMNode

annotations, dodsname, group, immutable, parentstruct, shortName, sort

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	StructurePseudoDS(NetcdfDataset ncfile, Group group, java.lang.String shortName) Deprecated. Use StructurePseudoDS.builder()
	StructurePseudoDS(NetcdfDataset ncfile, Group group, java.lang.String shortName, java.util.List<java.lang.String> varNames, Dimension outerDim) Deprecated. Use StructurePseudoDS.builder()
protected	StructurePseudoDS(StructurePseudoDS.Builder<?> builder, Group parentGroup)

Method Summary

Modifier and Type	Method and Description
protected StructurePseudoDS.Builder<?>	addLocalFieldsToBuilder(StructurePseudoDS.Builder<? extends StructurePseudoDS.Builder<?>> b)
static StructurePseudoDS.Builder<?>	builder()
protected StructureDS	copy() Deprecated. Use toBuilder()
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) Deprecated. Use StructurePseudoDS.builder()
Structure	select(java.util.List<java.lang.String> memberNames) Create a subset of the Structure consisting only of the given member variables
StructurePseudoDS.Builder<?>	toBuilder() Turn into a mutable Builder.

Methods inherited from class ucar.nc2.dataset.StructureDS

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

Methods inherited from class ucar.nc2.Structure

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

Methods inherited from class ucar.nc2.Variable

_read, _read, _readScalarData, addAll, addAttribute, addLocalFieldsToBuilder, attributes, compareTo, createNewCache, equals, extraInfo, findAttribute, findAttributeDouble, findAttributeIgnoreCase, findAttributeInteger, findAttributeString, findDimensionIndex, getAttributes, getDAPName, getDAPName, getDatasetLocation, getDataType, getDimension, getDimensions, getDimensionsAll, getDimensionsString, getEnumTypedef, getFileTypeId, getFullName, getNameAndDimensions, getNameAndDimensions, getNameAndDimensions, getNameAndDimensions, getNameAndDimensions, getNameAndDimensions, getNetcdfFile, getParentGroup, getParentGroupOrRoot, getParentStructure, getProxyReader, getRanges, getRank, getScalarData, getShape, getShape, getShapeAll, getShapeAsSection, getSize, getSizeToCache, getSPobject, hasCachedData, hashCode, invalidateCache, isCoordinateVariable, isEmpty, isImmutable, isMemberOfStructure, isMetadata, isScalar, isUnknownLength, isUnlimited, isVariableLength, lookupEnumString, read, read, read, read, read, readScalarByte, readScalarDouble, readScalarFloat, readScalarInt, readScalarLong, readScalarShort, readScalarString, readToByteChannel, readToStream, reduce, remove, removeAttribute, removeAttributeIgnoreCase, resetDimensions, resetShape, section, section, setCachedData, setCachedData, setDataType, setDimension, setDimensions, setDimensions, setDimensionsAnonymous, setElementSize, setEnumTypedef, setIsScalar, setProxyReader, setSizeToCache, setSPobject, setValues, setValues, slice, toString, toStringDebug, writeCDL

Methods inherited from class ucar.nc2.CDMNode

annotate, annotation, getDODSName, getFullNameEscaped, getGroup, getImmutable, getName, getShortName, getSort, localhash, setDODSName, setParentStructure, setShortName, setSort, unwrap

Methods inherited from class java.lang.Object

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

Methods inherited from interface ucar.nc2.dataset.VariableEnhanced

getFullName, getShortName

Methods inherited from interface ucar.nc2.VariableSimpleIF

getName, getShortName

Methods inherited from interface ucar.nc2.AttributeContainer

filter, findAttValueIgnoreCase, getName, hasAttribute, hasAttributeIgnoreCase, iterator

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

enhanceScaleMissing

protected static final java.util.Set<NetcdfDataset.Enhance> enhanceScaleMissing

orgVariables

protected java.util.List<Variable> orgVariables

Constructor Detail

StructurePseudoDS

@Deprecated
protected StructurePseudoDS(NetcdfDataset ncfile,
                                        Group group,
                                        java.lang.String shortName)

Deprecated. Use StructurePseudoDS.builder()

StructurePseudoDS

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

Deprecated. Use StructurePseudoDS.builder()

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

StructurePseudoDS

protected StructurePseudoDS(StructurePseudoDS.Builder<?> builder,
                            Group parentGroup)

Method Detail

copy

@Deprecated
protected StructureDS copy()

Deprecated. Use toBuilder()

Overrides:

copy in class StructureDS

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

@Deprecated
public boolean removeMemberVariable(Variable v)

Deprecated. Use StructurePseudoDS.builder()

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.

toBuilder

public StructurePseudoDS.Builder<?> toBuilder()

Description copied from class: Structure

Turn into a mutable Builder. Can use toBuilder().build() to copy.

Overrides:

toBuilder in class StructureDS

addLocalFieldsToBuilder

protected StructurePseudoDS.Builder<?> addLocalFieldsToBuilder(StructurePseudoDS.Builder<? extends StructurePseudoDS.Builder<?>> b)

builder

public static StructurePseudoDS.Builder<?> builder()