Skip to content

Tutorials

Step-by-step guides that walk you through complete reservoir simulation workflows, from simple depletion to advanced miscible flooding.

Prerequisites

Before starting these tutorials, make sure you have completed the following:

  1. Installation - BORES is installed and working in your environment.
  2. Quickstart - You have run the quickstart example successfully.
  3. Core Concepts - You understand the simulation pipeline, immutable models, and factory functions.

You should also be comfortable with Python and NumPy basics. Each tutorial builds on the previous one, so we recommend following them in order.

Tutorial Roadmap

The tutorials progress from fundamental skills to advanced recovery techniques. Each one introduces new concepts while reinforcing what you have already learned.

  • Your First Simulation

    Build a simple depletion model with a single production well. Learn the complete simulation workflow from grid construction to result visualization.

    Tutorial 1

  • Building Reservoir Models

    Construct realistic heterogeneous models with layered properties, anisotropic permeability, structural dip, and 3D visualization.

    Tutorial 2

  • Waterflood Simulation

    Set up a complete waterflood with injection and production wells. Track water breakthrough, water cut, and oil recovery factor.

    Tutorial 3

  • Gas Injection

    Simulate immiscible gas injection and observe gravity override, gas mobility effects, and compare recovery against waterflooding.

    Tutorial 4

  • Miscible Gas Flooding

    Model miscible displacement with the Todd-Longstaff method. Configure CO2 injection with custom fluid properties and analyze mixing behavior.

    Tutorial 5

Suggested Reading Order

Order Tutorial What You Will Learn Time
1 Your First Simulation Full simulation workflow, depletion drive, basic visualization 20 min
2 Building Reservoir Models Heterogeneity, anisotropy, structural dip, 3D visualization 25 min
3 Waterflood Simulation Injection wells, water breakthrough, recovery analysis 30 min
4 Gas Injection Gas injectors, gravity effects, gas-oil displacement 25 min
5 Miscible Gas Flooding Todd-Longstaff model, CO2 properties, miscible displacement 30 min

Learning Approach

Each tutorial is self-contained with complete, runnable code. However, the explanations assume familiarity with earlier tutorials. If you jump ahead and encounter an unfamiliar concept, check the earlier tutorials or the Core Concepts page.