# README

## Formal title

  Dataset for ``Mitigation versus adaptation: 
  Does insulating buildings increase overheating risk?''


## Description

Dataset for ``Mitigation versus adaptation: 
Does insulating buildings increase overheating risk?''.
The dataset corresponds to the simulation parametric study 
described in the journal publication
(please see details in data archive page).


## License

The dataset is licensed under a 
Creative Commons Attribution-ShareAlike 4.0 International License.


## Data

The data is stored in the file `data.csv`, 
a table with dimensions `(1152000 rows × 18 columns)`.
The table follows the principles of 
'each variable is a column and each observation is a row'.
The following describes the columns in the dataset,
together with metadata required for import in an application.
Values in brackets in column names indicates units where applicable.
Further descriptions are available in the journal publication.

  * Insulation
    - data type: categorical (strings)
    - purpose: Identify simulation case.
    - description: Cases considered in parameter `Insulation`.
      - '0.10'
      - '0.18'
      - '0.35'
      - '0.45'
      - '0.60'
  * Thermal mass
    - data type: categorical (strings)
    - purpose: Identify simulation case.
    - description: Cases considered in parameter `Thermal mass`.
      - '38'
      - '281'
      - '520'
  * Window size
    - data type: categorical (strings)
    - purpose: Identify simulation case.
    - description: Cases considered in parameter `Window size`.
      - '8'
      - '11'
      - '14'
  * Shading
    - data type: categorical (strings)
    - purpose: Identify simulation case.
    - description: Cases considered in parameter `Shading`.
      - 'None'
      - 'Full'
  * Internal gains
    - data type: categorical (string)
    - purpose: Identify simulation case.
    - description: Cases considered in parameter `Internal gains`.
      - 'Away'
      - 'Home'
  * Window opening rubric
    - data type: categorical (string)
    - purpose: Identify simulation case.
    - description: Cases considered in parameter `Window opening rubric`.
      - 'None'
      - 'Day-O Tmax'
      - 'Day-O Tneu'
      - 'Day-A Tmax'
      - 'Occupied Tneu'
  * Algorithm
    - data type: categorical (string)
    - purpose: Identify simulation case.
    - description: Cases considered in parameter `Algorithm`.
      - 'Fixed'
      - 'Adaptive'
  * Infiltration
    - data type: categorical (string)
    - purpose: Identify simulation case.
    - description: Cases considered in parameter `Infiltration`.
      - '20'
      - '10'
      - '5'
      - '2.5'
      - '0.2'
  * Orientation
    - data type: categorical (string)
    - purpose: Identify simulation case.
    - description: Cases considered in parameter `Orientation`.
      - 'East'
      - 'South'
      - 'West'
      - 'North'
  * Location
    - data type: categorical (string)
    - purpose: Identify simulation case.
    - description: Cases considered in parameter `Location`.
      - 'Cairo'
      - 'London'
      - 'New Delhi'
      - 'New York'
      - 'Sao Paulo'
      - 'Seville'
      - 'Shanghai'
      - 'Sydney'
  * House
    - data type: categorical (string)
    - purpose: Identify simulation case.
    - description: Cases considered in parameter `House`.
      - 'Apartment'
      - 'Detached'
  * Zone
    - data type: categorical (string)
    - purpose: Identify simulation case.
    - description: Cases considered in parameter `Zone`.
      - 'Living R.'
      - 'Bedroom'
  * occupancy [h]
    - data type: int32
    - purpose: Simulation output summary variable (yearly indicator).
    - description: Sum of hours `Zone` is occupied over a year.
  * oh_hour_count [h]
    - data type: int32
    - purpose: Simulation output summary variable (yearly indicator).
    - description: Overheating hour count.
  * oh_weighted_hour_count [h]
    - data type: float64
    - purpose: Simulation output summary variable (yearly indicator).
    - description: Overheating weighted hours.
  * oh_severity [K]
    - data type: float64
    - purpose: Simulation output summary variable (yearly indicator).
    - description: Overheating severity indicator (see journal publication).
  * ventilation_house [ach]
    - data type: float64
    - purpose: Simulation output summary variable (yearly indicator).
    - description: House-level mean natural ventilation outdoor air exchange.
  * space_heating_house [kWh/m2/a]
    - data type: float64
    - purpose: Simulation output summary variable (yearly indicator).
    - description: House-level space heating demand.