Adding custom projection systems to Express Server

Express Server can reproject imagery into an EPSG-defined spatial reference system (also called a coordinate reference system or CRS). The supported EPSG codes are a subset of those which were defined by the EPSG database available when the product was released. This article describes how to add support for other CRSs, such as custom projections or more recent additions to the EPSG database. It tells you how to obtain an OGC-compliant well known text (WKT) version of the CRS and add it to the esri_extra.wkt file used by Express Server.

CAUTION: Improper editing of the esri_extra.wkt file can cause unexpected behavior. Please review your changes carefully and make a backup before you start.

To obtain an OGC-compliant WKT version of the CRS: 
The WKT version of the CRS should be available from the source of the CRS. If an ESRI “.prj” file is provided instead (as is often the case) the .prj file can be converted in LizardTech GeoExpress using the steps below.

1. Add any image to the Images tab of the Job list in GeoExpress.
2. Click the Reproject icon on the toolbar (or choose Reproject from the Tools menu). The Reprojection Manager appears.
3. Click the Select Coordinate Reference System The Coordinate Reference System Selector dialog appears.
4. Select the Use custom WKT
5. Choose -Add a new WKT-from the Select WKT drop-down menu. The Edit User Defined WKT dialog appears.
6. Click Browse to choose the .prj file you need to convert. If you don’t see your file, select ESRI CRS files (*.prj)in the Files of Type drop-down menu.
7. Click OK. The text box populates with the OGC-compliant WKT that you will add to the esri_extra.wkt file.
8. Copy the WKT and paste it into a text editor for later use.
9. You may now close GeoExpress without saving the project.

If you don’t have access to GeoExpress or an authoritative conversion of your projection string (from the source) you may be able to convert it “by inspection” as ESRI PRJ files are quite similar to WKT files (see example below).

To add the WKT to the esri_extra.wkt file: 
This text file is used internally by Express Server. Each line in the file follows the format <epsg code>, <wkt>, containing an EPSG code with a definition of an OGC-compliant (but presumably non-standard) CRS:

1. Using a text editor, open the esri_extra.wkt file (located by default in C:LizardTechExpressServer6.1ImageServeretcgdal).
2. Add a new line for your custom EPSG code to the bottom of the file as follows:
   • Add the custom EPSG code and a comma
   • Append the WKT. Remove all the carriage return line feeds so that the WKT is all one long string.

Example
Here we’ll add support for EPSG code 102763, which is not in the EPSG database and not supported by Express Server. It comes from a custom “.prj” file shown below.

Convert the .prj file to an OGC standard WKT using GeoExpress, which results in the following. Note that the DATUM and PROJECTION have been changed.

Add the new WKT to the esri_extra.wkt file, preceding it with the EPSG code and a comma. While the text in the sample below has line breaks, the text in your esri_extra.wkt file should be on one line with no breaks.

Express Server will now reproject to “EPSG:102763″.

Reference Number:

FB-8385