edu.unh.sdb.datasource
Class BlockedDataSource

java.lang.Object
  edu.unh.sdb.datasource.DataCollection
      edu.unh.sdb.datasource.DataSource
          edu.unh.sdb.datasource.CompositeDataSource
              edu.unh.sdb.datasource.BlockedDataSource

All Implemented Interfaces:

Indexable

public class BlockedDataSource
extends CompositeDataSource

BlockedDataSource does a spatial join on several blocks of DataSources into one DataSource

Field Summary

Fields inherited from class edu.unh.sdb.datasource.CompositeDataSource

componentInfos

Fields inherited from class edu.unh.sdb.datasource.DataSource

fdlDescriptor, isActivated, name, wsName

Fields inherited from class edu.unh.sdb.datasource.DataCollection

attributeOrder, axisOrdering, axisWeights, bounds, dataOrder, dimensionality, numAttributes, pointOrder, recordDesc

Constructor Summary

BlockedDataSource(java.lang.String dsname, ComponentInfo[] compinfo)
Construct a BlockedDataSource from an array of ComponentInfo.

BlockedDataSource(java.lang.String aname, DataSource[] sources)
This constructor joins all the blocks of the input DataSources.

BlockedDataSource(java.lang.String aname, DataSource[] sources, FieldIDMapper[] FIDmap, ISIDMapper[] ISIDmap)
Construct a BlockedDataSource from parallel arrays of DataSource, FieldIDMapper and ISIDMapper

BlockedDataSource(java.lang.String aname, DataSource[] sources, ISBounds compositeBounds)
This constructor joins all the blocks of the input arrays.

BlockedDataSource(java.lang.String aname, DataSource[] sources, ISBounds[] componentLocations)
Construct a new BlockedDS by specified by the given ISBounds array and the corresponding DataSource array.

BlockedDataSource(java.lang.String aname, DataSource[] sources, ISIDMapper[] ISIDmap)
Construct a BlockedDataSource from parallel arrays of DataSource, and ISIDMapper

Method Summary

void	activate() Activate() method call its component DataSource to activate itself
ARBlock	ARRep(ISBounds bounds) Return a ARBlock, which is a AR representation of the requested area of specified ISBounds
protected boolean	check(ComponentInfo[] cinfo) Check the validity of the given ComponentInfo array
void	datum(Datum dtm, IndexSpaceID isid) Return by reference the Datum corresponding to the given IndexSpaceID.
void	datum(Datum dtm, IndexSpaceID isid, FieldIDMapper mp) Get the Datum and fill its values in the passed Datum at positions specified by the corresponding FieldIDMapper.
void	datum(Datum dtm, IndexSpaceID isid, RecordSpec recSpec) Get the Datum and fill its values in the passed Datum at positions specified by the corresponding RecordSpec.
BlockManager	getBlockManager() Return the BlockManager, from which you can get information for each Component.
protected void	initializeComponents(ComponentInfo[] compinfo) Initialize the component related information on construction
static void	main(java.lang.String[] args)
void	subblock(DataBlock blk, ISBounds blkisb, ISBounds dsisb) Get a block of data of the DataSource, pass by reference before this method is called, check to make sure the Dimensionality and dsisb is inside the DataSource's bounds
void	subblock(DataBlock blk, ISBounds blkisb, ISBounds dsisb, FieldIDMapper mp) Pass by reference subblock method taking FieldIDMapper
void	subblock(DataBlock blk, ISBounds blkisb, ISBounds dsisb, RecordSpec spec) Get a block of data of the DataSource.
DataBlock	subblock(ISBounds blk, ISBounds resolution) get the Datablock and fit in a Datablock which may have different size
java.lang.String	toString() Print the data members of the DataSource in an easy to read fashion.

Methods inherited from class edu.unh.sdb.datasource.CompositeDataSource

deactivate, equals, getComponentBounds, getComponentDataSources, getComponentFieldIDs, getComponentInfos, getCompositeBounds, getCompositeFieldIDs, getFIDMappers

Methods inherited from class edu.unh.sdb.datasource.DataSource

checkActivated, clearCache, copyBestID, create, create, create, createRemote, createRemote, createRemoteClient, createRemoteClient, createRemoteDataSource, createRemoteDataSource, createRemoteDataSourceUDP, createRemoteUDP, createRemoteUDP, dumpData, getName, getValues, isActivated, toString

Methods inherited from class edu.unh.sdb.datasource.DataCollection

byteSize, computeOffset, computeOffset, copyBounds, createDataBlock, createDataBlock, createDataBlock, createDatum, createDatum, createDatum, createDatum, createDatum, createDatum, datum, datum, datum, datum, dim, getAxisOrdering, getAxisWeight, getAxisWeights, getBounds, getByte, getBytes, getBytes, getBytes, getBytes, getBytes, getBytes, getBytesByAttribute, getBytesByAttribute, getBytesByPoint, getBytesByPoint, getDataOrder, getDimensionsArray, getDouble, getDoubles, getDoubles, getDoubles, getDoubles, getDoubles, getDoubles, getDoublesByAttribute, getDoublesByAttribute, getDoublesByPoint, getDoublesByPoint, getFloat, getFloats, getFloats, getFloats, getFloats, getFloats, getFloats, getFloatsByAttribute, getFloatsByAttribute, getFloatsByPoint, getFloatsByPoint, getInt, getInts, getInts, getInts, getInts, getInts, getInts, getIntsByAttribute, getIntsByAttribute, getIntsByPoint, getIntsByPoint, getLowerBoundsArray, getNumAttributes, getRecordDescriptor, getShort, getShorts, getShorts, getShorts, getShorts, getShorts, getShorts, getShortsByAttribute, getShortsByAttribute, getShortsByPoint, getShortsByPoint, getStorageType, getValues, getValuesByAttribute, getValuesByPoint, longVolume, setAxisOrdering, setBounds, setRecordDescriptor, size, subblock, subblock, subblock, subblock, subblock, subblock, subblock, subblock, subblock, useBytesOnly, volume

