Package org.apache.sis.coverage
Class BandedCoverage
Object
BandedCoverage
- Direct Known Subclasses:
GridCoverage
A coverage where all sample values at a given location can be provided in an array of primitive type.
This class does not require sample values to be "physically" stored in different bands,
but it enforces similar constraints:
- Sample values are represented by a primitive type, typically
byte
,short
orfloat
. - All sample dimensions (bands) use the same primitive type.
- Sample dimensions (bands) are accessed by band index with the first band at index 0.
Comparison with ISO 19123:
by contrast an ISO
The effect of above restrictions appears in Coverage
does not restrict sample values to primitive types,
does not require all sample dimensions to use the same type,
and sample values are accessed by field names instead of band indices.
Said otherwise, an ISO Coverage
can provide a complex structure (a Record
)
at every location while this BandedCoverage
class provides only primitive arrays such as float[]
.
getSampleDimensions()
and
BandedCoverage.Evaluator.apply(DirectPosition)
method signatures.- Since:
- 1.1
Defined in the sis-feature
module
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic interface
Computes or interpolates values of sample dimensions at given positions. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionabstract BandedCoverage.Evaluator
Creates a new function for computing or interpolating sample values at given locations.abstract List<SampleDimension>
Returns information about the range of this coverage.
-
Constructor Details
-
BandedCoverage
protected BandedCoverage()Constructs a coverage.
-
-
Method Details
-
getSampleDimensions
Returns information about the range of this coverage. Information include names, sample value ranges, fill values and transfer functions for all bands in this coverage. The length of the returned list should be equal to the number of bands in rendered images.- Returns:
- names, value ranges, fill values and transfer functions for all bands in this grid coverage.
-
evaluator
Creates a new function for computing or interpolating sample values at given locations. That function acceptsDirectPosition
in arbitrary Coordinate Reference System; conversions to the coverage reference system are applied as needed.Multi-threading
Evaluator
s are not thread-safe. For computing sample values concurrently, a newBandedCoverage.Evaluator
instance should be created for each thread by invoking this method multiply times.- Returns:
- a new function for computing or interpolating sample values.
-