WIKI for Bob Gaskell's StereoPC
This is an attempt to document of some of the key programs and support files for Stereo Photoclinometry. I've been taking pretty good notes, and I thought we could all share and benefit from what we each have learned. If you figure something out (or get help from Bob himself), be sure to post it. If you need help with the wiki, let me know (or just send me the info).
General_Parameters - Resolution scale, etc.
Questions_to_ask - When I talk to Bob, these are things I am wondering
Table_of_Contents_For_User's_Manual - We will come up with a table of contents for OSIRIS SPC. Here is where I will be putting my notes. Other's with suggestions are welcome. User Manual Author's Task List
Training_Notes - Eric's notes for what to introduce and how
SPC_V_and_V_testing - Directions and guideline for testing
Error_evaluation - How to evaluate things for error and consistancy
- 1.0 -- Initial version of SPC
- 2.0 -- Version of SPC with the Common library created
2.1A7 -- This is the baseline version of Gaskell's software. I has gone under SubComponent testing
- 3.0A1 -- Released by Bob in support of Dawn @ Ceres
- 3.0A1a -- Minor changes
- 3.1 -- (in progress) Will have all code improvements from Rosetta and include Polar Wobble. Will receive regression testing.
Procedures for Bennu
Making_new_landmarks - Workflow from the 50m resolution work done for Dawn at Vesta
Basic Tiling - Achieving the Desired Maplet Overlap - The bigmap.in file parameters to achieved the desired maplet overlap percentage.
LatLon_tiling - Tiling using Lat/Lon. Used for the initial sets of landmarks
Export_Import - Build landmarks on other machines and export them and import them
Fill_procedure -- Replace current topography with shape or bigmap. Fixes problems
Fixing_problem_landmarks -- Techniques to deal with landmarks that don't work well
When to Fix Landmarks - When?
Aligning to a Single Image -- What to do if initial image alignment shows no to very miniscule correlation.
Manually Moving An Image -- What to do when some images (that you want/need to use for building template) won't auto correlate.
Poor topography -- What to do when the topography is too poor for any alignment.
LITHOSP crashes -- How to recover without starting over
Obsolete Small_Footprint_Processing - Lets you do tiling copying only the files that you need for the specific task.
Scripts - from AAA.TXT
Fill - Take topography from a bigmap and replace a landmark's terrain with it.
Support Tools - useful tools that aid the SPC process
updateDisplay - aid for landmark/maplet visualization
lithos - aligns maplets to the current shape model and will provide slight changes to the shape (stored in MAPFILES)
geometry - figures out a surface based on landmarks
residuals.e - figures out a surface based on landmarks
register - aligns a new image with a reference, manually
autoregister - adds groups of landmarks to an image
autoregisterP - adds groups of landmarks to an image using parallel processing
blemishes - masks regions of an image which contain blemishes due to, for example, downlink errors, bad pixels, or a cosmic ray hit.
map_coverage.e - shows the coverage that has been processed by resolution
coverage.e - shows the global coverage that has been processed by resolution
image_map_rgb.e - Renders a 3D image of a bigmap using red and blue
view_shape.e - The generates a point-of-view image of the shape model
panaroma.e - Makes a 360 degree panaroma image from a big map
surface_imager.e - Makes an image using a surface point of view from a big map
display.e - Appears to generate an image that shows the location of landmarks on it
mosaic - Creates a mosaic of images registered to the shape model
Imager_MG - How to make images from maplets
bigmap - processes maplets to form a bigmap
spheremapB.e - This reads the Zmap files and makes the resulting map line by line.
update_infiles.e - generates a list of landmarks and headers for showing coverage
shape_info - generates DTM information
find_nofit - searches batch processing output files to identify landmarks or images which may need further work.
export.e - builds scripts to package up the new maplets/landmarks into a tar ball
importL.e - builds script to unpack maplets/landmarks and integrate into a master directory
Script Makers Overview - User guide for the script-maker program suite
make_scriptF - generic script maker for user-generated batch processing jobs.
refresh_sumfiles.e - updates the sumfiles to match the maplets
showmap.e - generates an image (.pgm) for a specific bigmap
pr_template - (copy the codes for when making a new prog page)
process_img - Takes a list of files and creates make_sumfiles.in. Creates IMAGEFILE for each images
make_sumfiles - Computes the SUMFILE and NOMINALS
make_tilefile - Generates the pixel/line maplet-center locations required to complete the tiling of a bigmap.
Sgrav.e - Makes a file called SGRAV.TXT that is like SHAPE.TXT but with extra columns for surface acceleration, potential and laplacian (just as a check). Based on a shape model. This is for a non-rotating body with GM=1.
Sslpa.e - ?
BIGFILES - Directory for BIGMAP LMK files
DATA - A place for the SPICE kernels
IMAGEFILES - Directory that holds the image files, .DAT
LMKFILES - Stores the actual landmarkts, .LMK
MAPFILES - Stores the maplets, .MAP
NEW_IMAGES - Directory that holds the new, and unprocessed image files (in pgm format)
NOMINALS - Directory that holds the sum files, .NOM
SHAPEFILES - Holds the different types of shapefiles
SUMFILES - Directory that holds the sum files, .SUM
TESTFILES - Directory to store display files generated during batch processing jobs.
TESTFILES1 - Directory to store display files generated during batch processing jobs.
UTILITIES - Programs that are specific for this project
Key Input Files
LMRKLIST.TXT - The full list of landmarks
PICTLIST.TXT - List of the images that are in the system
PICTLISTX.TXT - List of the images that are in the system with precomputed metadata.
SHAPE.TXT - The shape model of the object. Done is 3 column format of vertex using x, y, z coordinates
GEOID.TXT - gives the geoid in X, Y, Z position. A 3 column file.
SHAPEC.TXT - gives the height above the surface. A 4 column file.
make_sumfiles.in - List of new images to process
make_sumfiles.txt - SPICE references
IFRAME.TXT - Converts to J2000
MAPCHK.TXT - List of maplets whose difference between predicted and observed pixel/line locations in attached images is greater than a user-specified limit, or who have two or fewer overlaps attached to them, output by residuals.
no_update.txt - List of landmarks output by residuals whose associated pictures are not listed by increasing mission time in the .LMK file.
PRUNE.TXT - List of landmarks for which the number of pictures in which they are contained exceeds the default limit of 500, or the user-specified limit, PRNLM, set within INIT_LITHOS.TXT. File output by residuals.
redo.txt - List of landmarks output by find_nofit or find-nofitP which after batch lithos or lithosP processing either terminated in error, did not correlate with at least one image, or correlated weakly with at least one image.
Key Diagnostic Files
RESIDUALS.TXT - Errors within the map and images
INSIDE.TXT - Only the maps that are inside of the most recent bigmap created
USED_MAPS.TXT - All maps used when making a bigmap
USED_PICS.TXT - All images used when making a bigmap
PICINFO.TXT - List all the images and parameters about them
- Usually these files are used to run batch jobs or scripts.
make_script.in - Used by various script-makers for batch jobs.
- make_scriptF.in? seed? -
MAPTRANS - Diagnostic tools to visualize maplet translations.
- Generate a maplet with specific parameters
- Then tile maplet with overlapping better resolution maplets
- Process more images and tile a maplet (3-4 hours)
- AUTOREGISTER, Create Bigmap from 0.4 pm/px maps, set up batch run tiling
Papers and Presentations
Contact me with questions. Email: <epalmer AT SPAMFREE psi DOT edu>
Links to wiki formatting and help https://moinmo.in/HelpOnMoinWikiSyntax
Test_Files - I'm going to store the scripts here for the testing proceedures