Application: gvSIG desktop » gvSIG projections

/* gvSIG. Desktop Geographic Information System.

 *

 * Copyright ? 2007-2012 gvSIG Association

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.proj;

import org.gvsig.proj.catalog.TransformationDefinition;

import org.gvsig.proj.catalog.exception.NoninvertibleTransformException;

import org.gvsig.tools.junit.AbstractLibraryAutoInitTestCase;

/**

 * {@link CoordinateTransformation} API acceptance tests.

 * 

 * @author gvSIG Team

 */

public abstract class CoordinateTransformationIT extends

    AbstractLibraryAutoInitTestCase {

    protected CoordinateReferenceSystem source;

    protected CoordinateReferenceSystem target;

    protected CoordinateTransformation transformation;

    protected CoordinateReferenceSystemManager manager;

    protected void doSetUp() throws Exception {

        manager = createProjectionManager();

        source = createSourceProjection();

        target = createTargetProjection();

        transformation = createTransformationFromDefinition();

    }

    /**

     * Creates a {@link CoordinateReferenceSystemManager} instance.

     * 

     * @return the {@link CoordinateReferenceSystemManager} instance

     */

    protected abstract CoordinateReferenceSystemManager createProjectionManager();

    /**

     * Returns the transformation definition to create the CoordinateTransformation

     * to test.

     * 

     * @return the authority name

     */

    protected abstract TransformationDefinition getTransformationDefinition();

    /**

     * Creates the transformation to be tested

     */

    public CoordinateTransformation createTransformationFromDefinition() throws Exception {

            TransformationDefinition definition = getTransformationDefinition();

        return manager.getCoordinateTransformation(definition);

    }

    protected abstract CoordinateReferenceSystem createSourceProjection()

        throws Exception;

    protected abstract CoordinateReferenceSystem createTargetProjection()

        throws Exception;

    /**

     * Test method for

     * {@link org.gvsig.proj.CoordinateTransformation#getSource()}.

     */

    public void testGetSourceProjection() {

        assertEquals(source, transformation.getSource());

    }

    /**

     * Test method for

     * {@link org.gvsig.proj.CoordinateTransformation#getTarget()}.

     */

    public void testGetTargetProjection() {

        assertEquals(target, transformation.getTarget());

    }

    /**

     * Test method for

     * {@link org.gvsig.proj.CoordinateTransformation#getInverse()}.

     * @throws NoninvertibleTransformException 

     */

    public void testGetReverse() throws NoninvertibleTransformException {

        CoordinateTransformation reverseTransformation =

            transformation.getInverse();

        assertEquals(target, reverseTransformation.getSource());

        assertEquals(source, reverseTransformation.getTarget());

    }

    /**

     * The input point to test the transformation

     * 

     * @return

     */

    public abstract double[] getInputPoint();

    /**

     * The output point to thest the transformation. This point

     * should be a known result of applying the transformation on

     * getInputPoint()

     * @return

     */

    public abstract double[] getResultPoint();

    /**

     * Gets the maximum numeric tolerance to accept the result of

     * the transformation as valid

     * 

     * @return

     */

    public abstract double getResultTolerance();

    /**

     * Test method for

     * {@link org.gvsig.proj.CoordinateTransformation#apply(double[])}.

     */

    public void testApplyTransformationInline() {

            double[] input = getInputPoint();

            transformation.apply(input);

            assertTrue(pointsEquals(getResultPoint(), input, getResultTolerance()));

    }

    public boolean pointsEquals(double[] point1, double[] point2, double tolerance) {

            for (int i=0; i<point1.length; i++) {

                    if (Math.abs(point1[i]-point2[i])>tolerance) {

                            return false;

                    }

            }

            return true;

    }

    /**

     * Test method for

     * {@link org.gvsig.proj.CoordinateTransformation#apply(double[])}.

     */

    public void testApplyTransformation() {

            double[] input = getInputPoint();

            double[] transformed = new double[input.length];

            transformation.apply(input, transformed);

            assertTrue(pointsEquals(getResultPoint(), transformed, getResultTolerance()));

    }

    /**

     * Test method for

     * {@link org.gvsig.proj.CoordinateTransformation#getInverse()}

     * and

     * {@link org.gvsig.proj.CoordinateTransformation#apply(double[])}.

     * @throws NoninvertibleTransformException 

     */

    public void testApplyInverseTransformation() throws NoninvertibleTransformException {

            double[] input = getInputPoint();

            double[] transformed = new double[input.length];

            transformation.apply(input, transformed);

            CoordinateTransformation reverseTransformation =

                transformation.getInverse();

            reverseTransformation.apply(transformed);

            assertTrue(pointsEquals(input, transformed, getResultTolerance()));

    }

}