ucar.nc2.ncml

Class AggregationOuterDimension

java.lang.Object

ucar.nc2.ncml.Aggregation

ucar.nc2.ncml.AggregationOuterDimension

All Implemented Interfaces:

AggregationIF, ProxyReader

Direct Known Subclasses:

AggregationExisting, AggregationFmrc, AggregationNew

Deprecated.

do not use

@Deprecated
public abstract class AggregationOuterDimension
extends Aggregation
implements ProxyReader

Superclass for Aggregations on the outer dimension: joinNew, joinExisting, Fmrc, FmrcSingle

Since:

Aug 10, 2007

Nested Class Summary

Nested classes/interfaces inherited from class ucar.nc2.ncml.Aggregation

Aggregation.Dataset, Aggregation.DatasetProxyReader, Aggregation.Type, Aggregation.TypicalDataset

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.List<java.lang.String>	aggVarNames Deprecated.
protected java.util.List<VariableDS>	aggVars Deprecated.
protected java.util.List<ucar.nc2.ncml.AggregationOuterDimension.CacheVar>	cacheList Deprecated.
protected static boolean	debugCache Deprecated.
protected static boolean	debugInvocation Deprecated.
protected static boolean	debugStride Deprecated.
static int	invocation Deprecated.
protected boolean	timeUnitsChange Deprecated.

Fields inherited from class ucar.nc2.ncml.Aggregation

cacheDirty, datasetManager, datasets, dateFormatMark, dateFormatter, debug, debugConvert, debugDateParse, debugOpenFile, debugProxy, debugRead, debugSyncDetail, dimName, diskCache2, executor, explicitDatasets, isDate, logger, ncDataset, numericTimeSettings, spiObject, type, typicalDatasetMode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AggregationOuterDimension(NetcdfDataset ncd, java.lang.String dimName, Aggregation.Type type, java.lang.String recheckS) Deprecated. Create an Aggregation for the given NetcdfDataset.

Method Summary

Modifier and Type	Method and Description
void	addVariable(java.lang.String varName) Deprecated. Add a name for a variableAgg element
protected void	buildCoords(CancelTask cancelTask) Deprecated.
void	getDetailInfo(java.util.Formatter f) Deprecated.
protected int	getTotalCoords() Deprecated.
protected Aggregation.Dataset	makeDataset(MFile dset) Deprecated.
protected Aggregation.Dataset	makeDataset(java.lang.String cacheName, java.lang.String location, java.lang.String id, java.lang.String ncoordS, java.lang.String coordValueS, java.lang.String sectionSpec, java.util.EnumSet<NetcdfDataset.Enhance> enhance, FileFactory reader) Deprecated. Dataset factory, so subclasses can override
protected void	promoteGlobalAttributes(ucar.nc2.ncml.AggregationOuterDimension.DatasetOuterDimension typicalDataset) Deprecated.
protected void	readTimeCoordinates(Variable timeAxis, CancelTask cancelTask) Deprecated.
Array	reallyRead(Variable mainv, CancelTask cancelTask) Deprecated. Read an aggregation variable: A variable whose data spans multiple files.
Array	reallyRead(Variable mainv, Section section, CancelTask cancelTask) Deprecated. Read a section of an aggregation variable.
protected void	rebuildDataset() Deprecated. Call this when rescan has found changed datasets

Methods inherited from class ucar.nc2.ncml.Aggregation

addCollection, addDataset, addDatasetScan, addDatasetScan, addExplicitDataset, buildNetcdfDataset, close, findVariable, finish, getDatasets, getDimensionName, getFileTypeDescription, getFileTypeId, getLastModified, getLocation, getType, getTypicalDataset, instanceOfDatasetProxyReader, makeDatasets, persistRead, persistWrite, setDatasetAcquireProxy, setDatasetAcquireProxy, setExecutor, setModifications, setPersistenceCache, setTypicalDatasetMode, syncExtend

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

debugCache

protected static boolean debugCache

Deprecated.

debugInvocation

protected static boolean debugInvocation

Deprecated.

debugStride

protected static boolean debugStride

Deprecated.

invocation

public static int invocation

