= make_sumfiles =

Compiled by KD

== Description ==
In general, make_sumfiles ingests images into SPC.  It takes in, as a standard input, the name and camera position of the images from [[make_sumfiles.in]].  It will convert the image into the <filename>.DAT format in [[IMAGEFILES]].  It will also generate <filename>.SUM in [[SUMFILES]] and <filename>.NOM in [[NOMINALS]].  Finally, it will append the image name onto [[PICTLIST.TXT]]. 

In other words, make_sumfiles builds the sumfiles and nominals. The user should know that 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 [[shift]] will have to be used eventually). Furthermore, for make_sumfiles to work, the ck and spk kernel names in [[make_sumfiles.txt]] must cover the time span of all the images being ingested.

This program is non-standard.  While the goal is to make a single version that does it all, each mission has a different image format.  This program frequently has different versions for different missions to get the data in a form usable by SPC.

== Input Files ==
 * Spice kernel file (SPICE)
 * [[make_sumfiles.txt]] - list of SPICE kernels
 * [[make_sumfiles.in]]  - list of files from [[process_img]]

== Input stdin ==
{{{
 ~/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
}}}

 * if 0 is selected - routine does as description suggests and ends 
 * if 1 is selected - routine does as description suggests and ends 
 * if 2 is selected - the following questions need to be answered:
{{{
Update UTC? (y/n)
Update image thresholds? (y/n)
Update camera parameters? (y/n)
Reset geometry? (y/n)
Reset sigmas? (y/n)
}}}
== Output ==

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

== 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).