16. Tools

This chapter provides a overview of the various tools that are provided as part of the Ames Stereo Pipeline, and a summary of their command line options.

• 16.1. add_spot_rpc
• 16.2. aster2asp
• 16.3. bathy_plane_calc
  • 16.3.1. Example 1 (using a camera, a mask, and a DEM)
    • 16.3.1.1. Preparation and running the program
    • 16.3.1.2. Handling adjusted cameras and alignment
  • 16.3.2. Example 2 (using water height measurements)
  • 16.3.3. Example 3 (using a DEM and shapefile)
  • 16.3.4. Example 4 (pick a sample set of points at mask boundary)
  • 16.3.5. Acquisition of water height data
  • 16.3.6. Command-line options for bathy_plane_calc
• 16.4. bathy_threshold_calc.py
  • 16.4.1. Example usage
  • 16.4.2. Dependencies
  • 16.4.3. Command-line options for bathy_threshold_calc.py
• 16.5. bundle_adjust
  • 16.5.1. Examples
    • 16.5.1.1. ISIS cameras
    • 16.5.1.2. Maxar Earth cameras
    • 16.5.1.3. RPC cameras
    • 16.5.1.4. Pinhole cameras
  • 16.5.2. Use cases
    • 16.5.2.1. Uniformly distributed interest points
    • 16.5.2.2. Controlling where interest points are placed
    • 16.5.2.3. Using mapprojected images
  • 16.5.3. Large-scale bundle adjustment
  • 16.5.4. Use of the results
  • 16.5.5. How bundle adjustment works
  • 16.5.6. Ground control points
    • 16.5.6.1. File format
    • 16.5.6.2. Effect on optimization
  • 16.5.7. Creating or transforming pinhole cameras using GCP
  • 16.5.8. Output files
    • 16.5.8.1. Camera projection errors and triangulated points
    • 16.5.8.2. Convergence angles
    • 16.5.8.3. Error propagation
    • 16.5.8.4. Camera positions and orientations
    • 16.5.8.5. Registration errors on the ground
  • 16.5.9. Format of .adjust files
  • 16.5.10. Command-line options for bundle_adjust
• 16.6. cam2map4stereo.py
• 16.7. cam2rpc
• 16.8. cam_gen
• 16.9. cam_test
  • 16.9.1. Command-line options for cam_test
• 16.10. camera_calibrate
• 16.11. camera_footprint
• 16.12. camera_solve
  • 16.12.1. Example
  • 16.12.2. Usage
  • 16.12.3. Command-line options
• 16.13. CGAL tools
  • 16.13.1. Examples
• 16.14. colormap
  • 16.14.1. Using your own colormap
  • 16.14.2. Command-line options for colormap
• 16.15. convert_pinhole_model
• 16.16. corr_eval
• 16.17. Image correlator
• 16.18. dem_geoid
• 16.19. dem_mosaic
  • 16.19.1. Overview
  • 16.19.2. Examples
    • 16.19.2.1. Blend DEMs
    • 16.19.2.2. Priority blending
    • 16.19.2.3. Mean height DEM
    • 16.19.2.4. Regridding
    • 16.19.2.5. Apply a blur
    • 16.19.2.6. Erosion
    • 16.19.2.7. Fill small holes
    • 16.19.2.8. Grow a DEM
  • 16.19.3. Usage
  • 16.19.4. Command-line options
• 16.20. dg_mosaic
• 16.21. disparitydebug
• 16.22. GDAL tools
• 16.23. geodiff
• 16.24. hiedr2mosaic.py
• 16.25. hillshade
• 16.26. historical_helper.py
• 16.27. hsv_merge
• 16.28. icebridge_kmz_to_csv
• 16.29. image2qtree
• 16.30. image_align
  • 16.30.1. Examples
  • 16.30.2. Application for alignment of DEMs
  • 16.30.3. Determination of ECEF transform
  • 16.30.4. Usage
  • 16.30.5. Command-line options for image_align
• 16.31. image_calc
  • 16.31.1. Examples
    • 16.31.1.1. Apply operation and save pixels as float32
    • 16.31.1.2. Invalidate values no more than a threshold
    • 16.31.1.3. Apply a mask to an image
    • 16.31.1.4. Create a mask
    • 16.31.1.5. Create an image with random values
    • 16.31.1.6. Add a value to the geoheader metadata
    • 16.31.1.7. Subtract 360 degrees from the longitudes in a GeoTiff file
  • 16.31.2. Usage
  • 16.31.3. Command-line options
