org.opengis.test.referencing.gigs
Class Series2000Test

Show UML class diagram

Object
  TestCase
      Series2000Test

public class Series2000Test
extends TestCase

Pre-defined geodetic parameter library test. The tests for this series are designed to verify the correctness of geodetic parameters that are delivered with the software. The comparison to be taken as truth is the EPSG Dataset.

Since:

3.1

See Also:

AuthorityFactoryTest, TestSuite

Field Summary

protected CoordinateOperationAuthorityFactory	copAuthorityFactory Factory to use for building CoordinateOperation instances, or null if none.
protected CRSAuthorityFactory	crsAuthorityFactory Factory to use for building CoordinateReferenceSystem instances, or null if none.
protected CSAuthorityFactory	csAuthorityFactory Factory to use for building CoordinateSystem instances, or null if none.
protected DatumAuthorityFactory	datumAuthorityFactory Factory to use for building Datum instances, or null if none.
protected boolean	isDependencyIdentificationSupported true if the IdentifiedObject instances created indirectly by the factories are expected to have correct identification information.
protected boolean	isStandardAliasSupported true if the factories support aliases.
protected boolean	isStandardNameSupported true if the factories support name.

Fields inherited from class TestCase

configurationTip, listener, NO_FACTORY, validators

Constructor Summary

Series2000Test(CRSAuthorityFactory crsFactory, CSAuthorityFactory csFactory, DatumAuthorityFactory datumFactory, CoordinateOperationAuthorityFactory copFactory)
Creates a new test using the given factories.

Method Summary

Configuration	configuration() Returns information about the configuration of the test which has been run.
static List<Factory[]>	factories() Returns a default set of factories to use for running the tests.
void	test2001() Verifies reference units of measure bundled with the geoscience software.
void	test2002() Verifies reference ellipsoid parameters bundled with the geoscience software.
void	test2003() Verifies reference prime meridians bundled with the geoscience software.
void	test2004() Verifies reference geodetic datums and CRSs bundled with the geoscience software.
void	test2005() Verifies reference map projections bundled with the geoscience software.
void	test2006() Verifies reference projected CRSs bundled with the geoscience software.
void	test2007() Verifies reference coordinate transformations bundled with the geoscience software.
void	test2008() Verifies reference vertical datums and CRSs bundled with the geoscience software.
void	test2009() Verifies reference vertical transformations bundled with the geoscience software.

Methods inherited from class TestCase

addTestListener, factories, factories, getEnabledFlags, removeTestListener

Methods inherited from class Object

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

Field Detail

crsAuthorityFactory

protected final CRSAuthorityFactory crsAuthorityFactory

Factory to use for building CoordinateReferenceSystem instances, or null if none.

csAuthorityFactory

protected final CSAuthorityFactory csAuthorityFactory

Factory to use for building CoordinateSystem instances, or null if none.

datumAuthorityFactory

protected final DatumAuthorityFactory datumAuthorityFactory

Factory to use for building Datum instances, or null if none.

copAuthorityFactory

protected final CoordinateOperationAuthorityFactory copAuthorityFactory

Factory to use for building CoordinateOperation instances, or null if none.

isStandardNameSupported

protected boolean isStandardNameSupported

true if the factories support name. If true (the default), then the test methods will ensure that the identified objects created by the factories declare the same name than the GIGS tests. If false, then the names are ignored.

isStandardAliasSupported

protected boolean isStandardAliasSupported

true if the factories support aliases. If true (the default), then the test methods will ensure that the identified objects created by the factories declare at least all the aliases enumerated in the GIGS tests - additional aliases, if any, are ignored. If false, then the aliases are ignored.

isDependencyIdentificationSupported

protected boolean isDependencyIdentificationSupported

true if the IdentifiedObject instances created indirectly by the factories are expected to have correct identification information. For example when testing a Coordinate Reference System (CRS) object, the CRS authority code will be verified unconditionally but the authority codes of associated objects (Geodetic Datum or Coordinate System) will be verified only if this flag is true.

Constructor Detail

Series2000Test

public Series2000Test(CRSAuthorityFactory crsFactory,
                      CSAuthorityFactory csFactory,
                      DatumAuthorityFactory datumFactory,
                      CoordinateOperationAuthorityFactory copFactory)

Creates a new test using the given factories. If a given factory is null, then the tests which depend on it will be skipped.

Parameters:

crsFactory - Factory for creating CoordinateReferenceSystem instances.

csFactory - Factory for creating CoordinateSystem instances.

datumFactory - Factory for creating Datum instances.

copFactory - Factory for creating CoordinateOperation instances.

Method Detail

