MSP CCS Spreadsheet Tester

Man Page

1. Name

2. Synopsis

3. Description

4. Operands

5. Input File

6. Output File

7. Results

8. Example

NAME

MSP CCS Spreadsheet Tester executes a collection of coordinate conversion/datum transformation test cases using the MSP CCS service and compares the actual results with the specified expected results.

SYNOPSIS

MSPCCS_SpreadsheetTester <input file> <output file> <show warnings: 0 or 1>

DESCRIPTION

The MSP CCS Spreadsheet Tester tests the coordinate conversion accuracy of the MSP CCS coordinate conversion and datum transformation library.It inputs a text file containing a collection of test cases, uses the MSP CCS library to perform the specified coordinate conversion and/or datum transformation for each case, and outputs the results to another text file.It also displays a summary that identifies any errors, warnings, or differences from the expected results.

The input file contains tab-separated text organized in the following sequence of columns:

1. test case id,

2. input datum code,

3. input coordinate system/projection,

4. output datum code,

5. output coordinate system/projection,

6. input zone or hemisphere,

7. expected output zone or hemisphere,

8. input latitude (or easting, string, X),

9. input longitude (or northing, Y),

10. input height or Z,

11. expected output latitude (or easting, string, X),

12. expected output longitude (or northing, Y),

13. expected output height or Z,

14. actual output latitude (or easting, string, X),

15. actual output longitude (or northing, Y),

16. actual output height or Z,

17. actual output zone or hemisphere,

18. input 1st std. parallel or scale factor,

19. input 2nd std. parallel,

20. input central meridian,

21. input origin latitude,

22. input false easting or origin height,

23. input false northing or orientation,

24. input longitude 1,

25. input latitude 1,

26. input longitude 2,

27. input latitude 2,

28. output 1st std.parallel or scale factor,

29. output 2nd std. parallel,

30. output central meridian,

31. output origin latitude,

1. output false easting or origin height,

2. output false northing or orientation,

3. output longitude 1,

4. output latitude 1,

5. output longitude 2,

6. output latitude 2,

7. results.

OPERANDS

The following operands are supported:

< input file>

The input text file containing the test cases. The format of this file is described below.

<output file>

The path and name of the output text file containing the actual output coordinates and status.

<show warnings>

The display of coordinate conversion warnings can be tuned on or off. A value of 1 turns the display of warnings on, 0 turns the warnings off.

Input File

The input text file contains tab-separated text.It is normally produced by exporting the text from an Excel spreadsheet that contains a collection of test cases.The columns in the first row of the input file contain the following header information:

ColumnHeader Line

ATEST CASE ID

BINPUT DATUM (Code)

CINPUT PROJECTION

DOUTPUT DATUM (Code)

EOUTPUT PROJECTION

FINPUT ZONE

GOUTPUT ZONE

HINPUT_COORDS

KOUTPUT_COORDS

NCALCULATED_OUTPUT_COORDS

RINPUT_SYSTEM_PARAMETERS

ABOUTPUT_SYSTEM_PARAMETERS

AL RESULTS

The columns in the second row of the input file contain the following supplemental header information:

ColumnHeader Line

FOR HEMISPHERE

G:Same as F

HLat, Easting, String or X

ILon, Northing or Y

JHeight or Z

K, L, M:Same as H, I, J

N, O, PSame as H, I, J

QCalculated Zone or Hemisphere

R1st Standard Parallel or Scale Factor

S2nd Standard Parallel

TCentral Meridian

UOrigin Latitude

VFalse Easting or Origin Height

WFalse Northing or Orientation

XLongitude 1

YLatitude 1

ZLongitude 2

AALatitude 2

AB AKSame as R AA

The first step in creating an input file is to create a Microsoft Excel spreadsheet containing the column header information as listed above.

The test case id column should contain a unique identifier for each test case.

The datum columns may contain any of the standard datum codes supported by MSP CCS.

The coordinate system/projection columns may contain any of the following text strings:

Albers Equal Area Conic,

Azimuthal Equidistant (S),

British National Grid (BNG),

Bonne,

Cassini,

Cylindrical Equal Area,

Eckert IV (S),

Eckert VI (S),

Equidistant Cylindrical (S),

Geocentric,

Geodetic,

Georef,

Gnomonic (S),

Lambert Conformal Conic,

Lambert Conformal Conic (1 Parallel),

Lambert Conformal Conic (2 Parallel),

Local Cartesian,

Mercator,

Mercator (Scale Factor),

