Tutorials

Interactive tutorials to help you master UCLCHEM through practical examples.

Tutorial Structure

Our tutorials are organized by topic and difficulty level:

🎯 Basics

Essential concepts and your first models

Basic Tutorials

� Analysis

Analyzing and visualizing results

Analysis Tutorials

🚀 Advanced

Complex models and advanced features

Advanced Tutorials

⚙️ Customization

Custom networks and advanced settings

Customization Tutorials

Learning Path

We recommend following tutorials in this order:

1. First Model - Run your first UCLCHEM simulation

2. In-Memory Modelling - Work with models in memory

3. Parameter Grids - Run parameter surveys efficiently

4. Chemical Analysis - Analyze reaction pathways and networks

5. Heating & Cooling - Understand thermal processes

6. Advanced Settings - Fine-tune your models

All Tutorials

• Basic Tutorials
  • Advanced Physical Modelling
  • Running a Grid
• Analysis Tutorials
  • Chemical Analysis
  • UPDATE to UMIST22
• Advanced Tutorials
• Customization Tutorials
• Legacy Tutorials
  • Advanced Physical Modelling
  • About Legacy Tutorials
  • When to Use
  • Modern Alternatives

Running the Tutorials

All tutorials are available as Jupyter notebooks in the UCLCHEM repository:

# Clone the repository if you haven't already
git clone https://github.com/uclchem/UCLCHEM.git
cd UCLCHEM/notebooks

# Launch Jupyter
jupyter notebook

Tip

You can also view and run tutorials directly on GitHub or Binder (link coming soon).

Prerequisites

Most tutorials assume you have:

• UCLCHEM installed (see Installation Guide)

• Basic Python knowledge

• Familiarity with NumPy and Matplotlib

• Basic understanding of astrochemistry concepts

Don’t worry if you’re new to some of these - we explain as we go!

Need Help?

If you get stuck:

1. Check the API Reference for function details

2. Review the User Guide for conceptual explanations

3. Look at examples in the repository

4. Open an issue on GitHub