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. Using a camera, a mask, and a DEM
- 16.3.2. Using a DEM and an orthoimage mask
- 16.3.3. Using a DEM and shapefile
- 16.3.4. Using a DEM and lon-lat values
- 16.3.5. Using a water-surface raster
- 16.3.6. Multiple water bodies
- 16.3.7. Using water height measurements
- 16.3.8. Pick a sample set of points at the water-land boundary
- 16.3.9. Acquisition of water height data
- 16.3.10. Global tide models and water surface elevation
- 16.3.11. Bathy plane definition and format
- 16.3.12. Command-line options for bathy_plane_calc
- 16.4. bathy_threshold_calc.py
- 16.5. bundle_adjust
- 16.5.1. Examples
- 16.5.2. Use of the results
- 16.5.3. Camera adjustments and applying a transform
- 16.5.4. Validation
- 16.5.5. Handling failures
- 16.5.6. Constraints
- 16.5.7. Use cases
- 16.5.8. How bundle adjustment works
- 16.5.9. Ground control points
- 16.5.10. Control network
- 16.5.11. Output files
- 16.5.11.1. Reprojection errors per camera
- 16.5.11.2. Camera position changes
- 16.5.11.3. Changes in triangulated points
- 16.5.11.4. Convergence angles
- 16.5.11.5. Reprojection errors per triangulated point
- 16.5.11.6. GCP report
- 16.5.11.7. Image and camera lists
- 16.5.11.8. Error propagation
- 16.5.11.9. Camera positions and orientations
- 16.5.11.10. Registration errors on the ground
- 16.5.12. Format of .adjust files
- 16.5.13. Command-line options
- 16.5.13.1. General
- 16.5.13.2. Interest point detection
- 16.5.13.3. Interest point matching
- 16.5.13.4. Match files and control networks
- 16.5.13.5. Optimization
- 16.5.13.6. Outlier filtering
- 16.5.13.7. Camera and ground constraints
- 16.5.13.8. Solving for intrinsics
- 16.5.13.9. Camera initialization and transforms
- 16.5.13.10. Mapprojection
- 16.5.13.11. Error propagation
- 16.5.13.12. Bathymetry correction
- 16.6. cam2map4stereo.py
- 16.7. cam2rpc
- 16.8. cam_gen
- 16.8.1. Examples
- 16.8.1.1. Pinhole cameras
- 16.8.1.2. Optical bar cameras
- 16.8.1.3. Fit a prior camera
- 16.8.1.4. CSM Frame cameras
- 16.8.1.5. CSM Frame cameras distortion refit
- 16.8.1.6. CSM Frame cameras pose refit
- 16.8.1.7. CSM linescan cameras
- 16.8.1.8. Fit CSM to Optical Bar
- 16.8.1.9. Geodetic coordinates and angles
- 16.8.1.10. Vendor exterior orientation
- 16.8.1.11. Export RPC
- 16.8.2. Further refinement
- 16.8.3. Validation
- 16.8.4. Command-line options
- 16.8.1. Examples
- 16.9. cam_test
- 16.10. camera_calibrate
- 16.11. camera_footprint
- 16.12. camera_solve
- 16.13. CGAL tools
- 16.14. colormap
- 16.15. convert_pinhole_model
- 16.16. corr_eval
- 16.17. Image correlator
- 16.18. dem2gcp
- 16.18.1. ASP DEM creation
- 16.18.2. Comparison with the reference DEM
- 16.18.3. Running
dem2gcp - 16.18.4. Solving for extrinsics and intrinsics
- 16.18.5. Solving for jitter
- 16.18.6. Balancing GCP against other constraints
- 16.18.7. Multiple images and cameras
- 16.18.8. Transforming existing GCP files
- 16.18.9. Command-line options
- 16.19. dem_geoid
- 16.20. dem_mosaic
- 16.21. dg_mosaic
- 16.22. disp2ip
- 16.23. disparitydebug
- 16.24. gcp_gen
- 16.25. GDAL tools
- 16.26. geodiff
- 16.27. glint_correct
- 16.28. hiedr2mosaic.py
- 16.29. hillshade
- 16.30. historical_helper.py
- 16.31. icebridge_kmz_to_csv
- 16.32. image2qtree
- 16.33. image_align
- 16.33.1. Overview
- 16.33.2. Assumptions
- 16.33.3. Interest point-based alignment
- 16.33.4. Disparity-based alignment
- 16.33.5. Application for alignment of DEMs
- 16.33.6. Determination of ECEF transform
- 16.33.7. Evaluating matches between orthoimages
- 16.33.8. Per-match uncertainty
- 16.33.9. Usage
- 16.33.10. Command-line options for image_align
- 16.34. image_calc
- 16.34.1. Examples
- 16.34.1.1. Apply operation and save pixels as float32
- 16.34.1.2. Apply a mask to an image
- 16.34.1.3. Create a binary mask via thresholding
- 16.34.1.4. Threshold and invalidate pixels below a value
- 16.34.1.5. Threshold and invalidate pixels above a value
- 16.34.1.6. Median filter
- 16.34.1.7. Create an image with random values
- 16.34.1.8. Add a value to the geoheader metadata
- 16.34.1.9. Stretch and convert to 8-bit
- 16.34.1.10. Subtract 360 degrees from the longitudes in a GeoTiff file
- 16.34.1.11. Extract disparity bands respecting invalid disparities
- 16.34.2. Usage
- 16.34.3. Command-line options for image_calc
- 16.34.1. Examples
- 16.35. image_mosaic
- 16.36. image_subset
- 16.37. ipfind
- 16.38. ipmatch
- 16.39. jitter_solve
- 16.39.1. Limitations
- 16.39.2. Ground constraints
- 16.39.3. Camera constraints
- 16.39.4. Resampling the poses
- 16.39.5. Interest point matches
- 16.39.6. Anchor points
- 16.39.7. Solving for intrinsics
- 16.39.8. Example 1: CTX images on Mars
- 16.39.9. Example 2: WorldView-3 DigitalGlobe images on Earth
- 16.39.10. Example 3: Airbus Pleiades
- 16.39.11. ASTER cameras
- 16.39.12. Jitter with synthetic cameras and orientation constraints
- 16.39.13. Constraining direction of jitter with real cameras
- 16.39.14. Mixing linescan and frame cameras
- 16.39.15. Rig constraints
- 16.39.16. Point cloud constraint
- 16.39.17. Output files
- 16.39.17.1. Optimized cameras
- 16.39.17.2. Reprojection errors per camera
- 16.39.17.3. Changes in camera positions
- 16.39.17.4. Changes in triangulated points
- 16.39.17.5. GCP report
- 16.39.17.6. Reprojection errors per triangulated point
- 16.39.17.7. Anchor points
- 16.39.17.8. Reference terrain residuals
- 16.39.17.9. Image and camera lists
- 16.39.17.10. Other output files
- 16.39.18. Command-line options for jitter_solve
- 16.40. lronac2mosaic.py
- 16.41. lvis2kml
- 16.42. mapproject
- 16.43. multi_stereo
- 16.44. n_align
- 16.45. orbit_plot.py
- 16.46. orbitviz
- 16.47. ortho2pinhole
- 16.48. otsu_threshold
- 16.49. pansharp
- 16.50. parallel_bundle_adjust
- 16.51. parallel_sfs
- 16.52. parallel_stereo
- 16.53. parse_match_file.py
- 16.54. pc_align
- 16.54.1. The input point clouds
- 16.54.2. The max displacement option
- 16.54.3. Alignment method
- 16.54.4. File formats
- 16.54.5. The alignment transform
- 16.54.6. Applying an initial transform
- 16.54.7. Applying an initial specified translation or rotation
- 16.54.8. Interpreting the transform
- 16.54.9. Error metrics and outliers
- 16.54.10. Evaluation of aligned clouds
- 16.54.11. Output point clouds and convergence history
- 16.54.12. Manual alignment
- 16.54.13. Regrid a DEM
- 16.54.14. Applying a transform to cameras
- 16.54.15. Troubleshooting
- 16.54.16. Command-line options for pc_align
- 16.54.17. Options for Nuth and Kaab
- 16.55. pc_filter
- 16.56. pc_merge
- 16.57. point2dem
- 16.57.1. Determination of projection
- 16.57.2. Examples
- 16.57.2.1. Local stereographic projection
- 16.57.2.2. Orthoimage and error image
- 16.57.2.3. Specify a projection string
- 16.57.2.4. Custom grid size with geographic projection
- 16.57.2.5. Polar stereographic projection
- 16.57.2.6. UTM projection
- 16.57.2.7. CSV files
- 16.57.2.8. LAS and COPC
- 16.57.2.9. Reading from an archive or over the network
- 16.57.2.10. Multiple clouds
- 16.57.2.11. Ground-level or projected data
- 16.57.3. Comparing with MOLA
- 16.57.4. Post spacing
- 16.57.5. LAS or CSV clouds
- 16.57.6. Output statistics
- 16.57.7. Command-line options for point2dem
- 16.58. point2las
- 16.59. point2mesh
- 16.60. refr_index
- 16.61. rig_calibrator
- 16.61.1. Capabilities
- 16.61.2. Input data conventions
- 16.61.3. The reference sensor
- 16.61.4. Configuration file
- 16.61.5. Output files
- 16.61.6. Examples
- 16.61.7. Notes
- 16.61.8. Constraints on rig transforms
- 16.61.9. Constraints on cameras
- 16.61.10. Constraints on triangulated points
- 16.61.11. Determination of scale and registration
- 16.61.12. Quality metrics
- 16.61.13. Handling failures
- 16.61.14. Point cloud file format
- 16.61.15. Interfacing with bundle_adjust
- 16.61.16. Usage
- 16.61.17. Command-line options
- 16.62. ROS bag handling tools
- 16.63. sat_sim
- 16.63.1. Prior frame or linescan cameras
- 16.63.2. Create nadir-pointing frame cameras
- 16.63.3. Follow custom ground path with varying orientation
- 16.63.4. Fixed camera orientation
- 16.63.5. Pose and ground constraints
- 16.63.6. Jitter modelling
- 16.63.7. Linescan cameras
- 16.63.8. Modeling a rig
- 16.63.9. Adjusting a rig
- 16.63.10. Modeling time
- 16.63.11. Perturbing existing cameras
- 16.63.12. Roll, pitch, and yaw
- 16.63.13. Efficiency considerations
- 16.63.14. Preparing the input DEM and orthoimage
- 16.63.15. Output files
- 16.63.16. Command-line options
- 16.64. sfm_merge
- 16.65. sfm_proc
- 16.66. sfm_submap
- 16.67. sfm_view
- 16.68. sfs
- 16.69. sfs_blend
- 16.70. sparse_disp
- 16.71. stereo
- 16.72. stereo_dist
- 16.73. stereo_gui
- 16.73.1. Use as stereo front-end
- 16.73.2. Use as an image viewer
- 16.73.3. Other features
- 16.73.4. Hillshading
- 16.73.5. Displaying colorized images, with a colorbar and axes
- 16.73.6. View scattered points
- 16.73.7. Polygon editing and contouring
- 16.73.8. Finding pixel values and region bounds
- 16.73.9. View interest point matches
- 16.73.10. View GCP and .vwip files
- 16.73.11. Edit interest point matches
- 16.73.12. Creating GCP with with an orthoimage and a DEM
- 16.73.13. Image threshold
- 16.73.14. Cycle through images
- 16.73.15. See also
- 16.73.16. Command line options for
stereo_gui
- 16.74. stereo_sweep
- 16.75. stereo_tile
- 16.76. texrecon
- 16.77. theia_sfm
- 16.78. undistort_image
- 16.79. view_reconstruction
- 16.80. voxblox_mesh
- 16.81. wv_correct