Crate cteepbd

Source
Expand description

§CteEPBD

This crate provides a library and binary that implements most of the ISO EN 52000-1 standard Energy performance of buildings - Overarching EPB assessment - General framework and procedures (under version EN ISO 52000-1:2017).

This is oriented towards the assessment of the energy performance of buildings under the spanish building code (CTE) and, thus, uses specific naming conventions and default values best suited for that purpose.

It also holds the following assumptions:

  • constant weighting factors through all timesteps
  • no priority is defined for energy production (average step A weighting factor f_we_el_stepA)
  • all on-site produced energy from non cogeneration sources is considered as delivered
  • on-site produced energy is not compensated on a service by service basis, but on a carrier basis
  • unit and constant load matching factor

Some restrictions may be lifted in the future. Specifically:

  • implement a load matching factor (f_match_t) following formula B.32 in appendix B
  • allow the imputation to a specific service for produced energy
  • allow setting priorities for energy production

Este crate proporciona una biblioteca y un programa que implementa una parte sustancial del estándar EN ISO 52000-1: Eficiencia energética de los edificios - Evaluación global de la EPB - Parte 1: Marco general y procedimientos (versión EN ISO 52000-1:2017).

Este software está orientado a la evaluación de la eficiencia energética de los edificios dentro del marco de la normativa española de edificación (Código Técnico de la Edificación CTE, DB-HE) y, así, adopta nomenclatura y valores por defecto adaptados a ese propósito.

También realiza los siguientes supuestos:

  • factores de paso constantes en todo el periodo de cálculo
  • no se definen prioridades para la producción de energía
  • se considera como suministrada toda la energía producida procedente de fuentes distintas a la cogeneración
  • la energía producida in situ se compensa por vector energético y no por servicios
  • factor de coincidencia de cargas igual a la unidad

Algunas restricciones pueden revisarse en el futuro, tales como:

  • implementación del factor de coincidencia de cargas según fórmula B.32 del apéndice B
  • imputación de energía generada a servicios específicos
  • fijación de prioridades para la producción de energía

§Ejemplo

use std::fs::{read_to_string, File};
use cteepbd::*;

// lectura de un archivo de componentes energéticos
let components = read_to_string("test_data/cte_test_carriers.csv")
    .unwrap()
    .parse::<Components>()
    .unwrap();

// Definición de los factores de usuario y sus valores por defecto
let user_wf = UserWF {
    red1: Some((1.0, 0.0, 0.0).into()),
    red2: None,
    cogen_to_grid: None,
    cogen_to_nepb: None,
}; // Factores definidos por el usuario
let default_user_wf = cte::CTE_USERWF; // Valores por defecto de factores de paso del usuario

// Factores de usuario reglamentarios según localización y factores de usuario
let fp = cte::wfactors_from_loc("PENINSULA",
    &cte::CTE_LOCWF_RITE2014,
    user_wf,
    default_user_wf
).unwrap();

// Factor de exportación y área de referencia
let kexp = cte::KEXP_DEFAULT; // factor de exportación [-]
let arearef = 200.0; // superficie de referencia [m2]

// Cálculo del balance global según EN ISO 52000-1:2017
let balance = energy_performance(&components, &fp, kexp, arearef).unwrap();

// Visualización compacta
println!("{}", cte::balance_to_plain(&balance));

Modules§

cte
Utilidades para el cumplimiento reglamentario (compliance utilities)
error
Gestión de errores (error handling)
types
Tipos de datos (types)

Structs§

Balance
Datos y resultados de un cálculo de eficiencia energética
BalanceForCarrier
Resultados detallados del balance energético para un vector energético
BalanceTotal
Resultados del balance global (todos los vectores), en valor absoluto o por m2.
Components
Lista de datos de componentes con sus metadatos
Factors
Lista de factores de paso con sus metadatos
UserWF
Estructura para definir valores por defecto y valores de usuario

Statics§

VERSION
Número de versión de la librería

Functions§

energy_performance
Calcula enficiencia energética agregando resultados por vector energético