org.geotoolkit.parameter
Class MatrixParameterDescriptors

Object
  FormattableObject
      AbstractIdentifiedObject
          AbstractParameterDescriptor
              DefaultParameterDescriptorGroup
                  MatrixParameterDescriptors

All Implemented Interfaces:

Serializable, Formattable, LenientComparable, GeneralParameterDescriptor, ParameterDescriptorGroup, IdentifiedObject

@Immutable
public class MatrixParameterDescriptors
extends DefaultParameterDescriptorGroup

A parameter group for matrix elements. The amount of parameter values is extensible, i.e. it can grown or shrink according the value of "num_row" and "num_col" parameters. The parameters format may vary according the information provided to the constructor, but it is typically as below:

num_row
num_col
elt_0_0
elt_0_1
...
elt_0_<num_col-1>
elt_1_0
elt_1_1
...
elt_<num_row-1>_<num_col-1>

Since:

2.0

Version:

3.18

Author:

Martin Desruisseaux (IRD, Geomatys)

See Also:

MatrixParameters, Serialized Form

Module:

referencing/geotk-referencing (download)

View source code for this class

Field Summary

static int	DEFAULT_MATRIX_SIZE The default matrix size for the one-argument constructor.
protected ParameterDescriptor<Integer>	numCol The descriptor for the "num_col" parameter.
protected ParameterDescriptor<Integer>	numRow The descriptor for the "num_row" parameter.
protected String	prefix The prefix to insert in front of parameter name for each matrix elements.
protected char	separator The separator between the row and the column index in parameter names.

Fields inherited from class AbstractIdentifiedObject

EMPTY_ALIAS_ARRAY, EMPTY_IDENTIFIER_ARRAY, IDENTIFIER_COMPARATOR, NAME_COMPARATOR, REMARKS_COMPARATOR

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

MatrixParameterDescriptors(Map<String,?> properties)
Constructs a parameter group with default name format matching Well Known Text usages.

MatrixParameterDescriptors(Map<String,?> properties, ParameterDescriptor<?>[] parameters, String prefix, char separator)
Constructs a parameter group.

Method Summary

protected int	computeHashCode() Computes a hash value for this identified object.
ParameterValueGroup	createValue() Creates a new instance of parameter values with elements initialized to the 1 on the diagonal, and 0 everywere else.
ParameterDescriptor<Double>	descriptor(int row, int column) Returns the parameter in this group for a matrix element at the specified index. row and column indices are 0 based.
GeneralParameterDescriptor	descriptor(String name) Returns the parameter in this group for the specified name.
List<GeneralParameterDescriptor>	descriptors() Returns the parameters in this group.
boolean	equals(Object object, ComparisonMode mode) Compares the specified object with this parameter group for equality.
Matrix	getMatrix(ParameterValueGroup parameters) Constructs a matrix from a group of parameters.

Methods inherited from class DefaultParameterDescriptorGroup

getMaximumOccurs, toString

Methods inherited from class AbstractParameterDescriptor

formatWKT, getMinimumOccurs

Methods inherited from class AbstractIdentifiedObject

equals, equals, equals, equals, getAlias, getIdentifier, getIdentifier, getIdentifiers, getName, getName, getName, getProperties, getProperties, getRemarks, hashCode, nameMatches, nameMatches, nameMatches

Methods inherited from class FormattableObject

getDefaultIndentation, print, setDefaultIndentation, toWKT, toWKT, toWKT

Methods inherited from class Object

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

Methods inherited from interface GeneralParameterDescriptor

getMinimumOccurs

Methods inherited from interface IdentifiedObject

getAlias, getIdentifiers, getName, getRemarks, toWKT

Field Detail

DEFAULT_MATRIX_SIZE

public static final int DEFAULT_MATRIX_SIZE

The default matrix size for the one-argument constructor.

See Also:

Constant Field Values

numRow

protected final ParameterDescriptor<Integer> numRow

The descriptor for the "num_row" parameter.

