ADS Convert Level 0 to Level 1 module


Quick linksDescription :: Parameters :: Parameter descriptions :: Details

Back to top

Description


The ADS Convert Level 0 to Level 1 module converts airborne digital sensor (ADS) products from Level 0 to Level 1. The input can be either the Leica Socet support files (*.sup) or files in PCIDSK format (*.pix). During conversion, the Level 1 product is rectified on a plane and rotated along an epipolar line for stereo viewing. Image and auxiliary information is also written from the source files to each corresponding output file. The converted files retain the source format.
Back to top

Parameters


Name Caption
Input Folder Folder of input files
Output Folder Folder for output files
Overwrite Results Overwrite existing results
File-size Limit Limit of file size
Send Email Email notification settings
Source Background Type Source background type
Source Background Value Source background pixel value
Output Background Value Output background value
Constant Elevation Value Background elevation of DEM
Sampling Interval Pixel spacing for geometric calculations
Back to top

Parameter descriptions

Input Folder

The path and name of the folder containing the ADS Level 0 products to process. Files can be in ADS Socet support files (*.sup) or PCIDSK format (*.pix).

Output Folder

The path and name of the folder to which to write the ADS Level 1 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.

File-size Limit

The limit of the file size of the output TIFF files, in megabytes (MB). When you limit the file size, Level 1 images are cut horizontally into multiple blocks; that is, the block height is equal to the height of the Level 1 image.

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.

Source Background Type

The method to use to determine which pixels in the source image to process as background (NoData) pixels. In general, if a pixel is considered NoData, the module processes it in a specific manner.

If the Any option or the All option is selected, a value must be specified for the Source Background Value parameter.

Available options are:

For specific examples, see the Source Background Value parameter description.

Source Background Value

The source background value or values when the Source Background Type parameter is set to:

The source background value is provided as either a single number (applied to all channels) or as a pixel "stack" (a comma-delimited list of values). If a pixel stack is provided, but the number of values does not equal the number of channels, the list is truncated or the last value is repeated as necessary. The background values provided is truncated to the range allowed by the source image data type.

The following examples apply to a 3-channel, 8-bit unsigned image:

Output Background Value

The background (NoData) value to use for pixels that are not populated.

The specified background value is truncated to the range allowed by the source image data type.

When you specify one value, all channels are set to the same NoData value. If you want to specify different values for various channels, separate the values with commas. For example, to specify -32768 for channel 1 and zero for channel 2 (and any subsequent channels), enter "-32768, 0".

Constant Elevation Value

Enter a value to use as a plane of the elevation. During processing, the converted Level 1 products are rectified to the plane you specify.

Sampling Interval

The spacing of the pixel grid at which to perform rigorous Level 1-to-Level 0 geometric calculations. A value of 1 performs a rigorous calculation for each output pixel.

With intermediate pixels, the L1-to-L0 geometry is approximated by linear interpolation from the nearest grid locations at which the rigorous rectification is performed.

Back to top

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:

Module details

The ADS Convert Level 0 to Level 1 module converts Level 0 products to Level 1 by rectifying to a plane. By converting to Level 1, you can easily perform other photogrammetric processes, such as collect tie points (TP), measure ground control points (GCP), and compile features.

Job results

The ADS Convert Level 0 to Level 1 module creates Level 1 products in the Leica ADS Socet support format (*.sup). The module also creates all of the necessary associated files:
  • Camera-calibration file (*.cam)
  • Orientation data file (*.odf)
  • ADS header file (*.ads)
  • TIFF image file (*.tif)

© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.