make_sumfiles.txt

Description

This configuration 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.

4                                                         NCAM
'ORX_OCAMS_MAPCAM'
1024  1024                                                NPXB, NLNB
125.0  512.5  512.5                                       MMFLB, PX0B, LN0B
117.647, 0, 0, 0, 117.647, 0                              KMATB
 -1, -2, 3                                                  PROJECT CAMERA AXES
5, 16383                                                  T1,T2
'ORX_OCAMS_SAMCAM'
1024  1024                                                NPXC, NLNC
24.0  512.5  512.5                                        MMFLC, PX0C, LN0C
117.647, 0, 0, 0, 117.647, 0                              KMATC
 1, 2, 3                                                  PROJECT CAMERA AXES
5, 16383                                                    T1,T2
'ORX_OCAMS_POLYCAM'
1024  1024                                                NPXA, NLNA
611.0  512.5  512.5                                       MMFLA, PX0A, LN0A
117.647, 0, 0, 0, 117.647, 0                              KMATA
 -1, -2, 3                                                  PROJECT CAMERA AXES
5, 16383                                                     T1,T2
'ORX_NAVCAM'
2592   1944                                               NPXC, NLNC
7.6  1296.5 972.5                                         MMFLC, PX0C, LN0C
454.54, 0, 0, 0, 454.54, 0                                KMATC
 1, 2, 3                                                 PROJECT CAMERA AXES
5, 4096                                                    T1,T2
1                                                         NSC
-64                                                       ORX
1.d0  1.d0  1.d0                                          sigV0
1.d-3  1.d-3  1.d-3                                       sigPT
2101955                                                   BENNU
'IAU_BENNU'                                               BFRAME
'NONE'                                                    ABCORR
'../ORex/DATA/'                    PREFIX
KERNELS
sb-101955-76.bsp
bennu_v10.tpc
de421.bsp
naif0011.tls
orex_ocams_v02.ti
orx_aux_v01.ti
orx_v03.tf
pck00010.tpc
ApproachPrelim_Perturbed.bsp
DetailedSurvey_Perturbed.bsp
OrbitalB_Perturbed.bsp
ORX_SCLKSCET.00000.example.tsc
F3A_AllObs_20181109T000000_20181118T000000_Perturbed.bc
F3A_BD_AllObs_20190113T000000_20190122T120000_p.bc
F3A_ES_Obs1_20190127T094200_20190127T161200_p.bc
F3A_ES_Obs2_20190203T094300_20190203T161300_p.bc
F3A_ES_Obs3_20190210T100500_20190210T163500_p.bc
...
END_KRNLS

Description of codes

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]

The PROJECT CAMERA AXIS relates to how the camera is mounted to the spacecraft (it's orientation). I *think* this could be handled by frame kernels, but it isn't done that way right now. Thus, we have to put in a camera orientation matrix. From my testing, it appears that there are 4 orientations that valid.

• 1 2 3
• -1 -2 3
• -2 1 3
• 2 -1 3

Target Information

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). Additional questions can be answered by referencing NAIF's SPICE website. http://naif.jpl.nasa.gov

• 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:

Figure 00: Illustration of make_sumfiles.txt File with Explanations

(Compiled by KD)

CategoryFiles CategoryInputFiles