.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "auto_examples/camera_array.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_auto_examples_camera_array.py>`
        to download the full example code.

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_auto_examples_camera_array.py:


Using Camera Arrays
===================

This example demonstrates how to create and visualize a `CameraArray`, which
combines multiple individual camera views into a single, wide field-of-view image.

.. GENERATED FROM PYTHON SOURCE LINES 10-17

.. code-block:: Python

    import datetime
    from arguslib.camera.camera_array import CameraArray
    from arguslib.camera.undistorted_camera import UndistortedCamera
    from arguslib.camera.camera import Camera

    dt = datetime.datetime(2025, 3, 25, 9, 0, 0)








.. GENERATED FROM PYTHON SOURCE LINES 18-27

Creating a Basic Camera Array
-----------------------------

A `CameraArray` can be created from a configuration file. By default, it uses
the standard `Camera` class for each camera in the array. The `show()` method
plots the images from all cameras, stitched together.

Note the visible lens distortion (barrel distortion) at the edges of the
combined image.

.. GENERATED FROM PYTHON SOURCE LINES 27-30

.. code-block:: Python

    basic_array = CameraArray.from_config("COBALTArray")
    ax = basic_array.show(dt)




.. image-sg:: /auto_examples/images/sphx_glr_camera_array_001.png
   :alt: camera array
   :srcset: /auto_examples/images/sphx_glr_camera_array_001.png
   :class: sphx-glr-single-img





.. GENERATED FROM PYTHON SOURCE LINES 31-37

Using Undistorted Cameras in an Array
-------------------------------------

To correct for lens distortion, we can specify `UndistortedCamera` as the
`camera_class` when creating the array. This produces a more natural-looking
composite image, which is especially useful for wide-angle views.

.. GENERATED FROM PYTHON SOURCE LINES 37-41

.. code-block:: Python

    undistorted_array = CameraArray.from_config(
        "COBALTArray", camera_class=UndistortedCamera
    )
    ax = undistorted_array.show(dt)



.. image-sg:: /auto_examples/images/sphx_glr_camera_array_002.png
   :alt: camera array
   :srcset: /auto_examples/images/sphx_glr_camera_array_002.png
   :class: sphx-glr-single-img






.. rst-class:: sphx-glr-timing

   **Total running time of the script:** (0 minutes 14.201 seconds)


.. _sphx_glr_download_auto_examples_camera_array.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: camera_array.ipynb <camera_array.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: camera_array.py <camera_array.py>`

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: camera_array.zip <camera_array.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_