ADSL0TOL1

Description

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

Parameters

adsl0tol1(mfile, mmseg, dbiw, srcbgd, height, sampling, outdir, ftype, foptions, outbgd, memsize)

Name	Type	Caption	Length	Value range
MFILE *	str	Input file name, folder, or text file	1 -
MMSEG	List[int]	Input math-model segment	0 -
DBIW	List[int]	Input window	0 - 4	XOff, YOff, XSize, YSize
SRCBGD	str	Source background value	0 -	Default: FILE
HEIGHT	List[float]	Mean height	0 -
SAMPLING	List[int]	Sampling interval	0 - 1	1 - Default: 1
OUTDIR *	str	Output folder	1 -
FTYPE	str	Output file type	0 - 3	ADS \| PIX Default: ADS
FOPTIONS	str	Output file options	0 - 64
OUTBGD	List[float]	Output background value	0 - 1	Default: 0
MEMSIZE	List[int]	Working memory size	0 - 1	Default: 256

* Required parameter

Parameter descriptions

MFILE

The name of a file, or a folder or text file that contains the ADS Level 0 products to process. The files can be ADS Socet support files (*.sup) or in PCIDSK format (*.pix). Alternatively, you can specify a text file of ADS products. If necessary, you can use a wildcard (*) in the string.

You can specify the value of the MFILE parameter by using any of the following:

A file; for example, "irvine.pix" or "C:\data\irvine.pix".
A file-name pattern or all of the files in a folder; for example, "C:\data\*.pix" or "C:\data".
An existing text file that contains references to multiple files with, optionally, different parameter settings per file; for example, "C:\list.txt". The paths in the file can be absolute or relative to the folder location of the text file. With the text file, each line must have the following format:
- File;<parameter_1>;<parameter_n>

With a text file, the following general rules also apply:

The file must have a .txt extension for the file containing multiple files and different parameter values.
List each set of parameters on its own line in the given order.
Specify string parameters in quotation marks.
Do not specify numeric parameters in quotation marks.
A quotation mark preceded by a backslash is used as part of the string. For example, ab\"c is used as: ab"c.
Comments in the file must be preceded with an exclamation mark (!).
Use semicolons to delimit the parameters.
Leave the position between the semicolons empty (";;") when you do not want to specify a value. Alternatively, if there are no remaining parameters to specify at the end of a line, you can leave it blank.
Parameters in a text file may or may not be specified in the algorithm:
- If a parameter is specified in the algorithm and in the text file, the value in the text file is used.
- If a parameter is not specified in the text file, the parameter can be specified in the algorithm.

MMSEG

If your input file is a PCIDSK file, use this parameter to specify the ADS math-model segment. If you do not specify a value, the existing math-model segment of the input file is used. If your input file is an orientation data file (*.odf), you need not specify a value for this parameter.

DBIW

The raster window (x-offset, y-offset, x-size, y-size) of data to read from the input channels.

If no value is specified for this parameter, the entire image is processed. The x-offset and y-offset define the upper-left starting pixel coordinates of the window. X-size is the number of pixels that define the window width. Y-size is the number of lines that define the window height.

Tip: This parameter is particularly useful when orthorectifying scanned film airphotos, because you can use it to exclude the registration marks and ancillary data printed along the edge of the image.

SRCBGD

The pixels in the source image to consider as background (NoData) pixels. Typically, if a pixel is considered NoData, ADSL0TOL1 processes the pixel in a specific manner.

Available options are:

FILE: Reads the NoData value from the NO_DATA_VALUE metadata tag in the input file. The file-level metadata tag is used as the default for each channel; channel-level tags, when available, override the default. When metadata does not exist, each pixel in the input is considered valid.
0: Each pixel, in each channel, with a value of 0 is considered NoData
NONE: Each pixel, in each channel, is considered valid
<value>: Each pixel, in each channel, with the specified value is considered NoData.
FILE [, <value>]: same as FILE, but defines the NoData value for each channel, when metadata does not exist.

For example, the default "FILE, 0" specifies that the function uses metadata. If the metadata is unavailable, pixels that have a value of zero are considered NoData>.

HEIGHT

The average terrain height of the area covered by the strip. If no value is specified, the height is determined from the math model of the input file.

SAMPLING

Specifies the pixel grid spacing at which rigorous L1 to L0 geometric calculations are performed. A value of 1 causes the rigorous calculation to be performed for every output pixel.

For intermediate pixels, the L1 to L0 geometry is approximated by linearly interpolating it from the nearest grid locations at which the rigorous rectification was performed.

OUTDIR

The path and name of the folder to which to write the ADS Level 1 files, including the image files and associated Socet support files.

FTYPE

The format of the output file. The format must be a GDB-supported type.

Supported formats include:

ADS: Leica ADS format
PIX: PCIDSK format

For a complete list of GDB-supported formats, see GDB-supported file formats.

FOPTIONS

The options to apply on creating the output file, such as compression schemes, format subtypes, and more. The options are specific to each format. By default, no options are applied (empty string).

For a complete list of GDB-supported file types, including the avialable options for each, see GDB-supported file formats.

With ADS products, the FOPTIONS parameter includes an extra option to control the file size of the TIFF files created. That is, you can enter FILESIZE=XXX where XXX is the file size in megabytes (MB). For example, to create a TIFF file no larger than 150 MB, enter FILESIZE=150.

Note: The size you specify is an approximate value. Actual size may vary somewhat.

OUTBGD

The background (NoData) value to use for Level 1B pixels that are not populated. All channels are set to the same background value. The specified background value will be truncated to the range allowed by the source image data type.

MEMSIZE

The amount, in megabytes (MB), of internal memory to allocate to processing.

Return Value

Returns: Program execution status

Type: PCI_INT

The return value is 0. This algorithm provides a result only if it runs successfully; otherwise, it throws an exception.

Details

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

You must have either Leica ADS Level 0 Socet support files (*.sup) or files in PCIDSK (*.pix) format.

Example

Convert ADS Level 0 to Level 1

from pci.adsl0tol1 import adsl0tol1

mfile    = 'MyFile.mfile'   # Input file name, folder, or text file
mmseg    = [2]              # Input math-model segment
dbiw     = []               # Raster input window
srcbgd   = 'FILE'           # Source background value
height   = []               # Mean height
sampling = []               # Sampling interval
outdir   = 'Output'         # Output folder
ftype    = ''               # Output file type
foptions = ''               # Output file options
outbgd   = []               # Output background value
memsize  = []               # Working memory size

adsl0tol1(mfile, mmseg, dbiw, srcbgd, height, sampling, outdir, ftype, foptions, outbgd, memsize)

Environments	PYTHON :: EASI
Quick links	Description :: Parameters :: Parameter descriptions :: Return Value :: Details :: Example