Building

src.Sink.characterization.building.building(in_var, kb: KB)

Building characterization

Simulates heat (space heating and hot water) and cooling (space cooling) consumptions over the year, according to building specifications and climate weather data. Characterizes heating/cooling streams of a building.

Parameters

• in_var (dict) –

  All necessary data to perform the building characterization data, with the following key:

  platform: dict

  Data obtained from the platform, with the following keys:

  • locationlist

    location [º]; [latitude,longitude]

  • number_floor: int

    number of floors

  • width_floor: float

    floor width [m]

  • length_floor: float

    floor length [m]

  • height_floor: float

    floor height [m]

  • ratio_wall_N: float

    ratio of the North wall area in total north facade area (wall + window) []

  • ratio_wall_S: float

    ratio of the South wall area in total north facade area (wall + window) []

  • ratio_wall_E: float

    ratio of the East wall area in total north facade area (wall + window) []

  • ratio_wall_W: float

    ratio of the West wall area in total north facade area (wall + window) []

  • daily_periods: float

    period of daily periods [h]

  • shutdown_periods: list

    period of days stream is not available [day]

  • saturday_on: int

    if available on saturdays - available (1); not available (0)

  • sunday_on: int

    if available on sundays - available (1); not available (0)

  • building_orientation: str

    building’s main facade orientation; “N”,”S”,”E” or “W”

  • space_heating_type: int

    Space heating type;

    1 = Conventional; heaters working fluid supply temperature of 75ºC, heaters working fluid return temperature of 45ºC) 2 = Low temperature; heaters working fluid supply temperature of 50ºC, heaters working fluid return temperature of 30ºC) 3 = Specify Temperatures - Advanced Properties; of supply_temperature_heat and target_temperature_heat

  • T_cool_on: float

    Cooling setpoint temperature [ºC]

  • T_heat_on: float

    Heating setpoint temperature [ºC]

  • T_off_min: float

    Heating setback setpoint temperature [ºC]

  • T_off_max: float

    Cooling setback setpoint temperature [ºC]

  • ref_system_fuel_type_heating: str

    Fuel type associated; e.g. “natural_gas”,”electricity”,”biomass”,”fuel_oil”,”none”

  • ref_system_eff_equipment_heating: float, optional

    Efficiency of the heating equipment

  • ref_system_fuel_type_cooling: str

    Fuel type associated

  • ref_system_eff_equipment_cooling: float, optional

    COP of the cooling equipment

  • real_heating_monthly_capacity: dict, optional

    Real monthly data - for each month of the year

  • real_heating_yearly_capacity: float, optional

    Real yearly data - single value

  • real_cooling_monthly_capacity: dict, optional

    Real monthly data - for each month of the year

  • real_cooling_yearly_capacity: float, optional

    Real yearly data - single value

  • number_person_per_floor: int, optional

    Persons per floor

  • supply_temperature_heat: float, optional

    Heating System ReturnTemperature [ºC]

  • target_temperature_heat: float, optional

    Heating System Supply Temperature [ºC]

  • supply_temperature_cool: float, optional

    Cooling System Return Temperature [ºC]

  • target_temperature_cool: float, optional

    Cooling System Supply Temperature [ºC]

  • tau_glass: float, optional

    glass windows transmissivity []

  • u_wall: float, optional

    walls’ U value [W/m2.K]

  • u_roof: float, optional

    roof U value [W/m2.K]

  • u_glass: float, optional

    glass windows U value [W/m2.K]

  • u_floor: float, optional

    floor U value [W/m2.K]

  • alpha_wall: float, optional

    walls’ radiation absorption coefficient []

  • alpha_floor: float, optional

    floor’s radiation absorption coefficient []

  • alpha_glass: float, optional

    windows’ radiation absorption coefficient []

  • cp_floor: float, optional

    floor specific heat capacitance [J/kg.K]

  • cp_roof: float, optional

    roof specific heat capacitance [J/kg.K]

  • cp_wall: float, optional

    wall specific heat capacitance [J/kg.K]

  • air_change_hour: float, optional

    air changes per hour due to infiltrations [1/h]

  • renewal_air_per_person: float, optional

    fresh air changer per person [m3/s per person]

  • vol_dhw_set: float, optional

    Volume of daily water consumption [m3]

  • Q_gain_per_floor: float, optional

    Internal Gains [W/m2]

  • emissivity_wall: float, optional

    Walls’s emissivity

  • emissivity_glass: float, optional

    Glass Window’s emissivity

• kb (dict) – Knowledge Base data

Returns

output –

Streams data

• streamslist

  List with dicts of all streams with the following keys:

  • idint

    stream ID []

  • namestr

    Stream name []

  • object_typestr

    DEFAULT = “stream” []

  • object_linked_id

    None: DEFAULT=NONE, since no equipment/process is associated

  • stream_typestr

    Stream designation []; inflow, outflow, excess_heat

  • supply_temperaturefloat

    Stream’s supply/initial temperature [ºC]

  • target_temperaturefloat

    Stream’s target/final temperature [ºC]

  • fluidstr

    Stream fluid name

  • flowratefloat

    Stream mass flowrate [kg/h]

  • schedulelist

    Hourly values between 0 and 1, according to the capacity ration on that hour

  • hourly_generation: list

    Stream’s hourly capacity [kWh]

  • capacityfloat

    Stream’s capacity [kW]

  • monthly_generationlist

    Stream’s monthly capacity [kWh]

  • fuelstr

    Associated equipment fuel name []

  • eff_equipmentfloat

    Associated equipment efficiency []

Return type

dict