From 722553a177bfb28994d83e1c05cc7c3ea7e14c9d Mon Sep 17 00:00:00 2001
From: F Rehmann <49240249+c0nb4@users.noreply.github.com>
Date: Wed, 5 Feb 2025 16:35:52 +0100
Subject: [PATCH] Update readme
---
README.md | 7 +-
classes.html | 158 -
.../data/scenarios/test_scenario_nwg.csv | 12 +
img/DVG_Logo.png | Bin 0 -> 206615 bytes
packages.html | 35 -
test.ipynb | 3549 -----------------
6 files changed, 13 insertions(+), 3748 deletions(-)
delete mode 100644 classes.html
create mode 100644 districtgenerator/data/scenarios/test_scenario_nwg.csv
create mode 100644 img/DVG_Logo.png
delete mode 100644 packages.html
delete mode 100644 test.ipynb
diff --git a/README.md b/README.md
index 39b1f72f..0ee902ca 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,9 @@

+
# DistrictGenerator
[](http://doge.mit-license.org)
-[](https://rwth-ebc.github.io/FiLiP/master/docs/index.html)
The districtgenerator is a Python tool for generating building-specific thermal, electrical and occupancy profiles for districts.
By integrating several open-source data bases and tools like [TEASER](https://github.com/RWTH-EBC/TEASER) and
@@ -74,11 +74,6 @@ The minimal input data set was defined following the [TABULA archetype approach]
* _retrofit_: retrofit state according to TABULA (0: existing state, 1: usual refurbishment, 2: advanced refurbishment)
* _area_: reference floor area (given in square meters)
-- id: building ID (just numerate the buildings)
-- building: residential building type (single family house, terraced house, multi family house or apartment block)
-- year: construction year (the calendar year in which the building was constructed)
-- retrofit: retrofit state according to TABULA (0: existing state, 1: usual refurbishment, 2: advanced refurbishment)
-- area: reference floor area (given in square meters)
The example.csv file can be used as [template](../districtgenerator/data/scenarios/example.csv).
diff --git a/classes.html b/classes.html
deleted file mode 100644
index 95a9ba66..00000000
--- a/classes.html
+++ /dev/null
@@ -1,158 +0,0 @@
-
-
-
-
-
- classDiagram
- class Datahandler {
- SunRad : ndarray
- advancedModel : NoneType
- counter : dict
- district : list
- filePath
- resultPath : NoneType
- scenario : NoneType, TextFileReader
- scenario_name : NoneType, str
- sheetFile : NoneType
- site : dict
- srcPath
- time : dict
- weatherFile : NoneType
- generateBuildings()
- generateDemands(calcUserProfiles: bool, saveUserProfiles: bool, savePath: str)
- generateDistrictComplete(scenario_name, calcUserProfiles, saveUserProfiles)
- generateEnvironment()
- initializeBuildings(scenario_name)
- loadDistrict(scenario_name)
- plot(mode, initialTime, timeHorizon, savePlots, timeStamp, show)
- saveDistrict()
- setAdvancedModel(pathAdvancedModel)
- setResultPath(new_path)
- }
- class DemandPlots {
- color : dict
- factor
- filePath
- l
- labels : dict
- months : list
- plots : list
- plotsMonthly : list
- srcPath
- time
- titles : dict
- y : dict
- defaultPlots(plotResolution, initialTime, timeHorizon, savePlots, timeStamp, show)
- onePlot(plotType, plotResolution, initialTime, timeHorizon, label, title, color, savePlots, timeStamp, show)
- preparePlots(data)
- }
- class Envelope {
- A : dict
- A_m
- A_tot
- C_m
- Delta_theta_er : int
- F_F : int
- F_r : dict
- F_sh_gl : int
- H_tr_em : dict
- H_tr_is
- H_tr_ms
- H_tr_w
- H_ve
- I_sol : dict
- Lambda : dict
- R_se : dict
- R_si : dict
- T_set_min
- U : dict
- V
- alpha_Sc : dict
- attributes : list
- b_floor : float
- b_tr : dict
- c_p_air
- construction_type
- construction_year
- cp : dict
- d : dict
- d_iso : dict
- epsilon : dict
- f_class : dict
- file_path
- g_gl : dict
- h_is : float
- h_ms : float
- h_r : dict
- id
- kappa : dict
- lambda_at : float
- opaque : set
- opaque_ext : list
- phi_ia
- phi_m : dict
- phi_st : dict
- retrofit
- rho : dict
- rho_air
- usage_short
- ventilationRate
- calcHeatLoad(site, method)
- calcNormativeProperties(SunRad, internal_gains)
- loadAreas(prj)
- loadComponentProperties(prj)
- loadMaterialID(mat_id, data_class)
- loadParams()
- specificHeatCapacity(d, d_iso, density, cp)
- }
- class Profiles {
- activity_profile : NoneType, list
- app_load : list, ndarray
- initial_day
- light_load : list, ndarray
- nb_days
- number_occupants
- occ_profile : list, ndarray
- prob_profiles_dhw : dict
- time_resolution
- generate_activity_profile()
- generate_dhw_profile()
- generate_el_profile(irradiance, el_wrapper, annual_demand, do_normalization)
- generate_gain_profile()
- generate_occupancy_profiles()
- loadProbabilitiesDhw()
- }
- class Sun {
- filePath
- getGeometry(initialTime, timeDiscretization, timesteps, timeZone, location, altitude)
- getIncidenceAngle(beta, gamma, phi, omega, delta)
- getSolarGains(initialTime, timeDiscretization, timeSteps, timeZone, location, altitude, beta, gamma, beam, diffuse, albedo)
- getTotalRadiationTiltedSurface(theta, thetaZ, beamRadiation, diffuseRadiation, airmass, extraterrestrialIrradiance, beta, albedo)
- }
- class Users {
- annual_el_demand : NoneType, ndarray
- building
- dhw : NoneType, ndarray
- el_wrapper : list
- elec : NoneType, ndarray
- gains : NoneType, ndarray
- heat : NoneType, ndarray
- lighting_index : list
- nb_flats : NoneType, int
- nb_occ : list
- occ : NoneType, ndarray
- calcHeatingProfile(site, envelope, time_resolution)
- calcProfiles(site, time_resolution, time_horizon, initital_day)
- create_el_wrapper()
- generate_annual_el_consumption()
- generate_lighting_index()
- generate_number_flats(area)
- generate_number_occupants()
- loadProfiles(unique_name, path)
- saveHeatingProfile(unique_name, path)
- saveProfiles(unique_name, path)
- }
-
-
-
-
diff --git a/districtgenerator/data/scenarios/test_scenario_nwg.csv b/districtgenerator/data/scenarios/test_scenario_nwg.csv
new file mode 100644
index 00000000..f8b3a0a6
--- /dev/null
+++ b/districtgenerator/data/scenarios/test_scenario_nwg.csv
@@ -0,0 +1,12 @@
+id;building;year;retrofit;area
+0;IWU Office, Administrative or Government Buildings;1963;0;61
+1;IWU Research and University Teaching;1934;0;59
+2;IWU Health and Care;2014;0;25
+3;IWU School, Day Nursery and other Care;1926;0;21
+4;IWU Culture and Leisure;1993;0;21
+5;IWU Sports Facilities;1905;0;54
+6;IWU Trade Buildings;1947;0;64
+7;IWU Technical and Utility (supply and disposal);1924;0;70
+8;IWU Transport;1927;0;89
+9;IWU Generalized (1) Services building;1929;0;16
+10;IWU Generalized (2) Production buildings;1988;0;86
diff --git a/img/DVG_Logo.png b/img/DVG_Logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..6602d3293f6d1a248bf21cd072be561295991f75
GIT binary patch
literal 206615
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