coronagraphoto.datasets
=======================

.. py:module:: coronagraphoto.datasets

.. autoapi-nested-parse::

   Data management utilities for coronagraphoto.

   Fetches example data files for testing and documentation. The example
   coronagraph YIP is delegated to ``yippy.fetch_yip`` so there is exactly
   one canonical YIP hosting location across the workspace; example
   ExoVista scenes still come from the coronalyze raw data folder.

   Example:
       >>> from coronagraphoto.datasets import fetch_coronagraph, fetch_scene
       >>> coro_path = fetch_coronagraph()
       >>> scene_path = fetch_scene()



Attributes
----------

.. autoapisummary::

   coronagraphoto.datasets.REGISTRY
   coronagraphoto.datasets.PIKACHU


Functions
---------

.. autoapisummary::

   coronagraphoto.datasets.fetch_coronagraph
   coronagraphoto.datasets.fetch_scene
   coronagraphoto.datasets.fetch_all


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

.. py:data:: REGISTRY

.. py:data:: PIKACHU

.. py:function:: fetch_coronagraph()

   Fetch and unpack the example coronagraph YIP.

   Delegates to ``yippy.fetch_yip("eac1_aavc_2d")`` so coronagraphoto
   reuses yippy's canonical YIP cache instead of duplicating hosting.

   Returns:
       Path to the coronagraph directory.


.. py:function:: fetch_scene()

   Fetch and unpack example ExoVista scene data.

   Downloads a modified Solar System scene for demonstration.

   Returns:
       Path to the ExoVista FITS file.


.. py:function:: fetch_all()

   Fetch all example data.

   Returns:
       Tuple of (coronagraph_path, scene_path).