:py:mod:`geovista.pantry`
=========================

.. py:module:: geovista.pantry

.. autoapi-nested-parse::

   
   Download, cache and load geovista assets.













   .. rubric:: Notes

   .. versionadded:: 0.5.0



   ..
       !! processed by numpydoc !!


Submodules
----------
.. toctree::
   :titlesonly:
   :maxdepth: 1

   data/index.rst
   meshes/index.rst
   textures/index.rst


Package Contents
----------------


Functions
~~~~~~~~~

.. autoapisummary::

   geovista.pantry.fetch_coastlines
   geovista.pantry.fetch_raster



.. py:function:: fetch_coastlines(resolution = None)

   
   Get the Natural Earth coastlines for the required resolution.

   If the resource is not already available in the geovista
   :data:`geovista.cache.CACHE`, then it will be downloaded from the
   :data:`geovista.cache.BASE_URL`.

   :Parameters:

       **resolution** : :class:`python:str`, optional
           The resolution of the Natural Earth coastlines, which may be either
           ``110m``, ``50m`` or ``10m``. Defaults to
           :data:`geovista.common.COASTLINES_RESOLUTION`.



   :Returns:

       :obj:`PolyData <pyvista.PolyData>`
           The coastlines mesh.








   .. rubric:: Notes

   .. versionadded:: 0.1.0



   ..
       !! processed by numpydoc !!

.. py:function:: fetch_raster(fname)

   
   Download, uncompress and cache a raster file.

   If the resource is not already available in the geovista
   :data:`geovista.cache.CACHE`, then it will be downloaded from the
   :data:`geovista.cache.BASE_URL`.

   :Parameters:

       **fname** : :class:`python:str`
           The name of the raster file to be downloaded, uncompressed and cached.



   :Returns:

       :obj:`Path <pathlib.Path>`
           The absolute path to the raster file.








   .. rubric:: Notes

   .. versionadded:: 0.5.0



   ..
       !! processed by numpydoc !!