robokudo.io.storage_reader_interface
====================================

.. py:module:: robokudo.io.storage_reader_interface

.. autoapi-nested-parse::

   MongoDB storage reader interface for RoboKudo.

   This module provides an interface for reading stored sensor data and annotations
   from a MongoDB database. It supports:

   * Reading stored RGB-D camera data
   * Loading camera calibration information
   * Restoring annotations and views
   * Automatic cursor management
   * Optional looping through stored data

   The module is primarily used for:

   * Replaying recorded data
   * Testing and debugging pipelines
   * Offline data analysis
   * Visualization of stored data



Classes
-------

.. autoapisummary::

   robokudo.io.storage_reader_interface.StorageReaderInterface


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

.. py:class:: StorageReaderInterface(camera_config)

   Bases: :py:obj:`robokudo.io.camera_interface.CameraInterface`


   A camera interface for reading data from MongoDB storage.

   This interface reads sensor data and annotations that were previously stored
   using the StorageWriter annotator. It handles data deserialization and
   restoration of the Common Analysis Structure (CAS) views.

   :ivar storage: MongoDB storage interface
   :type storage: robokudo.io.storage.Storage
   :ivar reader: List-based reader for MongoDB data
   :type reader: robokudo.io.storage.Storage.ListReader


   .. py:attribute:: storage


   .. py:attribute:: reader


   .. py:method:: has_new_data()

      Check if more data is available to read.

      Handles looping behavior based on camera configuration and
      maintains cursor position in the data sequence.

      :return: True if more data is available, False otherwise
      :rtype: bool



   .. py:method:: set_data(cas: robokudo.cas.CAS)

      Update the Common Analysis Structure with data from storage.

      This method:
      * Retrieves the next frame from storage
      * Restores views and annotations
      * Updates camera intrinsics
      * Sets depth availability flag

      :param cas: Common Analysis Structure to update
      :type cas: robokudo.cas.CAS