Module org.opengis.geoapi.conformance

Package org.opengis.test.referencing

Class AffineTransformTest

Object

TestCase

TransformTestCase

AffineTransformTest

public class AffineTransformTest
extends TransformTestCase

Tests affine transforms from the org.opengis.referencing.operation package. Math transform instances are created using the factory given at construction time.

Usage example:

in order to specify their factories and run the tests in a JUnit framework, implementers can define a subclass in their own test suite as in the example below:

import org.opengis.test.referencing.AffineTransformTest;

public class MyTest extends AffineTransformTest {
    public MyTest() {
        super(new MyMathTransformFactory());
    }
}

Since:

3.1

See Also:

• ParameterizedTransformTest

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	isNonBidimensionalSpaceSupported	true if MathTransformFactory.createAffineTransform(Matrix) accepts matrixes of size different than 3×3.
protected boolean	isNonSquareMatrixSupported	true if MathTransformFactory.createAffineTransform(Matrix) accepts non-square matrixes.
protected Matrix	matrix	The matrix of the math transform being tested.
protected final MathTransformFactory	mtFactory	The factory for creating MathTransform objects, or null if none.

Fields inherited from class org.opengis.test.referencing.TransformTestCase

derivativeDeltas, isDerivativeSupported, isDoubleToDoubleSupported, isDoubleToFloatSupported, isFloatToDoubleSupported, isFloatToFloatSupported, isInverseTransformSupported, isOverlappingArraySupported, tolerance, toleranceModifier, transform

Fields inherited from class org.opengis.test.TestCase

configurationTip, units, validators

Constructor Summary

Constructors

Constructor	Description
AffineTransformTest(MathTransformFactory factory)	Creates a new test using the given factory.

Method Summary

Modifier and Type	Method	Description
Configuration	configuration()	Returns information about the configuration of the test which has been run.
void	testAxisSwapping2D()	Tests a transform swapping the axes in a two-dimensional space.
void	testDimensionReduction()	Tests a transform which reduce the number of dimensions from 4 to 2.
void	testGeneral()	Tests using a combination of scale, rotation and translation in a two-dimensional space.
void	testGenericScale2D()	Tests using a non-uniform scale factor of (3,4) in a two-dimensional space.
void	testIdentity1D()	Tests using an identity transform in an one-dimensional space.
void	testIdentity2D()	Tests using an identity transform in a two-dimensional space.
void	testIdentity3D()	Tests using an identity transform in a three-dimensional space.
void	testRotation2D()	Tests using an anticlockwise 30° rotation in a two-dimensional space.
void	testSouthOrientated2D()	Tests using a 180° rotation in a two-dimensional space.
void	testTranslatation2D()	Tests using a translation of (400000,-100000) metres in a two-dimensional space.
void	testUniformScale2D()	Tests using a uniform scale factor of 0.3048 in a two-dimensional space.

Methods inherited from class org.opengis.test.referencing.TransformTestCase

assertAllTestsEnabled, assertCoordinateEquals, assertCoordinateEquals, assertCoordinateEquals, assertCoordinateEquals, assertCoordinateEquals, assertCoordinateEquals, assertCoordinateEquals, assertCoordinateEquals, assertCoordinatesEqual, assertCoordinatesEqual, assertCoordinatesEqual, assertCoordinatesEqual, assertCoordinatesEqual, assertCoordinatesEqual, assertCoordinatesEqual, assertCoordinatesEqual, assertMatrixEquals, normalize, tolerance, verifyConsistency, verifyDerivative, verifyInDomain, verifyInverse, verifyInverse, verifyTransform

Methods inherited from class org.opengis.test.TestCase

getEnabledFlags

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

mtFactory

protected final MathTransformFactory mtFactory

The factory for creating MathTransform objects, or null if none.

matrix

protected Matrix matrix

The matrix of the math transform being tested. This field is set, together with the transform field, after the execution of every testFoo() method in this class.

If this field is non-null before a test is run, then those parameters will be used directly. This allow implementers to alter the parameters before to run the test one more time.

isNonSquareMatrixSupported

protected boolean isNonSquareMatrixSupported

