File Export module

Description

The File Export module scans the source folder (directory) for GDB-compatible files and creates a child export job for each file found. The module transfers the image and auxiliary information from one or more source files to one or more output files of a different data type.

Note: Some GDB-supported formats cannot be exported.

Parameters

Name	Caption
Input Folder	Input folder
Search Pattern	Pattern for file searching
Output Folder	Output folder
Overwrite Results	Overwrite existing results
Output File Type	Output file type
Output File Options	Output file options
Build Pyramids	Builds pyramids
Raster Channels	List of channels
Bitmap Segments	Bitmap segments to export
Vector Segments	Vector segments to export
LUT Segments	LUT segments to export
PCT Segments	PCT segments to export

Parameter descriptions

Input Folder

The path and name of the folder containing GDB-supported files to process. If necessary, you can use a wildcard, such as the asterisk (*) to search for files.

This parameter is mandatory.

Search Pattern

The search pattern to use when scanning the folder of reference imagery.

For example, to search PCIDSK files, you can specify *.pix, or to search .TIFF (or .tif) files, you can specify *.tiff or *.tif, as applicable. You can also combine two or more patterns separated by a comma, such as *.pix, *.tif.

Output Folder

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

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 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.

Build Pyramids

This check box controls whether to build image pyramids (raster overviews) for the ingested scenes.

Building pyramids improves performance in some subsequent processing steps. They can use the pyramids instead of reading all the pixels. However, building pyramids can cause the ingest job to take longer to complete. If immediately after ingestion you intend only to create orthorectified images, you need not build pyramids.

When to turn on pyramids:

View or edit the data in: CATALYST Professional Focus
Perform some tasks in: CATALYST Professional OrthoEngine
Run any of the aerial triangulation jobs:

For more information on pyramids, see the Pyramid module.

Raster Channels

A comma-delimited list of channels; for example, 1,2,5.

This parameter is optional. If you do not specify a value, all of the channels in the input files is used.

Bitmap Segments

A list of one or more bitmap segments from the input file to export.

This parameter is optional.

Vector Segments

A list of one or more vector segments from the input file to export.

This parameter is optional.

LUT Segments

A list of one or more lookup table (LUT) segments from the input file to export.

This parameter is optional.

PCT Segments

A list of one or more pseudocolor table (PCT) segments from the input file to export.

This parameter is optional.

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:

Format of input and output files must be GDB-supported

Note: For a complete list of GDB-recognized file types, including the options available for each, see GDB-supported file formats

Module details

The File Export module reads the source folder for GDB-compatible files and creates a child export job for each file found.

The module exports a window of selected data channels or segments in an input file to another file format. You can export image channels, bitmaps, vectors, LUTs, and PCTs.

Note: Not all output formats are supported for the various data types.

Input raster channels, bitmap segments, vector segments, LUTs, and PCTs to export can be listed explicitly; otherwise, the module processes all raster channels. You can also define a specific area (window) from which to export from the source file.

For supported formats, georeferencing information is also written to the output file. This information is computed based on the contents of the georeferencing of the input file and the specified raster-input window.

The value of the Output File Type parameter specifies the type of the output file.

Note: For a complete list of GDB-recognized file types, including the options available for each, see GDB-supported file formats

Note: Setting Output File Type to TIF, and if Output File Options has CLOUD in it then the job will export the data to Cloud Optimized Geotiff (COG) files. If Build Pyramids is checked then input file is first exported to PIX, the PIX is pyramided, and finally the PIX is exported to COG. If Build Pyramids is unchecked then the input file is exported directly to COG.

Job results

For each GDB-supported file in the input folder, the File Export module creates a new file in the output folder. Each file contains the image channel, bitmap segment, vector segment, LUT segment, and PCT segment specified for export from the original file.