• 16.32. image_mosaic
• 16.33. ipfind
• 16.34. ipmatch
• 16.35. jitter_solve
  • 16.35.1. Ground constraints
    • 16.35.1.1. Intrinsic constraint
    • 16.35.1.2. Extrinsic constraint
    • 16.35.1.3. Anchor points
  • 16.35.2. Camera constraints
  • 16.35.3. Resampling the poses
  • 16.35.4. Interest point matches
  • 16.35.5. Example 1: CTX images on Mars
    • 16.35.5.1. Input images
    • 16.35.5.2. Reference datasets
    • 16.35.5.3. Uncorrected DEM creation
    • 16.35.5.4. Solving for jitter
    • 16.35.5.5. Using multiple images
  • 16.35.6. Example 2: WorldView-3 DigitalGlobe images on Earth
    • 16.35.6.1. Bundle adjustment
    • 16.35.6.2. Mapprojection
    • 16.35.6.3. Stereo
    • 16.35.6.4. Alignment
    • 16.35.6.5. Solving for jitter
    • 16.35.6.6. Redoing mapprojection and stereo
    • 16.35.6.7. Reusing a previous run
    • 16.35.6.8. Validation
  • 16.35.7. Example 3: Airbus Pleiades
    • 16.35.7.1. Creation of terrain model
    • 16.35.7.2. Correcting the jitter
  • 16.35.8. ASTER cameras
    • 16.35.8.1. Setup
    • 16.35.8.2. Initial stereo and alignment
    • 16.35.8.3. Solving for jitter
  • 16.35.9. Jitter with synthetic cameras and orientation constraints
  • 16.35.10. Constraining direction of jitter with real cameras
  • 16.35.11. Mixing linescan and frame cameras
  • 16.35.12. Solving for jitter with a linescan and frame rig
  • 16.35.13. Output files
  • 16.35.14. Command-line options for jitter_solve
• 16.36. lronac2mosaic.py
• 16.37. lvis2kml
• 16.38. mapproject
  • 16.38.1. Examples
  • 16.38.2. Saved metadata
  • 16.38.3. Usage
  • 16.38.4. Command-line options
• 16.39. multi_stereo
  • 16.39.1. Examples
    • 16.39.1.1. Creation of camera models
    • 16.39.1.2. Running stereo and mesh creation
    • 16.39.1.3. Creating a textured mesh
  • 16.39.2. Handling issues
  • 16.39.3. Command-line options for multi_stereo
• 16.40. n_align
• 16.41. orbit_plot.py
  • 16.41.1. Satellite coordinate system
  • 16.41.2. Roll, pitch, and yaw angles
  • 16.41.3. Examples
    • 16.41.3.1. Plot one dataset
    • 16.41.3.2. Plot two datasets
    • 16.41.3.3. Plot two orbital groups, including linescan cameras
  • 16.41.4. Dependencies
  • 16.41.5. See also
  • 16.41.6. Command-line options
• 16.42. orbitviz
• 16.43. otsu_threshold
• 16.44. pansharp
• 16.45. parallel_bundle_adjust
• 16.46. parallel_sfs
• 16.47. parallel_stereo
  • 16.47.1. Processes and threads
  • 16.47.2. Entry points
  • 16.47.3. Command-line options
• 16.48. parse_match_file.py
• 16.49. pc_align
  • 16.49.1. The input point clouds
  • 16.49.2. The max displacement option
  • 16.49.3. Alignment method
  • 16.49.4. File formats
  • 16.49.5. The alignment transform
  • 16.49.6. Applying an initial transform
  • 16.49.7. Applying an initial specified translation or rotation
  • 16.49.8. Interpreting the transform
  • 16.49.9. Error metrics and outliers
  • 16.49.10. Evaluation of aligned clouds
  • 16.49.11. Output point clouds and convergence history
  • 16.49.12. Manual alignment
  • 16.49.13. Creating a point cloud from a DEM
  • 16.49.14. Applying the pc_align transform to cameras
  • 16.49.15. Troubleshooting
  • 16.49.16. Command-line options for pc_align
