Image Warp module

Name	Caption
Input Folder	Input folder
Output Folder	Output folder
Send Email	Email notification settings
Output File Type	Output file type
Output File Options	Output file options
Overwrite Results	Overwrite existing results
Output Map Units	Output projection
Panchromatic Pixel Output Size	Panchromatic output pixel size
Multispectral Pixel Output Size	Multispectral output pixel size
Resampling Method	Resampling method

Parameter descriptions

Input Folder

Specifies the path of the folder containing the PCIDSK (.pix) files to warp. This is typically the output folder of the Data Ingest module or the Data Ingest and GCP Collection module.

Output Folder

The path and name of the folder to which to write the output files.

Send Email

If necessary, you can set up CATALYST Enterprise to send an email notification on job start and job completion.

With this check box selected, an email message is sent to each address specified in the Email Addresses box after the job starts and on completion.

You can specify one or more addresses, and each must be separated by a comma or a semi-colon. The email address of the user currently logged in displays by default.

Output File Type

The format of the output file.

For more information on the supported file formats, see GDB-supported file formats.

Output File Options

The options to apply when creating the output file or files. The available options are specific to the file format; in each case, the default of no options is allowed.

For more information on the options available for the output file type you specify, see GDB-supported file formats.

Overwrite Results

Select this check box to overwrite the existing output files, if any exist. If this check box is left clear, and an output file exists in the relevant folder, the status of the job displays a message informing you of the existence and name of the output file. The message is also written to the event log of the job.

Output Map Units

The projection of the output imagery.

The value of this parameter must be in the PCI Projection String format.

The standard definitions are:

PIXEL: Pixel and line (not for use with DEM extraction)
UTM: Universal Transverse Mercator

The value specified can be the UTM grid zone number and row, and Earth model, as follows:
```
UTM [mm] [r] [Ennn]
```
where:
- [mm] is the two-digit zone number between 1 and 60
- [r] is the zone row: a single letter between N and X for north of the equator and between C and M for south of the equator. Zone rows A, B, Y, and Z are not supported; rows I and O do not exist.
- [Ennn] specifies the Earth model, where the model number is between 0 and 19. If the Earth model is not specified, it is assumed to be E000 (Clarke 1866).
SPCS: State Plane Coordinate System

The SPCS zone number and Earth model can be specified as follows:
```
SPCS [mmmm] [Ennn]
```
where:
- [mmmm] is the four-digit zone number
- [Ennn] specifies the Earth model, where the model number is between 0 and 19. If the Earth model is not specified, it is assumed to be E000 (Clarke 1866).
LONG/LAT: Longitude and latitude

The Earth model can be specified for LONG/LAT (and other units except PIXEL), as follows:
```
LONG/LAT [Ennn]
```
If the Earth model is not specified, it is assumed to be E000 (Clarke 1866).
EPSG: European Petroleum Survey Group code

You can specify the projection by entering an EPSG code defined by the Open Geospatial Consortium (OGC). For information on the code definitions, visit epsg.org and spatialreference.org.

The EPSG code is specified using the EPSG keyword followed by an integer and separated by a colon; for example:
```
EPSG:4326
```
Most common EPSG codes are supported.
METER: Image along-row and along-column meters
FEET: Image along-row and along-column feet
You can also specify the label of a projection you define, if the projection exists in the userproj.txt file; otherwise, you must enter the projection-parameter information as a string separated by the vertical bar (|). The projection-parameter string defines 18 parameters delimited by spaces, including the following:
- Dearth
- RefLong
- RefLat
- StdParallel1
- StdParallel2
- FalseEasting
- FalseNorthing
- Scale
- Height
- Long1
- Lat1
- Long2
- Lat2
- Azimuth
- LandsatNum
- LandsatPath
- UnitsCode
For example, the projection named 'France93' can be specified, as follows:
```
LCC D350 | 0 0 3.0 46.5 44.0 49.0 700000 6600000 0 0 0 0 0 0 0 0 0 -1
```

If you do not specify a value for Output Map Units, the map unit of the input image is used for the output image. If the input data is a variety of map units, the map unit of each output image is that of its corresponding input image. In such a case, it is recommended that you specify the output map units.

You can also specify the label of a projection defined in the userproj.txt file.

Panchromatic Pixel Output Size

The output spatial resolution for the panchromatic imagery to be orthorectified.

The units for the pixel size must match the units selected for the Map Units parameter; for example, if the map units are specified as UTM, the panchromatic pixel output size is in meters.

If no value is specified for this parameter, the pixel output size is based on the input math model associated with each scene in the input-scenes folder.

Note: If the input files have been pansharpened previously, specify the output pixel size in the Multispectral Pixel Output Size parameter.

Multispectral Pixel Output Size

The output spatial resolution for the multispectral imagery to be orthorectified.

Note: When the input images have been pansharpened previously, use this parameter to specify the output resolution.

The units for the pixel size must match the units specified for the Map Units parameter; for example, if the value of Map Units is specified as UTM, the multispectral pixel output size is in meters.

If no value for this parameter is specified, the pixel output size is based on the input math model associated with each scene in the input-scenes folder.

Resampling Method

The resampling method to use during processing.

Available resampling options are:

Cubic: cubic convolution. This method determines the gray level from the weighted average of the 16 pixels closest to the specified input coordinates and assigns that value to the output coordinates. The resulting image is slightly sharper than one produced by bilinear interpolation, and it does not have the disjointed appearance produced by nearest-neighbor interpolation.
Nearest Neighbor: nearest-neighbor interpolation. This method identifies the gray level of the pixel closest to the specified input coordinates and assigns that value to the output coordinates. Although this method is the most efficient in computation time, it introduces small offsets in the output image. The output image may be offset spatially by up to half a pixel, which may cause the image to have a jagged appearance.
Bilinear: bilinear interpolation. This method determines the gray level from the weighted average of the four closest pixels to the specified input coordinates and assigns that value to the output coordinates. An image with a smoother appearance than nearest-neighbor interpolation is created, but the gray-level values are altered in the process, resulting in blurring or degraded image resolution.

Details

General job details

Preprocessing requirements

Before running this module, the following requirements must be met to ensure the job processes successfully and produces accurate results:

A math model (usually a polynomial model) must exist in the input image files

Note: If the math model is an RPC or satellite model, the elevation used is assumed to be sea level (that is, 0); consequently, the generated output is not an actual ortho product.

Module details

The Image Warp module If an image file does not have a DEM available for orthorectification, you can register the image using the image’s math model. The Image Warping module searches the specified input folder for valid raster image files. For each valid file found, the module uses the file’s math model to rectify the image. Only raster files in PIX format and having a valid math model are processed.

The function always uses the math model in the last math model segment of the file to transform the image. If the math model is a polynomial or thin plate spline one, the module warps the raster; if the math model is an RPC or satellite one, the module rectifies the raster assuming that the elevation of the image’s ground area is flat at sea level.

The geometric accuracy of the warped image is determined by that of the math model.

Job results

Upon successful completion, this module generates one raster file for each input raster file and stores them in the specified output folder.

The output raster file name is based on the input file name, replacing the processing level indicator from RAW to WARP. For example:

Input raster file name: 55162510809161909232J_RAW_MS.pix
PIX output raster file name: 55162510809161909232J_WARP_MS.pix
TIFF output raster file name: 55162510809161909232J_WARP_MS.tif

Image Warp module

Description

Parameters

Parameter descriptions

Details