.. _sphx_glr_auto_examples_03-projectiles_and_scaling:

.. _gal-projectiles_and_scaling:

Projectiles and Scaling
=======================

This section provides examples of the use of the :ref:`api-projectile` and :ref:`api-scaling` components of Cratermaker to model projectil populations and projectile-crater size scaling relationships.


.. 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 demonstrates how to generate and visualize random impact angles for projectiles using cratermaker.">

.. only:: html

  .. image:: /auto_examples/03-projectiles_and_scaling/images/thumb/sphx_glr_3.5-plot_projectile_impact_angle_thumb.png
    :alt:

  :doc:`/auto_examples/03-projectiles_and_scaling/3.5-plot_projectile_impact_angle`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Plot random projectile impact angles</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates the generation of random velocities using the :pyget_random_velocity function from the api-utils-montecarlo module. The expected distribution of imapct velocities is a modified Maxwell-Boltzmann distribution. The modification is related to the relationship between the mean velocity and the escape velocity. If vmean &gt; vescape, then the distribution will adjusted so that the escape velocity is the minimum velocity by computing an encounter velocity then summing the encounter and escape velocities in quadrature. If vmean &lt; vescape, then the distirbution will be a truncated maxwellian.">

.. only:: html

  .. image:: /auto_examples/03-projectiles_and_scaling/images/thumb/sphx_glr_3.4-plot_projectile_random_velocity_thumb.png
    :alt:

  :doc:`/auto_examples/03-projectiles_and_scaling/3.4-plot_projectile_random_velocity`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Plot a distribution of random velocities given a mean</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates the generation of random impact locations.">

.. only:: html

  .. image:: /auto_examples/03-projectiles_and_scaling/images/thumb/sphx_glr_3.3-plot_projectile_random_location_thumb.png
    :alt:

  :doc:`/auto_examples/03-projectiles_and_scaling/3.3-plot_projectile_random_location`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Plot a distribution of random locations</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to use the ug-scaling class to calculate the simple-to-complex transition diameter as a function of surface gravity bodies using the Monte Carlo scaling model. Because the scaling model is non-deterministic, we sample each body 100 times to get a distribution of transition diameters. We plot the mean and standard deviation of the transition diameter is plotted for each body, showing results that resemble Fig. 7 of Schenk et al. (2021) [#]_.">

.. only:: html

  .. image:: /auto_examples/03-projectiles_and_scaling/images/thumb/sphx_glr_3.1-plot_transition_diameter_thumb.png
    :alt:

  :doc:`/auto_examples/03-projectiles_and_scaling/3.1-plot_transition_diameter`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">The simple-to-complex transition diameter</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to use the ug-scaling class to calculate the final crater diameter for different planetary bodies.  Normally, the scaling component would not be invoked manually like this. Instead, the scaling model is used internally by the ug-crater component. This example demonstrates how the scaling model can be used on its own.">

.. only:: html

  .. image:: /auto_examples/03-projectiles_and_scaling/images/thumb/sphx_glr_3.2-plot_projectile_to_crater_scaling_thumb.png
    :alt:

  :doc:`/auto_examples/03-projectiles_and_scaling/3.2-plot_projectile_to_crater_scaling`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Crater scaling for various planetary surfaces</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /auto_examples/03-projectiles_and_scaling/3.5-plot_projectile_impact_angle
   /auto_examples/03-projectiles_and_scaling/3.4-plot_projectile_random_velocity
   /auto_examples/03-projectiles_and_scaling/3.3-plot_projectile_random_location
   /auto_examples/03-projectiles_and_scaling/3.1-plot_transition_diameter
   /auto_examples/03-projectiles_and_scaling/3.2-plot_projectile_to_crater_scaling