Tutorials

Step-by-step tutorials to help you learn JaxABM concepts and techniques.

Getting Started

Core Concepts

Advanced Topics

Tutorial Overview

Basic Model Creation: Learn how to create your first JaxABM model with simple agents and basic behaviors.
Agent Behaviors: Understand how to define complex agent behaviors and interactions.
Parameter Calibration: Master the art of finding optimal parameters for your models using various methods.
Sensitivity Analysis: Learn to identify which parameters most influence your model outcomes.
Performance Optimization: Discover how to make your models run faster using JAX transformations.

Prerequisites

Before starting these tutorials, make sure you have:

JaxABM installed: See Installation
Basic Python knowledge: Familiarity with Python syntax
NumPy basics: Understanding of array operations
Optional: JAX knowledge: Helpful but not required

Learning Path

We recommend following this sequence:

Start with basic_model to understand core concepts
Move to adding_agents to learn about agent creation
Practice with running_simulations for execution basics
Explore agent_behaviors for advanced agent programming
Master Model Calibration for parameter optimization

Each tutorial includes:

Conceptual explanation of the topic
Complete code examples you can run
Exercises to test your understanding
Common pitfalls and how to avoid them
Next steps for further learning

Need Help?

If you get stuck:

Check the API Reference for detailed function documentation
Look at Examples for more complete examples
Review the troubleshooting sections in each guide
Open an issue on GitHub for bugs or unclear documentation