.. _sphx_glr_auto_examples_01-simulation_and_visualization:

.. _gal-simulation:

Simuation and Visualization
===========================

This section provides examples of how to run simulations using the main :ref:`api-simulation` component of Cratermaker to emplace craters on a surface and visualize the results with various tools.


.. raw:: html

  <div id='sg-tag-list' class='sphx-glr-tag-list'></div>


.. raw:: html

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

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to emplace a single large crater on the Moon using Cratermaker&#x27;s Simulation.emplace() method. The crater is defined with a specific diameter and location. The final surface is exported and visualized using PyVista.">

.. only:: html

  .. image:: /auto_examples/01-simulation_and_visualization/images/thumb/sphx_glr_1.1-visualize_one_crater_thumb.png
    :alt:

  :doc:`/auto_examples/01-simulation_and_visualization/1.1-visualize_one_crater`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Manually emplace a single crater on the Moon and visualize it with PyVista</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to use the DataSurface to fetch real DEM data for a local region on the Moon. In this case, we center the surface on Kepler crater (321.9913E, 8.121N) with a radius of 50 km and a resolution of 200 m/pix. We then visualize the surface using PyVista both with and without the superdomain.">

.. only:: html

  .. image:: /auto_examples/01-simulation_and_visualization/images/thumb/sphx_glr_1.5-Kepler_crater_datasurface_thumb.png
    :alt:

  :doc:`/auto_examples/01-simulation_and_visualization/1.5-Kepler_crater_datasurface`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Create a DataSurface centered on Kepler crater</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to load arbitrary DEM data using the data composer.">

.. only:: html

  .. image:: /auto_examples/01-simulation_and_visualization/images/thumb/sphx_glr_1.7-load_phobos_dem_thumb.png
    :alt:

  :doc:`/auto_examples/01-simulation_and_visualization/1.7-load_phobos_dem`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Load a DEM of phobos</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to run a crater population simulation on the Moon and visualize the final surface using PyVista.">

.. only:: html

  .. image:: /auto_examples/01-simulation_and_visualization/images/thumb/sphx_glr_1.2-Moon_simulation_pyvista_thumb.png
    :alt:

  :doc:`/auto_examples/01-simulation_and_visualization/1.2-Moon_simulation_pyvista`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Run a simulation of the Moon and visualize with PyVista</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to run a lunar simulation in &#x27;Quasi-Monte Carlo&#x27; mode, where the largest craters are read from a csv file that gives their diameters and locations, along with one or more columns that indicate an emplacement time or time range.  For details, see ug-production-quasimc for details.">

.. only:: html

  .. image:: /auto_examples/01-simulation_and_visualization/images/thumb/sphx_glr_1.8-Moon_quasimc_thumb.png
    :alt:

  :doc:`/auto_examples/01-simulation_and_visualization/1.8-Moon_quasimc`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Run a simulation of the Moon with basins emplaced using QuasiMC mode</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to emplace a crater at a specific distance and bearing from the center of a HiResLocalSurface using the new relative_location arguments that can be passed to the emplace method. This is useful to place a crater on a HiResLocalSurface at a specific location relative to the center without trying to figure out what lat,lon coordinates to use. In this example, we will emplace a sequence of craters in a spiral pattern. This not meant to be a realistic planetary surface, but it looks pretty cool!">

.. only:: html

  .. image:: /auto_examples/01-simulation_and_visualization/images/thumb/sphx_glr_1.6-emplace_crater_at_distance_thumb.png
    :alt:

  :doc:`/auto_examples/01-simulation_and_visualization/1.6-emplace_crater_at_distance`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Emplace a crater a specific distance and bearing from the center of a HiResLocalSurface</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Cratermaker can export Simulation data to a variety of GIS vector formats, including GeoPackage, ESRI Shapefile, and more. We do this using the GeoPandas library, which provides a set of useful tools for working with geospatial data in Python. Using the &quot;driver&quot; argument of the export method, you can export to just about any format supported by GeoPandas (see here). This is the same tool used to export data as a mesh in VTK format using the &quot;VTK&quot; driver, which does not use GeoPandas.">

.. only:: html

  .. image:: /auto_examples/01-simulation_and_visualization/images/thumb/sphx_glr_1.4-export_to_geopackage_thumb.png
    :alt:

  :doc:`/auto_examples/01-simulation_and_visualization/1.4-export_to_geopackage`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Export Cratermaker data to GeoPackage and visualize with GeoPandas</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to use the HiResLocal Surface to run a crater population over a small region of a planet, in this case Mars.">

.. only:: html

  .. image:: /auto_examples/01-simulation_and_visualization/images/thumb/sphx_glr_1.3-mars_simulation_pyvista_thumb.png
    :alt:

  :doc:`/auto_examples/01-simulation_and_visualization/1.3-mars_simulation_pyvista`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Run a simulation of a local region on Mars.</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /auto_examples/01-simulation_and_visualization/1.1-visualize_one_crater
   /auto_examples/01-simulation_and_visualization/1.5-Kepler_crater_datasurface
   /auto_examples/01-simulation_and_visualization/1.7-load_phobos_dem
   /auto_examples/01-simulation_and_visualization/1.2-Moon_simulation_pyvista
   /auto_examples/01-simulation_and_visualization/1.8-Moon_quasimc
   /auto_examples/01-simulation_and_visualization/1.6-emplace_crater_at_distance
   /auto_examples/01-simulation_and_visualization/1.4-export_to_geopackage
   /auto_examples/01-simulation_and_visualization/1.3-mars_simulation_pyvista