IFrameXform Interface

Provides access to members that control a standard frame camera transform.

Members

	Name	Description
	ApplyCurvatureAndRefraction	Indicates if the adjustment of earth curvature and refraction is applied.
	AverageZ	The average Z in meters.
	Domains	The domains in output space.
	EarthRadius	The earth radius in meters.
	EnableKonrady	Indicates if the Konrady adjustment to be applied.
	FocalLength	The focal length in micron.
	GetDistortionTable	The distortion tables.
	InteriorOrientation	The interior orientation as an affine transformation.
	IsIdentity	Indicates if this geodata transform is an identity transform.
	KonradyParameters	The Konrady adjustment parameters.
	KonradyType	The Konrady calculation method.
	LSR	The LSR-To-USR conversion.
	PerspectiveCenter	The sensor position.
	PerspectiveMatrix	The specified sensor orientation as an orthogonal rotation matrix.
	PerspectivePolarity	The sensor polarity.
	PrincipalPoint	The film principal point.
	PutDistortionTable	The distortion tables to calculate Konrady coefficients and residuals.
	PutInteriorOrientationParameters	Puts the interior orientation parameters.
	PutPerspectiveAngles	Puts the sensor exterior orientation as a set of rotation angles in degrees.
	QueryKonradyParameters	Queries the Konrady adjustment parameterrs.
	QueryPerspectiveAngles	Queries the sensor exterior orientation as a set of rotation angles in degrees.
	QueryPerspectiveMatrix	Queries the perspective matrix.
	Residuals	The residuals for distortion table points.
	SpatialReference	The output spatial reference after applying this transform.
	Transform	Transforms a set of points in a given direction.
	TransformCellsize	Transforms a cellsize in a given direction.
	TransformExtent	Transforms an extent in a given direction.
	TransformPoints	Transforms a point collection in a given direction

IFrameXform.ApplyCurvatureAndRefraction Property

Indicates if the adjustment of earth curvature and refraction is applied.

Public Property ApplyCurvatureAndRefraction As Boolean

public bool ApplyCurvatureAndRefraction {get; set;}

Remarks

Optional parameter indicating whether the earth curvature and atmospheric distortion correction should be applied. By default it is not. It is primarily used for high altitude aerial photography, as the effect is minimal in most aerial surveys.

IFrameXform.AverageZ Property

The average Z in meters.

Public Property AverageZ As Double

public double AverageZ {get; set;}

Remarks

When performing ortho-rectification, a source of elevation data is required. This is often a digital elevation model (DEM) dataset. If a DEM is not available, the average elevation in the area of interest must be set for best results.

IFrameXform.EarthRadius Property

The earth radius in meters.

Public Property EarthRadius As Double

public double EarthRadius {get; set;}

IFrameXform.EnableKonrady Property

Indicates if the Konrady adjustment to be applied.

Public Property EnableKonrady As Boolean

public bool EnableKonrady {get; set;}

Remarks

This parameter controls whether radial distortion correction is performed or not. If the corrections were applied during post-processing of the images, set this value to false. Otherwise, provide the Konrady coefficients. Be sure to set the correct Konrady type (ESRI or USGS) that corresponds to the coefficients.

IFrameXform.FocalLength Property

The focal length in micron.

Public Property FocalLength As Double

public double FocalLength {get; set;}

IFrameXform.GetDistortionTable Method

The distortion tables.

Public Sub GetDistortionTable ( _
    ByRef ppDistanceInMillimeters As IDoubleArray, _
    ByRef ppDistortionInMicrons As IDoubleArray _
)

public void GetDistortionTable (
    ref IDoubleArray ppDistanceInMillimeters,
    ref IDoubleArray ppDistortionInMicrons
);

IFrameXform.InteriorOrientation Property

The interior orientation as an affine transformation.

Public Property InteriorOrientation As IGeodataXform

public IGeodataXform InteriorOrientation {get; set;}

IFrameXform.KonradyParameters Property

The Konrady adjustment parameters.

Public Property KonradyParameters As Object

public object KonradyParameters {get; set;}

Remarks

Konrady coefficients are used to correct radial distortions in standard frame cameras. Three double precision values are stored and used when displaying the imagery. See the ESRIRasterKonradyType enumeration values to see how these coefficients are applied.

IFrameXform.KonradyType Property

The Konrady calculation method.

Public Property KonradyType As esriRasterKonradyType

public esriRasterKonradyType KonradyType {get; set;}

Description

ArcMap supports two conventions used for correcting radial distortions in standard frame cameras. They are represented by the enumeration values ESRIRasterKonradyESRI and ESRIRasterKonradyUSGS.

Both use a power series to calculate the percent error. The ESRI method uses second and fourth powers, while the USGS method uses third and fifth powers. See the enumeration ESRIRasterKonradyType for more information.

IFrameXform.LSR Property

The LSR-To-USR conversion.

Public Property LSR As IGeodataXform

public IGeodataXform LSR {get; set;}

