Differences between revisions 11 and 13 (spanning 2 versions)
⇤ ← Revision 11 as of 2016-01-27 14:35:47 →
Size: 2819
Editor: tcampb
Comment:
← Revision 13 as of 2016-02-16 19:26:59 → ⇥
Size: 4489
Editor: CoralieJackman
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:

Compiled by KD		  . (./) check this: Need to update PICTLISTR.TXT input file. Need to specify required files/directories to run. needs SUMFILES, NOMINALS, make_sumfiles.txt, etc
Line 7: Line 6:
This program generates a set of ascii interface files, one for each image, containing optical navigation observables, partials, and relevant ancillary information for use in the FDS navigation software suite(s). Both MIRAGE (KinetX) and GEODYN (GSFC) are currently ingesting these files. A file is created for each image in the restricted picture list, PICTLISTR.TXT, and only landmarks from a restricted landmark list, LMRKLISTR.TXT, are used. If the PICTLISTR.TXT file does not exist, the software defaults to PICTLIST.TXT. Each files contains the following information:
Line 8: Line 8:
The program regres takes position and SPICE file information from SPC and puts it in files for export to other users. Specifically, that other user has mainly been KinetX so they can use SPC info in their navigation software.  * SPICE IDs, image epoch, camera parameters
 * TITV matrix (inertial to camera frame transformation)
 * TPMI matrix (body-fixed to inertial transformation)
 * SPC solution for:
  * Spacecraft-to-object vector
  * Camera pointing (RA, Dec, Twist)
  * Spacecraft position sigma
  * Camera pointing and twist sigmas
 * Nominal (a priori):
  * Spacecraft-to-object vector
  * Camera pointing (RA, Dec, Twist)
  * Solar unit vector
 * For each landmark identified in the image from SPC process:
  * Landmark name
  * Body-fixed control point vector
  * Body-fixed control point sigma
  * Observed landmark center in (pixel, line) image coordinates
  * Predicted landmark center in (pixel, line) image coordinates based on nominal S/C position and SPC solution for camera pointing
  * Partial derivatives for (pixel, line) w.r.t. spacecraft-body position vector (SCOBJ)
  * Partial derivatives for (pixel, line) w.r.t. camera pointing (RA, Dec, Twist)
 * List of all SPICE kernels used
Line 10: Line 30:
For regres to run, a directory called "REGRES_FILES" needs to be made in the working directory. When regres is then run, export files for each picture are made (<PICTURE NAME>.TXT) and placed in the REGRES_FILES directory. '''regres''' requires the directory "REGRES_FILES" in the working directory. '''regres''' exports files for each picture (<PICTURE NAME>.TXT) to the "REGRES_FILES" directory.
Line 12: Line 32:
All pictures in [[PICTLIST.TXT]] will be used to make the exported regres files along with landmarks in [[LMRKLISTR.TXT]]. However, if a [[PICTLISTR.TXT]] has been made, regres will only use the pictures from that file when making the exported regres files. '''regres''' uses all pictures in [[PICTLIST.TXT]] and landmarks in [[LMRKLISTR.TXT]] to make the exported regres files. However, if you have created a [[PICTLISTR.TXT]], '''regres''' will only use the pictures from that file.
Line 14: Line 34:
== Input Files == '''regres''' uses data from NOMINAL

=== Input Files ===
Line 17: Line 39:
 * [[NOMINALS]]/
 * [[SUMFILES]]/
 * [[INIT_LITHOS.TXT]]
 * [[make_sumfiles.txt]]
Line 18: Line 44:
== Output Files ==
 * <path to working directory>/REGRES_FILES/<pixture name>.TXT		 === Output Files ===
 * <path to working directory>/REGRES_FILES/<picture name>.TXT
Line 21: Line 47:
== Using regres ==
Here is an annotated sample output file from '''regres''':
Line 22: Line 50:
== Exported File Information ==
Line 73: Line 100:
C [list of all spice kernels used] C                            [list of all spice kernels used]
Line 77: Line 104:
----------
''(Compiled by KD)''

CategoryPrograms

