Model Class Function Manual (T-Z)


UPDATEROAO

| HOME | BACK |

Purpose

To update values of Relative Orientation Parameter (ROP) and Absolute Orientation Parameter (AOP) of a model.  This is required when a model is initialized by known EOP photos.  In this case, there is no need to perform RO or AO, and the orientation parameters of the model are obtained by using this function.

Class

Model

Usage

{void} object.UPDATEROAO()

Example:

->mod.init(ph1, ph2)

->mod.updateroao()

->

See also (class function)

RO, AO

| HOME | BACK |


VECGCP2XMYMZM

| HOME | BACK |

Purpose

To convert from a vector of x y z ground control point coordinates to a vector of x y z model coordinates.  The transformation is done by 3D conformal transformation using the current AOP (Absolute Orientation Parameters).

Class

Model

Usage

{VecPt3D} ret  =  object.VECGCP2XMYMZM({VecPt3D} argm1)

argm1 = list of x y z ground coordinates

Example:

->vec_xyz_model = mod.vecgcp2xmymzm(vec_xyz)

->

See also (class function)

vecxmymzm2gcp, vidxmymzm2gcp, vidgcp2xmymzm

| HOME | BACK |


VECRC2GCP

| HOME | BACK |

Purpose

To convert from row and column numbers, of a list of points on the left photo and its corresponding points on the right photo, to x y z ground control coordinates. 

This function requires that both photos in the model have EOPs.  The computation algorithm utilizes the Least Square adjustment technique.

Class

Model

Usage

{VecPt3D} ret  =  object.VECRC2GCP({VecPt2D} argm1, {VecPt2D} argm2)

argm1 = list of row and column numbers of points on the left photo

argm2 = list of row and column numbers of points on the right photo

Example:

->vec_xyz = mod.vecrc2gcp(vec_ind_left, vec_ind_right)

->

See also (class function)

vidrc2gcp

| HOME | BACK |


VECRC2XMYMZM

| HOME | BACK |

Purpose

To convert from row and column numbers, of a list of points on the left photo and itscorresponding points on the right photo, to x y z model coordinates. 

This function requires that the model has done with RO.  The computation algorithm utilizes the Least Square adjustment technique.

Class

Model

Usage

{VecPt3D} ret  =  object.VECRC2XMYMZM({VecPt2D} argm1, {VecPt2D} argm2)

argm1 = list of row and column numbers of points on the left photo

argm2 = list of row and column numbers of points on the right photo

Example:

->vec_xyz = mod.vecrc2xmymzm(vec_ind_left, vec_ind_right)

->

See also (class function)

vidrc2xmymzm

| HOME | BACK |


VECXMYMZM2GCP

| HOME | BACK |

Purpose

To convert from a vector of x y z model coordinates to a vector of x y z ground control coordinates.  The transformation is done by 3D conformal transformation using the current AOP (Absolute Orientation Parameters).

Class

Model

Usage

{VecPt3D} ret  =  object.VECXMYMZM2GCP({VecPt3D} argm1)

argm1 = list of x y z model coordinate

Example:

->vec_xyz = mod.vecxmymzm2gcp(vec_xyz_model)

->

See also (class function)

vidxmymzm2gcp

| HOME | BACK |


VECXNYN2XPYP

| HOME | BACK |

Purpose

To convert from a vector of x y normalized photo coordinates to a vector of x y photo coordinates.  Normalized coordinates of corresponding points will have the same value of y-coordinates, hence no y-parallax.

Class

Model

Usage

{VecPt2D} ret  =  object.VECXNYN2XPYP({VecPt2D} argm1, {String} argm2)

argm1 = list of x y normalized photo coordinates

argm2 = side, must be "L" for left photo, or "R" for right photo

Example:

->vec_xy = mod.vecxnyn2xpyp(vec_xnyn, "r")

->

See also (class function)

vidxnyn2xpyp

| HOME | BACK |


VECXPYP2GCP

| HOME | BACK |

Purpose

To convert from x y photo coordinates, of a list of points on the left photo and its corresponding points on the right photo, to x y z ground control coordinates. 

This function requires that both photos in the model have EOPs.  The computation algorithm utilizes the Least Square adjustment technique.

Class

Model

Usage

{VecPt3D} ret  =  object.VECXPYP2GCP({VecPt2D} argm1, {VecPt2D} argm2)

argm1 = list of x y photo coordinates of points on the left photo

