jaitools.media.jai.zonalstats
Class ZonalStatsOpImage

java.lang.Object
  javax.media.jai.PlanarImage
      javax.media.jai.OpImage
          javax.media.jai.PointOpImage
              javax.media.jai.NullOpImage
                  jaitools.media.jai.zonalstats.ZonalStatsOpImage

All Implemented Interfaces:

java.awt.image.RenderedImage, javax.media.jai.ImageJAI, javax.media.jai.PropertyChangeEmitter, javax.media.jai.PropertySource, javax.media.jai.WritablePropertySource

public class ZonalStatsOpImage
extends javax.media.jai.NullOpImage

Calculates image summary statistics for a data image within zones defined by a integral valued zone image. If a zone image is not provided all data image pixels are treated as being in the same zone (zone 0).

Since:

1.0

Version:

$Id: ZonalStatsOpImage.java 1100 2010-02-10 07:28:08Z michael.bedward $

Author:

Michael Bedward, Andrea Antonello

See Also:

Description of the algorithm and example

Field Summary

Fields inherited from class javax.media.jai.NullOpImage

computeType

Fields inherited from class javax.media.jai.OpImage

cache, cobbleSources, OP_COMPUTE_BOUND, OP_IO_BOUND, OP_NETWORK_BOUND, tileCacheMetric, tileRecycler

Fields inherited from class javax.media.jai.PlanarImage

colorModel, eventManager, height, minX, minY, properties, sampleModel, tileFactory, tileGridXOffset, tileGridYOffset, tileHeight, tileWidth, width

Constructor Summary

ZonalStatsOpImage(java.awt.image.RenderedImage dataImage, java.awt.image.RenderedImage zoneImage, java.util.Map<?,?> config, javax.media.jai.ImageLayout layout, Statistic[] stats, java.lang.Integer[] bands, javax.media.jai.ROI roi, java.awt.geom.AffineTransform zoneTransform, java.util.List<Range<java.lang.Double>> excludedRanges)
Constructor.

Method Summary

java.lang.Object	getProperty(java.lang.String name) Get the specified property.
java.lang.Class<?>	getPropertyClass(java.lang.String name) Get the class of the given property.
java.lang.String[]	getPropertyNames() Get all property names

Methods inherited from class javax.media.jai.NullOpImage

computesUniqueTiles, computeTile, getOperationComputeType, getProperties, getPropertyNames, removeProperty, setProperties, setProperty

Methods inherited from class javax.media.jai.PointOpImage

dispose, isColormapOperation, mapDestRect, mapSourceRect, permitInPlaceOperation

Methods inherited from class javax.media.jai.OpImage

addTileToCache, cancelTiles, computeRect, computeRect, createTile, getExpandedNumBands, getFormatTags, getTile, getTileCache, getTileCacheMetric, getTileDependencies, getTileFromCache, getTileRecycler, getTiles, hasExtender, mapDestPoint, mapSourcePoint, prefetchTiles, queueTiles, recycleTile, setTileCache, vectorize, vectorize, vectorize

Methods inherited from class javax.media.jai.PlanarImage

addPropertyChangeListener, addPropertyChangeListener, addSink, addSink, addSource, addTileComputationListener, copyData, copyData, copyExtendedData, createColorModel, createSnapshot, createWritableRaster, finalize, getAsBufferedImage, getAsBufferedImage, getBounds, getColorModel, getData, getData, getDefaultColorModel, getExtendedData, getGraphics, getHeight, getImageID, getMaxTileX, getMaxTileY, getMaxX, getMaxY, getMinTileX, getMinTileY, getMinX, getMinY, getNumBands, getNumSources, getNumXTiles, getNumYTiles, getSampleModel, getSinks, getSource, getSourceImage, getSourceObject, getSources, getSplits, getTileComputationListeners, getTileFactory, getTileGridXOffset, getTileGridYOffset, getTileHeight, getTileIndices, getTileRect, getTiles, getTileWidth, getWidth, overlapsMultipleTiles, removePropertyChangeListener, removePropertyChangeListener, removeSink, removeSink, removeSinks, removeSource, removeSources, removeTileComputationListener, setImageLayout, setSource, setSources, tileXToX, tileXToX, tileYToY, tileYToY, toString, wrapRenderedImage, XToTileX, XToTileX, YToTileY, YToTileY

Methods inherited from class java.lang.Object

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

Constructor Detail

ZonalStatsOpImage

public ZonalStatsOpImage(java.awt.image.RenderedImage dataImage,
                         java.awt.image.RenderedImage zoneImage,
                         java.util.Map<?,?> config,
                         javax.media.jai.ImageLayout layout,
                         Statistic[] stats,
                         java.lang.Integer[] bands,
                         javax.media.jai.ROI roi,
                         java.awt.geom.AffineTransform zoneTransform,
                         java.util.List<Range<java.lang.Double>> excludedRanges)

Constructor.

Parameters:

dataImage - a RenderedImage from which data values will be read.

zoneImage - an optional RenderedImage of integral data type that defines the zones for which to calculate summary data.

config - configurable attributes of the image (see AreaOpImage).

layout - an optional ImageLayout object.

stats - an array of Statistic constants specifying the data required.

bands - the data image band to process.

roi - an optional ROI for data image masking.

zoneTransform -

excludedRanges - a List of Ranges, that will be filtered out of the process. This means that values inside the supplied ranges will not be considered as valid and discarded.

See Also:

ZonalStatsDescriptor, Statistic

Method Detail

getProperty

public java.lang.Object getProperty(java.lang.String name)

Get the specified property.

Use this method to retrieve the calculated statistics as a map of ZonalStats per band by setting name to ZonalStatsDescriptor.ZONAL_STATS_PROPERTY.

Specified by:

getProperty in interface java.awt.image.RenderedImage

Specified by:

getProperty in interface javax.media.jai.PropertySource

Overrides:

getProperty in class javax.media.jai.NullOpImage

Parameters:

name - property name

Returns:

the requested property

getPropertyClass

public java.lang.Class<?> getPropertyClass(java.lang.String name)

Get the class of the given property. For ZonalStatsDescriptor.ZONAL_STATS_PROPERTY this will return Map.class.

Specified by:

getPropertyClass in interface javax.media.jai.PropertySource

Overrides:

getPropertyClass in class javax.media.jai.NullOpImage

Parameters:

name - property name

Returns:

the property class

getPropertyNames

public java.lang.String[] getPropertyNames()

Get all property names

Specified by:

getPropertyNames in interface java.awt.image.RenderedImage

Specified by:

getPropertyNames in interface javax.media.jai.PropertySource

Overrides:

getPropertyNames in class javax.media.jai.NullOpImage

Returns:

property names as an array of Strings