Interactive Tutorials
=====================

This page provides access to interactive Jupyter notebook tutorials from the `NIST AFL-tutorial repository <https://github.com/usnistgov/AFL-tutorial>`_. 
These tutorials are designed to run directly in Google Colab without any installation required.

.. list-table:: Available Tutorials
   :header-rows: 1
   :widths: 10 50 20 20

   * - ID
     - Description
     - Instructor Version
     - Student Version
   * - 01
     - Introduction to small-angle scattering and the concept of phase mapping
     - `Open in Colab <https://colab.research.google.com/github/usnistgov/AFL-tutorial/blob/main/notebooks/01-introduction-instructor.ipynb>`_
     - `Open in Colab <https://colab.research.google.com/github/usnistgov/AFL-tutorial/blob/main/notebooks/01-introduction-student.ipynb>`_
   * - 02
     - Building decision pipelines (AI agents) using scikit-learn
     - `Open in Colab <https://colab.research.google.com/github/usnistgov/AFL-tutorial/blob/main/notebooks/02-sklearn-instructor.ipynb>`_
     - `Open in Colab <https://colab.research.google.com/github/usnistgov/AFL-tutorial/blob/main/notebooks/02-sklearn-student.ipynb>`_
   * - 03
     - Building decision agents with the AFL.double_agent library (Under Development)
     - 🚧 Under Development
     - 🚧 Under Development
   * - C1
     - Challenge: Build an agent that tolerates measurement noise
     - N/A
     - `Open in Colab <https://colab.research.google.com/github/usnistgov/AFL-tutorial/blob/main/notebooks/C1-challenge1.ipynb>`_
   * - C2
     - Challenge: Discover the boundaries of multiple phases
     - N/A
     - `Open in Colab <https://colab.research.google.com/github/usnistgov/AFL-tutorial/blob/main/notebooks/C2-challenge2.ipynb>`_
   * - C3
     - Challenge: Handle second order (continuous) phase transitions
     - N/A
     - `Open in Colab <https://colab.research.google.com/github/usnistgov/AFL-tutorial/blob/main/notebooks/C3-challenge3.ipynb>`_
   * - CX
     - Ideas and inspiration for the challenges
     - N/A
     - `Open in Colab <https://colab.research.google.com/github/usnistgov/AFL-tutorial/blob/main/notebooks/CX-inspiration.ipynb>`_

About the Tutorials
------------------

The goal of these tutorials is to introduce the software tools developed to run the Autonomous Formulation Lab. They introduce AI agent software (AFL.double_agent) and show how it can be used to build decision pipelines. The notebooks leverage widely used open source libraries (scikit-learn) and the AFL.double_agent library for building decision pipelines.

These tutorials are highly interactive, making them suitable for both self-paced learning and guided tutorial presentation settings.

Notebook Versions
-----------------

- **Student Notebooks**: These notebooks are designed for guided tutorial presentations. They have sections of the code removed that are meant to be filled in by the active participants.
- **Instructor Notebooks**: These notebooks contain the complete code solutions and are intended for instructors or for self-paced learning.