argm2 = list of x y photo coordinates of points on the right photo

Example:

->vec_xyz = mod.vecxpyp2gcp(vec_xy_left, vec_xy_right)

->

See also (class function)

vidxpyp2gcp

| HOME | BACK |


VECXPYP2XMYMZM

| HOME | BACK |

Purpose

To convert from x y photo coordinates, of a list of points on the left photo and its corresponding points on the right photo, to x y z model coordinates. 

This function requires that the model is done with RO.  The computation algorithm utilizes the Least Square adjustment technique.

Class

Model

Usage

{VecPt3D} ret  =  object.VECXPYP2XMYMZM({VecPt2D} argm1, {VecPt2D} argm2)

argm1 = list of x y photo coordinates of points on the left photo

argm2 = list of x y photo coordinates of points on the right photo

Example:

->vec_xyz = mod.vecxpyp2xmymzm(vec_xy_left, vec_xy_right)

->

See also (class function)

vidxpyp2xmymzm

| HOME | BACK |


VECXPYP2XNYN

| HOME | BACK |

Purpose

To convert from a vector of x y photo coordinates to a vector of x y normalized photo coordinates.  Normalized coordinates of corresponding points will have the same value of y-coordinates, hence no y-parallax.

Class

Model

Usage

{VecPt2D} ret  =  object.VECXPYP2XNYN({VecPt2D} argm1, {String} argm2)

argm1 = list of x y photo coordinates

argm2 = side, must be "L" for left photo, or "R" for right photo

Example:

->vec_xy_norm = mod.vecxpyp2xnyn(vec_xnyn, "r")

->

See also (class function)

vidxpyp2xnyn

| HOME | BACK |


VIDGCP2XMYMZM

| HOME | BACK |

Purpose

To convert from a vector of x y z ground control point coordinates to a vector of x y z model coordinates.  The transformation is done by 3D conformal transformation using the current AOP (Absolute Orientation Parameters).

Both input and output coordinates will have ID number.  This function will also determine standard deviation, using the law of error propagation.

Class

Model

Usage

{VecIdPt3D} ret  =  object.VIDGCP2XMYMZM({VecIdPt3D} argm1)

argm1 = list of x y z ground coordinates with ID and SD

Example:

->vec_xyz_model = mod.vidgcp2xmymzm(vec_xyz)

->

See also (class function)

vecxmymzm2gcp, vidxmymzm2gcp, vecgcp2xmymzm

| HOME | BACK |


VIDRC2GCP

| HOME | BACK |

Purpose

To convert from row and column numbers, of a list of points on the left photo and its corresponding points on the right photo, to x y z ground control coordinates. 

This function requires that both photos in the model have EOPs.  The computation algorithm utilizes the Least Square adjustment technique.

Both input and output coordinates will have ID number.  This function will also determine standard deviation, using the law of error propagation.

Class

Model

Usage

{VecIdPt3D} ret  =  object.VIDRC2GCP({VecIdPt2D} argm1, {VecIdPt2D} argm2)

argm1 = list of row and column numbers  with ID and SD of points on the left photo

argm2 = list of row and column numbers with ID and SD of points on the right photo

Example:

->vec_xyz = mod.vidrc2gcp(vec_ind_left, vec_ind_right)

->

See also (class function)

vidrc2gcp

| HOME | BACK |


VIDRC2XMYMZM

| HOME | BACK |

Purpose

To convert from row and column numbers, of a list of points on the left photo and itscorresponding points on the right photo, to x y z model coordinates. 

This function requires that the model has done with RO.  The computation algorithm utilizes the Least Square adjustment technique.

Both input and output coordinates will have ID number.  This function will also determine standard deviation, using the law of error propagation.

Class

Model

Usage

{VecIdPt3D} ret  =  object.VIDRC2XMYMZM({VecIdPt2D} argm1, {VecIdPt2D} argm2)

argm1 = list of row and column numbers with ID and SD of points on the left photo

argm2 = list of row and column numbers with ID and SD of points on the right photo

Example:

->vec_xyz = mod.vidrc2xmymzm(vec_ind_left, vec_ind_right)

->

See also (class function)

vecrc2xmymzm

| HOME | BACK |


VIDXMYMZM2GCP

| HOME | BACK |

Purpose

To convert from a vector of x y z model coordinates to a vector of x y z ground control coordinates.  The transformation is done by 3D conformal transformation using the current AOP (Absolute Orientation Parameters).