true if MathTransformFactory.createAffineTransform(Matrix) accepts non-square matrixes. Transforms defined by non-square matrixes have a number of input dimensions different than the number of output dimensions.

isNonBidimensionalSpaceSupported

protected boolean isNonBidimensionalSpaceSupported

true if MathTransformFactory.createAffineTransform(Matrix) accepts matrixes of size different than 3×3. If false, then only matrixes of size 3×3 (i.e. affine transforms between two-dimensional spaces) will be tested.

Constructor Details

AffineTransformTest

public AffineTransformTest(MathTransformFactory factory)

Creates a new test using the given factory. If the given factory is null, then the tests will be skipped.

Parameters:

factory - factory for creating MathTransform instances.

Method Details

configuration

public Configuration configuration()

Returns information about the configuration of the test which has been run. This method returns a map containing:

• All the entries defined in the parent class.
• All the following values associated to the Configuration.Key of the same name:
  • isNonSquareMatrixSupported
  • isNonBidimensionalSpaceSupported
  • mtFactory

Overrides:

configuration in class TransformTestCase

Returns:

the configuration of the test being run, or an empty map if none. This method returns a modifiable map in order to allow subclasses to modify it.

testIdentity1D

@Test
public void testIdentity1D()
                    throws FactoryException,
TransformException

Tests using an identity transform in an one-dimensional space. This test is executed only if the isNonBidimensionalSpaceSupported flag is set to true.

Throws:

FactoryException - should never happen.

TransformException - should never happen.

testIdentity2D

@Test
public void testIdentity2D()
                    throws FactoryException,
TransformException

Tests using an identity transform in a two-dimensional space.

Throws:

FactoryException - should never happen.

TransformException - should never happen.

testIdentity3D

@Test
public void testIdentity3D()
                    throws FactoryException,
TransformException

Tests using an identity transform in a three-dimensional space. This test is executed only if the isNonBidimensionalSpaceSupported flag is set to true.

Throws:

FactoryException - should never happen.

TransformException - should never happen.

testAxisSwapping2D

@Test
public void testAxisSwapping2D()
                        throws FactoryException,
TransformException

Tests a transform swapping the axes in a two-dimensional space.

Throws:

FactoryException - should never happen.

TransformException - should never happen.

testSouthOrientated2D

@Test
public void testSouthOrientated2D()
                           throws FactoryException,
TransformException

Tests using a 180° rotation in a two-dimensional space.

Throws:

FactoryException - should never happen.

TransformException - should never happen.

testTranslatation2D

@Test
public void testTranslatation2D()
                         throws FactoryException,
TransformException

Tests using a translation of (400000,-100000) metres in a two-dimensional space. This translation is determined by the False easting and False northing parameter values of the OSGB 1936 / British National Grid projection.

Throws:

FactoryException - should never happen.

TransformException - should never happen.

testUniformScale2D

@Test
public void testUniformScale2D()
                        throws FactoryException,
TransformException

Tests using a uniform scale factor of 0.3048 in a two-dimensional space. This is the conversion factor from feet to metres.

Throws:

FactoryException - should never happen.

TransformException - should never happen.

testGenericScale2D

@Test
public void testGenericScale2D()
                        throws FactoryException,
TransformException

Tests using a non-uniform scale factor of (3,4) in a two-dimensional space.

Throws:

FactoryException - should never happen.

TransformException - should never happen.

testRotation2D

@Test
public void testRotation2D()
                    throws FactoryException,
TransformException

Tests using an anticlockwise 30° rotation in a two-dimensional space.

Throws:

FactoryException - should never happen.

TransformException - should never happen.

testGeneral

@Test
public void testGeneral()
                 throws FactoryException,
TransformException

Tests using a combination of scale, rotation and translation in a two-dimensional space.

Throws:

FactoryException - should never happen.

TransformException - should never happen.

testDimensionReduction

@Test
public void testDimensionReduction()
                            throws FactoryException,
TransformException

Tests a transform which reduce the number of dimensions from 4 to 2. This test is executed only if the isNonSquareMatrixSupported flag is set to true.

Throws:

FactoryException - should never happen.

TransformException - should never happen.