diff --git a/developer_resources/known_issues.md b/developer_resources/known_issues.md index 9f375896..a7c98af2 100644 --- a/developer_resources/known_issues.md +++ b/developer_resources/known_issues.md @@ -49,6 +49,7 @@ nav_order: 3 ```bash resources/hpxml-resources/HPXMLtoOpenStudio/resources/data/climate_zones.csv ``` +1. **libomp.dylib Library not found Error** Apple Silicon computers may encounter an error message similar to `Library not loaded: '/opt/homebrew/opt/libomp/lib/libomp.dylib'`. This appears to be caused by the Apple Silicon chip (M1, M2, M3 etc). If you encounter this error, install the library with `brew install libomp`. You may also need to install Apple Command Line Developer Tools with `xcode-select --install`. ### Version 0.7.0 through 0.9.0 1. Residential stochastic schedules are silently failing in UO v0.7.0-v0.9.0 and the default schedules are instead being used. Use version v0.10.0 and above to resolve this issue. diff --git a/workflows/residential_workflows/residential_workflows.md b/workflows/residential_workflows/residential_workflows.md index 1f721fd9..484de414 100644 --- a/workflows/residential_workflows/residential_workflows.md +++ b/workflows/residential_workflows/residential_workflows.md @@ -126,7 +126,8 @@ Another example is allowing building orientation to be user-defined, or determin ### Geometry #### Aspect Ratio -The aspect ratio of individual units of the building is assumed to be 2. +The aspect ratio of individual units of the building is assumed to be 2. +* As of URBANopt version 0.11.0, aspect ratio can be configured in the geojson file for Single-Family Detached and Single-Family Attached building types. See the example project feature ID 14 for example usage. #### Foundations For buildings with a crawlspace foundation, the height of the foundation is assumed to be 3 ft. @@ -142,6 +143,8 @@ It is assumed that buildings have no neighbors. For Single-Family Detached and Single-Family Attached buildings, 100% of the building units are oriented to the South. For Low-Rise Multifamily buildings, 50% of the building units are oriented to the South while the other 50% are oriented to the North. +* As of URBANopt version 0.11.0, orientation can be configured in the geojson file for Single-Family Detached and Single-Family Attached building types. See the example project feature ID 14 for example usage. + #### Garages For Single-Family Detached buildings with garages, the size of the garage depends on the floor area. The garage is assumed to be a 1-car (12 ft wide) for buildings 2500 ft2 or less, and 2-car (24 ft wide) for buildings greater than 2500 ft2. diff --git a/workflows/residential_workflows/single_family_attached.md b/workflows/residential_workflows/single_family_attached.md index a710c0b3..6917ac70 100644 --- a/workflows/residential_workflows/single_family_attached.md +++ b/workflows/residential_workflows/single_family_attached.md @@ -73,6 +73,9 @@ Optional fields: | heating_system_fuel_type | string | (1) electricity
(2) natural gas
(3) fuel oil
(4) propane
(5) wood | | | template | string | | See [Customizable Template](residential_workflows#customizable-template) | | hpxml_directory | string | | Relative to xml_building. Most required fields are then optional. | +| orientation | number | North=0, East=90, South=180, West=270 | Customizable as of UO v0.11.0 | +| aspect_ratio | number | | Customizable as of UO v0.11.0. The ratio of front/back wall length to left/right wall length for the unit, excluding any protruding garage wall area. | + An example "Single-Family Attached" building feature snippet is shown below. diff --git a/workflows/residential_workflows/single_family_detached.md b/workflows/residential_workflows/single_family_detached.md index a24f148d..91e2391d 100644 --- a/workflows/residential_workflows/single_family_detached.md +++ b/workflows/residential_workflows/single_family_detached.md @@ -67,6 +67,8 @@ Optional fields: | onsite_parking_fraction | number | (1) No (0)
(2) Yes (1) | | | template | string | | See [Customizable Template](residential_workflows#customizable-template) | | hpxml_directory | string | | Relative to xml_building. Most required fields are then optional. | +| orientation | number | North=0, East=90, South=180, West=270 | Customizable as of UO v0.11.0 | +| aspect_ratio | number | | Customizable as of UO v0.11.0. The ratio of front/back wall length to left/right wall length for the unit, excluding any protruding garage wall area. | An example "Single-Family Detached" building feature snippet is shown below.