|
Size: 2300
Comment:
|
Size: 2737
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| Compiled by KD | == Description == In general, this program ingests images into SPC, building the sumfiles and nominals. |
| Line 5: | Line 6: |
| == 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]]. |
''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]] |
| Line 8: | Line 11: |
| 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. | == User Warnings == |
| Line 10: | Line 13: |
| 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. | /!\ '''''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.''''' |
| Line 12: | Line 15: |
| == Input Files == | /!\ '''''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 === |
| Line 17: | Line 24: |
| == Input stdin == | === 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''': |
| Line 19: | Line 37: |
| ~/bin/e.make_sumfiles | ~/bin/e.make_sumfiles |
| Line 24: | Line 42: |
| 2. Update old SUMFILES | 2. Update old SUMFILES |
| Line 28: | Line 46: |
| * 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: {{{ |
(./) 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: {{{ |
| Line 38: | Line 61: |
| == Output == | |
| Line 40: | Line 62: |
| * [[IFRAME.TXT]] - picture properties * [[PICTLIST.TXT]] - list of pictures * [[NOMINALS]] - nominal navigation information and uncertainties * [[SUMFILES]] - camera properties and navigation information |
(./) Do we need descriptions (default or suggested choices?) for each of these and what happens? |
| Line 45: | Line 64: |
| == Alternative Description == | == Additional Reference == === Alternative Description === |
| Line 47: | Line 68: |
---------- ''(Compiled by KD)'' CategoryPrograms |
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
![/!\](/wiki/classic/img/alert.png "/!\")
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)