.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "generated/gallery/unstructured/lfric_sst.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_generated_gallery_unstructured_lfric_sst.py>`
        to download the full example code.

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_generated_gallery_unstructured_lfric_sst.py:


LFRic Mesh
----------

This example demonstrates how to render an unstructured quadrilateral mesh.

📋 Summary
^^^^^^^^^^

Creates a mesh from 1-D latitude and longitude unstructured points and connectivity.

The resulting mesh contains quad cells. The connectivity is required to construct
the cells by indexing into the CF UGRID unstructured points.

It uses an unstructured Met Office LFRic C48 cubed-sphere of surface temperature
data located on the mesh faces/cells.

Note that, a threshold is also applied to remove land ``NaN`` cells. A Natural Earth
base layer is also rendered along with Natural Earth coastlines and a graticule.

.. tags:: Coastlines, Globe, Graticule, Unstructured, Texture, Threshold

----

.. GENERATED FROM PYTHON SOURCE LINES 32-82







.. tab-set::



   .. tab-item:: Static Scene



            
     .. image-sg:: /generated/gallery/unstructured/images/sphx_glr_lfric_sst_001.png
        :alt: lfric sst
        :srcset: /generated/gallery/unstructured/images/sphx_glr_lfric_sst_001.png
        :class: sphx-glr-single-img
     


   .. tab-item:: Interactive Scene



       .. offlineviewer:: /home/docs/checkouts/readthedocs.org/user_builds/geovista/checkouts/v0.5.3/docs/src/generated/gallery/unstructured/images/sphx_glr_lfric_sst_001.vtksz






.. code-block:: Python


    from __future__ import annotations

    import geovista as gv
    from geovista.pantry.data import lfric_sst
    import geovista.theme


    def main() -> None:
        """Plot an LFRic unstructured mesh.

        Notes
        -----
        .. versionadded:: 0.1.0

        """
        # Load the sample data.
        sample = lfric_sst()

        # Create the mesh from the sample data.
        mesh = gv.Transform.from_unstructured(
            sample.lons,
            sample.lats,
            connectivity=sample.connectivity,
            data=sample.data,
        )

        # Remove cells from the mesh with NaN values.
        mesh = mesh.threshold()

        # Plot the unstructured mesh.
        plotter = gv.GeoPlotter()
        sargs = {"title": f"{sample.name} / {sample.units}", "shadow": True}
        plotter.add_mesh(mesh, scalar_bar_args=sargs)
        plotter.add_base_layer(texture=gv.natural_earth_1())
        plotter.add_coastlines()
        plotter.add_graticule()
        plotter.add_axes()
        plotter.add_text(
            "LFRic C48 Unstructured Cube-Sphere (10m Coastlines)",
            position="upper_left",
            font_size=10,
            shadow=True,
        )
        plotter.camera.zoom(1.3)
        plotter.show()


    if __name__ == "__main__":
        main()


.. _sphx_glr_download_generated_gallery_unstructured_lfric_sst.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: lfric_sst.ipynb <lfric_sst.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: lfric_sst.py <lfric_sst.py>`

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: lfric_sst.zip <lfric_sst.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_