Methods inherited from class java.lang.Object

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

Constructor Detail

BlockedDataSource

public BlockedDataSource(java.lang.String dsname,
                         ComponentInfo[] compinfo)

Construct a BlockedDataSource from an array of ComponentInfo.

BlockedDataSource

public BlockedDataSource(java.lang.String aname,
                         DataSource[] sources)

This constructor joins all the blocks of the input DataSources. The attributes of all should be the same. The components are all mapped to the composite with identity ISIDMapper. The given DataSource array is parallel to the array of components (or ComponentInfos).

BlockedDataSource

public BlockedDataSource(java.lang.String aname,
                         DataSource[] sources,
                         ISBounds[] componentLocations)

Construct a new BlockedDS by specified by the given ISBounds array and the corresponding DataSource array. componentPositions are the positions of the components in the composite. The given arrays are parallel to the array of components (or ComponentInfos).

BlockedDataSource

public BlockedDataSource(java.lang.String aname,
                         DataSource[] sources,
                         ISBounds compositeBounds)

This constructor joins all the blocks of the input arrays. The attributes of the component DataSources should be compatible The components are all mapped to the composite with identity ISIDMapper The given DataSource array is parallel to the array of components (or ComponentInfos). The ISBounds of this new BlockedDS is the given ISBounds.

BlockedDataSource

public BlockedDataSource(java.lang.String aname,
                         DataSource[] sources,
                         ISIDMapper[] ISIDmap)

Construct a BlockedDataSource from parallel arrays of DataSource, and ISIDMapper

BlockedDataSource

public BlockedDataSource(java.lang.String aname,
                         DataSource[] sources,
                         FieldIDMapper[] FIDmap,
                         ISIDMapper[] ISIDmap)

Construct a BlockedDataSource from parallel arrays of DataSource, FieldIDMapper and ISIDMapper

Method Detail

check

protected boolean check(ComponentInfo[] cinfo)

Check the validity of the given ComponentInfo array

Specified by:

check in class CompositeDataSource

initializeComponents

protected void initializeComponents(ComponentInfo[] compinfo)

Initialize the component related information on construction

Specified by:

initializeComponents in class CompositeDataSource

getBlockManager

public BlockManager getBlockManager()

Return the BlockManager, from which you can get information for each Component.

activate

public void activate()

Activate() method call its component DataSource to activate itself

Overrides:

activate in class CompositeDataSource

subblock

public void subblock(DataBlock blk,
                     ISBounds blkisb,
                     ISBounds dsisb,
                     RecordSpec spec)

Get a block of data of the DataSource. The DataBlock is passed by reference

Specified by:

subblock in interface Indexable

Overrides:

subblock in class DataCollection

subblock

public void subblock(DataBlock blk,
                     ISBounds blkisb,
                     ISBounds dsisb)

Get a block of data of the DataSource, pass by reference before this method is called, check to make sure the Dimensionality and dsisb is inside the DataSource's bounds

Specified by:

subblock in interface Indexable

Specified by:

subblock in class DataCollection

subblock

public void subblock(DataBlock blk,
                     ISBounds blkisb,
                     ISBounds dsisb,
                     FieldIDMapper mp)

Pass by reference subblock method taking FieldIDMapper

Specified by:

subblock in interface Indexable

Specified by:

subblock in class DataCollection

subblock

public DataBlock subblock(ISBounds blk,
                          ISBounds resolution)

get the Datablock and fit in a Datablock which may have different size

datum

public void datum(Datum dtm,
                  IndexSpaceID isid)

Return by reference the Datum corresponding to the given IndexSpaceID.

Specified by:

datum in interface Indexable

Overrides:

datum in class DataCollection

datum

public void datum(Datum dtm,
                  IndexSpaceID isid,
                  FieldIDMapper mp)

Get the Datum and fill its values in the passed Datum at positions specified by the corresponding FieldIDMapper.

Specified by:

datum in interface Indexable

Specified by:

datum in class DataCollection

datum

public void datum(Datum dtm,
                  IndexSpaceID isid,
                  RecordSpec recSpec)

Get the Datum and fill its values in the passed Datum at positions specified by the corresponding RecordSpec.

Specified by:

datum in interface Indexable

Overrides:

datum in class DataCollection

ARRep

public ARBlock ARRep(ISBounds bounds)

Return a ARBlock, which is a AR representation of the requested area of specified ISBounds

toString

public java.lang.String toString()

Description copied from class: CompositeDataSource

Print the data members of the DataSource in an easy to read fashion.

Overrides:

toString in class CompositeDataSource

main

public static void main(java.lang.String[] args)