Skip to content

adding residential geometry enhancement language updates #205

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kflemin wants to merge 2 commits into
base: develop
Choose a base branch
from
Open

adding residential geometry enhancement language updates #205

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
07869ba
adding residential geometry enhancement language updates
kflemin Dec 8, 2023
2a075e4
fix wording
kflemin Jan 24, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions developer_resources/known_issues.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
5 changes: 4 additions & 1 deletion workflows/residential_workflows/residential_workflows.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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 ft<sup>2</sup> or less, and 2-car (24 ft wide) for buildings greater than 2500 ft<sup>2</sup>.
Expand Down
3 changes: 3 additions & 0 deletions workflows/residential_workflows/single_family_attached.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,9 @@ Optional fields:
| heating_system_fuel_type | string | (1) electricity<br>(2) natural gas<br>(3) fuel oil<br>(4) propane<br>(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. |
Comment on lines +76 to +77
Copy link
Contributor

@joseph-robertson joseph-robertson Jan 19, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What about updating multifamily.md?

Copy link
Contributor Author

@kflemin kflemin Jan 24, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rawad ran into some complexities for Multifamily and did not update it yet. @rawadelkontar?

Copy link
Contributor

@joseph-robertson joseph-robertson Feb 13, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What do you mean "did not update it yet"? Aren't orientation and aspect_ratio now available as inputs for any residential building type?



An example "Single-Family Attached" building feature snippet is shown below.

Expand Down
2 changes: 2 additions & 0 deletions workflows/residential_workflows/single_family_detached.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,8 @@ Optional fields:
| onsite_parking_fraction | number | (1) No (0)<br>(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.

Expand Down