Data Transformation module

Name	Caption
Send Email	Email notification settings
Input Folder	Input folder
Search Mask	Search pattern
Raster Channels	Input raster channels
Vector Segments	Input vector segments
Output Folder	Output folder
Output File Type	Output file format
Output File Options	Output file options
Target Segment Type	Output segment type
Elevation Reference/Datum	Elevation model
Overwrite Results	Overwrite existing results
Reproject	Reproject
Output Map Units	Output projection
Reprojection Method	Reprojection method
Output Resolution	Output resolution
Resampling Method	Resampling method
Resampling Kernel File	Resampling Kernel File

Parameter descriptions

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.

Input Folder

The path and name of the folder containing the spatial-data files to transform. If necessary, you can specify a folder of nested folders.

Search Mask

The search pattern to use when reading the input folder for spatial-data files. For example, specify *.pix to search for PCIDSK files, or *.tif to search for TIFF files.

If you do not specify a search pattern, by default, CATALYST Enterprise searches for *.pix, *.tif, and *.tiff.

Raster Channels

The input raster channels to transform. If no value is specified for this parameter, all raster channels are processed by default.

Vector Segments

The input vector segments to transform. If no value is specified for this parameter, all vector segments are processed by default.

Output Folder

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

Output File Type

The file format of the output transformed file.

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.

Target Segment Type

The type of output segment.

Available options are:

None
RPC Math Model
GCP Segment (Last)

Elevation Reference/Datum

The vertical reference for the elevation values in the source digital elevation model (DEM), or for the constant value of the Elevation Offset and Elevation Scale parameters, when available, and specified.

Available values are as follows:

Mean Sea Level: Elevations are referenced to mean sea level (MSL). The EGM2008 geoid model is used to convert the elevations to ellipsoidal heights.
Ellipsoid: Elevations are referenced to the ellipsoid. The coordinate system of the DEM raster file is examined to determine which ellipsoid and datum to use. For example, if the DEM file is referenced to NAD83, the heights are assumed to be NAD83 ellipsoidal heights. If the DEM and math model are based on different coordinate systems, the heights are converted automatically to the math-model coordinate system before use.
Automatic: Select this option when you want the module to automatically determine the elevation reference based on your input data.

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.

Reproject

Select this check box to reproject the spatial data.

Note that if this check box is selected, and Output Map Units is empty, then the original data's projection will be used, in effect, resampling the data instead of reprojecting it.

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.

Reprojection Method

The method of projection to use.

Available options are:

Pixel, Line, and Boundary
Pixel, Line, and Resolution
Boundary and Resolution

This parameter is used only when the Reproject check box is selected; otherwise, it is ignored.

Output Resolution

The resolution of the output, consistent with the value of the Target Projection parameter.

This parameter is used only when the Reproject check box is selected; otherwise, it is ignored.

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. This is the default value.
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.
Sinc-8: eight-point sin(x)/x
Sinc-16: 16-point sin(x)/x
2D Kernel: 2D Kernel resample using the specified kernel file.

Resampling Kernel File

The custom resampling kernel file specifies a 2D kernel to be applied during the resampling.

The kernel file has a specific format. The first line indicates the number of columns and rows in the kernel:

				ColSize,RowSize

The subsequent lines consist of (ColSize * RowSize) kernel weights, listed one row per line:

				Weight_{1,1},...,Weight_{1,ColSize}
				.
				.
				.
				Weight_{RowSize,1},...,Weight_{RowSize,ColSize}

The following is an example of a kernel file specifying a 3x3 kernel:

				3,3
				0.01134374,0.08381951,0.01134374
				0.08381951,0.61934703,0.08381951
				0.01134374,0.08381951,0.01134374

This parameter is used only when the Reproject check box is selected and Resampling Method is set to "2D Kernel"; otherwise, it is ignored.

Details

General job details

The Data Transformation module provides a series of predefined configuration files that define the type of output to create. These are defined in the settings.py file in the PROHOME\exe\PGS\config folder of your CATALYST Enterprise installation.

Pre-defined formats include:

TIF [-1, 0]
IMG [-1, 0]
JP2 [3, 0]
AIB [-1, 0]
NITF [-1, 0]
CDED [-1, 0]
DTD [1, 0]
SID [-1, 0]
PIX [-1, -1]
SHP [0, 1]
SHP [0, 1]
KML [0, 1]
KMZ [0, 1]
MIF [0, 1]
NTFC [0, 1]

The numbers following the type indicate the maximum number of channels or segments that the format supports. A negative 1 (-1) signifies that there is no limit to the number of channels or segments to be supported.

Module details

The Data Transformation module reads the input folder for valid spatial data to transform. Valid files must be in a GDB-supported format, and file names must match the search criteria specified by the value of the Search Mask parameter. For each valid file found, the module spawns a child data-transformation job.

Each child job transforms a given spatial-data file to a specified target format and, optionally, reprojects it. If the specified target format is the same as the original, no transformation is applied.

Conversion between formats can sometimes lead to loss of information. For example, the PCISDK format stores a great amount of metadata; after conversing, this information will not be stored in a TIFF file if those metadata tags are not supported.

When the target format supports only a limited number of channels or segments, not all channels or segments from the original file will be transformed, even if they are specified for inclusion.

The Data Transformation module can be extended by adding more options to the dataTransformation section of the settings.py configuration file, provided the additional options follow the necessary guidelines. For more information, see GDB-supported file formats.

Job results

On successful completion, the Data Transformation module creates a transformed output file for each valid spatial-data file found. The output file name will be the same as that of the original file, but with a file extension that reflects the output file type; for example, filename.tif.

Data Transformation module

Description

Parameters

Parameter descriptions

Details