WIKI for Bob Gaskell's StereoPC

General Info

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.

Work Flow

• ["Making new landmarks"] - Workflow from the 50m resolution work done for Dawn at Vesta
• ["Adding new images"]
• ["Building a shape model"]
• ["Making 3D images"]
• ["Making 'point of view' images"]
• ["Panorama Images"]
• ["Small Footprint Processing"] - Lets you do tiling copying only the files that you need for the specific task.

Scripts - from AAA.TXT

• ["Vesta Notes"]
• ["Startup"]
• ["LAT/LON Shape"]
• ["Triaxial Shape"]
• ["Batches"]
• ["Autoregister"]
• ["Parallel Autoregister"]
• ["Parallel Batch"]
• ["Batch Tiling: See make_scriptT.txt"]
• ["Geometry and Residuals"]
• ["Pole"]
• ["Export"]
• ["Import"]
• ["Export, External Iteration"]
• ["Import, External Iteration"]
• ["Gravity"]
• ["Fill"] - Take topography from a bigmap and replace a landmark's terrain with it.

Programs

Lithos

• ["lithos.e"] - aligns maplets to the current shape model and will provide slight changes to the shape (stored in MAPFILES)
• ["geometry.e"] - 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"] - aligns a new image with a reference, automatically

Imager

• ["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_mono.e"] -
• ["image_map_rgb.e"] - Renders a 3D image of a bigmap using red and blue
• ["image_map_stereo.e"] -
• ["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

Shaper

• ["bigmap.e"] - 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

Utilities

• ["find_nofitT.e"] - searches for alignments that had problems
• ["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
• ["make_scriptT.e"] - generates the script that tiles (makes new maplets)
• ["refresh_sumfiles.e"] - updates the sumfiles to match the maplets
• ["make_sumfiles.e"] - ingests images and sets them up for use in SPC
• ["showmap.e"] - generates an image (.pgm) for a specific bigmap
• ["pr_template"] - (copy the codes for when making a new prog page)
• ["make_pictlistX"] - Builds the file ["PICTLISTX.TXT"] which makes things run faster
• ["process_img"] - Takes a list of files and creates make_sumfiles.in. Creates IMAGEFILE for each images
• ["make_sumfiles"] - Computes the SUMFILE and NOMINALS

Gravity

["Notes on Gravity"]

• ["Mgrav.e"] - Makes ["MGRAV.TXT"] and generates gravity images based on a map or 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.
• ["Sacc.e"] - Provided the correct GM and Omega, it will use ["SGRAV.TXT"] file to create the surface acceleration.
• ["Selv.e"] - Provided the correct GM and Omega, it will use ["SGRAV.TXT"] file to create the surface elevation (same as geoid).
• ["Slap"] - Provided the correct GM and Omega, it will use ["SGRAV.TXT"] file to create the surface laplacian.
• ["Spot.e"] - Provided the correct GM and Omega, it will use ["SGRAV.TXT"] file to create the surface potential.
• ["Sslpa.e"] - ?

Directories

• ["LMKFILES"] - Stores the actual landmarkts, .LMK
• ["MAPFILES"] - Stores the maplets, .MAP
• ["IMAGEFILES"] - Directory that holds the image files, .DAT
• ["SUMFILES"] - Directory that holds the sum files, .SUM
• ["NOMINALS"] - Directory that holds the sum files, .NOM
• ["NEW_IMAGES"] - Directory that holds the new, and unprocessed image files (in pgm format)
• ["DATA"] - A place for the SPICE kernels
• ["UTILITIES"] - Programs that are specific for this project
• ["SHAPEFILES"] - Holds the different types of shapefiles

Key Input Files

• ["LMRKLIST.TXT"] - The full list of landmarks
• ["LMRKLIST1.TXT"]
• ["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.
• ["BIGLIST.TXT"] - List of mapfiles (bigmaps) used to make a new bigmap. Generated from ["bigmap.e"]
• ["NEWFILES.TXT"]
• ["OVERLAPS.TXT"]
• ["SGRAV.TXT"] - produced from ["Sgrav.e"]. Similar to SHAPE.TXT with extra columns for surface acceleration, potential and laplacian (just as a check).
• ["MGRAV.TXT"] - produced by ["Mgrav.e"]. It contains vector position, potential, acceleration, slope and delta elevation.
• ["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.
• ["MOSAIC.TXT"] - A list of images that ["mosaic"] uses to build a moasic
• ["make_sumfiles.in"] - List of new images to process
• ["make_sumfiles.txt"] - SPICE references

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

Support Files

• Usually these files are used to run batch jobs or scripts.
• ["make_scriptT.in"] - Used by ["make_scriptT.e"] to build ["run_script.b"]

Papers and Presentations

• ["LPSC 20??"]

Deprecated

• ["view_maps.in"]
• ["view_maps.e"] -

Help

Contact me with questions. Email: MailTo(epalmer AT SPAMFREE psi DOT edu)

Links to wiki formatting and help [http://www.psi.edu/dawn_wiki/SyntaxReference]

• ["Test Files"] - I'm going to store the scripts here for the testing proceedures

CategoryHomepage