.. This Software (Dioptra) is being made available as a public service by the
.. National Institute of Standards and Technology (NIST), an Agency of the United
.. States Department of Commerce. This software was developed in part by employees of
.. NIST and in part by NIST contractors. Copyright in portions of this software that
.. were developed by NIST contractors has been licensed or assigned to NIST. Pursuant
.. to Title 17 United States Code Section 105, works of NIST employees are not
.. subject to copyright protection in the United States. However, NIST may hold
.. international copyright in software created by its employees and domestic
.. copyright (or licensing rights) in portions of software that were assigned or
.. licensed to NIST. To the extent that NIST holds copyright in this software, it is
.. being made available under the Creative Commons Attribution 4.0 International
.. license (CC BY 4.0). The disclaimers of the CC BY 4.0 license apply to all parts
.. of the software developed or licensed by NIST.
..
.. ACCESS THE FULL CC BY 4.0 LICENSE HERE:
.. https://creativecommons.org/licenses/by/4.0/legalcode

.. _tutorial-learning-the-essentials:

Learning the Essentials
=================

This tutorial builds off the simple :ref:`Hello World tutorial <tutorial-hello-world-in-dioptra>` and showcases the 
core functionality of Dioptra. Throughout the sections, you will **create reusable workflows** in Dioptra of **increasing complexity**. 
Each step will iterate on the previous step, incorporating more features and functionality from Dioptra. 

Prerequisites
-------------

Before progressing through this tutorial, ensure that you have :ref:`installed Dioptra <explanation-install-dioptra>`. It is also recommended to complete the :ref:`Hello World tutorial <tutorial-hello-world-in-dioptra>` before starting this one. 

.. container:: wide-lightly-shaded

   .. toctree::
      :caption: Tutorial Contents
      :maxdepth: 1

      part-2
      part-3
      part-5
      part-6
..    part-0
      part-1
      part-4

**By the end of this tutorial, you will have:**

- Loaded in Python files and **registered their functions** as Dioptra **Plugin Tasks**
- **Created workflows** from those Plugin tasks to generate data, modify that data, and visualize your results
- Defined custom **types** and their associated **saving/loading behavior** to export your generated data and results into new entrypoints and out of Dioptra