.. _sphx_glr_auto_examples_simulating:

.. _simulating_gallery:

**********************
Simulating Transients
**********************

.. card::
   :class-card: sd-shadow-sm gallery-banner

   *Module:* :mod:`~uvex_transients.simulation`

   Run a :class:`~uvex_transients.simulation.core.SurveySimulator` end to end: sample, screen,
   and generate synthetic photometry for individual events.


.. 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="sphx_glr_auto_examples_simulating_plot_tde_end_to_end.py starts from a whole population, Monte Carlo sampled and screened against a real SurveySchedule. A target-of-opportunity (ToO) follow-up is the opposite problem: one specific TDE, at a position and redshift already known (from an alert, say), that gets pointed at directly on whatever cadence is chosen -- no schedule, no windowed sampling, no Event.">

.. only:: html

  .. image:: /auto_examples/simulating/images/thumb/sphx_glr_plot_too_followup_thumb.png
    :alt:

  :doc:`/auto_examples/simulating/plot_too_followup`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Target-of-Opportunity Follow-up of a TDE</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A minimal example of an end-to-end simulation of transient yields from a UVEX survey schedule. In this example, we&#x27;ll determine the anticipated yield of TDEs with the default UVEX schedule. To do this, we&#x27;ll take the following steps:">

.. only:: html

  .. image:: /auto_examples/simulating/images/thumb/sphx_glr_plot_tde_end_to_end_thumb.png
    :alt:

  :doc:`/auto_examples/simulating/plot_tde_end_to_end`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">TDE End-to-End Simulation</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The primary design scope of uvex-transients is to simulate yields from UVEX&#x27;s various surveys; however, there will certainly be cases when UVEX observes sources with corresponding OIR data from ZTF / Rubin / other ground based surveys. In some cases, this may be serendipetous, but in others, it may be because the sources was discovered and classified by a ground based observatory and a TOO was triggered on UVEX.">

.. only:: html

  .. image:: /auto_examples/simulating/images/thumb/sphx_glr_plot_multiband_too_followup_thumb.png
    :alt:

  :doc:`/auto_examples/simulating/plot_multiband_too_followup`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Multi-Band ToO Follow-up</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The Morag+24 shock-cooling emission of Type IIb supernovae comes in two flavors that share the same physical parameters and the same bolometric-luminosity/color-temperature evolution, but differ in the shape of the spectrum: MoragShockCoolingBlackbodySED is a pure blackbody (Eq. A8), while MoragShockCoolingSED adds the UV line suppression and free-free correction of Eq. A7. Since UVEX observes precisely in the UV where those two disagree the most, it&#x27;s a useful test case for a follow-up campaign.">

.. only:: html

  .. image:: /auto_examples/simulating/images/thumb/sphx_glr_plot_shock_cooling_comparison_thumb.png
    :alt:

  :doc:`/auto_examples/simulating/plot_shock_cooling_comparison`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Shock-Cooling Models: Blackbody vs. Full SED</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /auto_examples/simulating/plot_too_followup
   /auto_examples/simulating/plot_tde_end_to_end
   /auto_examples/simulating/plot_multiband_too_followup
   /auto_examples/simulating/plot_shock_cooling_comparison