ADS Ingest module

Description

The ADS Ingest module generates an airborne digital sensor (ADS) math model for Leica ADS data and imports raster data to a PCIDSK file, a format compatible with CATALYST Enterprise modules.

Parameters

Name	Caption
Scene Folder	Input scene folder
Output Folder	Output folder
Overwrite Results	Overwrite existing results
Send Email	Email notification settings
Ingest Method	Link or import data
Build Pyramids	Builds pyramids
Process One Scene at a Time	Run only one child job at a time
Tri-Stereo Look Directions	View or views to ingest
Ingest Panchromatic	Ingest panchromatic data
Ingest RGB	Ingest RGB data
Ingest CIR	Ingest CIR data
Ingest Red	Ingest red data
Ingest Green	Ingest green data
Ingest Blue	Ingest blue data
Ingest Near-infrared	Ingest near-infrared data
Ingest Level 0	Ingest Level 0 data
Ingest Level 1	Ingest Level 1 data
Ingest Level 2	Ingest Level 2 data

Parameter descriptions

Scene Folder

The path and name of the folder containing ADS scenes to ingest.

The folder you specify must contain support files (.sup) as acquired from the vendor. The folder must not contain a mixture of sensor types; rather, keep multiple sensor types separate, because the module can traverse nested folders.

This parameter is mandatory.

Output Folder

The path and name of the folder to which to write the imported data in PCIDSK format.

The ADS Ingest module creates PCIDSK files for each raw image in the specified scene folder. The module also automatically creates a CATALYST Professional OrthoEngine project file for each scene ingested successfully. These files are then merged into a master OrthoEngine project file written to the output folder.

This parameter is mandatory.

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.

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.

Ingest Method

Select whether to link or import the data specified in the scene folder.

You can select from the following:

Automatic: Links or imports the data based on the sensor.
Import: Creates from the ADS files and auxiliary information a PCIDISK file that contains the input scene.
This method may take longer to ingest the data; however, it improves the overall performance of the workflow.

Important: The Import method requires twice the amount of disk space, because it duplicates the pixel data.
Link: Creates a PCIDISK file that points to the input scene.
This method ingests data very quickly; however, subsequent steps of the workflow may take longer to complete.

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.

Process One Scene at a Time

Select this check box to run only one child job per scene at a time, regardless of the number of available processing nodes.

Tri-Stereo Look Directions

Available only when the Ingest Stereo Data check box is selected, and when the data is tri-stereo, such as ZY-3 scenes, select from the list the specific view or views you want to ingest.

Available options are:

All (Nadir, Forward, Backward)
Forward, Backward
Nadir, Forward
Nadir, Backward
Nadir
Forward
Backward

Ingest Panchromatic

Selected by default, this check box controls whether to ingest panchromatic data, if any exists in the scene folder.

Ingest RGB

Selected by default, this check box controls whether to ingest red, green, and blue (RGB) data, if any exists in the scene folder.

Ingest CIR

Selected by default, this check box controls whether to ingest color infrared (CIR) data, if any exists in the scene folder.

Ingest Red

Selected by default, this check box controls whether to ingest red data, if any exists in the scene folder.

Ingest Green

Select this check box to ingest green data, if any exists in the scene folder.

Ingest Blue

Select this check box to ingest blue data, if any exists in the scene folder.

Ingest Near-infrared

Select this check box to ingest near-infrared data, if any exists in the scene folder.

Ingest Level 0

Select this check box to ingest Level 0 data, if any exists in the scene folder.

Ingest Level 1

Select this check box to ingest Level 1 data, if any exists in the scene folder.

Ingest Level 2

Select this check box to ingest Level 2 data, if any exists in the scene folder.

Details

General job details

Preprocessing requirements

The ADS Ingest module supports ADS image products in the Leica GPRO format. This format contains several ancillary data files in addition to the image data. The following files are required:

One or more image files in TIFF format (.tif)
One .ads file in the same folder as the TIFF file, with the name of this TIFF file appearing in the BLOCK_DATA record of the .ads file
One .sup file in the same folder as the .ads file, in the parent folder of the .ads file, or in a Support subfolder of the parent .ads file. The IMAGE_FILE_NAME 1 record of the .sup file must contain the name of the .ads file.
One original .odf file containing position and orientation data. This file must be in the location listed in the ORIGINAL_ORIENTATION record of the .sup file, or at least in the same relative folder structure as listed in the .sup file.
Optionally, one .odf.adj file containing adjusted position and orientation data. This file must be in the location listed in the ADJUSTED_ORIENTATION record of the .sup file, or at least in the same relative folder structure as listed in the .sup file.
One original .cam file containing camera-calibration parameters. This file must be in the location listed in the ORIGINAL_CALIBRATION record of the .sup file, or at least in the same relative folder structure as listed in the .sup file.
Optionally, one .cam.adj file containing adjusted camera-calibration parameters. This file must be in the location listed in the ADJUSTED_CALIBRATION record of the .sup file, or at least in the same relative folder structure as listed in the .sup file.