Both input and output coordinates will have ID number.  This function will also determine standard deviation, using the law of error propagation.

Class

Model

Usage

{VecIdPt3D} ret  =  object.VIDXMYMZM2GCP({VecIdPt3D} argm1)

argm1 = list of x y z model coordinate with ID and SD

Example:

->vec_xyz = mod.vidxmymzm2gcp(vec_xyz_model)

->

See also (class function)

vecxmymzm2gcp

| HOME | BACK |


VIDXNYN2XPYP

| HOME | BACK |

Purpose

To convert from a vector of x y normalized photo coordinates to a vector of x y photo coordinates.  Normalized coordinates of corresponding points will have the same value of y-coordinates, hence no y-parallax.

Both input and output coordinates will have ID number.  This function will also determine standard deviation, using the law of error propagation.

Class

Model

Usage

{VecIdPt2D} ret  =  object.VIDXNYN2XPYP({VecIdPt2D} argm1, {String} argm2)

argm1 = list of x y normalized photo coordinates with ID and SD

argm2 = side, must be "L" for left photo, or "R" for right photo

Example:

->vec_xy = mod.vidxnyn2xpyp(vec_xnyn, "r")

->

See also (class function)

vecxnyn2xpyp

| HOME | BACK |


VIDXPYP2GCP

| HOME | BACK |

Purpose

To convert from x y photo coordinates, of a list of points on the left photo and its corresponding points on the right photo, to x y z ground control coordinates. 

This function requires that both photos in the model have EOPs.  The computation algorithm utilizes the Least Square adjustment technique.

Both input and output coordinates will have ID number.  This function will also determine standard deviation, using the law of error propagation.

Class

Model

Usage

{VecIdPt3D} ret  =  object.VIDXPYP2GCP({VecIdPt2D} argm1, {VecIdPt2D} argm2)

argm1 = list of x y photo coordinates with ID and SD of points on the left photo

argm2 = list of x y photo coordinates with ID and SD of points on the right photo

Example:

->vec_xyz = mod.vidxpyp2gcp(vec_xy_left, vec_xy_right)

->

See also (class function)

vecxpyp2gcp

| HOME | BACK |


VIDXPYP2XMYMZM

| HOME | BACK |

Purpose

To convert from x y photo coordinates, of a list of points on the left photo and its corresponding points on the right photo, to x y z model coordinates. 

This function requires that the model is done with RO.  The computation algorithm utilizes the Least Square adjustment technique.

Both input and output coordinates will have ID number.  This function will also determine standard deviation, using the law of error propagation.

Class

Model

Usage

{VecIdPt3D} ret  =  object.VIDXPYP2XMYMZM({VecIdPt2D} argm1, {VecIdPt2D} argm2)

argm1 = list of x y photo coordinates with ID and SD of points on the left photo

argm2 = list of x y photo coordinates with ID and SD of points on the right photo

Example:

->vec_xyz = mod.vidxpyp2xmymzm(vec_xy_left, vec_xy_right)

->

See also (class function)

vecxpyp2xmymzm

| HOME | BACK |


VIDXPYP2XNYN

| HOME | BACK |

Purpose

To convert from a vector of x y photo coordinates to a vector of x y normalized photo coordinates.  Normalized coordinates of corresponding points will have the same value of y-coordinates, hence no y-parallax.

Both input and output coordinates will have ID number.  This function will also determine standard deviation, using the law of error propagation.

Class

Model

Usage

{VecIdPt2D} ret  =  object.VIDXPYP2XNYN({VecIdPt2D} argm1, {String} argm2)

argm1 = list of x y photo coordinates with ID and SD

argm2 = side, must be "L" for left photo, or "R" for right photo

Example:

->vec_xy_norm = mod.vidxpyp2xnyn(vec_xnyn, "r")

->

See also (class function)

vecxpyp2xnyn

| HOME | BACK |


VLOAD

| HOME | BACK |

Purpose

To virtually load a Model object, saved as Noobeed format.  The document file is read but not the data file of the left and right photo.  The function simply opens the data file and get ready to perform some functions. 

Please note that only a limited set of functions is available for a virtually loaded model.  Most orientation function such as "EO", "RO", "AO" etc., and all coordinate conversion functions, such as "rc2gcp", "xpyp2gcp", etc., do not require contents of the photo, therefore, it is fine to vertually load a model to perform such functions.  Working by this way can save a lot of memory and also can reduce a lot of computer time used in reading data.

