| org.geotools.coverage.AbstractCoverage
 org.geotools.coverage.SpatioTemporalCoverage3D
| SpatioTemporalCoverage3D | | public class SpatioTemporalCoverage3D extends AbstractCoverage (Code) | | Convenience view of an other coverage with x, y and time axis.
This class provides
evaluate methods in two versions: the usual one expecting
a complete
, and an other one expecting the
and the
as separated arguments.
This class will detects by itself which dimension is the time axis. It will also tries to uses
the
Point2D 's
value for
or west direction, and the
value for
or south direction. The dimension mapping can be examined with the
SpatioTemporalCoverage3D.toSourceDimension method.
Note: This class is not thread safe for performance reasons. If desired,
users should create one instance of
SpatioTemporalCoverage3D for each thread.
since:
2.1
version:
$Id: SpatioTemporalCoverage3D.java 25787 2007-06-10 16:04:55Z desruisseaux $
author:
Martin Desruisseaux |
| Method Summary | |
| final public boolean[] | evaluate(Point2D point, Date time, boolean[] dest)
Returns a sequence of boolean values for a given point in the coverage.
Parameters:
point - The coordinate point where to evaluate.
Parameters:
time - The date where to evaluate.
Parameters:
dest - An array in which to store values, or null to create a new array. | | final public byte[] | evaluate(Point2D point, Date time, byte[] dest)
Returns a sequence of byte values for a given point in the coverage.
Parameters:
point - The coordinate point where to evaluate.
Parameters:
time - The date where to evaluate.
Parameters:
dest - An array in which to store values, or null to create a new array. | | final public int[] | evaluate(Point2D point, Date time, int[] dest)
Returns a sequence of integer values for a given point in the coverage.
Parameters:
point - The coordinate point where to evaluate.
Parameters:
time - The date where to evaluate.
Parameters:
dest - An array in which to store values, or null to create a new array. | | final public float[] | evaluate(Point2D point, Date time, float[] dest)
Returns a sequence of float values for a given point in the coverage.
Parameters:
point - The coordinate point where to evaluate.
Parameters:
time - The date where to evaluate.
Parameters:
dest - An array in which to store values, or null to create a new array. | | final public double[] | evaluate(Point2D point, Date time, double[] dest)
Returns a sequence of double values for a given point in the coverage.
Parameters:
point - The coordinate point where to evaluate.
Parameters:
time - The date where to evaluate.
Parameters:
dest - An array in which to store values, or null to create a new array. | | final public Object | evaluate(DirectPosition coord)
Returns the value vector for a given point in the coverage. | | final public boolean[] | evaluate(DirectPosition coord, boolean[] dest)
Returns a sequence of boolean values for a given point in the coverage. | | final public byte[] | evaluate(DirectPosition coord, byte[] dest)
Returns a sequence of byte values for a given point in the coverage. | | final public int[] | evaluate(DirectPosition coord, int[] dest)
Returns a sequence of integer values for a given point in the coverage. | | final public float[] | evaluate(DirectPosition coord, float[] dest)
Returns a sequence of float values for a given point in the coverage. | | final public double[] | evaluate(DirectPosition coord, double[] dest)
Returns a sequence of double values for a given point in the coverage. | | protected Dimension2D | getDefaultPixelSize()
Returns the default pixel size for images to be produced by
SpatioTemporalCoverage3D.getRenderableImage(Date) .
This method is invoked by
RenderableImage.createDefaultRendering for computing a
default image size. | | public GeographicBoundingBox | getGeographicBoundingBox()
Returns the
geographic bounding box. | | public GridCoverage2D | getGridCoverage2D(Date time)
Returns a 2 dimensional grid coverage for the given date. | | public int | getNumSampleDimensions()
The number of sample dimensions in the coverage. | | public RenderableImage | getRenderableImage(Date date)
Returns 2D view of this grid coverage at the given date. | | public SampleDimension | getSampleDimension(int index)
Retrieve sample dimension information for the coverage.
Parameters:
index - Index for sample dimension to retrieve. | | public Range | getTimeRange()
Returns the
time range. | | final public Coverage | getWrappedCoverage()
Returns the coverage specified at construction time. | | final public Date | toDate(DirectPosition position)
Returns the date for the specified direct position. | | final public DirectPosition | toDirectPosition(Point2D point, Date date)
Returns a coordinate point for the given spatial position and date.
Parameters:
point - The spatial position.
Parameters:
date - The date. | | final public Point2D | toPoint2D(DirectPosition position)
Returns the spatial coordinate for the specified direct position. | | final public int | toSourceDimension(int dimension)
Returns the dimension in the wrapped coverage for the specified dimension in this coverage.
The
evaluate(Point2D, Date) methods expect ordinates in the
(x, y, t) order.
The
evaluate(DirectPosition) methods and the wrapped coverage way uses a different
order.
Parameters:
dimension - A dimension in this coverage:0 for x,1 for y or2 for t. |
| SpatioTemporalCoverage3D | | public SpatioTemporalCoverage3D(CharSequence name, Coverage coverage) throws IllegalArgumentException(Code) | | Constructs a new coverage. The coordinate reference system will be the same than the
wrapped coverage, which must be three dimensional. This CRS must have a
component.
Parameters:
name - The name for this coverage, or null for the same than coverage .
Parameters:
coverage - The source coverage.
throws:
IllegalArgumentException - if the coverage CRS doesn't have a temporal component. |
| evaluate | | final public boolean[] evaluate(Point2D point, Date time, boolean[] dest) throws CannotEvaluateException(Code) | | Returns a sequence of boolean values for a given point in the coverage.
Parameters:
point - The coordinate point where to evaluate.
Parameters:
time - The date where to evaluate.
Parameters:
dest - An array in which to store values, or null to create a new array. The dest array, or a newly created array if dest was null.
throws:
PointOutsideCoverageException - if point or time is outside coverage.
throws:
CannotEvaluateException - if the computation failed for some other reason. |
| evaluate | | final public byte[] evaluate(Point2D point, Date time, byte[] dest) throws CannotEvaluateException(Code) | | Returns a sequence of byte values for a given point in the coverage.
Parameters:
point - The coordinate point where to evaluate.
Parameters:
time - The date where to evaluate.
Parameters:
dest - An array in which to store values, or null to create a new array. The dest array, or a newly created array if dest was null.
throws:
PointOutsideCoverageException - if point or time is outside coverage.
throws:
CannotEvaluateException - if the computation failed for some other reason. |
| evaluate | | final public int[] evaluate(Point2D point, Date time, int[] dest) throws CannotEvaluateException(Code) | | Returns a sequence of integer values for a given point in the coverage.
Parameters:
point - The coordinate point where to evaluate.
Parameters:
time - The date where to evaluate.
Parameters:
dest - An array in which to store values, or null to create a new array. The dest array, or a newly created array if dest was null.
throws:
PointOutsideCoverageException - if point or time is outside coverage.
throws:
CannotEvaluateException - if the computation failed for some other reason. |
| evaluate | | final public float[] evaluate(Point2D point, Date time, float[] dest) throws CannotEvaluateException(Code) | | Returns a sequence of float values for a given point in the coverage.
Parameters:
point - The coordinate point where to evaluate.
Parameters:
time - The date where to evaluate.
Parameters:
dest - An array in which to store values, or null to create a new array. The dest array, or a newly created array if dest was null.
throws:
PointOutsideCoverageException - if point or time is outside coverage.
throws:
CannotEvaluateException - if the computation failed for some other reason. |
| evaluate | | final public double[] evaluate(Point2D point, Date time, double[] dest) throws CannotEvaluateException(Code) | | Returns a sequence of double values for a given point in the coverage.
Parameters:
point - The coordinate point where to evaluate.
Parameters:
time - The date where to evaluate.
Parameters:
dest - An array in which to store values, or null to create a new array. The dest array, or a newly created array if dest was null.
throws:
PointOutsideCoverageException - if point or time is outside coverage.
throws:
CannotEvaluateException - if the computation failed for some other reason. |
| evaluate | | final public Object evaluate(DirectPosition coord) throws CannotEvaluateException(Code) | | Returns the value vector for a given point in the coverage.
Parameters:
coord - The coordinate point where to evaluate.
throws:
PointOutsideCoverageException - if coord is outside coverage.
throws:
CannotEvaluateException - if the computation failed for some other reason. |
| evaluate | | final public boolean[] evaluate(DirectPosition coord, boolean[] dest) throws CannotEvaluateException(Code) | | Returns a sequence of boolean values for a given point in the coverage.
|
| evaluate | | final public byte[] evaluate(DirectPosition coord, byte[] dest) throws CannotEvaluateException(Code) | | Returns a sequence of byte values for a given point in the coverage.
|
| evaluate | | final public int[] evaluate(DirectPosition coord, int[] dest) throws CannotEvaluateException(Code) | | Returns a sequence of integer values for a given point in the coverage.
|
| evaluate | | final public float[] evaluate(DirectPosition coord, float[] dest) throws CannotEvaluateException(Code) | | Returns a sequence of float values for a given point in the coverage.
|
| evaluate | | final public double[] evaluate(DirectPosition coord, double[] dest) throws CannotEvaluateException(Code) | | Returns a sequence of double values for a given point in the coverage.
|
| getDefaultPixelSize | | protected Dimension2D getDefaultPixelSize()(Code) | | Returns the default pixel size for images to be produced by
SpatioTemporalCoverage3D.getRenderableImage(Date) .
This method is invoked by
RenderableImage.createDefaultRendering for computing a
default image size. The default implementation for this method always returns
null .
Subclasses should overrides this method in order to provides a pixel size better suited to
their data.
The default pixel size, or null if no default is provided. |
| getGeographicBoundingBox | | public GeographicBoundingBox getGeographicBoundingBox() throws TransformException(Code) | | Returns the
geographic bounding box.
The bounding box coordinates uses the
CRS.
The geographic bounding box.
throws:
TransformException - if the envelope can't be transformed. |
| getGridCoverage2D | | public GridCoverage2D getGridCoverage2D(Date time) throws CannotEvaluateException(Code) | | Returns a 2 dimensional grid coverage for the given date. The grid geometry will be computed
in order to produces image with the
,
if any.
Parameters:
time - The date where to evaluate. The grid coverage at the specified time, or null if the requested date fall in a hole in the data.
throws:
PointOutsideCoverageException - if time is outside coverage.
throws:
CannotEvaluateException - if the computation failed for some other reason.
See Also: SpatioTemporalCoverage3D.getRenderableImage(Date)
See Also: RenderableImage.createDefaultRendering return |
| getNumSampleDimensions | | public int getNumSampleDimensions()(Code) | | The number of sample dimensions in the coverage.
For grid coverages, a sample dimension is a band.
The number of sample dimensions in the coverage. |
| getRenderableImage | | public RenderableImage getRenderableImage(Date date)(Code) | | Returns 2D view of this grid coverage at the given date. For images produced by the
, the size
will be computed from the
,
if any.
Parameters:
date - The date where to evaluate the images. The renderable image. |
| getSampleDimension | | public SampleDimension getSampleDimension(int index) throws IndexOutOfBoundsException(Code) | | Retrieve sample dimension information for the coverage.
Parameters:
index - Index for sample dimension to retrieve. Indices are numbered 0 to(-1). Sample dimension information for the coverage.
throws:
IndexOutOfBoundsException - if index is out of bounds. |
| getTimeRange | | public Range getTimeRange()(Code) | | Returns the
time range.
The returned range contains
Date objects.
|
| getWrappedCoverage | | final public Coverage getWrappedCoverage()(Code) | | Returns the coverage specified at construction time.
since:
2.2 |
| toSourceDimension | | final public int toSourceDimension(int dimension)(Code) | | Returns the dimension in the wrapped coverage for the specified dimension in this coverage.
The
evaluate(Point2D, Date) methods expect ordinates in the
(x, y, t) order.
The
evaluate(DirectPosition) methods and the wrapped coverage way uses a different
order.
Parameters:
dimension - A dimension in this coverage:0 for x,1 for y or2 for t. The corresponding dimension in the wrapped coverage.
See Also: SpatioTemporalCoverage3D.toDate
See Also: SpatioTemporalCoverage3D.toPoint2D
See Also: SpatioTemporalCoverage3D.toDirectPosition |
| Fields inherited from org.geotools.coverage.AbstractCoverage | final protected CoordinateReferenceSystem crs(Code)(Java Doc)
|
| Methods inherited from org.geotools.coverage.AbstractCoverage | public boolean dispose(boolean force)(Code)(Java Doc)
public void dispose()(Code)(Java Doc)
public Set evaluate(DirectPosition coord, Set list)(Code)(Java Doc)
public boolean[] evaluate(DirectPosition coord, boolean[] dest) throws CannotEvaluateException(Code)(Java Doc)
public byte[] evaluate(DirectPosition coord, byte[] dest) throws CannotEvaluateException(Code)(Java Doc)
public int[] evaluate(DirectPosition coord, int[] dest) throws CannotEvaluateException(Code)(Java Doc)
public float[] evaluate(DirectPosition coord, float[] dest) throws CannotEvaluateException(Code)(Java Doc)
public double[] evaluate(DirectPosition coord, double[] dest) throws CannotEvaluateException(Code)(Java Doc)
public Set evaluateInverse(Record v)(Code)(Java Doc)
public List find(DirectPosition p, int limit)(Code)(Java Doc)
public GeometryValuePair find(DirectPosition p)(Code)(Java Doc)
public CommonPointRule getCommonPointRule()(Code)(Java Doc)
public CoordinateReferenceSystem getCoordinateReferenceSystem()(Code)(Java Doc)
final public int getDimension()(Code)(Java Doc)
public InternationalString[] getDimensionNames()(Code)(Java Doc)
final public String[] getDimensionNames(Locale locale)(Code)(Java Doc)
public Set getDomainElements()(Code)(Java Doc)
public Set getDomainExtents()(Code)(Java Doc)
public Envelope getEnvelope()(Code)(Java Doc)
public Locale getLocale()(Code)(Java Doc)
public String[] getMetadataNames()(Code)(Java Doc)
public String getMetadataValue(String name) throws MetadataNameNotFoundException(Code)(Java Doc)
public InternationalString getName()(Code)(Java Doc)
public Set getRangeElements()(Code)(Java Doc)
public RecordType getRangeType()(Code)(Java Doc)
public RenderableImage getRenderableImage(int xAxis, int yAxis)(Code)(Java Doc)
public List getSources()(Code)(Java Doc)
public Set list()(Code)(Java Doc)
public Set select(Geometry arg0, Period arg1)(Code)(Java Doc)
public void show(int xAxis, int yAxis)(Code)(Java Doc)
public void show(String title, int xAxis, int yAxis)(Code)(Java Doc)
public void show(String title)(Code)(Java Doc)
public void show()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
|
|
|