plots.ancillary
===============

.. py:module:: plots.ancillary


Attributes
----------

.. autoapisummary::

   plots.ancillary.READERS


Exceptions
----------

.. autoapisummary::

   plots.ancillary.AmbiguousDataError
   plots.ancillary.DataNotFoundError


Functions
---------

.. autoapisummary::

   plots.ancillary.load
   plots.ancillary.remote_shp


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

.. py:exception:: AmbiguousDataError

   Bases: :py:obj:`Exception`


   Common base class for all non-exit exceptions.


.. py:exception:: DataNotFoundError

   Bases: :py:obj:`FileNotFoundError`


   File not found.


.. py:data:: READERS

.. py:function:: load(source, data_type=None)

   Load an earthkit.plots ancillary data file.

   :param source: The name of a file (with or without extension) found within
                  earthkit/plots/data.
   :type source: str
   :param data_type: If applicable, the name of the subdirectory within earthkit/plots/data
                     in which the auxilliary file will be found.
   :type data_type: str


.. py:function:: remote_shp(namespace, name, url)