RFMODEL

Description

RFMODEL calculates the mathematical models required for orthorectification using rational functions, and stores the result in a segment.

Parameters

Name	Type	Caption	Length	Value range
MFILE*	String	Input file name, directory, or text file	1 - 192
DBGC	Integer	Input GCP segment or layer	0 - 1
MMSEG	Integer	Math model segment or layer	0 - 1
ADJORDER	Integer	RPC adjustment order (0, 1, 2)	0 - 1	0 - 2
NUMCOEFF	Integer	Number of coefficients (3 to 20)	0 - 1	3 - 20
MAPUNITS	String	Map units	0 - 192	PIXEL, UTM, METER, and others
REPORT	String	Report mode	0 - 192	Quick links

* Required parameter

Parameter descriptions

MFILE

Specifies the name of a folder, image file, or text file that contains the input images. Wildcards (*) can be used.

MFILE can be set using any of the following options:

A specific data file name or directory path and file name (for example, "irvine.pix" or "c:\data\irvine.pix").
A specific 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 on a per file basis (for example, "c:\list.txt").

If the text file option is used, the following general rules apply:

Specify 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 (see below).
Specify string parameters within quotation marks.
Do not specify numeric parameters within 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.
Use an exclamation mark (!) before writing a comment in the text file.
Use semi-colons to delimit the parameters.
Leave the position between the semi-colons empty (";;") if you do not want to specify a value. Alternatively, if there are no remaining parameters to be specified on the end of a line, you may leave it blank.
Parameters in a text file may or may not be specified in the function:
- If a parameter is specified in the function and in the text file, the value provided in the text file is used.
- If a parameter is not specified in the text file, the parameter can be set in the function.

If MFILE is a directory name or if multiple file names are entered, then all images in MFILE should be processed using the parameters set for RFMODEL.

If a directory is specified, then the DBGC, MMSEG, ADJORDER, and NUMCOEFF parameters are set to a single value for all input images. If a text file is specified, the DBGC, MMSEG, ADJORDER, and NUMCOEFF parameters are read from the text file for each image, and those parameters can be empty.

If one file is specified for MFILE, the model computed will be an independent model (one image).

If a text file is specified for MFILE, the listed files in the text file are processed with the listed parameters.

DBGC

Specifies the ground control point (GCP) segment or layer to use to compute the model.

If a directory is specified for MFILE, then this segment number will be applied to all images. If a text file is specified, DBGC is read from the text file, and this parameter can be empty.

MMSEG

Specifies the math model segment or layer that stores the model.

If a directory is specified for MFILE, then this segment number will be applied to all images. If a text file is specified, MMSEG is read from the text file, and this parameter can be empty. If no value is specified, a new segment is created.

ADJORDER

If RPC data is supplied with the data, this value specifies the RPC adjustment order to be used in the RPC model refinement. Valid values are 0, 1 or 2.

NUMCOEFF

If RPC data is not supplied with the data, this value specifies the number of coefficients to be used to calculate the rational function. Valid values are 3 to 20.

MAPUNITS

Specifies the projection string for the output model.

The standard definitions are as follows:

PIXEL: pixel and line
UTM: Universal Transverse Mercator
SPCS: State Plane Coordinate System
LONG/LAT: longitude and latitude
METER: image along-row and along-column meters
FOOT: image along-row and along-column feet

For a complete list of supported projections and Earth models, see Understanding map projections. The format of the map units string is described in Output units.

If this parameter is not specified, the map units of the GCP segment are used.

REPORT

Specifies where to direct the generated report.

Available options are:

TERM: generates a report on the terminal (default)
DISK: generates a report on file "IMPRPT.LST"
OFF: turns off report generation
<filename>: appends a report to the specified file

Details

RFMODEL calculates the mathematical model required for orthorectification using rational functions. It computes an updated rational functions solution, based on provided GCPs or rational function coefficients, or both.

There are several use scenarios for RFMODEL:

Enter an unreferenced raw image, GCPs, and a number of coefficients: RFMODEL computes the RPCs based on ground control information alone, and generates to a math model segment.
Enter a linked PCIDSK file to a raw image with RPCs (NITF, TIFF, with TXT): RFMODEL creates a math model segment in the linked PCIDSK database.
Enter an imported raw image with RPCs and GCPs: RFMODEL computes the x- and y- offsets, and generates to a math model segment on the input database.
Enter a folder of images or a wildcard selection of images with RPCs and GCPs: RFMODEL computes the x- and y- offsets for each image and generates to a math model segment on the input databases or linked databases, as required.
Enter a text file specifying parameters for several images: RFMODEL computes the x- and y- offsets for each and generates to a math model segment on the input databases or linked databases, as required.

Note: If you have RPCs but no GCPs, RFMODEL need not run. ORTHO and other functions interpret the RPC model transparently from the original raw image files (NITF, TIFF with TXT).

Note: When run with EASI the function sets the parameter named IMSTAT to the values that are returned by the Python version.

Examples

You have an IKONOS image and would like to correct it using rational functions.

EASI>MFILE="ikonos.pix"	! input image file
EASI>DBGC=1		! use GCP segment 2
EASI>MMSEG=		! create a new math model segment
EASI>ADJORDER=0		! use 0 order RPC adjustment
EASI>NUMCOEFF=		! leave none for RPC coefficient number
EASI>MAPUNITS="UTM 11 d0"	! output projection
EASI>r RFMODEL

You have an image without existing RPC math model and would like to generate a new RPC segment.

EASI>MFILE="17029_pan.pix"	! input image file
EASI>DBGC=3		! use GCP segment 3
EASI>MMSEG=		! create a new math model segment
EASI>ADJORDER=		! leave none for RPC adjustment order
EASI>NUMCOEFF=20		! use 20 for RPC coefficient number
EASI>MAPUNITS=	! output projection
EASI>r RFMODEL

Environments	PYTHON :: EASI :: MODELER
Quick links	Description :: Parameters :: Parameter descriptions :: Details :: Examples :: Related