This site contains the documentation for the
opensimula project. Github site 
opensimula is a component-based time simulation environment in Python.
The main objective is the thermal and energy simulation of different systems and installations, mainly in buildings, although it can be used to simulate any component that presents a temporal variation.


Structure
The general object structure provided by opensimula is composed of three main elements:
- Simulation: The global environment for simulation.
- Project: A set of components that define a problem that can be temporarily simulated.
- Component: These are the base elements on which the simulation is performed. The types of components currently available can be consulted in section Component list.

Parameters
Parameters are used to define the characteristics that make up the projects and components.

Parameters can be of different types depending on the type of information they contain (strings, boolean, integer, float, options, ...). A list of all parameter types and their possibilities can be found in the User guide. :
Variables
Variables are elements included in the components to store the temporal information generated during the simulation.

Documentation
Release notes
Current Version 0.10.0 (November 19, 2026): water plants with several generators (heat pumps, chillers and boilers), a header between the primary and the secondary, and secondary circuits; zones defined by load records. It breaks the compatibility of the water systems with 0.9.
The changes of every version, and how to upgrade from 0.9, are in the Release notes.