asp_plot.scenes
===============

.. py:module:: asp_plot.scenes


Attributes
----------

.. autoapisummary::

   asp_plot.scenes.logger


Classes
-------

.. autoapisummary::

   asp_plot.scenes.ScenePlotter


Module Contents
---------------

.. py:class:: ScenePlotter(directory, stereo_directory, **kwargs)

   Bases: :py:obj:`asp_plot.utils.Plotter`


   Plot raw or map-projected images from ASP stereo processing.

   This class extends the base Plotter class to provide visualization
   of raw or map-projected images created during ASP stereo processing.
   It locates and plots the left and right scenes from a stereo pair.

   .. attribute:: directory

      Root directory of ASP processing

      :type: str

   .. attribute:: stereo_directory

      Subdirectory containing stereo outputs

      :type: str

   .. attribute:: full_stereo_directory

      Full path to stereo directory

      :type: str

   .. attribute:: left_scene_sub_fn

      Path to the left subsampled file

      :type: str or None

   .. attribute:: right_scene_sub_fn

      Path to the right subsampled file

      :type: str or None

   .. attribute:: title

      Plot title, inherited from Plotter class

      :type: str

   .. rubric:: Examples

   >>> scene_plotter = ScenePlotter('/path/to/asp', 'stereo', title="Stereo Images")
   >>> scene_plotter.plot_scenes(save_dir='/path/to/output', fig_fn='stereo_images.png')


   .. py:method:: plot_scenes(save_dir=None, fig_fn=None)

      Plot the left and right images side by side.

      Creates a figure with two subplots showing the left and right
      images from the stereo pair. Map-projection is not assumed.
      Each image is displayed with its filename above it.

      :param save_dir: Directory to save the figure, default is None (don't save)
      :type save_dir: str or None, optional
      :param fig_fn: Filename for the saved figure, default is None
      :type fig_fn: str or None, optional

      :returns: Displays the plot and optionally saves it
      :rtype: None

      .. rubric:: Notes

      If either image file is missing, the corresponding subplot
      will display a message indicating that required files are missing.



   .. py:attribute:: directory


   .. py:attribute:: full_stereo_directory


   .. py:attribute:: is_vantor
      :value: False



   .. py:attribute:: left_scene_sub_fn


   .. py:attribute:: right_scene_sub_fn


   .. py:attribute:: stereo_directory


.. py:data:: logger