MVDatasets
==========

Welcome to the documentation of the MVDatasets: Standardized DataLoaders for 3D Computer Vision.
Have a look around and feel free to reach out if you have any questions or suggestions.
Examples are the best way to get started!

⚠️ This is a work in progress research codebase designed with a focus on modularity; future updates *will try* not to disrupt existing functionalities.

--------

.. toctree::
   :maxdepth: 1
   :caption: Get started

   source/installation
   source/examples
   source/datasets

------------

.. toctree::
   :maxdepth: 1
   :caption: Main Modules

   source/camera
   source/mvdataset
   source/datasplit
   source/tensorreel

---------------

.. toctree::
   :maxdepth: 1
   :caption: Utility Modules

   source/io/index
   source/geometry/index
   source/loaders/index
   source/utils/index
   source/visualization/index

---------------

License
-------

This project is licensed under the Creative Commons Attribution 4.0 International License (CC BY 4.0).
You are free to use, modify, and distribute this code as long as you provide proper attribution to the original author(s).

Citation
--------

If you use this library for your research, please consider citing:

.. code-block:: bibtex

   @misc{Esposito2024MVDatasets,
      author       = {Stefano Esposito and Andreas Geiger},
      title        = {MVDatasets: Standardized DataLoaders for 3D Computer Vision},
      year         = {2025},
      url          = {https://github.com/autonomousvision/mvdatasets},
      note         = {GitHub repository}
   }

------------

.. toctree::
   :maxdepth: 1
   :caption: Credits

   source/bibliography