Deprecated.

aggVarNames

protected java.util.List<java.lang.String> aggVarNames

Deprecated.

aggVars

protected java.util.List<VariableDS> aggVars

Deprecated.

cacheList

protected java.util.List<ucar.nc2.ncml.AggregationOuterDimension.CacheVar> cacheList

Deprecated.

timeUnitsChange

protected boolean timeUnitsChange

Deprecated.

Constructor Detail

AggregationOuterDimension

protected AggregationOuterDimension(NetcdfDataset ncd,
                                    java.lang.String dimName,
                                    Aggregation.Type type,
                                    java.lang.String recheckS)

Deprecated.

Create an Aggregation for the given NetcdfDataset. The following addXXXX methods are called, then finish(), before the object is ready for use.

Parameters:

ncd - Aggregation belongs to this NetcdfDataset

dimName - the aggregation dimension name

type - the Aggregation.Type

recheckS - how often to check if files have changes

Method Detail

addVariable

public void addVariable(java.lang.String varName)

Deprecated.

Add a name for a variableAgg element

Parameters:

varName - name of agg variable

buildCoords

protected void buildCoords(CancelTask cancelTask)
                    throws java.io.IOException

Deprecated.

Throws:

java.io.IOException

readTimeCoordinates

protected void readTimeCoordinates(Variable timeAxis,
                                   CancelTask cancelTask)
                            throws java.io.IOException

Deprecated.

Throws:

java.io.IOException

getTotalCoords

protected int getTotalCoords()

Deprecated.

promoteGlobalAttributes

protected void promoteGlobalAttributes(ucar.nc2.ncml.AggregationOuterDimension.DatasetOuterDimension typicalDataset)
                                throws java.io.IOException

Deprecated.

Throws:

java.io.IOException

rebuildDataset

protected void rebuildDataset()
                       throws java.io.IOException

Deprecated.

Description copied from class: Aggregation

Call this when rescan has found changed datasets

Specified by:

rebuildDataset in class Aggregation

Throws:

java.io.IOException - on read error

reallyRead

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

Deprecated.

Read a section of an aggregation variable.

Specified by:

reallyRead in interface ProxyReader

Parameters:

section - read just this section of the data, array of Range

mainv - the client Variable

cancelTask - user may cancel

Returns:

the data array section

Throws:

java.io.IOException - on error

InvalidRangeException - if section has incorrect rank or illegal shape.

reallyRead

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

Deprecated.

Read an aggregation variable: A variable whose data spans multiple files. This is an implementation of ProxyReader, so must fulfill that contract.

Specified by:

reallyRead in interface ProxyReader

Parameters:

mainv - the aggregation variable

cancelTask - user may cancel

Returns:

memory resident Array containing the data. Will have same shape as the Variable.

Throws:

java.io.IOException - on error

makeDataset

protected Aggregation.Dataset makeDataset(java.lang.String cacheName,
                                          java.lang.String location,
                                          java.lang.String id,
                                          java.lang.String ncoordS,
                                          java.lang.String coordValueS,
                                          java.lang.String sectionSpec,
                                          java.util.EnumSet<NetcdfDataset.Enhance> enhance,
                                          FileFactory reader)

Deprecated.

Description copied from class: Aggregation

Dataset factory, so subclasses can override

Overrides:

makeDataset in class Aggregation

Parameters:

cacheName - a unique name to use for caching

location - attribute "location" on the netcdf element

id - attribute "id" on the netcdf element

ncoordS - attribute "ncoords" on the netcdf element

coordValueS - attribute "coordValue" on the netcdf element

sectionSpec - attribute "sectionSpec" on the netcdf element

enhance - open dataset in enhance mode NOT USED

reader - factory for reading this netcdf dataset

Returns:

a Aggregation.Dataset

makeDataset

protected Aggregation.Dataset makeDataset(MFile dset)

Deprecated.

Overrides:

makeDataset in class Aggregation

getDetailInfo

public void getDetailInfo(java.util.Formatter f)

Deprecated.

Specified by:

getDetailInfo in interface AggregationIF

Overrides:

getDetailInfo in class Aggregation