generate_eem_assessment_indicators: Generate the harmonised results of the Energy Efficiency...

In biggproject/biggr: biggr

Generate the harmonised results of the Energy Efficiency Measures (EEM) assessment

Description

Generate the results in harmonised format to BIGG ontology for the EEM assessment in buildings. Results are always related to project of EEMs, which are single or combinations of multiple EEMs.

Usage

generate_eem_assessment_indicators(
  data,
  indicatorsAggregatableByTime,
  indicatorsNonAggregatableByTime,
  measuredProperty,
  measuredPropertyComponent,
  frequencies,
  buildingId,
  buildingSubject,
  timeColumn,
  localTimeZone,
  eemProjectDf,
  forceAssessmentSingleEEM,
  consumptionColumn,
  indicatorsTimeAggregationFunctions,
  indicatorsUnitsSubjects,
  baselineConsumptionColumn = NULL,
  buildingGrossFloorArea = NA,
  carbonEmissionsColumn = NULL,
  energyPriceColumn = NULL,
  modelName = NULL,
  modelId = NULL,
  modelLocation = NULL,
  modelStorageInfrastructureSubject = NULL,
  estimateWhenAggregate = T,
  minRatioToTimeAggregateIndicators = 0.75,
  prevResults = NULL
)

Arguments

data	<data.frame> that contains all resultant time series.
indicatorsAggregatableByTime	<array> of strings defining the KPIs to calculate. Possible values: EnergyUseSavings, EnergyUseSavingsRelative, EnergyUseSavingsIntensity, EnergyCostSavings, EnergyCostSavingsRelative, EnergyCostSavingsIntensity, EnergyEmissionsSavings, EnergyEmissionsSavingsRelative, EnergyEmissionsSavingsIntensity.
indicatorsNonAggregatableByTime	<string> defining the KPI to calculate. Possible values: NormalisedInvestmentCost, AvoidanceCost, SimplePayback, NetPresentValue, ProfitabilityIndex, NetPresentValueQuotient, InternalRateOfReturn.
measuredProperty	<uri> defining the energy consumption measured property. (E.g.: http://bigg-project.eu/ontology#EnergyConsumptionGridElectricity)
measuredPropertyComponent	<uri> defining the energy consumption component name. (E.g.: "http://bigg-project.eu/ontology#Heating").
frequencies	<array> of strings defining the frequencies used to resample the results. They must follow ISO 8601 format representing the time step. Examples: 'P1D' (One day), 'P1Y' (One year), 'P1M' (One month), 'P1DT12H' (One day and a half)...
buildingId	<string> building unique identifier.
buildingSubject	<uri> building unique URI.
timeColumn	<string> of the time column name.
localTimeZone	<string> specifying the local time zone related to the building in analysis. The format of this time zones are defined by the IANA Time Zone Database (https://www.iana.org/time-zones).
eemProjectDf	<data.frame> defining the single EEMs applied to the project. Columns that must be available: eemSubject, ExchangeRate, Investment, Date, Currency, Type, AffectationShare, buildingSubject, buildingElement, Lifespan, DiscountRate, eemProjectId
forceAssessmentSingleEEM	<boolean> defining whether the EEM assessment should be done by single EEMs or by EMM projects.
consumptionColumn	<string> defining the energy consumption column name in data.
indicatorsTimeAggregationFunctions	named <array> of the aggregation function used for each indicator. Possible values are: "SUM", "AVG", "WEIGHTED-AVG".
indicatorsUnitsSubjects	named <array> of URIs containing the units for each indicator.
baselineConsumptionColumn	<string> defining the counterfactual energy consumption column name in data. By default it is not considered.
buildingGrossFloorArea	<float> defining the gross floor area of the building. By default it is not considered.
carbonEmissionsColumn	<string> defining the column in data related with the CO2 emissions factor of energy consumption. By default it is not considered.
energyPriceColumn	<string> defining the column in data related with the price of energy consumption. By default it is not considered.
modelName	<string> Name of the model used to predict the consumption. By default results are not based by any model.
modelId	<string> Identifier of the model used to predict the consumption. By default results are not based by any model.
modelLocation	<string> containing the model path in the model storage infrastructure. By default results are not based by any model.
modelStorageInfrastructureSubject	<uri> of the model infrastructure type. By default results are not based by any model.
estimateWhenAggregate	<boolean> defining if a linear estimation should be made when gaps are found in the time-aggregation of the results. By default, the estimation is done.
minRatioToTimeAggregateIndicators	<float> [0-1] defining the minimum ratio of data (real vs. theoretical) that should be considered for time-aggregation operations in the results. By default, 75 timestep is not considered in the results. This will avoid yearly and monthly results with very rough results.
prevResults	<list> with the previous results of this function. By default, no previous results are considered.

Value

<list> containing a knowledge graph with all resultant metadata and time series objects, that later can be transformed to TTL and JSON files.

biggproject/biggr documentation built on Oct. 2, 2024, 11:13 p.m.