factories

public static List<Factory[]> factories()

Returns a default set of factories to use for running the tests. Those factories are given in arguments to the constructor when this test class is instantiated directly by JUnit (for example as a suite element), instead than subclassed by the implementor. The factories are fetched as documented in the TestCase.factories(Class[]) javadoc.

Returns:

The default set of arguments to be given to the Series2000Test constructor.

configuration

public Configuration configuration()

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

• All the following values associated to the Configuration.Key of the same name:
  • isStandardNameSupported
  • isStandardAliasSupported
  • isDependencyIdentificationSupported
  • crsAuthorityFactory
  • csAuthorityFactory
  • datumAuthorityFactory
  • copAuthorityFactory

Overrides:

configuration in class TestCase

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.

See Also:

ImplementationDetails.configuration(Factory[])

test2001

public void test2001()
              throws FactoryException,
                     ConversionException

Verifies reference units of measure bundled with the geoscience software.

Test method:	Compare unit definitions included in the software against the EPSG Dataset.
Test data:	EPSG Dataset and file GIGS_2001_libUnit.csv. This file contains three separate blocks of data for linear units, angular units and scaling units. It gives the EPSG code and name for the unit of measure, together with the ratio of the unit to the ISO base unit for that unit type.
Tested API:	CSAuthorityFactory.createUnit(String).
Expected result:	Unit of measure definitions bundled with software should have the ratio to the appropriate base unit as in the EPSG Dataset. The values of the base unit per unit should be correct to at least 10 significant figures. Units missing from the software or included in the software additional to those in the EPSG Dataset or at variance with those in the EPSG Dataset should be reported.

Throws:

FactoryException - If an error (other than unsupported code) occurred while creating a unit from an EPSG code.

ConversionException - If an error occurred while converting a sample value from the tested unit to the base unit.

test2002

public void test2002()
              throws FactoryException

Verifies reference ellipsoid parameters bundled with the geoscience software.

Test method:	Compare ellipsoid definitions included in the software against the EPSG Dataset.
Test data:	EPSG Dataset and file GIGS_2002_libEllipsoid.csv. This file gives the EPSG code and name for the ellipsoid, commonly encountered alternative name(s) for the same object, the value and units for the semi-major axis, the conversion ratio to metres for these units, and then a second parameter which will be either the value of the inverse flattening (unitless) or the value of the semi-minor axis (in the same units as the semi-major axis). It additionally contain a flag to indicate that the figure is a sphere: if false the figure is an oblate ellipsoid.
Tested API:	DatumAuthorityFactory.createEllipsoid(String).
Expected result:	Ellipsoid definitions bundled with software, if any, should have same name and defining parameters as in the EPSG Dataset. Equivalent alternative parameters are acceptable but should be reported. The values of the parameters should be correct to at least 10 significant figures. For ellipsoids defined by Clarke and Everest, as well as those adopted by IUGG as International, several variants exist. These must be clearly distinguished. Ellipsoids missing from the software or included in the software additional to those in the EPSG Dataset or at variance with those in the EPSG Dataset should be reported.

Throws:

FactoryException - If an error (other than unsupported code) occurred while creating an ellipsoid from an EPSG code.

test2003

public void test2003()
              throws FactoryException

Verifies reference prime meridians bundled with the geoscience software.

Test method:	Compare prime meridian definitions included in the software against the EPSG Dataset.
Test data:	EPSG Dataset and file GIGS_2003_libPrimeMeridian.csv.
Tested API:	DatumAuthorityFactory.createPrimeMeridian(String).
Expected result:	Prime meridian definitions bundled with the software should have the same name and Greenwich Longitude as in the EPSG Dataset. Equivalent alternative units are acceptable but should be reported. The values of the Greenwich Longitude should be correct to at least 7 decimal places (of degrees or grads). Meridians missing from the software or included in the software additional to those in the EPSG Dataset or at variance with those in the EPSG Dataset should be reported.

Throws:

FactoryException - If an error (other than unsupported code) occurred while creating a prime meridian from an EPSG code.

test2004

public void test2004()
              throws FactoryException

Verifies reference geodetic datums and CRSs bundled with the geoscience software.

Test method:	Compare geodetic datum and geocentric, geographic 3D and geographic 2D CRS definitions included in the geoscience software against the EPSG Dataset.
Test data:	EPSG Dataset and file GIGS_2004_libGeodeticDatumCRS.csv. Tests for component logical consistency is included: for example, if a higher-level library-defined component such as ED50 datum is selected it should then not be possible to change any of its lower-level components such as the ellipsoid from the pre-defined value (in this example International 1924).
Tested API:	DatumAuthorityFactory.createGeodeticDatum(String), CRSAuthorityFactory.createGeographicCRS(String) and CRSAuthorityFactory.createGeocentricCRS(String).
Expected result:	Definitions bundled with the software should have the same name and associated ellipsoid and prime meridian as in the EPSG Dataset. CRSs missing from the software or included in the geoscience software additional to those in the EPSG Dataset or at variance with those in the EPSG Dataset should be reported.

