Differences between revisions 2 and 29 (spanning 27 versions)
Revision 2 as of 2013-02-04 15:57:57
Size: 1677
Comment:
Revision 29 as of 2016-02-10 19:50:55
Size: 4631
Editor: BMittan
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
== Description ==
Line 4: Line 5:
This text file is created by [[residuals]] to report on bad landmarks.
Line 5: Line 7:
 * The name of a landmark
 * The error for each image.
 No huge numbers of NaN
'''RESIDUALS.TXT''' captures and reports three types of information:
Line 9: Line 9:
  T has a map with it
  F flat landmark, no image
 landmark, resolution, lat, lon, radius
 
 (List)
   Image name, pix residual, line residual (actual and solution should be), magnitude, km residual
   Mostly they are there for historical res
 * The post-fit residuals between predicted and actual control point positions in all images.
 * The post-fit residuals between predicted and actual control point difference between adjacent, overlapping maplets.
 * Outliers in both quantities are flagged automatically based on input threshold criteria.
Line 17: Line 13:
 (Bottom)
    Meter resolution, difference between predicted and actual

 (Very bottom)
    Observations how many things
    RMS Residual (m) (vector residual)
Here is a sample '''RESIDUALS.TXT''' file. Elements of the data in each of the four sections are explained below.
Line 27: Line 17:
IA1_01 T 0.0200 56.5481 140.8124 13.6146 IA1_01 T 0.0200 56.5481 140.8124 13.6146             <- Section 1
Line 29: Line 19:
    A1_01 8.139 -6.853 10.640 0.01091     A1_01 8.139 -6.853 10.640 0.01091        <- Section 2
Line 33: Line 23:
IA1_01 42.78 IA1_01 42.78 <- Section 3
Line 50: Line 40:

 Observation # = 360180 <- Section 4

 RMS Residual (m) = 0.78928860594347106
Line 51: Line 46:

== Section 1 ==

Row between the dot rows includes:
 * '''col 1''' - The name of a landmark
 * '''col 2''' - T = landmark has a map with it; F = flat landmark, no image
 * '''col 3''' - Resolution
 * '''col 4''' - Lat of landmark
 * '''col 5''' - Wlon of landmark
 * '''col 6''' - Radius

== Section 2 ==

