.. ############################################################################
.. # Copyright (c) Lawrence Livermore National Security, LLC and other Ascent
.. # Project developers. See top-level LICENSE AND COPYRIGHT files for dates and
.. # other details. No copyright assignment is required to contribute to Ascent.
.. ############################################################################

.. _tutorial_intro:

Introduction to Ascent
=============================

.. toctree::
   Tutorial_Intro_First_Light
   Tutorial_Intro_Conduit_Basics
   Tutorial_Intro_Conduit_Blueprint
   Tutorial_Intro_Scenes   
   Tutorial_Intro_Pipelines
   Tutorial_Intro_Extracts
   Tutorial_Intro_Queries
   Tutorial_Intro_Triggers
   Tutorial_Intro_Binning

All Intro Examples
----------------------

Tutorial Notebooks
~~~~~~~~~~~~~~~~~~~

* First Light:  :download:`01_ascent_first_light.ipynb <../../../src/examples/tutorial/ascent_intro/notebooks/01_ascent_first_light.ipynb>`
* Conduit Basics:  :download:`02_conduit_basics.ipynb <../../../src/examples/tutorial/ascent_intro/notebooks/02_conduit_basics.ipynb>`
* Conduit Blueprint Mesh Examples: :download:`03_conduit_blueprint_mesh_examples.cpp <../../../src/examples/tutorial/ascent_intro/notebooks/03_conduit_blueprint_mesh_examples.ipynb>`
* Scene Examples:    :download:`04_ascent_scene_examples.cpp <../../../src/examples/tutorial/ascent_intro/notebooks/04_ascent_scene_examples.ipynb>`
* Pipeline Examples: :download:`05_ascent_pipeline_examples.cpp <../../../src/examples/tutorial/ascent_intro/notebooks/05_ascent_pipeline_examples.ipynb>`
* Extract Examples:  :download:`06_ascent_extract_examples.ipynb <../../../src/examples/tutorial/ascent_intro/notebooks/06_ascent_extract_examples.ipynb>`
* Query Examples:  :download:`07_ascent_query_examples.ipynb <../../../src/examples/tutorial/ascent_intro/notebooks/07_ascent_query_examples.ipynb>`
* Trigger Examples:  :download:`08_ascent_trigger_examples.ipynb <../../../src/examples/tutorial/ascent_intro/notebooks/08_ascent_trigger_examples.ipynb>`
* Binning Examples:  :download:`09_ascent_binning_examples.ipynb <../../../src/examples/tutorial/ascent_intro/notebooks/09_ascent_binning_examples.ipynb>`


C++ Examples
~~~~~~~~~~~~~~~

Example Makefile:
 * :download:`Makefile <../../../src/examples/tutorial/ascent_intro/cpp/Makefile>`

First Light:
 * :download:`ascent_example1.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_first_light_example.cpp>`

Conduit Basics:
 * :download:`conduit_example1.cpp <../../../src/examples/tutorial/ascent_intro/cpp/conduit_example1.cpp>`
 * :download:`conduit_example2.cpp <../../../src/examples/tutorial/ascent_intro/cpp/conduit_example2.cpp>`
 * :download:`conduit_example3.cpp <../../../src/examples/tutorial/ascent_intro/cpp/conduit_example3.cpp>`
 * :download:`conduit_example4.cpp <../../../src/examples/tutorial/ascent_intro/cpp/conduit_example4.cpp>`

Conduit Blueprint Mesh Examples:
 * :download:`blueprint_example2.cpp <../../../src/examples/tutorial/ascent_intro/cpp/blueprint_example1.cpp>`
 * :download:`blueprint_example2.cpp <../../../src/examples/tutorial/ascent_intro/cpp/blueprint_example2.cpp>`
 * :download:`blueprint_example2.cpp <../../../src/examples/tutorial/ascent_intro/cpp/blueprint_example3.cpp>`

Scene Examples:
 * :download:`ascent_scene_example1.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_scene_example1.cpp>`
 * :download:`ascent_scene_example2.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_scene_example2.cpp>`
 * :download:`ascent_scene_example3.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_scene_example3.cpp>`
 * :download:`ascent_scene_example4.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_scene_example4.cpp>`


