Marlim3 is a transient 1D multiphase-flow simulator for production and injection systems in oil and gas applications.

Core Capabilities

• Production wells
• Injection wells (water or gas)
• Network
  • Production networks
  • Injection networks
  • Gas-lift loops
• Artificial lift models
  • Gas-lift valves
  • ESP pumps
  • Volumetric pumps

Advanced modeling

• Natural convection: 2D solutions for natural convection analysis in confined spaces (single-phase or two-phase), such as pipeline cross-sections during production shutdowns
• Compositional fluid model library
• Near wellbore model: radial and 2D models to consider phenomena such as water coning
• Thermal diffusion: 2D and 3D coupled to the 1D flow model

How You Can Use Marlim3

• Streamlit GUI for interactive model setup and result inspection
• Python package for automation, integration, and parametric studies
• Command-line executable for direct simulation workflows

For installation instructions and usage guidelines in any of these settings, please refer to the official repository.

User Guide Map

Concept	What You Learn
Fluids	Fluid-model families, PVT files, and property applicability by model
Materials	Thermal-property definitions for wall layers and special material types
Cross Sections	Radial geometry, annular behavior, and layer construction
Rock Formation	Formation thermal memory and rock property assignment
Pipes	Segment geometry, discretization, ambient coupling, and thermal links
Accessories	Sources, valves, pumps, pressure devices, and pigging
Boundary Conditions	Inlet/outlet closure strategies and injection boundary modes
Time	Initialization strategies, step schedule, segregation windows, snapshots
General	Global physics switches, correlations, and advanced numerical controls
Results	Profile/trend/cross outputs and interpretation strategy

Reference and Tutorials

Section	Content
JSON Schema Reference	Full field catalog, object structure, and units
Tutorials	Practical notebook-based workflows
Bilingual Support	English ↔ Portuguese key mapping and usage

Recommended Reading Path

For a first model:

1. Fluids
2. Materials and Cross Sections
3. Pipes
4. Boundary Conditions and Accessories
5. Time and General
6. Results

Build This Documentation

uv sync --group docs
uv run mkdocs serve