= 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