Pipeline Examples:
 * :download:`ascent_pipeline_example1.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_pipeline_example1.cpp>`
 * :download:`ascent_pipeline_example2.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_pipeline_example2.cpp>`
 * :download:`ascent_pipeline_example3.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_pipeline_example3.cpp>`


Extract Examples:
 * :download:`ascent_extract_example1.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_extract_example1.cpp>`
 * :download:`ascent_extract_example2.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_extract_example2.cpp>`
 * :download:`ascent_extract_example2.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_extract_example3.cpp>`

Query Examples:
 * :download:`ascent_query_example1.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_query_example1.cpp>`

Trigger Examples:
 * :download:`ascent_trigger_example1.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_trigger_example1.cpp>`

Binning Examples:
 * :download:`ascent_binning_example1.cpp <../../../src/examples/tutorial/ascent_intro/cpp/ascent_binning_example1.cpp>`


Python Examples
~~~~~~~~~~~~~~~

First Light:
 * :download:`ascent_example1.py <../../../src/examples/tutorial/ascent_intro/python/ascent_first_light_example.py>`

Conduit Basics:
 * :download:`conduit_example1.py <../../../src/examples/tutorial/ascent_intro/python/conduit_example1.py>`
 * :download:`conduit_example2.py <../../../src/examples/tutorial/ascent_intro/python/conduit_example2.py>`
 * :download:`conduit_example3.py <../../../src/examples/tutorial/ascent_intro/python/conduit_example3.py>`
 * :download:`conduit_example4.py <../../../src/examples/tutorial/ascent_intro/python/conduit_example4.py>`

Conduit Blueprint Mesh Examples:
 * :download:`blueprint_example2.py <../../../src/examples/tutorial/ascent_intro/python/blueprint_example1.py>`
 * :download:`blueprint_example2.py <../../../src/examples/tutorial/ascent_intro/python/blueprint_example2.py>`
 * :download:`blueprint_example2.py <../../../src/examples/tutorial/ascent_intro/python/blueprint_example3.py>`

Scene Examples:
 * :download:`ascent_scene_example1.py <../../../src/examples/tutorial/ascent_intro/python/ascent_scene_example1.py>`
 * :download:`ascent_scene_example2.py <../../../src/examples/tutorial/ascent_intro/python/ascent_scene_example2.py>`
 * :download:`ascent_scene_example3.py <../../../src/examples/tutorial/ascent_intro/python/ascent_scene_example3.py>`
 * :download:`ascent_scene_example4.py <../../../src/examples/tutorial/ascent_intro/python/ascent_scene_example4.py>`


Pipeline Examples:
 * :download:`ascent_pipeline_example1.py <../../../src/examples/tutorial/ascent_intro/python/ascent_pipeline_example1.py>`
 * :download:`ascent_pipeline_example2.py <../../../src/examples/tutorial/ascent_intro/python/ascent_pipeline_example2.py>`
 * :download:`ascent_pipeline_example3.py <../../../src/examples/tutorial/ascent_intro/python/ascent_pipeline_example3.py>`


Extract Examples:
 * :download:`ascent_extract_example1.py <../../../src/examples/tutorial/ascent_intro/python/ascent_extract_example1.py>`
 * :download:`ascent_extract_example2.py <../../../src/examples/tutorial/ascent_intro/python/ascent_extract_example2.py>`
 * :download:`ascent_extract_example2.py <../../../src/examples/tutorial/ascent_intro/python/ascent_extract_example3.py>`

Query Examples:
 * :download:`ascent_query_example1.py <../../../src/examples/tutorial/ascent_intro/python/ascent_query_example1.py>`

Trigger Examples:
 * :download:`ascent_trigger_example1.py <../../../src/examples/tutorial/ascent_intro/python/ascent_trigger_example1.py>`

Binning Examples:
 * :download:`ascent_binning_example1.py <../../../src/examples/tutorial/ascent_intro/python/ascent_binning_example1.py>`