ucar.unidata.data

Class DataSelection

java.lang.Object

ucar.unidata.data.DataSelection

public class DataSelection
extends java.lang.Object

A class that represents some selection of data.

Author:

IDV Development Team

Field Summary

Fields

Modifier and Type	Field and Description
static DataSelection	NULL Null DataSelection
static java.lang.String	PROP_ASTIMEDRIVER status template
static java.lang.String	PROP_CHOOSERTIMEMATCHING chooser time matching property
static java.lang.String	PROP_DATESELECTION Flag to use any times set elsewhere
static java.lang.String	PROP_DEFAULT_LEVELS Property for selected levels
static java.lang.String	PROP_DEFAULTVIEW view manager - used for time/region matching
static java.lang.String	PROP_HASCORNER region option
static java.lang.String	PROP_PROGRESSIVERESOLUTION progressive resolution
static java.lang.String	PROP_REGIONOPTION region option
static java.lang.String	PROP_TIMESUBSET as time subset selection
static java.lang.String	PROP_USEDEFAULTAREA region option
static java.lang.String	PROP_USEDISPLAYAREA region option
static java.lang.String	PROP_USESELECTEDAREA region option
static java.lang.String	PROP_USESTIMEDRIVER status template
static int	TIMESMODE_USEOTHER Flag to use any times set elsewhere
static int	TIMESMODE_USETHIS Flag to use any times set here

Constructor Summary

Constructors

Constructor and Description
DataSelection() Construct a DataSelection.
DataSelection(boolean setDefaults) Construct a DataSelection.
DataSelection(DataSelection that) Construct a DataSelection from another instance.
DataSelection(int zStride) ctor
DataSelection(int xStride, int yStride, int zStride) ctor
DataSelection(java.util.List times) Construct a DataSelection with a list of times.
DataSelection(java.util.List times, int timesMode) Construct a DataSelection with a list of times and a particular times mode.
DataSelection(java.lang.Object fromLevel, java.lang.Object toLevel) ctor

Method Summary

Modifier and Type	Method and Description
DataSelection	cloneMe() Method for creating a clone of this DataSelection
boolean	equals(java.lang.Object o) See if the Object in question is equal to this DataSelection.
java.lang.Object	getFromLevel() Get the FromLevel property.
GeoSelection	getGeoSelection() Get the GeoSelection property.
GeoSelection	getGeoSelection(boolean createIfNeeded) Get the GeoSelection property.
java.util.Hashtable	getProperties() Get the Properties property.
java.lang.Object	getProperty(java.lang.Object key) get the property
boolean	getProperty(java.lang.String name, boolean dflt) Get the named boolean property
java.lang.String	getProperty(java.lang.String name, java.lang.String dflt) Get the named object property
java.util.List<visad.DateTime>	getTimeDriverTimes() Get the TimeDriverTimes property.
java.util.List	getTimes() Get the list of times held by this DataSelection
int	getTimesMode() Get the times mode.
java.lang.Object	getToLevel() Get the ToLevel property.
boolean	getUseThisTimes() Determine whether we should use the times from this DataSelection or not.
int	hashCode() Get the hash code for this DataSelection
boolean	hasTimes() Check whether this DataSelection has a time selection or not.
static DataSelection	merge(DataSelection higherPriority, DataSelection lowerPriority) If either of the params are null then simply return the other one.
void	putProperty(java.lang.Object key, java.lang.Object value) put the property
void	removeProperty(java.lang.Object key) remove the property identified by the given key
void	setBounds(double north, double west, double south, double east) set the clipping bounds
void	setFromLevel(java.lang.Object value) Set the FromLevel property.
void	setGeoSelection(GeoSelection value) Set the GeoSelection property.
void	setLevel(java.lang.Object level) Set the level.
void	setLevelRange(java.lang.Object fromLevel, java.lang.Object toLevel) Set the Level property.
void	setProperties(java.util.Hashtable value) Set the Properties property.
void	setTheTimeDriverTimes(java.util.List<visad.DateTime> value) Set the TimeDriverTimes property.
void	setTimes(java.util.List selectedTimes) Set the times list held by this DataSelection.
void	setTimesMode(int mode) Set the times mode.
void	setToLevel(java.lang.Object value) Set the ToLevel property.
void	setXStride(int stride) set the x stride
void	setXYStride(int stride) set the x and y stride
void	setYStride(int stride) set the y stride
void	setZStride(int stride) set the z stride
java.lang.String	toString() Return a string representation of this DataSelection.

