= 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]]


{{{
 ~/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

}}}

== Output ==

 * [[PICTLIST.TXT]]
 * [[NOMINALS]] - nominal navigation information and uncertainties
 * [[SUMFILES]] - camera properties and navigation information



== Example for Mercator Mission ==

 * Image name (the name of the image in pgm format, and stored in [NEW_IMAGES])  
{{{ 
 A1_05
}}}

 * Image time  
{{{ 
 410256.22608  (this is GPS time, but sometimes UTC is used)
}}}

 * Camera Location   
{{{ 
 31.69495, -110.62658, 17716.61873  (for Mercator, this is Lat/Lon and altitude of the aircraft)
}}}

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