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

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

.. _sphx_glr_generated_gallery_unstructured_smc_sinu.py:


Spherical Multi-Cell Mesh (Projected)
-------------------------------------

This example demonstrates how to render a projected unstructured quadrilateral mesh.

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

Creates a mesh from 2D latitude and longitude unstructured cell bounds.

The resulting mesh contains quad cells.

It uses WAVEWATCH III (WW3) unstructured Spherical Multi-Cell (SMC) sea surface
wave significant height data located on mesh faces/cells.

Note that a threshold is also applied to remove land ``NaN`` cells, and a
Natural Earth base layer is rendered along with Natural Earth coastlines. The mesh
is also transformed to the Sinusoidal (Sanson-Flamsteed) pseudo-cylindrical
projection.

.. tags::

    component: coastlines, component: texture,
    domain: oceanography,
    load: unstructured,
    filter: threshold,
    projection: crs,
    version: 0.1.0

----

.. GENERATED FROM PYTHON SOURCE LINES 40-91







.. tab-set::



   .. tab-item:: Static Scene



            
     .. image-sg:: /generated/gallery/unstructured/images/sphx_glr_smc_sinu_001.png
        :alt: smc sinu
        :srcset: /generated/gallery/unstructured/images/sphx_glr_smc_sinu_001.png
        :class: sphx-glr-single-img
     


   .. tab-item:: Interactive Scene



       .. offlineviewer:: /home/docs/checkouts/readthedocs.org/user_builds/geovista-ja/checkouts/latest/geovista/docs/src/generated/gallery/unstructured/images/sphx_glr_smc_sinu_001.vtksz






.. code-block:: Python


    from __future__ import annotations

    import geovista as gv
    from geovista.pantry.data import ww3_global_smc


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

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

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

        # Create the mesh from the sample data.
        mesh = gv.Transform.from_unstructured(
            sample.lons,
            sample.lats,
            data=sample.data,
            name=f"{sample.name} / {sample.units}",
        )

        # Threshold the mesh of NaNs.
        mesh = mesh.threshold()

        # Plot the unstructured mesh.
        crs = "+proj=sinu"
        p = gv.GeoPlotter(crs=crs)
        p.add_mesh(mesh)
        p.add_base_layer(texture=gv.natural_earth_hypsometric())
        p.add_coastlines()
        p.add_text(
            f"WW3 Spherical Multi-Cell ({crs})",
            position="upper_left",
            font_size=10,
        )

        # Define a specific camera position.
        p.view_xy()
        p.camera.zoom(1.5)

        p.add_axes()
        p.show()


    if __name__ == "__main__":
        main()


.. _sphx_glr_download_generated_gallery_unstructured_smc_sinu.py:

.. only:: html

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

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

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

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

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

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

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


.. only:: html

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

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