Methods inherited from class java.lang.Object

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

Field Detail

NULL

public static final DataSelection NULL

Null DataSelection

PROP_DEFAULT_LEVELS

public static final java.lang.String PROP_DEFAULT_LEVELS

Property for selected levels

See Also:

Constant Field Values

PROP_DATESELECTION

public static final java.lang.String PROP_DATESELECTION

Flag to use any times set elsewhere

See Also:

Constant Field Values

PROP_USESTIMEDRIVER

public static final java.lang.String PROP_USESTIMEDRIVER

status template

See Also:

Constant Field Values

PROP_ASTIMEDRIVER

public static final java.lang.String PROP_ASTIMEDRIVER

status template

See Also:

Constant Field Values

PROP_CHOOSERTIMEMATCHING

public static final java.lang.String PROP_CHOOSERTIMEMATCHING

chooser time matching property

See Also:

Constant Field Values

PROP_TIMESUBSET

public static final java.lang.String PROP_TIMESUBSET

as time subset selection

See Also:

Constant Field Values

PROP_PROGRESSIVERESOLUTION

public static final java.lang.String PROP_PROGRESSIVERESOLUTION

progressive resolution

See Also:

Constant Field Values

PROP_REGIONOPTION

public static final java.lang.String PROP_REGIONOPTION

region option

See Also:

Constant Field Values

PROP_HASCORNER

public static final java.lang.String PROP_HASCORNER

region option

See Also:

Constant Field Values

PROP_USEDISPLAYAREA

public static final java.lang.String PROP_USEDISPLAYAREA

region option

See Also:

Constant Field Values

PROP_USEDEFAULTAREA

public static final java.lang.String PROP_USEDEFAULTAREA

region option

See Also:

Constant Field Values

PROP_USESELECTEDAREA

public static final java.lang.String PROP_USESELECTEDAREA

region option

See Also:

Constant Field Values

PROP_DEFAULTVIEW

public static final java.lang.String PROP_DEFAULTVIEW

view manager - used for time/region matching

See Also:

Constant Field Values

TIMESMODE_USETHIS

public static final int TIMESMODE_USETHIS

Flag to use any times set here

See Also:

Constant Field Values

TIMESMODE_USEOTHER

public static final int TIMESMODE_USEOTHER

Flag to use any times set elsewhere

See Also:

Constant Field Values

Constructor Detail

DataSelection

public DataSelection()

Construct a DataSelection.

DataSelection

public DataSelection(java.lang.Object fromLevel,
                     java.lang.Object toLevel)

ctor

Parameters:

fromLevel - from level

toLevel - -0

DataSelection

public DataSelection(int zStride)

ctor

Parameters:

zStride - z stride

DataSelection

public DataSelection(int xStride,
                     int yStride,
                     int zStride)

ctor

Parameters:

xStride - stride

yStride - stride

zStride - stride

DataSelection

public DataSelection(boolean setDefaults)

Construct a DataSelection.

Parameters:

setDefaults - If true then we set our defaults from the global defaults

DataSelection

public DataSelection(java.util.List times)

Construct a DataSelection with a list of times. Use the default times mode

Parameters:

times - List of DateTimes

DataSelection

public DataSelection(java.util.List times,
                     int timesMode)

Construct a DataSelection with a list of times and a particular times mode.

Parameters:

times - List of DateTimes

timesMode - mode to use (TIMESMODE_USETHIS, TIMESMODE_USEOTHER)

DataSelection

public DataSelection(DataSelection that)

Construct a DataSelection from another instance.

Parameters:

that - other DataSelection

Method Detail

setXYStride

public void setXYStride(int stride)

set the x and y stride

Parameters:

stride - the stride

setXStride

public void setXStride(int stride)

set the x stride

Parameters:

stride - the stride

setYStride

public void setYStride(int stride)

set the y stride

Parameters:

stride - the stride

setZStride

public void setZStride(int stride)

set the z stride

Parameters:

stride - the stride

setBounds

public void setBounds(double north,
                      double west,
                      double south,
                      double east)

set the clipping bounds

Parameters:

north - north

west - west

south - south

east - east

merge

public static DataSelection merge(DataSelection higherPriority,
                                  DataSelection lowerPriority)

If either of the params are null then simply return the other one. Else, create a new DataSelection and set its times and other attributes to those held by the higherPriority param if it contains times, etc., else set it to the lowerPriority param.