Rows below the second dot row with the landmark name above include:
  * For each image:
   * '''col 1''' - picture name
   * '''col 2''' - PX residual (# of pixels in image resolution)
   * '''col 3''' - LN residual (# of pixels in image resolution)
   * '''col 4''' - magnitude of PX and LN residuals (# of pixels in image resolution)
   * '''col 5''' - the estimate linear residual (km)
  * For each overlap:
   * '''col 1''' - overlap name
   * '''col 2''' - X residual (km)
   * '''col 3''' - Y residual (km)
   * '''col 4''' - Z residual (km)
   * '''col 5''' - estimate linear residual (km)
  * For each limb apperation:
   * '''col 1''' - picture name
   * '''col 2''' - PX residual (# of pixels in image resolution)
   * '''col 3''' - LN residual (# of pixels in image resolution)
   * '''col 4''' - magnitude of PX and LN residuals (# of pixels in image resolution)
   * '''col 5''' - the estimate linear residual (km)
== Section 3 ==

Row below the images, overlaps, and limbs list for a landmark includes:
  * '''col 1' - landmark name
  * '''col 2' - magnitude of RMS linear residual for landmark

== Section 4 ==
Rows below the single dot row at the very bottom for each image includes:
  * Observations - how many IMAGEFILES, overlaps, and limbs for all landmarks
  * RMS RESIDUAL - overall RMS linear residual in meters.

Residuals are the difference between observed landmark positions and those predicted by the solution (SPC).

Observed landmark positions are positions of a landmark calculated by the code when it inputs pictures from the spacecraft of the object.

Predicted landmark positions are those calculated by SPC. When it inputs, it generates a solution (map) from all the pictures collected.

During iteration and refinement of the SPC solution, the position and attitude of the spacecraft are slightly changed over and over until the maps match the images as best they can. At the end of each iteration, [[SUMFILES]] are then updated for the new attitude and position.

When the RMS between landmark residuals is as low as possible, the maps match the images well. This means that the updated [[SUMFILE]] is the new estimate for spacecraft position and attitude.

----------

''(Compiled by KD)''

CategoryFiles CategoryOutputFiles

RESIDUALS.TXT

Description

This text file is created by residuals to report on bad landmarks.

RESIDUALS.TXT captures and reports three types of information:

  • The post-fit residuals between predicted and actual control point positions in all images.
  • The post-fit residuals between predicted and actual control point difference between adjacent, overlapping maplets.
  • Outliers in both quantities are flagged automatically based on input threshold criteria.

Here is a sample RESIDUALS.TXT file. Elements of the data in each of the four sections are explained below.

..................................................
IA1_01 T      0.0200     56.5481    140.8124     13.6146             <- Section 1
..................................................
    A1_01                 8.139    -6.853    10.640   0.01091        <- Section 2
    A2_05               -28.427    49.215    56.835   0.04250
    B1_01                -3.517    52.347    52.465   0.04857
    B1_03               -18.475   -57.091    60.006   0.05509
IA1_01     42.78                                                     <- Section 3

..................................................
IA1_03 T      0.0200     36.4771    136.8269     11.4593
..................................................
    A1_03               -29.498   -12.161    31.906   0.04002
    A2_03               -71.840    23.961    75.731   0.07142
    A2_04                -3.885    -4.689     6.089   0.00643
    A2_05               -34.754    95.249   101.392   0.10527
    B1_01                64.895   -21.470    68.354   0.07337
    B1_03                11.000    59.329    60.340   0.06832
    B2_04                97.637    29.005   101.855   0.11002
    B2_05                42.109    41.562    59.165   0.07455
IA1_03     75.45


.........

 Observation # =       360180                                        <- Section 4

 RMS Residual (m) =   0.78928860594347106

Section 1

Row between the dot rows includes:

  • col 1 - The name of a landmark

  • col 2 - T = landmark has a map with it; F = flat landmark, no image

  • col 3 - Resolution

  • col 4 - Lat of landmark

  • col 5 - Wlon of landmark

  • col 6 - Radius

Section 2

Rows below the second dot row with the landmark name above include:

  • For each image:
    • col 1 - picture name

    • col 2 - PX residual (# of pixels in image resolution)

    • col 3 - LN residual (# of pixels in image resolution)

    • col 4 - magnitude of PX and LN residuals (# of pixels in image resolution)

    • col 5 - the estimate linear residual (km)

  • For each overlap:
    • col 1 - overlap name

    • col 2 - X residual (km)

    • col 3 - Y residual (km)

    • col 4 - Z residual (km)

    • col 5 - estimate linear residual (km)

  • For each limb apperation:
    • col 1 - picture name

    • col 2 - PX residual (# of pixels in image resolution)

    • col 3 - LN residual (# of pixels in image resolution)

    • col 4 - magnitude of PX and LN residuals (# of pixels in image resolution)

    • col 5 - the estimate linear residual (km)

Section 3

Row below the images, overlaps, and limbs list for a landmark includes:

  • col 1' - landmark name

  • col 2' - magnitude of RMS linear residual for landmark

Section 4

Rows below the single dot row at the very bottom for each image includes:

  • Observations - how many IMAGEFILES, overlaps, and limbs for all landmarks
  • RMS RESIDUAL - overall RMS linear residual in meters.

Residuals are the difference between observed landmark positions and those predicted by the solution (SPC).

Observed landmark positions are positions of a landmark calculated by the code when it inputs pictures from the spacecraft of the object.

Predicted landmark positions are those calculated by SPC. When it inputs, it generates a solution (map) from all the pictures collected.

During iteration and refinement of the SPC solution, the position and attitude of the spacecraft are slightly changed over and over until the maps match the images as best they can. At the end of each iteration, SUMFILES are then updated for the new attitude and position.

When the RMS between landmark residuals is as low as possible, the maps match the images well. This means that the updated SUMFILE is the new estimate for spacecraft position and attitude.


(Compiled by KD)

CategoryFiles CategoryOutputFiles

RESIDUALS.TXT (last edited 2018-01-11 14:20:47 by LeilahMcCarthy)