• 16.50. pc_filter
• 16.51. pc_merge
• 16.52. point2dem
  • 16.52.1. Examples
    • 16.52.1.1. Auto-guess projection center and datum
    • 16.52.1.2. Orthoimage and error image
    • 16.52.1.3. Custom grid size with geographic projection
    • 16.52.1.4. Polar stereographic projection
    • 16.52.1.5. Multiple clouds
  • 16.52.2. Comparing with MOLA Data
  • 16.52.3. Post spacing
  • 16.52.4. Using with LAS or CSV clouds
  • 16.52.5. Output statistics
  • 16.52.6. Command-line options for point2dem
• 16.53. point2las
  • 16.53.1. Outlier removal
  • 16.53.2. Command-line options for point2las
• 16.54. point2mesh
• 16.55. rig_calibrator
  • 16.55.1. Capabilities
  • 16.55.2. Input data conventions
  • 16.55.3. Assumptions about the timestamp
  • 16.55.4. The reference sensor
  • 16.55.5. Configuration file
  • 16.55.6. Output files
  • 16.55.7. A solved example
  • 16.55.8. Notes
  • 16.55.9. Determination of scale and registration
  • 16.55.10. Quality metrics
  • 16.55.11. Handling failures
  • 16.55.12. Point cloud file format
  • 16.55.13. Source code
  • 16.55.14. Command-line options for rig_calibrator
• 16.56. ROS bag handling tools
  • 16.56.1. list_timestamps
  • 16.56.2. extract_bag
• 16.57. sat_sim
  • 16.57.1. Use given cameras
  • 16.57.2. Generate nadir-pointing cameras
  • 16.57.3. Follow custom ground path with varying orientation
  • 16.57.4. Fixed camera orientation
  • 16.57.5. Pose and ground constraints
  • 16.57.6. Jitter modelling
    • 16.57.6.1. Specifying the jitter amplitude in meters
    • 16.57.6.2. Specifying the jitter amplitude in micro radians
  • 16.57.7. Linescan cameras
  • 16.57.8. Roll, pitch, and yaw
  • 16.57.9. Efficiency considerations
  • 16.57.10. Preparing the input DEM and orthoimage
  • 16.57.11. Output files
  • 16.57.12. Command-line options
• 16.58. sfm_merge
  • 16.58.1. Example
  • 16.58.2. Handling tracks
  • 16.58.3. Command-line options for sfm_merge
• 16.59. sfm_submap
  • 16.59.1. Examples
  • 16.59.2. Command-line options for sfm_submap
• 16.60. sfm_view
  • 16.60.1. See also
  • 16.60.2. Example
  • 16.60.3. Command-line options
• 16.61. sfs
  • 16.61.1. Example
  • 16.61.2. Inputs
  • 16.61.3. Outputs
  • 16.61.4. Command-line options for sfs
• 16.62. sfs_blend
• 16.63. stereo
  • 16.63.1. Command-line options
• 16.64. stereo_gui
  • 16.64.1. Use as stereo front-end
  • 16.64.2. Use as an image viewer
  • 16.64.3. Other features
  • 16.64.4. Hillshading
  • 16.64.5. Displaying colorized images, with a colorbar and axes
  • 16.64.6. View scattered points
  • 16.64.7. Polygon editing and contouring
    • 16.64.7.1. Plain text polygon files
    • 16.64.7.2. Application
  • 16.64.8. Finding pixel values and region bounds
  • 16.64.9. View interest point matches
    • 16.64.9.1. View matches for an image pair
    • 16.64.9.2. View pairwise matches for N images
    • 16.64.9.3. View all matches for N images
    • 16.64.9.4. View NVM files
  • 16.64.10. View GCP and .vwip files
  • 16.64.11. Edit interest point matches
  • 16.64.12. Creating GCP with georeferenced images and a DEM
  • 16.64.13. Creating interest point matches using mapprojected images
  • 16.64.14. Image threshold
  • 16.64.15. Command line options for stereo_gui
• 16.65. texrecon
  • 16.65.1. Example
  • 16.65.2. Command-line options
• 16.66. theia_sfm
  • 16.66.1. Usage
  • 16.66.2. Examples
  • 16.66.3. Visualization
  • 16.66.4. Manipulating SfM solutions
    • 16.66.4.1. Command-line options for theia_sfm
• 16.67. undistort_image
• 16.68. voxblox_mesh
  • 16.68.1. Example
  • 16.68.2. Format of the inputs
  • 16.68.3. Command-line options for voxblox_mesh
• 16.69. wv_correct
  • 16.69.1. Note for WV-2 images
  • 16.69.2. Usage
  • 16.69.3. Examples
  • 16.69.4. Command-line options for wv_correct