Isis 3 Application Documentation
Update camera pointing for a single image
Description
This program can be used to update camera pointing (SPICE) for a single cube. The user must supply a latitude/longitude for a single sample/line coordinate in the image. The right ascension
and declination of the camera will be adjusted to match this request. In order for this program to work properly, the cube must have been initialized with the "spiceinit" program using
ATTACH="YES". Additionally, a second latitude/longitude and sample/line can be given to adjust for camera twist.
The camera pointing is updated using an iterative least-squares bundle adjustment. The number of iterations and tolerance for convergence are input parameters to this program. Solving for the
right ascension and declination only is similar to a translation of the image. Solving for the twist includes both translation and rotation.
Categories
Applications
History
| Jeff Anderson | 2006-09-06 |
Original version
|
| Tracie Sucharski | 2007-05-02 |
Added inclusion of TWIST to SAMP2,LINE2,LAT2,LON2,RAD2.
Without this inclusion, the AML was requiring these parameters
even if TWIST was false.
|
| Debbie A. Cook | 2007-07-12 |
Added pvl status report for a successful update.
|
| Steven Koechle | 2007-10-05 |
Added check to see if cube has existing polygon, if so delete it.
|
|
Parameter Groups
Files
|
Name
|
Description
|
| FROM |
Input camera cube
|
Bundle Adjustment Options
|
Name
|
Description
|
| MAXITS | Number of iterations |
| TOL | Tolerance |
| TWIST | Solve for camera twist |
Ground Points
|
Files:
FROM
Description
The file specification for the input cube. The cube will have
camera pointing updated.
|
Type
| cube |
|
File Mode
| input |
|
Filter
|
*.cub
|
Bundle Adjustment Options:
MAXITS
Description
Maximum number of iterations to try for convergence to tolerance before stopping
Bundle Adjustment Options:
TOL
Description
Tolerance in pixels. When the bundle adjustment error drops below this value the solution has converged and
the camera pointing will be updated. If the solution does not converge in MAXITS then the camera pointing will
not be updated.
Bundle Adjustment Options:
TWIST
Description
In addition to right ascension and declination, If this parameter is set, the program will solve for the camera twist. This requires input of a second ground coordinate (SAMP2,LINE2) and
(LAT2,LON2)
|
Type
| boolean |
|
Default
| False |
|
Inclusions
|
- LINE2
- SAMP2
- LAT2
- LON2
- RAD2
|
Ground Points:
SAMP1
Description
The sample coordinate for ground point #1 (LAT1,LON1)
Ground Points:
LINE1
Description
The line coordinate for ground point #1 (LAT1,LON1)
Ground Points:
LAT1
Description
Planetocentric latitude at the image coordinate (SAMP1,LINE1)
|
Type
| double |
|
Minimum
| -90.0
(inclusive)
|
|
Maximum
| 90.0
(inclusive)
|
Ground Points:
LON1
Description
Planetocentric longitude at the image coordinate (SAMP1,LINE1)
|
Type
| double |
|
Minimum
| 0.0
(inclusive)
|
|
Maximum
| 360.0
(inclusive)
|
Ground Points:
RAD1
Description
Radius in meters at the image coordinate (SAMP1,LINE1). It will be automatically computed using the shape model that
was initialized during the "spiceinit" program, either an ellipsoid or a DEM.
|
Type
| double |
|
Internal Default
| Computed |
|
Minimum
| 0.0
(exclusive)
|
Ground Points:
SAMP2
Description
The sample coordinate for ground point #2 (LAT2,LON2)
Ground Points:
LINE2
Description
The line coordinate for ground point #2 (LAT2,LON2)
Ground Points:
LAT2
Description
Planetocentric latitude at the image coordinate (SAMP2,LINE2)
|
Type
| double |
|
Minimum
| -90.0
(inclusive)
|
|
Maximum
| 90.0
(inclusive)
|
|
Inclusions
|
|
Ground Points:
LON2
Description
Planetocentric longitude at the image coordinate (SAMP2,LINE2)
|
Type
| double |
|
Minimum
| 0.0
(inclusive)
|
|
Maximum
| 360.0
(inclusive)
|
|
Inclusions
|
|
Ground Points:
RAD2
Description
Radius in meters at the image coordinate (SAMP2,LINE2). It will be automatically computed using the shape model that
was initialized during the "spiceinit" program, either an ellipsoid or a DEM.
|
Type
| double |
|
Internal Default
| Computed |
|
Minimum
| 0.0
(exclusive)
|
|
Inclusions
|
|