OpenSimula 0.0.5__tar.gz → 0.1.1__tar.gz

{opensimula-0.0.5 → opensimula-0.1.1}/.gitignore

@@ -117,7 +117,7 @@ venv.bak/
 .ropeproject
 
 # mkdocs documentation
-/site
+#/site
 
 # mypy
 .mypy_cache/

opensimula-0.1.1/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.3
+Name: OpenSimula
+Version: 0.1.1
+Summary: Component-based time simulation environment in Python
+Project-URL: Homepage, https://github.com/jfCoronel/OpenSimula/Site
+Project-URL: Repository, https://github.com/jfCoronel/OpenSimula
+Project-URL: Bug Tracker, https://github.com/jfCoronel/OpenSimula/issues
+Author-email: "Juan F. Coronel" <jfc@us.es>
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Requires-Dist: dash-ag-grid>=31.2.0
+Requires-Dist: dash-bootstrap-components>=1.6.0
+Requires-Dist: dash>=2.17.1
+Requires-Dist: ipywidgets>=8.1.3
+Requires-Dist: numpy>=1.25.2
+Requires-Dist: pandas>=2.2.2
+Requires-Dist: plotly>=5.23.0
+Requires-Dist: psychrolib>=2.5.0
+Requires-Dist: py-expression-eval>=0.3.14
+Requires-Dist: pyvista>=0.43.4
+Requires-Dist: scipy>=1.14.0
+Requires-Dist: shapely>=2.0.5
+Requires-Dist: trame-vtk>=2.8.9
+Requires-Dist: trame-vuetify>=2.6.2
+Requires-Dist: trame>=3.6.3
+Provides-Extra: docs
+Requires-Dist: mkdocs; extra == 'docs'
+Provides-Extra: testing
+Requires-Dist: pytest; extra == 'testing'
+Description-Content-Type: text/markdown
+
+![Logo](docs/img/logo_opensimula.png)
+Component-based time simulation environment in Python
+
+[Documentation page](https://jfcoronel.github.io/OpenSimula/site/)
+
+## Main Developers
+
+* [Juan F. Coronel](http://jfc.us.es), Universidad de Sevilla
+
+## Package dependencies
+- numpy
+- pandas
+- scipy
+- py-expression-eval
+- shapely
+- psychrolib
+- plotly
+- dash
+- dash_bootstrap_components
+- dash_ag_grid
+- pyvista
+- trame
+- trame-vtk
+- trame-vuetify
+- ipywidgets
+

opensimula-0.1.1/Python_Libraries.txt

@@ -0,0 +1,31 @@
+Python libraries needed for OpenSimula:
+In a clean python version:
+- numpy
+- pandas
+- scipy
+- py-expression-eval
+- shapely
+- psychrolib
+- plotly
+- dash
+- dash_bootstrap_components
+- dash_ag_grid
+- pyvista
+- trame
+- trame-vtk
+- trame-vuetify
+- ipywidgets
+
+For jupyter with VSC: try to run one ipynb file and VSC will isntall all packages it needed
+
+Development tools:
+- pipreqs: Revisa el código y mira que packages necesita el código
+- pytest: Para ejecutar los test que se encuentran en el directorio test
+- mkdocs: Para generar la documentación (mkdcos serve, mkdocs build --clean)
+
+
+
+
+
+
+

opensimula-0.1.1/README.md

@@ -0,0 +1,26 @@
+![Logo](docs/img/logo_opensimula.png)
+Component-based time simulation environment in Python
+
+[Documentation page](https://jfcoronel.github.io/OpenSimula/site/)
+
+## Main Developers
+
+* [Juan F. Coronel](http://jfc.us.es), Universidad de Sevilla
+
+## Package dependencies
+- numpy
+- pandas
+- scipy
+- py-expression-eval
+- shapely
+- psychrolib
+- plotly
+- dash
+- dash_bootstrap_components
+- dash_ag_grid
+- pyvista
+- trame
+- trame-vtk
+- trame-vuetify
+- ipywidgets
+

opensimula-0.1.1/debug.py

@@ -0,0 +1,9 @@
+import OpenSimula.Simulation as Simulation
+
+sim = Simulation()
+pro = sim.new_project("First example project")
+pro.read_json('docs/getting_started.json')
+pro.simulate()
+
+data = [pro.component("year").variable("values")]
+sim.plotly(pro.dates(), data)

{opensimula-0.0.5/examples → opensimula-0.1.1/docs}/component_list.ipynb

@@ -2,7 +2,7 @@
  "cells": [
   {
    "cell_type": "code",
-   "execution_count": 12,
+   "execution_count": 1,
    "metadata": {},
    "outputs": [
     {

opensimula-0.1.1/docs/component_list.md

@@ -0,0 +1,15 @@
+## Component List
+
+### Common parameters
+All the components include these three parameters:
+
+- **name** [_string_]: Name of the component.
+- **type** [_string_]: Type of the component.
+- **description** [_string_]: Description of the component.
+
+We have divided the list of all components into several groups of related components:
+
+- [Components to define shedules](component_list_schedules.md): Day_schedule, Week_schedule, Year_schedule.
+- [Components for reading files](component_list_files.md): File_met, File_data.
+- [Constructive components](component_list_constructions.md): Material, Construction, Glazing, Frame, Opening_type.
+- [Building definition components](component_list_building.md): Building, Space_type, Space, Exterior_surface, Interior_surface, Underground_surface, Virtual_exterior_surface, Virtual_interior_surface, Opening.

opensimula-0.1.1/docs/component_list_building.md

@@ -0,0 +1,423 @@
+## Component List for building definition elements
+### Building
+
+Base component for the definition of a building. The building is made up of a set of spaces (Space component).
+
+#### Parameters
+- **file_met** [_component_, default = "not_defined", component type = File_met]: Reference to the component where the weather file is defined.
+- **azimuth** [_float_, unit = "°", default = 0, min = -180, max = 180]: Angle formed between the x-axis of the building and the east (Global x-axis). The coordinates of all building elements refer to the building coordinate system. 
+- **albedo** [_float_, unit = "frac", default = 0.3, min = 0, max = 1]: Solar reflectivity of the ground surrounding the building. Used to calculate the solar radiation reflected to the exterior surfaces of the building.
+- **initial_temperature** [_float_, unit = "°C", default = 20]: Initial temperature of all building components at the beginning of the simulation.
+- **initial_humidity** [_float_, unit = "g/kg", default = 7.3]: Initial absolute humidity of all building spaces at the beginning of the simulation.
+
+The following figure shows the building's coordinate system:
+
+![Building coordinate system](img/building_coordinate_system.png)
+
+**Example:**
+<pre><code class="python">
+...
+
+building = osm.components.Building("building",project)
+param = {
+    "file_met": "met"
+    "azimuth": 90,
+    "albedo": 0.4
+}
+building.set_parameters(param)
+</code></pre>
+
+### Space_type
+
+Component used to define the type of space. This component will be referenced by all spaces that are of the same type. This component defines the internal loads and some of the functional characteristics of the space.
+
+#### Parameters
+
+- **input_variables** [_variable_list_, default = []]: List of variables from other components used in this component. They may be used in parameters of the type math_exp.
+- **people_density** [_math_exp_, unit = "p/m²", default = "0.1"]: Occupancy density, defined in persons per m² of floor. The mathematical expression may contain any of the variables declared in the "input_variables" parameter, to be able to reflect the time variation of this value. See example below
+- **people_sensible** [_float_, unit = "W/p", default = 70, min = 0]: Sensible heat generated by each of the occupants of the space.
+- **people_latent** [_float_, unit = "W/p", default = 35, min = 0]: Latent heat generated by each of the occupants of the space.
+- **people_radiant_fraction** [_float_, unit = "frac", default = 0.6, min = 0, max = 1]: Long wave radiant fraction of heat generated by occupants. The rest of the heat is assumed to be convective.
+- **light_density** [_math_exp_, unit = "W/m²", default = "10"]: Lighting density, defined as the electrical lighting power [W] per m² of floor. The mathematical expression may contain any of the variables declared in the "input_variables" parameter, to be able to reflect the time variation of this value. See example below.
+- **light_radiant_fraction** [_float_, unit = "frac", default = 0.6, min = 0, max = 1]: Short wave radiant fraction of heat generated by lights. The rest of the heat is assumed to be convective.
+- **other_gains_density** [_math_exp_, unit = "W/m²", default = "10"]: Other gains density, defined as the heat generated by other gains (Household appliances, office automation, miscellaneous electrical equipment, etc.) [W] per m² of floor. The mathematical expression may contain any of the variables declared in the "input_variables" parameter, to be able to reflect the time variation of this value. See example below.
+- **other_gains_radiant_fraction** [_float_, unit = "frac", default = 0.5, min = 0, max = 1]: Long wave radiant fraction of the heat generated by other gains. The convective fraction is calculated by subtracting the radiant and latent fractions.
+- **other_gains_latent_fraction** [_float_, unit = "frac", default = 0.0, min = 0, max = 1]: Latent fraction of the heat generated by other gains. The convective fraction is calculated by subtracting the radiant and latent fractions.
+- **infiltration** [_math_exp_, unit = "1/h", default = "1"]: Air flow rate infiltrated into the space from outside and expressed in volumes of the space per hour. The mathematical expression may contain any of the variables declared in the "input_variables" parameter, to be able to reflect the time variation of this value.
+- **heating_setpoint** [_math_exp_, unit = "°C", default = "20"]: Heating setpoint temperature. The mathematical expression may contain any of the variables declared in the "input_variables" parameter, to be able to reflect the time variation of this value.
+- **cooling_setpoint** [_math_exp_, unit = "°C", default = "25"]: Cooling setpoint temperature. The mathematical expression may contain any of the variables declared in the "input_variables" parameter, to be able to reflect the time variation of this value.
+- **heating_on_off** [_math_exp_, unit = "on/off", default = "1"]: If this value is 0, the heating will be off, otherwise it will be on. The mathematical expression may contain any of the variables declared in the "input_variables" parameter, to be able to reflect the time variation of this value.
+- **cooling_on_off** [_math_exp_, unit = "on/off", default = "1"]: If this value is 0, the cooling will be off, otherwise it will be on. The mathematical expression may contain any of the variables declared in the "input_variables" parameter, to be able to reflect the time variation of this value.
+
+Assuming that the variation of occupancy, lighting and other loads has been defined in a "Year_schedule" component, named "schedule" with values between 0 and 1, the following example would capture that variation.
+
+**Example:**
+<pre><code class="python">
+...
+
+office_space = osm.components.Space_type("office_space",project)
+param = {
+        "input_variables": ["f = schedule.value"]
+        "people_density": "0.1*f",
+        "light_density": "10*f",
+        "other_gains_density": "4.2*f",
+        "other_gains_radiant_fraction": 0.6,
+        "infiltration": "0.5",
+        "heating_setpoint": "20",
+        "cooling_setpoint": "25",
+        "heating_on_off": "f",
+        "cooling_on_off": "f",
+}
+office_space.set_parameters(param)
+</code></pre>
+
+#### Variables
+
+After the simulation we will have the following variables of this component:
+
+- __people_convective__ [W/m²]: Convective heat due to occupancy.
+- __people_radiant__ [W/m²]: Radiant heat (long wave) due to occupancy.
+- __people_latent__ [W/m²]: Latent heat due to occupancy.
+- __light_convective__ [W/m²]: Convective heat due to lighting.
+- __light_radiant__ [W/m²]: Radiant heat (short wave) due to lighting.
+- __other_gains_convective__ [W/m²]: Convective heat due to other gains.
+- __other_gains_radiant__ [W/m²]: Radiant heat (long wave) due to other gains.
+- __other_gains_latent__ [W/m²]: Latent heat due to other gains.
+- __infiltration_rate__ [1/h]: Air flow rate infiltrated into the space from outside, expressed in volumes of the space per hour.
+- __heating_setpoint__ [°C]: Heating setpoint temperature.
+- __cooling_setpoint__ [°C]: Cooling setpoint temperature.
+- __heating_on_off__ [on/off]: Heating on (1), off (0).
+- __heating_on_off__ [on/off]: Cooling on (1), off (0).
+
+### Space
+
+Component used to define each of the building's spaces. The spaces of a building are each of the volumes of the building where we can find a different temperatures. The spaces will be referenced by the different surfaces that comprise them.
+
+#### Parameters
+
+- **building** [_component_, default = "not_defined", component type = Building]: Reference to the "Building" component of which it is a part.
+- **space_type** [_component_, default = "not_defined", component type = Space_type]: Reference to the "Space_type" component that defines its occupational and functional characteristics.
+- **floor_area** [_float_, unit = "m²", default = 1, min = 0]: Floor area of the space.
+- **volume** [_float_, unit = "m³", default = 1, min = 0]: Volume of the space.
+- **furniture_weight** [_float_, unit = "kg/m²", default = 10, min = 0]: Weight of the furniture in the space. Used to increase the thermal inertia of the space which will be added to that of the air (for the furniture a specific heat of 1000 J/kg·K will be used).
+- **perfect_conditioning** [_boolean_, default = False]: If the value is "True" the space shall be perfectly conditioned using the setpoints and operating periods specified in its space_type,therefore the temperature will be maintained exactly at the value indicated in the setpoint if necessary. For "False" value the space will evolve freely according to the actual conditioning systems available.
+
+**Example:**
+<pre><code class="python">
+...
+
+space_1 = osm.components.Space("space_1",project)
+param = {
+        "building": "building",
+        "space_type": "office_space",
+        "floor_area": 30,
+        "volume": 90
+}
+space_1.set_parameters(param)
+</code></pre>
+
+#### Variables
+
+After the simulation we will have the following variables of this component:
+
+- __temperatura__ [°C]: Space dry air temperatura.
+- __abs_humidity__ [g/kg]: Absolute space air humidity.
+- __rel_humidity__ [%]: Relative space air humidity.
+- __people_convective__ [W]: Convective heat due to occupancy.
+- __people_radiant__ [W]: Radiant heat (long wave) due to occupancy.
+- __people_latent__ [W]: Latent heat due to occupancy.
+- __light_convective__ [W]: Convective heat due to lighting.
+- __light_radiant__ [W]: Radiant heat (short wave) due to lighting.
+- __other_gains_convective__ [W]: Convective heat due to other gains.
+- __other_gains_radiant__ [W]: Radiant heat (long wave) due to other gains.
+- __other_gains_latent__ [W]: Latent heat due to other gains.
+- __solar_direct_gains__ [W]: Direct solar radiation gains.
+- __infiltration_flow__ [m³/s]: Air flow rate infiltrated into the space from outside.
+- __infiltration_sensible_heat__ [W]: Sensible heat due to air infiltration from outdoor.
+- __infiltration_latent_heat__ [W]: Latent heat due to air infiltration from outdoor.
+
+### Exterior_surface
+
+Component to define the exterior surfaces of the building: vertical or inclined walls and horizontal or inclined roofs.
+
+#### Parameters
+
+- **shape** [_option_, default = "RECTANGLE", options = ["RECTANGLE","POLYGON"]]: Shape of the surface, for a rectangle the parameters "width" and "height" will be used and for a polygon the parameters "x-polygon" and "y-polygon". 
+- **width** [_float_, unit = "m", default = 1, min = 0]: Width of the rectangular surface. Only used if "shape" is equal to "RECTANGLE". 
+- **height** [_float_, unit = "m", default = 1, min = 0]: Height of the rectangular surface. Only used if "shape" is equal to "RECTANGLE". 
+- **ref_point** [_float-list_, unit = "m", default = [0,0,0]]: Three-dimensional coordinate of the surface reference point. For rectangular surfaces the lower left corner of the surface viewed from the outside, for surfaces defined by polygons the three-dimensional location of the coordinate origin used to define the polygon in two dimensions.
+- **x_polygon** [_float-list_, unit = "m", default = [0,10,10,0]]: List with the x-coordinates of the points defining the surface polygon. Only used if "shape" is equal to "POLYGON". 
+- **y_polygon** [_float-list_, unit = "m", default = [0,0,10,10]]: List with the y-coordinates of the points defining the surface polygon. Only used if "shape" is equal to "POLYGON".
+- **azimuth** [_float_, unit = "°", default = 0, min = -180, max = 180]: Angle formed between the x-axis of the building and the projection of the x-axis of the surface.
+- **altitude** [_float_, unit = "°", default = 0, min = -90, max = 90]: Angle formed between the z-axis of the building and the y-axis of the surface.
+- **construction** [_component_, default = "not_defined", component type = Construction]: Reference to the "Construction" component that defines its composition.
+- **space** [_component_, default = "not_defined", component type = Space]: Reference to the "Space" component to which it belongs.
+- **h_cv** [_float-list_, unit = "W/m²K", default = [19.3,2], min = 0]: Convective film coefficients of the exterior and interior surfaces, respectively.
+
+The following figures show the surface coordinate system versus the building coordinate system for rectangular or polygonal surfaces.
+
+![Rectangular surface coordinate system](img/rectangular_surface_coordinate_system.png)
+
+![Polygon surface coordinate system](img/polygon_surface_coordinate_system.png)
+
+**Example:**
+<pre><code class="python">
+...
+
+north_wall = osm.components.Exterior_surface("north_wall",project)
+param = {
+        "ref_point": [8,0,-6],
+        "width": 8,
+        "height": 2.7,
+        "azimuth": 180,
+        "altitude": 0,
+        "construction": "Multilayer_wall",
+        "space": "space_1"
+}
+north_wall.set_parameters(param)
+</code></pre>
+
+#### Variables
+
+After the simulation we will have the following variables of this component, all variables ending in 0 refer to the outer surface and those ending in 1 to the inner surface:
+
+- __T_s0, T_s1__ [°C]: Surface temperatures
+- __q_cd0, q_cd1__ [W/m²]: Conductive heat flux at the surfaces.
+- __q_cv0, q_cv1__ [W/m²]: Convective heat flux at the surfaces.
+- __q_sol0, q_sol1__ [W/m²]: Solar heat flux at the surfaces.
+- __q_swig0, q_swig1__ [W/m²]: Radiant short wave heat flux at the surfaces due to internal gains.
+- __q_lwig0, q_lwig1__ [W/m²]: Radiant long wave heat flux at the surfaces due to internal gains.
+- __q_lwt0, q_lwt1__ [W/m²]: Radiant long wave heat flux at the surfaces due other surfaces temperatures.
+- __p_0, p_1__ [W/m²]: Conductive heat flux at the surfaces due to previous time steps.
+- __T_rm__ [°C]: Exterior radiant mean temperature.
+- __E_dir__ [W/m²]: Direct solar radiation incident on the exterior surface.
+- __E_dif__ [W/m²]: Diffuse solar radiation incident on the exterior surface.
+
+### Interior_surface
+
+Component to define the interior surfaces of the building: vertical or inclined interior walls and slabs between floors.
+
+#### Parameters
+
+- **shape** [_option_, default = "RECTANGLE", options = ["RECTANGLE","POLYGON"]]: Shape of the surface, for a rectangle the parameters "width" and "height" will be used and for a polygon the parameters "x-polygon" and "y-polygon". 
+- **width** [_float_, unit = "m", default = 1, min = 0]: Width of the rectangular surface. Only used if "shape" is equal to "RECTANGLE". 
+- **height** [_float_, unit = "m", default = 1, min = 0]: Height of the rectangular surface. Only used if "shape" is equal to "RECTANGLE". 
+- **ref_point** [_float-list_, unit = "m", default = [0,0,0]]: Three-dimensional coordinate of the surface reference point. For rectangular surfaces the lower left corner of the surface viewed the "0" side, for surfaces defined by polygons the three-dimensional location of the coordinate origin used to define the polygon in two dimensions.
+- **x_polygon** [_float-list_, unit = "m", default = [0,10,10,0]]: List with the x-coordinates of the points defining the surface polygon. Only used if "shape" is equal to "POLYGON". 
+- **y_polygon** [_float-list_, unit = "m", default = [0,0,10,10]]: List with the y-coordinates of the points defining the surface polygon. Only used if "shape" is equal to "POLYGON".
+- **azimuth** [_float_, unit = "°", default = 0, min = -180, max = 180]: Angle formed between the x-axis of the building and the projection of the x-axis of the surface.
+- **altitude** [_float_, unit = "°", default = 0, min = -90, max = 90]: Angle formed between the z-axis of the building and the y-axis of the surface.
+- **construction** [_component_, default = "not_defined", component type = Construction]: Reference to the "Construction" component that defines its composition.
+- **spaces** [_component-list_, default = ["not_defined","not_defined], component type = Space]: Reference to the "Space" components for the side 0 and the side 1.
+- **h_cv** [_float-list_, unit = "W/m²K", default = [2,2], min = 0]: Convective film coefficients of the 0 an 1 side, respectively.
+
+See figures of the coordinate systems in the "Exterior_surface" component.
+
+**Example:**
+<pre><code class="python">
+...
+
+interior_wall = osm.components.Interior_surface("interior_wall",project)
+param = {
+        "ref_point": [8,0,-3],
+        "width": 8,
+        "height": 2.7,
+        "azimuth": 0,
+        "altitude": 0,
+        "construction": "Multilayer_wall",
+        "spaces": ["space_0", "space_1"]
+}
+interior_wall.set_parameters(param)
+</code></pre>
+
+#### Variables
+
+After the simulation we will have the following variables of this component, all variables ending in 0 refer "0" surface and those ending in 1 to the "1" surface:
+
+- __T_s0, T_s1__ [°C]: Surface temperatures
+- __q_cd0, q_cd1__ [W/m²]: Conductive heat flux at the surfaces.
+- __q_cv0, q_cv1__ [W/m²]: Convective heat flux at the surfaces.
+- __q_sol0, q_sol1__ [W/m²]: Solar heat flux at the surfaces.
+- __q_swig0, q_swig1__ [W/m²]: Radiant short wave heat flux at the surfaces due to internal gains.
+- __q_lwig0, q_lwig1__ [W/m²]: Radiant long wave heat flux at the surfaces due to internal gains.
+- __q_lwt0, q_lwt1__ [W/m²]: Radiant long wave heat flux at the surfaces due other surfaces temperatures.
+- __p_0, p_1__ [W/m²]: Conductive heat flux at the surfaces due to previous time steps.
+
+
+### Underground_surface
+
+Component define the surfaces in contact with the ground. Floors or vertical undergorund enclosures.
+
+#### Parameters
+
+- **shape** [_option_, default = "RECTANGLE", options = ["RECTANGLE","POLYGON"]]: Shape of the surface, for a rectangle the parameters "width" and "height" will be used and for a polygon the parameters "x-polygon" and "y-polygon". 
+- **width** [_float_, unit = "m", default = 1, min = 0]: Width of the rectangular surface. Only used if "shape" is equal to "RECTANGLE". 
+- **height** [_float_, unit = "m", default = 1, min = 0]: Height of the rectangular surface. Only used if "shape" is equal to "RECTANGLE". 
+- **ref_point** [_float-list_, unit = "m", default = [0,0,0]]: Three-dimensional coordinate of the surface reference point. For rectangular surfaces the lower left corner of the surface viewed the "0" side, for surfaces defined by polygons the three-dimensional location of the coordinate origin used to define the polygon in two dimensions.
+- **x_polygon** [_float-list_, unit = "m", default = [0,10,10,0]]: List with the x-coordinates of the points defining the surface polygon. Only used if "shape" is equal to "POLYGON". 
+- **y_polygon** [_float-list_, unit = "m", default = [0,0,10,10]]: List with the y-coordinates of the points defining the surface polygon. Only used if "shape" is equal to "POLYGON".
+- **azimuth** [_float_, unit = "°", default = 0, min = -180, max = 180]: Angle formed between the x-axis of the building and the projection of the x-axis of the surface.
+- **altitude** [_float_, unit = "°", default = 0, min = -90, max = 90]: Angle formed between the z-axis of the building and the y-axis of the surface.
+- **construction** [_component_, default = "not_defined", component type = Construction]: Reference to the "Construction" component that defines its composition.
+- **space** [_component_, default = "not_defined", component type = Space]: Reference to the "Space" component to which it belongs.
+- **h_cv** [_float_, unit = "W/m²K", default = 2, min = 0]: Convective film coefficient of interior surface.
+
+See figures of the coordinate systems in the "Exterior_surface" component.
+
+**Example:**
+<pre><code class="python">
+...
+
+floor = osm.components.Underground_surface("floor",project)
+param = {
+        "shape": "POLYGON",
+        "ref_point": [0,0,0],
+        "x_polygon": [0,8,8,0],
+        "y_polygon": [0,0,6,6],
+        "azimuth": 0,
+        "altitude": -90,
+        "construction": "Multilayer wall",
+        "space": "space_1"
+}
+floor.set_parameters(param)
+</code></pre>
+
+#### Variables
+
+After the simulation we will have the following variables of this component, all variables ending in 0 refer to the underground surface and those ending in 1 to the interior surface:
+
+- __T_s0, T_s1__ [°C]: Surface temperatures
+- __q_cd0, q_cd1__ [W/m²]: Conductive heat flux at the surfaces.
+- __q_cv1__ [W/m²]: Convective heat flux at the ineterior surface.
+- __q_sol1__ [W/m²]: Solar heat flux at the surfaces.
+- __q_swig1__ [W/m²]: Radiant short wave heat flux at the interior surface due to internal gains.
+- __q_lwig1__ [W/m²]: Radiant long wave heat flux at the interior surface due to internal gains.
+- __q_lwt1__ [W/m²]: Radiant long wave heat flux at the interior surface due other surfaces temperatures.
+- __p_0, p_1__ [W/m²]: Conductive heat flux at the surfaces due to previous time steps.
+
+
+### Virtual_exterior_surface
+
+Virtual surfaces are used to define gaps between a space and the outside "Virtual_exterior_surface" or between two spaces "Virtual_interior_surface". Spaces in OpenSimula must be completely enclosed by surfaces for the radiant exchange calculation to work correctly.
+
+#### Parameters
+
+- **shape** [_option_, default = "RECTANGLE", options = ["RECTANGLE","POLYGON"]]: Shape of the surface, for a rectangle the parameters "width" and "height" will be used and for a polygon the parameters "x-polygon" and "y-polygon". 
+- **width** [_float_, unit = "m", default = 1, min = 0]: Width of the rectangular surface. Only used if "shape" is equal to "RECTANGLE". 
+- **height** [_float_, unit = "m", default = 1, min = 0]: Height of the rectangular surface. Only used if "shape" is equal to "RECTANGLE". 
+- **ref_point** [_float-list_, unit = "m", default = [0,0,0]]: Three-dimensional coordinate of the surface reference point. For rectangular surfaces the lower left corner of the surface viewed from the outside, for surfaces defined by polygons the three-dimensional location of the coordinate origin used to define the polygon in two dimensions.
+- **x_polygon** [_float-list_, unit = "m", default = [0,10,10,0]]: List with the x-coordinates of the points defining the surface polygon. Only used if "shape" is equal to "POLYGON". 
+- **y_polygon** [_float-list_, unit = "m", default = [0,0,10,10]]: List with the y-coordinates of the points defining the surface polygon. Only used if "shape" is equal to "POLYGON".
+- **azimuth** [_float_, unit = "°", default = 0, min = -180, max = 180]: Angle formed between the x-axis of the building and the projection of the x-axis of the surface.
+- **altitude** [_float_, unit = "°", default = 0, min = -90, max = 90]: Angle formed between the z-axis of the building and the y-axis of the surface.
+- **space** [_component_, default = "not_defined", component type = Space]: Reference to the "Space" component to which it belongs.
+
+See figures of the coordinate systems in the "Exterior_surface" component.
+
+**Example:**
+<pre><code class="python">
+...
+
+north_hole = osm.components.Virtual_exterior_surface("north_hole",project)
+param = {
+            "ref_point": [8,0,-6],
+            "width": 8,
+            "height": 2.7,
+            "azimuth": 180,
+            "altitude": 0,
+            "space": "space_1"
+}
+north_hole.set_parameters(param)
+</code></pre>
+
+#### Variables
+
+After the simulation we will have the following variables of this component:
+
+- __T_rm__ [°C]: Exterior radiant mean temperature.
+- __E_dir__ [W/m²]: Direct solar radiation incident on the exterior surface.
+- __E_dif__ [W/m²]: Diffuse solar radiation incident on the exterior surface.
+
+### Virtual_interior_surface
+
+Virtual surfaces are used to define gaps between a space and the outside "Virtual_exterior_surface" or between two spaces "Virtual_interior_surface". Spaces in OpenSimula must be completely enclosed by surfaces for the radiant exchange calculation to work correctly.
+
+#### Parameters
+
+- **shape** [_option_, default = "RECTANGLE", options = ["RECTANGLE","POLYGON"]]: Shape of the surface, for a rectangle the parameters "width" and "height" will be used and for a polygon the parameters "x-polygon" and "y-polygon". 
+- **width** [_float_, unit = "m", default = 1, min = 0]: Width of the rectangular surface. Only used if "shape" is equal to "RECTANGLE". 
+- **height** [_float_, unit = "m", default = 1, min = 0]: Height of the rectangular surface. Only used if "shape" is equal to "RECTANGLE". 
+- **ref_point** [_float-list_, unit = "m", default = [0,0,0]]: Three-dimensional coordinate of the surface reference point. For rectangular surfaces the lower left corner of the surface viewed from the outside, for surfaces defined by polygons the three-dimensional location of the coordinate origin used to define the polygon in two dimensions.
+- **x_polygon** [_float-list_, unit = "m", default = [0,10,10,0]]: List with the x-coordinates of the points defining the surface polygon. Only used if "shape" is equal to "POLYGON". 
+- **y_polygon** [_float-list_, unit = "m", default = [0,0,10,10]]: List with the y-coordinates of the points defining the surface polygon. Only used if "shape" is equal to "POLYGON".
+- **azimuth** [_float_, unit = "°", default = 0, min = -180, max = 180]: Angle formed between the x-axis of the building and the projection of the x-axis of the surface.
+- **altitude** [_float_, unit = "°", default = 0, min = -90, max = 90]: Angle formed between the z-axis of the building and the y-axis of the surface.
+- **spaces** [_component-list_, default = ["not_defined","not_defined], component type = Space]: Reference to the "Space" components for the side 0 and the side 1.
+
+See figures of the coordinate systems in the "Exterior_surface" component.
+
+**Example:**
+<pre><code class="python">
+...
+
+interior_hole = osm.components.Virtual_interior_surface("interior_hole",project)
+param = {
+            "ref_point": [8,0,-3],
+            "width": 8,
+            "height": 2.7,
+            "azimuth": 0,
+            "altitude": 0,
+            "spaces": ["space_0","space_1"]
+}
+interior_hole.set_parameters(param)
+</code></pre>
+
+### Opening
+
+Component for defining openings in exterior surfaces, e.g. windows or doors. These elements must be rectangular.
+
+#### Parameters
+
+- **surface** [_component_, default = "not_defined", component type = Exterior_surface]: Reference to the "Exterior_surface" in which it is located.
+- **width** [_float_, unit = "m", default = 1, min = 0]: Width of the opening.
+- **height** [_float_, unit = "m", default = 1, min = 0]: Height of the opening.
+- **ref_point** [_float-list_, unit = "m", default = [0,0]]: Two-dimensional coordinate of the opening reference point in the exterior wall coordinate system. The reference point is the lower left corner of the opening viewed from the outside.
+- **opening_type** [_component_, default = "not_defined", component type = Opening_type]: Reference to the "Opening_type" component that defines its composition.
+- **h_cv** [_float-list_, unit = "W/m²K", default = [19.3,2], min = 0]: Convective film coefficients of the exterior and interior surfaces, respectively.
+
+The following figure show geometrical definition of the opening in the surface coordinate system.
+
+![Opening gemetrical definition](img/opening_definition.png)
+
+**Example:**
+<pre><code class="python">
+...
+
+south_window = osm.components.Opening("south_window",project)
+param = {
+        "surface": "south_wall"
+        "ref_point": [2,1],
+        "width": 3,
+        "height": 1.3,
+        "opening_type": "double_glazed_window"
+}
+south_window.set_parameters(param)
+</code></pre>
+
+#### Variables
+
+After the simulation we will have the following variables of this component, all variables ending in 0 refer to the outer surface and those ending in 1 to the inner surface:
+
+- __T_s0, T_s1__ [°C]: Surface temperatures
+- __q_cd__ [W/m²]: Conductive heat flux.
+- __q_sol_dir_trans__ [W/m²]: Direct solar radiation passing through into space.
+- __q_cv0, q_cv1__ [W/m²]: Convective heat flux at the surfaces.
+- __q_sol0, q_sol1__ [W/m²]: Solar heat flux at the surfaces.
+- __q_sol01, q_sol10__ [W/m²]: Solar heat flux appearing on surface "i" due to the absorption of solar radiation on surface "j". 
+- __q_swig0, q_swig1__ [W/m²]: Radiant short wave heat flux at the surfaces due to internal gains.
+- __q_lwig0, q_lwig1__ [W/m²]: Radiant long wave heat flux at the surfaces due to internal gains.
+- __q_lwt0, q_lwt1__ [W/m²]: Radiant long wave heat flux at the surfaces due other surfaces temperatures.
+- __T_rm__ [°C]: Exterior radiant mean temperature.
+- __E_dir__ [W/m²]: Direct solar radiation incident on the exterior surface.
+- __E_dif__ [W/m²]: Diffuse solar radiation incident on the exterior surface.
+