:orphan:

:orphan:

Image Renderer
==============

.. raw:: html

    <iframe width="560" height="315" src="https://www.youtube.com/embed/84sWTNgUvUU" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

|

Description
-----------

The Image Renderer displays a georeferenced image that is automatically reprojected and fit to the user's data.  The image may be offset by a height variable to show bathymetry or mountainous terrain.

Basic Controls
--------------

This renderer contains a subset of Vapor's standard renderer controls: the :ref:`Variables <variablesTab>`, :ref:`Appearance <appearanceTab>`, and :ref:`Geometry <geometryTab>` tabs.

The Image Renderer's Appearance tab does not contain a transfer function since it is not rendering any variable with color or opacity.

Georeferenced Images
--------------------

Georeferenced images may be selected in the Appearance tab.  Vapor comes bundled with two georeferenced image products: *NaturalEarth*, and *BigBlueMarble*.  However these are global images that may not have the resolution you need, depending on the size of your simulation domain.

The example below (makeGeotiff.py) will show you how to generate your own georeferenced image using NASA's WorldView map server.  For a list of available WorldView layers, you can see :ref:`this document <worldViewLayers>`.  These layers can also be previewed at `NASA's EarthView webpage <https://worldview.earthdata.nasa.gov/>`_.

.. include:: ../commonControls/heightVariable.rst



.. raw:: html

    <div class="sphx-glr-thumbnails">


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="It performs the the following:    - Takes user-specified lat/lon coordinates to query NASA&#x27;s Wo...">

.. only:: html

  .. image:: /vaporApplicationReference/imageRenderer/images/thumb/sphx_glr_makeGeotiff_thumb.png
    :alt: makeGeotiff.py

  :ref:`sphx_glr_vaporApplicationReference_imageRenderer_makeGeotiff.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">makeGeotiff.py</div>
    </div>


.. raw:: html

    </div>


.. toctree::
   :hidden:

   /vaporApplicationReference/imageRenderer/makeGeotiff


.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-gallery

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

      :download:`Download all examples in Python source code: imageRenderer_python.zip </vaporApplicationReference/imageRenderer/imageRenderer_python.zip>`

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

      :download:`Download all examples in Jupyter notebooks: imageRenderer_jupyter.zip </vaporApplicationReference/imageRenderer/imageRenderer_jupyter.zip>`


.. only:: html

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

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