.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "generated/gallery/warp/from_unstructured__lfric_orog_eqc.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_warp_from_unstructured__lfric_orog_eqc.py>`
        to download the full example code.

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

.. _sphx_glr_generated_gallery_warp_from_unstructured__lfric_orog_eqc.py:


LFRic Orography (Projected)
---------------------------

This example demonstrates how to render a projected warped unstructured
cubed-sphere mesh.

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

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

It uses an unstructured Met Office LFRic C48 cubed-sphere of surface altitude
data.

The resulting mesh contains quad cells and is constructed from CF UGRID unstructured
cell points and connectivity.

The mesh is transformed onto an Equidistant Cylindrical (Plate Carrée)
projection.

Note that the scalar elevation values are located on the mesh nodes/points
which results in the rendered colours being interpolated across the cell faces.
A ``pyvista`` "warp" operation extrudes the mesh, using the same node altitude
values, to highlight the global surface topography.

The warp uses :meth:`~pyvista.PolyDataFilters.compute_normals` and
:meth:`~pyvista.DataSetFilters.warp_by_scalar`. See
`Computing Surface Normals <https://docs.pyvista.org/version/stable/examples/01-filter/compute-normals.htm>`_
for further details.

.. tags:: Projection, Transform Mesh, Unstructured, Warp

----

.. GENERATED FROM PYTHON SOURCE LINES 44-98







.. tab-set::



   .. tab-item:: Static Scene



            
     .. image-sg:: /generated/gallery/warp/images/sphx_glr_from_unstructured__lfric_orog_eqc_001.png
        :alt: from unstructured  lfric orog eqc
        :srcset: /generated/gallery/warp/images/sphx_glr_from_unstructured__lfric_orog_eqc_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/warp/images/sphx_glr_from_unstructured__lfric_orog_eqc_001.vtksz






.. code-block:: Python


    from __future__ import annotations

    import geovista as gv
    from geovista.pantry.data import lfric_orog
    import geovista.theme
    from geovista.transform import transform_mesh


    def main() -> None:
        """Plot a projected warped LFRic unstructured mesh.

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

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

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

        # Transform the mesh to the Plate Carrée projection.
        mesh = transform_mesh(mesh, crs := "esri:54001")

        # Warp the mesh nodes by the surface altitude.
        mesh.compute_normals(cell_normals=False, point_normals=True, inplace=True)
        mesh.warp_by_scalar(scalars=sample.name, inplace=True, factor=200)

        # Plot the unstructured mesh.
        plotter = gv.GeoPlotter(crs=crs)
        sargs = {"title": f"{sample.name} / {sample.units}", "shadow": True}
        plotter.add_mesh(mesh, scalar_bar_args=sargs)
        plotter.add_axes()
        plotter.add_text(
            f"LFRic C48 Unstructured Cube-Sphere ({crs})",
            position="upper_left",
            font_size=10,
            shadow=True,
        )
        plotter.view_xy()
        plotter.camera.zoom(1.5)
        plotter.show()


    if __name__ == "__main__":
        main()


.. _sphx_glr_download_generated_gallery_warp_from_unstructured__lfric_orog_eqc.py:

.. only:: html

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

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

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

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

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

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

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


.. only:: html

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

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