Dragonfly Primer
Ladybug Tools for Grasshopper Documentation
  • Dragonfly Primer
  • Components
    • 0 :: Create
      • Deconstruct All Object
      • Deconstruct Model
      • Deconstruct Object
      • Model
      • Building from Detailed Rooms
      • Building from Footprint
      • Building from Solid
      • Building from Stories
      • Process Alleys
      • Separate Top Bottom
      • Rejoin to Building
      • Story
      • Room2D
      • Solve Adjacency
      • Apply Facade Parameters
      • Detailed Windows
      • Repeating Window Ratio Parameters
      • Repeating Window Width Height Parameters
      • Simple Window Ratio Parameters
      • Single Window Parameters
      • Extruded Border Parameters
      • Gridded Skylight Parameters
      • Louver Parameters
      • Overhang Parameters
      • Apply Roof
      • ContextShade
      • Align
      • BC by Orientation
      • Deconstruct Roof
      • Intersect Room2Ds
      • Set Ground Top
    • 1 :: Visualize
      • Visualize All
      • Visualize Floors
      • Visualize Quick
      • Visualize Wireframe
      • Geometry Properties
      • Room2D Attributes
      • Color Room2D Attributes
      • Room2Ds by Attribute
      • Color Network Attributes
      • Network Attributes
      • Color Network Results
    • 2 :: Serialize
      • Object to String
      • String to Object
      • Dump Objects
      • Load Objects
      • Model To Honeybee
      • Model To geoJSON
      • Model From Honeybee
      • Model From geoJSON
      • Validate Model
    • 3 :: Energy
      • Run OpenDSS
      • Run REopt
      • Run RNM
      • Run URBANopt
      • Diversify Building Programs
      • Load Mapper Measure
      • Process Load
      • Reassign Energy Properties
      • All-Air HVAC
      • DOAS HVAC
      • Detailed HVAC
      • HeatCool HVAC
      • IdealAir
      • SHW System
      • Electrical Connector
      • Electrical Network
      • Ground Photovoltaics
      • Road Network
      • Substation
      • Transformer
      • Read OpenDSS Result
      • Search OpenDSS
      • Deconstruct OpenDSS
      • Fourth Generation Thermal Loop
      • GHE Thermal Loop
      • REopt Financial Parameters
      • Run Modelica DES
      • Window Opening
    • 4 :: AlternativeWeather
      • Run Urban Weather Generator
      • UWG Simulation Parameter
      • Assign Building UWG Properties
      • Assign Model UWG Properties
      • Terrain
      • Traffic Parameters
      • Construct Design Day
      • Create EPW
      • Write DDY
      • Write EPW
      • Horizontal Infrared
      • Import NOAA File
      • Boundary Layer Parameters
      • Luminous Efficacy
      • Reference EPW Parameters
      • Vegetation Parameters
Powered by GitBook
On this page
  • Inputs
  • Outputs
Export as PDF
  1. Components
  2. 3 :: Energy

Diversify Building Programs

PreviousRun URBANoptNextLoad Mapper Measure

Last updated 3 years ago

-

Diversify the ProgramTypes assigned to a Building's Room2Ds.

This is useful when attempting to account for the fact that not all rooms are used by occupants according to a strict scheduled regimen. Some rooms will be used more than expected and others less.

This component uses a random number generator and gaussian distribution to generate loads that vary about the original "mean" programs. Note that the randomly generated values assigned by this component will be different every time that this component is run unless and input for seed_ has been specified.

In addition to diversifying load values, approximately 2/3 of the schedules in the resulting Room2Ds will be offset from the mean by the input schedule_offset (1/3 ahead and another 1/3 behind).

Inputs

  • building [Required]

    A Dragonfly Building, which will have its room programs diversified.

  • occ_stdev

    A number between 0 and 100 for the percent of the occupancy people_per_area representing one standard deviation of diversification from the mean. (Default 20 percent).

  • lighting_stdev

    A number between 0 and 100 for the percent of the lighting watts_per_area representing one standard deviation of diversification from the mean. (Default 20 percent).

  • electric_stdev

    A number between 0 and 100 for the percent of the electric equipment watts_per_area representing one standard deviation of diversification from the mean. (Default 20 percent).

  • gas_stdev

    A number between 0 and 100 for the percent of the gas equipment watts_per_area representing one standard deviation of diversification from the mean. (Default 20 percent).

  • hot_wtr_stdev

    A number between 0 and 100 for the percent of the service hot water flow_per_area representing one standard deviation of diversification from the mean. (Default 20 percent).

  • infilt_stdev

    A number between 0 and 100 for the percent of the infiltration flow_per_exterior_area representing one standard deviation of diversification from the mean. (Default 20 percent).

  • sched_offset

    A positive integer for the number of timesteps at which all schedules of the resulting programs will be shifted - roughly 1/3 of the programs ahead and another 1/3 behind. (Default: 1).

  • timestep

    An integer for the number of timesteps per hour at which the shifting is occurring. This must be a value between 1 and 60, which is evenly divisible by 60. 1 indicates that each step is an hour while 60 indicates that each step is a minute. (Default: 1).

  • seed

    An optional integer to set the seed of the random number generator that is diversifying the loads. Setting a value here will ensure that the same "random" values are assigned every time that this component is run, making comparison of energy simulation results easier. If not set, the loads assigned by this component will be different every time it is run.

Outputs

  • building

    The input Dragonfly Building with its programs diversified. The diversified values can be checked by using the "DF Color Room2D Attributes" component.

[source code]