Mercator (Standard Parallel),

Miller Cylindrical (S),

Military Grid Reference System (MGRS),

Mollweide (S),

Neys (Modified Lambert Conformal Conic),

Neys (Modified Lambert Conformal Conic),

New Zealand Map Grid (NZMG),

Oblique Mercator,

Orthographic (S),

Polar Stereographic,

Polar Stereographic (Scale Factor),

Polar Stereographic (Standard Parallel),

Polyconic,

Sinusoidal,

Stereographic (S),

Transverse Cylindrical Equal Area,

Transverse Mercator,

United States National Grid (USNG),

Universal Polar Stereographic (UPS),

Universal Transverse Mercator (UTM),

Van der Grinten.

The abbreviations BNG, MGRS, NZMG, UPS and UTM may be used in place of the full names listed above. The spelling of all other projection names in the spreadsheet must exactly match those given above, or the test case will not be correctly executed. The projection names are not case sensitive. Any unique part of a projection name text string will allow the test case to be executed. For example, "Mercator (Scale" can be used for "Mercator (Scale Factor)".

The zone columns are used for UTM zone and hemisphere information. The UTM hemisphere is denoted by a positive (North) or negative (South) sign on the zone number. This column is also used to denote the hemisphere for UPS.

The input coordinate columns contain the input coordinates for the given test case.

The expected output coordinate columns contain the expected output coordinates.

The actual output coordinates columns contain the converted output coordinates.

If the actual output latitude and longitude or easting and northing values are not available, columns N and O must contain n/a. If an actual output coordinate string (GEOREF or MGRS) is not available, column N must contain n/a. Also, if an actual output zone or hemisphere is not available for a UTM or UPS conversion, column Q must contain n/a. If a calculated height is not available, column P may be left blank.

The parameter columns must be filled in with the values of the parameters required by the specified coordinate system or projection. Parameters not applicable to the given projection may be left blank.

The false easting column may be used to denote the origin height for Local Cartesian.Similarly, the false northing column may be used to denote the Local Cartesian orientation.

The results column does not need any information. It will be filled in when the output file is created.

After the Microsoft Excel spreadsheet is complete, it must be exported as a .txt file. This can be done by going to the File menu and selecting the Save As command. From the Save As type drop down list, select the Text (Tab delimited) (*.txt) option, and type a name in the file name field. Click the Save button. A dialog box will come up asking if you want to keep the workbook in a text delimited format, click the Yes button. The file is now ready to be used by the MSP CCS Spreadsheet Tester application.

Output File

The output text file has the same format as the input file except the actual output coordinates columns contains the results produced by the MSP CCS Spreadsheet Tester application.

The output text file can be imported into Microsoft Excel. To do this, start Microsoft Excel and select the Open command from the File menu. Select the output text file and click the Open button. A Text Import Wizard dialog box will come up. Make sure the Delimited radio button is selected, the start import row is 1 and the file origin is Windows (ANSI), then click the Next button. Check that the tab delimiter check box is selected and click the Next button. Verify that the column data format is General and click the Finish button. Next, click the top left header corner of the spreadsheet to select the entire spreadsheet. From the Format menu, select the Column, AutoFit Selection menu item to resize the columns.

Results

During execution, information may be displayed for a given test case if the actual output is different from the expected output, or if either a warning or error status was returned.The information displayed will include the test case id, the expected output coordinates, the actual output coordinates, and the returned status (success, warning, or error).

When execution of the test cases is complete, a summary of the results is displayed as follows:

Successful

Equivalent Results###

Different Results###

Warnings

Equivalent Results###

Different Results###

Errors (No Results)###

Total Test Cases###

These values should be interpreted as follows:

Successful those test cases for which a successful status was returned

Equivalent Results those test cases for which the actual output matched the expected output

Different Results those test cases for which the actual output did not match the expected output

Warnings those test cases for which a warning status was returned

Equivalent Results those test cases for which the actual output matched the expected output

Different Results those test cases for which the actual output did not match the expected output

Errors those test cases for which an error status was returned, and which therefore did not produce output

Total Test Cases the total number of test cases executed.

EXAMPLE

See the example input file.

Last change: 8 July 2010

If you encounter any problems using the MSP CCS Spreadsheet Tester software, please report them to:

MSP Help Desk Support

Unclassified Email: msphelp@baesystems.com

Unclassified Phone: (858) 592-5677

Contact the MSP Unclassified Help Desk to arrange for a classified discussion on a secure Red phone.