FBMIMPORT

Description

Parameters

fbmimport(mfile, oeproji, oeprojo, thin)

Parameter descriptions

MFILE

The path and file name of the text file that contains the TP data to import.

Alternatively, you can specify an MFILE. The MFILE can be a file containing a list of TP text files, a wildcard, or a folder of TP text files.

For information about basic use of an MFILE with CATALYST Professional algorithms, see Using an MFILE with a CATALYST Professional algorithm.

OEPROJI

The path and file name of the input OrthoEngine project file.

OEPROJO

The path and file name of the OrthoEngine project file to which to write the imported TPs.

THIN

The number of grid cells to use during thinning.

That is, when a large number of points are collected, it is useful to thin the points prior to importing them into an OrthoEngine project file. By defining the number of grid cells per image, you can control the amount of thinning that occurs. The greater the value, the greater the number of points retained. The thinning process divides each image into the number of grid cells you specify and keeps the TPs with the most connectivity in each grid cell.

If you do not specify a value, the number of grid cells is determined automatically.

If you do not want to apply thinning, enter a value of zero (0).

Return Value

Returns: execution status

Type:  PCI_INT

The return value is the number of TPs imported to the OrthoEngine project file. This function returns only if it executes successfully; otherwise, it throws an exception.

Details

FBMIMPORT reads TP data from TP text files created by running the FBMTIE algorithm, and then writes the data to an OrthoEngine project file.

Example

In the following example, an airphoto_tps.txt file is imported to an OrthoEngine project file, airphoto.prj, and then written to the output project file, airphoto_tps.prj.

from pci.fbmimport import fbmimport

mfile = u"airphoto_tps.txt" 
oeproji = u"airphoto.prj" 
oeprojo = u"airphoto_tps.prj"

fbmimport(mfile, oeproji, oeprojo)