FLIGHTLINE

Description

FLIGHTLINE prints flight-line information for all the images in the MFILE you specify. A metadata tag, BASENAME_FL#_IMG#, is also written to each file.

Parameters

flightline(mfile, basename, breakang)

Name	Type	Caption	Length	Value range
MFILE *	str	Input files	1 -
BASENAME *	str	Basename of the flight line	1 -
BREAKANG	List[float]	Break angle of flight line	0 - 1	Default: 22.5

* Required parameter

Parameter descriptions

MFILE

The names of image files, a folder, or a text file that contains the input images to process. If necessary, you can use wildcards, such as the asterisk (*) in the value string.

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

A specific file-name pattern; for example, "C:\data\*.pix"
All of the files in a folder; for example, "C:\data"
An existing text file that contains references to multiple files; for example, "C:\data\list.txt"

If you use a wildcard, FLIGHTLINE processes all files that match the specified file-name pattern.

If you specify a folder, FLIGHTLINE processes all the recognized image files in that folder.

If you specify the the name of a text file, FLIGHTLINE processes the images listed in the file. Each image should be listed on a separate line. Any other entries that follow the file path and name on each line are ignored.

BASENAME

The basename of the flight line to print. This will be used to write the metadata tag.

BREAKANG

The break angle of a flight line, which is used to determine the end of a flight line. The vector angles between image centers are calculated, and if the vector angle between two image centers is greater than the break-angle threshold of the flight-line ends, a new one begins.

The default value is 22.5 (22.5 degrees).

This parameter is optional.

Return Value

Returns: execution status

Type: PCI_INT

The return value is 0. This function returns a result only if it runs successfully; otherwise, processing stops, and an error message is displayed.

Details

FLIGHTLINE prints flight-line information for all the images in the MFILE you specify. A metadata tag, BASENAME_FL#_IMG#, is also written to each file as follows:

BASENAME is the value set to the BASENAME parameter.
FL# is the number of the flight line in the sequence of images.
IMG# is the number of the image in the flight line

Example

Process all of the photos in a particular folder to group them into their respective flight lines.

from pci.flightline import flightline
mfile="halifax_16"
basename="Halifax"
breakang=[]                       # use the default of 22.5 degrees

flightline(mfile, basename, breakang)

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