make_sumfiles

Description

In general, this program ingests images into SPC, building the sumfiles and nominals.

make_sumfiles takes in the name and camera position of the images from make_sumfiles.in. The program then

converts the image into the <filename>.DAT format in IMAGEFILES
generates <filename>.SUM in SUMFILES and <filename>.NOM in NOMINALS
appends the image name onto PICTLIST.TXT

User Warnings

$/!\$ All the vectors in the sumfiles and nominals are in a body fixed frame with the origin at the center of the target body. The origin might be off a little bit, which means you may have to use shift eventually.
$/!\$ The ck and spk kernel names in make_sumfiles.txt must cover the time span of all the images being ingested. Otherwise, make_sumfiles will not work.
$/!\$ This program is non-standard. It frequently requires different versions for different missions to get the data in a form usable by SPC. Although the goal is to make a single version that does it all, each mission has a different image format.

Input Files

Spice kernel file (SPICE)
make_sumfiles.txt - list of SPICE kernels
make_sumfiles.in - list of files from process_fits

Output Files

IFRAME.TXT - picture properties
PICTLIST.TXT - list of pictures
NOMINALS - nominal navigation information and uncertainties
SUMFILES - camera properties and navigation information

Using make_sumfiles

The following sample shows the standard inputs and the list of options for make_sumfiles:

 ~/bin/e.make_sumfiles
 Use B-Frame? (y/n)
n
 0.  Create SUMFILES & NOMINALS and ..
 1.  Update old NOMINALS and ..
 2.  Update old SUMFILES
0

Do we need something about what "Use B-Frame" means and why to choose 'n'?

Enter the appropriate option:

0 Create SUMFILES & NOMINALS and .. - Completes both operations and ends.
1 Update old NOMINALS and .. - Completes NOMINALS operation and ends.
2 Update old SUMFILES - Issues the following prompts:
```
Update UTC? (y/n)
Update image thresholds? (y/n)
Update camera parameters? (y/n)
Reset geometry? (y/n)
Reset sigmas? (y/n)
```
Do we need descriptions (default or suggested choices?) for each of these and what happens?

Additional Reference

Alternative Description

Combines the converted image file with the image number, spacecraft state, spacecraft position & velocity and pointing information along with the associated calculated errors (Sigmas).

(Compiled by KD)

CategoryPrograms