IFrameXform.PerspectiveCenter Property

The sensor position.

Public Property PerspectiveCenter As IPoint

public IPoint PerspectiveCenter {get; set;}

IFrameXform.PerspectiveMatrix Property

The specified sensor orientation as an orthogonal rotation matrix.

Public Property PerspectiveMatrix As Object

public object PerspectiveMatrix {get; set;}

Remarks

The perspective matrix is a 3x3 rotation matrix that adjusts the imagery based on the three perspective angles associated with an image frame. The three angles represent the roll, pitch and yaw of the aircraft (omega, phi, kappa) when the exposure was taken.

There are two ways to set the perspective matrix: put_PerspectiveMatrix( ) and PutPerspectiveAngles( ). Both methods populate the 3x3 rotation matrix. The choice of which to use is largely based on what information is available in the aerial photography project file.

IFrameXform.PerspectivePolarity Property

The sensor polarity.

Public Property PerspectivePolarity As Integer

public int PerspectivePolarity {get; set;}

Remarks

An optional parameter that defines the direction of the Z axis. The default value is -1, and should only be changed for sensor that use that convention.

IFrameXform.PrincipalPoint Property

The film principal point.

Public Property PrincipalPoint As IPoint

public IPoint PrincipalPoint {get; set;}

IFrameXform.PutDistortionTable Method

The distortion tables to calculate Konrady coefficients and residuals.

Public Sub PutDistortionTable ( _
    ByVal pDistanceInMillimeters As IDoubleArray, _
    ByVal pDistortionInMicrons As IDoubleArray _
)

public void PutDistortionTable (
    IDoubleArray pDistanceInMillimeters,
    IDoubleArray pDistortionInMicrons
);

Remarks

An alternative to put_KonradyParameters, this method allows the use of the distortion tables contained in the camera calibration report to calculate the Konrady coefficients. It is critical to ensure that the units are correct for the two arrays that are passed in. The first array is the radial distance in mm, while the second array is the distortion errors in microns. Either ESRI or USGS conventions can be used to calculate the coefficients. See the ESRIRasterKonradyType enumeration for more details.

IFrameXform.PutInteriorOrientationParameters Method

Puts the interior orientation parameters.

Public Sub PutInteriorOrientationParameters ( _
    ByVal direction As esriTransformDirection, _
    ByVal Parameters As Object _
)

public void PutInteriorOrientationParameters (
    esriTransformDirection direction,
    object Parameters
);

Remarks

See putref_InteriorOrientation for more details.

IFrameXform.PutPerspectiveAngles Method

Puts the sensor exterior orientation as a set of rotation angles in degrees.

Public Sub PutPerspectiveAngles ( _
    ByVal omega As Double, _
    ByVal phi As Double, _
    ByVal kappa As Double, _
    ByVal clockwise As Boolean _
)

public void PutPerspectiveAngles (
    double omega,
    double phi,
    double kappa,
    bool clockwise
);

Remarks

An alternative to put_PerspectiveMatrix( ) for establishing the rotation matrix.

IFrameXform.QueryKonradyParameters Method

Queries the Konrady adjustment parameterrs.

Public Sub QueryKonradyParameters ( _
    ByRef pK As Double _
)

public void QueryKonradyParameters (
    ref double pK
);

IFrameXform.QueryPerspectiveAngles Method

Queries the sensor exterior orientation as a set of rotation angles in degrees.

Public Sub QueryPerspectiveAngles ( _
    ByRef pOmega As Double, _
    ByRef pPhi As Double, _
    ByRef pKappa As Double, _
    ByRef pClockwise As Boolean _
)

public void QueryPerspectiveAngles (
    ref double pOmega,
    ref double pPhi,
    ref double pKappa,
    ref bool pClockwise
);

IFrameXform.QueryPerspectiveMatrix Method

Queries the perspective matrix.

Public Sub QueryPerspectiveMatrix ( _
    ByRef pMatrix As Double _
)

public void QueryPerspectiveMatrix (
    ref double pMatrix
);

IFrameXform.Residuals Property

The residuals for distortion table points.

Public ReadOnly Property Residuals As IDoubleArray

public IDoubleArray Residuals {get;}

Remarks

After using the distortion table to calculate the Konrady coefficients, it is important to check the residuals to detect if any anomalies, for instance an error when inputing the data values. Under normal circumstances, the residuals should be just a few microns. Larger residuals could indicate a problem with the data points.

Inherited Interfaces

Interfaces	Description
IGeodataXform	Provides access to members that control geodata transformation.

Classes that implement IFrameXform

Classes	Description
FrameXform	A standard frame camera model transformation class.

Remarks

Use this interface to set and query parameters associated with a standard frame camera. Many of the parameters are required, and there are multiple ways to set some of these. See the documentation for each parameter for more details.

The required parameters are:

Interior orientation

Principal point

Focal length

Perspective center

Perspective matrix or perspective angles

Average Z or a DEM

Konrady coefficients if radial distortion correction is needed