Differences between revisions 2 and 10 (spanning 8 versions)
Revision 2 as of 2014-02-11 23:55:37
Size: 1897
Editor: EricPalmer
Comment:
Revision 10 as of 2016-02-09 14:22:45
Size: 4017
Editor: BMittan
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
== make_sumfiles.txt == = make_sumfiles.txt =
Line 3: Line 3:
This is a configure file that contains basic camera distortion data and a list of available SPICE kernels. As far as I can tell, it is created by hand. == Description ==
Line 5: Line 5:
It is used by ["make_sumfiles"] as a configuration file when generating ["SUMFILES"] and ["NOMINALS"] This configure file contains basic camera distortion data and a list of available SPICE kernels. It is used by [[make_sumfiles]] as a configuration file when generating [[SUMFILES]] and [[NOMINALS]]. At this time, '''make_sumfiles.txt''' is created by hand.

== Creating make_sumfiles.txt ==
Here is a sample '''make_sumfiles.txt" file'''. Annotations on the right indicate what the data elements are.
Line 28: Line 31:
'../ORex/DATA/' PREFIX
Line 35: Line 39:
...
END_KRNLS
Line 37: Line 43:
When processing ["make_sumfiles"]
 . If you get the "NOFRAMECONNECT" error (where it says, "At epoch...", then you likely need a CK Kernel (<filename>.bc).
 . If you get the "SPKINSUFFDATA" error (where it says, "Insufficient...", the you likely need a SPK Kernel (<filename>.bsp).
The '''make_sumfiles.txt''' file consists of three sections:

=== Camera Data Definitions ===
Enter the number of cameras that the file maintains (NCAM).
List the following for each camera:
  * Camera Name
  * Pixels (sample and rows)
  * Focal length, center pixel (x/y)
  * K Matrix - distortion matrix
  * Min and max expected DN for this data type
Enter sigV0 - The uncertainty of the spacecraft position [km]
Enter sigPt - The uncertainty of the camera pointing [Rad]

=== Target Information ===
 (./) didn't know what to call this "section"--is that heading good?

Enter the follow three rows:
 * the names of the ID of the target body
 * body fixed frame in the kernels
 * aberration correction desired

=== Kernel List ===

If the SPICE kernels are not in your working directory, give the path to the kernels (PREFIX).

Start the SPICE kernels list with these two rows:
 {{{
 KERNELS
 #
 }}}

List each kernel on a separate row.

 /!\ When in doubt, list all the available kernels.

Here is a list of kernels that are known to make [[make_sumfiles]] work:
 * '''SPK kernels (.bsp)''' - for spacecraft and target object - ephemeris
 * '''CK kernels (.bc)''' - orientation/attitude of spacecraft and other structures (like camera)
 * '''SCLK kernels (.tsc)''' - spacecraft clock coefficients
 * '''IK kernels (.ti)''' - instrument geometry for camera taking pictures
 * '''LSK kernels (.tls)''' - leap seconds
 * '''FK kernels (.tf)''' - reference frame specifications
 * '''PCK kernels (.tpc)''' - text form of planetary/asteroidal constants


End the kernels list with this row:
 {{{
 END_KRNLS
 }}}

When processing [[make_sumfiles]]
 . '''If you get the "NOFRAMECONNECT" error (display says, "At epoch...")''' - You likely need a CK Kernel (<filename>.bc).
 . '''If you get the "SPKINSUFFDATA" error (display says, "Insufficient...")''' - You likely need a SPK Kernel (<filename>.bsp).

== Additional Reference ==

Here is the same '''make_sumfiles.txt''' but with additional comments:

{{attachment:make_sumfiles.txt.jpg||width=700}}

----------
''(Compiled by KD)''

CategoryFiles

make_sumfiles.txt

Description

This configure file contains basic camera distortion data and a list of available SPICE kernels. It is used by make_sumfiles as a configuration file when generating SUMFILES and NOMINALS. At this time, make_sumfiles.txt is created by hand.

Creating make_sumfiles.txt

Here is a sample make_sumfiles.txt" file. Annotations on the right indicate what the data elements are.

2                                                         NCAM
'DAWN_FC1'
1024  1024                                                NPXA, NLNA
150.0664382826180  512.5  512.5                           MMFLA, PX0A, LN0A
71.4286, 0, 0, 0.003374864380978, -71.441109720651326, 0  KMATA
 0, 0, 0, 0                                               DA
400, 16383                                                T1,T2
'DAWN_FC2'
1024  1024                                                NPXB, NLNB
150.0732773452877  512.5  512.5                           MMFLB, PX0B, LN0B
71.4286, 0, 0, 0.003862501939093, -71.44341298478835, 0  KMATB
 0, 0, 0, 0                                               DB
400, 16383                                                T1,T2
1                                                         NSC
-203                                                      DAWN
2.d-1  2.d-1  2.d-1                                       sigV0
1.d-4  1.d-4  1.d-4                                       sigPT
2000004                                                   VESTA
'VESTA_FIXED'                                             BFRAME
'LT+S'                                                    ABCORR
'../ORex/DATA/'                                           PREFIX
KERNELS
#
naif0009.tls
dawn_fc_v01.ti
dawn_v05.tf
dawn_ceres_v00.tf
dawn_vesta_v00.tf
...
END_KRNLS

The make_sumfiles.txt file consists of three sections:

Camera Data Definitions

Enter the number of cameras that the file maintains (NCAM). List the following for each camera:

  • Camera Name
  • Pixels (sample and rows)
  • Focal length, center pixel (x/y)
  • K Matrix - distortion matrix
  • Min and max expected DN for this data type

Enter sigV0 - The uncertainty of the spacecraft position [km] Enter sigPt - The uncertainty of the camera pointing [Rad]

Target Information

  • (./) didn't know what to call this "section"--is that heading good?

Enter the follow three rows:

  • the names of the ID of the target body
  • body fixed frame in the kernels
  • aberration correction desired

Kernel List

If the SPICE kernels are not in your working directory, give the path to the kernels (PREFIX).

Start the SPICE kernels list with these two rows:

  •  KERNELS
     #

List each kernel on a separate row.

  • /!\ When in doubt, list all the available kernels.

Here is a list of kernels that are known to make make_sumfiles work:

  • SPK kernels (.bsp) - for spacecraft and target object - ephemeris

  • CK kernels (.bc) - orientation/attitude of spacecraft and other structures (like camera)

  • SCLK kernels (.tsc) - spacecraft clock coefficients

  • IK kernels (.ti) - instrument geometry for camera taking pictures

  • LSK kernels (.tls) - leap seconds

  • FK kernels (.tf) - reference frame specifications

  • PCK kernels (.tpc) - text form of planetary/asteroidal constants

End the kernels list with this row:

  •  END_KRNLS

When processing make_sumfiles

  • If you get the "NOFRAMECONNECT" error (display says, "At epoch...") - You likely need a CK Kernel (<filename>.bc).

  • If you get the "SPKINSUFFDATA" error (display says, "Insufficient...") - You likely need a SPK Kernel (<filename>.bsp).

Additional Reference

Here is the same make_sumfiles.txt but with additional comments:

make_sumfiles.txt.jpg


(Compiled by KD)

CategoryFiles

make_sumfiles.txt (last edited 2022-10-22 08:41:05 by EricPalmer)