Occupant profile - kaemco/CitySim-Solver GitHub Wiki
In this section you will find everything related to human activity in buildings. In each Tag District there are as many Tags Occupant profile as necessary for the simulation. It represents the human activity per day (how many people are in the building per day). Each occupant profile type contains daily occupancy profile and yearly profile.
<OccupancyDayProfile id="1" p1="1.0" p2="1.0" p3="1.0" p4="1.0" p5="1.0" p6="1.0" p7="0.8" p8="0.6" p9="0.4" p10="0.4" p11="0.4" p12="0.6" p13="0.8"p14="0.6" p15="0.4" p16="0.4" p17="0.6" p18="0.8" p19="0.8" p20="0.8" p21="0.8"
p22="1.0" p23="1.0" p24="1.0"/>It defines daily occupancy profile identified with id number 1 and contains the daily rate of occupancy. For example, p13 represents occupancy rate at 13rth hour equal to 0.8. This occupancy rate can be taken from SIA 2024. About SIA 2024
<OccupancyYearProfile id="1" d1="1" d2="1" d3="1" d4="1" d5="1" d6="1" d7="1"
d8="1" d9="1" d10="1" d11="1" d12="1" d13="1" d14="1" d15="1" d16="1" d17="1"
d18="1" d19="1" d20="1" d21="1" d22="1" d23="1" d24="1" d25="1" d26="1" d27="1"
d28="1" d29="1" d30="1" d31="1" d32="1" d33="1" d34="1" d35="1" d36="1" d37="1"
d38="1" d39="1" d40="1" d41="1" d42="1" d43="1" d44="1" d45="1" d46="1" d47="1"
d48="1" d49="1" d50="1" d51="1" d52="1" d53="1" d54="1" d55="1" d56="1" d57="1"
d58="1" d59="1" d60="1" d61="1" d62="1" d63="1" d64="1" d65="1" d66="1" d67="1"
d68="1" d69="1" d70="1" d71="1" d72="1" d73="1" d74="1" d75="1" d76="1" d77="1"
d78="1" d79="1" d80="1" d81="1" d82="1" d83="1" d84="1" d85="1" d86="1" d87="1"
d88="1" d89="1" d90="1" d91="1" d92="1" d93="1" d94="1" d95="1" d96="1" d97="1"
d98="1" d99="1" d100="1" d101="1" d102="1" d103="1" d104="1" d105="1" d106="1"
d107="1" d108="1" d109="1" d110="1" d111="1" d112="1" d113="1" d114="1" d115="1"
d116="1" d117="1" d118="1" d119="1" d120="1" d121="1" d122="1" d123="1" d124="1"
d125="1" d126="1" d127="1" d128="1" d129="1" d130="1" d131="1" d132="1" d133="1"
d134="1" d135="1" d136="1" d137="1" d138="1" d139="1" d140="1" d141="1" d142="1"
d143="1" d144="1" d145="1" d146="1" d147="1" d148="1" d149="1" d150="1" d151="1
" d152="1" d153="1" d154="1" d155="1" d156="1" d157="1" d158="1" d159="1" d160="1"
d161="1" d162="1" d163="1" d164="1" d165="1" d166="1" d167="1" d168="1" d169="1"
d170="1" d171="1" d172="1" d173="1" d174="1" d175="1" d176="1" d177="1" d178="1"
d179="1" d180="1" d181="1" d182="1" d183="1" d184="1" d185="1" d186="1" d187="1"
d188="1" d189="1" d190="1" d191="1" d192="1" d193="1" d194="1" d195="1" d196="1"
d197="1" d198="1" d199="1" d200="1" d201="1" d202="1" d203="1" d204="1" d205="1"
d206="1" d207="1" d208="1" d209="1" d210="1" d211="1" d212="1" d213="1" d214="1"
d215="1" d216="1" d217="1" d218="1" d219="1" d220="1" d221="1" d222="1" d223="1"
d224="1" d225="1" d226="1" d227="1" d228="1" d229="1" d230="1" d231="1" d232="1"
d233="1" d234="1" d235="1" d236="1" d237="1" d238="1" d239="1" d240="1" d241="1"
d242="1" d243="1" d244="1" d245="1" d246="1" d247="1" d248="1" d249="1" d250="1"
d251="1" d252="1" d253="1" d254="1" d255="1" d256="1" d257="1" d258="1" d259="1"
d260="1" d261="1" d262="1" d263="1" d264="1" d265="1" d266="1" d267="1" d268="1"
d269="1"
d270="1" d271="1" d272="1" d273="1" d274="1" d275="1" d276="1" d277="1" d278="1"
d279="1" d280="1" d281="1" d282="1" d283="1" d284="1" d285="1" d286="1" d287="1"
d288="1" d289="1" d290="1" d291="1" d292="1" d293="1" d294="1" d295="1" d296="1"
d297="1" d298="1" d299="1" d300="1" d301="1" d302="1" d303="1" d304="1"
d305="1" d306="1" d307="1" d308="1" d309="1" d310="1" d311="1" d312="1" d313="1"
d314="1" d315="1" d316="1" d317="1" d318="1" d319="1" d320="1" d321="1" d322="1"
d323="1" d324="1" d325="1" d326="1" d327="1" d328="1" d329="1" d330="1" d331="1"
d332="1" d333="1" d334="1" d335="1" d336="1" d337="1" d338="1" d339="1" d340="1"
d341="1" d342="1" d343="1" d344="1" d345="1" d346="1" d347="1" d348="1" d349="1"
350="1" d351="1" d352="1" d353="1" d354="1" d355="1" d356="1" d357="1" d358="1"
d359="1" d360="1" d361="1" d362="1" d363="1" d364="1" d365="1"/>It defines yearly occupancy profile identified with id number 1 and di represents the daily profile associated with the ith day where i is from 1 to 365. For example, d89 represents the 89th day with daily profile corresponding to id 1.
In each Tag District there are as many Tags DeviceType as necessary for the simulation. It represents the use of electrical appliances that consume a certain amount of power and a probability of its use. Each device type contains different devices and for each device the average power (W), the sensible heat gain convective and radiative fractions and the hourly mean usage probability [0,1].
<DeviceType id="1" name="sample device">
<Device name="device 1" avgPower="400" convectiveFraction="0.8" radiativeFraction="0.1" p1="0.1" p2="0.3" p3="0.05"
p4="0.04" p5="0.03" p6="0.05" p7="0.8" p8="0.13" p9="0.6" p10="0.15" p11="0.18" p12="0.15" p13="0.54" p14="0.66"
p15="0.35" p16="0.54" p17="0.73" p18="0.75" p19="0.44" p20="0.53" p21="0.61" p22="0.51" p23="0.12" p24="0.11"/>
</DeviceType>
<DeviceType id="2" name="Office">
<Device name="Office device" avgPower="130" convectiveFraction="0.8" radiativeFraction="0.1" p1="0.001"
p2="0.001" p3="0.001" p4="0.001" p5="0.001" p6="0.001" p7="0.001" p8="0.2" p9="0.4" p10="0.6" p11="0.8" p12="0.8"
p13="0.4" p14="0.6" p15="0.8" p16="0.8" p17="0.4" p18="0.2" p19="0.001" p20="0.001" p21="0.001" p22="0.001" p23="0.001"
p24="0.001"/>
</DeviceType>It defines a device type referred by the id number 1 and can contains only one Device. For example, device name “device 1” have average power as 400 W, convective heat gain fraction of 0.8 (convective heat gain due to this device will be 0.8*400=320 W), radiative sensible heat gains fraction of 0.1 (the remainder of 0.1 is for mechanical work) and hourly usage probability. In case, average power is not known then use 50% of the rated power of the device. In case of lighting, rated power should be used.
It should be noted that all the probabilities are mutually independent, which means that a random number will be generated for all the devices for each time step, to select the total power and heat gains. For example, for the device “device 1” at time step 2, a random number will be generated and compared with 0.3 and if the number is less than or equal to 0.3 the device will be selected. This will be done for the entire device list in device type. Note: By default when the convective and radiative sensible heat gain fractions are not given, their values are assumed to be respectively 0.8 and 0.2.
In each Tag District there are as many Tags ActivityType as necessary for the simulation. Each activity type contains different activities and the hourly mean activity probability [0,1] and the device type.
<ActivityType id="1" name="Sample Activity">
<Activity name="activity 1" p1="0.1" p2="0.1" p3="0.2" p4="0.2"
p5="0.3" p6="0.3" p7="0.4" p8="0.5" p9="0.6" p10="0.6"
p11="0.8" p12="0.6" p13="0.1" p14="0.1" p15="0.2" p16="0.2"
p17="0.3" p18="0.3" p19="0.4" p20="0.5" p21="0.6"
p22="0.6" p23="0.8" p24="0.6" deviceType="1"/>
<Activity name="activity 2" p1="0.5" p2="0.3" p3="0.3" p4="0.4"
p5="0.4" p6="0.2" p7="0.2" p8="0.2" p9="0.3" p10="0.3"
p11="0.1" p12="0.3" p13="0.5" p14="0.3" p15="0.3" p16="0.4"
p17="0.4" p18="0.2" p19="0.2" p20="0.2" p21="0.3"
p22="0.3" p23="0.1" p24="0.3" deviceType="1"/>
<Activity name="activity 3" p1="0.4" p2="0.6" p3="0.5" p4="0.4"
p5="0.3" p6="0.5" p7="0.4" p8="0.3" p9="0.1" p10="0.1"
p11="0.1" p12="0.1" p13="0.4" p14="0.6" p15="0.5" p16="0.4"
p17="0.3" p18="0.5" p19="0.4" p20="0.3" p21="0.1"
p22="0.1" p23="0.1" p24="0.1" deviceType="2"/>
</ActivityType>It defines a activity type referred by the id number 1 and contains 3 activities (activity 1, activity 2 and activity 3). For example, for the activity 1, hourly mean probability is given and the device type id as 1.
The probability of the occurrence of the activities is mutually exclusive i.e. at any given time only one activity will be performed. The cumulative probability of the activities for the same hour should be 1. The program will calculate the cumulative probability and the user need to give only the hourly mean probability of the occurrence. For example, for the time step 6 (p6), the mean probability of occurrence of “activity 1”, “activity 2” and “activity 3” is given as 0.3, 0.2 and 0.5. The cumulative probability will be calculated as given below: 0 >= “activity 1” <= 0.3 0.3 > “activity 2” <= 0.5 0.5 > “activity 3” <= 1 The activity will be chosen based on the random number generated between 0 and 1. For example, if the number generated is 0.4 then “activity 2” will be selected and the device type is 1 will be used to determine the device usage profile. The activities can be written in any order.
The electricity consumed by the devices in each thermal zone is computed deterministically by doing for each hour and for each occupant the multiplication of the activity probability, the device probability and the device average power.
In each Tag District there are as many Tags DHW profile as necessary for the simulation. Witch means Daily Hot Water. Each DHW profile type contains daily DHW profile and yearly profile. DHW profile represents water consumption per hour.
<DHWDayProfile id="1" name=" IEA task 26 DHW profile" waterConsumption="50.0" p1="0.0018",
p2="0.0019", p3="0.0019", p4="0.0018", p5="0.0018", p6="0.042", p7="0.090", p8="0.13", p9="0.090",
p10="0.038", p11="0.038", p12="0.039", p13="0.040", p14="0.040", p15="0.040",
p16="0.041", p17="0.040", p18="0.040", p19="0.053", p20="0.081", p21="0.073", p22="0.038",
p23="0.036", p24="0.0018"/>It defines daily DHW profile identified with id number 1, daily water consumption of 50.0 liters per person, and contains the hourly distribution of that consumption. Note that it is normalized: p1+p2+...+p24=1. If the occupants are set to "stochastic", then at every hour, eg the 6th hour, there is a probability p6=0.042 that the occupant uses the whole 50 liters during that hour (to try to model taking a shower). If the occupant has "stochastic" set to false, then at the 6th hour he always consumes 50*0.042=2.1 liters. This DHW probability profile above is taken from IEA Task 26.
<DHWYearProfile id="1" name="IEA task 26 Profile House" d1="1" d2="1" d3="1"
d4="1" d5="1" d6="1" d7="1" d8="1" d9="1" d10="1" d11="1" d12="1" d13="1"
d14="1" d15="1" d16="1" d17="1" d18="1" d19="1" d20="1" d21="1" d22="1" d23="1"
d24="1" d25="1" d26="1" d27="1" d28="1" d29="1" d30="1" d31="1" d32="1" d33="1"
d34="1" d35="1" d36="1" d37="1" d38="1" d39="1" d40="1" d41="1" d42="1" d43="1"
d44="1" d45="1" d46="1" d47="1" d48="1" d49="1" d50="1" d51="1" d52="1" d53="1"
d54="1" d55="1" d56="1" d57="1" d58="1" d59="1" d60="1" d61="1" d62="1" d63="1"
d64="1" d65="1" d66="1" d67="1" d68="1" d69="1" d70="1" d71="1" d72="1" d73="1"
d74="1" d75="1" d76="1" d77="1" d78="1" d79="1" d80="1" d81="1" d82="1" d83="1"
d250="1" d251="1" d252="1" d253="1" d254="1" d255="1" d256="1" d257="1" d258="1"
d259="1" d260="1" d261="1" d262="1" d263="1" d264="1" d265="1" d266="1" d267="1"
d268="1" d269="1" d270="1" d271="1" d272="1" d273="1" d274="1" d275="1" d276="1"
d277="1" d278="1" d279="1" d280="1" d281="1" d282="1" d283="1" d284="1" d285="1"
d286="1" d287="1" d288="1" d289="1" d290="1" d291="1" d292="1" d293="1" d294="1"
d295="1" d296="1" d297="1" d298="1" d299="1" d300="1" d301="1" d302="1" d303="1"
d304="1" d305="1" d306="1" d307="1" d308="1" d309="1" d310="1" d311="1" d312="1"
d313="1" d314="1" d315="1" d316="1" d317="1" d318="1" d319="1" d320="1" d321="1"
d322="1" d323="1" d324="1" d325="1" d326="1" d327="1" d328="1" d329="1" d330="1"
d331="1" d332="1" d333="1" d334="1" d335="1" d336="1" d337="1" d338="1" d339="1"
d340="1" d341="1" d342="1" d343="1" d344="1" d345="1" d346="1" d347="1" d348="1"
d349="1" d350="1" d351="1" d352="1" d353="1" d354="1" d355="1" d356="1" d357="1"
d358="1" d359="1" d360="1" d361="1" d362="1" d363="1" d364="1" d365="1"/>It defines yearly DHW profile identified with id number 1 and di represents the daily profile associated with the ith day where i is from 1 to 365. For example, d89 represents the 89th day with daily profile corresponding to id 1.