Marlim3 is a 1D multiphase flow simulator developed by Petrobras.
- Production wells
- Injection wells: Water or gas injection wells, both single-phase and multiphase
- Networks
- Production networks
- Injection networks
- Gas lift loops
- Artificial Lift models: gas lift valves, pumps
- 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
Marlim3 is undergoing a major architectural refactoring. While that work is in progress:
- Not every mapped bug in the current version will be fixed. Some defects live in code that the refactoring will replace, and fixing them twice is not a good use of anyone's time.
- The current focus is verification. We are consolidating reference cases for the regression suite and validation cases for limiting conditions, so that the refactored engine can be checked against known-correct behaviour rather than against itself.
- Issues where external collaboration is welcome are labelled
help wanted. Those are scoped so they do not collide with the refactoring.
Bug reports remain valuable even when a fix is deferred — they inform what the new architecture has to get right, and they are candidates for the reference suite. Please keep them coming.
Broader contributions will be accepted once the refactoring settles. See CONTRIBUTING.md for what is being accepted in the meantime.
| Getting Started | Installation, usage, and compilation |
| Python package | Python API, bilingual interface, scripting |
| Model reference | Every input section, key and unit |
| Theory | Governing equations and discretization |
| Developer guide | Engine internals |
| Tutorials | Step-by-step notebooks |
| Desktop application | Platform notes and diagnostics |
| Regression tool | Model registration and native coverage |
| Tests | Test suite and regression references |
The full documentation is published at petrobras.github.io/marlim3.
Contributions are welcome — see CONTRIBUTING.md, along with the Code of Conduct and the Contributor License Agreement. Note the project status above for what is being accepted during the refactoring.
Please use the Discussions section for questions rather than opening issues.
Several resources and portions of the source code are currently written in Portuguese. We plan to gradually translate all content into English.
The Python API is fully bilingual (EN/PT) — see Bilingual Support.