3.0 create_bar_from_deer_building_type_ratios aa4a7ecf-5bfd-4c5e-b0ca-e68babbacff1 a7331b3c-b881-4181-8e47-f74a9e84e795 20210716T215730Z B31F0C1F CreateBarFromDEERBuildingTypeRatios Create Bar From DEER Building Type Ratios Creates one or more rectangular building elements based on space type ratios of selected mix of building types, along with user arguments that describe the desired geometry characteristics. The building floor area can be described as a footprint size or as a total building area. The shape can be described by its aspect ratio or can be defined as a set width. bldg_type_a Primary Building Type Choice true false OfS Asm Asm DMo DMo ECC ECC EPr EPr ERC ERC ESe ESe EUn EUn GHs GHs Gro Gro Hsp Hsp Htl Htl MBT MBT MFm MFm MLI MLI Mtl Mtl Nrs Nrs OfL OfL OfS OfS RFF RFF RSD RSD Rt3 Rt3 RtL RtL RtS RtS SCn SCn SFm SFm SUn SUn WRf WRf bldg_type_b Building Type B Choice true false OfS Asm Asm DMo DMo ECC ECC EPr EPr ERC ERC ESe ESe EUn EUn GHs GHs Gro Gro Hsp Hsp Htl Htl MBT MBT MFm MFm MLI MLI Mtl Mtl Nrs Nrs OfL OfL OfS OfS RFF RFF RSD RSD Rt3 Rt3 RtL RtL RtS RtS SCn SCn SFm SFm SUn SUn WRf WRf bldg_type_b_fract_bldg_area Building Type B Fraction of Building Floor Area Double true false 0 bldg_type_c Building Type C Choice true false OfS Asm Asm DMo DMo ECC ECC EPr EPr ERC ERC ESe ESe EUn EUn GHs GHs Gro Gro Hsp Hsp Htl Htl MBT MBT MFm MFm MLI MLI Mtl Mtl Nrs Nrs OfL OfL OfS OfS RFF RFF RSD RSD Rt3 Rt3 RtL RtL RtS RtS SCn SCn SFm SFm SUn SUn WRf WRf bldg_type_c_fract_bldg_area Building Type C Fraction of Building Floor Area Double true false 0 bldg_type_d Building Type D Choice true false OfS Asm Asm DMo DMo ECC ECC EPr EPr ERC ERC ESe ESe EUn EUn GHs GHs Gro Gro Hsp Hsp Htl Htl MBT MBT MFm MFm MLI MLI Mtl Mtl Nrs Nrs OfL OfL OfS OfS RFF RFF RSD RSD Rt3 Rt3 RtL RtL RtS RtS SCn SCn SFm SFm SUn SUn WRf WRf bldg_type_d_fract_bldg_area Building Type D Fraction of Building Floor Area Double true false 0 total_bldg_floor_area Total Building Floor Area Double ft^2 true false 10000 single_floor_area Single Floor Area Non-zero value will fix the single floor area, overriding a user entry for Total Building Floor Area Double ft^2 true false 0 floor_height Typical Floor to FLoor Height Selecting a typical floor height of 0 will trigger a smart building type default. Double ft true false 0 custom_height_bar Enable Custom Height Bar Application This is argument value is only relevant when smart default floor to floor height is used for a building type that has spaces with custom heights. Boolean true false true true true false false num_stories_above_grade Number of Stories Above Grade Double true false 1 num_stories_below_grade Number of Stories Below Grade Integer true false 0 building_rotation Building Rotation Set Building Rotation off of North (positive value is clockwise). Rotation applied after geometry generation. Values greater than +/- 45 will result in aspect ratio and party wall orientations that do not match cardinal directions of the inputs. Double Degrees true false 0 template Target Standard Choice true false DEER 2017 DEER Pre-1975 DEER Pre-1975 DEER 1985 DEER 1985 DEER 1996 DEER 1996 DEER 2003 DEER 2003 DEER 2007 DEER 2007 DEER 2011 DEER 2011 DEER 2014 DEER 2014 DEER 2015 DEER 2015 DEER 2017 DEER 2017 DEER 2020 DEER 2020 ns_to_ew_ratio Ratio of North/South Facade Length Relative to East/West Facade Length Selecting an aspect ratio of 0 will trigger a smart building type default. Aspect ratios less than one are not recommended for sliced bar geometry, instead rotate building and use a greater than 1 aspect ratio. Double true false 0 perim_mult Perimeter Multiplier Selecting a value of 0 will trigger a smart building type default. This represents a multiplier for the building perimeter relative to the perimeter of a rectangular building that meets the area and aspect ratio inputs. Other than the smart default of 0.0 this argument should have a value of 1.0 or higher and is only applicable Multiple Space Types - Individual Stories Sliced division method. Double true false 0 bar_width Bar Width Non-zero value will fix the building width, overriding user entry for Perimeter Multiplier. NS/EW Aspect Ratio may be limited based on target width. Double ft true false 0 bar_sep_dist_mult Bar Separation Distance Multiplier Multiplier of separation between bar elements relative to building height. Double true false 10 wwr Window to Wall Ratio Selecting a window to wall ratio of 0 will trigger a smart building type default. Double true false 0 party_wall_fraction Fraction of Exterior Wall Area with Adjacent Structure This will impact how many above grade exterior walls are modeled with adiabatic boundary condition. Double true false 0 party_wall_stories_north Number of North facing stories with party wall This will impact how many above grade exterior north walls are modeled with adiabatic boundary condition. If this is less than the number of above grade stoes, upper flor will reamin exterior Integer true false 0 party_wall_stories_south Number of South facing stories with party wall This will impact how many above grade exterior south walls are modeled with adiabatic boundary condition. If this is less than the number of above grade stoes, upper flor will reamin exterior Integer true false 0 party_wall_stories_east Number of East facing stories with party wall This will impact how many above grade exterior east walls are modeled with adiabatic boundary condition. If this is less than the number of above grade stoes, upper flor will reamin exterior Integer true false 0 party_wall_stories_west Number of West facing stories with party wall This will impact how many above grade exterior west walls are modeled with adiabatic boundary condition. If this is less than the number of above grade stoes, upper flor will reamin exterior Integer true false 0 bottom_story_ground_exposed_floor Is the Bottom Story Exposed to Ground This should be true unless you are modeling a partial building which doesn't include the lowest story. The bottom story floor will have an adiabatic boundary condition when false. Boolean true false true true true false false top_story_exterior_exposed_roof Is the Top Story an Exterior Roof This should be true unless you are modeling a partial building which doesn't include the highest story. The top story ceiling will have an adiabatic boundary condition when false. Boolean true false true true true false false story_multiplier Calculation Method for Story Multiplier Choice true false Basements Ground Mid Top None None Basements Ground Mid Top Basements Ground Mid Top make_mid_story_surfaces_adiabatic Make Mid Story Floor Surfaces Adiabatic If set to true, this will skip surface intersection and make mid story floors and celings adiabatic, not just at multiplied gaps. Boolean true false false true true false false bar_division_method Division Method for Bar Space Types To use perimeter multiplier greater than 1 selected Multiple Space Types - Individual Stories Sliced. Choice true false Multiple Space Types - Individual Stories Sliced Multiple Space Types - Simple Sliced Multiple Space Types - Simple Sliced Multiple Space Types - Individual Stories Sliced Multiple Space Types - Individual Stories Sliced Single Space Type - Core and Perimeter Single Space Type - Core and Perimeter space_type_sort_logic Choose Space Type Sorting Method Choice true false Building Type > Size Size Size Building Type > Size Building Type > Size use_upstream_args Use Upstream Argument Values When true this will look for arguments or registerValues in upstream measures that match arguments from this measure, and will use the value from the upstream measure in place of what is entered for this measure. Boolean true false true true true false false Envelope.Form Intended Software Tool Apply Measure Now string Intended Software Tool OpenStudio Application string Intended Software Tool Parametric Analysis Tool string Intended Software Tool Apply Measure Now string Intended Software Tool OpenStudio Application string Intended Software Tool Parametric Analysis Tool string Measure Type ModelMeasure string Intended Software Tool Apply Measure Now string Intended Software Tool OpenStudio Application string Intended Software Tool Parametric Analysis Tool string example_model.osm osm test 032BCDC9 ar_05.png png doc A86ECE4C ar_1.png png doc F5818F2F ar_2.png png doc 1CAF9C96 bar_double_loaded.png png doc 29AECFF4 bar_single_core_perim.png png doc D1ED9343 bar_sliced_indiv.png png doc B737F7E5 bar_sliced_simple.png png doc EF138637 basement.png png doc 6436A0E2 custom_height_false.png png doc 0684A3AD custom_height_true.png png doc 37DBC088 no_party_mult.png png doc E68AC690 party.png png doc B70845E6 party_multi.png png doc 1CA071B4 perim_mult_2010.png png doc 7704044F perim_mult_2012.png png doc 8809F075 perim_mult_2020.png png doc 0925C42D sep_05.png png doc 86E7AC6E sep_10.png png doc 91062F24 sep_3.png png doc 4DE3ED94 story_sort.png png doc A64E1184 wwr_custom.png png doc D1E7B644 LICENSE.md md license A21A3ED2 create_bar_from_deer_building_type_ratios_test.rb rb test E1730A64 OpenStudio 2.0.0 3.0.0 measure.rb rb script B28CBC41 README.md.erb erb readmeerb 8FAE2C4C README.md md readme CC366365