Package org.geotools.coverage.processing.operation

Class Multiply

Object

AbstractOperation

Operation2D

OperationJAI

BaseMathOperationJAI

Multiply

All Implemented Interfaces:

Serializable, Operation

public class Multiply
extends BaseMathOperationJAI

Create a new coverage as the multiplication of two source coverages by doing pixel by pixel multiplication: result[0][0] = source0[0][0] * source1[0][0] ... ... result[i][j] = source0[i][j] * source1[i][j] ... ... result[n-1][m-1] = source0[n-1][m-1] * source1[n-1][m-1]

Make sure coverages have same envelope and same resolution before using this operation.

Name: "Multiply"
JAI operator: "Multiply"
Parameters:

Name	Class	Default value	Minimum value	Maximum value
"Source0"	GridCoverage2D	N/A	N/A	N/A
"Source1"	GridCoverage2D	N/A	N/A	N/A

Since:

8.x

See Also:

Operations.multiply(org.geotools.api.coverage.Coverage, org.geotools.api.coverage.Coverage), Multiply, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class OperationJAI

OperationJAI.Parameters

Field Summary

Fields inherited from class BaseMathOperationJAI

LOGGER, SOURCES, SOURCES_NAME

Fields inherited from class OperationJAI

operation, RENDERED_MODE

Fields inherited from class Operation2D

PRIMARY_SOURCE_INDEX, SOURCE_0

Fields inherited from class AbstractOperation

descriptor

Constructor Summary

Constructors

Constructor	Description
Multiply()	Constructs a default "MultiplyConst" operation.

Method Summary

Modifier and Type	Method	Description
protected NumberRange<? extends Number>	deriveRange(NumberRange<? extends Number>[] ranges, OperationJAI.Parameters parameters)	Returns the expected range of values for the resulting image.
protected void	extractSources(ParameterValueGroup parameters, Collection<GridCoverage2D> sources, String[] sourceNames)	Extraction of the sources from the parameter called SOURCES.
String	getName()	Returns the name of the processing operation.
protected Map<String,?>	getProperties(RenderedImage data, CoordinateReferenceSystem crs, InternationalString name, MathTransform gridToCRS, GridCoverage2D[] sources, OperationJAI.Parameters parameters)	Prepares the properties to be given to the coverage created by the deriveGridCoverage method.
protected void	handleJAIEXTParams(ParameterBlockJAI parameters, ParameterValueGroup parameters2)	Extension point for adding to the JAI ParameterBlockJAI object the parameters defined in the ParameterValueGroup, which can be read by the JAI-EXT operations.

Methods inherited from class OperationJAI

createRenderedImage, deriveCategory, deriveGridCoverage, deriveName, deriveSampleDimension, deriveUnit, doOperation, equals, getJAI, getOperationDescriptor, getQuantitative, handleROINoDataInternal, handleROINoDataProperties, hashCode, prepareParameters, resampleToCommonGeometry

Methods inherited from class Operation2D

extractSources, getFactory

Methods inherited from class AbstractOperation

getDescription, getDocURL, getNumSources, getParameters, getVendor, getVersion, toString

Methods inherited from class Object

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

Constructor Detail

Multiply

public Multiply()

Constructs a default "MultiplyConst" operation.

Method Detail

getName

public String getName()

Description copied from class: AbstractOperation

Returns the name of the processing operation. The default implementation returns the AbstractOperation.descriptor code name.

Specified by:

getName in interface Operation

Overrides:

getName in class AbstractOperation

Returns:

The name of the processing operation.

deriveRange

protected NumberRange<? extends Number> deriveRange(NumberRange<? extends Number>[] ranges,
                                                    OperationJAI.Parameters parameters)

Returns the expected range of values for the resulting image.

Overrides:

deriveRange in class OperationJAI

Parameters:

ranges - The range of values from every sources. For unary operations this array has a length of 1. For binary operations like "add" and "multiply", this array has a length of 2.

parameters - Parameters, rendering hints and coordinate reference system to use.

Returns:

The range of values to use in the destination image, or null if unknow.

handleJAIEXTParams

protected void handleJAIEXTParams(ParameterBlockJAI parameters,
                                  ParameterValueGroup parameters2)

Description copied from class: OperationJAI

Extension point for adding to the JAI ParameterBlockJAI object the parameters defined in the ParameterValueGroup, which can be read by the JAI-EXT operations.

Notice that if you are using JAI, the new parameters will not be accepted by the ParameterBlockJAI instance.

Overrides:

handleJAIEXTParams in class OperationJAI

Parameters:

parameters - ParameterBlockJAI instance used by the current JAI-EXT/JAI operation

parameters2 - ParameterValueGroup instance containing input operation parameters

extractSources

protected void extractSources(ParameterValueGroup parameters,
                              Collection<GridCoverage2D> sources,
                              String[] sourceNames)
                       throws ParameterNotFoundException,
                              InvalidParameterValueException

Description copied from class: OperationJAI

Extraction of the sources from the parameter called SOURCES. The sources are stored inside a List.

Overrides:

extractSources in class BaseMathOperationJAI

Throws:

ParameterNotFoundException

InvalidParameterValueException

getProperties

protected Map<String,?> getProperties(RenderedImage data,
                                            CoordinateReferenceSystem crs,
                                            InternationalString name,
                                            MathTransform gridToCRS,
                                            GridCoverage2D[] sources,
                                            OperationJAI.Parameters parameters)

Description copied from class: OperationJAI

Prepares the properties to be given to the coverage created by the deriveGridCoverage method. The default implementation returns null.

Overrides:

getProperties in class OperationJAI

Parameters:

data - The RenderedImage created by this operation.

crs - The coordinate reference system assigned to the coverage this OperationJAI will produce.

name - The name assigned to the coverage this OperationJAI will produce.

gridToCRS - The transform from grid to crs to be assigned to the coverage this OperationJAI will produce.

sources - The sources to be assigned to the coverage this OperationJAI will produce.

parameters - The parameters that were used by this OperationJAI.

Returns:

a Map with the properties generated by this OperationJAI or null if we haven't any.