The ADS Ingest module uses logic to recognize the relative folder structure of the various files listed in the .sup file. Should the process indicate that one or more of the files could not be found, make sure your .sup file lists the correct path names and reflects your actual folder structure.

If you are working with read-only files; that is, you cannot edit the .sup file or folder structure, you can copy the .sup file to another location, edit the path names as necessary, and then use that file as input to the module. The .sup file need not be stored in any specific location relative to the other product files. The ADS Ingest module will use the actual path names to find all of the other files.

The following example shows a typical folder-and-file layout for a typical ADS product. This product contains a single Level 0 product, the Level 1 panchromatic backward, forward, and nadir channels, and a three-component Level 1 RGB file.

+---Calibration
|   \---ADS40_30018
|       |   DOC-870107-30018-040929-1.pdf
|       |   
|       \---v001
|               BLUF16A.cam
|               GRNF16A.cam
|               misalignment.dat
|               PANB14A.cam
|               PANF28A.cam
|               PANN00A.cam
|               readme.txt
|               REDF16A.cam
|               
+---Images
|       06260944PANN00A.ads
|       06260944PANN00A_0_0.tif
|       L106260944PANB14A.ads
|       L106260944PANB14A_0_0.tif
|       L106260944PANF28A.ads
|       L106260944PANF28A_0_0.tif
|       L106260944PANN00A.ads
|       L106260944PANN00A_0_0.tif
|       L106260944RGBF16A.ads
|       L106260944RGBF16A_0_0.tif
|       L106260944RGBF16A_0_1.tif
|       L106260944RGBF16A_0_2.tif
|       
+---Orientation
|       06260944BLUF16A.odf
|       06260944BLUF16A.odf.adj
|       06260944GRNF16A.odf
|       06260944GRNF16A.odf.adj
|       06260944PANB14A.odf
|       06260944PANB14A.odf.adj
|       06260944PANF28A.odf
|       06260944PANF28A.odf.adj
|       06260944PANN00A.odf
|       06260944PANN00A.odf.adj
|       06260944REDF16A.odf
|       06260944REDF16A.odf.adj
|       06260944RGBF16A.odf
|       06260944RGBF16A.odf.adj
|       
\---Support
        L006260944PANN00A.sup
        L106260944PANB14A.sup
        L106260944PANF28A.sup
        L106260944PANN00A.sup
        L106260944RGBF16A.sup

For this product, L106260944PANN00A.sup lists the locations of ancillary data files, as shown in the following example.

IMAGE_FILE_NAME 1 "C:\InfoKit_v2\Data\Images\L106260944PANN00A.ads"
ORIGINAL_ORIENTATION C:\InfoKit_v2\Data\Orientation\06260944PANN00A.odf
ADJUSTED_ORIENTATION C:\InfoKit_v2\Data\Orientation\06260944PANN00A.odf.adj
ORIGINAL_CALIBRATION C:\InfoKit_v2\Data\Calibration\ADS40_30018\v001\PANN00A.cam

In the preceding example, the root folder for the product is C:\\InfoKit_v2\\Data\\. If you want to move the folder to another location, you must keep the Images\\, Orientation\\, and Calibration\\ folders in their relative positions. No modifications to the data set are should be required for it to be read by the ADS Ingest module.

Module details

You use the ADS Ingest module to automatically import ADS data into the PCIDSK format. This is a mandatory step in the CATALYST Enterprise workflow, and allows a multitude of actions to take place, including:

Ingesting the nominal math model provided with the sensor data
Setting default metadata to the ingested PCIDSK file

This module supports ADS sensors and data products. With each data product, the module can import the multispectral and panchromatic images.

Note: Typically, images acquired with an airborne digital sensor (ADS) have panchromatic (PAN) and multispectral (MS) bands. To reduce processing time when ingesting the data, the MS images are deactivated, and then reactivated during orthorectification with the updated math model applied.

Job results

For each scene in the scene folder, the ADS Ingest module creates:

A PCIDSK file containing the multispectral image bands
A PCIDSK file containing the panchromatic image band

Each output file is written to the output folder using a naming convention based on the base name of the support file. That is, the file name is appended using the following file name convention:

*_L#.prj, where _L# represents the level of the data in the OrthoEngine project.

_L0 = Level 0
_L1 = Level 1

The ADS Ingest module also automatically creates an OrthoEngine project file for each scene ingested successfully. To facilitate quality-assurance (QA) processes, it also creates an OrthoEngine project file of all processed scenes. You will find this merged file, OEProject.prj, in the output folder.