numCol

protected final ParameterDescriptor<Integer> numCol

The descriptor for the "num_col" parameter.

prefix

protected final String prefix

The prefix to insert in front of parameter name for each matrix elements.

separator

protected final char separator

The separator between the row and the column index in parameter names.

Constructor Detail

MatrixParameterDescriptors

public MatrixParameterDescriptors(Map<String,?> properties)

Constructs a parameter group with default name format matching Well Known Text usages.

Parameters:

properties - Set of properties. Should contains at least "name".

MatrixParameterDescriptors

public MatrixParameterDescriptors(Map<String,?> properties,
                                  ParameterDescriptor<?>[] parameters,
                                  String prefix,
                                  char separator)

Constructs a parameter group. The properties map is given unchanged to the super-class constructor. The parameters array should contains parameters other than matrix elements. The first parameter is assumed to be the number of rows, and the second parameter the number of columns. All extra parameters are ignored.

Parameters:

properties - Set of properties. Should contains at least "name".

parameters - The "num_row" and "num_col" parameters.

prefix - The prefix to insert in front of parameter name for each matrix elements.

separator - The separator between the row and the column index in parameter names.

Method Detail

descriptor

public final 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

Overrides:

descriptor in class DefaultParameterDescriptorGroup

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.

descriptor

public final ParameterDescriptor<Double> descriptor(int row,
                                                    int column)
                                             throws IndexOutOfBoundsException

Returns the parameter in this group for a matrix element at the specified index. row and column indices are 0 based. Indices must be lower that the maximum values given to the numRow and numCol parameters.

Parameters:

row - The row indice.

column - The column indice

Returns:

The parameter descriptor for the specified matrix element.

Throws:

IndexOutOfBoundsException - if row or column is out of bounds.

descriptors

public final List<GeneralParameterDescriptor> descriptors()

Returns the parameters in this group. The number or elements is inferred from the default values given to the numRow and numCol parameters.

Specified by:

descriptors in interface ParameterDescriptorGroup

Overrides:

descriptors in class DefaultParameterDescriptorGroup

Returns:

The matrix parameters, including all elements.

createValue

public ParameterValueGroup createValue()

Creates a new instance of parameter values with elements initialized to the 1 on the diagonal, and 0 everywere else. The returned parameter group is extensible, i.e. the number of elements will depends upon the value associated to the numRow and numCol parameters.

Specified by:

createValue in interface GeneralParameterDescriptor

Specified by:

createValue in interface ParameterDescriptorGroup

Overrides:

createValue in class DefaultParameterDescriptorGroup

Returns:

A new parameter initialized to the default value.

getMatrix

public Matrix getMatrix(ParameterValueGroup parameters)
                 throws InvalidParameterNameException

Constructs a matrix from a group of parameters.

Parameters:

parameters - The group of parameters.

Returns:

A matrix constructed from the specified group of parameters.

Throws:

InvalidParameterNameException - if a parameter name was not recognized.

equals

public boolean equals(Object object,
                      ComparisonMode mode)

Compares the specified object with this parameter group for equality.

Specified by:

equals in interface LenientComparable

Overrides:

equals in class DefaultParameterDescriptorGroup

Parameters:

object - The object to compare to this.

mode - STRICT for performing a strict comparison, or IGNORE_METADATA for comparing only properties relevant to transformations.

Returns:

true if both objects are equal.

computeHashCode

protected int computeHashCode()

Computes a hash value for this identified object. This method is invoked by AbstractIdentifiedObject.hashCode() when first needed.

Implementation specific feature
In the Geotk implementation, the name, identifiers and remarks are not used for hash code computation. Consequently two identified objects will return the same hash value if they are equal in the sense of equals(…, ComparisonMode.IGNORE_METADATA). This feature allows users to implement metadata-insensitive HashMap.

Overrides:

computeHashCode in class DefaultParameterDescriptorGroup

Returns:

The hash code value. This value may change between different execution of the Geotk library.