MSP CCS Spreadsheet
Tester
Man Page
1.
Name
2.
Synopsis
3.
Description
4.
Operands
5.
Input
File
6.
Output
File
7.
Results
8.
Example
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.
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.
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.
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
RINPUT_SYSTEM_PARAMETERS
ABOUTPUT_SYSTEM_PARAMETERS
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.
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.
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