Package org.apache.sis.referencing.operation.matrix
- The class specializations for such small matrices.
- Methods specific to coordinate systems support like
Matrices.createTransform(…)
. - Matrix inversions tolerant to
NaN
values and non-square matrix in some situations. - Capability to store
Number
instances for greater precision (depending on the number subtype).
This package provides public implementations of small square matrices, with size ranging from 1×1 to 4×4. Those implementations are convenient for working with Coordinate Reference Systems (CRS) of fixed dimensions. If the number of CRS dimensions is fixed to 3, then affine transforms between those CRS can be represented by 4×4 matrices, and the derivatives of those transforms can be represented by 3×3 matrices. When the number of dimensions is fixed at compile-time, matrix elements can be accessed directly with the mrow column fields.
Example: in the two dimensional case, an affine transform from a map projection (units in metres) to the screen (units in pixels) can be performed by the following matrix multiplication:
Extended floating point precision
This package uses extended floating point precision for most arithmetic operations like matrix multiplications and inversions. SIS needs extended precision because affine transforms concatenations like conversion from degrees to radians, followed by some operations, followed by conversion back from radians to degrees, are very frequent. Without extended precision, we often obtain values like 0.99999… where we would expect an identity transform. The usual workaround - namely comparing the floating point values with a small epsilon tolerance value - is dangerous in this particular case because datum shifts, when expressed as a matrix from their Bursa-Wolf parameters, are very close to the identity transform.The current implementation uses double-double arithmetic. However, this may change in any future SIS version.
Related projects
This package is not designed for large matrices, and is rooted inorg.apache.sis.referencing
for making clearer that this is not a general-purpose library.
For computational intensive calculations, better guarantees on numerical stability, sparse matrices support
and more, consider using an dedicated library like jblas instead.
The Vecmath
library shares similar goals than MatrixSIS
.
Like SIS, Vecmath is optimized for small matrices of interest for 2D and 3D graphics.
- Since:
- 0.4
-
ClassDescriptionBridge between
Matrix
and Java2DAffineTransform
instances.Matrix
factory methods and utilities.AMatrix
able to perform some operations of interest to Spatial Information Systems (SIS).Thrown when two matrices cannot be added or multiplied because the sizes do not match.Thrown when a matrix cannot be inverted.