org.geotools.pt
Class Matrix

java.lang.Object
  javax.vecmath.GMatrix
      org.geotools.referencing.operation.matrix.GeneralMatrix
          org.geotools.referencing.operation.GeneralMatrix
              org.geotools.pt.Matrix

All Implemented Interfaces:

java.lang.Cloneable, org.opengis.util.Cloneable, org.opengis.referencing.operation.Matrix, java.io.Serializable, XMatrix

Deprecated. Replaced by GeneralMatrix in the org.geotools.referencing.operation package.

public class Matrix

extends GeneralMatrix

A two dimensional array of numbers. Row and column numbering begins with zero.

Version:

$Id: Matrix.java 17672 2006-01-19 00:25:55Z desruisseaux $

Author:

Martin Desruisseaux

See Also:

Serialized Form

Constructor Summary

Matrix(java.awt.geom.AffineTransform transform)
Deprecated. Construct a 3×3 matrix from the specified affine transform.

Matrix(double[][] matrix)
Deprecated. Constructs a new matrix from a two-dimensional array of doubles.

Matrix(javax.vecmath.GMatrix matrix)
Deprecated. Constructs a new matrix and copies the initial values from the parameter matrix.

Matrix(int size)
Deprecated. Construct a square identity matrix of size size × size.

Matrix(int numRow, int numCol)
Deprecated. Construct a matrix of size numRow × numCol.

Matrix(int numRow, int numCol, double[] matrix)
Deprecated. Constructs a numRow × numCol matrix initialized to the values in the matrix array.

Method Summary

static Matrix	createAffineTransform(AxisOrientation[] srcAxis, AxisOrientation[] dstAxis) Deprecated. Construct an affine transform changing axis order and/or orientation.
static Matrix	createAffineTransform(Envelope srcRegion, AxisOrientation[] srcAxis, Envelope dstRegion, AxisOrientation[] dstAxis) Deprecated. Construct an affine transform mapping a source region to a destination region.
static Matrix	createAffineTransform(Envelope srcRegion, Envelope dstRegion) Deprecated. Construct an affine transform that maps a source region to a destination region.

Methods inherited from class org.geotools.referencing.operation.matrix.GeneralMatrix

getElements, getElements, isAffine, isIdentity, load, load, multiply, toAffineTransform2D, toString

Methods inherited from class javax.vecmath.GMatrix

add, add, clone, copySubMatrix, epsilonEquals, epsilonEquals, equals, equals, get, get, get, get, get, getColumn, getColumn, getElement, getNumCol, getNumRow, getRow, getRow, hashCode, identityMinus, invert, invert, LUD, mul, mul, mul, mulTransposeBoth, mulTransposeLeft, mulTransposeRight, negate, negate, set, set, set, set, set, set, setColumn, setColumn, setElement, setIdentity, setRow, setRow, setScale, setSize, setZero, sub, sub, SVD, trace, transpose, transpose

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.geotools.referencing.operation.matrix.XMatrix

invert, negate, setIdentity, setZero, transpose

Methods inherited from interface org.opengis.referencing.operation.Matrix

clone, getElement, getNumCol, getNumRow, setElement

Constructor Detail

Matrix

public Matrix(int size)

Deprecated.

Construct a square identity matrix of size size × size.

Matrix

public Matrix(int numRow,
              int numCol)

Deprecated.

Construct a matrix of size numRow × numCol. Elements on the diagonal j==i are set to 1.

Matrix

public Matrix(int numRow,
              int numCol,
              double[] matrix)

Deprecated.

Constructs a numRow × numCol matrix initialized to the values in the matrix array. The array values are copied in one row at a time in row major fashion. The array should be exactly numRow*numCol in length. Note that because row and column numbering begins with zero, row and numCol will be one larger than the maximum possible matrix index values.

Matrix

public Matrix(double[][] matrix)
       throws java.lang.IllegalArgumentException

Deprecated.

Constructs a new matrix from a two-dimensional array of doubles.

Parameters:

matrix - Array of rows. Each row must have the same length.

Throws:

java.lang.IllegalArgumentException - if the specified matrix is not regular (i.e. if all rows doesn't have the same length).

Matrix

public Matrix(javax.vecmath.GMatrix matrix)

Deprecated.

Constructs a new matrix and copies the initial values from the parameter matrix.

Matrix

public Matrix(java.awt.geom.AffineTransform transform)

Deprecated.

Construct a 3×3 matrix from the specified affine transform.

Method Detail

createAffineTransform

public static Matrix createAffineTransform(AxisOrientation[] srcAxis,
                                           AxisOrientation[] dstAxis)

Deprecated.

Construct an affine transform changing axis order and/or orientation. For example, the affine transform may convert (NORTH,WEST) coordinates into (EAST,NORTH). Axis orientation can be inversed only. For example, it is illegal to transform (NORTH,WEST) coordinates into (NORTH,DOWN).

Parameters:

srcAxis - The set of axis orientation for source coordinate system.

dstAxis - The set of axis orientation for destination coordinate system.

Throws:

org.opengis.spatialschema.geometry.MismatchedDimensionException - if srcAxis and dstAxis don't have the same length.

java.lang.IllegalArgumentException - if the affine transform can't be created for some other raison.

createAffineTransform

public static Matrix createAffineTransform(Envelope srcRegion,
                                           Envelope dstRegion)

Deprecated.

Construct an affine transform that maps a source region to a destination region. Axis order and orientation are left unchanged.

Parameters:

srcRegion - The source region.

dstRegion - The destination region.

Throws:

org.opengis.spatialschema.geometry.MismatchedDimensionException - if regions don't have the same dimension.

createAffineTransform

public static Matrix createAffineTransform(Envelope srcRegion,
                                           AxisOrientation[] srcAxis,
                                           Envelope dstRegion,
                                           AxisOrientation[] dstAxis)

Deprecated.

Construct an affine transform mapping a source region to a destination region. Axis order and/or orientation can be changed during the process. For example, the affine transform may convert (NORTH,WEST) coordinates into (EAST,NORTH). Axis orientation can be inversed only. For example, it is illegal to transform (NORTH,WEST) coordinates into (NORTH,DOWN).

Parameters:

srcRegion - The source region.

srcAxis - Axis orientation for each dimension of the source region.

dstRegion - The destination region.

dstAxis - Axis orientation for each dimension of the destination region.

Throws:

org.opengis.spatialschema.geometry.MismatchedDimensionException - if all arguments don't have the same dimension.

java.lang.IllegalArgumentException - if the affine transform can't be created for some other raison.