Class

Model

Usage

{void} object.VLOAD({String} argm1)

argm1 = file name for the documentation file (default extension is ".txt")

Example:

->mol = Model()

->A.vload("my_photo")

photo virtually loaded...

photo virtually loaded...

model virtually loaded...

->

See also (class function)

load

| HOME | BACK |


XMYMZM2GCP

| HOME | BACK |

Purpose

To convert from an x y z model coordinate to a x y z ground control coordinate.  The transformation is done by 3D conformal transformation using the current AOP (Absolute Orientation Parameters).

Class

Model

Usage

{Pt3D} ret  =  object.VIDXMYMZM2GCP({double} argm1, {double} argm2, {double} argm3)

argm1 = x model coordinate

argm2 = y model coordinate

argm3 = z model coordinate

Example:

->gcp_xyz = mod.xmymzm2gcp(x, y, z)

->

See also (class function)

gcp2xmymzm

| HOME | BACK |


XNYN2XPYP

| HOME | BACK |

Purpose

To convert from an x y normalized photo coordinate to an x y photo coordinates.  Normalized coordinates of corresponding points will have the same value of y-coordinates, hence no y-parallax.

Class

Model

Usage

{Pt2D} ret  =  object.XNYN2XPYP({double} argm1, {double} argm2, {String} argm3)

argm1 = x normalized photo coordinates

argm2 = y normalized photo coordinates

argm3 = side, must be "L" for left photo, or "R" for right photo

Example:

->xy = mod.xnyn2xpyp(x, y, "r")

->

See also (class function)

vecxnyn2xpyp

| HOME | BACK |


XPYP2GCP

| HOME | BACK |

Purpose

To convert from an x y photo coordinate, a point on the left photo and its corresponding point on the right photo, to an x y z ground control coordinate. 

This function requires that both photos in the model have EOPs.  The computation algorithm utilizes the Least Square adjustment technique.

If the lens distortion flag, earth curvature flag, or refraction flag, is turn on (0=off 1 =on), then lens distortion, earth curvature effect and refraction effect, will be removed from the given photo coordinates prior to feed into the collinearity equation

Class

Model

Usage

{Pt3D} ret  =  object.XPYP2GCP({double} argm1, {double} argm2, {double} argm3, {double} argm4)

argm1 = x coordinate of points on the left photo

argm2 = y coordinate of points on the left photo

argm3 = x coordinate of points on the right photo

argm4 = y coordinate of points on the right photo

Example:

->gcp_xyz = mod.xpyp2gcp(20, -10, 100, -9.25)

->

See also (class function)

vecxpyp2gcp

| HOME | BACK |


XPYP2XMYMZM

| HOME | BACK |

Purpose

To convert from an x y photo coordinate, of a point on the left photo and its corresponding point on the right photo, to an x y z model coordinate. 

This function requires that the model is done with RO.  The computation algorithm utilizes the Least Square adjustment technique.

If the lens distortion flag, earth curvature flag, or refraction flag, is turn on (0=off 1 =on), then lens distortion, earth curvature effect and refraction effect, will be removed from the given photo coordinates prior to feed into the collinearity equation

Class

Model

Usage

{Pt3D} ret  =  object.XPYP2XMYMZM({double} argm1, {double} argm2, {double} argm3, {double} argm4)

argm1 = x coordinate of points on the left photo

argm2 = y coordinate of points on the left photo

argm3 = x coordinate of points on the right photo

argm4 = y coordinate of points on the right photo

Example:

->model_xyz = mod.xpyp2gcp(20, -10, 100, -9.25)

->

See also (class function)

vecxpyp2xmymzm

| HOME | BACK |


XPYP2XNYN

| HOME | BACK |

Purpose

To convert from an x y photo coordinate to an x y normalized photo coordinate.  Normalized coordinates of corresponding points will have the same value of y-coordinates, hence no y-parallax.

Class

Model

Usage

{Pt2D} ret  =  object.XPYP2XNYN({double} argm1, {double} argm2, {String} argm3)

argm1 = x photo coordinates

argm2 = y photo coordinates

argm3 = side, must be "L" for left photo, or "R" for right photo

Example:

->xy = mod.xpyp2xnyn(x, y, "r")

->

See also (class function)

vecxpyp2xnyn

| HOME | BACK |