UNCLASSIFIED

Error Conditions

This section describes each of the error messages that can be generated by the GEOTRANS application. Errors are grouped into four types.

Initialization Error Messages

Coordinate Conversion Error Messages

User-Defined Ellipsoid & Datum Error Messages

File Processing Error Messages

Initialization Error Messages

Initialization error messages are returned by the MSP Coordinate Conversion Service when it is unable to initialize properly.

The Initialization error messages are:

Typically, multiple initialization error messages are generated.  After each of these messages have been acknowledged, a ‘Failed to create empty document’ dialog box will appear.

Initialization failure most often occurs as a result of the application software being unable to open or read one or more of five key data files:

1)      ellips.dat – containing ellipsoid parameter values,

2)      3_param.dat – containing datum parameter values for datums that are specified only by their displacement relative to WGS84,

3)      7_param.dat – containing datum parameter values for datums that are specified in terms of displacement, rotation, and scale differences relative to WGS84,

4)      egm96.grd – containing geoid separation values for Earth Gravity Model 1996,

5)      egm84.grd – containing geoid separation values for Earth Gravity Model 1984.

These data files are normally located in the /data subdirectory, and the GEOTRANS software looks for them there by default. As an alternative, you can define the environment variable CCS_DATA, and place the files in the directory identified by this variable.

Coordinate Conversion Error Messages

Coordinate conversion error messages are displayed by the GEOTRANS software when a parameter or coordinate value is invalid relative to a particular coordinate system or map projection. In some cases, all of the individual parameter or coordinate values may be valid, but the combination is not. It may also be possible for the input coordinates to be invalid relative to the output coordinate system or map projection after being converted. When any of these errors are detected during interactive operations, a message box is displayed, identifying either the input or the output coordinate system or map projection, and the parameter or coordinate value, or values, which are invalid. When any of these errors are detected during file processing, the same message is written to the output coordinate file in the form of a comment.

Each message includes a prefix that indicates whether the problem is in the input or output portion of the conversion process, and the coordinate reference frame involved. For example, if the error occurred in a conversion from UTM to geodetic coordinates, the prefix might read "Input UTM Coordinates:"

The Coordinate Conversion warning messages are:

The Coordinate Conversion error messages are:

See the description of the indicated coordinate reference frame, and/or the description(s) of the indicated parameter or coordinate field(s) for more information on the valid ranges and valid combinations of map projection parameter and coordinate values.

It is possible for the MSP Coordinate Conversion Application to output error messages other than those listed above. However, these error messages should never appear under normal circumstances, and indicate that the software is in an invalid internal state.

User-Defined Ellipsoid & Datum Error Messages

User-defined datum error messages may be generated when you use the Create... or Delete... commands in the Datum menu. When creating a new user-defined datum, if the code specified for the new datum is already in use, or if any of the parameters for the new datum are not value, an error message box will be displayed after the OK button is clicked. Once the error message is acknowledged, the message box disappears and you are returned to the Create Datum dialog box, where you may either correct the invalid inputs, or cancel the operation.

When deleting a user-defined datum, if the code specified for the datum to be deleted is not user-defined, an error message box will be displayed after the OK button is clicked. Once the error message is acknowledged, the message box disappears and you are returned to the Delete Datum dialog box, where you may either select another datum, or cancel the operation.

The user-defined datum error messages are:

User-defined ellipsoid error messages may be generated when you use the Create... command in the Ellipsoid menu. When creating a user-defined ellipsoid, if the code specified for the new user-defined ellipsoid is already in use, or if the ellipsoid axis values are not valid, an error message box will be displayed after the OK button is clicked. Once the error message is acknowledged, the message box disappears and you are returned to the Create Ellipsoid dialog box, where you may either correct the invalid inputs, or cancel the operation.

When deleting a user-defined ellipsoid, if the code specified for the ellipsoid to be deleted is not user-defined, an error message box will be displayed after the OK button is clicked. Once the error message is acknowledged, the message box disappears and you are returned to the Delete Ellipsoid dialog box, where you may either select another ellipsoid, or cancel the operation.

The user-defined ellipsoid error messages are:

File Processing Error Messages

File processing error messages are generated when the header of an input coordinate file does not have the proper format, or when a particular set of coordinates in the body of an input coordinate file cannot be read successfully, or contains an illegal value. When an error is detected in the header of an input coordinate file, a message box is displayed, and file processing is aborted. When an error is detected in the body of an input coordinate file, a message is written to the output coordinate file in the form of a comment.

The File Processing input coordinate file header error messages are:

Unless otherwise indicated above, you should examine the header of the input coordinate file, and use a text editor to correct the error. See the description of the indicated field for information on the valid ranges of map projection parameter and coordinate values.

The File Processing input coordinate file body error messages are:

In addition, any of the coordinate conversion error messages contained in the previous section can occur during file processing. These messages are written to the output coordinate file in the form of comments. The File Processing dialog box displays the number of such errors in the file when file processing is complete. Examine the line in the input coordinate file which corresponds to the line containing the error message in the output coordinate file (there is a one-to-one correspondence), and correct the contents of the input coordinate file using a text editor. See the descriptions of the coordinate systems, and the coordinate field descriptions, for information on the valid formats and ranges of coordinate values.

UNCLASSIFIED

 


 [KCT1]change to "parameter"

 [KCT2]change to "parameter"

 [KCT3]separation

 [KCT4]check on this - only Equidistant Cylindrical?

 [KCT5]check on this

 [KCT6]check on this - should be Standard Parallel?