csm_camera_plot

The csm_camera_plot command-line tool creates diagnostic plots after running tools like bundle_adjust and jitter_solve. The inputs must be CSM camera files. Currently, this tool only supports CSM linescan cameras, such as those from WorldView satellites.

Two WorldView-3 cameras before and after jitter_solve over Salar de Uyuni (notebook). For each camera: the position change along the image lines (easting, northing, altitude, in meters) and the roll / pitch / yaw change with the original angle overlaid, plus a map of where along the trajectory the change is largest. The along-track oscillation is the jitter being removed; a bundle_adjust run shows a flat offset instead (compare the UCSD notebook). To see only how far each camera moved, from the bundle_adjust folder alone, use bundle_adjust_cameras.

Basic usage

csm_camera_plot --original-cameras path/to/original_camera_1,path/to/original_camera_2 \
                --optimized-cameras path/to/optimized_camera_1,path/to/optimized_camera_2

With UTM projection and save directory

For more meaningful positions, specify a map_crs UTM EPSG code:

csm_camera_plot --original-cameras path/to/original_camera_1,path/to/original_camera_2 \
                --optimized-cameras path/to/optimized_camera_1,path/to/optimized_camera_2 \
                --map-crs EPSG:32728 \
                --output-directory path/to/save_directory/

Single camera

If a second camera is not supplied, the tool will plot just the single camera:

csm_camera_plot --original-cameras path/to/original_camera_1 \
                --optimized-cameras path/to/optimized_camera_1 \
                --map-crs EPSG:32728 \
                --output-directory path/to/save_directory/

Full options

Usage: csm_camera_plot [OPTIONS]

  Create diagnostic plots for CSM camera model adjustments.

  Analyzes the changes between original and optimized camera models after
  bundle adjustment or jitter correction. Generates plots showing position and
  angle differences along the satellite trajectory, as well as a mapview of
  the camera footprints.

Options:
  --original-cameras TEXT         Original camera files, supplied as comma
                                  separated list 'path/to/original_camera_1,pa
                                  th/to/original_camera_2'. No default. Must
                                  be supplied.
  --optimized-cameras TEXT        Optimized camera files, supplied as comma
                                  separated list 'path/to/optimized_camera_1,p
                                  ath/to/optimized_camera_2'. No default. Must
                                  be supplied.
  --map-crs TEXT                  UTM EPSG code for map projection. As
                                  EPSG:XXXX. If not supplied, the map will be
                                  plotted in original camera coordinates of
                                  EPSG:4978 (ECEF).
  --title TEXT                    Optional short title to append to figure
                                  output. Default: None.
  --no-trim                       Do not trim the plotted positions to the
                                  first and last camera image lines (trimmed
                                  by default).
  --shared-scales                 Share the position and angle difference
                                  scales between the cameras.
  --log-scale-positions           Log-scale the position difference plots.
  --log-scale-angles              Log-scale the angle difference plots.
  --upper-magnitude-percentile INTEGER
                                  Percentile to use for the upper limit of the
                                  mapview colorbars. Default: 95.
  --figure-size TEXT              Figure size as width,height. Default: 20,15.
  --output-directory TEXT         Directory to save the figure. Default: None,
                                  which does not save the figure.
  --output-filename TEXT          Figure filename. Default:
                                  csm_camera_summary_plot.png.
  --add-basemap                   Add a contextily basemap to the figure,
                                  which requires an internet connection.
  --help                          Show this message and exit.