Throws:

FactoryException - If an error (other than unsupported code) occurred while creating a geodetic CRS from an EPSG code.

test2005

public void test2005()
              throws FactoryException

Verifies reference map projections bundled with the geoscience software.

Test method:	Compare map projection definitions included in the software against the EPSG Dataset.
Test data:	EPSG Dataset and file GIGS_2005_libProjection.csv.
Tested API:	CoordinateOperationAuthorityFactory.createCoordinateOperation(String).
Expected result:	Map projection definitions bundled with the software should have the same name, method name, defining parameters and parameter values as in the EPSG Dataset. The values of the parameters should be correct to at least 10 significant figures. Map projections missing from the software or included in the software additional to those in the EPSG Dataset or at variance with those in the EPSG Dataset should be reported.

Throws:

FactoryException - If an error (other than unsupported identifier) occurred while creating an operation from an EPSG code.

test2006

public void test2006()
              throws FactoryException

Verifies reference projected CRSs bundled with the geoscience software.

Test method:	Compare projected CRS definitions included in the software against the EPSG Dataset.
Test data:	EPSG Dataset and file GIGS_2006_libProjectedCRS.csv.
Tested API:	CRSAuthorityFactory.createProjectedCRS(String).
Expected result:	Projected CRS definitions bundled with the software should have the same name, coordinate system (including units and axes abbreviations and axes order) and map projection as in the EPSG Dataset. CRSs missing from the software or included in the software additional to those in the EPSG Dataset or at variance with those in the EPSG Dataset should be reported.

Throws:

FactoryException - If an error (other than unsupported identifier) occurred while creating a projected CRS from an EPSG code.

test2007

public void test2007()
              throws FactoryException

Verifies reference coordinate transformations bundled with the geoscience software.

Test method:	Compare transformation definitions included in the software against the EPSG Dataset.
Test data:	EPSG Dataset and file GIGS_2007_libGeodTfm.csv.
Tested API:	CoordinateOperationAuthorityFactory.createCoordinateOperation(String).
Expected result:	Transformation definitions bundled with the software should have the same name, method name, defining parameters and parameter values as in EPSG Dataset. The values of the parameters should be correct to at least 10 significant figures. Transformations missing from the software or included in the software additional to those in the EPSG Dataset or at variance with those in the EPSG Dataset should be reported.

Throws:

FactoryException - If an error (other than unsupported identifier) occurred while creating an operation from an EPSG code.

test2008

public void test2008()
              throws FactoryException

Verifies reference vertical datums and CRSs bundled with the geoscience software.

Test method:	Compare vertical datum and CRS definitions included in the software against the EPSG Dataset.
Test data:	EPSG Dataset and file GIGS_2008_libVerticalDatumCRS.csv. Compare vertical datums definition included in the software against the EPSG Dataset.
Tested API:	DatumAuthorityFactory.createVerticalDatum(String) and CRSAuthorityFactory.createVerticalCRS(String).
Expected result:	Definitions bundled with the software should have the same name and coordinate system (including axes direction and units) as in EPSG Dataset. CRSs missing from the software or included in the software additional to those in the EPSG Dataset or at variance with those in the EPSG Dataset should be reported.

Throws:

FactoryException - If an error (other than unsupported identifier) occurred while creating a vertical datum from an EPSG code.

test2009

public void test2009()
              throws FactoryException

Verifies reference vertical transformations bundled with the geoscience software.

Test method:	Compare transformation definitions included in the software against the EPSG Dataset.
Test data:	EPSG Dataset and file GIGS_2009_libVertTfm.csv. Compare vertical transformation definitions included in the software against the EPSG Dataset.
Tested API:	CoordinateOperationAuthorityFactory.createCoordinateOperation(String).
Expected result:	Transformation definitions bundled with the software should have same name, method name, defining parameters and parameter values as in EPSG Dataset. See current version of the EPSG Dataset. The values of the parameters should be correct to at least 10 significant figures. Transformations missing from the software or included in the software additional to those in the EPSG Dataset or at variance with those in the EPSG Dataset should be reported.

Throws:

FactoryException - If an error (other than unsupported identifier) occurred while creating a vertical transformation from an EPSG code.