org.geotoolkit.parameter
Class MatrixParameters

Object
  FormattableObject
      AbstractParameter
          ParameterGroup
              MatrixParameters

All Implemented Interfaces:

Serializable, Cloneable, Formattable, GeneralParameterDescriptor, GeneralParameterValue, ParameterDescriptorGroup, ParameterValueGroup, IdentifiedObject

public class MatrixParameters
extends ParameterGroup
implements ParameterDescriptorGroup

The values for a group of matrix parameters. This value group is extensible, i.e. the number of "elt_row_col" parameters depends on the "num_row" and "num_col" parameter values. Consequently, this parameter value group is also its own mutable operation parameter group.

Since:

2.0

Version:

3.00

Author:

Martin Desruisseaux (IRD)

See Also:

MatrixParameterDescriptors, Serialized Form

Module:

referencing/geotk-referencing (download)

View source code for this class

Field Summary

Fields inherited from class ParameterGroup

EMPTY

Fields inherited from class FormattableObject

EPSG, GEOTIFF, INTERNAL, OGC, SINGLE_LINE

Fields inherited from interface IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Constructor Summary

MatrixParameters(MatrixParameterDescriptors descriptor)
Constructs default values for the specified matrix parameter descriptors.

Method Summary

MatrixParameters	clone() Returns a clone of this parameter group.
ParameterValueGroup	createValue() Forwards the call to the matrix parameter descriptors specified at construction time.
GeneralParameterDescriptor	descriptor(String name) Returns the parameter in this group for the specified name.
List<GeneralParameterDescriptor>	descriptors() Returns the parameters descriptors in this group.
boolean	equals(Object object) Compares this object with the specified one for equality.
Collection<GenericName>	getAlias() Forwards the call to the matrix parameter descriptors specified at construction time.
ParameterDescriptorGroup	getDescriptor() Returns a description of this parameter value group.
Set<ReferenceIdentifier>	getIdentifiers() Forwards the call to the matrix parameter descriptors specified at construction time.
Matrix	getMatrix() Creates a matrix from this group of parameters.
int	getMaximumOccurs() Forwards the call to the matrix parameter descriptors specified at construction time.
int	getMinimumOccurs() Forwards the call to the matrix parameter descriptors specified at construction time.
ReferenceIdentifier	getName() Forwards the call to the matrix parameter descriptors specified at construction time.
InternationalString	getRemarks() Forwards the call to the matrix parameter descriptors specified at construction time.
ParameterValue<Double>	parameter(int row, int column) Returns the value in this group for a matrix element at the specified index.
ParameterValue<?>	parameter(String name) Returns the value in this group for the specified name.
void	setMatrix(Matrix matrix) Sets all parameter values to the element value in the specified matrix.
List<GeneralParameterValue>	values() Returns the parameters values in this group.
protected void	write(TableWriter table) Writes the content of this parameter to the specified table.

Methods inherited from class ParameterGroup

addGroup, groups, hashCode

Methods inherited from class AbstractParameter

formatWKT, toString

Methods inherited from class FormattableObject

getDefaultIndentation, print, setDefaultIndentation, toWKT, toWKT, toWKT

Methods inherited from class Object

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

Methods inherited from interface IdentifiedObject

toWKT

Constructor Detail

MatrixParameters

public MatrixParameters(MatrixParameterDescriptors descriptor)

Constructs default values for the specified matrix parameter descriptors.

Parameters:

descriptor - The descriptor for this group of parameters.

Method Detail

getDescriptor

public ParameterDescriptorGroup getDescriptor()

Returns a description of this parameter value group. Returns always this, since the description depends on "num_row" and "num_col" parameter values.

Specified by:

getDescriptor in interface GeneralParameterValue

Specified by:

getDescriptor in interface ParameterValueGroup

Overrides:

getDescriptor in class ParameterGroup

getName

public ReferenceIdentifier getName()

Forwards the call to the matrix parameter descriptors specified at construction time.

Specified by:

getName in interface IdentifiedObject

getAlias

public Collection<GenericName> getAlias()

Forwards the call to the matrix parameter descriptors specified at construction time.

Specified by:

getAlias in interface IdentifiedObject

getIdentifiers

public Set<ReferenceIdentifier> getIdentifiers()

Forwards the call to the matrix parameter descriptors specified at construction time.

Specified by:

getIdentifiers in interface IdentifiedObject

getRemarks

public InternationalString getRemarks()

Forwards the call to the matrix parameter descriptors specified at construction time.

Specified by:

getRemarks in interface IdentifiedObject

getMinimumOccurs

public int getMinimumOccurs()

Forwards the call to the matrix parameter descriptors specified at construction time.

Specified by:

getMinimumOccurs in interface GeneralParameterDescriptor

getMaximumOccurs

public int getMaximumOccurs()

Forwards the call to the matrix parameter descriptors specified at construction time.

Specified by:

getMaximumOccurs in interface GeneralParameterDescriptor

descriptor

public GeneralParameterDescriptor descriptor(String name)
                                      throws ParameterNotFoundException

Returns the parameter in this group for the specified name. The name can be a matrix element if it uses the following syntax: "elt_row_col" where "elt_" is the prefix for all matrix elements, and row and col are row and column indices respectively. For example "elt_2_1" is the element name for the value at line 2 and row 1. The row and column index are 0 based.

Specified by:

descriptor in interface ParameterDescriptorGroup

Parameters:

name - The case insensitive name of the parameter to search for.

Returns:

The parameter for the given name.

Throws:

ParameterNotFoundException - if there is no parameter for the given name.

parameter

public ParameterValue<?> parameter(String name)
                            throws ParameterNotFoundException

Returns the value in this group for the specified name. The name can be a matrix element if it uses the following syntax: "elt_row_col" where "elt_" is the prefix for all matrix elements, and row and col are row and column indices respectively. For example "elt_2_1" is the element name for the value at line 2 and row 1. The row and column index are 0 based.

Specified by:

parameter in interface ParameterValueGroup

Overrides:

parameter in class ParameterGroup

Parameters:

name - The case insensitive name of the parameter to search for.

Returns:

The parameter value for the given name.

Throws:

ParameterNotFoundException - if there is no parameter for the given name.

See Also:

Parameters.getOrCreate(ParameterDescriptor, ParameterValueGroup)

parameter

public final ParameterValue<Double> parameter(int row,
                                              int column)
                                       throws IndexOutOfBoundsException

Returns the value in this group for a matrix element at the specified index. Row and column index are 0 based.

Parameters:

row - The row indice.

column - The column indice

Returns:

The parameter value for the specified matrix element (never null).

Throws:

IndexOutOfBoundsException - if row or column is out of bounds.

descriptors

public List<GeneralParameterDescriptor> descriptors()

Returns the parameters descriptors in this group. The amount of parameters depends on the value of "num_row" and "num_col" parameters.

Specified by:

descriptors in interface ParameterDescriptorGroup

values

public List<GeneralParameterValue> values()

Returns the parameters values in this group. The amount of parameters depends on the value of "num_row" and "num_col" parameters. The parameter array will contains only matrix elements which have been requested at least once by one of parameter(...) methods. Never requested elements are left to their default value and omitted from the returned array.

Specified by:

values in interface ParameterValueGroup

Overrides:

values in class ParameterGroup

createValue

public ParameterValueGroup createValue()

Forwards the call to the matrix parameter descriptors specified at construction time.

Specified by:

createValue in interface GeneralParameterDescriptor

Specified by:

createValue in interface ParameterDescriptorGroup

getMatrix

public Matrix getMatrix()

Creates a matrix from this group of parameters.

Returns:

A matrix created from this group of parameters.

setMatrix

public void setMatrix(Matrix matrix)

Sets all parameter values to the element value in the specified matrix. After this method call, values() will returns only the elements different from the default value.

Parameters:

matrix - The matrix to copy in this group of parameters.

equals

public boolean equals(Object object)

Compares this object with the specified one for equality.

Overrides:

equals in class ParameterGroup

Parameters:

object - The object to compare to this.

Returns:

true if both objects are equal.

clone

public MatrixParameters clone()

Returns a clone of this parameter group.

Specified by:

clone in interface GeneralParameterValue

Specified by:

clone in interface ParameterValueGroup

Overrides:

clone in class ParameterGroup

Returns:

A copy of this group of parameter values.

write

protected void write(TableWriter table)
              throws IOException

Writes the content of this parameter to the specified table.

Overrides:

write in class AbstractParameter

Parameters:

table - The table where to format the parameter value.

Throws:

IOException - if an error occurs during output operation.