regres

  • (./) check this: Need to update PICTLISTR.TXT input file. Need to specify required files/directories to run. needs SUMFILES, NOMINALS, make_sumfiles.txt, etc

Description

This program generates a set of ascii interface files, one for each image, containing optical navigation observables, partials, and relevant ancillary information for use in the FDS navigation software suite(s). Both MIRAGE (KinetX) and GEODYN (GSFC) are currently ingesting these files. A file is created for each image in the restricted picture list, PICTLISTR.TXT, and only landmarks from a restricted landmark list, LMRKLISTR.TXT, are used. If the PICTLISTR.TXT file does not exist, the software defaults to PICTLIST.TXT. Each files contains the following information:

  • SPICE IDs, image epoch, camera parameters
  • TITV matrix (inertial to camera frame transformation)
  • TPMI matrix (body-fixed to inertial transformation)
  • SPC solution for:
    • Spacecraft-to-object vector
    • Camera pointing (RA, Dec, Twist)
    • Spacecraft position sigma
    • Camera pointing and twist sigmas
  • Nominal (a priori):
    • Spacecraft-to-object vector
    • Camera pointing (RA, Dec, Twist)
    • Solar unit vector
  • For each landmark identified in the image from SPC process:
    • Landmark name
    • Body-fixed control point vector
    • Body-fixed control point sigma
    • Observed landmark center in (pixel, line) image coordinates
    • Predicted landmark center in (pixel, line) image coordinates based on nominal S/C position and SPC solution for camera pointing
    • Partial derivatives for (pixel, line) w.r.t. spacecraft-body position vector (SCOBJ)
    • Partial derivatives for (pixel, line) w.r.t. camera pointing (RA, Dec, Twist)
  • List of all SPICE kernels used

regres requires the directory "REGRES_FILES" in the working directory. regres exports files for each picture (<PICTURE NAME>.TXT) to the "REGRES_FILES" directory.

regres uses all pictures in PICTLIST.TXT and landmarks in LMRKLISTR.TXT to make the exported regres files. However, if you have created a PICTLISTR.TXT, regres will only use the pictures from that file.

regres uses data from NOMINAL

Input Files

Output Files

  • <path to working directory>/REGRES_FILES/<picture name>.TXT

Using regres

Here is an annotated sample output file from regres: 

REGRES FILE.  CREATED           [time of creation]
C            PARTIALS UNITS: PX/KM, PX/DEG
C
C            CAMERA ID
C            SPACECRAFT ID
C            TARGET ID
C            ABCORR
C
C            UTC                             [Image time]
C            ET SEC PAST J2000
C
C            NPX, NLN                        [Image size ib pixels and lines]
C            MMFL, CTR                       [Camera focal length and image center]
C            K-MATRIX
C
C            TITV                            [Inertial to camera frame rotation]
C            TPMI                            [Body-fixed to inertial rotation]
C
C            LITHOS SOLUTION:
C
C                 SC - OBJ VECTOR
C                 CAMERA RA, DC, TW
C                 S/C POSITION SIG
C                 PNT SIGMA (DEG)
C                 TWIST SIGMA (DEG)
C
C            NOMINAL SOLUTION:
C
C                 SC - OBJ VECTOR
C                 CAMERA RA, DC, TW
C                 SOLAR UNIT VECTOR
C
C            LANDMARKS:                      [One for each landmark]
C
C                 BODY-FIXED VLM
C                 B-F VLM SIGMA              [Formal uncertainty in LM position]
C                 PX, LN OBSERVED            [Landmark location in image]
C                 PX, LN PREDICTED           [Uses nominal scobj, solved pointing]
C                 dpx/dW1, dln/dW1
C                 dpx/dW2, dln/dW2           [Partials wrt scobj]
C                 dpx/dW3, dln/dW3
C                 dpx/dRA, dln/dRA
C                 dpx/dDC, dln/dDC           [Partials wrt pointing Euler angles]
C                 dpx/dTW, dln/dTW
C
C             END LANDMARKS
C
C             KERNEL LIST
C
C                                            [list of all spice kernels used]
C
C             END FILE

(Compiled by KD)

CategoryPrograms

regres (last edited 2017-12-21 15:43:15 by EricPalmer)