geovista.pantry.data ==================== .. py:module:: geovista.pantry.data .. autoapi-nested-parse:: Download, cache and load geovista sample data. Notes ----- .. versionadded:: 0.5.0 .. !! processed by numpydoc !! Attributes ---------- .. autoapisummary:: geovista.pantry.data.CLOUD_AMOUNT_PREFERENCE Classes ------- .. autoapisummary:: geovista.pantry.data.CloudPreference geovista.pantry.data.SampleGridXYZ geovista.pantry.data.SamplePointsXYZ geovista.pantry.data.SampleStructuredXY geovista.pantry.data.SampleUnstructuredXY geovista.pantry.data.SampleVectorsXYUVW Functions --------- .. autoapisummary:: geovista.pantry.data.capitalise geovista.pantry.data.cloud_amount geovista.pantry.data.dynamico geovista.pantry.data.fesom geovista.pantry.data.fvcom_tamar geovista.pantry.data.icon_soil geovista.pantry.data.lam_equator geovista.pantry.data.lam_falklands geovista.pantry.data.lam_london geovista.pantry.data.lam_new_zealand geovista.pantry.data.lam_pacific geovista.pantry.data.lam_polar geovista.pantry.data.lam_uk geovista.pantry.data.lfric_orog geovista.pantry.data.lfric_sst geovista.pantry.data.lfric_winds geovista.pantry.data.name_reykjanes geovista.pantry.data.nemo_orca2 geovista.pantry.data.nemo_orca2_gradient geovista.pantry.data.oisst_avhrr_sst geovista.pantry.data.usgs_earthquakes geovista.pantry.data.ww3_global_smc geovista.pantry.data.ww3_global_tri Module Contents --------------- .. py:class:: CloudPreference Bases: :py:obj:`geovista.common.StrEnumPlus` Enumeration of mesh types for cloud amount. Notes ----- .. versionadded:: 0.4.0 Initialize self. See help(type(self)) for accurate signature. .. !! processed by numpydoc !! .. py:attribute:: HIGH :value: 'high' .. py:attribute:: LOW :value: 'low' .. py:attribute:: MEDIUM :value: 'medium' .. py:attribute:: MESH :value: 'mesh' .. py:attribute:: VERY_HIGH :value: 'very_high' .. py:class:: SampleGridXYZ Data container for structured grid. .. !! processed by numpydoc !! .. py:attribute:: data :type: numpy.typing.ArrayLike | None :value: None .. py:attribute:: name :type: str | None :value: None .. py:attribute:: poi :type: geopy.location.Location | None :value: None .. py:attribute:: units :type: str | None :value: None .. py:attribute:: xs :type: numpy.typing.ArrayLike .. py:attribute:: ys :type: numpy.typing.ArrayLike .. py:attribute:: zs :type: numpy.typing.ArrayLike .. py:class:: SamplePointsXYZ Data container for point cloud. .. !! processed by numpydoc !! .. py:attribute:: data :type: numpy.typing.ArrayLike | None :value: None .. py:attribute:: lats :type: numpy.typing.ArrayLike .. py:attribute:: lons :type: numpy.typing.ArrayLike .. py:attribute:: name :type: str | None :value: None .. py:attribute:: steps :type: int | None :value: None .. py:attribute:: units :type: str | None :value: None .. py:attribute:: zlevel :type: numpy.typing.ArrayLike .. py:class:: SampleStructuredXY Data container for structured surface. .. !! processed by numpydoc !! .. py:attribute:: data :type: numpy.typing.ArrayLike | None :value: None .. py:attribute:: lats :type: numpy.typing.ArrayLike .. py:attribute:: lons :type: numpy.typing.ArrayLike .. py:attribute:: name :type: str | None :value: None .. py:attribute:: steps :type: int | None :value: None .. py:attribute:: units :type: str | None :value: None .. py:class:: SampleUnstructuredXY Data container for unstructured surface. .. !! processed by numpydoc !! .. py:attribute:: connectivity :type: numpy.typing.ArrayLike .. py:attribute:: data :type: numpy.typing.ArrayLike | None :value: None .. py:attribute:: face :type: numpy.typing.ArrayLike | None :value: None .. py:attribute:: lats :type: numpy.typing.ArrayLike .. py:attribute:: lons :type: numpy.typing.ArrayLike .. py:attribute:: name :type: str | None :value: None .. py:attribute:: node :type: numpy.typing.ArrayLike | None :value: None .. py:attribute:: start_index :type: int | None :value: None .. py:attribute:: steps :type: int | None :value: None .. py:attribute:: units :type: str | None :value: None .. py:class:: SampleVectorsXYUVW Data container for vector information on unconnected points. .. !! processed by numpydoc !! .. py:attribute:: lats :type: numpy.typing.ArrayLike .. py:attribute:: lons :type: numpy.typing.ArrayLike .. py:attribute:: name :type: str | None :value: None .. py:attribute:: steps :type: int | None :value: None .. py:attribute:: u :type: numpy.typing.ArrayLike .. py:attribute:: units :type: str | None :value: None .. py:attribute:: v :type: numpy.typing.ArrayLike .. py:attribute:: w :type: numpy.typing.ArrayLike :value: None .. py:function:: capitalise(title) Capitalise each word and replace inappropriate characters. :Parameters: **title** : :class:`python:str` The string title to be reformatted. :Returns: :class:`python:str` The capitalised title. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: cloud_amount(*, preference = None) Download and cache unstructured cloud amount data. Load Met Office LFRic c768 unstructured cubed-sphere quad-mesh cloud amount data. :Parameters: **preference** : :class:`python:str` or :obj:`CloudPreference `, optional The cloud type, which may be ``low``, ``medium``, ``high``, ``very_high`` or ``mesh``. Defaults to ``mesh``, the c768 mesh with no data payload attached. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.4.0 .. !! processed by numpydoc !! .. py:function:: dynamico() Download and cache unstructured surface sample data. Load DYNAMICO icosahedral unstructured mesh. :Returns: :obj:`SampleUnstructuredXY` The hexagonal/pentagonal unstructured spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.3.0 .. !! processed by numpydoc !! .. py:function:: fesom() Download and cache unstructured surface sample data. Load AWI-CM FESOM 1.4 unstructured mesh. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: fvcom_tamar() Download and cache unstructured surface sample data. Load PML FVCOM unstructured mesh. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: icon_soil() Download and cache unstructured surface sample data. Load Icosahedral Nonhydrostatic Weather and Climate Model (ICON) global 160km resolution (R02B04 grid) triangular mesh. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.1.0 .. rubric:: References Sourced from http://icon-downloads.mpimet.mpg.de/dwd_grids.xml .. only:: latex .. !! processed by numpydoc !! .. py:function:: lam_equator() Download and cache unstructured surface sample data. Load the GungHo C4 cubed-sphere LAM unstructured mesh located over the equator. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and connectivity. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: lam_falklands() Download and cache unstructured surface sample data. Load the GungHo C4 cubed-sphere LAM unstructured mesh located over the Falkland Islands. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and connectivity. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: lam_london() Download and cache unstructured surface sample data. Load the GungHo C4 cubed-sphere LAM unstructured mesh located over London, UK. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and connectivity. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: lam_new_zealand() Download and cache unstructured surface sample data. Load the GungHo C4 cubed-sphere LAM unstructured mesh located over New Zealand. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and connectivity. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: lam_pacific() Download and cache unstructured surface sample data. Load a high-resolution LAM unstructured mesh located over the Pacific Ocean. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: lam_polar() Download and cache unstructured surface sample data. Load the GungHo C4 cubed-sphere LAM unstructured mesh located over the Polar cap. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and connectivity. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: lam_uk() Download and cache unstructured surface sample data. Load the GungHo C4 cubed-sphere LAM unstructured mesh located over the UK. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and connectivity. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: lfric_orog() Download and cache unstructured surface sample data. Load CF UGRID global nodal orography unstructured mesh. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: lfric_sst() Download and cache unstructured surface sample data. Load CF UGRID global unstructured mesh. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: lfric_winds() Download and cache unstructured 3D winds sample. This data is derived from the LFRic test suite. :Returns: :obj:`SampleVectorsXYUVW` Data payload with XY spatial coordinates and UVW wind components. .. rubric:: Notes .. versionadded:: 0.6.0 .. !! processed by numpydoc !! .. py:function:: name_reykjanes() Download and cache structured grid sample. Load NAME Reykjanes structured grid. :Returns: :obj:`SampleGridXYZ` The structured grid spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.6.0 .. !! processed by numpydoc !! .. py:function:: nemo_orca2() Download and cache structured surface sample data. Load NEMO ORCA2 curvilinear mesh. :Returns: :obj:`SampleStructuredXY` The curvilinear spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: nemo_orca2_gradient() Download and cache point-cloud sample data. Load NEMO ORCA2 curvilinear mesh with gradient filter. :Returns: :obj:`SamplePointsXYZ` The gradient filtered spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.2.0 .. !! processed by numpydoc !! .. py:function:: oisst_avhrr_sst() Download and cache structured surface sample data. Load NOAA/NCEI OISST AVHRR rectilinear mesh. :Returns: :obj:`SampleStructuredXY` The curvilinear spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: usgs_earthquakes() Download and cache the USGS HoloViz large earthquake dataset. :Returns: :obj:`SamplePointsXYZ` The spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.4.0 .. !! processed by numpydoc !! .. py:function:: ww3_global_smc(*, step = None) Download and cache unstructured surface sample data. Load the WAVEWATCH III (WW3) unstructured Spherical Multi-Cell (SMC) mesh. :Parameters: **step** : :class:`python:int`, default=0 The time-series offset. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:function:: ww3_global_tri() Download and cache unstructured surface sample data. Load the WAVEWATCH III (WW3) unstructured triangular mesh. :Returns: :obj:`SampleUnstructuredXY` The unstructured spatial coordinates and data payload. .. rubric:: Notes .. versionadded:: 0.1.0 .. !! processed by numpydoc !! .. py:data:: CLOUD_AMOUNT_PREFERENCE :type: str :value: 'mesh' The default type of cloud amount mesh. .. !! processed by numpydoc !!