3.0 create_bar_from_space_type_ratios 3e988765-9673-46f8-9b65-99d5b86c2b22 29ef75fa-0a73-4a08-85bb-a421d8aebbf2 20220505T182936Z 49BEF039 CreateBarFromSpaceTypeRatios Create Bar From Space 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. Because this measure contains both DOE and DEER inputs, care needs to be taken to choose a template compatable with the selected building types. See readme document for additional guidance. template Target Standard Choice true false 90.1-2004 DOE Ref Pre-1980 DOE Ref Pre-1980 DOE Ref 1980-2004 DOE Ref 1980-2004 90.1-2004 90.1-2004 90.1-2007 90.1-2007 90.1-2010 90.1-2010 90.1-2013 90.1-2013 90.1-2016 90.1-2016 90.1-2019 90.1-2019 ComStock DOE Ref Pre-1980 ComStock DOE Ref Pre-1980 ComStock DOE Ref 1980-2004 ComStock DOE Ref 1980-2004 ComStock 90.1-2004 ComStock 90.1-2004 ComStock 90.1-2007 ComStock 90.1-2007 ComStock 90.1-2010 ComStock 90.1-2010 ComStock 90.1-2013 ComStock 90.1-2013 NREL ZNE Ready 2017 NREL ZNE Ready 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 DEER 2025 DEER 2025 DEER 2030 DEER 2030 DEER 2035 DEER 2035 DEER 2040 DEER 2040 DEER 2045 DEER 2045 DEER 2050 DEER 2050 DEER 2055 DEER 2055 DEER 2060 DEER 2060 DEER 2065 DEER 2065 DEER 2070 DEER 2070 DEER 2075 DEER 2075 space_type_hash_string Space Type Ratios String Hash of Space Types with Building and Space Type name as Key and Fraction as value. All space types should come from the selected OpenStudio Standards template. Example entry is (BuildingType | SpaceType => 0.25) String true false MediumOffice | Conference => 0.2, PrimarySchool | Corridor => 0.125, PrimarySchool | Classroom => 0.175, Warehouse | Office => 0.5 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 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 double_loaded_corridor Double Loaded Corridor Add double loaded corridor for building types that have a defined circulation space type, to the selected space types. Choice true false Primary Space Type None None Primary Space Type Primary Space Type 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 Measure Type ModelMeasure string Measure Function Measure string Requires EnergyPlus Results false boolean Uses SketchUp API false boolean basement.png png doc 6436A0E2 custom_height_false.png png doc 0684A3AD ar_1.png png doc F5818F2F sep_3.png png doc 4DE3ED94 custom_height_true.png png doc 37DBC088 ar_2.png png doc 1CAF9C96 wwr_custom.png png doc D1E7B644 perim_mult_2010.png png doc 7704044F perim_mult_2012.png png doc 8809F075 ar_05.png png doc A86ECE4C party.png png doc B70845E6 bar_sliced_simple.png png doc EF138637 bar_single_core_perim.png png doc D1ED9343 party_multi.png png doc 1CA071B4 sep_05.png png doc 86E7AC6E sep_10.png png doc 91062F24 bar_sliced_indiv.png png doc B737F7E5 no_party_mult.png png doc E68AC690 bar_double_loaded.png png doc 29AECFF4 perim_mult_2020.png png doc 0925C42D story_sort.png png doc A64E1184 LICENSE.md md license A21A3ED2 README.md.erb erb readmeerb 0BC848FD README.md md readme F153B1B9 create_bar_from_space_type_ratios_test.rb rb test 5A8700A0 OpenStudio 2.0.0 2.8.0 measure.rb rb script CA930408