Parameters:

higherPriority - DataSelection with higher priority

lowerPriority - DataSelection with lower priority

Returns:

the new DataSelection

getUseThisTimes

public boolean getUseThisTimes()

Determine whether we should use the times from this DataSelection or not.

Returns:

true if we should use the times from this

setTimesMode

public void setTimesMode(int mode)

Set the times mode.

Parameters:

mode - (TIMESMODE_USEOTHER, TIMESMODE_USETHIS)

getTimesMode

public int getTimesMode()

Get the times mode.

Returns:

TIMESMODE_USEOTHER or TIMESMODE_USETHIS

cloneMe

public DataSelection cloneMe()

Method for creating a clone of this DataSelection

Returns:

cloned version

hasTimes

public boolean hasTimes()

Check whether this DataSelection has a time selection or not.

Returns:

true if it has times set

setTimes

public void setTimes(java.util.List selectedTimes)

Set the times list held by this DataSelection. The given argument may be null and is cloned. This list represents the set of selected times which may either be DateTime objects or Integer indices.

Parameters:

selectedTimes - The new times list.

getTimes

public java.util.List getTimes()

Get the list of times held by this DataSelection

Returns:

list of times

hashCode

public int hashCode()

Get the hash code for this DataSelection

Overrides:

hashCode in class java.lang.Object

Returns:

the hash code

equals

public boolean equals(java.lang.Object o)

See if the Object in question is equal to this DataSelection.

Overrides:

equals in class java.lang.Object

Parameters:

o - Object in question

Returns:

true if they are equal

toString

public java.lang.String toString()

Return a string representation of this DataSelection.

Overrides:

toString in class java.lang.Object

Returns:

a string representation of this DataSelection

setLevel

public void setLevel(java.lang.Object level)

Set the level. This in effect sets both the from and the to level to the argument

Parameters:

level - The level

setLevelRange

public void setLevelRange(java.lang.Object fromLevel,
                          java.lang.Object toLevel)

Set the Level property.

Parameters:

fromLevel - from level

toLevel - to level

setFromLevel

public void setFromLevel(java.lang.Object value)

Set the FromLevel property.

Parameters:

value - The new value for FromLevel

getFromLevel

public java.lang.Object getFromLevel()

Get the FromLevel property.

Returns:

The FromLevel

setToLevel

public void setToLevel(java.lang.Object value)

Set the ToLevel property.

Parameters:

value - The new value for ToLevel

getToLevel

public java.lang.Object getToLevel()

Get the ToLevel property.

Returns:

The ToLevel

setGeoSelection

public void setGeoSelection(GeoSelection value)

Set the GeoSelection property.

Parameters:

value - The new value for GeoSelection

getGeoSelection

public GeoSelection getGeoSelection()

Get the GeoSelection property.

Returns:

The GeoSelection

getGeoSelection

public GeoSelection getGeoSelection(boolean createIfNeeded)

Get the GeoSelection property.

Parameters:

createIfNeeded - If true then create the geosubset of we don't have one already.

Returns:

The GeoSelection

setProperties

public void setProperties(java.util.Hashtable value)

Set the Properties property.

Parameters:

value - The new value for Properties

getProperties

public java.util.Hashtable getProperties()

Get the Properties property.

Returns:

The Properties

getProperty

public java.lang.Object getProperty(java.lang.Object key)

get the property

Parameters:

key - property key

Returns:

property value

removeProperty

public void removeProperty(java.lang.Object key)

remove the property identified by the given key

Parameters:

key - property key

getProperty

public boolean getProperty(java.lang.String name,
                           boolean dflt)

Get the named boolean property

Parameters:

name - name of property

dflt - default value

Returns:

the value of the property or the default

getProperty

public java.lang.String getProperty(java.lang.String name,
                                    java.lang.String dflt)

Get the named object property

Parameters:

name - name of property

dflt - default value

Returns:

the value of the property or the default

putProperty

public void putProperty(java.lang.Object key,
                        java.lang.Object value)

put the property

Parameters:

key - key

value - value

setTheTimeDriverTimes

public void setTheTimeDriverTimes(java.util.List<visad.DateTime> value)

Set the TimeDriverTimes property.

Parameters:

value - The new value for TimeDriverTimes

getTimeDriverTimes

public java.util.List<visad.DateTime> getTimeDriverTimes()

Get the TimeDriverTimes property.

Returns:

The TimeDriverTimes