From 9a98b7bd4f752b8bbe2f5e8edb140a1e145f656e Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Thu, 16 May 2024 15:03:32 -0700 Subject: [PATCH 01/21] Try using changelog ext in rtd. --- .../source/changelog/changelog_1_0_0.rst | 12 +++++ .../source/changelog/changelog_2_0_0.rst | 21 ++++++++ .../source/changelog/changelog_2_1_0.rst | 51 +++++++++++++++++++ .../source/changelog/changelog_2_2_0.rst | 51 +++++++++++++++++++ .../source/changelog/changelog_2_2_1.rst | 51 +++++++++++++++++++ .../source/changelog/changelog_2_2_2.rst | 51 +++++++++++++++++++ .../source/changelog/changelog_2_2_3.rst | 51 +++++++++++++++++++ .../source/changelog/changelog_2_2_4.rst | 51 +++++++++++++++++++ .../source/changelog/changelog_2_2_5.rst | 51 +++++++++++++++++++ .../source/changelog/changelog_2_3_0.rst | 51 +++++++++++++++++++ .../source/changelog/changelog_2_4_0.rst | 51 +++++++++++++++++++ .../source/changelog/changelog_2_5_0.rst | 51 +++++++++++++++++++ .../source/changelog/changelog_3_1_0.rst | 51 +++++++++++++++++++ .../source/changelog/changelog_3_1_1.rst | 51 +++++++++++++++++++ .../source/changelog/changelog_3_2_0.rst | 51 +++++++++++++++++++ .../source/changelog/changelog_dev.rst | 37 ++++++++++++++ docs/read_the_docs/source/changelog/index.rst | 31 +++++++++++ docs/read_the_docs/source/conf.py | 15 ++++++ docs/read_the_docs/source/index.rst | 9 ++++ 19 files changed, 788 insertions(+) create mode 100644 docs/read_the_docs/source/changelog/changelog_1_0_0.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_2_0_0.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_2_1_0.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_2_2_0.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_2_2_1.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_2_2_2.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_2_2_3.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_2_2_4.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_2_2_5.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_2_3_0.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_2_4_0.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_2_5_0.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_3_1_0.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_3_1_1.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_3_2_0.rst create mode 100644 docs/read_the_docs/source/changelog/changelog_dev.rst create mode 100644 docs/read_the_docs/source/changelog/index.rst diff --git a/docs/read_the_docs/source/changelog/changelog_1_0_0.rst b/docs/read_the_docs/source/changelog/changelog_1_0_0.rst new file mode 100644 index 0000000000..491a70c4b5 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_1_0_0.rst @@ -0,0 +1,12 @@ +================ +v1.0.0 Changelog +================ + +.. changelog:: + :version: v1.0.0 + :released: 2019-04-17 + + .. change:: + :tags: general + + The initial release of ResStock. diff --git a/docs/read_the_docs/source/changelog/changelog_2_0_0.rst b/docs/read_the_docs/source/changelog/changelog_2_0_0.rst new file mode 100644 index 0000000000..8c427b2179 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_2_0_0.rst @@ -0,0 +1,21 @@ +================ +v2.0.0 Changelog +================ + +.. changelog:: + :version: v2.0.0 + :released: 2019-04-17 + + .. change:: + :tags: software, openstudio + :pullreq: 151 + + **Date**: 2019-04-11 + + Main Title: Multifamily + + Description: Update to OpenStudio v2.8.0. + + Assignee(s): + + - `joseph-robertson `_ diff --git a/docs/read_the_docs/source/changelog/changelog_2_1_0.rst b/docs/read_the_docs/source/changelog/changelog_2_1_0.rst new file mode 100644 index 0000000000..b2cf699865 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_2_1_0.rst @@ -0,0 +1,51 @@ +================ +v2.1.0 Changelog +================ + +.. changelog:: + :version: v2023.11.0 + :released: 2023-11-27 + + .. change:: + :tags: eagle, bugfix + :pullreq: 406 + :tickets: 404 + + Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + + .. change:: + :tags: documentation + :pullreq: 410 + :tickets: 408 + + Update cost multiplier link in upgrade scenarios documentation. + + .. change:: + :tags: bugfix + :pullreq: 418 + :tickets: 411 + + Fixing ``started_at`` and ``completed_at`` timestamps in parquet files + to that when read by AWS Glue/Athena they show up as dates rather than + bigints. + + .. change:: + :tags: general, feature, kestrel + :pullreq: 405 + :tickets: 313 + + Add support for NREL's Kestrel supercomputer. + + .. change:: + :tags: general, postprocessing + :pullreq: 414 + :tickets: 412 + + Add support for an AWS service account on Kestrel/Eagle so the user + doesn't have to manage AWS keys. + + .. change:: + :tags: documentation + :pullreq: 419 + + Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_0.rst b/docs/read_the_docs/source/changelog/changelog_2_2_0.rst new file mode 100644 index 0000000000..6488f2e109 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_2_2_0.rst @@ -0,0 +1,51 @@ +================ +v2.2.0 Changelog +================ + +.. changelog:: + :version: v2023.11.0 + :released: 2023-11-27 + + .. change:: + :tags: eagle, bugfix + :pullreq: 406 + :tickets: 404 + + Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + + .. change:: + :tags: documentation + :pullreq: 410 + :tickets: 408 + + Update cost multiplier link in upgrade scenarios documentation. + + .. change:: + :tags: bugfix + :pullreq: 418 + :tickets: 411 + + Fixing ``started_at`` and ``completed_at`` timestamps in parquet files + to that when read by AWS Glue/Athena they show up as dates rather than + bigints. + + .. change:: + :tags: general, feature, kestrel + :pullreq: 405 + :tickets: 313 + + Add support for NREL's Kestrel supercomputer. + + .. change:: + :tags: general, postprocessing + :pullreq: 414 + :tickets: 412 + + Add support for an AWS service account on Kestrel/Eagle so the user + doesn't have to manage AWS keys. + + .. change:: + :tags: documentation + :pullreq: 419 + + Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_1.rst b/docs/read_the_docs/source/changelog/changelog_2_2_1.rst new file mode 100644 index 0000000000..3d774d3211 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_2_2_1.rst @@ -0,0 +1,51 @@ +================ +v2.2.1 Changelog +================ + +.. changelog:: + :version: v2023.11.0 + :released: 2023-11-27 + + .. change:: + :tags: eagle, bugfix + :pullreq: 406 + :tickets: 404 + + Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + + .. change:: + :tags: documentation + :pullreq: 410 + :tickets: 408 + + Update cost multiplier link in upgrade scenarios documentation. + + .. change:: + :tags: bugfix + :pullreq: 418 + :tickets: 411 + + Fixing ``started_at`` and ``completed_at`` timestamps in parquet files + to that when read by AWS Glue/Athena they show up as dates rather than + bigints. + + .. change:: + :tags: general, feature, kestrel + :pullreq: 405 + :tickets: 313 + + Add support for NREL's Kestrel supercomputer. + + .. change:: + :tags: general, postprocessing + :pullreq: 414 + :tickets: 412 + + Add support for an AWS service account on Kestrel/Eagle so the user + doesn't have to manage AWS keys. + + .. change:: + :tags: documentation + :pullreq: 419 + + Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_2.rst b/docs/read_the_docs/source/changelog/changelog_2_2_2.rst new file mode 100644 index 0000000000..b5517cf689 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_2_2_2.rst @@ -0,0 +1,51 @@ +================ +v2.2.2 Changelog +================ + +.. changelog:: + :version: v2023.11.0 + :released: 2023-11-27 + + .. change:: + :tags: eagle, bugfix + :pullreq: 406 + :tickets: 404 + + Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + + .. change:: + :tags: documentation + :pullreq: 410 + :tickets: 408 + + Update cost multiplier link in upgrade scenarios documentation. + + .. change:: + :tags: bugfix + :pullreq: 418 + :tickets: 411 + + Fixing ``started_at`` and ``completed_at`` timestamps in parquet files + to that when read by AWS Glue/Athena they show up as dates rather than + bigints. + + .. change:: + :tags: general, feature, kestrel + :pullreq: 405 + :tickets: 313 + + Add support for NREL's Kestrel supercomputer. + + .. change:: + :tags: general, postprocessing + :pullreq: 414 + :tickets: 412 + + Add support for an AWS service account on Kestrel/Eagle so the user + doesn't have to manage AWS keys. + + .. change:: + :tags: documentation + :pullreq: 419 + + Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_3.rst b/docs/read_the_docs/source/changelog/changelog_2_2_3.rst new file mode 100644 index 0000000000..f2609e3d2e --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_2_2_3.rst @@ -0,0 +1,51 @@ +================ +v2.2.3 Changelog +================ + +.. changelog:: + :version: v2023.11.0 + :released: 2023-11-27 + + .. change:: + :tags: eagle, bugfix + :pullreq: 406 + :tickets: 404 + + Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + + .. change:: + :tags: documentation + :pullreq: 410 + :tickets: 408 + + Update cost multiplier link in upgrade scenarios documentation. + + .. change:: + :tags: bugfix + :pullreq: 418 + :tickets: 411 + + Fixing ``started_at`` and ``completed_at`` timestamps in parquet files + to that when read by AWS Glue/Athena they show up as dates rather than + bigints. + + .. change:: + :tags: general, feature, kestrel + :pullreq: 405 + :tickets: 313 + + Add support for NREL's Kestrel supercomputer. + + .. change:: + :tags: general, postprocessing + :pullreq: 414 + :tickets: 412 + + Add support for an AWS service account on Kestrel/Eagle so the user + doesn't have to manage AWS keys. + + .. change:: + :tags: documentation + :pullreq: 419 + + Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_4.rst b/docs/read_the_docs/source/changelog/changelog_2_2_4.rst new file mode 100644 index 0000000000..0bb1d1736a --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_2_2_4.rst @@ -0,0 +1,51 @@ +================ +v2.2.4 Changelog +================ + +.. changelog:: + :version: v2023.11.0 + :released: 2023-11-27 + + .. change:: + :tags: eagle, bugfix + :pullreq: 406 + :tickets: 404 + + Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + + .. change:: + :tags: documentation + :pullreq: 410 + :tickets: 408 + + Update cost multiplier link in upgrade scenarios documentation. + + .. change:: + :tags: bugfix + :pullreq: 418 + :tickets: 411 + + Fixing ``started_at`` and ``completed_at`` timestamps in parquet files + to that when read by AWS Glue/Athena they show up as dates rather than + bigints. + + .. change:: + :tags: general, feature, kestrel + :pullreq: 405 + :tickets: 313 + + Add support for NREL's Kestrel supercomputer. + + .. change:: + :tags: general, postprocessing + :pullreq: 414 + :tickets: 412 + + Add support for an AWS service account on Kestrel/Eagle so the user + doesn't have to manage AWS keys. + + .. change:: + :tags: documentation + :pullreq: 419 + + Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_5.rst b/docs/read_the_docs/source/changelog/changelog_2_2_5.rst new file mode 100644 index 0000000000..d5cb07f932 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_2_2_5.rst @@ -0,0 +1,51 @@ +================ +v2.2.5 Changelog +================ + +.. changelog:: + :version: v2023.11.0 + :released: 2023-11-27 + + .. change:: + :tags: eagle, bugfix + :pullreq: 406 + :tickets: 404 + + Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + + .. change:: + :tags: documentation + :pullreq: 410 + :tickets: 408 + + Update cost multiplier link in upgrade scenarios documentation. + + .. change:: + :tags: bugfix + :pullreq: 418 + :tickets: 411 + + Fixing ``started_at`` and ``completed_at`` timestamps in parquet files + to that when read by AWS Glue/Athena they show up as dates rather than + bigints. + + .. change:: + :tags: general, feature, kestrel + :pullreq: 405 + :tickets: 313 + + Add support for NREL's Kestrel supercomputer. + + .. change:: + :tags: general, postprocessing + :pullreq: 414 + :tickets: 412 + + Add support for an AWS service account on Kestrel/Eagle so the user + doesn't have to manage AWS keys. + + .. change:: + :tags: documentation + :pullreq: 419 + + Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_3_0.rst b/docs/read_the_docs/source/changelog/changelog_2_3_0.rst new file mode 100644 index 0000000000..6931646533 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_2_3_0.rst @@ -0,0 +1,51 @@ +================ +v2.3.0 Changelog +================ + +.. changelog:: + :version: v2023.11.0 + :released: 2023-11-27 + + .. change:: + :tags: eagle, bugfix + :pullreq: 406 + :tickets: 404 + + Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + + .. change:: + :tags: documentation + :pullreq: 410 + :tickets: 408 + + Update cost multiplier link in upgrade scenarios documentation. + + .. change:: + :tags: bugfix + :pullreq: 418 + :tickets: 411 + + Fixing ``started_at`` and ``completed_at`` timestamps in parquet files + to that when read by AWS Glue/Athena they show up as dates rather than + bigints. + + .. change:: + :tags: general, feature, kestrel + :pullreq: 405 + :tickets: 313 + + Add support for NREL's Kestrel supercomputer. + + .. change:: + :tags: general, postprocessing + :pullreq: 414 + :tickets: 412 + + Add support for an AWS service account on Kestrel/Eagle so the user + doesn't have to manage AWS keys. + + .. change:: + :tags: documentation + :pullreq: 419 + + Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_4_0.rst b/docs/read_the_docs/source/changelog/changelog_2_4_0.rst new file mode 100644 index 0000000000..7e203c91b0 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_2_4_0.rst @@ -0,0 +1,51 @@ +================ +v2.4.0 Changelog +================ + +.. changelog:: + :version: v2023.11.0 + :released: 2023-11-27 + + .. change:: + :tags: eagle, bugfix + :pullreq: 406 + :tickets: 404 + + Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + + .. change:: + :tags: documentation + :pullreq: 410 + :tickets: 408 + + Update cost multiplier link in upgrade scenarios documentation. + + .. change:: + :tags: bugfix + :pullreq: 418 + :tickets: 411 + + Fixing ``started_at`` and ``completed_at`` timestamps in parquet files + to that when read by AWS Glue/Athena they show up as dates rather than + bigints. + + .. change:: + :tags: general, feature, kestrel + :pullreq: 405 + :tickets: 313 + + Add support for NREL's Kestrel supercomputer. + + .. change:: + :tags: general, postprocessing + :pullreq: 414 + :tickets: 412 + + Add support for an AWS service account on Kestrel/Eagle so the user + doesn't have to manage AWS keys. + + .. change:: + :tags: documentation + :pullreq: 419 + + Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_5_0.rst b/docs/read_the_docs/source/changelog/changelog_2_5_0.rst new file mode 100644 index 0000000000..89fe39c305 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_2_5_0.rst @@ -0,0 +1,51 @@ +================ +v2.5.0 Changelog +================ + +.. changelog:: + :version: v2023.11.0 + :released: 2023-11-27 + + .. change:: + :tags: eagle, bugfix + :pullreq: 406 + :tickets: 404 + + Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + + .. change:: + :tags: documentation + :pullreq: 410 + :tickets: 408 + + Update cost multiplier link in upgrade scenarios documentation. + + .. change:: + :tags: bugfix + :pullreq: 418 + :tickets: 411 + + Fixing ``started_at`` and ``completed_at`` timestamps in parquet files + to that when read by AWS Glue/Athena they show up as dates rather than + bigints. + + .. change:: + :tags: general, feature, kestrel + :pullreq: 405 + :tickets: 313 + + Add support for NREL's Kestrel supercomputer. + + .. change:: + :tags: general, postprocessing + :pullreq: 414 + :tickets: 412 + + Add support for an AWS service account on Kestrel/Eagle so the user + doesn't have to manage AWS keys. + + .. change:: + :tags: documentation + :pullreq: 419 + + Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_3_1_0.rst b/docs/read_the_docs/source/changelog/changelog_3_1_0.rst new file mode 100644 index 0000000000..b6ca9f06bf --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_3_1_0.rst @@ -0,0 +1,51 @@ +================ +v3.1.0 Changelog +================ + +.. changelog:: + :version: v2023.11.0 + :released: 2023-11-27 + + .. change:: + :tags: eagle, bugfix + :pullreq: 406 + :tickets: 404 + + Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + + .. change:: + :tags: documentation + :pullreq: 410 + :tickets: 408 + + Update cost multiplier link in upgrade scenarios documentation. + + .. change:: + :tags: bugfix + :pullreq: 418 + :tickets: 411 + + Fixing ``started_at`` and ``completed_at`` timestamps in parquet files + to that when read by AWS Glue/Athena they show up as dates rather than + bigints. + + .. change:: + :tags: general, feature, kestrel + :pullreq: 405 + :tickets: 313 + + Add support for NREL's Kestrel supercomputer. + + .. change:: + :tags: general, postprocessing + :pullreq: 414 + :tickets: 412 + + Add support for an AWS service account on Kestrel/Eagle so the user + doesn't have to manage AWS keys. + + .. change:: + :tags: documentation + :pullreq: 419 + + Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_3_1_1.rst b/docs/read_the_docs/source/changelog/changelog_3_1_1.rst new file mode 100644 index 0000000000..8c739a4898 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_3_1_1.rst @@ -0,0 +1,51 @@ +================ +v3.1.1 Changelog +================ + +.. changelog:: + :version: v2023.11.0 + :released: 2023-11-27 + + .. change:: + :tags: eagle, bugfix + :pullreq: 406 + :tickets: 404 + + Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + + .. change:: + :tags: documentation + :pullreq: 410 + :tickets: 408 + + Update cost multiplier link in upgrade scenarios documentation. + + .. change:: + :tags: bugfix + :pullreq: 418 + :tickets: 411 + + Fixing ``started_at`` and ``completed_at`` timestamps in parquet files + to that when read by AWS Glue/Athena they show up as dates rather than + bigints. + + .. change:: + :tags: general, feature, kestrel + :pullreq: 405 + :tickets: 313 + + Add support for NREL's Kestrel supercomputer. + + .. change:: + :tags: general, postprocessing + :pullreq: 414 + :tickets: 412 + + Add support for an AWS service account on Kestrel/Eagle so the user + doesn't have to manage AWS keys. + + .. change:: + :tags: documentation + :pullreq: 419 + + Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_3_2_0.rst b/docs/read_the_docs/source/changelog/changelog_3_2_0.rst new file mode 100644 index 0000000000..c286409cd7 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_3_2_0.rst @@ -0,0 +1,51 @@ +================ +v3.2.0 Changelog +================ + +.. changelog:: + :version: v2023.11.0 + :released: 2023-11-27 + + .. change:: + :tags: eagle, bugfix + :pullreq: 406 + :tickets: 404 + + Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + + .. change:: + :tags: documentation + :pullreq: 410 + :tickets: 408 + + Update cost multiplier link in upgrade scenarios documentation. + + .. change:: + :tags: bugfix + :pullreq: 418 + :tickets: 411 + + Fixing ``started_at`` and ``completed_at`` timestamps in parquet files + to that when read by AWS Glue/Athena they show up as dates rather than + bigints. + + .. change:: + :tags: general, feature, kestrel + :pullreq: 405 + :tickets: 313 + + Add support for NREL's Kestrel supercomputer. + + .. change:: + :tags: general, postprocessing + :pullreq: 414 + :tickets: 412 + + Add support for an AWS service account on Kestrel/Eagle so the user + doesn't have to manage AWS keys. + + .. change:: + :tags: documentation + :pullreq: 419 + + Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_dev.rst b/docs/read_the_docs/source/changelog/changelog_dev.rst new file mode 100644 index 0000000000..bd619d14a8 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_dev.rst @@ -0,0 +1,37 @@ +===================== +Development Changelog +===================== + +.. changelog:: + :version: development + :released: It has not been + + .. change:: + :tags: general, feature + :pullreq: 101 + :tickets: 101 + + This is an example change. Please copy and paste it - for valid tags please refer to ``conf.py`` in the docs + directory. ``pullreq`` should be set to the appropriate pull request number and ``tickets`` to any related + github issues. These will be automatically linked in the documentation. + + .. change:: + :tags: general + :pullreq: 421 + + Refactor docker_base to use inversion of control so that it can more strongly and easily ensure consistency + between various implementations (GCP implementation to come). This also includes teasing apart the several batch + prep steps (weather, assets, and jobs) into their own methods so they can each be more easily understood, + shared, and maintained. + + .. change:: + :tags: general + :pullreq: 422 + + Refactor AWS code so it can be shared by the upcoming GCP implementation. + + .. change:: + :tags: general, bugfix + :pullreq: 426 + + A bugfix for gracefully handling empty data_point_out.json files. diff --git a/docs/read_the_docs/source/changelog/index.rst b/docs/read_the_docs/source/changelog/index.rst new file mode 100644 index 0000000000..390ac1c2d0 --- /dev/null +++ b/docs/read_the_docs/source/changelog/index.rst @@ -0,0 +1,31 @@ +.. _changelogs: + +Changelogs +========== + +.. toctree:: + :titlesonly: + + changelog_3_2_0 + changelog_3_1_1 + changelog_3_1_0 + changelog_2_5_0 + changelog_2_4_0 + changelog_2_3_0 + changelog_2_2_5 + changelog_2_2_4 + changelog_2_2_3 + changelog_2_2_2 + changelog_2_2_1 + changelog_2_2_0 + changelog_2_1_0 + changelog_2_0_0 + changelog_1_0_0 + +Development +=========== + +.. toctree:: + :titlesonly: + + changelog_dev diff --git a/docs/read_the_docs/source/conf.py b/docs/read_the_docs/source/conf.py index ea4e779da1..27d1cc123c 100644 --- a/docs/read_the_docs/source/conf.py +++ b/docs/read_the_docs/source/conf.py @@ -39,8 +39,23 @@ # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ + "changelog" ] +changelog_sections = [ + "workflow", + "characteristics", + "software", + "documentation" +] +# tags to sort on inside of sections +changelog_inner_tag_sort = ["feature", "changed", "removed", "bug", "moved"] + +# how to render changelog links +changelog_render_ticket = "http://www.github.com/nrel/resstock/issues/%s" + +changelog_render_pullreq = {"default": "https://www.github.com/nrel/resstock/pull/%s"} + # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] diff --git a/docs/read_the_docs/source/index.rst b/docs/read_the_docs/source/index.rst index a806c6018d..6cbeac69cb 100644 --- a/docs/read_the_docs/source/index.rst +++ b/docs/read_the_docs/source/index.rst @@ -24,3 +24,12 @@ ResStock Documentation advanced_tutorial/index workflow_inputs/index workflow_outputs/index + +Updates & Changelog +=================== + +.. toctree:: + :maxdepth: 2 + :caption: Changes + + changelog/index From c5a6ef4c02a8bf27c541be75c8a9b4b642298f71 Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Thu, 16 May 2024 19:13:23 -0700 Subject: [PATCH 02/21] Try changelog install before making docs. --- .github/workflows/config.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/config.yml b/.github/workflows/config.yml index 16a8dc593a..1203bb7497 100644 --- a/.github/workflows/config.yml +++ b/.github/workflows/config.yml @@ -363,6 +363,7 @@ jobs: ruby docs/read_the_docs/source/workflow_inputs/create_characteristics_rst.rb ruby docs/read_the_docs/source/workflow_outputs/csv_tables.rb cd docs/read_the_docs + pip install changelog make html SPHINXOPTS="-W --keep-going -n" - name: Save Docs From 0d8d32b91818c49491ed621be064a9f62165f0bc Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Thu, 16 May 2024 21:27:33 -0700 Subject: [PATCH 03/21] Start populating rst from excel file. --- .../source/changelog/changelog_3_1_0.rst | 47 +- .../source/changelog/changelog_3_1_1.rst | 49 +- .../source/changelog/changelog_3_2_0.rst | 498 +++++++++++++++++- .../source/changelog/changelog_dev.rst | 445 +++++++++++++++- 4 files changed, 911 insertions(+), 128 deletions(-) diff --git a/docs/read_the_docs/source/changelog/changelog_3_1_0.rst b/docs/read_the_docs/source/changelog/changelog_3_1_0.rst index b6ca9f06bf..8d866f3277 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_1_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_1_0.rst @@ -3,49 +3,6 @@ v3.1.0 Changelog ================ .. changelog:: - :version: v2023.11.0 - :released: 2023-11-27 + :version: v3.1.0 + :released: 2023-05-25 - .. change:: - :tags: eagle, bugfix - :pullreq: 406 - :tickets: 404 - - Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. - - .. change:: - :tags: documentation - :pullreq: 410 - :tickets: 408 - - Update cost multiplier link in upgrade scenarios documentation. - - .. change:: - :tags: bugfix - :pullreq: 418 - :tickets: 411 - - Fixing ``started_at`` and ``completed_at`` timestamps in parquet files - to that when read by AWS Glue/Athena they show up as dates rather than - bigints. - - .. change:: - :tags: general, feature, kestrel - :pullreq: 405 - :tickets: 313 - - Add support for NREL's Kestrel supercomputer. - - .. change:: - :tags: general, postprocessing - :pullreq: 414 - :tickets: 412 - - Add support for an AWS service account on Kestrel/Eagle so the user - doesn't have to manage AWS keys. - - .. change:: - :tags: documentation - :pullreq: 419 - - Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_3_1_1.rst b/docs/read_the_docs/source/changelog/changelog_3_1_1.rst index 8c739a4898..657a4e5740 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_1_1.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_1_1.rst @@ -3,49 +3,24 @@ v3.1.1 Changelog ================ .. changelog:: - :version: v2023.11.0 - :released: 2023-11-27 + :version: v3.1.1 + :released: 2023-11-28 .. change:: - :tags: eagle, bugfix - :pullreq: 406 - :tickets: 404 + :tags: workflow, mechanics + :pullreq: 1170 - Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + **Date**: 2023-11-28 - .. change:: - :tags: documentation - :pullreq: 410 - :tickets: 408 - - Update cost multiplier link in upgrade scenarios documentation. + Title: + Use gem version on bsb version strings - .. change:: - :tags: bugfix - :pullreq: 418 - :tickets: 411 + Description: + Use `Gem::Version` on buildstockbatch version string comparisons so that, e.g., '2023.10.0' < '2023.5.0' does not evaluate to true + Patched release with version comparison fix - Fixing ``started_at`` and ``completed_at`` timestamps in parquet files - to that when read by AWS Glue/Athena they show up as dates rather than - bigints. - - .. change:: - :tags: general, feature, kestrel - :pullreq: 405 - :tickets: 313 + Assignee(s): - Add support for NREL's Kestrel supercomputer. + - Joe - .. change:: - :tags: general, postprocessing - :pullreq: 414 - :tickets: 412 - - Add support for an AWS service account on Kestrel/Eagle so the user - doesn't have to manage AWS keys. - - .. change:: - :tags: documentation - :pullreq: 419 - Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_3_2_0.rst b/docs/read_the_docs/source/changelog/changelog_3_2_0.rst index c286409cd7..d2dec5ee65 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_2_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_2_0.rst @@ -3,49 +3,491 @@ v3.2.0 Changelog ================ .. changelog:: - :version: v2023.11.0 - :released: 2023-11-27 + :version: v3.2.0 + :released: 2023-12-19 .. change:: - :tags: eagle, bugfix - :pullreq: 406 - :tickets: 404 + :tags: workflow, weather + :pullreq: 1182 + + **Date**: 2023-12-18 + + Title: + Update weather files from NREL Data Catalog + + Description: + Update TMY3 weather URL from the NREL Data Catalog + The current link in the project YAMLs for the TMY weather files in NREL Data Catalog is out of date and missing the following Counties. This PR updates the link to the latest file on the NREL Data Catalog. + + Assignee(s): + + - Tony - Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. .. change:: - :tags: documentation - :pullreq: 410 - :tickets: 408 + :tags: workflow, gshp + :pullreq: 1187 + + **Date**: 2023-12-10 + + Title: + Geothermal loop & soil properties + + Description: + Updates and enhancements to the ground source heat pump model; ability to describe detailed geothermal loop inputs + Allow inputs to describe a ground-source heat pump field (e.g., vertical vs horizontal, bore/trench length, etc.). + + Assignee(s): + + - Prateek + + - Jeff + + - Tony + + - Joe + + + .. change:: + :tags: characteristics, ground conductivity + :pullreq: 1165 + + **Date**: 2023-12-04 + + Title: + Add variability in ground thermal conductivity + + Description: + Add variability in ground thermal conductivity + Allow ground conductivity to vary by climate zone. The GeoVision task force report provided data by climate zone. The same data is used to fill out distributions by climate zone. + + Assignee(s): + + - Tony + + + .. change:: + :tags: documentation, resstockarguments + :pullreq: 1146 + + **Date**: 2023-11-27 + + Title: + RTD: summarize lookup arguments + + Description: + Automate creation of new "Arguments" documentation sections for summarizing arguments (and their default values) in options_lookup.tsv + By housing characteristic parameter, automates summarizing Arguments sets used in options_lookup.tsv (including Name, Required, Units, Type, Choices, Description). See below for example. + + Assignee(s): + + - Joe - Update cost multiplier link in upgrade scenarios documentation. .. change:: - :tags: bugfix - :pullreq: 418 - :tickets: 411 + :tags: characteristics, data sources + :pullreq: 1164 + + **Date**: 2023-11-10 + + Title: + Update to RECS 2020 V5 data files + + Description: + Update to RECS 2020 V5 data files + Use RECS 2020 V5 microdata file to create the characteristics. There is very little impact as the update to RECS 2020 V5 is mainly adding columns with end-use energy and expenditures. There are some very small changes to some TSVs, but these changes result in no changes to the options_saturation file. + + Assignee(s): + + - Tony - Fixing ``started_at`` and ``completed_at`` timestamps in parquet files - to that when read by AWS Glue/Athena they show up as dates rather than - bigints. .. change:: - :tags: general, feature, kestrel - :pullreq: 405 - :tickets: 313 + :tags: software, openstudio + :pullreq: 1144 + + **Date**: 2023-10-26 + + Title: + Latest OS-HPXML, OS v3.7.0 + + Description: + Update to OpenStudio v3.7.0 + OpenStudio 3.7.0/EnergyPlus 23.2.0 + + Assignee(s): + + - Joe + + - Scott - Add support for NREL's Kestrel supercomputer. .. change:: - :tags: general, postprocessing - :pullreq: 414 - :tickets: 412 + :tags: workflow, utility bills + :pullreq: 1109 + + **Date**: 2023-10-24 + + Title: + Calculate detailed utility bills + + Description: + Add ability to calculate detailed utility bills based on a user-specified TSV file of paths to JSON utility rate tariff files + Add optional detailed_filepath yml argument for pointing to user-specified TSV file of electricity tariff file paths. The TSV file can contain electricity tariff file paths mapped by State, or any other parameter. + + Assignee(s): + + - Joe - Add support for an AWS service account on Kestrel/Eagle so the user - doesn't have to manage AWS keys. .. change:: - :tags: documentation - :pullreq: 419 + :tags: workflow, resilience + :pullreq: 1113 + + **Date**: 2023-10-23 + + Title: + Add resilience arguments to yml files + + Description: + Add ability to request timeseries resilience output from the yml file + Include the new include_timeseries_resilience argument in example yml files. + + Assignee(s): + + - Joe + + + .. change:: + :tags: characteristics, water heater + :pullreq: 1125 + + **Date**: 2023-09-25 + + Title: + Add water heater location + + Description: + Add Water Heater Location and Geometry Space Combination, update Geometry Garage and Geometry Floor Area Bin to RECS2020, update RECS2020 microdata from v2 to v4, auto-generate buildstocks for yml_precomputed tests + Added Water Heater Location.tsv + + Assignee(s): + + - Lixi + + + .. change:: + :tags: workflow, mechanics + :pullreq: 1138 + + **Date**: 2023-09-20 + + Title: + run_analysis.rb: handle illegal upgrade names, provide run folder map + + Description: + Update `run_analysis.rb` to handle illegal path characters in upgrade names + run_analysis.rb creates directories based on upgrade names, but these upgrade names may have illegal path characters in them (e.g., "/" if the upgrade name is "Higher efficiency ducted ASHP w/ elec backup "), resulting in an obscure error. It should more gracefully handle this situation and be able to run upgrades with these characters in the name. + + Assignee(s): + + - Joe + + + .. change:: + :tags: workflow, mechanics + :pullreq: 1138 + + **Date**: 2023-09-20 + + Title: + run_analysis.rb: handle illegal upgrade names, provide run folder map + + Description: + Update `run_analysis.rb` to map datapoints to run folder names when the `-k` argument is supplied + Also, adds writing run folder names (e.g., "run1", "run2", etc.) to the "job_id" column when supplying the -k argument to run_analysis.rb (i.e., a map from datapoint to run folder). + + Assignee(s): + + - Joe + + + .. change:: + :tags: characteristics, setpoints + :pullreq: 1136 + + **Date**: 2023-09-11 + + Title: + Update TSVs after bugfix + + Description: + Minor changes to heating and cooling setpoint TSV after a bug fix + Fix an elusive bug that causes a slight changes on the Heating Setpoint and Cooling Setpoint TSV on each run. This bug was a result of previous PR of refactoring prune_rules. + + Assignee(s): + + - Rajendra + + + .. change:: + :tags: characteristics, setpoints + :pullreq: 1132 + + **Date**: 2023-09-06 + + Title: + TSV changes from prune_rules refactor and adding options_saturations.csv + + Description: + Minor changes to heating and cooling setpoint TSV due to refactoring of prune_rules handling in resstock-estimation + Attempt at fixing ongoing issue with unexpected behavior of prune rules in #385 by refactoring and simplifying prune rule handling. + + Assignee(s): + + - Rajendra + + + .. change:: + :tags: characteristics, general + :pullreq: 1132 + + **Date**: 2023-09-06 + + Title: + TSV changes from prune_rules refactor and adding options_saturations.csv + + Description: + options_saturations.csv is added to project_*/resources/ folder + Also add options_saturations.csv to resources. + + Assignee(s): + + - Rajendra + + + .. change:: + :tags: characteristics, refrigerator + :pullreq: 1118 + + **Date**: 2023-08-23 + + Title: + change refrigerator rated annual kwh + + Description: + Correct refrigerator rated annual kWh based on EF and an assumed volume of 20.9cft. + Change the rated annual consumption of refrigerator and misc extra refrigerator in options_lookup.tsv + + Assignee(s): + + - Lixi + + + .. change:: + :tags: workflow, heat pumps + :pullreq: 1074 + + **Date**: 2023-08-18 + + Title: + Heating system -> heat pump backup + + Description: + For heat pump upgrades, adds the ability to set the existing primary (non-shared) heating system as the backup system using only a single option from the lookup + Uses ResStockArguments to add a new boolean argument heat_pump_backup_use_existing_system. + + Assignee(s): + + - Joe + + + .. change:: + :tags: characteristics, ducts + :pullreq: 1104, 1112 + + **Date**: 2023-08-09 + + Title: + add Duct Location and Duct Leakage to Outside + + Description: + Fix/clarify duct location assignment by defining Duct Location.tsv, making Duct Leakage and Insulation (formerly Duct) depend on Duct Location, and making HVAC Has Ducts depend on HVAC Has Shared Systems. Includes fixes on standalone and shared heating system assignment for Other Fuel. + Added Duct Location.tsv + Replaced Duct.tsv with Duct Leakage and Insulation.tsv + Added "HVAC Has Shared System" as dependency to HVAC Has Ducts.tsv + Fixed HVAC Shared Efficiencies.tsv + Fixed HVAC Heating Efficiency.tsv + + Assignee(s): + + - Lixi + + - Joe + + + .. change:: + :tags: characteristics, floor area + :pullreq: 1115 + + **Date**: 2023-08-07 + + Title: + Typo for square feet area of multi-family + + Description: + Fix square footage for a MF dwelling unit in the "3000-3999" CFA bin (from 33171 to 3171) + This shows square footage for an MF housing bin of 3000-3999 to be 33171. I assume this is incorrect and a typo, but should be a quick fix + + Assignee(s): + + - Joe + + + .. change:: + :tags: workflow, secondary heating + :pullreq: 1093 + + **Date**: 2023-07-17 + + Title: + HVAC Secondary Heating, try 2 + + Description: + Include HVAC secondary heating capabilities for project_testing + Support options sampled from HVAC Secondary Heating xxx. + + Assignee(s): + + - Joe + + + .. change:: + :tags: workflow, secondary heating + :pullreq: 1093 + + **Date**: 2023-07-17 + + Title: + HVAC Secondary Heating, try 2 + + Description: + Update ResStockArguments to support nonzero fraction of heat load served by the secondary heating system + Update the ResStockArguments measure to adjust the primary system's fraction of heat load served such that the sum of fractions does not exceed 1.0 + + Assignee(s): + + - Joe + + + .. change:: + :tags: characteristics, other fuel + :pullreq: 947 + + **Date**: 2023-07-11 + + Title: + Model wood fuel when sampling "Other Fuel" for WH and "Other" for HVAC + + Description: + Model a wood storage water heater when "Other Fuel" is sampled from Water Heater Efficiency.tsv (allowing downstream modeling of clothes washer/dryer). Similarly, model a wood wall/floor furnace when "Other" is sampled from HVAC Heating Efficiency.tsv + Water Heater Efficiency|Other Fuel to model a wood storage water heater instead of no water heater. + HVAC Heating Efficiency|Other to model a wood wall/floor furnace instead of no heating system. + + Assignee(s): + + - Joe + + + .. change:: + :tags: workflow, formatting + :pullreq: 962 + + **Date**: 2023-06-26 + + Title: + Clean up options_lookup.tsv in github actions + + Description: + Set standard format for options_lookup + In an effort to clean up resources/options_lookup.tsv, this sets a standard for what the file should look like. + + Assignee(s): + + - Rajendra + + - Tony + + + .. change:: + :tags: workflow, utility bills + :pullreq: 1012 + + **Date**: 2023-06-12 + + Title: + Simple bill calcs (enhancement) + + Description: + Add ability to calculate simple utility bills based on a user-specified TSV file of utility rates + Add optional simple_filepath yml argument for pointing to user-specified TSV file of utility rates. The TSV file can contain utility rates mapped by State, or any other parameter. + + Assignee(s): + + - Joe + + + .. change:: + :tags: characteristics, data sources + :pullreq: 1031 + + **Date**: 2023-06-08 + + Title: + Update to RECS 2020 data + + Description: + Update characteristics to use EIA 2020 RECS + Transitioning characteristics to use the EIA's 2020 RECS survey final characteristics. + + Assignee(s): + + - Tony + + + .. change:: + :tags: workflow, emissions + :pullreq: 1038 + + **Date**: 2023-06-07 + + Title: + Update to 2022 Cambium release + + Description: + Add 2022 Cambium emissions data + Cambium 2022 data is out. This issue is to update to the 2022 data. + + Assignee(s): + + - Joe + + + .. change:: + :tags: characteristics, climate zones + :pullreq: 1080 + + **Date**: 2023-06-06 + + Title: + Ll/energystar climate zones + + Description: + Add Energystar Climate Zone for window upgrade specification + Add Energystar Climate Zone for window upgrade specification + + Assignee(s): + + - Lixi + - Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_dev.rst b/docs/read_the_docs/source/changelog/changelog_dev.rst index bd619d14a8..baf8265446 100644 --- a/docs/read_the_docs/source/changelog/changelog_dev.rst +++ b/docs/read_the_docs/source/changelog/changelog_dev.rst @@ -7,31 +7,440 @@ Development Changelog :released: It has not been .. change:: - :tags: general, feature - :pullreq: 101 - :tickets: 101 + :tags: software, openstudio + :pullreq: 1225 + + **Date**: 2024-05-09 + + Title: + OpenStudio 3.8/EnergyPlus 24.1 + + Description: + Update to OpenStudio v3.8.0 + OpenStudio 3.8/EnergyPlus 24.1 + + Assignee(s): + + - Joe + + - Scott + + + .. change:: + :tags: characteristics, ducts + :pullreq: 1233 + + **Date**: 2024-05-07 + + Title: + Updates duct effective R-values; allows duct shape inputs + + Description: + Update to new OS-HPXML defaults for duct insulation; 25% rectangular supply ducts and 100% rectangular return ducts (previously 100% round supply/return ducts) + Adds optional inputs (Ducts/DuctShape and Ducts/DuctFractionRectangular); defaults to 25% rectangular supply ducts and 100% rectangular return ducts (previously 100% round supply/return ducts). + + Assignee(s): + + - Scott + + + .. change:: + :tags: workflow, hvac + :pullreq: 1233 + + **Date**: 2024-05-07 + + Title: + HVAC Autosizing Limits + + Description: + nan + The PR aims to allow specifying upper limits for autosized capacities. + + Assignee(s): + + - Joe + + + .. change:: + :tags: workflow, hvac + :pullreq: 1218 + + **Date**: 2024-04-09 + + Title: + HVAC Autosizing Factors + + Description: + Enable HVAC airflow and capacity scaling factors to oversize or undersize the equipment + Manually create new tsv files for assigning autosizing factor arguments introduced by NREL/OpenStudio-HPXML#1611 + + Assignee(s): + + - Joe + + + .. change:: + :tags: characteristics, plug loads, ceiling fan + :pullreq: 1220 + + **Date**: 2024-04-02 + + Title: + Update Other, TV, and Ceiling Fan stochastic schedules + + Description: + Update the stochastic schedule generator to produce updated other/TV plug load and ceiling fan schedules + generate TV schedules that follow the ATUS TV schedule fractions (distinct weekday/weekend) and multipliers (and not Other schedule fractions and multipliers). + generate Other schedules that follow the new Other schedule fractions (still uses non-constant 2010 BAHSP monthly multipliers). + generate Ceiling Fan schedules that follow the new Ceiling Fan schedule fractions (also update multipliers to not follow Other multipliers, but rather Ceiling Fan multipliers that are a function of weather) + + Assignee(s): + + - Joe + + + .. change:: + :tags: characteristics, alaska + :pullreq: 1214 + + **Date**: 2024-03-18 + + Title: + Integrate ARIS data + + Description: + Update the Alaska residential stock characterization using the Alaska Retrofit Information System data + Update housing characteristics for Alaska using ARIS dataset. Explicitly model wood heating for the national. + + Assignee(s): + + - Rajendra + + - Tony + + + .. change:: + :tags: workflow, hvac + :pullreq: 1215 + + **Date**: 2024-03-11 + + Title: + HVAC Autosizing Factors + + Description: + Add ability to specify HVAC system autosizing factors for baseline buildings; autosizing factors are retained for upgrade buildings following the same approach for HVAC system capacities + Allows optional HeatingAutosizingFactor, CoolingAutosizingFactor, BackupHeatingAutosizingFactor inputs to scale HVAC equipment autosizing results. + + Assignee(s): + + - Joe + + - Yueyue + + + .. change:: + :tags: workflow, weather + :pullreq: 1215 + + **Date**: 2024-03-11 + + Title: + Allow building site inputs + + Description: + nan + Allow building site inputs; this is particularly useful when the building is located far from, or at a very different elevation than, the EPW weather station. When not provided, defaults to using EPW header values (as before). + + Assignee(s): + + - Scott + + + .. change:: + :tags: characteristics, socio-demographics + :pullreq: 1212 + + **Date**: 2024-02-29 + + Title: + Add SMI, MSA, Metro Status + + Description: + Add Metropolitan and Micropolitan Statistical Area tsv, County Metro Status tsv, and State Metro Median Income tsv + Added 3 new tsvs to support @SinounPhoung's socio-demographically differentiated Stochastic Occupant Schedule integration into ResStock + + Assignee(s): + + - Lixi + + + .. change:: + :tags: characteristics, water heater + :pullreq: 1201 + + **Date**: 2024-02-28 + + Title: + Update water heater location + + Description: + Move location of out-of-unit (shared) water heaters to conditioned mechanical room + Move out-of-unit water heaters (i.e., Water Heater In Unit=No from Location=None to Location=Conditioned Mechanical Room (corresponds to OS-HPXML location: "other heated space"). + + Assignee(s): + + - Lixi + + - Jeff + + - Tony + + + .. change:: + :tags: workflow, unavailable periods + :pullreq: 1209 + + **Date**: 2024-02-23 + + Title: + BuildResidentialHPXML: multiple vacancy/outage periods + + Description: + Allow definition of multiple unavailable periods (i.e., vacancy, power outage) + Update schedules_vacancy_period and schedules_power_outage_period arguments to support multiple periods (comma-separated?). Argument schedules_power_outage_window_natvent_availability would then need to also be comma-separated? + + Assignee(s): + + - Joe + + + .. change:: + :tags: workflow, heat pump backup + :pullreq: 1209 + + **Date**: 2024-02-23 + + Title: + HP backup sizing methodology + + Description: + Add ability to set either an "emergency" or "supplemental" heat pump backup sizing methodology + Adds a HeatPumpBackupSizingMethodology element with choices of 'emergency' and 'supplemental'. Defaults to 'emergency', so results do not change by default. + + Assignee(s): + + - Scott + + + .. change:: + :tags: characteristics, refrigerator + :pullreq: 1209 + + **Date**: 2024-02-23 + + Title: + ANSI 301-2022: load profile schedules + + Description: + Refrigerator energy use is now affected by its ambient temperature using hourly constant and temperature coefficients from ANSI/RESNET/ICC 301-2022 Addendum C + Default fridge schedule is now an actuated EMS program. Daily schedule is a function of hour and space temperature. + + Assignee(s): + + - Joe + + + .. change:: + :tags: workflow, general water use + :pullreq: 1209 + + **Date**: 2024-02-23 + + Title: + ANSI 301-2022: load profile schedules + + Description: + nan + Various schedule fractions/multipliers updates (e.g., appliances, lighting, fixtures, occupancy, ceiling fan). + + Assignee(s): + + - Joe - This is an example change. Please copy and paste it - for valid tags please refer to ``conf.py`` in the docs - directory. ``pullreq`` should be set to the appropriate pull request number and ``tickets`` to any related - github issues. These will be automatically linked in the documentation. .. change:: - :tags: general - :pullreq: 421 + :tags: workflow, ceiling fan + :pullreq: 1209 + + **Date**: 2024-02-23 + + Title: + ANSI 301-2022: load profile schedules + + Description: + nan + For ceiling fans, add a LabelEnergyUse (W) input as an alternative to Efficiency (cfm/W). + + Assignee(s): + + - Joe - Refactor docker_base to use inversion of control so that it can more strongly and easily ensure consistency - between various implementations (GCP implementation to come). This also includes teasing apart the several batch - prep steps (weather, assets, and jobs) into their own methods so they can each be more easily understood, - shared, and maintained. .. change:: - :tags: general - :pullreq: 422 + :tags: characteristics, hot water fixtures + :pullreq: 1210 + + **Date**: 2024-02-21 + + Title: + Updating hot water fixtures multipliers based on field data. + + Description: + Update hot water usage multipliers based on field data rather than engineering judgement + Update hot water usage multipliers. Using field data from 1700 water heaters in New England to come up with the distribution. Based on data collected as part of PERFORM with Michael Blonsky, who shared the distribution with us. + + Assignee(s): + + - Jeff + + - Tony - Refactor AWS code so it can be shared by the upcoming GCP implementation. .. change:: - :tags: general, bugfix - :pullreq: 426 + :tags: workflow, whole building + :pullreq: 1200 + + **Date**: 2024-01-30 + + Title: + Whole MF building models: Replace building_id=ALL argument with an HPXML element + + Description: + Add optional switch to BuildExistingModel (defaulted to false) for modeling whole SFA/MF buildings + Replaces building_id=ALL argument with an element in the HPXML file, which allows us to perform validation specific to whole MF building simulations + + Assignee(s): + + - Joe + + - Scott + + + .. change:: + :tags: characteristics, data sources + :pullreq: 1199 + + **Date**: 2024-01-26 + + Title: + Update characteristics using 2020 RECS v7 data + + Description: + Update to RECS 2020 V7 data files + Updates RECS 2020 data from v5 to v7. There are some new EV variables to be leveraged by the ResStock/TEMPO project. I am not sure what V6 was as there is no documentation. + + Assignee(s): + + - Tony + + + .. change:: + :tags: workflow, mechanics + :pullreq: 1195 + + **Date**: 2024-01-22 + + Title: + Reorganize emissions and utility bills data folders + + Description: + Reorganize the emissions and utility rates data folders such that their sources and functions are more clear + Previously, it wasn't clear that the provided utility rate data was for demonstration purposes only. + + Assignee(s): + + - Joe + + + .. change:: + :tags: workflow, emissions + :pullreq: 1194 + + **Date**: 2024-01-19 + + Title: + 2022 Cambium: add 25 year levelization scenarios + + Description: + Include additional 2022 Cambium 25-year LRMER emissions data + Add 10 new "LRMER_xxx_25" data folders to resources/data/cambium/2022. + + Assignee(s): + + - Joe + + + .. change:: + :tags: workflow, radiant barrier + :pullreq: 1188 + + **Date**: 2024-01-17 + + Title: + Adding flexibility to specify location of the radiant barrier + + Description: + Add flexibility to specify location of the radiant barrier + Allowing Radiant Barrier for Attic Floor + + Assignee(s): + + - Prateek + + + .. change:: + :tags: workflow, hvac + :pullreq: 1188, 1200 + + **Date**: 2024-01-17 + + Title: + Allow autosizing with detailed performance data inputs for var speed systems + BuildResidentialHPXML: detailed performance data arguments + + Description: + Add ability to describe detailed performance data for variable-speed air-source HVAC systems + Updated assumptions for variable-speed air conditioners, heat pumps, and mini-splits. + Also allows detailed heating and cooling performance data (min/max COPs and capacities at different outdoor temperatures) as an optional set of inputs. + Data can be sourced from e.g. NEEP's Cold Climate Air Source Heat Pump List. + Add detailed performance data arguments for air-source, variable-speed HVAC systems. + + Assignee(s): + + - Yueyue + + - Scott + + - Joe + + + .. change:: + :tags: workflow, water heater + :pullreq: 1190 + + **Date**: 2024-01-12 + + Title: + Remove old HPWH options from options_lookup + + Description: + Remove old HPWH options from options_lookup + Removing the old HPWH options from options_lookup.tsv + + Assignee(s): + + - Jeff + - A bugfix for gracefully handling empty data_point_out.json files. From c9e135d09805124b5d1ea75333d6cf7f45c4b89b Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Thu, 16 May 2024 21:31:49 -0700 Subject: [PATCH 04/21] Update the pull request template. --- .github/pull_request_template.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 47b5ccd3f6..b1db45441c 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -9,6 +9,6 @@ Not all may apply: - [ ] Tests (and test files) have been updated - [ ] Documentation has been updated - [ ] If related to resstock-estimation, checklist includes [data dictionary](https://github.com/NREL/resstock/tree/develop/resources/data/dictionary), [source report](https://github.com/NREL/resstock/tree/develop/project_national/resources/source_report.csv), [options saturation](https://github.com/NREL/resstock/tree/develop/project_national/resources/options_saturations.csv), [options_lookup](https://github.com/NREL/resstock/blob/develop/resources/options_lookup.tsv). -- [ ] Changelog has been updated +- [ ] Add to the changelog_dev.rst file - [ ] `openstudio tasks.rb update_measures` has been run - [ ] No unexpected regression test changes on CI (checked comparison artifacts) From 0ff1fbcda4119fdef3d955fc5abe04d9869eb4cd Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Fri, 17 May 2024 12:57:55 -0700 Subject: [PATCH 05/21] Add all stubbed changelog rst files. --- .../source/changelog/changelog_1_0_0.rst | 4 - .../source/changelog/changelog_2_0_0.rst | 193 +++- .../source/changelog/changelog_2_1_0.rst | 589 +++++++++++- .../source/changelog/changelog_2_2_0.rst | 301 +++++- .../source/changelog/changelog_2_2_1.rst | 81 +- .../source/changelog/changelog_2_2_2.rst | 47 +- .../source/changelog/changelog_2_2_3.rst | 49 +- .../source/changelog/changelog_2_2_4.rst | 49 +- .../source/changelog/changelog_2_2_5.rst | 49 +- .../source/changelog/changelog_2_3_0.rst | 457 ++++++++- .../source/changelog/changelog_2_4_0.rst | 509 +++++++++- .../source/changelog/changelog_2_5_0.rst | 877 +++++++++++++++++- .../source/changelog/changelog_3_0_0.rst | 456 +++++++++ .../source/changelog/changelog_3_1_0.rst | 189 ++++ .../source/changelog/changelog_3_1_1.rst | 6 +- .../source/changelog/changelog_3_2_0.rst | 172 ++-- .../source/changelog/changelog_dev.rst | 162 ++-- 17 files changed, 3655 insertions(+), 535 deletions(-) create mode 100644 docs/read_the_docs/source/changelog/changelog_3_0_0.rst diff --git a/docs/read_the_docs/source/changelog/changelog_1_0_0.rst b/docs/read_the_docs/source/changelog/changelog_1_0_0.rst index 491a70c4b5..38225e510f 100644 --- a/docs/read_the_docs/source/changelog/changelog_1_0_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_1_0_0.rst @@ -6,7 +6,3 @@ v1.0.0 Changelog :version: v1.0.0 :released: 2019-04-17 - .. change:: - :tags: general - - The initial release of ResStock. diff --git a/docs/read_the_docs/source/changelog/changelog_2_0_0.rst b/docs/read_the_docs/source/changelog/changelog_2_0_0.rst index 8c427b2179..3ab93c8afa 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_0_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_0_0.rst @@ -7,15 +7,194 @@ v2.0.0 Changelog :released: 2019-04-17 .. change:: - :tags: software, openstudio + :tags: software, openstudio, feature :pullreq: 151 - **Date**: 2019-04-11 + **Date**: 2019-04-17 - Main Title: Multifamily + Title: + TODO + + Description: + Update to OpenStudio v2.8.0 + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 151 + + **Date**: 2019-04-17 + + Title: + TODO + + Description: + Add a multifamily project which includes housing characteristic distributions for single-family detached, single-family attached, and multifamily buildings + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 151 + + **Date**: 2019-04-17 + + Title: + TODO + + Description: + Ability to add central systems (boiler with baseboards, fan coil, PTAC) to multifamily buildings using the openstudio-standards gem + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 206 + + **Date**: 2019-04-17 + + Title: + TODO + + Description: + Ability to simulate large multifamily buildings using "collapsed" buildings with multipliers on building units + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 211 + + **Date**: 2019-04-17 + + Title: + TODO + + Description: + Automatically generate dependency graphs and a dependency wheel for each project + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 151 + + **Date**: 2019-04-17 + + Title: + TODO + + Description: + Add measures for calculating construction properties, modeling power outages and calculating resilience metrics, and calculating utility bills + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 151 + + **Date**: 2019-04-17 + + Title: + TODO + + Description: + Add measure for modeling shared multiifamily facades using adiabatic constructions + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 151 + + **Date**: 2019-04-17 + + Title: + TODO + + Description: + Relocate all measure unit tests, test osw files, and test osm files from archived OpenStudio-BEopt and into this repository + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 151 + + **Date**: 2019-04-17 + + Title: + TODO + + Description: + Create example workflow osw files for single-family detached, single-family attached, and multifamily buildings using TMY weather + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 151 + + **Date**: 2019-04-17 + + Title: + TODO + + Description: + Reporting measures read from ReportMeterData table to get disaggregated fan and pump energy + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 151 + + **Date**: 2019-04-17 + + Title: + TODO + + Description: + Break out central system heating, cooling, and pump energy in reporting measures + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 216 + + **Date**: 2019-04-17 + + Title: + TODO + + Description: + Use custom unit conversions script instead of that provided by OpenStudio SDK + TODO + + Assignees: TODO - Description: Update to OpenStudio v2.8.0. - Assignee(s): - - - `joseph-robertson `_ diff --git a/docs/read_the_docs/source/changelog/changelog_2_1_0.rst b/docs/read_the_docs/source/changelog/changelog_2_1_0.rst index b2cf699865..8cd5307453 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_1_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_1_0.rst @@ -3,49 +3,582 @@ v2.1.0 Changelog ================ .. changelog:: - :version: v2023.11.0 - :released: 2023-11-27 + :version: v2.1.0 + :released: 2019-11-05 .. change:: - :tags: eagle, bugfix - :pullreq: 406 - :tickets: 404 + :tags: software, openstudio, feature + :pullreq: 322 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Update to OpenStudio v2.9.0 + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 228, 237, 239 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Unit tests and performance improvements for integrity checks + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 245 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Register climate zones (BA and IECC) based on the simulation EPW file + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 244, 252 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Split ResidentialLighting into separate ResidentialLightingInterior and ResidentialLightingOther (with optional exterior holiday lighting) measures + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 259, 261 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Additional example workflow osw files using TMY/AMY2012/AMY2014 weather for use in regression testing + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 272 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Update all projects with new heating/cooling setpoint, offset, and magnitude distributions + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 276 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Add new ResidentialDemandResponse measure that allows for 8760 DR schedules to be applied to heating/cooling schedules + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 264, 278, 292 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Additional options for HVAC, dehumidifier, clothes washer, misc loads, infiltration, etc. + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 282 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Add EV options and update ResidentialMiscLargeUncommonLoads measure with new electric vehicle argument + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 287 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Update ResidentialSimulationControls measure to include a calendar year argument for controlling the simulation start day of week + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 273, 293 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Increase number of possible upgrade options from 10 to 25 + TODO + + Assignees: TODO - Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. .. change:: - :tags: documentation - :pullreq: 410 - :tickets: 408 + :tags: todo, todo, feature + :pullreq: 296 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Additional "max-tech" options for slab, wall, refrigerator, dishwasher, clothes washer, and lighting + TODO + + Assignees: TODO - Update cost multiplier link in upgrade scenarios documentation. .. change:: - :tags: bugfix - :pullreq: 418 - :tickets: 411 + :tags: todo, todo, feature + :pullreq: 302 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Add references to ResStock trademark in both the license and readme files + TODO + + Assignees: TODO - Fixing ``started_at`` and ``completed_at`` timestamps in parquet files - to that when read by AWS Glue/Athena they show up as dates rather than - bigints. .. change:: - :tags: general, feature, kestrel - :pullreq: 405 - :tickets: 313 + :tags: todo, todo, feature + :pullreq: 304 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Report all cost multipliers in the SimulationOutputReport measure + TODO + + Assignees: TODO - Add support for NREL's Kestrel supercomputer. .. change:: - :tags: general, postprocessing - :pullreq: 414 - :tickets: 412 + :tags: todo, todo, feature + :pullreq: 305 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Add options for low flow fixtures + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 310 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Add argument to BuildExistingModel measure that allows the user to ignore measures + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 291, 314 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Create example project yaml files for use with buildstockbatch + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 317 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Create a pull request template to facilitate development + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 321 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Update documentation to clarify downselect logic parameters + TODO + + Assignees: TODO - Add support for an AWS service account on Kestrel/Eagle so the user - doesn't have to manage AWS keys. .. change:: - :tags: documentation - :pullreq: 419 + :tags: todo, todo, feature + :pullreq: 329, 333 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Additional options for EnergyStar clothes washer, clothes dryer, dishwasher + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 255 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Bugfix for assuming that all simulations are exactly 365 days + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 258 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Bugfix for heating coil defrost strategy + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 263 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Various HVAC-related fixes for buildings with central systems + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 280 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Update testing project to sweep through more options + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 270, 274, 285 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Updates, edits, and clarification to the documentation + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 286 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Skip any reporting measure output requests for datapoints that have been registered as invalid + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 295 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Bugfix for when bedrooms are specified for each unit but bathrooms are not + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 307 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Ensure that autosizing does not draw the whole tank volume in one minute for solar hot water storage tank + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 308 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Remove invalid characters from option names for consistency with buildstockbatch + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 309 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Bugfix for ducts occasionally getting placed in the garage attic instead of only unfinished attic + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 312 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Able to get past runner values of any type, and not just as string + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 315 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Log the error message along with the backtrace when an applied measure fails + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 320 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Add tests to ensure that the Run Measure argument is correctly defined in all Apply Upgrade measures for all projects + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 330 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Bugfix when specifying numbers of bedrooms to building units + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 331 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Enforce rubocop as CI test so code with offenses cannot be merged + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 329, 333 + + **Date**: 2019-11-05 + + Title: + TODO + + Description: + Bugfix for some clothes washer, dishwasher options causing increased energy consumption + TODO + + Assignees: TODO + - Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_0.rst b/docs/read_the_docs/source/changelog/changelog_2_2_0.rst index 6488f2e109..d48a45e8bf 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_0.rst @@ -3,49 +3,294 @@ v2.2.0 Changelog ================ .. changelog:: - :version: v2023.11.0 - :released: 2023-11-27 + :version: v2.2.0 + :released: 2020-01-30 .. change:: - :tags: eagle, bugfix - :pullreq: 406 - :tickets: 404 + :tags: todo, todo, feature + :pullreq: 371 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + The results csv now optionally reports annual totals for all end use subcategories, including appliances, plug loads, etc. + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 362 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Split out national average options so not all homes have all miscellaneous equipment, and add none options to appliances + TODO + + Assignees: TODO - Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. .. change:: - :tags: documentation - :pullreq: 410 - :tickets: 408 + :tags: todo, todo, feature + :pullreq: 357 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Update the single-family detached project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls + TODO + + Assignees: TODO - Update cost multiplier link in upgrade scenarios documentation. .. change:: - :tags: bugfix - :pullreq: 418 - :tickets: 411 + :tags: todo, todo, feature + :pullreq: 353 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Made housing characteristics a consistent format. Added integrity check to ensure housing characteristics follow the guildelines specified in read-the-docs + TODO + + Assignees: TODO - Fixing ``started_at`` and ``completed_at`` timestamps in parquet files - to that when read by AWS Glue/Athena they show up as dates rather than - bigints. .. change:: - :tags: general, feature, kestrel - :pullreq: 405 - :tickets: 313 + :tags: todo, todo, feature + :pullreq: 346 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Include additional "daylight saving time" and "utc time" columns to timeseries csv file to account for one hour forward and backward time shifts + TODO + + Assignees: TODO - Add support for NREL's Kestrel supercomputer. .. change:: - :tags: general, postprocessing - :pullreq: 414 - :tickets: 412 + :tags: todo, todo, feature + :pullreq: 340 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Update bedrooms and occupants tsv files with options and probability distributions based on RECS 2015 data + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 334 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Add new QOIReport measure for reporting seasonal quantities of interest for uncertainty quantification + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 338 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Separate tsv files for bedrooms, cooking range schedule, corridor, holiday lighting, interior/other lighting use, pool schedule, plug loads schedule, and refrigeration schedule + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 372 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Allow Wood Stove option as an upgrade, and account for wood heating energy in simulation output + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 371 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Custom meters for ceiling fan, hot water recirc pump, and vehicle end use subcategories were not properly implemented + TODO + + Assignees: TODO - Add support for an AWS service account on Kestrel/Eagle so the user - doesn't have to manage AWS keys. .. change:: - :tags: documentation - :pullreq: 419 + :tags: todo, todo, bugfix + :pullreq: 356 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Some re-labeling of tsv files, such as "Geometry Building Type" to "Geometry Building Type RECS" and "Geometry Building Type FPL" to "Geometry Building Type ACS" + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 360 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Removes option "Auto" from parameter "Occupants" in the options lookup file + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 350 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Update the multifamily project's neighbors and orientation tsv files to have geometry building type dependency; remove the now obsolete "Geometry Is Multifamily Low Rise.tsv" file + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 346 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Update each PAT project's AMI selection to "2.9.0" + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 349 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Fixes for custom output meters: total site electricity double-counting exterior holiday lighting, and garage lighting all zeroes + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 301 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Remove shared facades tsv files from the multifamily_beta and testing projects + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 334 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Move redundant output meter code from individual reporting measures out into shared resource file + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 238 + + **Date**: 2020-01-30 + + Title: + TODO + + Description: + Fix for the power outages measure where the last hour of the day was not getting the new schedule applied + TODO + + Assignees: TODO + - Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_1.rst b/docs/read_the_docs/source/changelog/changelog_2_2_1.rst index 3d774d3211..c22da24df4 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_1.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_1.rst @@ -3,49 +3,70 @@ v2.2.1 Changelog ================ .. changelog:: - :version: v2023.11.0 - :released: 2023-11-27 + :version: v2.2.1 + :released: 2020-02-07 .. change:: - :tags: eagle, bugfix - :pullreq: 406 - :tickets: 404 + :tags: todo, todo, feature + :pullreq: 382 - Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + **Date**: 2020-02-07 - .. change:: - :tags: documentation - :pullreq: 410 - :tickets: 408 + Title: + TODO - Update cost multiplier link in upgrade scenarios documentation. + Description: + Update the multifamily project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls + TODO - .. change:: - :tags: bugfix - :pullreq: 418 - :tickets: 411 + Assignees: TODO - Fixing ``started_at`` and ``completed_at`` timestamps in parquet files - to that when read by AWS Glue/Athena they show up as dates rather than - bigints. .. change:: - :tags: general, feature, kestrel - :pullreq: 405 - :tickets: 313 + :tags: todo, todo, bugfix + :pullreq: 387 + + **Date**: 2020-02-07 + + Title: + TODO + + Description: + Add generation of the Geometry Wall Type tsv file for the single-family detached project to the 2009 RECS tsv maker; this corrects the tsv file + TODO + + Assignees: TODO - Add support for NREL's Kestrel supercomputer. .. change:: - :tags: general, postprocessing - :pullreq: 414 - :tickets: 412 + :tags: todo, todo, bugfix + :pullreq: 387 + + **Date**: 2020-02-07 + + Title: + TODO + + Description: + Add generation of the Misc Pool tsv file (with Geometry Building Type and Location Region dependencies) to the 2009 RECS tsv maker; this also corrects having pool pumps for all homes + TODO + + Assignees: TODO - Add support for an AWS service account on Kestrel/Eagle so the user - doesn't have to manage AWS keys. .. change:: - :tags: documentation - :pullreq: 419 + :tags: todo, todo, bugfix + :pullreq: 382 + + **Date**: 2020-02-07 + + Title: + TODO + + Description: + Refactor the RECS tsv makers for years 2009 and 2015 + TODO + + Assignees: TODO + - Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_2.rst b/docs/read_the_docs/source/changelog/changelog_2_2_2.rst index b5517cf689..35efa3b2ed 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_2.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_2.rst @@ -3,49 +3,22 @@ v2.2.2 Changelog ================ .. changelog:: - :version: v2023.11.0 - :released: 2023-11-27 + :version: v2.2.2 + :released: 2020-02-19 .. change:: - :tags: eagle, bugfix + :tags: todo, todo, bugfix :pullreq: 406 - :tickets: 404 - Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + **Date**: 2020-02-19 - .. change:: - :tags: documentation - :pullreq: 410 - :tickets: 408 - - Update cost multiplier link in upgrade scenarios documentation. - - .. change:: - :tags: bugfix - :pullreq: 418 - :tickets: 411 - - Fixing ``started_at`` and ``completed_at`` timestamps in parquet files - to that when read by AWS Glue/Athena they show up as dates rather than - bigints. + Title: + TODO - .. change:: - :tags: general, feature, kestrel - :pullreq: 405 - :tickets: 313 - - Add support for NREL's Kestrel supercomputer. + Description: + Update the datapoint initialization script to download weather files to a common zip filename + TODO - .. change:: - :tags: general, postprocessing - :pullreq: 414 - :tickets: 412 + Assignees: TODO - Add support for an AWS service account on Kestrel/Eagle so the user - doesn't have to manage AWS keys. - - .. change:: - :tags: documentation - :pullreq: 419 - Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_3.rst b/docs/read_the_docs/source/changelog/changelog_2_2_3.rst index f2609e3d2e..933b56d482 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_3.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_3.rst @@ -3,49 +3,22 @@ v2.2.3 Changelog ================ .. changelog:: - :version: v2023.11.0 - :released: 2023-11-27 + :version: v2.2.3 + :released: 2020-03-09 .. change:: - :tags: eagle, bugfix - :pullreq: 406 - :tickets: 404 + :tags: todo, todo, bugfix + :pullreq: 422 - Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + **Date**: 2020-03-09 - .. change:: - :tags: documentation - :pullreq: 410 - :tickets: 408 - - Update cost multiplier link in upgrade scenarios documentation. - - .. change:: - :tags: bugfix - :pullreq: 418 - :tickets: 411 - - Fixing ``started_at`` and ``completed_at`` timestamps in parquet files - to that when read by AWS Glue/Athena they show up as dates rather than - bigints. + Title: + TODO - .. change:: - :tags: general, feature, kestrel - :pullreq: 405 - :tickets: 313 - - Add support for NREL's Kestrel supercomputer. + Description: + Update the weather zip file url in each PAT project to point to data.nrel.gov + TODO - .. change:: - :tags: general, postprocessing - :pullreq: 414 - :tickets: 412 + Assignees: TODO - Add support for an AWS service account on Kestrel/Eagle so the user - doesn't have to manage AWS keys. - - .. change:: - :tags: documentation - :pullreq: 419 - Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_4.rst b/docs/read_the_docs/source/changelog/changelog_2_2_4.rst index 0bb1d1736a..56f450471d 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_4.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_4.rst @@ -3,49 +3,22 @@ v2.2.4 Changelog ================ .. changelog:: - :version: v2023.11.0 - :released: 2023-11-27 + :version: v2.2.4 + :released: 2020-04-28 .. change:: - :tags: eagle, bugfix - :pullreq: 406 - :tickets: 404 + :tags: todo, todo, bugfix + :pullreq: 442 - Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + **Date**: 2020-04-28 - .. change:: - :tags: documentation - :pullreq: 410 - :tickets: 408 - - Update cost multiplier link in upgrade scenarios documentation. - - .. change:: - :tags: bugfix - :pullreq: 418 - :tickets: 411 - - Fixing ``started_at`` and ``completed_at`` timestamps in parquet files - to that when read by AWS Glue/Athena they show up as dates rather than - bigints. + Title: + TODO - .. change:: - :tags: general, feature, kestrel - :pullreq: 405 - :tickets: 313 - - Add support for NREL's Kestrel supercomputer. + Description: + Fix bug in options lookup where buildings without heating systems were not being assigned the required "has_hvac_flue" airflow measure argument + TODO - .. change:: - :tags: general, postprocessing - :pullreq: 414 - :tickets: 412 + Assignees: TODO - Add support for an AWS service account on Kestrel/Eagle so the user - doesn't have to manage AWS keys. - - .. change:: - :tags: documentation - :pullreq: 419 - Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_5.rst b/docs/read_the_docs/source/changelog/changelog_2_2_5.rst index d5cb07f932..3439581dc9 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_5.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_5.rst @@ -3,49 +3,22 @@ v2.2.5 Changelog ================ .. changelog:: - :version: v2023.11.0 - :released: 2023-11-27 + :version: v2.2.5 + :released: 2020-09-24 .. change:: - :tags: eagle, bugfix - :pullreq: 406 - :tickets: 404 + :tags: todo, todo, bugfix + :pullreq: 489 - Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. + **Date**: 2020-09-24 - .. change:: - :tags: documentation - :pullreq: 410 - :tickets: 408 - - Update cost multiplier link in upgrade scenarios documentation. - - .. change:: - :tags: bugfix - :pullreq: 418 - :tickets: 411 - - Fixing ``started_at`` and ``completed_at`` timestamps in parquet files - to that when read by AWS Glue/Athena they show up as dates rather than - bigints. + Title: + TODO - .. change:: - :tags: general, feature, kestrel - :pullreq: 405 - :tickets: 313 - - Add support for NREL's Kestrel supercomputer. + Description: + Update the weather zip file url in each PAT project to point to a different location at data.nrel.gov + TODO - .. change:: - :tags: general, postprocessing - :pullreq: 414 - :tickets: 412 + Assignees: TODO - Add support for an AWS service account on Kestrel/Eagle so the user - doesn't have to manage AWS keys. - - .. change:: - :tags: documentation - :pullreq: 419 - Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_3_0.rst b/docs/read_the_docs/source/changelog/changelog_2_3_0.rst index 6931646533..ace2e76af5 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_3_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_3_0.rst @@ -3,49 +3,454 @@ v2.3.0 Changelog ================ .. changelog:: - :version: v2023.11.0 - :released: 2023-11-27 + :version: v2.3.0 + :released: 2020-06-24 .. change:: - :tags: eagle, bugfix - :pullreq: 406 - :tickets: 404 + :tags: todo, todo, feature + :pullreq: 402 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Remove the single-family detached project, and remove PAT from the testing and multifamily projects + TODO + + Assignees: TODO - Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. .. change:: - :tags: documentation - :pullreq: 410 - :tickets: 408 + :tags: todo, todo, feature + :pullreq: 401 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Relocate the data folder, along with tsv makers, to a separate private repository + TODO + + Assignees: TODO - Update cost multiplier link in upgrade scenarios documentation. .. change:: - :tags: bugfix - :pullreq: 418 - :tickets: 411 + :tags: todo, todo, feature + :pullreq: 392 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Update the single-family detached and multifamily projects with more up-to-date lighting stock distributions + TODO + + Assignees: TODO - Fixing ``started_at`` and ``completed_at`` timestamps in parquet files - to that when read by AWS Glue/Athena they show up as dates rather than - bigints. .. change:: - :tags: general, feature, kestrel - :pullreq: 405 - :tickets: 313 + :tags: todo, todo, feature + :pullreq: 395 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Update Insulation Finished Attic tsv with more options for insulation levels + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 408 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Add ability to ignore comment lines with the "#" symbol + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 324 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Update occupant and plug loads equations based on RECS 2015 data; replace floor area with occupants as independent variable in plug loads equation; allow modeling of zero-bedroom units (e.g., studios) + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 416 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + New geospatial characteristics have been added or updated. New geospatial characteristics are as follows: ASHRAE IECC Climate Zone 2004, State, County, PUMA, Census Division, Census Region, Building America Climate Zone, and ISO/RTO Region. The top level housing characteristic is now ASHRAE IECC Climate Zone 2004. Now using data from the American Community Survey Public Use Microdata Sample (ACS PUMS) for Building Type, Vintage, and Heating Fuel + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 418 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Update HVAC System Cooling tsv with air-conditioning saturations ("None", "Room AC", or "Central AC") from American Housing Survey for Custom Region 04. Efficiency probabilities remain based on RECS 2009 + TODO + + Assignees: TODO - Add support for NREL's Kestrel supercomputer. .. change:: - :tags: general, postprocessing + :tags: todo, todo, feature :pullreq: 414 - :tickets: 412 - Add support for an AWS service account on Kestrel/Eagle so the user - doesn't have to manage AWS keys. + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Diversify the timing heating and cooling setpoint setbacks + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 420 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Reduce the number of appliances in multifamily units. Adding RECS building type as a dependencies to clothes washers, clothes dryers, dishwashers, refrigerators, extra refrigerators, and stand-alone freezers. Update refrigeration levels based on RECS 2009 age and shipment-weighted efficiency by year. Now using the American Housing Survey (AHS) for clothes washer and clothes dryer saturations. New geographic field, AHS Region, which uses the top 15 largest Core Based Statistical Areas (CBSAs) and Non-CBSA Census Divisions + TODO + + Assignees: TODO + .. change:: - :tags: documentation + :tags: todo, todo, feature :pullreq: 419 - Update weather file location argument name in custom weather files documentation. + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Exterior lighting schedule changed from using interior lighting sunrise/sunset algorithm to T24 2016 Residential ACM Appendix C Table 8 Exterior Lighting Hourly Multiplier for weekdays and weekends + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 425 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Increase the diversity of the floor areas that are simulated. Geometry House Size has been replaced by Geometry Floor Area Bin and Geometry Floor Area. Now using AHS for specifying the floor area. Floor areas differ by non-Core Based Statistical Areas (CBSAs) Census Divisions and the top 15 largest CBSAs + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 427 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Increase the diversity of the infiltration simulated. Now using the Residential Diagnostics Database for the Infiltration housing characteristic + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 438 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Allow a key value to be specified when outputting timeseries variables + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 459 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Rename "project_multifamily_beta" to "project_national" + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 454 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Add mini-split heat pump pan heater to custom meter for heating electricity + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 453 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Assign daylight saving start/end dates based on county and not epw region + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 445 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Update ceiling fan tsv to remove the "National Average" option, and instead sample 28% "None" and 72% "Standard Efficiency" + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 432 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Remove Location Weather Filename and Location Weather Year tsvs, and update options lookup to reflect updated weather file changes; weather filenames are now required to match what is in the options lookup + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 433 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Fix bug in QOI reporting measure where absence of any heating/cooling/overlap seasons would cause errors + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 426 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Restructure unfinished attic and finished roof -related tsv files (i.e., insulation, roof material, and radiant barrier) and options + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 405 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Exclude net site energy consumption from annual and timeseries simulation output ("total" now reflects net of pv); change `include_enduse_subcategories` argument default to "true"; report either total interior equipment OR each of its components + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 392 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Refactor the tsv maker classes to accommodate more data sources + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 375 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Allow a building to be simulated with no water heater; map the "Other Fuel" option from the Water Heater tsv to no water heater + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 355 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Revert plug load schedule to RBSA for the National Average option + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 416 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Removed the "Geometry Unit Stories SF" and "Geometry Unit Stories MF" housing characteristics. Unit stories are instead represented by the "Geometry Stories" housing characteristic + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 412 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Diversify window to wall ratio variation using the Residential Building Stock Assessment (RBSA) II data + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 452 + + **Date**: 2020-06-24 + + Title: + TODO + + Description: + Fix bug in assigning small window areas to surfaces + TODO + + Assignees: TODO + + diff --git a/docs/read_the_docs/source/changelog/changelog_2_4_0.rst b/docs/read_the_docs/source/changelog/changelog_2_4_0.rst index 7e203c91b0..2c05ede5d4 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_4_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_4_0.rst @@ -3,49 +3,502 @@ v2.4.0 Changelog ================ .. changelog:: - :version: v2023.11.0 - :released: 2023-11-27 + :version: v2.4.0 + :released: 2021-01-27 .. change:: - :tags: eagle, bugfix - :pullreq: 406 - :tickets: 404 + :tags: todo, todo, feature + :pullreq: 458 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Report the annual peak use and timing using the quantities of interest measure + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 348 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Major change to most occupant-related schedules. Occupant activities are now generated on-the-fly and saved to .csv files used by Schedule:File objects. Schedules are generated using time-inhomogenous Markov chains derived from American Time Use Survey data, supplemented with sampling duration and power level from NEEA RBSA data, as well as DHW draw duration and flow rate data from Aquacraft/AWWA data [(see pre-print for details)](https://arxiv.org/abs/2111.01881) + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 468 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Update the dependencies for heating and cooling setpoint tsvs (Setpoint, Has Offset, Offset Magnitude, and Offset Period) to IECC climate zone + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 473 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Distinguish between vacant and occupied dwelling units using PUMS data + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 474 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Update heating fuel distributions to be by Public Use Microdata Area (PUMA) rather than State + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 478 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Restructure HVAC housing characteristics to 1) simplify the structure, 2) allow for integrating more local data sources, 3) update reference years for HVAC and refrigerator ages and efficiencies from 2009 to 2018, 4) add assumption comments to all HVAC-related housing characteristics, 5) improve Room AC efficiency distributions using ENERGY STAR saturation data, and 6) fix some incorrect assignment of Option=None heating systems + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 485 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Increase roofing material options; update roofing material tsv files to include these new options + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 492 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Update foundation type from the [Building Foundation Design Handbook](https://www.osti.gov/biblio/6980439-building-foundation-design-handbook) published in 1988 to RECS 2009 + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 507 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Synchronize weather between ResStock and ComStock which increases the number of weather stations from 215 to 941 + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 509 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Update Occupants per unit from RECS 2015 to PUMS 5-yr 2017 + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 471 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Based on RECS 2015, separate the plug load equations for single-family detached, single-family attached, and multifamily buildings + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 511 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Allow for plug load energy consumption to vary by Census Division and include additional "diversity" multiplier in plug load equations + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 510 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Lighting saturations based on RECS 2015 with new building type and spatial dependencies + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 513 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Introduce premium water heaters and heat pump water heaters into building stock, differentiate between central and in-unit water heating, and split water heater fuel and efficiency into different housing characteristics + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 512 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Separate heat pump electric supplemental heating from total electric heating in output reporting + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 532 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Update the duct leakage "total" to "to outside" conversion to be based on ASHRAE Standard 152 + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 525 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Allow for flexible weather regions based on weather data available and introduce TMY3 weather files for the new weather format + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 477 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Fix for pseudo-random number generator that was generating non-deterministic occupancy schedules + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 480 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Iterate all spaces in a thermal zone when checking for zone type; fixes missing infiltration for protruding garages in 1-story homes + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 486 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Update spatial distribution of units based on total dwelling unit counts rather than occupied unit counts + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 496 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Exclude existing shared walls when calculating the partition wall area of MF and SFA buildings + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 501 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + For the purpose of calculating cooling and dehumidification loads for HVAC sizing, use simple internal gains equation from ANSI/RESNET/ICC 301 (consistent with HPXML workflow); this fixes a bug introduced in [#348](https://github.com/NREL/resstock/pull/348) that caused cooling capacities to be ~3x larger than they should be + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 497 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Reintroduce IECC climate zone dependency to HVAC Cooling Type and some heat pump fixes + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 504 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Reintroduce monthly multipliers with stochastic load model for dishwasher, clothes washer and clothes dryer and cooking + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 518 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Account for collapsed units when determining geometry variables (building floor/wall area and volume) in infiltration calculations; add airflow unit tests + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 523 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Fix for calculating door and below-grade wall area of multifamily and single-family attached buildings with collapsed geometries + TODO + + Assignees: TODO - Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. .. change:: - :tags: documentation - :pullreq: 410 - :tickets: 408 + :tags: todo, todo, bugfix + :pullreq: 522 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + In the Corridor.tsv, assign single-family attached, single-family detached, and mobile homes with a "Not Applicable" option + TODO + + Assignees: TODO - Update cost multiplier link in upgrade scenarios documentation. .. change:: - :tags: bugfix - :pullreq: 418 - :tickets: 411 + :tags: todo, todo, bugfix + :pullreq: 527 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Remove ceiling fan energy for vacant units + TODO + + Assignees: TODO - Fixing ``started_at`` and ``completed_at`` timestamps in parquet files - to that when read by AWS Glue/Athena they show up as dates rather than - bigints. .. change:: - :tags: general, feature, kestrel - :pullreq: 405 - :tickets: 313 + :tags: todo, todo, bugfix + :pullreq: 528 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Fix bug related to incorrect timestamps when using AMY weather file + TODO + + Assignees: TODO - Add support for NREL's Kestrel supercomputer. .. change:: - :tags: general, postprocessing - :pullreq: 414 - :tickets: 412 + :tags: todo, todo, bugfix + :pullreq: 530 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Fix DST start hour error and end date error + TODO + + Assignees: TODO - Add support for an AWS service account on Kestrel/Eagle so the user - doesn't have to manage AWS keys. .. change:: - :tags: documentation - :pullreq: 419 + :tags: todo, todo, bugfix + :pullreq: 537 + + **Date**: 2021-01-27 + + Title: + TODO + + Description: + Calculate slab surface effective R values used in HVAC sizing with unit-level variables + TODO + + Assignees: TODO + - Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_2_5_0.rst b/docs/read_the_docs/source/changelog/changelog_2_5_0.rst index 89fe39c305..39f49c831f 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_5_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_5_0.rst @@ -3,49 +3,870 @@ v2.5.0 Changelog ================ .. changelog:: - :version: v2023.11.0 - :released: 2023-11-27 + :version: v2.5.0 + :released: 2022-02-09 .. change:: - :tags: eagle, bugfix - :pullreq: 406 - :tickets: 404 + :tags: software, openstudio, feature + :pullreq: 604 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Update to OpenStudio v3.3.0 + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 439 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Model multifamily and single-family attached buildings as individual dwelling units instead of multiple units representing a building + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 541 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Reduce vacant unit heating setpoints to 55ºF + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 548 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Introduce a CEC Building Climate Zone tag for samples in California + TODO + + Assignees: TODO - Cleans out the ``/tmp/scratch`` folder on Eagle at the end of each array job. .. change:: - :tags: documentation - :pullreq: 410 - :tickets: 408 + :tags: todo, todo, feature + :pullreq: 545 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Increase LED saturation to approximately 2019 levels + TODO + + Assignees: TODO - Update cost multiplier link in upgrade scenarios documentation. .. change:: - :tags: bugfix - :pullreq: 418 - :tickets: 411 + :tags: todo, todo, feature + :pullreq: 483 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Introduce GEB capabilities for water heaters, including the ability to schedule setpoint and HPWH operating mode + TODO + + Assignees: TODO - Fixing ``started_at`` and ``completed_at`` timestamps in parquet files - to that when read by AWS Glue/Athena they show up as dates rather than - bigints. .. change:: - :tags: general, feature, kestrel - :pullreq: 405 - :tickets: 313 + :tags: todo, todo, feature + :pullreq: 551 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Introduce different cooling setpoint distributions for window ACs + TODO + + Assignees: TODO - Add support for NREL's Kestrel supercomputer. .. change:: - :tags: general, postprocessing - :pullreq: 414 - :tickets: 412 + :tags: todo, todo, feature + :pullreq: 549 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Include electric zonal heating equipment as a dependency in heating setpoint-related tsvs + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 550 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Geo-temporal shifting of the stochastic load model schedules using the American Time Use Survey + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 561 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Switch data source for `Geometry Wall Type.tsv` from RECS 2009 to Homeland Infrastructure Foundation-Level Data (HIFLD) Parcel data + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 556 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Use Schedule:File with well pump / vehicle plug loads, as well as gas grill / fireplace / lighting fuel loads. This enables the optional vacancy period to apply to these end uses + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 583 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Update example project yaml files to use buildstockbatch input schema version 0.3 + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 585 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Update default daylight saving start and end dates to March 12 and November 5, respectively + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 586 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Switches room air conditioner model to use Cutler performance curves + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 558 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Remove 3 story limit for multi-family buildings, and instead use RECS data to allow for buildings up to 21 stories + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 584 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Add a sampling probability column in the housing characteristics to define the probability a given column will be sampled + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 591 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Add ReEDS balancing areas as a spatial field + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 605 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Changes heat pump defrost control from OnDemand to Timed + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 601 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Update number of bathrooms assumption to match the Building America House Simulation Protocols + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 606 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Speed up sampling algorithm by multiple orders of magnitude for large numbers of samples + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 619 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Use ANSI/RESNET/ICC 301 equations to calculate annual interior, exterior, and garage lighting energy + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 559 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Update tsv files for both the national and testing projects. Supports transition to ResStock-HPXML + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 634 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Changes "Duct Surface Area (ft^2)" cost multiplier to "Duct Unconditioned Surface Area (ft^2)" + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 615 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Update window type distributions using RECS 2015. Includes additional of frame material types (RECS 2015) and presence of storm windows (D&R International) + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 649 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Reduces window interior shading during Winter to match ANSI/RESNET/ICC 301 assumption + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 652 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Updates ceiling fan model based on ANSI/RESNET ICC 301 assumptions + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 670 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Updates infiltration model pressure coefficient + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 675 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Updates mechanical ventilation options/model to ASHRAE 62.2-2019 and adds a "Flow Rate, Mechanical Ventilation (cfm)" output + TODO + + Assignees: TODO - Add support for an AWS service account on Kestrel/Eagle so the user - doesn't have to manage AWS keys. .. change:: - :tags: documentation - :pullreq: 419 + :tags: todo, todo, feature + :pullreq: 673 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Add PV ownership and PV system size distributions using 2019 Tracking the Sun and GTM report on solar installation + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 764 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Add optional argument to ResidentialLocation measure for setting the IECC climate zone + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 759 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Add Geometry Story Bin tsv and Geometry Story Bin dependency to Geometry Wall Type + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 661, 818 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Add arguments to the ServerDirectoryCleanup measure for controlling deletion of files in the run folder + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 543 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Fixes significant runtime bottleneck in TSV fetching in BuildExistingModel & ApplyUpgrade measures + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 553 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Dwelling units that are 0-499 ft2 are limited to a maximum of 2 bedrooms + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 556 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Reverses the material layers of the unfinished attic floor construction so that they are correctly ordered outside-to-inside + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 560 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Fixes invalid garage and living space dimension errors + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 564 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Set all mini-split heat pump supplemental capacity to autosize + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 571, 577 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Reduce stochastic schedule generation runtime by over 50% + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 568 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Fixes the problem that `Heating Type=Void` is showing up in buildstock samples + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 585 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Set AZ counties to NA daylight saving times instead of some AR counties + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 592 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Housing characteristics fixes based on more samples in testing + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 597 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Fixes window-to-wall ratio calculation for facades with doors + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 601 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Fixes number of bathrooms for single-family attached and multi-family buildings + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 609 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Sync the sample probabilities after a bug fix in tsv_dist + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 613 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Fix name of ReEDS balancing areas + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 653 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Fixes hot water distribution internal gains not being zeroed out during vacancies + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 674 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Exclude adiabatic doors when outputting the door area cost multiplier + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 694 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Disaggregate the shared fan coil's fan energy use into heating and cooling + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 700 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Fixes hours setpoint not met output to exclude A) no heating and/or cooling equipment and B) finished basements + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 759 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Revert wall type constraint that assumes all brick facades built >1960 are wood-framed with 4" face brick. Also add constraint to force all buildings > 8 stories to have steel-framed wall type + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 789 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Fixes for wall constructions: remove wood sheathing on CMU and brick walls; better data for exterior finish absorptances and wall densities + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 809 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Fixes unit conversion bugs in solar hot water model + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 821 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Update the number of units represented in the national project YAML files to the American Community Survey 2019 5-year estimate + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 817 + + **Date**: 2022-02-09 + + Title: + TODO + + Description: + Properly apply roof insulation when the attic type is Finished Attic or Cathedral Ceilings + TODO + + Assignees: TODO + - Update weather file location argument name in custom weather files documentation. diff --git a/docs/read_the_docs/source/changelog/changelog_3_0_0.rst b/docs/read_the_docs/source/changelog/changelog_3_0_0.rst new file mode 100644 index 0000000000..b61df37ea2 --- /dev/null +++ b/docs/read_the_docs/source/changelog/changelog_3_0_0.rst @@ -0,0 +1,456 @@ +================ +v3.0.0 Changelog +================ + +.. changelog:: + :version: v3.0.0 + :released: 2023-02-03 + + .. change:: + :tags: todo, todo, feature + :pullreq: 443 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Transition to using the HPXML-based workflow + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 870 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Add a new "Floor Area, Foundation (ft^2)" cost multiplier + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 842 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Add a new "Floor Area, Attic * Insulation Increase (ft^2 * Delta R-value)" cost multiplier for handling incremental costs of adding attic insulation + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 840 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Allow air leakage % reduction upgrades (e.g., 25%), and add a new "Floor Area, Conditioned * Infiltration Reduction (ft^2 * Delta ACH50)" cost multiplier for handling incremental costs of such upgrades + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 828 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + For the testing project, sample equal distributions of (1) smooth and stochastic schedules (each 50%) and (2) faulted and non-faulted HVAC systems (each 50%) + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 839 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Allow upgrade options to be defined in the lookup using measures other than ResStockArguments + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 831 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Enable rim joists for homes with basements/crawlspaces; assumes a height of 9.25 inches and calculates rim joist assembly R-value from new insulation arguments + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 782 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Enable the HEScore workflow to be run with BuildExistingModel + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 874 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Cities with more than 15,000 dwelling units are added as a geographic characteristic + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 905 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Update tsvs with new sampling_probability calculation + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 913 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Improve distributions of heat pumps in the southeast U.S. by spliting IECC zone 2A into two zones: 2A (FL, GA, AL, MS) and 2A (TX, LA) + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 900 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Add Income and Tenure tsv, update PUMS tsvs from 2017 5-yrs to 2019 5-yrs, update dependencies and fix encoding error in Occupants.tsv + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 949 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Add Income and Tenure into Geometry Floor Area + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 964 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Add distributions for partial space cooling + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 791 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Add ability to calculate emissions for various scenarios + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 984 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Add ability to calculate simple utility bills for various scenarios + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 978 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Modeled floor area based on AHS 2021 and AHS 2019 + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, feature + :pullreq: 1004 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Add area median income + TODO + + Assignees: TODO + + + .. change:: + :tags: software, openstudio, feature + :pullreq: 1015 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Update to OpenStudio v3.5.1 + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 828 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Clean up option names for natural ventilation and hot water distribution + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 833 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Remove the zero degree switchover temperature for heat pump backup heating + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 830 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + For homes with a finished attic or cathedral ceilings, models a conditioned attic instead of a vented attic + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 877 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Reduce housing characteristic file size by relaxing the six digit float format in the housing characteristics + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 934 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Fix minor bug in sampling probability calculation + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 959 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Rename sources subfolders so all tsv_makers can be imported as packages + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 975 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Fix heating and cooling auto-season inputs + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 981 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Remove Void from dependency columns in TSVs and update tests + TODO + + Assignees: TODO + + + .. change:: + :tags: todo, todo, bugfix + :pullreq: 982 + + **Date**: 2023-02-03 + + Title: + TODO + + Description: + Update low-sample downscaling logic to use raw source_weight, which leads to minor changes to Geometry Floor Area and HVAC Partial Space Conditioning + TODO + + Assignees: TODO + + diff --git a/docs/read_the_docs/source/changelog/changelog_3_1_0.rst b/docs/read_the_docs/source/changelog/changelog_3_1_0.rst index 8d866f3277..710a69396f 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_1_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_1_0.rst @@ -6,3 +6,192 @@ v3.1.0 Changelog :version: v3.1.0 :released: 2023-05-25 + .. change:: + :tags: workflow, battery, feature + :pullreq: 1009 + + **Date**: 2023-03-07 + + Title: + Stub battery tsv for testing project + + Description: + Include battery modeling capabilities for project_testing + Stub new Battery.tsv. + Separate battery related arguments from PV in options_lookup. + Test battery options using testing project. + + resstock-estimation: `pull request 321 `_ + + Assignees: Joe + + + .. change:: + :tags: workflow, mechanics, feature + :pullreq: 1042 + + **Date**: 2023-03-07 + + Title: + Check a buildstock csv against an options_lookup tsv + + Description: + Ability to check buildstock csv against an options lookup as a command line utility + Enable "integrity checks" on buildstock.csv + + Assignees: Joe + + + .. change:: + :tags: workflow, unavailable periods, feature + :pullreq: 1054 + + **Date**: 2023-03-15 + + Title: + Support for power outages + + Description: + Demonstrate new power outage modeling feature using upgrades specified in example project yml files + Support for power outages + + Assignees: Joe + + + .. change:: + :tags: workflow, mechanics, feature + :pullreq: 1056 + + **Date**: 2023-03-21 + + Title: + Support sample_weight in buildstock.csv + + Description: + Ability to specify a "sample_weight" column in the precomputed buildstock.csv + Adds support for a sample_weight column in the precomputed buildstock.csv. By default, BuildExistingModel writes build_existing_model.sample_weight based on calculating n_buildings_represented / n_datapoints (this calculation is done in the workflow generator and then passed into the BuildExistingModel measure). Now, if sample_weight already exists in the buildstock.csv, it will write this value instead of the calculated one. + + Assignees: Joe + + + .. change:: + :tags: characteristics, documentation, feature + :pullreq: 1069 + + **Date**: 2023-05-01 + + Title: + Add descriptions to housing characteristics + + Description: + Add descriptions to the housing characteristics + Add a description tag to each of the housing characteristics. Add the source reports from resstock-estimation to resstock. + + resstock-estimation: `pull request 366 `_ + + Assignees: Tony + + + .. change:: + :tags: workflow, heat pumps, feature + :pullreq: 1071 + + **Date**: 2023-05-09 + + Title: + Add capacity retention arguments for ASHP + + Description: + Connect ASHP to optional capacity retention temperature and fraction arguments (that already exist for MSHP) + Add capacity retention arguments for ASHP + + Assignees: Joe, Scott + + + .. change:: + :tags: documentation, data dictionary, feature + :pullreq: 1058 + + **Date**: 2023-05-10 + + Title: + Data dictionary + automated RTD generation + + Description: + Add data dictionary files for describing various outputs. Use these files to (1) check against integration test results, and (2) generate documentation tables + One of the pain points we experience when importing ResStock runs into SightGlass (resstock.nrel.gov) is that the outputs and format of the outputs from ResStock frequently change. This causes our data processing for that to break and require many hours of manual updating every time we go to bring new data in. + + It would be really helpful to have a data dictionary of the outputs ResStock produces meaning every column name (including the input and output columns) in the results.csv and timeseries parquet files. It should also include some flags about which are end uses to include in the sum vs aggregates (net or totals), units, other random outputs like load, emissions, etc. To keep this in sync, it should be verified against the CI runs of ResStock and if there is a discrepancy you get a big ❌ on your checks. + + Assignees: Joe + + + .. change:: + :tags: workflow, heat pumps, feature + :pullreq: 1072 + + **Date**: 2023-05-09 + + Title: + HP heating capacity retention + + Description: + OS-HPXML now supports use of optional heat pump capacity retention temperature and fraction arguments (applicable to both ASHP and MSHP) + Adds optional inputs for defining heat pump capacity retention: + + extension/HeatingCapacityRetention/Fraction + extension/HeatingCapacityRetention/Temperature + + OpenStudio-HPXML: `pull request 1383 `_ + + Assignees: Joe, Scott + + + .. change:: + :tags: software, openstudio, feature + :pullreq: 1076 + + **Date**: 2023-05-25 + + Title: + Latest OS-HPXML, OS v3.6.1 + + Description: + Update to OpenStudio v3.6.1 + Latest OS-HPXML, OS v3.6.1 + + Assignees: Joe, Scott + + + .. change:: + :tags: workflow, mechanics, bugfix + :pullreq: 1054 + + **Date**: 2023-03-15 + + Title: + Pulls in upstream OS-HPXML fix related to [avoiding possible OpenStudio temporary directory collision](https://github.com/NREL/OpenStudio-HPXML/pull/1316) causing random errors + + Description: + Pulls in upstream OS-HPXML fix related to [avoiding possible OpenStudio temporary directory collision](https://github.com/NREL/OpenStudio-HPXML/pull/1316) causing random errors + Pulls in upstream OS-HPXML fix related to [avoiding possible OpenStudio temporary directory collision](https://github.com/NREL/OpenStudio-HPXML/pull/1316) causing random errors + + Assignees: Joe + + + .. change:: + :tags: workflow, mechanics, bugfix + :pullreq: 1076 + + **Date**: 2023-05-25 + + Title: + Pulls in upstream OS-HPXML fix related to [falling back to a WWR calculation when window placement fails](https://github.com/NREL/OpenStudio-HPXML/pull/1385) causing errors fitting windows + + Description: + Pulls in upstream OS-HPXML fix related to [falling back to a WWR calculation when window placement fails](https://github.com/NREL/OpenStudio-HPXML/pull/1385) causing errors fitting windows + Pulls in upstream OS-HPXML fix related to [falling back to a WWR calculation when window placement fails](https://github.com/NREL/OpenStudio-HPXML/pull/1385) causing errors fitting windows + + Assignees: Joe + + diff --git a/docs/read_the_docs/source/changelog/changelog_3_1_1.rst b/docs/read_the_docs/source/changelog/changelog_3_1_1.rst index 657a4e5740..7f02104ddc 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_1_1.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_1_1.rst @@ -7,7 +7,7 @@ v3.1.1 Changelog :released: 2023-11-28 .. change:: - :tags: workflow, mechanics + :tags: workflow, mechanics, bugfix :pullreq: 1170 **Date**: 2023-11-28 @@ -19,8 +19,6 @@ v3.1.1 Changelog Use `Gem::Version` on buildstockbatch version string comparisons so that, e.g., '2023.10.0' < '2023.5.0' does not evaluate to true Patched release with version comparison fix - Assignee(s): - - - Joe + Assignees: Joe diff --git a/docs/read_the_docs/source/changelog/changelog_3_2_0.rst b/docs/read_the_docs/source/changelog/changelog_3_2_0.rst index d2dec5ee65..fb16f1b825 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_2_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_2_0.rst @@ -7,7 +7,7 @@ v3.2.0 Changelog :released: 2023-12-19 .. change:: - :tags: workflow, weather + :tags: workflow, weather, bugfix :pullreq: 1182 **Date**: 2023-12-18 @@ -19,13 +19,11 @@ v3.2.0 Changelog Update TMY3 weather URL from the NREL Data Catalog The current link in the project YAMLs for the TMY weather files in NREL Data Catalog is out of date and missing the following Counties. This PR updates the link to the latest file on the NREL Data Catalog. - Assignee(s): - - - Tony + Assignees: Tony .. change:: - :tags: workflow, gshp + :tags: workflow, gshp, feature :pullreq: 1187 **Date**: 2023-12-10 @@ -37,19 +35,13 @@ v3.2.0 Changelog Updates and enhancements to the ground source heat pump model; ability to describe detailed geothermal loop inputs Allow inputs to describe a ground-source heat pump field (e.g., vertical vs horizontal, bore/trench length, etc.). - Assignee(s): - - - Prateek - - - Jeff + OpenStudio-HPXML: `pull request 1391 `_ - - Tony - - - Joe + Assignees: Prateek, Jeff, Tony, Joe .. change:: - :tags: characteristics, ground conductivity + :tags: characteristics, ground conductivity, feature :pullreq: 1165 **Date**: 2023-12-04 @@ -61,13 +53,13 @@ v3.2.0 Changelog Add variability in ground thermal conductivity Allow ground conductivity to vary by climate zone. The GeoVision task force report provided data by climate zone. The same data is used to fill out distributions by climate zone. - Assignee(s): + resstock-estimation: `pull request 393 `_ - - Tony + Assignees: Tony .. change:: - :tags: documentation, resstockarguments + :tags: documentation, resstockarguments, feature :pullreq: 1146 **Date**: 2023-11-27 @@ -79,13 +71,11 @@ v3.2.0 Changelog Automate creation of new "Arguments" documentation sections for summarizing arguments (and their default values) in options_lookup.tsv By housing characteristic parameter, automates summarizing Arguments sets used in options_lookup.tsv (including Name, Required, Units, Type, Choices, Description). See below for example. - Assignee(s): - - - Joe + Assignees: Joe .. change:: - :tags: characteristics, data sources + :tags: characteristics, data sources, bugfix :pullreq: 1164 **Date**: 2023-11-10 @@ -97,13 +87,13 @@ v3.2.0 Changelog Update to RECS 2020 V5 data files Use RECS 2020 V5 microdata file to create the characteristics. There is very little impact as the update to RECS 2020 V5 is mainly adding columns with end-use energy and expenditures. There are some very small changes to some TSVs, but these changes result in no changes to the options_saturation file. - Assignee(s): + resstock-estimation: `pull request 392 `_ - - Tony + Assignees: Tony .. change:: - :tags: software, openstudio + :tags: software, openstudio, feature :pullreq: 1144 **Date**: 2023-10-26 @@ -115,15 +105,11 @@ v3.2.0 Changelog Update to OpenStudio v3.7.0 OpenStudio 3.7.0/EnergyPlus 23.2.0 - Assignee(s): - - - Joe - - - Scott + Assignees: Joe, Scott .. change:: - :tags: workflow, utility bills + :tags: workflow, utility bills, feature :pullreq: 1109 **Date**: 2023-10-24 @@ -135,13 +121,11 @@ v3.2.0 Changelog Add ability to calculate detailed utility bills based on a user-specified TSV file of paths to JSON utility rate tariff files Add optional detailed_filepath yml argument for pointing to user-specified TSV file of electricity tariff file paths. The TSV file can contain electricity tariff file paths mapped by State, or any other parameter. - Assignee(s): - - - Joe + Assignees: Joe .. change:: - :tags: workflow, resilience + :tags: workflow, resilience, feature :pullreq: 1113 **Date**: 2023-10-23 @@ -153,13 +137,11 @@ v3.2.0 Changelog Add ability to request timeseries resilience output from the yml file Include the new include_timeseries_resilience argument in example yml files. - Assignee(s): - - - Joe + Assignees: Joe .. change:: - :tags: characteristics, water heater + :tags: characteristics, water heater, feature :pullreq: 1125 **Date**: 2023-09-25 @@ -171,13 +153,13 @@ v3.2.0 Changelog Add Water Heater Location and Geometry Space Combination, update Geometry Garage and Geometry Floor Area Bin to RECS2020, update RECS2020 microdata from v2 to v4, auto-generate buildstocks for yml_precomputed tests Added Water Heater Location.tsv - Assignee(s): + resstock-estimation: `pull request 385 `_ - - Lixi + Assignees: Lixi .. change:: - :tags: workflow, mechanics + :tags: workflow, mechanics, bugfix :pullreq: 1138 **Date**: 2023-09-20 @@ -189,13 +171,11 @@ v3.2.0 Changelog Update `run_analysis.rb` to handle illegal path characters in upgrade names run_analysis.rb creates directories based on upgrade names, but these upgrade names may have illegal path characters in them (e.g., "/" if the upgrade name is "Higher efficiency ducted ASHP w/ elec backup "), resulting in an obscure error. It should more gracefully handle this situation and be able to run upgrades with these characters in the name. - Assignee(s): - - - Joe + Assignees: Joe .. change:: - :tags: workflow, mechanics + :tags: workflow, mechanics, feature :pullreq: 1138 **Date**: 2023-09-20 @@ -207,13 +187,11 @@ v3.2.0 Changelog Update `run_analysis.rb` to map datapoints to run folder names when the `-k` argument is supplied Also, adds writing run folder names (e.g., "run1", "run2", etc.) to the "job_id" column when supplying the -k argument to run_analysis.rb (i.e., a map from datapoint to run folder). - Assignee(s): - - - Joe + Assignees: Joe .. change:: - :tags: characteristics, setpoints + :tags: characteristics, setpoints, bugfix :pullreq: 1136 **Date**: 2023-09-11 @@ -225,13 +203,13 @@ v3.2.0 Changelog Minor changes to heating and cooling setpoint TSV after a bug fix Fix an elusive bug that causes a slight changes on the Heating Setpoint and Cooling Setpoint TSV on each run. This bug was a result of previous PR of refactoring prune_rules. - Assignee(s): + resstock-estimation: `pull request 388 `_ - - Rajendra + Assignees: Rajendra .. change:: - :tags: characteristics, setpoints + :tags: characteristics, setpoints, bugfix :pullreq: 1132 **Date**: 2023-09-06 @@ -243,13 +221,13 @@ v3.2.0 Changelog Minor changes to heating and cooling setpoint TSV due to refactoring of prune_rules handling in resstock-estimation Attempt at fixing ongoing issue with unexpected behavior of prune rules in #385 by refactoring and simplifying prune rule handling. - Assignee(s): + resstock-estimation: `pull request 386 `_ - - Rajendra + Assignees: Rajendra .. change:: - :tags: characteristics, general + :tags: characteristics, general, feature :pullreq: 1132 **Date**: 2023-09-06 @@ -261,13 +239,13 @@ v3.2.0 Changelog options_saturations.csv is added to project_*/resources/ folder Also add options_saturations.csv to resources. - Assignee(s): + resstock-estimation: `pull request 386 `_ - - Rajendra + Assignees: Rajendra .. change:: - :tags: characteristics, refrigerator + :tags: characteristics, refrigerator, bugfix :pullreq: 1118 **Date**: 2023-08-23 @@ -279,13 +257,11 @@ v3.2.0 Changelog Correct refrigerator rated annual kWh based on EF and an assumed volume of 20.9cft. Change the rated annual consumption of refrigerator and misc extra refrigerator in options_lookup.tsv - Assignee(s): - - - Lixi + Assignees: Lixi .. change:: - :tags: workflow, heat pumps + :tags: workflow, heat pumps, feature :pullreq: 1074 **Date**: 2023-08-18 @@ -297,13 +273,11 @@ v3.2.0 Changelog For heat pump upgrades, adds the ability to set the existing primary (non-shared) heating system as the backup system using only a single option from the lookup Uses ResStockArguments to add a new boolean argument heat_pump_backup_use_existing_system. - Assignee(s): - - - Joe + Assignees: Joe .. change:: - :tags: characteristics, ducts + :tags: characteristics, ducts, bugfix :pullreq: 1104, 1112 **Date**: 2023-08-09 @@ -319,15 +293,13 @@ v3.2.0 Changelog Fixed HVAC Shared Efficiencies.tsv Fixed HVAC Heating Efficiency.tsv - Assignee(s): - - - Lixi + resstock-estimation: `pull request 377 `_ - - Joe + Assignees: Lixi, Joe .. change:: - :tags: characteristics, floor area + :tags: characteristics, floor area, bugfix :pullreq: 1115 **Date**: 2023-08-07 @@ -339,13 +311,11 @@ v3.2.0 Changelog Fix square footage for a MF dwelling unit in the "3000-3999" CFA bin (from 33171 to 3171) This shows square footage for an MF housing bin of 3000-3999 to be 33171. I assume this is incorrect and a typo, but should be a quick fix - Assignee(s): - - - Joe + Assignees: Joe .. change:: - :tags: workflow, secondary heating + :tags: workflow, secondary heating, feature :pullreq: 1093 **Date**: 2023-07-17 @@ -357,13 +327,15 @@ v3.2.0 Changelog Include HVAC secondary heating capabilities for project_testing Support options sampled from HVAC Secondary Heating xxx. - Assignee(s): + resstock-estimation: `pull request 375 `_ - - Joe + OpenStudio-HPXML: `pull request 1414 `_ + + Assignees: Joe .. change:: - :tags: workflow, secondary heating + :tags: workflow, secondary heating, bugfix :pullreq: 1093 **Date**: 2023-07-17 @@ -375,13 +347,15 @@ v3.2.0 Changelog Update ResStockArguments to support nonzero fraction of heat load served by the secondary heating system Update the ResStockArguments measure to adjust the primary system's fraction of heat load served such that the sum of fractions does not exceed 1.0 - Assignee(s): + resstock-estimation: `pull request 375 `_ + + OpenStudio-HPXML: `pull request 1414 `_ - - Joe + Assignees: Joe .. change:: - :tags: characteristics, other fuel + :tags: characteristics, other fuel, bugfix :pullreq: 947 **Date**: 2023-07-11 @@ -394,13 +368,11 @@ v3.2.0 Changelog Water Heater Efficiency|Other Fuel to model a wood storage water heater instead of no water heater. HVAC Heating Efficiency|Other to model a wood wall/floor furnace instead of no heating system. - Assignee(s): - - - Joe + Assignees: Joe .. change:: - :tags: workflow, formatting + :tags: workflow, formatting, bugfix :pullreq: 962 **Date**: 2023-06-26 @@ -412,15 +384,11 @@ v3.2.0 Changelog Set standard format for options_lookup In an effort to clean up resources/options_lookup.tsv, this sets a standard for what the file should look like. - Assignee(s): - - - Rajendra - - - Tony + Assignees: Rajendra, Tony .. change:: - :tags: workflow, utility bills + :tags: workflow, utility bills, feature :pullreq: 1012 **Date**: 2023-06-12 @@ -432,13 +400,11 @@ v3.2.0 Changelog Add ability to calculate simple utility bills based on a user-specified TSV file of utility rates Add optional simple_filepath yml argument for pointing to user-specified TSV file of utility rates. The TSV file can contain utility rates mapped by State, or any other parameter. - Assignee(s): - - - Joe + Assignees: Joe .. change:: - :tags: characteristics, data sources + :tags: characteristics, data sources, feature :pullreq: 1031 **Date**: 2023-06-08 @@ -450,13 +416,11 @@ v3.2.0 Changelog Update characteristics to use EIA 2020 RECS Transitioning characteristics to use the EIA's 2020 RECS survey final characteristics. - Assignee(s): - - - Tony + Assignees: Tony .. change:: - :tags: workflow, emissions + :tags: workflow, emissions, feature :pullreq: 1038 **Date**: 2023-06-07 @@ -468,13 +432,11 @@ v3.2.0 Changelog Add 2022 Cambium emissions data Cambium 2022 data is out. This issue is to update to the 2022 data. - Assignee(s): - - - Joe + Assignees: Joe .. change:: - :tags: characteristics, climate zones + :tags: characteristics, climate zones, feature :pullreq: 1080 **Date**: 2023-06-06 @@ -486,8 +448,8 @@ v3.2.0 Changelog Add Energystar Climate Zone for window upgrade specification Add Energystar Climate Zone for window upgrade specification - Assignee(s): + resstock-estimation: `pull request 369 `_ - - Lixi + Assignees: Lixi diff --git a/docs/read_the_docs/source/changelog/changelog_dev.rst b/docs/read_the_docs/source/changelog/changelog_dev.rst index baf8265446..9445fa2057 100644 --- a/docs/read_the_docs/source/changelog/changelog_dev.rst +++ b/docs/read_the_docs/source/changelog/changelog_dev.rst @@ -3,11 +3,11 @@ Development Changelog ===================== .. changelog:: - :version: development - :released: It has not been + :version: v3.3.0 + :released: pending .. change:: - :tags: software, openstudio + :tags: software, openstudio, feature :pullreq: 1225 **Date**: 2024-05-09 @@ -19,15 +19,11 @@ Development Changelog Update to OpenStudio v3.8.0 OpenStudio 3.8/EnergyPlus 24.1 - Assignee(s): - - - Joe - - - Scott + Assignees: Joe, Scott .. change:: - :tags: characteristics, ducts + :tags: characteristics, ducts, feature :pullreq: 1233 **Date**: 2024-05-07 @@ -39,13 +35,13 @@ Development Changelog Update to new OS-HPXML defaults for duct insulation; 25% rectangular supply ducts and 100% rectangular return ducts (previously 100% round supply/return ducts) Adds optional inputs (Ducts/DuctShape and Ducts/DuctFractionRectangular); defaults to 25% rectangular supply ducts and 100% rectangular return ducts (previously 100% round supply/return ducts). - Assignee(s): + OpenStudio-HPXML: `pull request 1691 `_ - - Scott + Assignees: Scott .. change:: - :tags: workflow, hvac + :tags: workflow, hvac, feature :pullreq: 1233 **Date**: 2024-05-07 @@ -54,16 +50,16 @@ Development Changelog HVAC Autosizing Limits Description: - nan + HVAC The PR aims to allow specifying upper limits for autosized capacities. - Assignee(s): + OpenStudio-HPXML: `pull request 1584 `_ - - Joe + Assignees: Joe .. change:: - :tags: workflow, hvac + :tags: workflow, hvac, bugfix :pullreq: 1218 **Date**: 2024-04-09 @@ -75,13 +71,13 @@ Development Changelog Enable HVAC airflow and capacity scaling factors to oversize or undersize the equipment Manually create new tsv files for assigning autosizing factor arguments introduced by NREL/OpenStudio-HPXML#1611 - Assignee(s): + resstock-estimation: `pull request 406 `_ - - Joe + Assignees: Joe .. change:: - :tags: characteristics, plug loads, ceiling fan + :tags: characteristics, plug loads, ceiling fan, feature :pullreq: 1220 **Date**: 2024-04-02 @@ -95,13 +91,13 @@ Development Changelog generate Other schedules that follow the new Other schedule fractions (still uses non-constant 2010 BAHSP monthly multipliers). generate Ceiling Fan schedules that follow the new Ceiling Fan schedule fractions (also update multipliers to not follow Other multipliers, but rather Ceiling Fan multipliers that are a function of weather) - Assignee(s): + OpenStudio-HPXML: `pull request 1634 `_ - - Joe + Assignees: Joe .. change:: - :tags: characteristics, alaska + :tags: characteristics, alaska, bugfix :pullreq: 1214 **Date**: 2024-03-18 @@ -113,15 +109,13 @@ Development Changelog Update the Alaska residential stock characterization using the Alaska Retrofit Information System data Update housing characteristics for Alaska using ARIS dataset. Explicitly model wood heating for the national. - Assignee(s): - - - Rajendra + resstock-estimation: `pull request 381 `_ - - Tony + Assignees: Rajendra, Tony .. change:: - :tags: workflow, hvac + :tags: workflow, hvac, feature :pullreq: 1215 **Date**: 2024-03-11 @@ -133,15 +127,13 @@ Development Changelog Add ability to specify HVAC system autosizing factors for baseline buildings; autosizing factors are retained for upgrade buildings following the same approach for HVAC system capacities Allows optional HeatingAutosizingFactor, CoolingAutosizingFactor, BackupHeatingAutosizingFactor inputs to scale HVAC equipment autosizing results. - Assignee(s): + OpenStudio-HPXML: `pull request 1611 `_ - - Joe - - - Yueyue + Assignees: Joe, Yueyue .. change:: - :tags: workflow, weather + :tags: workflow, weather, feature :pullreq: 1215 **Date**: 2024-03-11 @@ -153,13 +145,13 @@ Development Changelog nan Allow building site inputs; this is particularly useful when the building is located far from, or at a very different elevation than, the EPW weather station. When not provided, defaults to using EPW header values (as before). - Assignee(s): + OpenStudio-HPXML: `pull request 1636 `_ - - Scott + Assignees: Scott .. change:: - :tags: characteristics, socio-demographics + :tags: characteristics, socio-demographics, feature :pullreq: 1212 **Date**: 2024-02-29 @@ -171,13 +163,13 @@ Development Changelog Add Metropolitan and Micropolitan Statistical Area tsv, County Metro Status tsv, and State Metro Median Income tsv Added 3 new tsvs to support @SinounPhoung's socio-demographically differentiated Stochastic Occupant Schedule integration into ResStock - Assignee(s): + resstock-estimation: `pull request 400 `_ - - Lixi + Assignees: Lixi .. change:: - :tags: characteristics, water heater + :tags: characteristics, water heater, bugfix :pullreq: 1201 **Date**: 2024-02-28 @@ -189,17 +181,11 @@ Development Changelog Move location of out-of-unit (shared) water heaters to conditioned mechanical room Move out-of-unit water heaters (i.e., Water Heater In Unit=No from Location=None to Location=Conditioned Mechanical Room (corresponds to OS-HPXML location: "other heated space"). - Assignee(s): - - - Lixi - - - Jeff - - - Tony + Assignees: Lixi, Jeff, Tony .. change:: - :tags: workflow, unavailable periods + :tags: workflow, unavailable periods, feature :pullreq: 1209 **Date**: 2024-02-23 @@ -211,13 +197,13 @@ Development Changelog Allow definition of multiple unavailable periods (i.e., vacancy, power outage) Update schedules_vacancy_period and schedules_power_outage_period arguments to support multiple periods (comma-separated?). Argument schedules_power_outage_window_natvent_availability would then need to also be comma-separated? - Assignee(s): + OpenStudio-HPXML: `pull request 1622 `_ - - Joe + Assignees: Joe .. change:: - :tags: workflow, heat pump backup + :tags: workflow, heat pump backup, feature :pullreq: 1209 **Date**: 2024-02-23 @@ -229,13 +215,13 @@ Development Changelog Add ability to set either an "emergency" or "supplemental" heat pump backup sizing methodology Adds a HeatPumpBackupSizingMethodology element with choices of 'emergency' and 'supplemental'. Defaults to 'emergency', so results do not change by default. - Assignee(s): + OpenStudio-HPXML: `pull request 1597 `_ - - Scott + Assignees: Scott .. change:: - :tags: characteristics, refrigerator + :tags: characteristics, refrigerator, feature :pullreq: 1209 **Date**: 2024-02-23 @@ -247,13 +233,13 @@ Development Changelog Refrigerator energy use is now affected by its ambient temperature using hourly constant and temperature coefficients from ANSI/RESNET/ICC 301-2022 Addendum C Default fridge schedule is now an actuated EMS program. Daily schedule is a function of hour and space temperature. - Assignee(s): + OpenStudio-HPXML: `pull request 1572 `_ - - Joe + Assignees: Joe .. change:: - :tags: workflow, general water use + :tags: workflow, general water use, feature :pullreq: 1209 **Date**: 2024-02-23 @@ -265,13 +251,13 @@ Development Changelog nan Various schedule fractions/multipliers updates (e.g., appliances, lighting, fixtures, occupancy, ceiling fan). - Assignee(s): + OpenStudio-HPXML: `pull request 1572 `_ - - Joe + Assignees: Joe .. change:: - :tags: workflow, ceiling fan + :tags: workflow, ceiling fan, feature :pullreq: 1209 **Date**: 2024-02-23 @@ -283,13 +269,13 @@ Development Changelog nan For ceiling fans, add a LabelEnergyUse (W) input as an alternative to Efficiency (cfm/W). - Assignee(s): + OpenStudio-HPXML: `pull request 1609 `_ - - Joe + Assignees: Joe .. change:: - :tags: characteristics, hot water fixtures + :tags: characteristics, hot water fixtures, feature :pullreq: 1210 **Date**: 2024-02-21 @@ -301,15 +287,13 @@ Development Changelog Update hot water usage multipliers based on field data rather than engineering judgement Update hot water usage multipliers. Using field data from 1700 water heaters in New England to come up with the distribution. Based on data collected as part of PERFORM with Michael Blonsky, who shared the distribution with us. - Assignee(s): + resstock-estimation: `pull request 361 `_ - - Jeff - - - Tony + Assignees: Jeff, Tony .. change:: - :tags: workflow, whole building + :tags: workflow, whole building, feature :pullreq: 1200 **Date**: 2024-01-30 @@ -321,15 +305,11 @@ Development Changelog Add optional switch to BuildExistingModel (defaulted to false) for modeling whole SFA/MF buildings Replaces building_id=ALL argument with an element in the HPXML file, which allows us to perform validation specific to whole MF building simulations - Assignee(s): - - - Joe - - - Scott + Assignees: Joe, Scott .. change:: - :tags: characteristics, data sources + :tags: characteristics, data sources, bugfix :pullreq: 1199 **Date**: 2024-01-26 @@ -341,13 +321,13 @@ Development Changelog Update to RECS 2020 V7 data files Updates RECS 2020 data from v5 to v7. There are some new EV variables to be leveraged by the ResStock/TEMPO project. I am not sure what V6 was as there is no documentation. - Assignee(s): + resstock-estimation: `pull request 394 `_ - - Tony + Assignees: Tony .. change:: - :tags: workflow, mechanics + :tags: workflow, mechanics, bugfix :pullreq: 1195 **Date**: 2024-01-22 @@ -359,13 +339,11 @@ Development Changelog Reorganize the emissions and utility rates data folders such that their sources and functions are more clear Previously, it wasn't clear that the provided utility rate data was for demonstration purposes only. - Assignee(s): - - - Joe + Assignees: Joe .. change:: - :tags: workflow, emissions + :tags: workflow, emissions, feature :pullreq: 1194 **Date**: 2024-01-19 @@ -377,13 +355,11 @@ Development Changelog Include additional 2022 Cambium 25-year LRMER emissions data Add 10 new "LRMER_xxx_25" data folders to resources/data/cambium/2022. - Assignee(s): - - - Joe + Assignees: Joe .. change:: - :tags: workflow, radiant barrier + :tags: workflow, radiant barrier, feature :pullreq: 1188 **Date**: 2024-01-17 @@ -395,13 +371,13 @@ Development Changelog Add flexibility to specify location of the radiant barrier Allowing Radiant Barrier for Attic Floor - Assignee(s): + OpenStudio-HPXML: `pull request 1473 `_ - - Prateek + Assignees: Prateek .. change:: - :tags: workflow, hvac + :tags: workflow, hvac, feature :pullreq: 1188, 1200 **Date**: 2024-01-17 @@ -417,17 +393,13 @@ Development Changelog Data can be sourced from e.g. NEEP's Cold Climate Air Source Heat Pump List. Add detailed performance data arguments for air-source, variable-speed HVAC systems. - Assignee(s): - - - Yueyue + OpenStudio-HPXML: `pull request 1583 `_, `pull request 1317 `_, `pull request 1558 `_ - - Scott - - - Joe + Assignees: Yueyue, Scott, Joe .. change:: - :tags: workflow, water heater + :tags: workflow, water heater, bugfix :pullreq: 1190 **Date**: 2024-01-12 @@ -439,8 +411,6 @@ Development Changelog Remove old HPWH options from options_lookup Removing the old HPWH options from options_lookup.tsv - Assignee(s): - - - Jeff + Assignees: Jeff From 9811cbeac485795af935c864481fb75f22dbfaf0 Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Fri, 17 May 2024 16:00:32 -0700 Subject: [PATCH 06/21] Missed the 3_0_0 in the changelog index. --- docs/read_the_docs/source/changelog/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/read_the_docs/source/changelog/index.rst b/docs/read_the_docs/source/changelog/index.rst index 390ac1c2d0..a90fd5d73b 100644 --- a/docs/read_the_docs/source/changelog/index.rst +++ b/docs/read_the_docs/source/changelog/index.rst @@ -9,6 +9,7 @@ Changelogs changelog_3_2_0 changelog_3_1_1 changelog_3_1_0 + changelog_3_0_0 changelog_2_5_0 changelog_2_4_0 changelog_2_3_0 From a011ef8a1e8aaf0ca95ec2b85390499521b6b872 Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Mon, 20 May 2024 15:49:07 -0700 Subject: [PATCH 07/21] Update 3_0_0 changelog. [ci skip] --- .../source/changelog/changelog_3_0_0.rst | 308 ++++++++++-------- 1 file changed, 171 insertions(+), 137 deletions(-) diff --git a/docs/read_the_docs/source/changelog/changelog_3_0_0.rst b/docs/read_the_docs/source/changelog/changelog_3_0_0.rst index b61df37ea2..d9703eb235 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_0_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_0_0.rst @@ -7,450 +7,484 @@ v3.0.0 Changelog :released: 2023-02-03 .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 443 - **Date**: 2023-02-03 + **Date**: 2022-02-10 Title: - TODO + ResStock-HPXML Description: Transition to using the HPXML-based workflow - TODO + Subtree resources/hpxml-measures to github.com/NREL/OpenStudio-HPXML. - Assignees: TODO + OpenStudio-HPXML: `pull request 372 `_ + + Assignees: Joe, Andrew .. change:: - :tags: todo, todo, feature + :tags: workflow, cost multipliers, feature :pullreq: 870 - **Date**: 2023-02-03 + **Date**: 2022-04-11 Title: - TODO + Unvented crawlspace upgrade Description: Add a new "Floor Area, Foundation (ft^2)" cost multiplier - TODO + Unvented crawlspace upgrade - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature - :pullreq: 842 + :tags: workflow, cost multipliers, feature + :pullreq: 848 - **Date**: 2023-02-03 + **Date**: 2022-04-06 Title: - TODO + Handle incremental costs of (1) adding attic insulation and (2) reducing (%) infiltration Description: Add a new "Floor Area, Attic * Insulation Increase (ft^2 * Delta R-value)" cost multiplier for handling incremental costs of adding attic insulation - TODO + Handle incremental costs of adding attic insulation - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature - :pullreq: 840 + :tags: workflow, cost multipliers, feature + :pullreq: 848 - **Date**: 2023-02-03 + **Date**: 2022-04-06 Title: - TODO + Handle incremental costs of (1) adding attic insulation and (2) reducing (%) infiltration Description: Allow air leakage % reduction upgrades (e.g., 25%), and add a new "Floor Area, Conditioned * Infiltration Reduction (ft^2 * Delta ACH50)" cost multiplier for handling incremental costs of such upgrades - TODO + Add generic multiplier argument to infiltration options to facilitate % reductions in ACH50 - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: characteristics, testing, feature :pullreq: 828 - **Date**: 2023-02-03 + **Date**: 2022-03-09 Title: - TODO + Changes after switching to ResStock-HPXML Description: For the testing project, sample equal distributions of (1) smooth and stochastic schedules (each 50%) and (2) faulted and non-faulted HVAC systems (each 50%) - TODO + project_testing/Schedules.tsv to equal distribution of Default and Stochastic + project_testing/HVAC System Is Faulted.tsv to equal distribution of No and Yes - Assignees: TODO + resstock-estimation: `pull request 193 `_ + + Assignees: Joe, Andrew .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 839 - **Date**: 2023-02-03 + **Date**: 2022-02-28 Title: - TODO + Extend ApplyUpgrade for upgrade measures Description: Allow upgrade options to be defined in the lookup using measures other than ResStockArguments - TODO + Support "upgrade" measures that are not part of the OS-HPXML workflow, and are tacked on after model is created. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, rim joists, feature :pullreq: 831 - **Date**: 2023-02-03 + **Date**: 2022-02-16 Title: - TODO + Enable rim joists Description: Enable rim joists for homes with basements/crawlspaces; assumes a height of 9.25 inches and calculates rim joist assembly R-value from new insulation arguments - TODO + Enable rim joists (set this by default, and r-value to foundation wall r-value); we could potentially enable rim joists between floors by adjusting average ceiling height, but we won't for now - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, hescore, feature :pullreq: 782 - **Date**: 2023-02-03 + **Date**: 2022-02-14 Title: - TODO + HEScore Workflow Description: Enable the HEScore workflow to be run with BuildExistingModel - TODO + Enables to the HEScore workflow to be run from BuildExistingModel. A new argument os_hescore_directory is added in BuildExistingModel which points to a local checkout of https://github.com/NREL/OpenStudio-HEScore. - Assignees: TODO + Assignees: Andrew .. change:: - :tags: todo, todo, feature + :tags: characteristics, geography, feature :pullreq: 874 - **Date**: 2023-02-03 + **Date**: 2022-04-20 Title: - TODO + City Boundaries Description: Cities with more than 15,000 dwelling units are added as a geographic characteristic - TODO + Adding City boundaries as a housing characteristic in ResStock. This way users can aggregate directly by a given City. - Assignees: TODO + resstock-estimation: `pull request 196 `_ + + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, mechanics, feature :pullreq: 905 - **Date**: 2023-02-03 + **Date**: 2022-04-27 Title: - TODO + update tsvs with new sampling_prob Description: Update tsvs with new sampling_probability calculation TODO - Assignees: TODO + resstock-estimation: `pull request 210 `_, `pull request 203 `_ + + Assignees: Lixi .. change:: - :tags: todo, todo, feature + :tags: characteristics, heat pumps, feature :pullreq: 913 - **Date**: 2023-02-03 + **Date**: 2022-05-02 Title: - TODO + Improve heat pump distributions for Texas and Florida Description: Improve distributions of heat pumps in the southeast U.S. by spliting IECC zone 2A into two zones: 2A (FL, GA, AL, MS) and 2A (TX, LA) - TODO + Currently using IECC climate zone for HVAC Heating Type + Zone 2A is 16%-20% HP, whereas Reportable Domain of TX (3%), FL (20%) + Solution: Split 2A into two chunks, 2A (FL, GA, AL, MS), and 2A (TX, LA) - Assignees: TODO + resstock-estimation: `pull request 209 `_ + + Assignees: Phil, Eric, Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, income, feature :pullreq: 900 - **Date**: 2023-02-03 + **Date**: 2022-05-06 Title: - TODO + Add income, tenure, fix occupants Description: Add Income and Tenure tsv, update PUMS tsvs from 2017 5-yrs to 2019 5-yrs, update dependencies and fix encoding error in Occupants.tsv - TODO + Update PUMS tsvs from 2017 5-yrs to 2019 5-yrs, + Add new tvs: Income, Income RECS2015, Federal Poverty Level, Tenure, and PUMA Metro Status (a few of them are explained in detail below.) - Assignees: TODO + Assignees: Lixi, Tony, Nate .. change:: - :tags: todo, todo, feature + :tags: characteristics, income, feature :pullreq: 949 - **Date**: 2023-02-03 + **Date**: 2022-07-08 Title: - TODO + add income + tenure to floor_area Description: Add Income and Tenure into Geometry Floor Area - TODO + Add Income and Tenure to Geometry Floor Area - Assignees: TODO + resstock-estimation: `pull request 233 `_ + + Assignees: Lixi .. change:: - :tags: todo, todo, feature + :tags: characteristics, hvac, feature :pullreq: 964 - **Date**: 2023-02-03 + **Date**: 2022-07-15 Title: - TODO + Introduce cooling partial space conditioning Description: Add distributions for partial space cooling - TODO + Introduce partial space conditioning for cooling. - Assignees: TODO + resstock-estimation: `pull request 235 `_, `pull request 233 `_, `pull request 241 `_ + + Assignees: Tony, Rajendra .. change:: - :tags: todo, todo, feature + :tags: workflow, emissions, feature :pullreq: 791 - **Date**: 2023-02-03 + **Date**: 2022-02-01 Title: - TODO + ResStock-HPXML: Emissions calculations (e.g., CO2) Description: Add ability to calculate emissions for various scenarios - TODO + ResStock-HPXML: CO2 Emissions calculations - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, utility bills, feature :pullreq: 984 - **Date**: 2023-02-03 + **Date**: 2022-09-09 Title: - TODO + Optionally calculate simple utility bills Description: Add ability to calculate simple utility bills for various scenarios - TODO + Call new ReportUtilityBills measure from OS-HPXML. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: characteristics, floor area, feature :pullreq: 978 - **Date**: 2023-02-03 + **Date**: 2022-10-27 Title: - TODO + AHS 2019 and 2021 data for simulated conditioned floor area Description: Modeled floor area based on AHS 2021 and AHS 2019 - TODO + Use the AHS 2019, 2021 data for the simulated conditioned floor area ResStock arguments. Link to the AHS table used is HERE. For multi-family the ACS multi-family building types were combined using a weighted average where there were enough samples. - Assignees: TODO + Assignees: Tony, Lixi .. change:: - :tags: todo, todo, feature + :tags: characteristics, income, feature :pullreq: 1004 - **Date**: 2023-02-03 + **Date**: 2022-11-09 Title: - TODO + Add AMI + modified tsvs from resstock-estimation refactoring/opt Description: Add area median income - TODO + Using the traditional method of copying files over from resstock-estimation, add AMI and other modified tsvs from a recent set of resstock-estimation PRs refactoring and optimizing tsv_making processes. - Assignees: TODO + resstock-estimation: `pull request 243 `_, `pull request 302 `_, `pull request 304 `_ + + Assignees: Lixi, Tony .. change:: :tags: software, openstudio, feature :pullreq: 1015 - **Date**: 2023-02-03 + **Date**: 2023-02-01 Title: - TODO + Latest OS-HPXML Description: Update to OpenStudio v3.5.1 - TODO + OS 3.5.1 - Assignees: TODO + OpenStudio-HPXML: `pull request 1251 `_ + + Assignees: Joe, Scott .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 828 - **Date**: 2023-02-03 + **Date**: 2022-03-09 Title: - TODO + Changes after switching to ResStock-HPXML Description: Clean up option names for natural ventilation and hot water distribution TODO - Assignees: TODO + resstock-estimation: `pull request 193 `_ + + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, heat pumps, bugfix :pullreq: 833 - **Date**: 2023-02-03 + **Date**: 2022-02-16 Title: - TODO + Remove backup switchover temp for non dual fuel heat pumps Description: Remove the zero degree switchover temperature for heat pump backup heating - TODO + Remove heat_pump_backup_heating_switchover_temp=0.0 for non dual fuel heat pumps. Leave heat_pump_backup_heating_switchover_temp=30.0 for dual fuel heat pumps. - Assignees: TODO + Assignees: Joe, Andrew .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 830 - **Date**: 2023-02-03 + **Date**: 2022-02-14 Title: - TODO + Model finished attics Description: For homes with a finished attic or cathedral ceilings, models a conditioned attic instead of a vented attic - TODO + Change geometry_attic_type=VentedAttic when Geometry Attic Type samples Finished Attic or Cathedral Ceilings. - Assignees: TODO + Assignees: Joe, Andrew .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, mechanics, bugfix :pullreq: 877 - **Date**: 2023-02-03 + **Date**: 2022-04-04 Title: - TODO + Reduce TSV Sizes Description: Reduce housing characteristic file size by relaxing the six digit float format in the housing characteristics - TODO + As housing characteristics get bigger, we are moving to a compact writing style. The 6-digit float format requirement was put in place when most of the characteristics were not scripted. Now that there is a standard workflow for creating the characteristics, the formatting requirements are being relaxed. This change should allow for more accurate characteristic distributions because the exponential format can be used. The change should also stop round-off errors. - Assignees: TODO + resstock-estimation: `pull request 200 `_ + + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, mechanics, bugfix :pullreq: 934 - **Date**: 2023-02-03 + **Date**: 2022-06-02 Title: - TODO + Fix/tsv tags sampling prob etc Description: Fix minor bug in sampling probability calculation TODO - Assignees: TODO + resstock-estimation: `pull request 221 `_ + + Assignees: Lixi, Tony .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, mechanics, bugfix :pullreq: 959 - **Date**: 2023-02-03 + **Date**: 2022-07-09 Title: - TODO + Ll/rename sources Description: Rename sources subfolders so all tsv_makers can be imported as packages - TODO + Rename sources folders so all tsv_makers can be imported as packages. Packages cannot contain names that start with a number. - Assignees: TODO + resstock-estimation: `pull request 238 `_ + + Assignees: Lixi .. change:: - :tags: todo, todo, bugfix + :tags: workflow, setpoints, bugfix :pullreq: 975 - **Date**: 2023-02-03 + **Date**: 2022-08-17 Title: - TODO + Support auto_seasons arguments Description: Fix heating and cooling auto-season inputs - TODO + Looks like OS-HPXML auto_seasons related arguments may have been updated, but ResStockArguments subsequently was not. I believe this was not caught because our testing project does not currently sample any setpoint options which enable the auto_seasons arguments. Assignees: TODO .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, mechanics, bugfix :pullreq: 981 - **Date**: 2023-02-03 + **Date**: 2022-08-22 Title: - TODO + TSV changes from improved low samples handling Description: Remove Void from dependency columns in TSVs and update tests - TODO + Some TSVs have "Option=Void" as one of the available options. The idea behind Void is that certain dependency conditions are structurally impossible. For example, for "HVAC Heating Type and Fuel.tsv", it's impossible that "Heating Fuel" = Electricity and "HVAC Heating Efficiency" = "Fuel Boiler". So, this particular dependency condition get's Void option. - Assignees: TODO + resstock-estimation: `pull request 245 `_ + + Assignees: Rajendra .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, mechanics, bugfix :pullreq: 982 - **Date**: 2023-02-03 + **Date**: 2022-08-26 Title: - TODO + Update join_tsv to use raw source_count Description: Update low-sample downscaling logic to use raw source_weight, which leads to minor changes to Geometry Floor Area and HVAC Partial Space Conditioning - TODO + TSV changes from updating join_distributions_in_order to use raw source_weight (previously, it uses what is now called fallback_weight which artificially increases the weight of undersampled options, thus making it deviate more from the sample truth marginal distributions) - Assignees: TODO + resstock-estimation: `pull request 248 `_ + + Assignees: Lixi, Tony From 861b5f206b584009babc79c8fdca9c9cea394073 Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Tue, 21 May 2024 13:38:19 -0700 Subject: [PATCH 08/21] Update 2_5_0 changelog. [ci skip] --- .../source/changelog/changelog_2_5_0.rst | 677 +++++++++++------- 1 file changed, 405 insertions(+), 272 deletions(-) diff --git a/docs/read_the_docs/source/changelog/changelog_2_5_0.rst b/docs/read_the_docs/source/changelog/changelog_2_5_0.rst index 39f49c831f..e80f46b82c 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_5_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_5_0.rst @@ -10,863 +10,996 @@ v2.5.0 Changelog :tags: software, openstudio, feature :pullreq: 604 - **Date**: 2022-02-09 + **Date**: 2021-07-26 Title: - TODO + OS v3.2.1 (E+ v9.5) Description: Update to OpenStudio v3.3.0 - TODO + Updates to OpenStudio v3.2.1 (EnergyPlus v9.5). - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 439 - **Date**: 2022-02-09 + **Date**: 2021-02-09 Title: - TODO + Single-Unit Geometry Description: Model multifamily and single-family attached buildings as individual dwelling units instead of multiple units representing a building - TODO + Updates geometry measures and various measure resources to model MF and SFA homes as single units. The geometry measures now apply adiabatic boundary conditions to surfaces that would otherwise be shared in the current MF and SFA modeling approaches - Assignees: TODO + Assignees: Andrew .. change:: - :tags: todo, todo, feature + :tags: characteristics, setpoints, feature :pullreq: 541 - **Date**: 2022-02-09 + **Date**: 2021-02-15 Title: - TODO + Vacant Unit Heating Setpoints Description: Reduce vacant unit heating setpoints to 55ºF - TODO + Assign Vacant Unit Heating Setpoints to 55F. The assumption is close to a "don't freeze the pipes" instead of using occupied setpoints. - Assignees: TODO + resstock-estimation: `pull request 96 `_ + + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, climate zones, feature :pullreq: 548 - **Date**: 2022-02-09 + **Date**: 2021-02-18 Title: - TODO + Introduce CEC Climate Zones Description: Introduce a CEC Building Climate Zone tag for samples in California - TODO + This pull requests add the California Energy Commission (CEC) Building Climate Zones into ResStock. A given building sample is tagged with a CEC climate zone (1-16) if the building is in California. If the sample is outside of California the sample is tagged with "None". + + resstock-estimation: `pull request 99 `_ - Assignees: TODO + Assignees: Tony, Eric .. change:: - :tags: todo, todo, feature + :tags: characteristics, lighting, feature :pullreq: 545 - **Date**: 2022-02-09 + **Date**: 2021-02-18 Title: - TODO + Increase LED saturation to 2019 projected values Description: Increase LED saturation to approximately 2019 levels - TODO + LED saturation is one of the fastest-changing technologies. Previously, we estimated that the LED saturation was ~10% based on the 2015 U.S. Lighting Market Characterization. - Assignees: TODO + Assignees: Tony, Eric .. change:: - :tags: todo, todo, feature + :tags: workflow, water heater, feature :pullreq: 483 - **Date**: 2022-02-09 + **Date**: 2021-07-19 Title: - TODO + Water Heater GEB Description: Introduce GEB capabilities for water heaters, including the ability to schedule setpoint and HPWH operating mode - TODO + Adding in new GEB related features, including: + + Allowing tanks to use either a mixed or stratified tank model (additional user argument) + Allowing setpoint to follow an hourly (8760) schedule rather than only fixed values. + Allowing HPWH operating mode to be scheduled (either "HP Only" or "standard"). This allows the elements to be disabled during peak periods. + Adding unmet shower (an unmet load metric for WHs) calculations into ResStock runs to quantify any unmet WH loads. + In addition to these GEB features, a few new HPWH options, corresponding the AO Smith's current product line, are added to options lookup as potential upgrade options. + + resstock-estimation: `pull request 150 `_ - Assignees: TODO + Assignees: Jeff, Joe, Andrew .. change:: - :tags: todo, todo, feature + :tags: characteristics, hvac, feature :pullreq: 551 - **Date**: 2022-02-09 + **Date**: 2021-03-02 Title: - TODO + Room AC Setpoint Dependency Description: Introduce different cooling setpoint distributions for window ACs - TODO + Adds HVAC Cooling Type dependency to Cooling Setpoint.tsv. Cooling type is not queried in RECS, and setpoints are determined the same as before, however the underlying temperature data for Room ACs is reduced by 6F to better align with the 2009 Residential Appliance Saturation Study (RASS). - Assignees: TODO + resstock-estimation: `pull request 96 `_ + + Assignees: Andrew, Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, hvac, feature :pullreq: 549 - **Date**: 2022-02-09 + **Date**: 2021-03-02 Title: - TODO + Zonal Electric Heating Setpoints Description: Include electric zonal heating equipment as a dependency in heating setpoint-related tsvs - TODO + Adds zonal electric heating equipment as a dependency for heating setpoint-related tsvs (Heating Setpoint, Heating Setpoint Offset Period, Heating Setpoint Offset Magnitude and Heating Setpoint Has Offset). Zonal electric heating includes "Built-In Electric Units" and "Portable Electric Heaters" in RECS 2009. Additionally, all weekend daytime heating and cooling setpoint offsets are removed + + resstock-estimation: `pull request 96 `_ - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: workflow, schedules, feature :pullreq: 550 - **Date**: 2022-02-09 + **Date**: 2021-03-04 Title: - TODO + Apply schedule geo-temporal shifting Description: Geo-temporal shifting of the stochastic load model schedules using the American Time Use Survey - TODO + The appliance schedules are shifted based on geography (state), day type(weekday/weekend), and month. + The amount of shift is defined in resources/measures/HPXMLtoOpenStudio/resources/schedules/weekday/state_and_monthly_schedule_shift.csv + and + resources/measures/HPXMLtoOpenStudio/resources/schedules/weekend/state_and_monthly_schedule_shift.csv + files. + + resstock-estimation: `pull request 101 `_ - Assignees: TODO + Assignees: Rajendra .. change:: - :tags: todo, todo, feature + :tags: characteristics, envelope, feature :pullreq: 561 - **Date**: 2022-02-09 + **Date**: 2021-07-09 Title: - TODO + geometry wall type.tsv to create from Lightbox Description: Switch data source for `Geometry Wall Type.tsv` from RECS 2009 to Homeland Infrastructure Foundation-Level Data (HIFLD) Parcel data - TODO + replace existing geometry wall type.tsv with new tsv from Lightbox + add geometry wall exterior finish.tsv from Lightbox + update insulation wall.tsv per new wall type. + update options lookup per new wall type and exterior finish - Assignees: TODO + resstock-estimation: `pull request 109 `_ + + Assignees: Lixi .. change:: - :tags: todo, todo, feature - :pullreq: 556 + :tags: workflow, schedules, feature + :pullreq: 566 - **Date**: 2022-02-09 + **Date**: 2021-04-02 Title: - TODO + Addresses #562, use Schedule:File with plug/fuel loads Description: Use Schedule:File with well pump / vehicle plug loads, as well as gas grill / fireplace / lighting fuel loads. This enables the optional vacancy period to apply to these end uses - TODO + Populate well pump and vehicle plug loads, as well as grill / lighting / fireplace fuel loads, in the schedule csv. Remove weekday / weekend / monthly schedule arguments from ResidentialMiscLargeUncommonLoads measure and the options lookup. Apply vacancy to these plug/fuel loads. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 583 - **Date**: 2022-02-09 + **Date**: 2021-04-29 Title: - TODO + Project yml updates Description: Update example project yaml files to use buildstockbatch input schema version 0.3 - TODO + From schema 0.2 to 0.3. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 585 - **Date**: 2022-02-09 + **Date**: 2021-05-03 Title: - TODO + dst=NA somehow shifted from AZ to AR Description: Update default daylight saving start and end dates to March 12 and November 5, respectively - TODO + AZ counties did not have daylight saving dates set to NA (instead, some AR counties did). This corrects that. + + This PR also updates daylight saving dates from April 7 to October 26 to March 12 through November 5 (current OS-HPXML default values). - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, hvac, feature :pullreq: 586 - **Date**: 2022-02-09 + **Date**: 2021-07-01 Title: - TODO + Replace room-ac performance curves by Cutler curves Description: Switches room air conditioner model to use Cutler performance curves - TODO + Backports: + + Replace room-ac performance curves by Cutler curves OpenStudio-HPXML#698 + Room air conditioner performance curve bugfix OpenStudio-HPXML#701 + Allow CEER efficiency unit for room ac OpenStudio-HPXML#764 - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: characteristics, envelope, feature :pullreq: 558 - **Date**: 2022-02-09 + **Date**: 5/11/221 Title: - TODO + New stories options for MF buildings Description: Remove 3 story limit for multi-family buildings, and instead use RECS data to allow for buildings up to 21 stories - TODO + Removes the artificial cap of 3 stories for MF buildings, and instead uses RECS data to allow for up to 21 stories. Horizontal location and level tsvs were updated to account for the new dependencies. ResidentialGeometryCreateMultifamily was also updated for error checking and to set the Middle-level units at the halfway point. Dependency options in the Window Areas and Geometry Garage tsvs are updated as well. + + resstock-estimation: `pull request 100 `_, `pull request 129 `_ - Assignees: TODO + Assignees: Andrew .. change:: - :tags: todo, todo, feature + :tags: workflow, sampling, feature :pullreq: 584 - **Date**: 2022-02-09 + **Date**: 2021-05-17 Title: - TODO + Enforce running sampling probability script, try 2 Description: Add a sampling probability column in the housing characteristics to define the probability a given column will be sampled - TODO + Add in a column called the sampling_probability to each housing characteristic. The sampling_probability is the probability that a given row in the housing characteristic TSV file is sampled. This value is calculated from the product of the marginal probability of each of the dependency values being sampled for that specific row. For each housing characteristic, the sampling_probability column should sum to 1.0 and have non-negative values. - Assignees: TODO + resstock-estimation: `pull request 127 `_ + + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: characteristics, balancing areas, feature :pullreq: 591 - **Date**: 2022-02-09 + **Date**: 2021-05-21 Title: - TODO + ReEDS Balancing Areas Description: Add ReEDS balancing areas as a spatial field - TODO + This PR adds a TSV for the ReEDS balancing areas. There are 134 balancing areas. The balancing areas are a county mapping provided by the ReEDS team. + + resstock-estimation: `pull request 132 `_ - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: workflow, heat pumps, feature :pullreq: 605 - **Date**: 2022-02-09 + **Date**: 2021-07-13 Title: - TODO + HP defrost control Description: Changes heat pump defrost control from OnDemand to Timed - TODO + Backports NREL/OpenStudio-HPXML#403 - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, feature + :tags: characteristics, bathrooms, feature :pullreq: 601 - **Date**: 2022-02-09 + **Date**: 2021-06-10 Title: - TODO + Number of bathrooms Description: Update number of bathrooms assumption to match the Building America House Simulation Protocols - TODO + This PR makes two changes: + + Updates number of bathrooms to use the BAHSP equation (Nbedrooms/2 + 0.5) and fixes the values used for SFA/MF. + Rounds down the number of bathrooms to the nearest integer for the assumption of number of bath fans. (E.g., a 1.5 bathroom home will now have 1 bath fan instead of 1.5 bath fans.) - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, feature + :tags: workflow, sampling, feature :pullreq: 606 - **Date**: 2022-02-09 + **Date**: 2021-06-04 Title: - TODO + Sampling speed improvement Description: Speed up sampling algorithm by multiple orders of magnitude for large numbers of samples - TODO + Addresses a bottleneck in run_sampling.rb that occurs for large TSVs. - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, feature + :tags: characteristics, lighting, feature :pullreq: 619 - **Date**: 2022-02-09 + **Date**: 2021-06-21 Title: - TODO + Backport ERI lighting calcs from restructure-v3 Description: Use ANSI/RESNET/ICC 301 equations to calculate annual interior, exterior, and garage lighting energy - TODO + Backports the Energy Rating Index equations used to calculate interior, exterior, and garage lighting on https://github.com/NREL/resstock/tree/restructure-v3 - Assignees: TODO + Assignees: Andrew .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 559 - **Date**: 2022-02-09 + **Date**: 2021-06-29 Title: - TODO + ResStock-HPXML: Apply tsv files to develop branch Description: Update tsv files for both the national and testing projects. Supports transition to ResStock-HPXML - TODO + ResStock-HPXML: Apply tsv files to develop branch - Assignees: TODO + resstock-estimation: `pull request 136 `_ + + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, cost multipliers, feature :pullreq: 634 - **Date**: 2022-02-09 + **Date**: 2021-07-08 Title: - TODO + Duct cost multiplier - unconditioned area Description: Changes "Duct Surface Area (ft^2)" cost multiplier to "Duct Unconditioned Surface Area (ft^2)" - TODO + Converts "Duct Surface Area (ft^2)" cost multiplier to "Duct Unconditioned Surface Area (ft^2)". Provides consistency w/ ResStock-HPXML. Follow-up to #532. + + Only buildings where the primary duct location is living space or finished basement are affected; they now return zero (instead of non-zero) values for the cost multiplier. - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, feature + :tags: characteristics, windows, feature :pullreq: 615 - **Date**: 2022-02-09 + **Date**: 2021-07-21 Title: - TODO + Add more descriptive window options Description: Update window type distributions using RECS 2015. Includes additional of frame material types (RECS 2015) and presence of storm windows (D&R International) - TODO + The previous limited description of windows caused a lack of variation in U-value and solar gains for windows + + resstock-estimation: `pull request 140 `_ - Assignees: TODO + Assignees: Elaina, Tony, Prateek .. change:: - :tags: todo, todo, feature + :tags: characteristics, windows, feature :pullreq: 649 - **Date**: 2022-02-09 + **Date**: 2021-07-27 Title: - TODO + Adjust interior shading assumptions Description: Reduces window interior shading during Winter to match ANSI/RESNET/ICC 301 assumption - TODO + Changes to winter interior shading factor = 85% instead of 70%, per ANSI/RESNET/ICC 301 Standard. - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, feature + :tags: characteristics, ceiling fan, feature :pullreq: 652 - **Date**: 2022-02-09 + **Date**: 2021-07-27 Title: - TODO + Update ceiling fan model Description: Updates ceiling fan model based on ANSI/RESNET ICC 301 assumptions - TODO + Backports the ceiling fan model from OS-HPXML, which is based on ANSI/RESNET/ICC 301. - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, feature + :tags: characteristics, infiltration, feature :pullreq: 670 - **Date**: 2022-02-09 + **Date**: 2021-08-04 Title: - TODO + Update infiltration Description: Updates infiltration model pressure coefficient - TODO + Changes the pressure coefficient from 0.67 to 0.65 for consistency with OS-HPXML. Also updates a water heater option's flue input to be consistent with the OS-HPXML default logic. - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, feature + :tags: characteristics, mechanical ventilation, feature :pullreq: 675 - **Date**: 2022-02-09 + **Date**: 2021-08-19 Title: - TODO + Update mechanical ventilation Description: Updates mechanical ventilation options/model to ASHRAE 62.2-2019 and adds a "Flow Rate, Mechanical Ventilation (cfm)" output - TODO + Updates mechanical ventilation to ASHRAE 62.2-2019. This affects both the Qfan requirement for a mechanical ventilation system as well as how mechanical ventilation interacts with infiltration on a timestep basis. Also adds a 'Flow Rate, Mechanical Ventilation (cfm)' cost multiplier. - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, feature + :tags: characteristics, pv, feature :pullreq: 673 - **Date**: 2022-02-09 + **Date**: 2021-08-25 Title: - TODO + add PV distributions Description: Add PV ownership and PV system size distributions using 2019 Tracking the Sun and GTM report on solar installation - TODO + This PR introduces PV systems into ResStock. - Assignees: TODO + Assignees: Lixi .. change:: - :tags: todo, todo, feature + :tags: workflow, climate zones, feature :pullreq: 764 - **Date**: 2022-02-09 + **Date**: 2021-11-08 Title: - TODO + IECC Zone argument for ResidentialLocation Description: Add optional argument to ResidentialLocation measure for setting the IECC climate zone - TODO + Backport water heater location logic (based on IECC zone) - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: characteristics, envelope, feature :pullreq: 759 - **Date**: 2022-02-09 + **Date**: 2021-11-17 Title: - TODO + add geometry_story_bin, add story_bin as dependency to geometry_wall_… Description: Add Geometry Story Bin tsv and Geometry Story Bin dependency to Geometry Wall Type - TODO + Resolves: + + #[https://github.com/Missing building height dependency in Geometry Wall Type resstock-estimation#175] + #[https://github.com/Higher than expected brick %s in wall type in recent vintages resstock-estimation#145] - reverting fix for high brick %s in newer vintages + + resstock-estimation: `pull request 177 `_ - Assignees: TODO + Assignees: Lixi .. change:: - :tags: todo, todo, feature - :pullreq: 661, 818 + :tags: workflow, mechanics, feature + :pullreq: 661 - **Date**: 2022-02-09 + **Date**: 2021-08-16 Title: - TODO + Clean up ServerDirectoryCleanup measure Description: Add arguments to the ServerDirectoryCleanup measure for controlling deletion of files in the run folder - TODO + Update this measure to have arguments for including/excluding files in the run directory. Would need to update the buildstockbatch workflow generator to accommodate this. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, feature + :pullreq: 818 + + **Date**: 2022-02-02 + + Title: + ServerDirectoryCleanup debug argument + + Description: + Add arguments to the ServerDirectoryCleanup measure for controlling deletion of files in the run folder + Setting to true would set all "retain" arguments to true. + + Assignees: Joe + + + .. change:: + :tags: workflow, mechanics, bugfix :pullreq: 543 - **Date**: 2022-02-09 + **Date**: 2021-02-09 Title: - TODO + Speed up TSV fetching Description: Fixes significant runtime bottleneck in TSV fetching in BuildExistingModel & ApplyUpgrade measures - TODO + A bug in the buildstock.rb get_measure_args_from_option_names() method was causing the entirety of every TSV to be processed even when the option(s) of interest had already been found. As the number and length of TSVs has grown, so has this bottleneck. - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, envelope, bugfix :pullreq: 553 - **Date**: 2022-02-09 + **Date**: 2021-03-08 Title: - TODO + Bug Fix: Too many bedrooms for small units Description: Dwelling units that are 0-499 ft2 are limited to a maximum of 2 bedrooms - TODO + This pull request updates the number of bedrooms for small units. - Assignees: TODO + resstock-estimation: `pull request 104 `_ + + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 556 - **Date**: 2022-02-09 + **Date**: 2021-03-16 Title: - TODO + Addresses #555, unfinished attic floor material layers are reversed Description: Reverses the material layers of the unfinished attic floor construction so that they are correctly ordered outside-to-inside - TODO + Unfinished attic floor material layers are reversed - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 560 - **Date**: 2022-02-09 + **Date**: 2021-03-25 Title: - TODO + Bugfix/invalid geometry garage size Description: Fixes invalid garage and living space dimension errors - TODO + The geometry measure is throwing an error due to garage sizes compared to the conditioned space size. We believe the error is due to the tucked garage is larger than either the depth or width of the first floor of the single-family detached unit. + + resstock-estimation: `pull request 106 `_ - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: workflow, heat pumps, bugfix :pullreq: 564 - **Date**: 2022-02-09 + **Date**: 2021-03-26 Title: - TODO + Fix the supplimental capacity to autosize and reorder for efficiency Description: Set all mini-split heat pump supplemental capacity to autosize - TODO + Make sure all the HVAC Heating Efficiency; MSHP options have the ResidentialHVACMiniSplitHeatPump argument supplemental_capacity=autosize. + + Reorder MSHP options based on efficiency. + + Assignees: Tony + + + .. change:: + :tags: workflow, schedules, bugfix + :pullreq: 571 + + **Date**: 2021-04-08 - Assignees: TODO + Title: + Faster stochastic schedules + + Description: + Reduce stochastic schedule generation runtime by over 50% + Related to NREL/OpenStudio-HPXML#697. + + ScheduleGenerator.create: + + develop: ~34 s + faster-schedules: ~10 s + + Assignees: Joe .. change:: - :tags: todo, todo, bugfix - :pullreq: 571, 577 + :tags: workflow, schedules, bugfix + :pullreq: 577 - **Date**: 2022-02-09 + **Date**: 2021-04-16 Title: - TODO + Faster stochastic schedules, second pass Description: Reduce stochastic schedule generation runtime by over 50% - TODO + Related to NREL/OpenStudio-HPXML#706. + + ScheduleGenerator.create: + + develop: ~10 s + faster-schedules2: ~7 s - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, sampling, bugfix :pullreq: 568 - **Date**: 2022-02-09 + **Date**: 2021-04-14 Title: - TODO + Fix Heating Type = Void showing up in buildstock.csv Description: Fixes the problem that `Heating Type=Void` is showing up in buildstock samples - TODO + Fixes the problem that Heating Type=Void is showing up in buildstock samples. - Assignees: TODO + resstock-estimation: `pull request 123 `_ + + Assignees: Lixi .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 585 - **Date**: 2022-02-09 + **Date**: 2021-05-02 Title: - TODO + dst=NA somehow shifted from AZ to AR Description: Set AZ counties to NA daylight saving times instead of some AR counties - TODO + AZ counties did not have daylight saving dates set to NA (instead, some AR counties did). This corrects that - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, sampling, bugfix :pullreq: 592 - **Date**: 2022-02-09 + **Date**: 2021-05-27 Title: - TODO + Housing Characteristic Fixes Description: Housing characteristics fixes based on more samples in testing - TODO + project_national + Add Geometry Attic Type.tsv + Ensure assumptions are consistent for 5 to 9 unit buildings and their number of units. The assumption was added that 5 to 9 unit buildings cannot be >10 stories was not transparent in Geometry Building Number Units MF.tsv, but is enforced in Geometry Stories. The sampling_probability is 0, so the option values are set to "Option=None". + Add Geometry Attic Type as a dependency in Insulation Unfinished Attic.tsv + Script Roof Material Finished Roof.tsv and Roof Material Unfinished Attic.tsv. + project_testing + Add Geometry Attic Type.tsv + Add Geometry Attic Type as a dependency in Insulation Unfinished Attic.tsv + Script Roof Material Finished Roof.tsv and Roof Material Unfinished Attic.tsv. + Add Geometry Attic Type as a dependency to Roof Material Finished Roof.tsv and Roof Material Unfinished Attic.tsv. + Add Geometry Stories as a dependency for Geometry Building Number Units MF.tsv + Pier and Beam Foundations cannot have garages + Add HVAC Cooling Type as a dependency to HVAC Cooling Efficiency.tsv + + resstock-estimation: `pull request 134 `_ - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, windows, bugfix :pullreq: 597 - **Date**: 2022-02-09 + **Date**: 2021-07-14 Title: - TODO + WWR calculation for facades w/ doors Description: Fixes window-to-wall ratio calculation for facades with doors - TODO + Fixes window-to-wall ratio calculation for facades with doors. Previously if a facade had a door, the WWR would be applied to the net wall area instead of gross wall area. Added a unit test that demonstrates the fix -- previously the front window area was 95.6 ft2, now it's 100 ft2 and matches the results from ResStock-HPXML. - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, bathrooms, bugfix :pullreq: 601 - **Date**: 2022-02-09 + **Date**: 2021-06-10 Title: - TODO + Number of bathrooms Description: Fixes number of bathrooms for single-family attached and multi-family buildings - TODO + This PR makes two changes: + + Updates number of bathrooms to use the BAHSP equation (Nbedrooms/2 + 0.5) and fixes the values used for SFA/MF. + Rounds down the number of bathrooms to the nearest integer for the assumption of number of bath fans. (E.g., a 1.5 bathroom home will now have 1 bath fan instead of 1.5 bath fans.) - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, mechanics, bugfix :pullreq: 609 - **Date**: 2022-02-09 + **Date**: 2021-06-10 Title: - TODO + Update sampling_probabilty column based on bug in tsv_dist Description: Sync the sample probabilities after a bug fix in tsv_dist - TODO + The tsv_dist function was updated in the EULP-uncertainty-quantification PR #27. This update was due to a bug in identifying dependency intersections. As a result, the sample_probability column has updated for many housing characteristics. + + resstock-estimation: `pull request 142 `_ - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, balancing areas, bugfix :pullreq: 613 - **Date**: 2022-02-09 + **Date**: 2021-06-18 Title: - TODO + Rename ReEDS to REEDS Description: Fix name of ReEDS balancing areas - TODO + In the results.csv the ReEDS column gets interpreted as re_eds which makes the column hard to search for. Even though "ReEDS" is correct, it was decided that the TSV name will be "REEDS". - Assignees: TODO + resstock-estimation: `pull request 143 `_ + + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 653 - **Date**: 2022-02-09 + **Date**: 2021-07-27 Title: - TODO + Hot water recirc pump bugfix, take 2 Description: Fixes hot water distribution internal gains not being zeroed out during vacancies - TODO + Follow-up to #646. It turns out that the recirculation pump was correctly reflecting the vacancy status for a unit, so that code is reverting. While making the change, I noticed that the internal gains associated with the hot water distribution system were not being zeroed out for vacant units, so that is fixed here too - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, bugfix + :tags: workflow, cost multipliers, bugfix :pullreq: 674 - **Date**: 2022-02-09 + **Date**: 2021-08-05 Title: - TODO + Exclude corridor doors in door area cost multiplier Description: Exclude adiabatic doors when outputting the door area cost multiplier - TODO + Backports approach used by OS-HPXML, in which adiabatic doors are not included in the door area cost multiplier output. - Assignees: TODO + Assignees: Andrew .. change:: - :tags: todo, todo, bugfix + :tags: workflow, hvac, bugfix :pullreq: 694 - **Date**: 2022-02-09 + **Date**: 2021-08-31 Title: - TODO + Disaggregate fan coil fan energy use Description: Disaggregate the shared fan coil's fan energy use into heating and cooling - TODO + Was previously all lumped into ElectricityFansCooling with a FIXME. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, unmet hours, bugfix :pullreq: 700 - **Date**: 2022-02-09 + **Date**: 2021-09-03 Title: - TODO + Fix unmet hours Description: Fixes hours setpoint not met output to exclude A) no heating and/or cooling equipment and B) finished basements - TODO + Excludes reported unmet hours for A) no heating and/or cooling equipment and B) finished basements. - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, envelope, bugfix :pullreq: 759 - **Date**: 2022-02-09 + **Date**: 2021-11-17 Title: - TODO + add geometry_story_bin, add story_bin as dependency to geometry_wall_… Description: Revert wall type constraint that assumes all brick facades built >1960 are wood-framed with 4" face brick. Also add constraint to force all buildings > 8 stories to have steel-framed wall type - TODO + Resolves: + + #[https://github.com/Missing building height dependency in Geometry Wall Type resstock-estimation#175] + #[https://github.com/Higher than expected brick %s in wall type in recent vintages resstock-estimation#145] - reverting fix for high brick %s in newer vintages + + resstock-estimation: `pull request 177 `_ - Assignees: TODO + Assignees: Lixi .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, envelope, bugfix :pullreq: 789 - **Date**: 2022-02-09 + **Date**: 2022-01-18 Title: - TODO + Backport material properties from ResStock-HPXML Description: Fixes for wall constructions: remove wood sheathing on CMU and brick walls; better data for exterior finish absorptances and wall densities - TODO + Update exterior finish absorptance and wall density values to align with ResStock-HPXML values. Also removes sheathing layer from CMU and brick wall types. - Assignees: TODO + Assignees: Andrew .. change:: - :tags: todo, todo, bugfix + :tags: workflow, solar hot water, bugfix :pullreq: 809 - **Date**: 2022-02-09 + **Date**: 2022-01-27 Title: - TODO + Backport unit conversion bugfixes for solar hot model from OS-HPXML Description: Fixes unit conversion bugs in solar hot water model - TODO + Backport unit conversion bugfixes for solar hot model from OS-HPXML - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 821 - **Date**: 2022-02-09 + **Date**: 2022-02-03 Title: - TODO + Update national project YAMLs with unit counts from ACS 2019 5-year Description: Update the number of units represented in the national project YAML files to the American Community Survey 2019 5-year estimate - TODO + In the YAML files, the n_buildings_represented was 110,000,000. This estimate is a bit low compared to the ACS 2019 5-year estimate of 136,569,411. + + This PR updates the YAML files to include the ACS 2019 5-year estimate of the number of housing units. - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 817 - **Date**: 2022-02-09 + **Date**: 2022-02-03 Title: - TODO + Finished Roof Bugfix Description: Properly apply roof insulation when the attic type is Finished Attic or Cathedral Ceilings - TODO + Insulation Roof options are not applying insulation correctly because attic spaces are modeled as unfinished, and no applicable surfaces are found in the ResidentialConstructionsFinishedRoof measure. This PR applies roof insulation via the ResidentialConstructionsUnfinishedAttic instead. + + This keeps attic spaces modeled as unfinished, correctly applies insulation, and better aligns with the resstock-hpxml attic construction. - Assignees: TODO + Assignees: Andrew From d1f2d9113decbee750978cd22e34b3892e207cf1 Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Tue, 21 May 2024 14:15:39 -0700 Subject: [PATCH 09/21] Update 2_4_0 changelog. [ci skip] --- .../source/changelog/changelog_2_4_0.rst | 346 ++++++++++-------- 1 file changed, 190 insertions(+), 156 deletions(-) diff --git a/docs/read_the_docs/source/changelog/changelog_2_4_0.rst b/docs/read_the_docs/source/changelog/changelog_2_4_0.rst index 2c05ede5d4..88bcab7d43 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_4_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_4_0.rst @@ -7,498 +7,532 @@ v2.4.0 Changelog :released: 2021-01-27 .. change:: - :tags: todo, todo, feature - :pullreq: 458 + :tags: workflow, quantities of interest, feature + :pullreq: 460 - **Date**: 2021-01-27 + **Date**: 2020-07-08 Title: - TODO + Report peak kw Description: Report the annual peak use and timing using the quantities of interest measure - TODO + Report peak use and timing using the QOIReport measure. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, schedules, feature :pullreq: 348 - **Date**: 2021-01-27 + **Date**: 2020-07-16 Title: - TODO + Generate schedule csv on the fly and use Schedule:File objects on its columns Description: Major change to most occupant-related schedules. Occupant activities are now generated on-the-fly and saved to .csv files used by Schedule:File objects. Schedules are generated using time-inhomogenous Markov chains derived from American Time Use Survey data, supplemented with sampling duration and power level from NEEA RBSA data, as well as DHW draw duration and flow rate data from Aquacraft/AWWA data [(see pre-print for details)](https://arxiv.org/abs/2111.01881) - TODO + The Stochastic Occupancy Modelling introduces major change to most occupant-related schedules. Occupant activities are now generated on-the-fly and saved to .csv files used by Schedule:File objects. Schedules are generated using time-inhomogenous Markov chains derived from American Time Use Survey data, supplemented with sampling duration and power level from NEEA RBSA data, as well as DHW draw duration and flow rate data from Aquacraft/AWWA data. - Assignees: TODO + Assignees: Joe, Rajendra .. change:: - :tags: todo, todo, feature + :tags: characteristics, setpoints, feature :pullreq: 468 - **Date**: 2021-01-27 + **Date**: 2020-08-10 Title: - TODO + Update Setpoint and Setpoint Schedule Distributions Description: Update the dependencies for heating and cooling setpoint tsvs (Setpoint, Has Offset, Offset Magnitude, and Offset Period) to IECC climate zone - TODO + Updates the thermostat heating and cooling setpoint distributions (setpoint, has offset, offset magnitude, offset schedule) to be dependent on IECC climate zone instead of AIA zone. - Assignees: TODO + Assignees: Andrew .. change:: - :tags: todo, todo, feature + :tags: characteristics, vacancy, feature :pullreq: 473 - **Date**: 2021-01-27 + **Date**: 2020-08-17 Title: - TODO + Introduce Vacant Units Description: Distinguish between vacant and occupied dwelling units using PUMS data - TODO + The purpose of the pull request is to introduce vacant units into the residential stock. This work was motivated by the following maps that shows the fraction of vacant units by building type and PUMA. - Assignees: TODO + resstock-estimation: `pull request 36 `_ + + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, heating fuel, feature :pullreq: 474 - **Date**: 2021-01-27 + **Date**: 2020-08-10 Title: - TODO + Feature/heating fuel puma Description: Update heating fuel distributions to be by Public Use Microdata Area (PUMA) rather than State - TODO + This pull request modifies the state level description of Heating Fuel type to PUMA. See the graphics below for modifications of heating fuel types. The data is based on PUMS 5-yr 2016, and for sample sizes that are less than 10, the state average is used. + + resstock-estimation: `pull request 49 `_ - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, mechanics, feature :pullreq: 478 - **Date**: 2021-01-27 + **Date**: 2020-09-09 Title: - TODO + HVAC tsv restructuring Description: Restructure HVAC housing characteristics to 1) simplify the structure, 2) allow for integrating more local data sources, 3) update reference years for HVAC and refrigerator ages and efficiencies from 2009 to 2018, 4) add assumption comments to all HVAC-related housing characteristics, 5) improve Room AC efficiency distributions using ENERGY STAR saturation data, and 6) fix some incorrect assignment of Option=None heating systems - TODO + We have an inordinate number of tsvs presently describing the hvac systems in OpenStudio-BuildStock. This PR reorders and merges existing hvac tsvs while preserving the necessary interactions. The major changes to structure are to move from multiple heating fuel-specific efficiency TSV files to a single TSV for heating efficiencies. The "Is Heat Pump" TSV is also expanded to include ducted/non-ducted options for use as an interim dependency. + + resstock-estimation: `pull request 32 `_ - Assignees: TODO + Assignees: Tobi, Eric .. change:: - :tags: todo, todo, feature + :tags: workflow, envelope, feature :pullreq: 485 - **Date**: 2021-01-27 + **Date**: 2020-09-23 Title: - TODO + Roofing material options and tsvs updates Description: Increase roofing material options; update roofing material tsv files to include these new options - TODO + Expand roof material options and update related tsv files. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: characteristics, envelope, feature :pullreq: 492 - **Date**: 2021-01-27 + **Date**: 2020-11-10 Title: - TODO + Update Geometry Foundation Type to be Based on RECS Description: Update foundation type from the [Building Foundation Design Handbook](https://www.osti.gov/biblio/6980439-building-foundation-design-handbook) published in 1988 to RECS 2009 - TODO + This pull request updates the Geometry Foundation Type.tsv from the "Building Foundation Design Handbook" published in 1988 to RECS 2009. The new TSV has dependencies on IECC Climate and Moisture regions and Vintage ACS. - Assignees: TODO + resstock-estimation: `pull request 63 `_, `pull request 73 `_ + + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 507 - **Date**: 2021-01-27 + **Date**: 2020-11-13 Title: - TODO + ResStock/ComStock weather syncronization Description: Synchronize weather between ResStock and ComStock which increases the number of weather stations from 215 to 941 - TODO + This pull request synchronizes the weather files for both ResStock and ComStock. Currently, ResStock uses 215 weather regions defined by county. ComStock uses 941 weather files also defined by county. For applications (especially GEB applications) where combined results from ResStock and ComStock are desired, it is important that the residential and commercial models use the same weather data. This way both residential and commercial models respond to hot days, cold days, rainy days together to predict more accurate combined loads. + + resstock-estimation: `pull request 58 `_ - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, occupants, feature :pullreq: 509 - **Date**: 2021-01-27 + **Date**: 2020-11-16 Title: - TODO + Number of occupants based on PUMS Description: Update Occupants per unit from RECS 2015 to PUMS 5-yr 2017 - TODO + This pull request updates the number of occupants (that gets passed into the stochastic load generator) from RECS 2015 to PUMS 5-yr 2017. The switch to PUMS allows PUMA level spatial granularity in the distributions and leverages more than 6 million samples. - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, plug loads, feature :pullreq: 471 - **Date**: 2021-01-27 + **Date**: 2020-08-11 Title: - TODO + Separate plug load equations for SFD, SFA, MF Description: Based on RECS 2015, separate the plug load equations for single-family detached, single-family attached, and multifamily buildings - TODO + Using RECS 2015 a multilinear regression is performed to determine the annual MELS for ResStock. The dependent variables are the number of occupants (noccupants) and the finished floor area (ffa) of the dwelling unit. The MELS definition is a combination of microwave, television, humidifiers, and other devices. The RECS fields for these variables are KWHMICRO, KWHTVREL, KWHHUM, and KWHNEC, respectively. + + resstock-estimation: `pull request 45 `_ - Assignees: TODO + Assignees: Joe, Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, plug loads, feature :pullreq: 511 - **Date**: 2021-01-27 + **Date**: 2020-11-22 Title: - TODO + Multiplier updates to plug load measure Description: Allow for plug load energy consumption to vary by Census Division and include additional "diversity" multiplier in plug load equations - TODO + This pull request separates out multipliers meant to adjust total energy and multipliers meant to adjust diversity of the results. The ResidentialMiscPlugLoads argument mult has been split into two multipliers (energy_mult and diversity_mult). + + The energy multiplier now allows the plug load energy use to vary with building type and RECS 2015 definition of Census Division (the Mountain division is split into North and South). + + The diversity_mult argument is simply the same as the previous definition of mult. - Assignees: TODO + resstock-estimation: `pull request 86 `_ + + Assignees: Joe, Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, lighting, feature :pullreq: 510 - **Date**: 2021-01-27 + **Date**: 2020-11-22 Title: - TODO + Add spatial and building type dependencies to lighting saturations Description: Lighting saturations based on RECS 2015 with new building type and spatial dependencies - TODO + This pull request updates the Lighting.tsv to include dependencies on building type and RECS 2015 definition of Census Division. The RECS 2015 definition of Census division is similar to the U.S. Census definition, except RECS breaks out the Mountain Census Division into a North and South Subdivision. + + resstock-estimation: `pull request 84 `_ - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, water heater, feature :pullreq: 513 - **Date**: 2021-01-27 + **Date**: 2020-12-10 Title: - TODO + Feature/water heater update Description: Introduce premium water heaters and heat pump water heaters into building stock, differentiate between central and in-unit water heating, and split water heater fuel and efficiency into different housing characteristics - TODO + This pull request updates the water heater housing characteristics. + + resstock-estimation: `pull request 87 `_ - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: workflow, heat pumps, feature :pullreq: 512 - **Date**: 2021-01-27 + **Date**: 2021-01-07 Title: - TODO + Report supplemental electric heating Description: Separate heat pump electric supplemental heating from total electric heating in output reporting - TODO + Break "supplemental electric heating" out of "electric heating". + + This is important for heat pump analysis. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, ducts, feature :pullreq: 532 - **Date**: 2021-01-27 + **Date**: 2021-01-13 Title: - TODO + Update duct related calcs in airflow.rb Description: Update the duct leakage "total" to "to outside" conversion to be based on ASHRAE Standard 152 - TODO + Addresses https://trello.com/c/VmcGehGM/62-duct-leakage-total. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 525 - **Date**: 2021-01-27 + **Date**: 2021-01-20 Title: - TODO + Feature/weather infrastructure Description: Allow for flexible weather regions based on weather data available and introduce TMY3 weather files for the new weather format - TODO + This PR generalizes the weather data available for a given AMY or TMY analysis. ResStock currently uses 941 static weather stations. The stations are used based on the Location.tsv. - Assignees: TODO + resstock-estimation: `pull request 95 `_ + + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: workflow, schedules, bugfix :pullreq: 477 - **Date**: 2021-01-27 + **Date**: 2020-08-13 Title: - TODO + Addresses #476, appliance design levels fluctuate between runs Description: Fix for pseudo-random number generator that was generating non-deterministic occupancy schedules - TODO + Fixes an issue with sampling an integer without using the pseudo-random number generator seed. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 480 - **Date**: 2021-01-27 + **Date**: 2020-08-18 Title: - TODO + Addresses #479, garage zone infiltration not always added to model Description: Iterate all spaces in a thermal zone when checking for zone type; fixes missing infiltration for protruding garages in 1-story homes - TODO + For 1-story, SFD homes with protruding garages, we expect an effective leakage area object added to the model for the garage and garage attic spaces, as shown below. However, these only get added about half of the time. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, vacancy, bugfix :pullreq: 486 - **Date**: 2021-01-27 + **Date**: 2020-09-24 Title: - TODO + Fix/vacant units Description: Update spatial distribution of units based on total dwelling unit counts rather than occupied unit counts - TODO + After talking with @TobiAdekanye, we realized that the spatial distribution of dwelling units are based on only the occupied dwelling units. When the vacant units were pulled into ResStock, the TSV creation functions in sources/spatial/tsv_maker.py in the resstock-estimation repository should have been updated to acs_count instead of acs_occupied_count. This was an oversight when I merged in the Vacant Units. + + resstock-estimation: `pull request 56 `_ - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: mechanics, envelope, bugfix :pullreq: 496 - **Date**: 2021-01-27 + **Date**: 2020-10-07 Title: - TODO + Update partition wall area calculation for MF and SFA buildings Description: Exclude existing shared walls when calculating the partition wall area of MF and SFA buildings - TODO + Updates how partition wall surface area is calculated so that shared walls in MF and SFA buildings do not count as existing partition wall mass. This means that MF and SFA building partition walls are now calculated the same as SFD buildings - as a direct proportion of the finished floor area. - Assignees: TODO + Assignees: Andrew .. change:: - :tags: todo, todo, bugfix + :tags: workflow, internal gains, bugfix :pullreq: 501 - **Date**: 2021-01-27 + **Date**: 2020-10-27 Title: - TODO + Internal gain calcs for sizing updates/fixes Description: For the purpose of calculating cooling and dehumidification loads for HVAC sizing, use simple internal gains equation from ANSI/RESNET/ICC 301 (consistent with HPXML workflow); this fixes a bug introduced in [#348](https://github.com/NREL/resstock/pull/348) that caused cooling capacities to be ~3x larger than they should be - TODO + Updates to be consistent with how the hpxml workflow processes internal gains. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, climate zones, bugfix :pullreq: 497 - **Date**: 2021-01-27 + **Date**: 2020-11-10 Title: - TODO + Add IECC zone dependency to HVAC Cooling Type and some minor heat pump fixes Description: Reintroduce IECC climate zone dependency to HVAC Cooling Type and some heat pump fixes - TODO + Addresses #64 by adding IECC zone as a dependency. Lumping some of the other dependencies to bring up sample sizes. Increased from ~47% to 60% rows with fewer than 10 samples, but overall I think it is a net improvement. + + resstock-estimation: `pull request 67 `_ - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: workflow, appliances, bugfix :pullreq: 504 - **Date**: 2021-01-27 + **Date**: 2020-11-22 Title: - TODO + Add monthly multiplier for cooking, clothes washer, clothes dryer, and dishwasher Description: Reintroduce monthly multipliers with stochastic load model for dishwasher, clothes washer and clothes dryer and cooking - TODO + The cooking schedule was previously (before the ResidentialScheduleGenerator was introduced) generated using weekend, weekday, and monthly multiplier schedule. Currently, they are generated using the Markov-chain by the ResidentialScheduleGenerator. This pull request adds monthly multipliers to the schedule so generated. - Assignees: TODO + Assignees: Rajendra .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 518 - **Date**: 2021-01-27 + **Date**: 2020-12-10 Title: - TODO + Account for collapsed units when determining geometry variables for infiltration calculation Description: Account for collapsed units when determining geometry variables (building floor/wall area and volume) in infiltration calculations; add airflow unit tests - TODO + Fixes how geometry variables (building ffa, building volume, and building exterior wall area) are calculated in the Airflow.rb measure when minimal_collapsed == True. The "collapsed" units were not originally accounted for when determining these variables, influencing the calculated leakage area at each unit. This changes the infiltration and HVAC sizing in SFA buildings, and most likely MF buildings as well. - Assignees: TODO + Assignees: Andrew .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 523 - **Date**: 2021-01-27 + **Date**: 2020-12-23 Title: - TODO + Fix surface area reporting for collapsed buildings Description: Fix for calculating door and below-grade wall area of multifamily and single-family attached buildings with collapsed geometries - TODO + Fixes below grade wall and door area calculations in SimulationOutputReport when minimal_collapsed = true for MF and SFA buildings. Previously, units_represented was not used to scale foundation wall or door area, and therefore areas were underestimated when building geometries were collapsed. - Assignees: TODO + Assignees: Andrew .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, mechanics, bugfix :pullreq: 522 - **Date**: 2021-01-27 + **Date**: 2021-01-07 Title: - TODO + Fix: All buildings have double-loaded corridors Description: In the Corridor.tsv, assign single-family attached, single-family detached, and mobile homes with a "Not Applicable" option - TODO + In the project_national/housing_characteristics/Corridor.tsv, all buildings are assigned a "Double-Loaded Corridor." However, the single-family detached, mobile homes, and single-family attached buildings do not have corridors. For single-family detached, mobile homes, and single-family attached buildings, measures/BuildExistingModel/measure.rb removes the calls to the ResidentialGeometryCreateMultifamily measure. - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: workflow, vacancy, bugfix :pullreq: 527 - **Date**: 2021-01-27 + **Date**: 2021-01-07 Title: - TODO + Make sure vacant units have zero ceiling fan energy Description: Remove ceiling fan energy for vacant units - TODO + Vacant units currently have ceiling fan energy. This PR introduces an option where the ceiling fan energy is zero. The ratio of ceiling fans is kept the same, so 72% of units have ceiling fans for either occupied or vacant units. This ensures the counts of ceiling fans are consistent, but vacant units have no ceiling fan energy. - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: workflow, weather, bugfix :pullreq: 528 - **Date**: 2021-01-27 + **Date**: 2021-01-11 Title: - TODO + Change to UTC time calculations to avoid DST messing things up Description: Fix bug related to incorrect timestamps when using AMY weather file - TODO + Resolves the issue of timestamps being incorrect around the DST switchover time when using AMY weather files. - Assignees: TODO + Assignees: Rajendra .. change:: - :tags: todo, todo, bugfix + :tags: workflow, weather, bugfix :pullreq: 530 - **Date**: 2021-01-27 + **Date**: 2021-01-20 Title: - TODO + Bugfix for DST start hour and end date. Description: Fix DST start hour error and end date error - TODO + The PR fixes 2 issues with the current calculation of DST time column. + + Currently, DST spring forward occurs at 1:00 AM standard time. The time jumps from 0:59 to 2:00. It should jump from 1:59 to 3:00 instead. This fixes the problem. + The DST end date is currently one day behind what's specified in the options_lookup or weather file. This PR also fixes that. + The clocks are supposed to shift back by one hour at 2:00 AM on the same date as DST end date. See https://www.timeanddate.com/time/change/usa. - Assignees: TODO + Assignees: Rajendra .. change:: - :tags: todo, todo, bugfix + :tags: workflow, envelope, bugfix :pullreq: 537 - **Date**: 2021-01-27 + **Date**: 2021-01-26 Title: - TODO + Fix: Effective R Value Calculation for HVAC Sizing Description: Calculate slab surface effective R values used in HVAC sizing with unit-level variables - TODO + Fixes how the effective R value of a slab is calculated for use in the HVAC sizing measure. The effective R values were previously calculated use the slab area of the entire building footprint and the exposed perimeter of the individual unit, causing the R value to scale incorrectly with larger buildings. This calculates the R value using variables specific to the unit, not the building. - Assignees: TODO + Assignees: Andrew From 59e6123d903257c550595141ce829965a6559210 Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Tue, 21 May 2024 15:11:38 -0700 Subject: [PATCH 10/21] Update 2_3_0 changelog. [ci skip] --- .../source/changelog/changelog_2_3_0.rst | 318 ++++++++++-------- 1 file changed, 178 insertions(+), 140 deletions(-) diff --git a/docs/read_the_docs/source/changelog/changelog_2_3_0.rst b/docs/read_the_docs/source/changelog/changelog_2_3_0.rst index ace2e76af5..1dbfcb2c99 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_3_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_3_0.rst @@ -7,450 +7,488 @@ v2.3.0 Changelog :released: 2020-06-24 .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 402 - **Date**: 2020-06-24 + **Date**: 2020-02-17 Title: - TODO + Remove single-family detached, PAT projects Description: Remove the single-family detached project, and remove PAT from the testing and multifamily projects - TODO + Remove single-family detached, PAT projects - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: characteristics, mechanics, feature :pullreq: 401 - **Date**: 2020-06-24 + **Date**: 2020-02-17 Title: - TODO + Move data folder into resstock-estimation Description: Relocate the data folder, along with tsv makers, to a separate private repository - TODO + Folder data moved here: https://github.com/NREL/resstock-estimation - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: characteristics, lighting, feature :pullreq: 392 - **Date**: 2020-06-24 + **Date**: 2020-02-13 Title: - TODO + Update lighting distribution. Description: Update the single-family detached and multifamily projects with more up-to-date lighting stock distributions - TODO + The old lighting distribution is weighted too heavily towards incandescent bulbs. New distribution data is from 2015 in the 2015 U.S. Lighting Market Characterization study. Option= 100% Incandescent include Incandescent, HID, Halogen, and Other. Option=100% CFL include CFL and LFL. Option=100% LED include LED. - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, envelope, feature :pullreq: 395 - **Date**: 2020-06-24 + **Date**: 2020-02-18 Title: - TODO + adding in diversity to MF roof insulation. Description: Update Insulation Finished Attic tsv with more options for insulation levels - TODO + Improve diversity for MF roof insulation by manually copying SF roof insulation (from Insulation Unfinished Attic). In the future, script NAHB / RBSA to pull MF distribution and also improve attic / non-attic split. - Assignees: TODO + Assignees: Janet .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 408 - **Date**: 2020-06-24 + **Date**: 2020-02-21 Title: - TODO + Ignore comment lines Description: Add ability to ignore comment lines with the "#" symbol - TODO + This pull request is an effort to make the housing characteristics more machine-readable. The created by line is causing issues when reading the files programmatically. The resolution is that we have ResStock ignore comment lines. The comment lines begin with the "#" symbol. - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, occupants, plug loads, feature :pullreq: 324 - **Date**: 2020-06-24 + **Date**: 2020-03-05 Title: - TODO + Update to RECS 2015 Description: Update occupant and plug loads equations based on RECS 2015 data; replace floor area with occupants as independent variable in plug loads equation; allow modeling of zero-bedroom units (e.g., studios) - TODO + To summarize, this: + + solves for Nbr (in terms of Nocc) for: + sinks, showers, baths + range, dishwasher, clothes washer, clothes dryer + plug loads, large uncommon loads + replaces plug loads equation with RECS 2015-derived - Assignees: TODO + resstock-estimation: `pull request 12 `_ + + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: characteristics, geospatial, feature :pullreq: 416 - **Date**: 2020-06-24 + **Date**: 2020-03-02 Title: - TODO + Geospatial Description: New geospatial characteristics have been added or updated. New geospatial characteristics are as follows: ASHRAE IECC Climate Zone 2004, State, County, PUMA, Census Division, Census Region, Building America Climate Zone, and ISO/RTO Region. The top level housing characteristic is now ASHRAE IECC Climate Zone 2004. Now using data from the American Community Survey Public Use Microdata Sample (ACS PUMS) for Building Type, Vintage, and Heating Fuel - TODO + This pull request is aimed at adding some spatial specification of ResStock samples. Currently, there are only two spatial descriptions in the housing characteristics: 1) Location (the epw weather file regions), and 2) Location Region (RECS defined Custom Regions) This pull request creates 10 housing characteristic files that help spatially define the location of a sampled housing unit. - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, hvac, feature :pullreq: 418 - **Date**: 2020-06-24 + **Date**: 2020-03-02 Title: - TODO + Chicago AC saturation Description: Update HVAC System Cooling tsv with air-conditioning saturations ("None", "Room AC", or "Central AC") from American Housing Survey for Custom Region 04. Efficiency probabilities remain based on RECS 2009 - TODO + During data source comparison, it was discovered that we probably have cooling saturation too low for Chicago. AHS is probably a better source for cooling saturation that we should use going forward. In the meantime, I pulled AC type saturation from AHS (None, Room AC , Central), and adjusted the distributions for each of these within the HVAC System Cooling tsv, but still using the efficiency breakdowns from RECS. Only CR04 was adjusted for the moment (which includes Chicago), using East North Central as an approximation for CR04 (the difference is the state of Wisconsin). In the future, we should probably separate saturation from efficiency in separate TSVs so we can use AHS for saturation and RECS for efficiency. - Assignees: TODO + Assignees: Janet .. change:: - :tags: todo, todo, feature + :tags: characteristics, setpoints, feature :pullreq: 414 - **Date**: 2020-06-24 + **Date**: 2020-03-05 Title: - TODO + Fuzzy schedules Description: Diversify the timing heating and cooling setpoint setbacks - TODO + Smears the Heating and Cooling offset schedules period +- 2hours around existing times. - Assignees: TODO + Assignees: Rajendra .. change:: - :tags: todo, todo, feature + :tags: characteristics, appliances, feature :pullreq: 420 - **Date**: 2020-06-24 + **Date**: 2020-03-12 Title: - TODO + Major appliance sat Description: Reduce the number of appliances in multifamily units. Adding RECS building type as a dependencies to clothes washers, clothes dryers, dishwashers, refrigerators, extra refrigerators, and stand-alone freezers. Update refrigeration levels based on RECS 2009 age and shipment-weighted efficiency by year. Now using the American Housing Survey (AHS) for clothes washer and clothes dryer saturations. New geographic field, AHS Region, which uses the top 15 largest Core Based Statistical Areas (CBSAs) and Non-CBSA Census Divisions - TODO + The purpose of this pull request is to reduce the number of appliances in multifamily units. The current assumption is that all units have Dishwashers and Clothes Washers. However multifamily units should have a lower probability of having laundry facilities (in unit) and extra refrigerators and stand-alone freezers. As a result, building type dependency was added to these characteristics and the fraction of units without the appliances is adjusted. - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, lighting, feature :pullreq: 419 - **Date**: 2020-06-24 + **Date**: 2020-03-12 Title: - TODO + Update the ResidentialLightingOther schedule in the options_lookup.tsv Description: Exterior lighting schedule changed from using interior lighting sunrise/sunset algorithm to T24 2016 Residential ACM Appendix C Table 8 Exterior Lighting Hourly Multiplier for weekdays and weekends - TODO + The old schedules were from the T24 2016 Residential ACM, except they were using the residential MELS schedule instead of the exterior lighting schedule. This commit updates to use the properly intended exterior lighting schedule instead. + + See the T24 2016 Residential ACM and the Plug Loads and Lighting Modeling CASE report from Energy Solutions for more information. - Assignees: TODO + Assignees: Tony, Eric .. change:: - :tags: todo, todo, feature + :tags: characteristics, floor area, feature :pullreq: 425 - **Date**: 2020-06-24 + **Date**: 2020-03-17 Title: - TODO + Increase floor area diversity Description: Increase the diversity of the floor areas that are simulated. Geometry House Size has been replaced by Geometry Floor Area Bin and Geometry Floor Area. Now using AHS for specifying the floor area. Floor areas differ by non-Core Based Statistical Areas (CBSAs) Census Divisions and the top 15 largest CBSAs - TODO + The purpose of this pull request is to diversify the floor area values that are simulated in ResStock. There are now two floor area bins housing characteristics, Geometry Floor Area Coarse and Geometry Floor Area Fine. These two housing characteristics are replacing the Geometry House Size housing characteristic. The Geometry Floor Area Coarse characteristics is meant to be used as a dependency for other RECS queries. The small number of bins (as before in Geometry House Size) does not slice RECS into many bins and retains reasonable sample sizes for housing characteristics dependent on Geometry Floor Area Coarse (Geometry Garage, Geometry Stories, Bedrooms, and Infiltration). The Geometry Floor Area Fine are bins based on the American Housing Survey (AHS). To maintain consistency between the two characteristics the bin sizes have been updated in Geometry Floor Area Coarse. The total_ffa and unit_ffa arguments in options_lookup.tsv are obtained from Geometry Floor Area Fine bin averages from RECS 2015. + + resstock-estimation: `pull request 19 `_ - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, infiltration, feature :pullreq: 427 - **Date**: 2020-06-24 + **Date**: 2020-03-24 Title: - TODO + Update Infiltration.tsv based on the Residential Diagnostics Database. Description: Increase the diversity of the infiltration simulated. Now using the Residential Diagnostics Database for the Infiltration housing characteristic - TODO + The purpose of this pull request is to diversify and update the infiltration housing characteristic. Currently, infiltration is based on the regression from Chan et al. (also based on LBL ResDB). As the regression produces a single infiltration value for a given set of input parameters, the probability distributions specified in the Infiltration.tsv are binary (only 0 and 1). In reality, the distributions are more continuous. + + In this pull request, the Infiltration.tsv has been updated with data from the Residential Diagnostics Database (ResDB). The cumulative distribution functions (CDFs) for air change at 50 Pa (ACH50) have been downloaded from their website. Each CDF from the website was fit with a lognormal distribution. The fitted lognormal distribution is then used to assign probabilities into the infiltration bins in ResStock. - Assignees: TODO + resstock-estimation: `pull request 20 `_ + + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 438 - **Date**: 2020-06-24 + **Date**: 2020-04-30 Title: - TODO + Specify key value in timeseries reporting Description: Allow a key value to be specified when outputting timeseries variables - TODO + Allows users to specify a key value when requesting timeseries csvs, for example: + output_variables: Surface Outside Face Incident Solar Radiation Rate per Area|Surface 2 outputs the variable for just Surface 2, instead of every surface. - Assignees: TODO + Assignees: Andrew .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 459 - **Date**: 2020-06-24 + **Date**: 2020-06-23 Title: - TODO + Rename multifamily_beta to national Description: Rename "project_multifamily_beta" to "project_national" - TODO + Rename multifamily_beta to national - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, heat pumps, bugfix :pullreq: 454 - **Date**: 2020-06-24 + **Date**: 2020-06-10 Title: - TODO + MSHP pan heater custom meter Description: Add mini-split heat pump pan heater to custom meter for heating electricity - TODO + Exclude mshp pan heater from being added to the electric interior equipment meter. Instead, add it to the electric heating meter. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 453 - **Date**: 2020-06-24 + **Date**: 2020-05-21 Title: - TODO + Assign daylight saving dates based on County Description: Assign daylight saving start/end dates based on county and not epw region - TODO + Assign dst_start_date and dst_end_date based on county instead of epw location. This eliminates the possibility of simulating a building without daylight saving dates when it is near, but not within, Arizona. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, ceiling fan, bugfix :pullreq: 445 - **Date**: 2020-06-24 + **Date**: 2020-05-12 Title: - TODO + Update ceiling fan options Description: Update ceiling fan tsv to remove the "National Average" option, and instead sample 28% "None" and 72% "Standard Efficiency" - TODO + Update ceiling fan options and tsvs according to: https://trello.com/c/yBmLc3OU/23-ceiling-fans - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, weather, bugfix :pullreq: 432 - **Date**: 2020-06-24 + **Date**: 2020-04-06 Title: - TODO + Weather file update Description: Remove Location Weather Filename and Location Weather Year tsvs, and update options lookup to reflect updated weather file changes; weather filenames are now required to match what is in the options lookup - TODO + Presently, to update the weather year files, we would need to make changes to the Location Weather Filename and Location Weather Year tsvs. While this approach is fine with two weather years i.e. TMY3 and AMY weather files presently, it creates a 'ballooning' effect when one begins to add more weather years as the location weather filename tsv will need the addition of 216 EPWs to its rows and columns for each AMY year. To resolve this issue, we: + + rename all epw weather filenames such that names are consistent between all years. New location weather filename data can be found here + delete location weather filename and location weather year as the names are now consistent between years + update options lookup tsv by adding weather filename arguments to the location tsv + update options lookup tsv by removing 'location weather filename' and 'location weather year' arguments - Assignees: TODO + Assignees: Tobi .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 433 - **Date**: 2020-06-24 + **Date**: 2020-04-02 Title: - TODO + ix qoi report measure to handle locations without a season Description: Fix bug in QOI reporting measure where absence of any heating/cooling/overlap seasons would cause errors - TODO + The QOI report measure timing section has two errors: + + If there are no days with mean daily temperature above 70F (summer), the measure will fail, as the summer season does not exist. Common in climate zones 7+ + The daily_vals object is comprised of two arrays, and the intent is to get the array length. This fixes the timing reporting in the measure. - Assignees: TODO + Assignees: Matt, Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, envelope, bugfix :pullreq: 426 - **Date**: 2020-06-24 + **Date**: 2020-04-01 Title: - TODO + Roofing material restructure Description: Restructure unfinished attic and finished roof -related tsv files (i.e., insulation, roof material, and radiant barrier) and options - TODO + Previously, we had: + + No "None" option for Insulation Unfinished Attic.tsv + Roofing Material.tsv assigned roofing_material arguments for both ResidentialConstructionsUnfinishedAttic and ResidentialConstructionsFinishedRoof + The issue with the previous is that if we try to upgrade just roofing_material, measure ResidentialConstructionsFinishedRoof is applied without all measure arguments specified. By adding the building type dependency to Insulation Unfinished Attic.tsv, Insulation Finished Roof.tsv, and both Roofing Material.tsv files, we can avoid this issue. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 405 - **Date**: 2020-06-24 + **Date**: 2020-02-25 Title: - TODO + Addresses #403, remove redundant enduses Description: Exclude net site energy consumption from annual and timeseries simulation output ("total" now reflects net of pv); change `include_enduse_subcategories` argument default to "true"; report either total interior equipment OR each of its components - TODO + Remove all the net site columns + Leave total columns for both true and false + Total columns become net of pv + Change the default of include_enduse_subcategories from false to true - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, mechanics, bugfix :pullreq: 392 - **Date**: 2020-06-24 + **Date**: 2020-02-13 Title: - TODO + Update lighting distribution. Description: Refactor the tsv maker classes to accommodate more data sources - TODO + The old lighting distribution is weighted too heavily towards incandescent bulbs. New distribution data is from 2015 in the 2015 U.S. Lighting Market Characterization study. Option= 100% Incandescent include Incandescent, HID, Halogen, and Other. Option=100% CFL include CFL and LFL. Option=100% LED include LED. - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: workflow, water heater, bugfix :pullreq: 375 - **Date**: 2020-06-24 + **Date**: 2020-03-25 Title: - TODO + Update Water Heater=Other Fuel to map to no water heater Description: Allow a building to be simulated with no water heater; map the "Other Fuel" option from the Water Heater tsv to no water heater - TODO + update cw, cd, dw, fixtures, distribution measures to skip when not finding a water heater - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, plug loads, bugfix :pullreq: 355 - **Date**: 2020-06-24 + **Date**: 2020-02-18 Title: - TODO + revert national average plug load schedule to RBSAM-derived schedule,… Description: Revert plug load schedule to RBSA for the National Average option - TODO + … which had accidentally been changed to CA Title 24 – CASE Plug Loads and Lighting Schedule - Assignees: TODO + Assignees: Eric .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, mechanics, bugfix :pullreq: 416 - **Date**: 2020-06-24 + **Date**: 2020-03-02 Title: - TODO + Geospatial Description: Removed the "Geometry Unit Stories SF" and "Geometry Unit Stories MF" housing characteristics. Unit stories are instead represented by the "Geometry Stories" housing characteristic - TODO + This pull request is aimed at adding some spatial specification of ResStock samples. Currently, there are only two spatial descriptions in the housing characteristics: 1) Location (the epw weather file regions), and 2) Location Region (RECS defined Custom Regions) This pull request creates 10 housing characteristic files that help spatially define the location of a sampled housing unit - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, windows, bugfix :pullreq: 412 - **Date**: 2020-06-24 + **Date**: 2020-03-24 Title: - TODO + Add wwr variation per RBSA II data Description: Diversify window to wall ratio variation using the Residential Building Stock Assessment (RBSA) II data - TODO + Per comments on that PR and discussion with @mdahlhausen, there are still changes that might happen before merging. + + binned WWRs for multifamily and single family buildings from RBSA II data + for calculations, see WWR estimates in EULP calibration directory on sharepoint + Assuming '50 or more Unit' building type is midrise/highrise with default 30% WWR for all buildings + + resstock-estimation: `pull request 21 `_ - Assignees: TODO + Assignees: Andrew P, Tony .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 452 - **Date**: 2020-06-24 + **Date**: 2020-06-10 Title: - TODO + fix bug for small window areas Description: Fix bug in assigning small window areas to surfaces - TODO + @whiphi92 uncovered a bug that would throw an error when the calculated window area of a facade was less than the minimum allowable window area. This fix checks for that case and applies the invalid window area to the largest available surface. - Assignees: TODO + Assignees: Andrew From 930cc47ced643ed5961fc70a2edf80e081435d10 Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Wed, 22 May 2024 10:22:43 -0700 Subject: [PATCH 11/21] Update 2_0_0 thru 2_2_5 changelogs. [ci skip] --- .../source/changelog/changelog_2_0_0.rst | 118 ++-- .../source/changelog/changelog_2_1_0.rst | 590 ++++++++++++------ .../source/changelog/changelog_2_2_0.rst | 186 +++--- .../source/changelog/changelog_2_2_1.rst | 36 +- .../source/changelog/changelog_2_2_2.rst | 10 +- .../source/changelog/changelog_2_2_3.rst | 10 +- .../source/changelog/changelog_2_2_4.rst | 12 +- .../source/changelog/changelog_2_2_5.rst | 8 +- 8 files changed, 598 insertions(+), 372 deletions(-) diff --git a/docs/read_the_docs/source/changelog/changelog_2_0_0.rst b/docs/read_the_docs/source/changelog/changelog_2_0_0.rst index 3ab93c8afa..45d4fa3d98 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_0_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_0_0.rst @@ -10,191 +10,191 @@ v2.0.0 Changelog :tags: software, openstudio, feature :pullreq: 151 - **Date**: 2019-04-17 + **Date**: 2019-04-11 Title: - TODO + Multifamily Description: Update to OpenStudio v2.8.0 - TODO + Multifamily - Assignees: TODO + Assignees: Joe, Maharshi, Scott .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 151 - **Date**: 2019-04-17 + **Date**: 2019-04-11 Title: - TODO + Multifamily Description: Add a multifamily project which includes housing characteristic distributions for single-family detached, single-family attached, and multifamily buildings - TODO + Multifamily - Assignees: TODO + Assignees: Joe, Maharshi, Scott .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 151 - **Date**: 2019-04-17 + **Date**: nan Title: - TODO + Multifamily Description: Ability to add central systems (boiler with baseboards, fan coil, PTAC) to multifamily buildings using the openstudio-standards gem - TODO + Multifamily - Assignees: TODO + Assignees: Joe, Maharshi, Scott .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 206 - **Date**: 2019-04-17 + **Date**: 2019-02-12 Title: - TODO + Large buildings collapsed into minimal units Description: Ability to simulate large multifamily buildings using "collapsed" buildings with multipliers on building units - TODO + Large buildings collapsed into minimal units - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, documentation, feature :pullreq: 211 - **Date**: 2019-04-17 + **Date**: 2019-02-28 Title: - TODO + Dependency graphs and wheels Description: Automatically generate dependency graphs and a dependency wheel for each project - TODO + I put together scripts in the docs folder to automatically generate dependency graphs and a dependency wheel for each in the OpenStudio-BuildStock repository. These scripts create a util folder if it doesn't exist and puts data for these visualizations. A project README.md file has been added to each where there is a link to the interactive dependency wheel. These visualizations are easily updated as they depend strictly on the TSV files. They are updated through a single regenerate_visualization.ipynb script. - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 151 - **Date**: 2019-04-17 + **Date**: 2019-04-11 Title: - TODO + Multifamily Description: Add measures for calculating construction properties, modeling power outages and calculating resilience metrics, and calculating utility bills - TODO + Multifamily - Assignees: TODO + Assignees: Joe, Maharshi, Scott .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 151 - **Date**: 2019-04-17 + **Date**: 2019-04-11 Title: - TODO + Multifamily Description: Add measure for modeling shared multiifamily facades using adiabatic constructions - TODO + Multifamily - Assignees: TODO + Assignees: Joe, Maharshi, Scott .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 151 - **Date**: 2019-04-17 + **Date**: 2019-04-11 Title: - TODO + Multifamily Description: Relocate all measure unit tests, test osw files, and test osm files from archived OpenStudio-BEopt and into this repository - TODO + Multifamily - Assignees: TODO + Assignees: Joe, Maharshi, Scott .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 151 - **Date**: 2019-04-17 + **Date**: 2019-04-11 Title: - TODO + Multifamily Description: Create example workflow osw files for single-family detached, single-family attached, and multifamily buildings using TMY weather - TODO + Multifamily - Assignees: TODO + Assignees: Joe, Maharshi, Scott .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 151 - **Date**: 2019-04-17 + **Date**: 2019-04-11 Title: - TODO + Multifamily Description: Reporting measures read from ReportMeterData table to get disaggregated fan and pump energy - TODO + Multifamily - Assignees: TODO + Assignees: Joe, Maharshi, Scott .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 151 - **Date**: 2019-04-17 + **Date**: 2019-04-11 Title: - TODO + Multifamily Description: Break out central system heating, cooling, and pump energy in reporting measures - TODO + Multifamily - Assignees: TODO + Assignees: Joe, Maharshi, Scott .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 216 - **Date**: 2019-04-17 + **Date**: 2019-03-21 Title: - TODO + Use UnitConversions.convert(...) method Description: Use custom unit conversions script instead of that provided by OpenStudio SDK - TODO + Use UnitConversions.convert(...) method - Assignees: TODO + Assignees: Joe diff --git a/docs/read_the_docs/source/changelog/changelog_2_1_0.rst b/docs/read_the_docs/source/changelog/changelog_2_1_0.rst index 8cd5307453..98b508b2d8 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_1_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_1_0.rst @@ -10,575 +10,789 @@ v2.1.0 Changelog :tags: software, openstudio, feature :pullreq: 322 - **Date**: 2019-11-05 + **Date**: 2019-10-15 Title: - TODO + OS 2.9.0 Description: Update to OpenStudio v2.9.0 - TODO + Try out OpenStudio 2.9.0: rc1, rc2, rc3, and final. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature - :pullreq: 228, 237, 239 + :tags: workflow, mechanics, feature + :pullreq: 228 - **Date**: 2019-11-05 + **Date**: 2019-04-12 Title: - TODO + TSV Speed Improvements Description: Unit tests and performance improvements for integrity checks - TODO + This PR substantially speeds up integrity checks for TSVs with large numbers of rows (and has the side benefit of speeding up sampling) by using caching. - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, feature + :tags: workflow, testing, feature + :pullreq: 237 + + **Date**: 2019-04-22 + + Title: + Integrity check unit tests + + Description: + Unit tests and performance improvements for integrity checks + Adds unit tests to make sure that the integrity checks are covering various potential scenarios that would cause errors. Each unit test consists of a housing_characteristics dir with custom TSVs and corresponding options in the test_options_lookup.tsv that should cause the error. The unit tests check that the appropriate error message is hit. + + Assignees: Scott + + + .. change:: + :tags: workflow, testing, feature + :pullreq: 239 + + **Date**: 2019-04-22 + + Title: + Integrity check performance improvement + + Description: + Unit tests and performance improvements for integrity checks + Dramatically improves the speed of performing measure argument checks. Rather than checking every combination of option for every parameter that contributes to a single measure's arguments, we now pick options from each parameter in step. + + Assignees: Scott + + + .. change:: + :tags: workflow, reporting, feature :pullreq: 245 - **Date**: 2019-11-05 + **Date**: 2019-05-02 Title: - TODO + Register climate zones Description: Register climate zones (BA and IECC) based on the simulation EPW file - TODO + This is a pretty simple and straightforward PR: it adds two columns "climate_zone_ba" and "climate_zone_iecc" (based on the epw) to the results csv. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature - :pullreq: 244, 252 + :tags: workflow, lighting, feature + :pullreq: 244 - **Date**: 2019-11-05 + **Date**: 2019-05-06 Title: - TODO + Lighting measure changes Description: Split ResidentialLighting into separate ResidentialLightingInterior and ResidentialLightingOther (with optional exterior holiday lighting) measures - TODO + Lighting measure changes - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature - :pullreq: 259, 261 + :tags: workflow, lighting, feature + :pullreq: 252 - **Date**: 2019-11-05 + **Date**: 2019-05-15 Title: - TODO + Optional exterior "holiday" lights + + Description: + Split ResidentialLighting into separate ResidentialLightingInterior and ResidentialLightingOther (with optional exterior holiday lighting) measures + This involves modifications to: + + ResidentialLightingOther measure + 4 new arguments (daily energy use, holiday period start, holiday period end, holiday schedule) + unit test for verifying that exterior lighting increases by, e.g., 41 days * 1.1 kWh/day = 45 kWh + lighting.rb + new apply_exterior_holiday method + assigning end use subcategories to all light objects + options_lookup.tsv and testing project + existing lighting options now get default holiday argument values + new lighting option to test exterior holiday lighting + SimulationOutputReport / TimeseriesCSVExport measures + custom meters for "garage lighting" and "exterior holiday lighting" + reporting "garage lighting" and "exterior holiday lighting" + + Assignees: Joe + + + .. change:: + :tags: workflow, testing, feature + :pullreq: 259 + + **Date**: 2019-05-22 + + Title: + Store example osw annual simulation results on ci Description: Additional example workflow osw files using TMY/AMY2012/AMY2014 weather for use in regression testing - TODO + Similar to how @shorowit does "regression testing" on https://github.com/NREL/OpenStudio-HPXML. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, testing, feature + :pullreq: 261 + + **Date**: 2019-05-24 + + Title: + Additional example workflow osws + + Description: + Additional example workflow osw files using TMY/AMY2012/AMY2014 weather for use in regression testing + TMY, AMY2012, AMY2014. + + Assignees: Joe + + + .. change:: + :tags: characteristics, setpoints, feature :pullreq: 272 - **Date**: 2019-11-05 + **Date**: 2019-09-25 Title: - TODO + new distributions for heating/cooling tsps with offsets Description: Update all projects with new heating/cooling setpoint, offset, and magnitude distributions - TODO + New/updated tsvs for distributions of heating/cooling setpoints and setpoint offsets. Queried from RECS at the AIA climate zone level. Options_lookup is updated with new options. - Assignees: TODO + Assignees: Andrew .. change:: - :tags: todo, todo, feature + :tags: workflow, demand response, feature :pullreq: 276 - **Date**: 2019-11-05 + **Date**: 2019-07-15 Title: - TODO + Demand response Description: Add new ResidentialDemandResponse measure that allows for 8760 DR schedules to be applied to heating/cooling schedules - TODO + New measure ResidentialDemandResponse that allows for 8760 DR schedules to be applied to heating and/or cooling schedules. + + Assignees: Andrew + + + .. change:: + :tags: characteristics, mechanics, feature + :pullreq: 264 + + **Date**: 2019-06-13 + + Title: + New parameters & options + + Description: + Additional options for HVAC, dehumidifier, clothes washer, misc loads, infiltration, etc. + New options and parameters for existing OS measures. + Purpose is to expand OS modeling capability, driven in this case by an outside client interested in using E+ as their simulation engine. - Assignees: TODO + Assignees: Nate .. change:: - :tags: todo, todo, feature - :pullreq: 264, 278, 292 + :tags: characteristics, mechanics, feature + :pullreq: 278 - **Date**: 2019-11-05 + **Date**: 2019-06-25 Title: - TODO + Moar options Description: Additional options for HVAC, dehumidifier, clothes washer, misc loads, infiltration, etc. - TODO + Add items to options_lookup available in master branch - Assignees: TODO + Assignees: Nate .. change:: - :tags: todo, todo, feature + :tags: workflow, hvac, feature + :pullreq: 292 + + **Date**: 2019-08-14 + + Title: + Add 96% AFUE Propane Boiler + + Description: + Additional options for HVAC, dehumidifier, clothes washer, misc loads, infiltration, etc. + Propane boilers go up to 97% AFUE in the Energy STAR database. Oil boilers only go up to 91%. + + Assignees: Elaina + + + .. change:: + :tags: workflow, mechanics, feature :pullreq: 282 - **Date**: 2019-11-05 + **Date**: 2019-07-12 Title: - TODO + Add options and write EV code Description: Add EV options and update ResidentialMiscLargeUncommonLoads measure with new electric vehicle argument - TODO + Also includes writing new options/arguments in measure.rb, which should be closely examined for errors due to my inexperience with that task. - Assignees: TODO + Assignees: Nate .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 287 - **Date**: 2019-11-05 + **Date**: 2019-07-09 Title: - TODO + Add year argument to simulation controls measure Description: Update ResidentialSimulationControls measure to include a calendar year argument for controlling the simulation start day of week - TODO + Add year argument to simulation controls measure + + Assignees: Joe - Assignees: TODO + + .. change:: + :tags: workflow, upgrades, feature + :pullreq: 273 + + **Date**: 2019-06-18 + + Title: + Increase upgrade options from 10 to 20 + + Description: + Increase number of possible upgrade options from 10 to 25 + Increase upgrade options from 10 to 20 + + Assignees: Joe .. change:: - :tags: todo, todo, feature - :pullreq: 273, 293 + :tags: workflow, upgrades, feature + :pullreq: 293 - **Date**: 2019-11-05 + **Date**: 2019-07-16 Title: - TODO + Increase upgrade options from 20 to 25 Description: Increase number of possible upgrade options from 10 to 25 - TODO + Increase upgrade options from 20 to 25 - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, upgrades, feature :pullreq: 296 - **Date**: 2019-11-05 + **Date**: 2019-07-31 Title: - TODO + Additional max-tech levels for options_lookup Description: Additional "max-tech" options for slab, wall, refrigerator, dishwasher, clothes washer, and lighting - TODO + Added 112 lm/W LED option, EF 22.2 refrigerator option, R20 Whole Slab insulation option, Wood Stud R-13 with R-20 external XPS option, EnergyStar Most Efficient clothes washers, and EnergyStar Most Efficient Dishwashers at 199 rated Kwh - Assignees: TODO + Assignees: Elaina .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 302 - **Date**: 2019-11-05 + **Date**: 2019-08-08 Title: - TODO + Add TM to ResStock and ComStock Description: Add references to ResStock trademark in both the license and readme files - TODO + Added to first references in: + + README.md + LICENSE.md - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, reporting, feature :pullreq: 304 - **Date**: 2019-11-05 + **Date**: 2019-08-21 Title: - TODO + Fixes/updates for SimulationOutputReport measure Description: Report all cost multipliers in the SimulationOutputReport measure - TODO + Fix bug in cost multipliers for "minimally collapsed" building + SimulationOutputReport unit tests for "minimally collapsed" building + Report all cost multipliers in results csv + Regression tests include all cost multipliers - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, fixtures, feature :pullreq: 305 - **Date**: 2019-11-05 + **Date**: 2019-08-16 Title: - TODO + Low flow fixture options Description: Add options for low flow fixtures - TODO + Low flow fixture options - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 310 - **Date**: 2019-11-05 + **Date**: 2019-09-03 Title: - TODO + Ehale ignore measures Description: Add argument to BuildExistingModel measure that allows the user to ignore measures - TODO + This branch adds the feature of being able to having the ResStock BuildExistingModel ignore measures. There will be a companion pull request to buildstockbatch that passes that argument through the project yml. - Assignees: TODO + Assignees: Elaine .. change:: - :tags: todo, todo, feature - :pullreq: 291, 314 + :tags: workflow, mechanics, feature + :pullreq: 291 - **Date**: 2019-11-05 + **Date**: 2019-07-12 Title: - TODO + Add buildstockbatch ymls to each resstock project Description: Create example project yaml files for use with buildstockbatch - TODO + For convenience. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature + :pullreq: 314 + + **Date**: 2019-09-20 + + Title: + Example YAML file upload + + Description: + Create example project yaml files for use with buildstockbatch + Some comments on correct defaults included, could use more. + + Assignees: Elaina + + + .. change:: + :tags: workflow, mechanics, feature :pullreq: 317 - **Date**: 2019-11-05 + **Date**: 2019-09-19 Title: - TODO + Create pull_request_template.md Description: Create a pull request template to facilitate development - TODO + Start creating a pull request template. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, documentation, feature :pullreq: 321 - **Date**: 2019-11-05 + **Date**: 2019-09-23 Title: - TODO + Talk to downselect point that datapoints are before downselect logic. Description: Update documentation to clarify downselect logic parameters - TODO + Update documentation to clarify downselect logic parameters - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature - :pullreq: 329, 333 + :tags: characteristics, mechanics, feature + :pullreq: 329 - **Date**: 2019-11-05 + **Date**: 2019-10-17 Title: - TODO + Add more efficient options for dw, cw, cd Description: Additional options for EnergyStar clothes washer, clothes dryer, dishwasher - TODO + We need "more efficient" options for idsm-scout and mf aedg. Currently, the dw, cw options are causing increased energy consumption. Janet had started to look into this. Turns out things related to the energy guide label, like rated_annual_energy, annual_cost, and test_date, had not been updated. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, mechanics, feature + :pullreq: 333 + + **Date**: 2019-10-23 + + Title: + Update the cw options a bit + + Description: + Additional options for EnergyStar clothes washer, clothes dryer, dishwasher + Reduce IMEF on the "more" efficient option. Change drum volume on "most" efficient option. Add links in unit tests to actual clothes washer examples pulled from energystar. + + Assignees: Joe + + + .. change:: + :tags: workflow, mechanics, bugfix :pullreq: 255 - **Date**: 2019-11-05 + **Date**: 2019-05-28 Title: - TODO + Addresses #243 and #254 Description: Bugfix for assuming that all simulations are exactly 365 days - TODO + Bugfix for assuming that all simulations are exactly 365 days - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, hvac, bugfix :pullreq: 258 - **Date**: 2019-11-05 + **Date**: 2019-05-21 Title: - TODO + Typo in heating coil defrost strategy Description: Bugfix for heating coil defrost strategy - TODO + Typo in heating coil defrost strategy - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, hvac, bugfix :pullreq: 263 - **Date**: 2019-11-05 + **Date**: 2019-06-06 Title: - TODO + HVAC autosizing and add/replace fixes Description: Various HVAC-related fixes for buildings with central systems - TODO + When a model has both a central system and non central system, don't autosize the non central system (e.g., central boiler with room ac) + Cannot have heating-only fan coil anymore; the ZoneHVACUnitHeater object was not being autosized correctly and was resulting in zero heating energy + Don't remove the cooling-only fan coil when applying a heating-only non central system (e.g., cooling-only fan coil with furnace) - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, testing, bugfix :pullreq: 280 - **Date**: 2019-11-05 + **Date**: 2019-07-02 Title: - TODO + Update testing project to sweep thru more options Description: Update testing project to sweep through more options - TODO + Update testing project to sweep thru more options - Assignees: TODO + Assignees: Nate .. change:: - :tags: todo, todo, bugfix - :pullreq: 270, 274, 285 + :tags: workflow, documentation, bugfix + :pullreq: 270 - **Date**: 2019-11-05 + **Date**: 2019-06-17 Title: - TODO + Advanced tutorial updates Description: Updates, edits, and clarification to the documentation - TODO + Advanced tutorial updates - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, documentation, bugfix + :pullreq: 274 + + **Date**: 2019-06-19 + + Title: + Some RTD updates + + Description: + Updates, edits, and clarification to the documentation + Some RTD updates + + Assignees: Joe + + + .. change:: + :tags: workflow, documentation, bugfix + :pullreq: 285 + + **Date**: 2019-07-02 + + Title: + Minor readthedocs updates + + Description: + Updates, edits, and clarification to the documentation + Minor readthedocs updates + + Assignees: Joe + + + .. change:: + :tags: workflow, mechanics, bugfix :pullreq: 286 - **Date**: 2019-11-05 + **Date**: 2019-07-09 Title: - TODO + Don't request output for "invalid" datapoints Description: Skip any reporting measure output requests for datapoints that have been registered as invalid - TODO + Don't request output for "invalid" datapoints - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 295 - **Date**: 2019-11-05 + **Date**: 2019-07-18 Title: - TODO + Fix bug when you specify all br but not ba Description: Bugfix for when bedrooms are specified for each unit but bathrooms are not - TODO + Fix bug when you specify all br but not ba - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, solar hot water, bugfix :pullreq: 307 - **Date**: 2019-11-05 + **Date**: 2019-08-20 Title: - TODO + Addresses #306 Description: Ensure that autosizing does not draw the whole tank volume in one minute for solar hot water storage tank - TODO + setUseSideDesignFlowRate for solar hw measure - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 308 - **Date**: 2019-11-05 + **Date**: 2019-08-20 Title: - TODO + Remove invalid characters from option names Description: Remove invalid characters from option names for consistency with buildstockbatch - TODO + Fixes options that would fail the validation proposed in NREL/buildstockbatch#99 - Assignees: TODO + Assignees: Nate .. change:: - :tags: todo, todo, bugfix + :tags: workflow, ducts, bugfix :pullreq: 309 - **Date**: 2019-11-05 + **Date**: 2019-08-21 Title: - TODO + Ducts sometimes placed in garage attic Description: Bugfix for ducts occasionally getting placed in the garage attic instead of only unfinished attic - TODO + This changes the space type for the 1-story building garage attic from unfinished attic to garage attic. This should fix issues brought up by @jonwinkler. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 312 - **Date**: 2019-11-05 + **Date**: 2019-08-23 Title: - TODO + Get past runner values of any type Description: Able to get past runner values of any type, and not just as string - TODO + Can only get runner past values as string - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 315 - **Date**: 2019-11-05 + **Date**: 2019-09-19 Title: - TODO + Log the error string along with backtrace Description: Log the error message along with the backtrace when an applied measure fails - TODO + Currently, the apply_measure function only logs the error backtrace when the measure being applied fails, but not the actual error message. This fixes the issue, and logs the error message alongside the backtrace. - Assignees: TODO + Assignees: Rajendra .. change:: - :tags: todo, todo, bugfix + :tags: workflow, testing, bugfix :pullreq: 320 - **Date**: 2019-11-05 + **Date**: 2019-09-23 Title: - TODO + Fixes #319 Description: Add tests to ensure that the Run Measure argument is correctly defined in all Apply Upgrade measures for all projects - TODO + Fixes #319. Added tests to ensure that the Run Measure argument is correctly defined in all Apply Upgrade measures for all projects. - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 330 - **Date**: 2019-11-05 + **Date**: 2019-10-17 Title: - TODO + Fix assignment of bedrooms to units Description: Bugfix when specifying numbers of bedrooms to building units - TODO + This fixes a bug when you try to assign, e.g., 3, 2, 1, 2, 2, 3 numbers of bedrooms to 6 building units. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, testing, bugfix :pullreq: 331 - **Date**: 2019-11-05 + **Date**: 2019-10-18 Title: - TODO + Enforce rubocop as separate ci test Description: Enforce rubocop as CI test so code with offenses cannot be merged - TODO + Code can no longer be committed to the repo with rubocop offenses. + + Assignees: Joe + + + .. change:: + :tags: characteristics, mechanics, bugfix + :pullreq: 329 + + **Date**: 2019-10-17 + + Title: + Add more efficient options for dw, cw, cd + + Description: + Bugfix for some clothes washer, dishwasher options causing increased energy consumption + We need "more efficient" options for idsm-scout and mf aedg. Currently, the dw, cw options are causing increased energy consumption. Janet had started to look into this. Turns out things related to the energy guide label, like rated_annual_energy, annual_cost, and test_date, had not been updated. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix - :pullreq: 329, 333 + :tags: characteristics, mechanics, bugfix + :pullreq: 333 - **Date**: 2019-11-05 + **Date**: 2019-10-23 Title: - TODO + Update the cw options a bit Description: Bugfix for some clothes washer, dishwasher options causing increased energy consumption - TODO + Reduce IMEF on the "more" efficient option. Change drum volume on "most" efficient option. Add links in unit tests to actual clothes washer examples pulled from energystar. - Assignees: TODO + Assignees: Joe diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_0.rst b/docs/read_the_docs/source/changelog/changelog_2_2_0.rst index d48a45e8bf..468ded2932 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_0.rst @@ -7,290 +7,300 @@ v2.2.0 Changelog :released: 2020-01-30 .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 371 - **Date**: 2020-01-30 + **Date**: 2020-01-24 Title: - TODO + Addresses #352, optionally include annual totals for end use subcategories Description: The results csv now optionally reports annual totals for all end use subcategories, including appliances, plug loads, etc. - TODO + Can now optionally report (using the SimulationOutputReport measure) annual totals for end use subcategories (same as for the TimeseriesCSVExport measure) in the results csv. Measure also checks that the sum of the end use subcategories equals the reported interior equipment value. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, misc loads, feature :pullreq: 362 - **Date**: 2020-01-30 + **Date**: 2020-01-29 Title: - TODO + More none no natl avg Description: Split out national average options so not all homes have all miscellaneous equipment, and add none options to appliances - TODO + Split out national average options so not all homes have all miscellaneous equipment, and add none options to appliances - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: characteristics, envelope, feature :pullreq: 357 - **Date**: 2020-01-30 + **Date**: 2020-01-18 Title: - TODO + Tsv wall w hcs reformat Description: Update the single-family detached project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls - TODO + [Added the TSV for wall type, masonry and wood. added dependency to the Insulation Wall TSV; additional options for CMU walls(post-1950) and 3" wythe brick wall] - Assignees: TODO + Assignees: Maharshi .. change:: - :tags: todo, todo, feature + :tags: characteristics, mechanics, feature :pullreq: 353 - **Date**: 2020-01-30 + **Date**: 2020-01-17 Title: - TODO + Make housing characteristics format consistent. Description: Made housing characteristics a consistent format. Added integrity check to ensure housing characteristics follow the guildelines specified in read-the-docs - TODO + In the effort to make the format more consistent, the following format has been applied to the housing characteristics. Standardizing the format of the housing characteristics should make it easier to see differences in commits + + All line terminators are '\r\n' which is consistent with Windows machines. + All Option columns have format '%.6f'. + All [For Reference Only] Source Sample Size columns are type 'int'. + All [For Reference Only] Source Weight columns are type 'int'. - Assignees: TODO + Assignees: Tony .. change:: - :tags: todo, todo, feature + :tags: workflow, mechanics, feature :pullreq: 346 **Date**: 2020-01-30 Title: - TODO + Addresses #344, adjust timeseries csv index for DST Description: Include additional "daylight saving time" and "utc time" columns to timeseries csv file to account for one hour forward and backward time shifts - TODO + The TimeseriesCSVExport measure outputs time at a constant interval across a year, regardless of time changes for daylight savings time. This can cause confusion, as E+ shifts schedules to account for DST, but our time output does not line up with this shift. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: characteristics, recs, feature :pullreq: 340 - **Date**: 2020-01-30 + **Date**: 2019-11-26 Title: - TODO + RECS 2015 tsv maker Description: Update bedrooms and occupants tsv files with options and probability distributions based on RECS 2015 data - TODO + RECS 2015 tsv maker - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: workflow, reporting, feature :pullreq: 334 - **Date**: 2020-01-30 + **Date**: 2019-11-05 Title: - TODO + Report quantities of interest Description: Add new QOIReport measure for reporting seasonal quantities of interest for uncertainty quantification - TODO + Reporting quantities of interest for EULP uncertainty quantification. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, feature + :tags: characteristics, mechanics, feature :pullreq: 338 - **Date**: 2020-01-30 + **Date**: 2019-11-07 Title: - TODO + Update sfd, mf, and testing tsv structure Description: Separate tsv files for bedrooms, cooking range schedule, corridor, holiday lighting, interior/other lighting use, pool schedule, plug loads schedule, and refrigeration schedule - TODO + Update sfd, mf, and testing tsv structure - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, hvac, bugfix :pullreq: 372 - **Date**: 2020-01-30 + **Date**: 2020-01-23 Title: - TODO + Fixes wood stove upgrade Description: Allow Wood Stove option as an upgrade, and account for wood heating energy in simulation output - TODO + I added a bugfix for the upgrade so that the EnergyPlus simulation is successful. - Assignees: TODO + Assignees: Scott .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 371 - **Date**: 2020-01-30 + **Date**: 2020-01-24 Title: - TODO + Addresses #352, optionally include annual totals for end use subcategories Description: Custom meters for ceiling fan, hot water recirc pump, and vehicle end use subcategories were not properly implemented - TODO + Can now optionally report (using the SimulationOutputReport measure) annual totals for end use subcategories (same as for the TimeseriesCSVExport measure) in the results csv. Measure also checks that the sum of the end use subcategories equals the reported interior equipment value. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, mechanics, bugfix :pullreq: 356 - **Date**: 2020-01-30 + **Date**: 2020-01-18 Title: - TODO + Mf renaming w hcs formating Description: Some re-labeling of tsv files, such as "Geometry Building Type" to "Geometry Building Type RECS" and "Geometry Building Type FPL" to "Geometry Building Type ACS" - TODO + [Changes in the naming convention of hcs with the new hcs format included. ] - Assignees: TODO + Assignees: Maharshi .. change:: - :tags: todo, todo, bugfix + :tags: workflow, mechanics, bugfix :pullreq: 360 - **Date**: 2020-01-30 + **Date**: 2020-01-17 Title: - TODO + Remove "auto" option for number of occupants Description: Removes option "Auto" from parameter "Occupants" in the options lookup file - TODO + Remove "auto" option for number of occupants - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, mechanics, bugfix :pullreq: 350 - **Date**: 2020-01-30 + **Date**: 2019-12-12 Title: - TODO + Neighbors update Description: Update the multifamily project's neighbors and orientation tsv files to have geometry building type dependency; remove the now obsolete "Geometry Is Multifamily Low Rise.tsv" file - TODO + Remove Geometry Is Multifamily Low Rise.tsv from all projects, and replace with Geometry Building Type.tsv as a dependency in the multifamily project + Use Geometry Building Type.tsv as dependency for Neighbors.tsv in multifamily project + Use Geometry Building Type.tsv as dependency for Orientation.tsv in multifamily project - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, reporting, bugfix :pullreq: 346 **Date**: 2020-01-30 Title: - TODO + Addresses #344, adjust timeseries csv index for DST Description: Update each PAT project's AMI selection to "2.9.0" - TODO + The TimeseriesCSVExport measure outputs time at a constant interval across a year, regardless of time changes for daylight savings time. This can cause confusion, as E+ shifts schedules to account for DST, but our time output does not line up with this shift. - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, lighting, bugfix :pullreq: 349 - **Date**: 2020-01-30 + **Date**: 2019-12-11 Title: - TODO + Lighting fixes Description: Fixes for custom output meters: total site electricity double-counting exterior holiday lighting, and garage lighting all zeroes - TODO + Addresses bugs in custom output meters found by @rajeee and @afontani: + + total site electricity double-counting exterior holiday lighting + garage lighting all zeroes - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, facades, bugfix :pullreq: 301 - **Date**: 2020-01-30 + **Date**: 2019-11-15 Title: - TODO + Remove shared facades Description: Remove shared facades tsv files from the multifamily_beta and testing projects - TODO + Remove shared facades - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, reporting, bugfix :pullreq: 334 - **Date**: 2020-01-30 + **Date**: 2019-11-05 Title: - TODO + Report quantities of interest Description: Move redundant output meter code from individual reporting measures out into shared resource file - TODO + Move redundant output meter code from individual reporting measures out into shared resource file - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: workflow, power outage, bugfix :pullreq: 238 - **Date**: 2020-01-30 + **Date**: 2019-11-13 Title: - TODO + Updates to outage measure Description: Fix for the power outages measure where the last hour of the day was not getting the new schedule applied - TODO + It looked like the last hour of the day wasn't getting the new schedule applied. This fixes that. I've also cleaned up some code and added some new unit tests. - Assignees: TODO + Assignees: Joe diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_1.rst b/docs/read_the_docs/source/changelog/changelog_2_2_1.rst index c22da24df4..578de95b2b 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_1.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_1.rst @@ -7,66 +7,66 @@ v2.2.1 Changelog :released: 2020-02-07 .. change:: - :tags: todo, todo, feature + :tags: characteristics, envelope, feature :pullreq: 382 - **Date**: 2020-02-07 + **Date**: 2020-02-04 Title: - TODO + Multifamily masonry walls Description: Update the multifamily project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls - TODO + Adding in masonry walls via "Geometry Wall Type" tsv and adding a new dependency in "Insulation Wall". Mimics work done by Maharshi for project_singlefamily. Also created a new tsv_maker for RECS 2009 - Assignees: TODO + Assignees: Janet .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, envelope, bugfix :pullreq: 387 **Date**: 2020-02-07 Title: - TODO + Addresses #386, fix misc pool tsv files and updates project_singlefamilydetached masonry walls Description: Add generation of the Geometry Wall Type tsv file for the single-family detached project to the 2009 RECS tsv maker; this corrects the tsv file - TODO + Addresses #386, fix misc pool tsv files and updates project_singlefamilydetached masonry walls - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, misc loads, bugfix :pullreq: 387 **Date**: 2020-02-07 Title: - TODO + Addresses #386, fix misc pool tsv files and updates project_singlefamilydetached masonry walls Description: Add generation of the Misc Pool tsv file (with Geometry Building Type and Location Region dependencies) to the 2009 RECS tsv maker; this also corrects having pool pumps for all homes - TODO + Fix pool pump probabilities - Assignees: TODO + Assignees: Joe .. change:: - :tags: todo, todo, bugfix + :tags: characteristics, recs, bugfix :pullreq: 382 - **Date**: 2020-02-07 + **Date**: 2020-02-04 Title: - TODO + Multifamily masonry walls Description: Refactor the RECS tsv makers for years 2009 and 2015 - TODO + Refactor the RECS tsv makers for years 2009 and 2015 - Assignees: TODO + Assignees: Janet diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_2.rst b/docs/read_the_docs/source/changelog/changelog_2_2_2.rst index 35efa3b2ed..f3cc34c095 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_2.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_2.rst @@ -7,18 +7,18 @@ v2.2.2 Changelog :released: 2020-02-19 .. change:: - :tags: todo, todo, bugfix + :tags: workflow, weather, bugfix :pullreq: 406 - **Date**: 2020-02-19 + **Date**: 2020-02-21 Title: - TODO + Release 2_2_2 patch Description: Update the datapoint initialization script to download weather files to a common zip filename - TODO + Current curl command in datapoint init script guaranteed aws s3 downloads to work, but not downloads from other hosts (e.g., dropbox). Changing the curl command to be more generic. - Assignees: TODO + Assignees: Joe diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_3.rst b/docs/read_the_docs/source/changelog/changelog_2_2_3.rst index 933b56d482..fd8d6dddc9 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_3.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_3.rst @@ -7,18 +7,18 @@ v2.2.3 Changelog :released: 2020-03-09 .. change:: - :tags: todo, todo, bugfix + :tags: workflow, weather, bugfix :pullreq: 422 - **Date**: 2020-03-09 + **Date**: 2020-03-10 Title: - TODO + Release 2_2_3 patch Description: Update the weather zip file url in each PAT project to point to data.nrel.gov - TODO + Release 2_2_3 patch - Assignees: TODO + Assignees: Joe diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_4.rst b/docs/read_the_docs/source/changelog/changelog_2_2_4.rst index 56f450471d..a1415a6ae1 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_4.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_4.rst @@ -7,18 +7,20 @@ v2.2.4 Changelog :released: 2020-04-28 .. change:: - :tags: todo, todo, bugfix + :tags: workflow, airflow, bugfix :pullreq: 442 - **Date**: 2020-04-28 + **Date**: 2020-05-01 Title: - TODO + Release 2_2_4 patch Description: Fix bug in options lookup where buildings without heating systems were not being assigned the required "has_hvac_flue" airflow measure argument - TODO + Argument has_hvac_flue for ResidentialAirflow wasn't being assigned when no heating system was sampled. + + The proposed solution here is to move the has_hvac_flue argument from the ResidentialAirflow measure out into the HVAC equipment measures (furnace, boiler, unit heater, shared systems). The value assigned to has_hvac_flue will be set as an additional property on the Building model object, and then the airflow measure will parse it from the Building model object. If it doesn't exist, then the value will be set to false. - Assignees: TODO + Assignees: Joe diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_5.rst b/docs/read_the_docs/source/changelog/changelog_2_2_5.rst index 3439581dc9..b4b8bbd3fb 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_5.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_5.rst @@ -7,18 +7,18 @@ v2.2.5 Changelog :released: 2020-09-24 .. change:: - :tags: todo, todo, bugfix + :tags: workflow, weather, bugfix :pullreq: 489 **Date**: 2020-09-24 Title: - TODO + Release 2_2_5 patch Description: Update the weather zip file url in each PAT project to point to a different location at data.nrel.gov - TODO + Release 2_2_5 patch - Assignees: TODO + Assignees: Joe From 9367a5740f5488be88d5d910414bfbf3e6787c6e Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Wed, 22 May 2024 10:41:08 -0700 Subject: [PATCH 12/21] Add most recent dev entries. --- .../source/changelog/changelog_dev.rst | 83 +++++++++++++++++++ 1 file changed, 83 insertions(+) diff --git a/docs/read_the_docs/source/changelog/changelog_dev.rst b/docs/read_the_docs/source/changelog/changelog_dev.rst index 9445fa2057..770692aa7d 100644 --- a/docs/read_the_docs/source/changelog/changelog_dev.rst +++ b/docs/read_the_docs/source/changelog/changelog_dev.rst @@ -414,3 +414,86 @@ Development Changelog Assignees: Jeff + .. change:: + :tags: workflow, mechanics, feature + :pullreq: 1230 + + **Date**: 2024-05-16 + + Title: + Run run_analysis in parallel + + Description: + Introduce a new optional `buildstock_csv_path` argument that supports parallel resstock runs using `run_analysis.rb` + I know this is an odd workflow, but I'd like to call resstock in parallel, to run multiple models (baseline only) built each with a precomputed buildstock.csv + + Assignees: Julien + + + .. change:: + :tags: workflow, reporting, feature + :pullreq: 1240 + + **Date**: 2024-05-16 + + Title: + Latest OS-HPXML + + Description: + Improves heating/cooling component loads; for timesteps where there is no heating/cooling load, assigns heat transfer to heating or cooling by comparing indoor temperature to the average of heating/cooling setpoints + Improves heating/cooling component loads; for timesteps where there is no heating/cooling load, assigns heat transfer to heating or cooling by comparing indoor temperature to the average of heating/cooling setpoints. + + Assignees: Andrew + + + .. change:: + :tags: workflow, reporting, feature + :pullreq: 1240 + + **Date**: 2024-05-16 + + Title: + Latest OS-HPXML + + Description: + Additional geothermal loop default simulation outputs (number/length of boreholes) + Adds geothermal loop outputs (number/length of boreholes) to annual results output file. + + Assignees: Scott + + + .. change:: + :tags: workflow, infiltration, feature + :pullreq: 1240 + + **Date**: 2024-05-16 + + Title: + Latest OS-HPXML + + Description: + Updates default `ShieldingofHome` to be "well-shielded" (from "normal") for single-family attached and multifamily dwelling units + Updates default ShieldingofHome to be "well-shielded" for single-family attached and multifamily dwelling units. + + Assignees: Scott + + + .. change:: + :tags: workflow, plug loads, feature + :pullreq: 1213 + + **Date**: 2024-05-21 + + Title: + Split out Other and TV plug loads + + Description: + Split out TV plug loads (calculated using an equation based on ANSI/RESNET/ICC 301) from other plug loads (calculated using updated regression equations based on RECS2020) + For TV, we are now using OS-HPXML defaults (i.e., TV = 413.0 + 69.0 * NumberofBedrooms based on ANSI/RESNET/ICC 301-2019, where NumberofBedrooms is adjusted based on NumberofResidents). + Create a new sources/recs/recs2020/plug_loads/mel_ann.py script. + + resstock-estimation: `pull request 401 `_ + + Assignees: Joe, Tony + + From 29bc1b061540aaef377dd3f62c27d31c57066946 Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Wed, 22 May 2024 12:45:10 -0700 Subject: [PATCH 13/21] Order all dates from newest to oldest. --- .../source/changelog/changelog_2_0_0.rst | 109 +- .../source/changelog/changelog_2_1_0.rst | 682 ++++++------- .../source/changelog/changelog_2_2_0.rst | 240 +++-- .../source/changelog/changelog_2_2_1.rst | 38 +- .../source/changelog/changelog_2_2_2.rst | 4 +- .../source/changelog/changelog_2_2_3.rst | 5 +- .../source/changelog/changelog_2_2_4.rst | 5 +- .../source/changelog/changelog_2_2_5.rst | 3 +- .../source/changelog/changelog_2_3_0.rst | 439 ++++---- .../source/changelog/changelog_2_4_0.rst | 458 +++++---- .../source/changelog/changelog_2_5_0.rst | 949 +++++++++--------- .../source/changelog/changelog_3_0_0.rst | 414 ++++---- .../source/changelog/changelog_3_1_0.rst | 171 ++-- .../source/changelog/changelog_3_1_1.rst | 2 +- .../source/changelog/changelog_3_2_0.rst | 53 +- .../source/changelog/changelog_dev.rst | 213 ++-- 16 files changed, 1850 insertions(+), 1935 deletions(-) diff --git a/docs/read_the_docs/source/changelog/changelog_2_0_0.rst b/docs/read_the_docs/source/changelog/changelog_2_0_0.rst index 45d4fa3d98..77af19b060 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_0_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_0_0.rst @@ -17,9 +17,8 @@ v2.0.0 Changelog Description: Update to OpenStudio v2.8.0 - Multifamily - Assignees: Joe, Maharshi, Scott + Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz .. change:: @@ -33,57 +32,53 @@ v2.0.0 Changelog Description: Add a multifamily project which includes housing characteristic distributions for single-family detached, single-family attached, and multifamily buildings - Multifamily - Assignees: Joe, Maharshi, Scott + Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz .. change:: :tags: workflow, mechanics, feature :pullreq: 151 - **Date**: nan + **Date**: 2019-04-11 Title: Multifamily Description: - Ability to add central systems (boiler with baseboards, fan coil, PTAC) to multifamily buildings using the openstudio-standards gem - Multifamily + Add measures for calculating construction properties, modeling power outages and calculating resilience metrics, and calculating utility bills - Assignees: Joe, Maharshi, Scott + Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz .. change:: :tags: workflow, mechanics, feature - :pullreq: 206 + :pullreq: 151 - **Date**: 2019-02-12 + **Date**: 2019-04-11 Title: - Large buildings collapsed into minimal units + Multifamily Description: - Ability to simulate large multifamily buildings using "collapsed" buildings with multipliers on building units - Large buildings collapsed into minimal units + Add measure for modeling shared multiifamily facades using adiabatic constructions - Assignees: Joe + Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz .. change:: - :tags: workflow, documentation, feature - :pullreq: 211 + :tags: workflow, mechanics, feature + :pullreq: 151 - **Date**: 2019-02-28 + **Date**: 2019-04-11 Title: - Dependency graphs and wheels + Multifamily Description: - Automatically generate dependency graphs and a dependency wheel for each project - I put together scripts in the docs folder to automatically generate dependency graphs and a dependency wheel for each in the OpenStudio-BuildStock repository. These scripts create a util folder if it doesn't exist and puts data for these visualizations. A project README.md file has been added to each where there is a link to the interactive dependency wheel. These visualizations are easily updated as they depend strictly on the TSV files. They are updated through a single regenerate_visualization.ipynb script. + Relocate all measure unit tests, test osw files, and test osm files from archived OpenStudio-BEopt and into this repository - Assignees: Tony + Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz .. change:: @@ -96,14 +91,13 @@ v2.0.0 Changelog Multifamily Description: - Add measures for calculating construction properties, modeling power outages and calculating resilience metrics, and calculating utility bills - Multifamily + Create example workflow osw files for single-family detached, single-family attached, and multifamily buildings using TMY weather - Assignees: Joe, Maharshi, Scott + Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz .. change:: - :tags: workflow, mechanics, feature + :tags: workflow, mechanics, bugfix :pullreq: 151 **Date**: 2019-04-11 @@ -112,14 +106,13 @@ v2.0.0 Changelog Multifamily Description: - Add measure for modeling shared multiifamily facades using adiabatic constructions - Multifamily + Reporting measures read from ReportMeterData table to get disaggregated fan and pump energy - Assignees: Joe, Maharshi, Scott + Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz .. change:: - :tags: workflow, mechanics, feature + :tags: workflow, mechanics, bugfix :pullreq: 151 **Date**: 2019-04-11 @@ -128,73 +121,69 @@ v2.0.0 Changelog Multifamily Description: - Relocate all measure unit tests, test osw files, and test osm files from archived OpenStudio-BEopt and into this repository - Multifamily + Break out central system heating, cooling, and pump energy in reporting measures - Assignees: Joe, Maharshi, Scott + Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz .. change:: - :tags: workflow, mechanics, feature - :pullreq: 151 + :tags: workflow, mechanics, bugfix + :pullreq: 216 - **Date**: 2019-04-11 + **Date**: 2019-03-21 Title: - Multifamily + Use UnitConversions.convert(...) method Description: - Create example workflow osw files for single-family detached, single-family attached, and multifamily buildings using TMY weather - Multifamily + Use custom unit conversions script instead of that provided by OpenStudio SDK - Assignees: Joe, Maharshi, Scott + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 151 + :tags: workflow, documentation, feature + :pullreq: 211 - **Date**: 2019-04-11 + **Date**: 2019-02-28 Title: - Multifamily + Dependency graphs and wheels Description: - Reporting measures read from ReportMeterData table to get disaggregated fan and pump energy - Multifamily + Automatically generate dependency graphs and a dependency wheel for each project + I put together scripts in the docs folder to automatically generate dependency graphs and a dependency wheel for each in the OpenStudio-BuildStock repository. These scripts create a util folder if it doesn't exist and puts data for these visualizations. A project README.md file has been added to each where there is a link to the interactive dependency wheel. These visualizations are easily updated as they depend strictly on the TSV files. They are updated through a single regenerate_visualization.ipynb script. - Assignees: Joe, Maharshi, Scott + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 151 + :tags: workflow, mechanics, feature + :pullreq: 206 - **Date**: 2019-04-11 + **Date**: 2019-02-12 Title: - Multifamily + Large buildings collapsed into minimal units Description: - Break out central system heating, cooling, and pump energy in reporting measures - Multifamily + Ability to simulate large multifamily buildings using "collapsed" buildings with multipliers on building units - Assignees: Joe, Maharshi, Scott + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 216 + :tags: workflow, mechanics, feature + :pullreq: 151 - **Date**: 2019-03-21 + **Date**: NaT Title: - Use UnitConversions.convert(...) method + Multifamily Description: - Use custom unit conversions script instead of that provided by OpenStudio SDK - Use UnitConversions.convert(...) method + Ability to add central systems (boiler with baseboards, fan coil, PTAC) to multifamily buildings using the openstudio-standards gem - Assignees: Joe + Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz diff --git a/docs/read_the_docs/source/changelog/changelog_2_1_0.rst b/docs/read_the_docs/source/changelog/changelog_2_1_0.rst index 98b508b2d8..5177b1594b 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_1_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_1_0.rst @@ -7,160 +7,115 @@ v2.1.0 Changelog :released: 2019-11-05 .. change:: - :tags: software, openstudio, feature - :pullreq: 322 - - **Date**: 2019-10-15 - - Title: - OS 2.9.0 - - Description: - Update to OpenStudio v2.9.0 - Try out OpenStudio 2.9.0: rc1, rc2, rc3, and final. - - Assignees: Joe - - - .. change:: - :tags: workflow, mechanics, feature - :pullreq: 228 - - **Date**: 2019-04-12 - - Title: - TSV Speed Improvements - - Description: - Unit tests and performance improvements for integrity checks - This PR substantially speeds up integrity checks for TSVs with large numbers of rows (and has the side benefit of speeding up sampling) by using caching. - - Assignees: Scott - - - .. change:: - :tags: workflow, testing, feature - :pullreq: 237 + :tags: characteristics, mechanics, feature + :pullreq: 333 - **Date**: 2019-04-22 + **Date**: 2019-10-23 Title: - Integrity check unit tests + Update the cw options a bit Description: - Unit tests and performance improvements for integrity checks - Adds unit tests to make sure that the integrity checks are covering various potential scenarios that would cause errors. Each unit test consists of a housing_characteristics dir with custom TSVs and corresponding options in the test_options_lookup.tsv that should cause the error. The unit tests check that the appropriate error message is hit. + Additional options for EnergyStar clothes washer, clothes dryer, dishwasher + Reduce IMEF on the "more" efficient option. Change drum volume on "most" efficient option. Add links in unit tests to actual clothes washer examples pulled from energystar. - Assignees: Scott + Assignees: Joe Robertson .. change:: - :tags: workflow, testing, feature - :pullreq: 239 + :tags: characteristics, mechanics, bugfix + :pullreq: 333 - **Date**: 2019-04-22 + **Date**: 2019-10-23 Title: - Integrity check performance improvement + Update the cw options a bit Description: - Unit tests and performance improvements for integrity checks - Dramatically improves the speed of performing measure argument checks. Rather than checking every combination of option for every parameter that contributes to a single measure's arguments, we now pick options from each parameter in step. + Bugfix for some clothes washer, dishwasher options causing increased energy consumption + Reduce IMEF on the "more" efficient option. Change drum volume on "most" efficient option. Add links in unit tests to actual clothes washer examples pulled from energystar. - Assignees: Scott + Assignees: Joe Robertson .. change:: - :tags: workflow, reporting, feature - :pullreq: 245 + :tags: workflow, testing, bugfix + :pullreq: 331 - **Date**: 2019-05-02 + **Date**: 2019-10-18 Title: - Register climate zones + Enforce rubocop as separate ci test Description: - Register climate zones (BA and IECC) based on the simulation EPW file - This is a pretty simple and straightforward PR: it adds two columns "climate_zone_ba" and "climate_zone_iecc" (based on the epw) to the results csv. + Enforce rubocop as CI test so code with offenses cannot be merged + Code can no longer be committed to the repo with rubocop offenses. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, lighting, feature - :pullreq: 244 + :tags: characteristics, mechanics, feature + :pullreq: 329 - **Date**: 2019-05-06 + **Date**: 2019-10-17 Title: - Lighting measure changes + Add more efficient options for dw, cw, cd Description: - Split ResidentialLighting into separate ResidentialLightingInterior and ResidentialLightingOther (with optional exterior holiday lighting) measures - Lighting measure changes + Additional options for EnergyStar clothes washer, clothes dryer, dishwasher + We need "more efficient" options for idsm-scout and mf aedg. Currently, the dw, cw options are causing increased energy consumption. Janet had started to look into this. Turns out things related to the energy guide label, like rated_annual_energy, annual_cost, and test_date, had not been updated. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, lighting, feature - :pullreq: 252 + :tags: workflow, mechanics, bugfix + :pullreq: 330 - **Date**: 2019-05-15 + **Date**: 2019-10-17 Title: - Optional exterior "holiday" lights + Fix assignment of bedrooms to units Description: - Split ResidentialLighting into separate ResidentialLightingInterior and ResidentialLightingOther (with optional exterior holiday lighting) measures - This involves modifications to: - - ResidentialLightingOther measure - 4 new arguments (daily energy use, holiday period start, holiday period end, holiday schedule) - unit test for verifying that exterior lighting increases by, e.g., 41 days * 1.1 kWh/day = 45 kWh - lighting.rb - new apply_exterior_holiday method - assigning end use subcategories to all light objects - options_lookup.tsv and testing project - existing lighting options now get default holiday argument values - new lighting option to test exterior holiday lighting - SimulationOutputReport / TimeseriesCSVExport measures - custom meters for "garage lighting" and "exterior holiday lighting" - reporting "garage lighting" and "exterior holiday lighting" + Bugfix when specifying numbers of bedrooms to building units + This fixes a bug when you try to assign, e.g., 3, 2, 1, 2, 2, 3 numbers of bedrooms to 6 building units. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, testing, feature - :pullreq: 259 + :tags: characteristics, mechanics, bugfix + :pullreq: 329 - **Date**: 2019-05-22 + **Date**: 2019-10-17 Title: - Store example osw annual simulation results on ci + Add more efficient options for dw, cw, cd Description: - Additional example workflow osw files using TMY/AMY2012/AMY2014 weather for use in regression testing - Similar to how @shorowit does "regression testing" on https://github.com/NREL/OpenStudio-HPXML. + Bugfix for some clothes washer, dishwasher options causing increased energy consumption + We need "more efficient" options for idsm-scout and mf aedg. Currently, the dw, cw options are causing increased energy consumption. Janet had started to look into this. Turns out things related to the energy guide label, like rated_annual_energy, annual_cost, and test_date, had not been updated. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, testing, feature - :pullreq: 261 + :tags: software, openstudio, feature + :pullreq: 322 - **Date**: 2019-05-24 + **Date**: 2019-10-15 Title: - Additional example workflow osws + OS 2.9.0 Description: - Additional example workflow osw files using TMY/AMY2012/AMY2014 weather for use in regression testing - TMY, AMY2012, AMY2014. + Update to OpenStudio v2.9.0 + Try out OpenStudio 2.9.0: rc1, rc2, rc3, and final. - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -176,190 +131,185 @@ v2.1.0 Changelog Update all projects with new heating/cooling setpoint, offset, and magnitude distributions New/updated tsvs for distributions of heating/cooling setpoints and setpoint offsets. Queried from RECS at the AIA climate zone level. Options_lookup is updated with new options. - Assignees: Andrew + Assignees: Andrew Speake .. change:: - :tags: workflow, demand response, feature - :pullreq: 276 + :tags: workflow, documentation, feature + :pullreq: 321 - **Date**: 2019-07-15 + **Date**: 2019-09-23 Title: - Demand response + Talk to downselect point that datapoints are before downselect logic. Description: - Add new ResidentialDemandResponse measure that allows for 8760 DR schedules to be applied to heating/cooling schedules - New measure ResidentialDemandResponse that allows for 8760 DR schedules to be applied to heating and/or cooling schedules. + Update documentation to clarify downselect logic parameters - Assignees: Andrew + Assignees: Joe Robertson .. change:: - :tags: characteristics, mechanics, feature - :pullreq: 264 + :tags: workflow, testing, bugfix + :pullreq: 320 - **Date**: 2019-06-13 + **Date**: 2019-09-23 Title: - New parameters & options + Fixes #319 Description: - Additional options for HVAC, dehumidifier, clothes washer, misc loads, infiltration, etc. - New options and parameters for existing OS measures. - Purpose is to expand OS modeling capability, driven in this case by an outside client interested in using E+ as their simulation engine. + Add tests to ensure that the Run Measure argument is correctly defined in all Apply Upgrade measures for all projects + Fixes #319. Added tests to ensure that the Run Measure argument is correctly defined in all Apply Upgrade measures for all projects. - Assignees: Nate + Assignees: Scott Horowitz .. change:: - :tags: characteristics, mechanics, feature - :pullreq: 278 + :tags: workflow, mechanics, feature + :pullreq: 314 - **Date**: 2019-06-25 + **Date**: 2019-09-20 Title: - Moar options + Example YAML file upload Description: - Additional options for HVAC, dehumidifier, clothes washer, misc loads, infiltration, etc. - Add items to options_lookup available in master branch + Create example project yaml files for use with buildstockbatch + Some comments on correct defaults included, could use more. - Assignees: Nate + Assignees: Elaina Present .. change:: - :tags: workflow, hvac, feature - :pullreq: 292 + :tags: workflow, mechanics, feature + :pullreq: 317 - **Date**: 2019-08-14 + **Date**: 2019-09-19 Title: - Add 96% AFUE Propane Boiler + Create pull_request_template.md Description: - Additional options for HVAC, dehumidifier, clothes washer, misc loads, infiltration, etc. - Propane boilers go up to 97% AFUE in the Energy STAR database. Oil boilers only go up to 91%. + Create a pull request template to facilitate development + Start creating a pull request template. - Assignees: Elaina + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, feature - :pullreq: 282 + :tags: workflow, mechanics, bugfix + :pullreq: 315 - **Date**: 2019-07-12 + **Date**: 2019-09-19 Title: - Add options and write EV code + Log the error string along with backtrace Description: - Add EV options and update ResidentialMiscLargeUncommonLoads measure with new electric vehicle argument - Also includes writing new options/arguments in measure.rb, which should be closely examined for errors due to my inexperience with that task. + Log the error message along with the backtrace when an applied measure fails + Currently, the apply_measure function only logs the error backtrace when the measure being applied fails, but not the actual error message. This fixes the issue, and logs the error message alongside the backtrace. - Assignees: Nate + Assignees: Rajendra Adhikari .. change:: :tags: workflow, mechanics, feature - :pullreq: 287 + :pullreq: 310 - **Date**: 2019-07-09 + **Date**: 2019-09-03 Title: - Add year argument to simulation controls measure + Ehale ignore measures Description: - Update ResidentialSimulationControls measure to include a calendar year argument for controlling the simulation start day of week - Add year argument to simulation controls measure + Add argument to BuildExistingModel measure that allows the user to ignore measures + This branch adds the feature of being able to having the ResStock BuildExistingModel ignore measures. There will be a companion pull request to buildstockbatch that passes that argument through the project yml. - Assignees: Joe + Assignees: Elaine Hale .. change:: - :tags: workflow, upgrades, feature - :pullreq: 273 + :tags: workflow, mechanics, bugfix + :pullreq: 312 - **Date**: 2019-06-18 + **Date**: 2019-08-23 Title: - Increase upgrade options from 10 to 20 + Get past runner values of any type Description: - Increase number of possible upgrade options from 10 to 25 - Increase upgrade options from 10 to 20 + Able to get past runner values of any type, and not just as string + Can only get runner past values as string - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, upgrades, feature - :pullreq: 293 + :tags: workflow, reporting, feature + :pullreq: 304 - **Date**: 2019-07-16 + **Date**: 2019-08-21 Title: - Increase upgrade options from 20 to 25 + Fixes/updates for SimulationOutputReport measure Description: - Increase number of possible upgrade options from 10 to 25 - Increase upgrade options from 20 to 25 + Report all cost multipliers in the SimulationOutputReport measure + Fix bug in cost multipliers for "minimally collapsed" building + SimulationOutputReport unit tests for "minimally collapsed" building + Report all cost multipliers in results csv + Regression tests include all cost multipliers - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, upgrades, feature - :pullreq: 296 + :tags: workflow, ducts, bugfix + :pullreq: 309 - **Date**: 2019-07-31 + **Date**: 2019-08-21 Title: - Additional max-tech levels for options_lookup + Ducts sometimes placed in garage attic Description: - Additional "max-tech" options for slab, wall, refrigerator, dishwasher, clothes washer, and lighting - Added 112 lm/W LED option, EF 22.2 refrigerator option, R20 Whole Slab insulation option, Wood Stud R-13 with R-20 external XPS option, EnergyStar Most Efficient clothes washers, and EnergyStar Most Efficient Dishwashers at 199 rated Kwh + Bugfix for ducts occasionally getting placed in the garage attic instead of only unfinished attic + This changes the space type for the 1-story building garage attic from unfinished attic to garage attic. This should fix issues brought up by @jonwinkler. - Assignees: Elaina + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, feature - :pullreq: 302 + :tags: workflow, solar hot water, bugfix + :pullreq: 307 - **Date**: 2019-08-08 + **Date**: 2019-08-20 Title: - Add TM to ResStock and ComStock + Addresses #306 Description: - Add references to ResStock trademark in both the license and readme files - Added to first references in: - - README.md - LICENSE.md + Ensure that autosizing does not draw the whole tank volume in one minute for solar hot water storage tank + setUseSideDesignFlowRate for solar hw measure - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, reporting, feature - :pullreq: 304 + :tags: workflow, mechanics, bugfix + :pullreq: 308 - **Date**: 2019-08-21 + **Date**: 2019-08-20 Title: - Fixes/updates for SimulationOutputReport measure + Remove invalid characters from option names Description: - Report all cost multipliers in the SimulationOutputReport measure - Fix bug in cost multipliers for "minimally collapsed" building - SimulationOutputReport unit tests for "minimally collapsed" building - Report all cost multipliers in results csv - Regression tests include all cost multipliers + Remove invalid characters from option names for consistency with buildstockbatch + Fixes options that would fail the validation proposed in NREL/buildstockbatch#99 - Assignees: Joe + Assignees: Nate Moore .. change:: @@ -373,171 +323,166 @@ v2.1.0 Changelog Description: Add options for low flow fixtures - Low flow fixture options - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, feature - :pullreq: 310 + :tags: workflow, hvac, feature + :pullreq: 292 - **Date**: 2019-09-03 + **Date**: 2019-08-14 Title: - Ehale ignore measures + Add 96% AFUE Propane Boiler Description: - Add argument to BuildExistingModel measure that allows the user to ignore measures - This branch adds the feature of being able to having the ResStock BuildExistingModel ignore measures. There will be a companion pull request to buildstockbatch that passes that argument through the project yml. + Additional options for HVAC, dehumidifier, clothes washer, misc loads, infiltration, etc. + Propane boilers go up to 97% AFUE in the Energy STAR database. Oil boilers only go up to 91%. - Assignees: Elaine + Assignees: Elaina Present .. change:: :tags: workflow, mechanics, feature - :pullreq: 291 + :pullreq: 302 - **Date**: 2019-07-12 + **Date**: 2019-08-08 Title: - Add buildstockbatch ymls to each resstock project + Add TM to ResStock and ComStock Description: - Create example project yaml files for use with buildstockbatch - For convenience. + Add references to ResStock trademark in both the license and readme files + Added to first references in: + README.md + LICENSE.md - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, feature - :pullreq: 314 + :tags: workflow, upgrades, feature + :pullreq: 296 - **Date**: 2019-09-20 + **Date**: 2019-07-31 Title: - Example YAML file upload + Additional max-tech levels for options_lookup Description: - Create example project yaml files for use with buildstockbatch - Some comments on correct defaults included, could use more. + Additional "max-tech" options for slab, wall, refrigerator, dishwasher, clothes washer, and lighting + Added 112 lm/W LED option, EF 22.2 refrigerator option, R20 Whole Slab insulation option, Wood Stud R-13 with R-20 external XPS option, EnergyStar Most Efficient clothes washers, and EnergyStar Most Efficient Dishwashers at 199 rated Kwh - Assignees: Elaina + Assignees: Elaina Present .. change:: - :tags: workflow, mechanics, feature - :pullreq: 317 + :tags: workflow, mechanics, bugfix + :pullreq: 295 - **Date**: 2019-09-19 + **Date**: 2019-07-18 Title: - Create pull_request_template.md + Fix bug when you specify all br but not ba Description: - Create a pull request template to facilitate development - Start creating a pull request template. + Bugfix for when bedrooms are specified for each unit but bathrooms are not - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, documentation, feature - :pullreq: 321 + :tags: workflow, upgrades, feature + :pullreq: 293 - **Date**: 2019-09-23 + **Date**: 2019-07-16 Title: - Talk to downselect point that datapoints are before downselect logic. + Increase upgrade options from 20 to 25 Description: - Update documentation to clarify downselect logic parameters - Update documentation to clarify downselect logic parameters + Increase number of possible upgrade options from 10 to 25 - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: characteristics, mechanics, feature - :pullreq: 329 + :tags: workflow, demand response, feature + :pullreq: 276 - **Date**: 2019-10-17 + **Date**: 2019-07-15 Title: - Add more efficient options for dw, cw, cd + Demand response Description: - Additional options for EnergyStar clothes washer, clothes dryer, dishwasher - We need "more efficient" options for idsm-scout and mf aedg. Currently, the dw, cw options are causing increased energy consumption. Janet had started to look into this. Turns out things related to the energy guide label, like rated_annual_energy, annual_cost, and test_date, had not been updated. + Add new ResidentialDemandResponse measure that allows for 8760 DR schedules to be applied to heating/cooling schedules + New measure ResidentialDemandResponse that allows for 8760 DR schedules to be applied to heating and/or cooling schedules. - Assignees: Joe + Assignees: Andrew Speake .. change:: - :tags: characteristics, mechanics, feature - :pullreq: 333 + :tags: workflow, mechanics, feature + :pullreq: 282 - **Date**: 2019-10-23 + **Date**: 2019-07-12 Title: - Update the cw options a bit + Add options and write EV code Description: - Additional options for EnergyStar clothes washer, clothes dryer, dishwasher - Reduce IMEF on the "more" efficient option. Change drum volume on "most" efficient option. Add links in unit tests to actual clothes washer examples pulled from energystar. + Add EV options and update ResidentialMiscLargeUncommonLoads measure with new electric vehicle argument + Also includes writing new options/arguments in measure.rb, which should be closely examined for errors due to my inexperience with that task. - Assignees: Joe + Assignees: Nate Moore .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 255 + :tags: workflow, mechanics, feature + :pullreq: 291 - **Date**: 2019-05-28 + **Date**: 2019-07-12 Title: - Addresses #243 and #254 + Add buildstockbatch ymls to each resstock project Description: - Bugfix for assuming that all simulations are exactly 365 days - Bugfix for assuming that all simulations are exactly 365 days + Create example project yaml files for use with buildstockbatch + For convenience. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, hvac, bugfix - :pullreq: 258 + :tags: workflow, mechanics, feature + :pullreq: 287 - **Date**: 2019-05-21 + **Date**: 2019-07-09 Title: - Typo in heating coil defrost strategy + Add year argument to simulation controls measure Description: - Bugfix for heating coil defrost strategy - Typo in heating coil defrost strategy + Update ResidentialSimulationControls measure to include a calendar year argument for controlling the simulation start day of week - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, hvac, bugfix - :pullreq: 263 + :tags: workflow, mechanics, bugfix + :pullreq: 286 - **Date**: 2019-06-06 + **Date**: 2019-07-09 Title: - HVAC autosizing and add/replace fixes + Don't request output for "invalid" datapoints Description: - Various HVAC-related fixes for buildings with central systems - When a model has both a central system and non central system, don't autosize the non central system (e.g., central boiler with room ac) - Cannot have heating-only fan coil anymore; the ZoneHVACUnitHeater object was not being autosized correctly and was resulting in zero heating energy - Don't remove the cooling-only fan coil when applying a heating-only non central system (e.g., cooling-only fan coil with furnace) + Skip any reporting measure output requests for datapoints that have been registered as invalid - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -551,25 +496,39 @@ v2.1.0 Changelog Description: Update testing project to sweep through more options - Update testing project to sweep thru more options - Assignees: Nate + Assignees: Nate Moore .. change:: :tags: workflow, documentation, bugfix - :pullreq: 270 + :pullreq: 285 - **Date**: 2019-06-17 + **Date**: 2019-07-02 Title: - Advanced tutorial updates + Minor readthedocs updates Description: Updates, edits, and clarification to the documentation - Advanced tutorial updates - Assignees: Joe + Assignees: Joe Robertson + + + .. change:: + :tags: characteristics, mechanics, feature + :pullreq: 278 + + **Date**: 2019-06-25 + + Title: + Moar options + + Description: + Additional options for HVAC, dehumidifier, clothes washer, misc loads, infiltration, etc. + Add items to options_lookup available in master branch + + Assignees: Nate Moore .. change:: @@ -583,216 +542,241 @@ v2.1.0 Changelog Description: Updates, edits, and clarification to the documentation - Some RTD updates - Assignees: Joe + Assignees: Joe Robertson + + + .. change:: + :tags: workflow, upgrades, feature + :pullreq: 273 + + **Date**: 2019-06-18 + + Title: + Increase upgrade options from 10 to 20 + + Description: + Increase number of possible upgrade options from 10 to 25 + + Assignees: Joe Robertson .. change:: :tags: workflow, documentation, bugfix - :pullreq: 285 + :pullreq: 270 - **Date**: 2019-07-02 + **Date**: 2019-06-17 Title: - Minor readthedocs updates + Advanced tutorial updates Description: Updates, edits, and clarification to the documentation - Minor readthedocs updates - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 286 + :tags: characteristics, mechanics, feature + :pullreq: 264 - **Date**: 2019-07-09 + **Date**: 2019-06-13 Title: - Don't request output for "invalid" datapoints + New parameters & options Description: - Skip any reporting measure output requests for datapoints that have been registered as invalid - Don't request output for "invalid" datapoints + Additional options for HVAC, dehumidifier, clothes washer, misc loads, infiltration, etc. + New options and parameters for existing OS measures. + Purpose is to expand OS modeling capability, driven in this case by an outside client interested in using E+ as their simulation engine. - Assignees: Joe + Assignees: Nate Moore .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 295 + :tags: workflow, hvac, bugfix + :pullreq: 263 - **Date**: 2019-07-18 + **Date**: 2019-06-06 Title: - Fix bug when you specify all br but not ba + HVAC autosizing and add/replace fixes Description: - Bugfix for when bedrooms are specified for each unit but bathrooms are not - Fix bug when you specify all br but not ba + Various HVAC-related fixes for buildings with central systems + When a model has both a central system and non central system, don't autosize the non central system (e.g., central boiler with room ac) + Cannot have heating-only fan coil anymore; the ZoneHVACUnitHeater object was not being autosized correctly and was resulting in zero heating energy + Don't remove the cooling-only fan coil when applying a heating-only non central system (e.g., cooling-only fan coil with furnace) - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, solar hot water, bugfix - :pullreq: 307 + :tags: workflow, mechanics, bugfix + :pullreq: 255 - **Date**: 2019-08-20 + **Date**: 2019-05-28 Title: - Addresses #306 + Addresses #243 and #254 Description: - Ensure that autosizing does not draw the whole tank volume in one minute for solar hot water storage tank - setUseSideDesignFlowRate for solar hw measure + Bugfix for assuming that all simulations are exactly 365 days - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 308 + :tags: workflow, testing, feature + :pullreq: 261 - **Date**: 2019-08-20 + **Date**: 2019-05-24 Title: - Remove invalid characters from option names + Additional example workflow osws Description: - Remove invalid characters from option names for consistency with buildstockbatch - Fixes options that would fail the validation proposed in NREL/buildstockbatch#99 + Additional example workflow osw files using TMY/AMY2012/AMY2014 weather for use in regression testing + TMY, AMY2012, AMY2014. - Assignees: Nate + Assignees: Joe Robertson .. change:: - :tags: workflow, ducts, bugfix - :pullreq: 309 + :tags: workflow, testing, feature + :pullreq: 259 - **Date**: 2019-08-21 + **Date**: 2019-05-22 Title: - Ducts sometimes placed in garage attic + Store example osw annual simulation results on ci Description: - Bugfix for ducts occasionally getting placed in the garage attic instead of only unfinished attic - This changes the space type for the 1-story building garage attic from unfinished attic to garage attic. This should fix issues brought up by @jonwinkler. + Additional example workflow osw files using TMY/AMY2012/AMY2014 weather for use in regression testing + Similar to how @shorowit does "regression testing" on https://github.com/NREL/OpenStudio-HPXML. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 312 + :tags: workflow, hvac, bugfix + :pullreq: 258 - **Date**: 2019-08-23 + **Date**: 2019-05-21 Title: - Get past runner values of any type + Typo in heating coil defrost strategy Description: - Able to get past runner values of any type, and not just as string - Can only get runner past values as string + Bugfix for heating coil defrost strategy - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 315 + :tags: workflow, lighting, feature + :pullreq: 252 - **Date**: 2019-09-19 + **Date**: 2019-05-15 Title: - Log the error string along with backtrace + Optional exterior "holiday" lights Description: - Log the error message along with the backtrace when an applied measure fails - Currently, the apply_measure function only logs the error backtrace when the measure being applied fails, but not the actual error message. This fixes the issue, and logs the error message alongside the backtrace. + Split ResidentialLighting into separate ResidentialLightingInterior and ResidentialLightingOther (with optional exterior holiday lighting) measures + This involves modifications to: + ResidentialLightingOther measure + 4 new arguments (daily energy use, holiday period start, holiday period end, holiday schedule) + unit test for verifying that exterior lighting increases by, e.g., 41 days * 1.1 kWh/day = 45 kWh + lighting.rb + new apply_exterior_holiday method + assigning end use subcategories to all light objects + options_lookup.tsv and testing project + existing lighting options now get default holiday argument values + new lighting option to test exterior holiday lighting + SimulationOutputReport / TimeseriesCSVExport measures + custom meters for "garage lighting" and "exterior holiday lighting" + reporting "garage lighting" and "exterior holiday lighting" - Assignees: Rajendra + Assignees: Joe Robertson .. change:: - :tags: workflow, testing, bugfix - :pullreq: 320 + :tags: workflow, lighting, feature + :pullreq: 244 - **Date**: 2019-09-23 + **Date**: 2019-05-06 Title: - Fixes #319 + Lighting measure changes Description: - Add tests to ensure that the Run Measure argument is correctly defined in all Apply Upgrade measures for all projects - Fixes #319. Added tests to ensure that the Run Measure argument is correctly defined in all Apply Upgrade measures for all projects. + Split ResidentialLighting into separate ResidentialLightingInterior and ResidentialLightingOther (with optional exterior holiday lighting) measures - Assignees: Scott + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 330 + :tags: workflow, reporting, feature + :pullreq: 245 - **Date**: 2019-10-17 + **Date**: 2019-05-02 Title: - Fix assignment of bedrooms to units + Register climate zones Description: - Bugfix when specifying numbers of bedrooms to building units - This fixes a bug when you try to assign, e.g., 3, 2, 1, 2, 2, 3 numbers of bedrooms to 6 building units. + Register climate zones (BA and IECC) based on the simulation EPW file + This is a pretty simple and straightforward PR: it adds two columns "climate_zone_ba" and "climate_zone_iecc" (based on the epw) to the results csv. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, testing, bugfix - :pullreq: 331 + :tags: workflow, testing, feature + :pullreq: 237 - **Date**: 2019-10-18 + **Date**: 2019-04-22 Title: - Enforce rubocop as separate ci test + Integrity check unit tests Description: - Enforce rubocop as CI test so code with offenses cannot be merged - Code can no longer be committed to the repo with rubocop offenses. + Unit tests and performance improvements for integrity checks + Adds unit tests to make sure that the integrity checks are covering various potential scenarios that would cause errors. Each unit test consists of a housing_characteristics dir with custom TSVs and corresponding options in the test_options_lookup.tsv that should cause the error. The unit tests check that the appropriate error message is hit. - Assignees: Joe + Assignees: Scott Horowitz .. change:: - :tags: characteristics, mechanics, bugfix - :pullreq: 329 + :tags: workflow, testing, feature + :pullreq: 239 - **Date**: 2019-10-17 + **Date**: 2019-04-22 Title: - Add more efficient options for dw, cw, cd + Integrity check performance improvement Description: - Bugfix for some clothes washer, dishwasher options causing increased energy consumption - We need "more efficient" options for idsm-scout and mf aedg. Currently, the dw, cw options are causing increased energy consumption. Janet had started to look into this. Turns out things related to the energy guide label, like rated_annual_energy, annual_cost, and test_date, had not been updated. + Unit tests and performance improvements for integrity checks + Dramatically improves the speed of performing measure argument checks. Rather than checking every combination of option for every parameter that contributes to a single measure's arguments, we now pick options from each parameter in step. - Assignees: Joe + Assignees: Scott Horowitz .. change:: - :tags: characteristics, mechanics, bugfix - :pullreq: 333 + :tags: workflow, mechanics, feature + :pullreq: 228 - **Date**: 2019-10-23 + **Date**: 2019-04-12 Title: - Update the cw options a bit + TSV Speed Improvements Description: - Bugfix for some clothes washer, dishwasher options causing increased energy consumption - Reduce IMEF on the "more" efficient option. Change drum volume on "most" efficient option. Add links in unit tests to actual clothes washer examples pulled from energystar. + Unit tests and performance improvements for integrity checks + This PR substantially speeds up integrity checks for TSVs with large numbers of rows (and has the side benefit of speeding up sampling) by using caching. - Assignees: Joe + Assignees: Scott Horowitz diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_0.rst b/docs/read_the_docs/source/changelog/changelog_2_2_0.rst index 468ded2932..0f6b35ef99 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_0.rst @@ -8,75 +8,22 @@ v2.2.0 Changelog .. change:: :tags: workflow, mechanics, feature - :pullreq: 371 - - **Date**: 2020-01-24 - - Title: - Addresses #352, optionally include annual totals for end use subcategories - - Description: - The results csv now optionally reports annual totals for all end use subcategories, including appliances, plug loads, etc. - Can now optionally report (using the SimulationOutputReport measure) annual totals for end use subcategories (same as for the TimeseriesCSVExport measure) in the results csv. Measure also checks that the sum of the end use subcategories equals the reported interior equipment value. - - Assignees: Joe - - - .. change:: - :tags: workflow, misc loads, feature - :pullreq: 362 - - **Date**: 2020-01-29 - - Title: - More none no natl avg - - Description: - Split out national average options so not all homes have all miscellaneous equipment, and add none options to appliances - Split out national average options so not all homes have all miscellaneous equipment, and add none options to appliances - - Assignees: Tony - - - .. change:: - :tags: characteristics, envelope, feature - :pullreq: 357 - - **Date**: 2020-01-18 - - Title: - Tsv wall w hcs reformat - - Description: - Update the single-family detached project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls - [Added the TSV for wall type, masonry and wood. added dependency to the Insulation Wall TSV; additional options for CMU walls(post-1950) and 3" wythe brick wall] - - Assignees: Maharshi - - - .. change:: - :tags: characteristics, mechanics, feature - :pullreq: 353 + :pullreq: 346 - **Date**: 2020-01-17 + **Date**: 2020-01-30 Title: - Make housing characteristics format consistent. + Addresses #344, adjust timeseries csv index for DST Description: - Made housing characteristics a consistent format. Added integrity check to ensure housing characteristics follow the guildelines specified in read-the-docs - In the effort to make the format more consistent, the following format has been applied to the housing characteristics. Standardizing the format of the housing characteristics should make it easier to see differences in commits - - All line terminators are '\r\n' which is consistent with Windows machines. - All Option columns have format '%.6f'. - All [For Reference Only] Source Sample Size columns are type 'int'. - All [For Reference Only] Source Weight columns are type 'int'. + Include additional "daylight saving time" and "utc time" columns to timeseries csv file to account for one hour forward and backward time shifts + The TimeseriesCSVExport measure outputs time at a constant interval across a year, regardless of time changes for daylight savings time. This can cause confusion, as E+ shifts schedules to account for DST, but our time output does not line up with this shift. - Assignees: Tony + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, feature + :tags: workflow, reporting, bugfix :pullreq: 346 **Date**: 2020-01-30 @@ -85,58 +32,57 @@ v2.2.0 Changelog Addresses #344, adjust timeseries csv index for DST Description: - Include additional "daylight saving time" and "utc time" columns to timeseries csv file to account for one hour forward and backward time shifts + Update each PAT project's AMI selection to "2.9.0" The TimeseriesCSVExport measure outputs time at a constant interval across a year, regardless of time changes for daylight savings time. This can cause confusion, as E+ shifts schedules to account for DST, but our time output does not line up with this shift. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: characteristics, recs, feature - :pullreq: 340 + :tags: workflow, misc loads, feature + :pullreq: 362 - **Date**: 2019-11-26 + **Date**: 2020-01-29 Title: - RECS 2015 tsv maker + More none no natl avg Description: - Update bedrooms and occupants tsv files with options and probability distributions based on RECS 2015 data - RECS 2015 tsv maker + Split out national average options so not all homes have all miscellaneous equipment, and add none options to appliances - Assignees: Joe + Assignees: Anthony Fontanini .. change:: - :tags: workflow, reporting, feature - :pullreq: 334 + :tags: workflow, mechanics, feature + :pullreq: 371 - **Date**: 2019-11-05 + **Date**: 2020-01-24 Title: - Report quantities of interest + Addresses #352, optionally include annual totals for end use subcategories Description: - Add new QOIReport measure for reporting seasonal quantities of interest for uncertainty quantification - Reporting quantities of interest for EULP uncertainty quantification. + The results csv now optionally reports annual totals for all end use subcategories, including appliances, plug loads, etc. + Can now optionally report (using the SimulationOutputReport measure) annual totals for end use subcategories (same as for the TimeseriesCSVExport measure) in the results csv. Measure also checks that the sum of the end use subcategories equals the reported interior equipment value. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: characteristics, mechanics, feature - :pullreq: 338 + :tags: workflow, mechanics, bugfix + :pullreq: 371 - **Date**: 2019-11-07 + **Date**: 2020-01-24 Title: - Update sfd, mf, and testing tsv structure + Addresses #352, optionally include annual totals for end use subcategories Description: - Separate tsv files for bedrooms, cooking range schedule, corridor, holiday lighting, interior/other lighting use, pool schedule, plug loads schedule, and refrigeration schedule - Update sfd, mf, and testing tsv structure + Custom meters for ceiling fan, hot water recirc pump, and vehicle end use subcategories were not properly implemented + Can now optionally report (using the SimulationOutputReport measure) annual totals for end use subcategories (same as for the TimeseriesCSVExport measure) in the results csv. Measure also checks that the sum of the end use subcategories equals the reported interior equipment value. - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -152,23 +98,23 @@ v2.2.0 Changelog Allow Wood Stove option as an upgrade, and account for wood heating energy in simulation output I added a bugfix for the upgrade so that the EnergyPlus simulation is successful. - Assignees: Scott + Assignees: Scott Horowitz .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 371 + :tags: characteristics, envelope, feature + :pullreq: 357 - **Date**: 2020-01-24 + **Date**: 2020-01-18 Title: - Addresses #352, optionally include annual totals for end use subcategories + Tsv wall w hcs reformat Description: - Custom meters for ceiling fan, hot water recirc pump, and vehicle end use subcategories were not properly implemented - Can now optionally report (using the SimulationOutputReport measure) annual totals for end use subcategories (same as for the TimeseriesCSVExport measure) in the results csv. Measure also checks that the sum of the end use subcategories equals the reported interior equipment value. + Update the single-family detached project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls + [Added the TSV for wall type, masonry and wood. added dependency to the Insulation Wall TSV; additional options for CMU walls(post-1950) and 3" wythe brick wall] - Assignees: Joe + Assignees: Maharshi Pathak .. change:: @@ -184,7 +130,27 @@ v2.2.0 Changelog Some re-labeling of tsv files, such as "Geometry Building Type" to "Geometry Building Type RECS" and "Geometry Building Type FPL" to "Geometry Building Type ACS" [Changes in the naming convention of hcs with the new hcs format included. ] - Assignees: Maharshi + Assignees: Maharshi Pathak + + + .. change:: + :tags: characteristics, mechanics, feature + :pullreq: 353 + + **Date**: 2020-01-17 + + Title: + Make housing characteristics format consistent. + + Description: + Made housing characteristics a consistent format. Added integrity check to ensure housing characteristics follow the guildelines specified in read-the-docs + In the effort to make the format more consistent, the following format has been applied to the housing characteristics. Standardizing the format of the housing characteristics should make it easier to see differences in commits + All line terminators are '\r\n' which is consistent with Windows machines. + All Option columns have format '%.6f'. + All [For Reference Only] Source Sample Size columns are type 'int'. + All [For Reference Only] Source Weight columns are type 'int'. + + Assignees: Anthony Fontanini .. change:: @@ -198,9 +164,8 @@ v2.2.0 Changelog Description: Removes option "Auto" from parameter "Occupants" in the options lookup file - Remove "auto" option for number of occupants - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -218,42 +183,38 @@ v2.2.0 Changelog Use Geometry Building Type.tsv as dependency for Neighbors.tsv in multifamily project Use Geometry Building Type.tsv as dependency for Orientation.tsv in multifamily project - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, reporting, bugfix - :pullreq: 346 + :tags: workflow, lighting, bugfix + :pullreq: 349 - **Date**: 2020-01-30 + **Date**: 2019-12-11 Title: - Addresses #344, adjust timeseries csv index for DST + Lighting fixes Description: - Update each PAT project's AMI selection to "2.9.0" - The TimeseriesCSVExport measure outputs time at a constant interval across a year, regardless of time changes for daylight savings time. This can cause confusion, as E+ shifts schedules to account for DST, but our time output does not line up with this shift. + Fixes for custom output meters: total site electricity double-counting exterior holiday lighting, and garage lighting all zeroes + Addresses bugs in custom output meters found by @rajeee and @afontani: - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, lighting, bugfix - :pullreq: 349 + :tags: characteristics, recs, feature + :pullreq: 340 - **Date**: 2019-12-11 + **Date**: 2019-11-26 Title: - Lighting fixes + RECS 2015 tsv maker Description: - Fixes for custom output meters: total site electricity double-counting exterior holiday lighting, and garage lighting all zeroes - Addresses bugs in custom output meters found by @rajeee and @afontani: - - total site electricity double-counting exterior holiday lighting - garage lighting all zeroes + Update bedrooms and occupants tsv files with options and probability distributions based on RECS 2015 data - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -267,13 +228,43 @@ v2.2.0 Changelog Description: Remove shared facades tsv files from the multifamily_beta and testing projects - Remove shared facades - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, reporting, bugfix + :tags: workflow, power outage, bugfix + :pullreq: 238 + + **Date**: 2019-11-13 + + Title: + Updates to outage measure + + Description: + Fix for the power outages measure where the last hour of the day was not getting the new schedule applied + It looked like the last hour of the day wasn't getting the new schedule applied. This fixes that. I've also cleaned up some code and added some new unit tests. + + Assignees: Joe Robertson + + + .. change:: + :tags: characteristics, mechanics, feature + :pullreq: 338 + + **Date**: 2019-11-07 + + Title: + Update sfd, mf, and testing tsv structure + + Description: + Separate tsv files for bedrooms, cooking range schedule, corridor, holiday lighting, interior/other lighting use, pool schedule, plug loads schedule, and refrigeration schedule + + Assignees: Joe Robertson + + + .. change:: + :tags: workflow, reporting, feature :pullreq: 334 **Date**: 2019-11-05 @@ -282,25 +273,24 @@ v2.2.0 Changelog Report quantities of interest Description: - Move redundant output meter code from individual reporting measures out into shared resource file - Move redundant output meter code from individual reporting measures out into shared resource file + Add new QOIReport measure for reporting seasonal quantities of interest for uncertainty quantification + Reporting quantities of interest for EULP uncertainty quantification. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, power outage, bugfix - :pullreq: 238 + :tags: workflow, reporting, bugfix + :pullreq: 334 - **Date**: 2019-11-13 + **Date**: 2019-11-05 Title: - Updates to outage measure + Report quantities of interest Description: - Fix for the power outages measure where the last hour of the day was not getting the new schedule applied - It looked like the last hour of the day wasn't getting the new schedule applied. This fixes that. I've also cleaned up some code and added some new unit tests. + Move redundant output meter code from individual reporting measures out into shared resource file - Assignees: Joe + Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_1.rst b/docs/read_the_docs/source/changelog/changelog_2_2_1.rst index 578de95b2b..db206b1c22 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_1.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_1.rst @@ -7,23 +7,22 @@ v2.2.1 Changelog :released: 2020-02-07 .. change:: - :tags: characteristics, envelope, feature - :pullreq: 382 + :tags: characteristics, envelope, bugfix + :pullreq: 387 - **Date**: 2020-02-04 + **Date**: 2020-02-07 Title: - Multifamily masonry walls + Addresses #386, fix misc pool tsv files and updates project_singlefamilydetached masonry walls Description: - Update the multifamily project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls - Adding in masonry walls via "Geometry Wall Type" tsv and adding a new dependency in "Insulation Wall". Mimics work done by Maharshi for project_singlefamily. Also created a new tsv_maker for RECS 2009 + Add generation of the Geometry Wall Type tsv file for the single-family detached project to the 2009 RECS tsv maker; this corrects the tsv file - Assignees: Janet + Assignees: Joe Robertson .. change:: - :tags: characteristics, envelope, bugfix + :tags: characteristics, misc loads, bugfix :pullreq: 387 **Date**: 2020-02-07 @@ -32,26 +31,26 @@ v2.2.1 Changelog Addresses #386, fix misc pool tsv files and updates project_singlefamilydetached masonry walls Description: - Add generation of the Geometry Wall Type tsv file for the single-family detached project to the 2009 RECS tsv maker; this corrects the tsv file - Addresses #386, fix misc pool tsv files and updates project_singlefamilydetached masonry walls + Add generation of the Misc Pool tsv file (with Geometry Building Type and Location Region dependencies) to the 2009 RECS tsv maker; this also corrects having pool pumps for all homes + Fix pool pump probabilities - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: characteristics, misc loads, bugfix - :pullreq: 387 + :tags: characteristics, envelope, feature + :pullreq: 382 - **Date**: 2020-02-07 + **Date**: 2020-02-04 Title: - Addresses #386, fix misc pool tsv files and updates project_singlefamilydetached masonry walls + Multifamily masonry walls Description: - Add generation of the Misc Pool tsv file (with Geometry Building Type and Location Region dependencies) to the 2009 RECS tsv maker; this also corrects having pool pumps for all homes - Fix pool pump probabilities + Update the multifamily project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls + Adding in masonry walls via "Geometry Wall Type" tsv and adding a new dependency in "Insulation Wall". Mimics work done by Maharshi for project_singlefamily. Also created a new tsv_maker for RECS 2009 - Assignees: Joe + Assignees: Janet Reyna .. change:: @@ -65,8 +64,7 @@ v2.2.1 Changelog Description: Refactor the RECS tsv makers for years 2009 and 2015 - Refactor the RECS tsv makers for years 2009 and 2015 - Assignees: Janet + Assignees: Janet Reyna diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_2.rst b/docs/read_the_docs/source/changelog/changelog_2_2_2.rst index f3cc34c095..f09d1cfc29 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_2.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_2.rst @@ -4,7 +4,7 @@ v2.2.2 Changelog .. changelog:: :version: v2.2.2 - :released: 2020-02-19 + :released: 2020-02-21 .. change:: :tags: workflow, weather, bugfix @@ -19,6 +19,6 @@ v2.2.2 Changelog Update the datapoint initialization script to download weather files to a common zip filename Current curl command in datapoint init script guaranteed aws s3 downloads to work, but not downloads from other hosts (e.g., dropbox). Changing the curl command to be more generic. - Assignees: Joe + Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_3.rst b/docs/read_the_docs/source/changelog/changelog_2_2_3.rst index fd8d6dddc9..8fae39076b 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_3.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_3.rst @@ -4,7 +4,7 @@ v2.2.3 Changelog .. changelog:: :version: v2.2.3 - :released: 2020-03-09 + :released: 2020-03-10 .. change:: :tags: workflow, weather, bugfix @@ -17,8 +17,7 @@ v2.2.3 Changelog Description: Update the weather zip file url in each PAT project to point to data.nrel.gov - Release 2_2_3 patch - Assignees: Joe + Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_4.rst b/docs/read_the_docs/source/changelog/changelog_2_2_4.rst index a1415a6ae1..54491ab0f7 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_4.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_4.rst @@ -4,7 +4,7 @@ v2.2.4 Changelog .. changelog:: :version: v2.2.4 - :released: 2020-04-28 + :released: 2020-05-01 .. change:: :tags: workflow, airflow, bugfix @@ -18,9 +18,8 @@ v2.2.4 Changelog Description: Fix bug in options lookup where buildings without heating systems were not being assigned the required "has_hvac_flue" airflow measure argument Argument has_hvac_flue for ResidentialAirflow wasn't being assigned when no heating system was sampled. - The proposed solution here is to move the has_hvac_flue argument from the ResidentialAirflow measure out into the HVAC equipment measures (furnace, boiler, unit heater, shared systems). The value assigned to has_hvac_flue will be set as an additional property on the Building model object, and then the airflow measure will parse it from the Building model object. If it doesn't exist, then the value will be set to false. - Assignees: Joe + Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_5.rst b/docs/read_the_docs/source/changelog/changelog_2_2_5.rst index b4b8bbd3fb..fac6360ffb 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_5.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_5.rst @@ -17,8 +17,7 @@ v2.2.5 Changelog Description: Update the weather zip file url in each PAT project to point to a different location at data.nrel.gov - Release 2_2_5 patch - Assignees: Joe + Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_2_3_0.rst b/docs/read_the_docs/source/changelog/changelog_2_3_0.rst index 1dbfcb2c99..26b4774ce1 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_3_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_3_0.rst @@ -7,368 +7,350 @@ v2.3.0 Changelog :released: 2020-06-24 .. change:: - :tags: workflow, mechanics, feature - :pullreq: 402 - - **Date**: 2020-02-17 - - Title: - Remove single-family detached, PAT projects - - Description: - Remove the single-family detached project, and remove PAT from the testing and multifamily projects - Remove single-family detached, PAT projects - - Assignees: Joe - - - .. change:: - :tags: characteristics, mechanics, feature - :pullreq: 401 + :tags: workflow, mechanics, bugfix + :pullreq: 459 - **Date**: 2020-02-17 + **Date**: 2020-06-23 Title: - Move data folder into resstock-estimation + Rename multifamily_beta to national Description: - Relocate the data folder, along with tsv makers, to a separate private repository - Folder data moved here: https://github.com/NREL/resstock-estimation + Rename "project_multifamily_beta" to "project_national" - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: characteristics, lighting, feature - :pullreq: 392 + :tags: workflow, heat pumps, bugfix + :pullreq: 454 - **Date**: 2020-02-13 + **Date**: 2020-06-10 Title: - Update lighting distribution. + MSHP pan heater custom meter Description: - Update the single-family detached and multifamily projects with more up-to-date lighting stock distributions - The old lighting distribution is weighted too heavily towards incandescent bulbs. New distribution data is from 2015 in the 2015 U.S. Lighting Market Characterization study. Option= 100% Incandescent include Incandescent, HID, Halogen, and Other. Option=100% CFL include CFL and LFL. Option=100% LED include LED. + Add mini-split heat pump pan heater to custom meter for heating electricity + Exclude mshp pan heater from being added to the electric interior equipment meter. Instead, add it to the electric heating meter. - Assignees: Tony + Assignees: Joe Robertson .. change:: - :tags: characteristics, envelope, feature - :pullreq: 395 + :tags: workflow, mechanics, bugfix + :pullreq: 452 - **Date**: 2020-02-18 + **Date**: 2020-06-10 Title: - adding in diversity to MF roof insulation. + fix bug for small window areas Description: - Update Insulation Finished Attic tsv with more options for insulation levels - Improve diversity for MF roof insulation by manually copying SF roof insulation (from Insulation Unfinished Attic). In the future, script NAHB / RBSA to pull MF distribution and also improve attic / non-attic split. + Fix bug in assigning small window areas to surfaces + @whiphi92 uncovered a bug that would throw an error when the calculated window area of a facade was less than the minimum allowable window area. This fix checks for that case and applies the invalid window area to the largest available surface. - Assignees: Janet + Assignees: Andrew Speake .. change:: - :tags: workflow, mechanics, feature - :pullreq: 408 + :tags: workflow, mechanics, bugfix + :pullreq: 453 - **Date**: 2020-02-21 + **Date**: 2020-05-21 Title: - Ignore comment lines + Assign daylight saving dates based on County Description: - Add ability to ignore comment lines with the "#" symbol - This pull request is an effort to make the housing characteristics more machine-readable. The created by line is causing issues when reading the files programmatically. The resolution is that we have ResStock ignore comment lines. The comment lines begin with the "#" symbol. + Assign daylight saving start/end dates based on county and not epw region + Assign dst_start_date and dst_end_date based on county instead of epw location. This eliminates the possibility of simulating a building without daylight saving dates when it is near, but not within, Arizona. - Assignees: Tony + Assignees: Joe Robertson .. change:: - :tags: characteristics, occupants, plug loads, feature - :pullreq: 324 + :tags: workflow, ceiling fan, bugfix + :pullreq: 445 - **Date**: 2020-03-05 + **Date**: 2020-05-12 Title: - Update to RECS 2015 + Update ceiling fan options Description: - Update occupant and plug loads equations based on RECS 2015 data; replace floor area with occupants as independent variable in plug loads equation; allow modeling of zero-bedroom units (e.g., studios) - To summarize, this: - - solves for Nbr (in terms of Nocc) for: - sinks, showers, baths - range, dishwasher, clothes washer, clothes dryer - plug loads, large uncommon loads - replaces plug loads equation with RECS 2015-derived - - resstock-estimation: `pull request 12 `_ + Update ceiling fan tsv to remove the "National Average" option, and instead sample 28% "None" and 72% "Standard Efficiency" + Update ceiling fan options and tsvs according to: https://trello.com/c/yBmLc3OU/23-ceiling-fans - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: characteristics, geospatial, feature - :pullreq: 416 + :tags: workflow, mechanics, feature + :pullreq: 438 - **Date**: 2020-03-02 + **Date**: 2020-04-30 Title: - Geospatial + Specify key value in timeseries reporting Description: - New geospatial characteristics have been added or updated. New geospatial characteristics are as follows: ASHRAE IECC Climate Zone 2004, State, County, PUMA, Census Division, Census Region, Building America Climate Zone, and ISO/RTO Region. The top level housing characteristic is now ASHRAE IECC Climate Zone 2004. Now using data from the American Community Survey Public Use Microdata Sample (ACS PUMS) for Building Type, Vintage, and Heating Fuel - This pull request is aimed at adding some spatial specification of ResStock samples. Currently, there are only two spatial descriptions in the housing characteristics: 1) Location (the epw weather file regions), and 2) Location Region (RECS defined Custom Regions) This pull request creates 10 housing characteristic files that help spatially define the location of a sampled housing unit. + Allow a key value to be specified when outputting timeseries variables + Allows users to specify a key value when requesting timeseries csvs, for example: + output_variables: Surface Outside Face Incident Solar Radiation Rate per Area|Surface 2 outputs the variable for just Surface 2, instead of every surface. - Assignees: Tony + Assignees: Andrew Speake .. change:: - :tags: characteristics, hvac, feature - :pullreq: 418 + :tags: workflow, weather, bugfix + :pullreq: 432 - **Date**: 2020-03-02 + **Date**: 2020-04-06 Title: - Chicago AC saturation + Weather file update Description: - Update HVAC System Cooling tsv with air-conditioning saturations ("None", "Room AC", or "Central AC") from American Housing Survey for Custom Region 04. Efficiency probabilities remain based on RECS 2009 - During data source comparison, it was discovered that we probably have cooling saturation too low for Chicago. AHS is probably a better source for cooling saturation that we should use going forward. In the meantime, I pulled AC type saturation from AHS (None, Room AC , Central), and adjusted the distributions for each of these within the HVAC System Cooling tsv, but still using the efficiency breakdowns from RECS. Only CR04 was adjusted for the moment (which includes Chicago), using East North Central as an approximation for CR04 (the difference is the state of Wisconsin). In the future, we should probably separate saturation from efficiency in separate TSVs so we can use AHS for saturation and RECS for efficiency. + Remove Location Weather Filename and Location Weather Year tsvs, and update options lookup to reflect updated weather file changes; weather filenames are now required to match what is in the options lookup + Presently, to update the weather year files, we would need to make changes to the Location Weather Filename and Location Weather Year tsvs. While this approach is fine with two weather years i.e. TMY3 and AMY weather files presently, it creates a 'ballooning' effect when one begins to add more weather years as the location weather filename tsv will need the addition of 216 EPWs to its rows and columns for each AMY year. To resolve this issue, we: + rename all epw weather filenames such that names are consistent between all years. New location weather filename data can be found here + delete location weather filename and location weather year as the names are now consistent between years + update options lookup tsv by adding weather filename arguments to the location tsv + update options lookup tsv by removing 'location weather filename' and 'location weather year' arguments - Assignees: Janet + Assignees: Tobi Adekanye .. change:: - :tags: characteristics, setpoints, feature - :pullreq: 414 + :tags: workflow, mechanics, bugfix + :pullreq: 433 - **Date**: 2020-03-05 + **Date**: 2020-04-02 Title: - Fuzzy schedules + ix qoi report measure to handle locations without a season Description: - Diversify the timing heating and cooling setpoint setbacks - Smears the Heating and Cooling offset schedules period +- 2hours around existing times. + Fix bug in QOI reporting measure where absence of any heating/cooling/overlap seasons would cause errors + The QOI report measure timing section has two errors: + If there are no days with mean daily temperature above 70F (summer), the measure will fail, as the summer season does not exist. Common in climate zones 7+ + The daily_vals object is comprised of two arrays, and the intent is to get the array length. This fixes the timing reporting in the measure. - Assignees: Rajendra + Assignees: Matt Dahlhausen, Joe Robertson .. change:: - :tags: characteristics, appliances, feature - :pullreq: 420 + :tags: workflow, envelope, bugfix + :pullreq: 426 - **Date**: 2020-03-12 + **Date**: 2020-04-01 Title: - Major appliance sat + Roofing material restructure Description: - Reduce the number of appliances in multifamily units. Adding RECS building type as a dependencies to clothes washers, clothes dryers, dishwashers, refrigerators, extra refrigerators, and stand-alone freezers. Update refrigeration levels based on RECS 2009 age and shipment-weighted efficiency by year. Now using the American Housing Survey (AHS) for clothes washer and clothes dryer saturations. New geographic field, AHS Region, which uses the top 15 largest Core Based Statistical Areas (CBSAs) and Non-CBSA Census Divisions - The purpose of this pull request is to reduce the number of appliances in multifamily units. The current assumption is that all units have Dishwashers and Clothes Washers. However multifamily units should have a lower probability of having laundry facilities (in unit) and extra refrigerators and stand-alone freezers. As a result, building type dependency was added to these characteristics and the fraction of units without the appliances is adjusted. + Restructure unfinished attic and finished roof -related tsv files (i.e., insulation, roof material, and radiant barrier) and options + Previously, we had: + No "None" option for Insulation Unfinished Attic.tsv + Roofing Material.tsv assigned roofing_material arguments for both ResidentialConstructionsUnfinishedAttic and ResidentialConstructionsFinishedRoof + The issue with the previous is that if we try to upgrade just roofing_material, measure ResidentialConstructionsFinishedRoof is applied without all measure arguments specified. By adding the building type dependency to Insulation Unfinished Attic.tsv, Insulation Finished Roof.tsv, and both Roofing Material.tsv files, we can avoid this issue. - Assignees: Tony + Assignees: Joe Robertson .. change:: - :tags: characteristics, lighting, feature - :pullreq: 419 + :tags: workflow, water heater, bugfix + :pullreq: 375 - **Date**: 2020-03-12 + **Date**: 2020-03-25 Title: - Update the ResidentialLightingOther schedule in the options_lookup.tsv + Update Water Heater=Other Fuel to map to no water heater Description: - Exterior lighting schedule changed from using interior lighting sunrise/sunset algorithm to T24 2016 Residential ACM Appendix C Table 8 Exterior Lighting Hourly Multiplier for weekdays and weekends - The old schedules were from the T24 2016 Residential ACM, except they were using the residential MELS schedule instead of the exterior lighting schedule. This commit updates to use the properly intended exterior lighting schedule instead. - - See the T24 2016 Residential ACM and the Plug Loads and Lighting Modeling CASE report from Energy Solutions for more information. + Allow a building to be simulated with no water heater; map the "Other Fuel" option from the Water Heater tsv to no water heater + update cw, cd, dw, fixtures, distribution measures to skip when not finding a water heater - Assignees: Tony, Eric + Assignees: Joe Robertson .. change:: - :tags: characteristics, floor area, feature - :pullreq: 425 + :tags: characteristics, infiltration, feature + :pullreq: 427 - **Date**: 2020-03-17 + **Date**: 2020-03-24 Title: - Increase floor area diversity + Update Infiltration.tsv based on the Residential Diagnostics Database. Description: - Increase the diversity of the floor areas that are simulated. Geometry House Size has been replaced by Geometry Floor Area Bin and Geometry Floor Area. Now using AHS for specifying the floor area. Floor areas differ by non-Core Based Statistical Areas (CBSAs) Census Divisions and the top 15 largest CBSAs - The purpose of this pull request is to diversify the floor area values that are simulated in ResStock. There are now two floor area bins housing characteristics, Geometry Floor Area Coarse and Geometry Floor Area Fine. These two housing characteristics are replacing the Geometry House Size housing characteristic. The Geometry Floor Area Coarse characteristics is meant to be used as a dependency for other RECS queries. The small number of bins (as before in Geometry House Size) does not slice RECS into many bins and retains reasonable sample sizes for housing characteristics dependent on Geometry Floor Area Coarse (Geometry Garage, Geometry Stories, Bedrooms, and Infiltration). The Geometry Floor Area Fine are bins based on the American Housing Survey (AHS). To maintain consistency between the two characteristics the bin sizes have been updated in Geometry Floor Area Coarse. The total_ffa and unit_ffa arguments in options_lookup.tsv are obtained from Geometry Floor Area Fine bin averages from RECS 2015. + Increase the diversity of the infiltration simulated. Now using the Residential Diagnostics Database for the Infiltration housing characteristic + The purpose of this pull request is to diversify and update the infiltration housing characteristic. Currently, infiltration is based on the regression from Chan et al. (also based on LBL ResDB). As the regression produces a single infiltration value for a given set of input parameters, the probability distributions specified in the Infiltration.tsv are binary (only 0 and 1). In reality, the distributions are more continuous. + In this pull request, the Infiltration.tsv has been updated with data from the Residential Diagnostics Database (ResDB). The cumulative distribution functions (CDFs) for air change at 50 Pa (ACH50) have been downloaded from their website. Each CDF from the website was fit with a lognormal distribution. The fitted lognormal distribution is then used to assign probabilities into the infiltration bins in ResStock. - resstock-estimation: `pull request 19 `_ + resstock-estimation: `pull request 20 `_ - Assignees: Tony + Assignees: Anthony Fontanini .. change:: - :tags: characteristics, infiltration, feature - :pullreq: 427 + :tags: characteristics, windows, bugfix + :pullreq: 412 **Date**: 2020-03-24 Title: - Update Infiltration.tsv based on the Residential Diagnostics Database. + Add wwr variation per RBSA II data Description: - Increase the diversity of the infiltration simulated. Now using the Residential Diagnostics Database for the Infiltration housing characteristic - The purpose of this pull request is to diversify and update the infiltration housing characteristic. Currently, infiltration is based on the regression from Chan et al. (also based on LBL ResDB). As the regression produces a single infiltration value for a given set of input parameters, the probability distributions specified in the Infiltration.tsv are binary (only 0 and 1). In reality, the distributions are more continuous. - - In this pull request, the Infiltration.tsv has been updated with data from the Residential Diagnostics Database (ResDB). The cumulative distribution functions (CDFs) for air change at 50 Pa (ACH50) have been downloaded from their website. Each CDF from the website was fit with a lognormal distribution. The fitted lognormal distribution is then used to assign probabilities into the infiltration bins in ResStock. + Diversify window to wall ratio variation using the Residential Building Stock Assessment (RBSA) II data + Per comments on that PR and discussion with @mdahlhausen, there are still changes that might happen before merging. + binned WWRs for multifamily and single family buildings from RBSA II data + for calculations, see WWR estimates in EULP calibration directory on sharepoint + Assuming '50 or more Unit' building type is midrise/highrise with default 30% WWR for all buildings - resstock-estimation: `pull request 20 `_ + resstock-estimation: `pull request 21 `_ - Assignees: Tony + Assignees: Andrew Parker, Anthony Fontanini .. change:: - :tags: workflow, mechanics, feature - :pullreq: 438 + :tags: characteristics, floor area, feature + :pullreq: 425 - **Date**: 2020-04-30 + **Date**: 2020-03-17 Title: - Specify key value in timeseries reporting + Increase floor area diversity Description: - Allow a key value to be specified when outputting timeseries variables - Allows users to specify a key value when requesting timeseries csvs, for example: - output_variables: Surface Outside Face Incident Solar Radiation Rate per Area|Surface 2 outputs the variable for just Surface 2, instead of every surface. + Increase the diversity of the floor areas that are simulated. Geometry House Size has been replaced by Geometry Floor Area Bin and Geometry Floor Area. Now using AHS for specifying the floor area. Floor areas differ by non-Core Based Statistical Areas (CBSAs) Census Divisions and the top 15 largest CBSAs + The purpose of this pull request is to diversify the floor area values that are simulated in ResStock. There are now two floor area bins housing characteristics, Geometry Floor Area Coarse and Geometry Floor Area Fine. These two housing characteristics are replacing the Geometry House Size housing characteristic. The Geometry Floor Area Coarse characteristics is meant to be used as a dependency for other RECS queries. The small number of bins (as before in Geometry House Size) does not slice RECS into many bins and retains reasonable sample sizes for housing characteristics dependent on Geometry Floor Area Coarse (Geometry Garage, Geometry Stories, Bedrooms, and Infiltration). The Geometry Floor Area Fine are bins based on the American Housing Survey (AHS). To maintain consistency between the two characteristics the bin sizes have been updated in Geometry Floor Area Coarse. The total_ffa and unit_ffa arguments in options_lookup.tsv are obtained from Geometry Floor Area Fine bin averages from RECS 2015. + + resstock-estimation: `pull request 19 `_ - Assignees: Andrew + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 459 + :tags: characteristics, appliances, feature + :pullreq: 420 - **Date**: 2020-06-23 + **Date**: 2020-03-12 Title: - Rename multifamily_beta to national + Major appliance sat Description: - Rename "project_multifamily_beta" to "project_national" - Rename multifamily_beta to national + Reduce the number of appliances in multifamily units. Adding RECS building type as a dependencies to clothes washers, clothes dryers, dishwashers, refrigerators, extra refrigerators, and stand-alone freezers. Update refrigeration levels based on RECS 2009 age and shipment-weighted efficiency by year. Now using the American Housing Survey (AHS) for clothes washer and clothes dryer saturations. New geographic field, AHS Region, which uses the top 15 largest Core Based Statistical Areas (CBSAs) and Non-CBSA Census Divisions + The purpose of this pull request is to reduce the number of appliances in multifamily units. The current assumption is that all units have Dishwashers and Clothes Washers. However multifamily units should have a lower probability of having laundry facilities (in unit) and extra refrigerators and stand-alone freezers. As a result, building type dependency was added to these characteristics and the fraction of units without the appliances is adjusted. - Assignees: Joe + Assignees: Anthony Fontanini .. change:: - :tags: workflow, heat pumps, bugfix - :pullreq: 454 + :tags: characteristics, lighting, feature + :pullreq: 419 - **Date**: 2020-06-10 + **Date**: 2020-03-12 Title: - MSHP pan heater custom meter + Update the ResidentialLightingOther schedule in the options_lookup.tsv Description: - Add mini-split heat pump pan heater to custom meter for heating electricity - Exclude mshp pan heater from being added to the electric interior equipment meter. Instead, add it to the electric heating meter. + Exterior lighting schedule changed from using interior lighting sunrise/sunset algorithm to T24 2016 Residential ACM Appendix C Table 8 Exterior Lighting Hourly Multiplier for weekdays and weekends + The old schedules were from the T24 2016 Residential ACM, except they were using the residential MELS schedule instead of the exterior lighting schedule. This commit updates to use the properly intended exterior lighting schedule instead. + See the T24 2016 Residential ACM and the Plug Loads and Lighting Modeling CASE report from Energy Solutions for more information. - Assignees: Joe + Assignees: Anthony Fontanini, Eric Wilson .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 453 + :tags: characteristics, occupants, plug loads, feature + :pullreq: 324 - **Date**: 2020-05-21 + **Date**: 2020-03-05 Title: - Assign daylight saving dates based on County + Update to RECS 2015 Description: - Assign daylight saving start/end dates based on county and not epw region - Assign dst_start_date and dst_end_date based on county instead of epw location. This eliminates the possibility of simulating a building without daylight saving dates when it is near, but not within, Arizona. + Update occupant and plug loads equations based on RECS 2015 data; replace floor area with occupants as independent variable in plug loads equation; allow modeling of zero-bedroom units (e.g., studios) + To summarize, this: + solves for Nbr (in terms of Nocc) for: + sinks, showers, baths + range, dishwasher, clothes washer, clothes dryer + plug loads, large uncommon loads + replaces plug loads equation with RECS 2015-derived + + resstock-estimation: `pull request 12 `_ - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, ceiling fan, bugfix - :pullreq: 445 + :tags: characteristics, setpoints, feature + :pullreq: 414 - **Date**: 2020-05-12 + **Date**: 2020-03-05 Title: - Update ceiling fan options + Fuzzy schedules Description: - Update ceiling fan tsv to remove the "National Average" option, and instead sample 28% "None" and 72% "Standard Efficiency" - Update ceiling fan options and tsvs according to: https://trello.com/c/yBmLc3OU/23-ceiling-fans + Diversify the timing heating and cooling setpoint setbacks + Smears the Heating and Cooling offset schedules period +- 2hours around existing times. - Assignees: Joe + Assignees: Rajendra Adhikari .. change:: - :tags: workflow, weather, bugfix - :pullreq: 432 + :tags: characteristics, geospatial, feature + :pullreq: 416 - **Date**: 2020-04-06 + **Date**: 2020-03-02 Title: - Weather file update + Geospatial Description: - Remove Location Weather Filename and Location Weather Year tsvs, and update options lookup to reflect updated weather file changes; weather filenames are now required to match what is in the options lookup - Presently, to update the weather year files, we would need to make changes to the Location Weather Filename and Location Weather Year tsvs. While this approach is fine with two weather years i.e. TMY3 and AMY weather files presently, it creates a 'ballooning' effect when one begins to add more weather years as the location weather filename tsv will need the addition of 216 EPWs to its rows and columns for each AMY year. To resolve this issue, we: - - rename all epw weather filenames such that names are consistent between all years. New location weather filename data can be found here - delete location weather filename and location weather year as the names are now consistent between years - update options lookup tsv by adding weather filename arguments to the location tsv - update options lookup tsv by removing 'location weather filename' and 'location weather year' arguments + New geospatial characteristics have been added or updated. New geospatial characteristics are as follows: ASHRAE IECC Climate Zone 2004, State, County, PUMA, Census Division, Census Region, Building America Climate Zone, and ISO/RTO Region. The top level housing characteristic is now ASHRAE IECC Climate Zone 2004. Now using data from the American Community Survey Public Use Microdata Sample (ACS PUMS) for Building Type, Vintage, and Heating Fuel + This pull request is aimed at adding some spatial specification of ResStock samples. Currently, there are only two spatial descriptions in the housing characteristics: 1) Location (the epw weather file regions), and 2) Location Region (RECS defined Custom Regions) This pull request creates 10 housing characteristic files that help spatially define the location of a sampled housing unit. - Assignees: Tobi + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 433 + :tags: characteristics, hvac, feature + :pullreq: 418 - **Date**: 2020-04-02 + **Date**: 2020-03-02 Title: - ix qoi report measure to handle locations without a season + Chicago AC saturation Description: - Fix bug in QOI reporting measure where absence of any heating/cooling/overlap seasons would cause errors - The QOI report measure timing section has two errors: - - If there are no days with mean daily temperature above 70F (summer), the measure will fail, as the summer season does not exist. Common in climate zones 7+ - The daily_vals object is comprised of two arrays, and the intent is to get the array length. This fixes the timing reporting in the measure. + Update HVAC System Cooling tsv with air-conditioning saturations ("None", "Room AC", or "Central AC") from American Housing Survey for Custom Region 04. Efficiency probabilities remain based on RECS 2009 + During data source comparison, it was discovered that we probably have cooling saturation too low for Chicago. AHS is probably a better source for cooling saturation that we should use going forward. In the meantime, I pulled AC type saturation from AHS (None, Room AC , Central), and adjusted the distributions for each of these within the HVAC System Cooling tsv, but still using the efficiency breakdowns from RECS. Only CR04 was adjusted for the moment (which includes Chicago), using East North Central as an approximation for CR04 (the difference is the state of Wisconsin). In the future, we should probably separate saturation from efficiency in separate TSVs so we can use AHS for saturation and RECS for efficiency. - Assignees: Matt, Joe + Assignees: Janet Reyna .. change:: - :tags: workflow, envelope, bugfix - :pullreq: 426 + :tags: characteristics, mechanics, bugfix + :pullreq: 416 - **Date**: 2020-04-01 + **Date**: 2020-03-02 Title: - Roofing material restructure + Geospatial Description: - Restructure unfinished attic and finished roof -related tsv files (i.e., insulation, roof material, and radiant barrier) and options - Previously, we had: - - No "None" option for Insulation Unfinished Attic.tsv - Roofing Material.tsv assigned roofing_material arguments for both ResidentialConstructionsUnfinishedAttic and ResidentialConstructionsFinishedRoof - The issue with the previous is that if we try to upgrade just roofing_material, measure ResidentialConstructionsFinishedRoof is applied without all measure arguments specified. By adding the building type dependency to Insulation Unfinished Attic.tsv, Insulation Finished Roof.tsv, and both Roofing Material.tsv files, we can avoid this issue. + Removed the "Geometry Unit Stories SF" and "Geometry Unit Stories MF" housing characteristics. Unit stories are instead represented by the "Geometry Stories" housing characteristic + This pull request is aimed at adding some spatial specification of ResStock samples. Currently, there are only two spatial descriptions in the housing characteristics: 1) Location (the epw weather file regions), and 2) Location Region (RECS defined Custom Regions) This pull request creates 10 housing characteristic files that help spatially define the location of a sampled housing unit - Assignees: Joe + Assignees: Anthony Fontanini .. change:: @@ -387,39 +369,39 @@ v2.3.0 Changelog Total columns become net of pv Change the default of include_enduse_subcategories from false to true - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: characteristics, mechanics, bugfix - :pullreq: 392 + :tags: workflow, mechanics, feature + :pullreq: 408 - **Date**: 2020-02-13 + **Date**: 2020-02-21 Title: - Update lighting distribution. + Ignore comment lines Description: - Refactor the tsv maker classes to accommodate more data sources - The old lighting distribution is weighted too heavily towards incandescent bulbs. New distribution data is from 2015 in the 2015 U.S. Lighting Market Characterization study. Option= 100% Incandescent include Incandescent, HID, Halogen, and Other. Option=100% CFL include CFL and LFL. Option=100% LED include LED. + Add ability to ignore comment lines with the "#" symbol + This pull request is an effort to make the housing characteristics more machine-readable. The created by line is causing issues when reading the files programmatically. The resolution is that we have ResStock ignore comment lines. The comment lines begin with the "#" symbol. - Assignees: Tony + Assignees: Anthony Fontanini .. change:: - :tags: workflow, water heater, bugfix - :pullreq: 375 + :tags: characteristics, envelope, feature + :pullreq: 395 - **Date**: 2020-03-25 + **Date**: 2020-02-18 Title: - Update Water Heater=Other Fuel to map to no water heater + adding in diversity to MF roof insulation. Description: - Allow a building to be simulated with no water heater; map the "Other Fuel" option from the Water Heater tsv to no water heater - update cw, cd, dw, fixtures, distribution measures to skip when not finding a water heater + Update Insulation Finished Attic tsv with more options for insulation levels + Improve diversity for MF roof insulation by manually copying SF roof insulation (from Insulation Unfinished Attic). In the future, script NAHB / RBSA to pull MF distribution and also improve attic / non-attic split. - Assignees: Joe + Assignees: Janet Reyna .. change:: @@ -435,60 +417,69 @@ v2.3.0 Changelog Revert plug load schedule to RBSA for the National Average option … which had accidentally been changed to CA Title 24 – CASE Plug Loads and Lighting Schedule - Assignees: Eric + Assignees: Eric Wilson .. change:: - :tags: characteristics, mechanics, bugfix - :pullreq: 416 + :tags: workflow, mechanics, feature + :pullreq: 402 - **Date**: 2020-03-02 + **Date**: 2020-02-17 Title: - Geospatial + Remove single-family detached, PAT projects Description: - Removed the "Geometry Unit Stories SF" and "Geometry Unit Stories MF" housing characteristics. Unit stories are instead represented by the "Geometry Stories" housing characteristic - This pull request is aimed at adding some spatial specification of ResStock samples. Currently, there are only two spatial descriptions in the housing characteristics: 1) Location (the epw weather file regions), and 2) Location Region (RECS defined Custom Regions) This pull request creates 10 housing characteristic files that help spatially define the location of a sampled housing unit + Remove the single-family detached project, and remove PAT from the testing and multifamily projects - Assignees: Tony + Assignees: Joe Robertson .. change:: - :tags: characteristics, windows, bugfix - :pullreq: 412 + :tags: characteristics, mechanics, feature + :pullreq: 401 - **Date**: 2020-03-24 + **Date**: 2020-02-17 Title: - Add wwr variation per RBSA II data + Move data folder into resstock-estimation Description: - Diversify window to wall ratio variation using the Residential Building Stock Assessment (RBSA) II data - Per comments on that PR and discussion with @mdahlhausen, there are still changes that might happen before merging. - - binned WWRs for multifamily and single family buildings from RBSA II data - for calculations, see WWR estimates in EULP calibration directory on sharepoint - Assuming '50 or more Unit' building type is midrise/highrise with default 30% WWR for all buildings + Relocate the data folder, along with tsv makers, to a separate private repository + Folder data moved here: https://github.com/NREL/resstock-estimation - resstock-estimation: `pull request 21 `_ + Assignees: Joe Robertson - Assignees: Andrew P, Tony + + .. change:: + :tags: characteristics, lighting, feature + :pullreq: 392 + + **Date**: 2020-02-13 + + Title: + Update lighting distribution. + + Description: + Update the single-family detached and multifamily projects with more up-to-date lighting stock distributions + The old lighting distribution is weighted too heavily towards incandescent bulbs. New distribution data is from 2015 in the 2015 U.S. Lighting Market Characterization study. Option= 100% Incandescent include Incandescent, HID, Halogen, and Other. Option=100% CFL include CFL and LFL. Option=100% LED include LED. + + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 452 + :tags: characteristics, mechanics, bugfix + :pullreq: 392 - **Date**: 2020-06-10 + **Date**: 2020-02-13 Title: - fix bug for small window areas + Update lighting distribution. Description: - Fix bug in assigning small window areas to surfaces - @whiphi92 uncovered a bug that would throw an error when the calculated window area of a facade was less than the minimum allowable window area. This fix checks for that case and applies the invalid window area to the largest available surface. + Refactor the tsv maker classes to accommodate more data sources + The old lighting distribution is weighted too heavily towards incandescent bulbs. New distribution data is from 2015 in the 2015 U.S. Lighting Market Characterization study. Option= 100% Incandescent include Incandescent, HID, Halogen, and Other. Option=100% CFL include CFL and LFL. Option=100% LED include LED. - Assignees: Andrew + Assignees: Anthony Fontanini diff --git a/docs/read_the_docs/source/changelog/changelog_2_4_0.rst b/docs/read_the_docs/source/changelog/changelog_2_4_0.rst index 88bcab7d43..21757b6aa4 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_4_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_4_0.rst @@ -7,191 +7,187 @@ v2.4.0 Changelog :released: 2021-01-27 .. change:: - :tags: workflow, quantities of interest, feature - :pullreq: 460 + :tags: workflow, envelope, bugfix + :pullreq: 537 - **Date**: 2020-07-08 + **Date**: 2021-01-26 Title: - Report peak kw + Fix: Effective R Value Calculation for HVAC Sizing Description: - Report the annual peak use and timing using the quantities of interest measure - Report peak use and timing using the QOIReport measure. + Calculate slab surface effective R values used in HVAC sizing with unit-level variables + Fixes how the effective R value of a slab is calculated for use in the HVAC sizing measure. The effective R values were previously calculated use the slab area of the entire building footprint and the exposed perimeter of the individual unit, causing the R value to scale incorrectly with larger buildings. This calculates the R value using variables specific to the unit, not the building. - Assignees: Joe + Assignees: Andrew Speake .. change:: - :tags: workflow, schedules, feature - :pullreq: 348 + :tags: workflow, mechanics, feature + :pullreq: 525 - **Date**: 2020-07-16 + **Date**: 2021-01-20 Title: - Generate schedule csv on the fly and use Schedule:File objects on its columns + Feature/weather infrastructure Description: - Major change to most occupant-related schedules. Occupant activities are now generated on-the-fly and saved to .csv files used by Schedule:File objects. Schedules are generated using time-inhomogenous Markov chains derived from American Time Use Survey data, supplemented with sampling duration and power level from NEEA RBSA data, as well as DHW draw duration and flow rate data from Aquacraft/AWWA data [(see pre-print for details)](https://arxiv.org/abs/2111.01881) - The Stochastic Occupancy Modelling introduces major change to most occupant-related schedules. Occupant activities are now generated on-the-fly and saved to .csv files used by Schedule:File objects. Schedules are generated using time-inhomogenous Markov chains derived from American Time Use Survey data, supplemented with sampling duration and power level from NEEA RBSA data, as well as DHW draw duration and flow rate data from Aquacraft/AWWA data. + Allow for flexible weather regions based on weather data available and introduce TMY3 weather files for the new weather format + This PR generalizes the weather data available for a given AMY or TMY analysis. ResStock currently uses 941 static weather stations. The stations are used based on the Location.tsv. - Assignees: Joe, Rajendra + resstock-estimation: `pull request 95 `_ + + Assignees: Anthony Fontanini .. change:: - :tags: characteristics, setpoints, feature - :pullreq: 468 + :tags: workflow, weather, bugfix + :pullreq: 530 - **Date**: 2020-08-10 + **Date**: 2021-01-20 Title: - Update Setpoint and Setpoint Schedule Distributions + Bugfix for DST start hour and end date. Description: - Update the dependencies for heating and cooling setpoint tsvs (Setpoint, Has Offset, Offset Magnitude, and Offset Period) to IECC climate zone - Updates the thermostat heating and cooling setpoint distributions (setpoint, has offset, offset magnitude, offset schedule) to be dependent on IECC climate zone instead of AIA zone. + Fix DST start hour error and end date error + The PR fixes 2 issues with the current calculation of DST time column. + Currently, DST spring forward occurs at 1:00 AM standard time. The time jumps from 0:59 to 2:00. It should jump from 1:59 to 3:00 instead. This fixes the problem. + The DST end date is currently one day behind what's specified in the options_lookup or weather file. This PR also fixes that. + The clocks are supposed to shift back by one hour at 2:00 AM on the same date as DST end date. See https://www.timeanddate.com/time/change/usa. - Assignees: Andrew + Assignees: Rajendra Adhikari .. change:: - :tags: characteristics, vacancy, feature - :pullreq: 473 + :tags: workflow, ducts, feature + :pullreq: 532 - **Date**: 2020-08-17 + **Date**: 2021-01-13 Title: - Introduce Vacant Units + Update duct related calcs in airflow.rb Description: - Distinguish between vacant and occupied dwelling units using PUMS data - The purpose of the pull request is to introduce vacant units into the residential stock. This work was motivated by the following maps that shows the fraction of vacant units by building type and PUMA. - - resstock-estimation: `pull request 36 `_ + Update the duct leakage "total" to "to outside" conversion to be based on ASHRAE Standard 152 + Addresses https://trello.com/c/VmcGehGM/62-duct-leakage-total. - Assignees: Tony + Assignees: Joe Robertson .. change:: - :tags: characteristics, heating fuel, feature - :pullreq: 474 + :tags: workflow, weather, bugfix + :pullreq: 528 - **Date**: 2020-08-10 + **Date**: 2021-01-11 Title: - Feature/heating fuel puma + Change to UTC time calculations to avoid DST messing things up Description: - Update heating fuel distributions to be by Public Use Microdata Area (PUMA) rather than State - This pull request modifies the state level description of Heating Fuel type to PUMA. See the graphics below for modifications of heating fuel types. The data is based on PUMS 5-yr 2016, and for sample sizes that are less than 10, the state average is used. - - resstock-estimation: `pull request 49 `_ + Fix bug related to incorrect timestamps when using AMY weather file + Resolves the issue of timestamps being incorrect around the DST switchover time when using AMY weather files. - Assignees: Tony + Assignees: Rajendra Adhikari .. change:: - :tags: characteristics, mechanics, feature - :pullreq: 478 + :tags: workflow, heat pumps, feature + :pullreq: 512 - **Date**: 2020-09-09 + **Date**: 2021-01-07 Title: - HVAC tsv restructuring + Report supplemental electric heating Description: - Restructure HVAC housing characteristics to 1) simplify the structure, 2) allow for integrating more local data sources, 3) update reference years for HVAC and refrigerator ages and efficiencies from 2009 to 2018, 4) add assumption comments to all HVAC-related housing characteristics, 5) improve Room AC efficiency distributions using ENERGY STAR saturation data, and 6) fix some incorrect assignment of Option=None heating systems - We have an inordinate number of tsvs presently describing the hvac systems in OpenStudio-BuildStock. This PR reorders and merges existing hvac tsvs while preserving the necessary interactions. The major changes to structure are to move from multiple heating fuel-specific efficiency TSV files to a single TSV for heating efficiencies. The "Is Heat Pump" TSV is also expanded to include ducted/non-ducted options for use as an interim dependency. - - resstock-estimation: `pull request 32 `_ + Separate heat pump electric supplemental heating from total electric heating in output reporting + Break "supplemental electric heating" out of "electric heating". + This is important for heat pump analysis. - Assignees: Tobi, Eric + Assignees: Joe Robertson .. change:: - :tags: workflow, envelope, feature - :pullreq: 485 + :tags: characteristics, mechanics, bugfix + :pullreq: 522 - **Date**: 2020-09-23 + **Date**: 2021-01-07 Title: - Roofing material options and tsvs updates + Fix: All buildings have double-loaded corridors Description: - Increase roofing material options; update roofing material tsv files to include these new options - Expand roof material options and update related tsv files. + In the Corridor.tsv, assign single-family attached, single-family detached, and mobile homes with a "Not Applicable" option + In the project_national/housing_characteristics/Corridor.tsv, all buildings are assigned a "Double-Loaded Corridor." However, the single-family detached, mobile homes, and single-family attached buildings do not have corridors. For single-family detached, mobile homes, and single-family attached buildings, measures/BuildExistingModel/measure.rb removes the calls to the ResidentialGeometryCreateMultifamily measure. - Assignees: Joe + Assignees: Anthony Fontanini .. change:: - :tags: characteristics, envelope, feature - :pullreq: 492 + :tags: workflow, vacancy, bugfix + :pullreq: 527 - **Date**: 2020-11-10 + **Date**: 2021-01-07 Title: - Update Geometry Foundation Type to be Based on RECS + Make sure vacant units have zero ceiling fan energy Description: - Update foundation type from the [Building Foundation Design Handbook](https://www.osti.gov/biblio/6980439-building-foundation-design-handbook) published in 1988 to RECS 2009 - This pull request updates the Geometry Foundation Type.tsv from the "Building Foundation Design Handbook" published in 1988 to RECS 2009. The new TSV has dependencies on IECC Climate and Moisture regions and Vintage ACS. - - resstock-estimation: `pull request 63 `_, `pull request 73 `_ + Remove ceiling fan energy for vacant units + Vacant units currently have ceiling fan energy. This PR introduces an option where the ceiling fan energy is zero. The ratio of ceiling fans is kept the same, so 72% of units have ceiling fans for either occupied or vacant units. This ensures the counts of ceiling fans are consistent, but vacant units have no ceiling fan energy. - Assignees: Tony + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, feature - :pullreq: 507 + :tags: workflow, mechanics, bugfix + :pullreq: 523 - **Date**: 2020-11-13 + **Date**: 2020-12-23 Title: - ResStock/ComStock weather syncronization + Fix surface area reporting for collapsed buildings Description: - Synchronize weather between ResStock and ComStock which increases the number of weather stations from 215 to 941 - This pull request synchronizes the weather files for both ResStock and ComStock. Currently, ResStock uses 215 weather regions defined by county. ComStock uses 941 weather files also defined by county. For applications (especially GEB applications) where combined results from ResStock and ComStock are desired, it is important that the residential and commercial models use the same weather data. This way both residential and commercial models respond to hot days, cold days, rainy days together to predict more accurate combined loads. - - resstock-estimation: `pull request 58 `_ + Fix for calculating door and below-grade wall area of multifamily and single-family attached buildings with collapsed geometries + Fixes below grade wall and door area calculations in SimulationOutputReport when minimal_collapsed = true for MF and SFA buildings. Previously, units_represented was not used to scale foundation wall or door area, and therefore areas were underestimated when building geometries were collapsed. - Assignees: Tony + Assignees: Andrew Speake .. change:: - :tags: characteristics, occupants, feature - :pullreq: 509 + :tags: characteristics, water heater, feature + :pullreq: 513 - **Date**: 2020-11-16 + **Date**: 2020-12-10 Title: - Number of occupants based on PUMS + Feature/water heater update Description: - Update Occupants per unit from RECS 2015 to PUMS 5-yr 2017 - This pull request updates the number of occupants (that gets passed into the stochastic load generator) from RECS 2015 to PUMS 5-yr 2017. The switch to PUMS allows PUMA level spatial granularity in the distributions and leverages more than 6 million samples. + Introduce premium water heaters and heat pump water heaters into building stock, differentiate between central and in-unit water heating, and split water heater fuel and efficiency into different housing characteristics + This pull request updates the water heater housing characteristics. + + resstock-estimation: `pull request 87 `_ - Assignees: Tony + Assignees: Anthony Fontanini .. change:: - :tags: characteristics, plug loads, feature - :pullreq: 471 + :tags: workflow, mechanics, bugfix + :pullreq: 518 - **Date**: 2020-08-11 + **Date**: 2020-12-10 Title: - Separate plug load equations for SFD, SFA, MF + Account for collapsed units when determining geometry variables for infiltration calculation Description: - Based on RECS 2015, separate the plug load equations for single-family detached, single-family attached, and multifamily buildings - Using RECS 2015 a multilinear regression is performed to determine the annual MELS for ResStock. The dependent variables are the number of occupants (noccupants) and the finished floor area (ffa) of the dwelling unit. The MELS definition is a combination of microwave, television, humidifiers, and other devices. The RECS fields for these variables are KWHMICRO, KWHTVREL, KWHHUM, and KWHNEC, respectively. - - resstock-estimation: `pull request 45 `_ + Account for collapsed units when determining geometry variables (building floor/wall area and volume) in infiltration calculations; add airflow unit tests + Fixes how geometry variables (building ffa, building volume, and building exterior wall area) are calculated in the Airflow.rb measure when minimal_collapsed == True. The "collapsed" units were not originally accounted for when determining these variables, influencing the calculated leakage area at each unit. This changes the infiltration and HVAC sizing in SFA buildings, and most likely MF buildings as well. - Assignees: Joe, Tony + Assignees: Andrew Speake .. change:: @@ -206,14 +202,12 @@ v2.4.0 Changelog Description: Allow for plug load energy consumption to vary by Census Division and include additional "diversity" multiplier in plug load equations This pull request separates out multipliers meant to adjust total energy and multipliers meant to adjust diversity of the results. The ResidentialMiscPlugLoads argument mult has been split into two multipliers (energy_mult and diversity_mult). - The energy multiplier now allows the plug load energy use to vary with building type and RECS 2015 definition of Census Division (the Mountain division is split into North and South). - The diversity_mult argument is simply the same as the previous definition of mult. resstock-estimation: `pull request 86 `_ - Assignees: Joe, Tony + Assignees: Joe Robertson, Anthony Fontanini .. change:: @@ -231,308 +225,310 @@ v2.4.0 Changelog resstock-estimation: `pull request 84 `_ - Assignees: Tony + Assignees: Anthony Fontanini .. change:: - :tags: characteristics, water heater, feature - :pullreq: 513 + :tags: workflow, appliances, bugfix + :pullreq: 504 - **Date**: 2020-12-10 + **Date**: 2020-11-22 Title: - Feature/water heater update + Add monthly multiplier for cooking, clothes washer, clothes dryer, and dishwasher Description: - Introduce premium water heaters and heat pump water heaters into building stock, differentiate between central and in-unit water heating, and split water heater fuel and efficiency into different housing characteristics - This pull request updates the water heater housing characteristics. - - resstock-estimation: `pull request 87 `_ + Reintroduce monthly multipliers with stochastic load model for dishwasher, clothes washer and clothes dryer and cooking + The cooking schedule was previously (before the ResidentialScheduleGenerator was introduced) generated using weekend, weekday, and monthly multiplier schedule. Currently, they are generated using the Markov-chain by the ResidentialScheduleGenerator. This pull request adds monthly multipliers to the schedule so generated. - Assignees: Tony + Assignees: Rajendra Adhikari .. change:: - :tags: workflow, heat pumps, feature - :pullreq: 512 + :tags: characteristics, occupants, feature + :pullreq: 509 - **Date**: 2021-01-07 + **Date**: 2020-11-16 Title: - Report supplemental electric heating + Number of occupants based on PUMS Description: - Separate heat pump electric supplemental heating from total electric heating in output reporting - Break "supplemental electric heating" out of "electric heating". - - This is important for heat pump analysis. + Update Occupants per unit from RECS 2015 to PUMS 5-yr 2017 + This pull request updates the number of occupants (that gets passed into the stochastic load generator) from RECS 2015 to PUMS 5-yr 2017. The switch to PUMS allows PUMA level spatial granularity in the distributions and leverages more than 6 million samples. - Assignees: Joe + Assignees: Anthony Fontanini .. change:: - :tags: workflow, ducts, feature - :pullreq: 532 + :tags: workflow, mechanics, feature + :pullreq: 507 - **Date**: 2021-01-13 + **Date**: 2020-11-13 Title: - Update duct related calcs in airflow.rb + ResStock/ComStock weather syncronization Description: - Update the duct leakage "total" to "to outside" conversion to be based on ASHRAE Standard 152 - Addresses https://trello.com/c/VmcGehGM/62-duct-leakage-total. + Synchronize weather between ResStock and ComStock which increases the number of weather stations from 215 to 941 + This pull request synchronizes the weather files for both ResStock and ComStock. Currently, ResStock uses 215 weather regions defined by county. ComStock uses 941 weather files also defined by county. For applications (especially GEB applications) where combined results from ResStock and ComStock are desired, it is important that the residential and commercial models use the same weather data. This way both residential and commercial models respond to hot days, cold days, rainy days together to predict more accurate combined loads. + + resstock-estimation: `pull request 58 `_ - Assignees: Joe + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, feature - :pullreq: 525 + :tags: characteristics, envelope, feature + :pullreq: 492 - **Date**: 2021-01-20 + **Date**: 2020-11-10 Title: - Feature/weather infrastructure + Update Geometry Foundation Type to be Based on RECS Description: - Allow for flexible weather regions based on weather data available and introduce TMY3 weather files for the new weather format - This PR generalizes the weather data available for a given AMY or TMY analysis. ResStock currently uses 941 static weather stations. The stations are used based on the Location.tsv. + Update foundation type from the [Building Foundation Design Handbook](https://www.osti.gov/biblio/6980439-building-foundation-design-handbook) published in 1988 to RECS 2009 + This pull request updates the Geometry Foundation Type.tsv from the "Building Foundation Design Handbook" published in 1988 to RECS 2009. The new TSV has dependencies on IECC Climate and Moisture regions and Vintage ACS. - resstock-estimation: `pull request 95 `_ + resstock-estimation: `pull request 63 `_, `pull request 73 `_ - Assignees: Tony + Assignees: Anthony Fontanini .. change:: - :tags: workflow, schedules, bugfix - :pullreq: 477 + :tags: characteristics, climate zones, bugfix + :pullreq: 497 - **Date**: 2020-08-13 + **Date**: 2020-11-10 Title: - Addresses #476, appliance design levels fluctuate between runs + Add IECC zone dependency to HVAC Cooling Type and some minor heat pump fixes Description: - Fix for pseudo-random number generator that was generating non-deterministic occupancy schedules - Fixes an issue with sampling an integer without using the pseudo-random number generator seed. + Reintroduce IECC climate zone dependency to HVAC Cooling Type and some heat pump fixes + Addresses #64 by adding IECC zone as a dependency. Lumping some of the other dependencies to bring up sample sizes. Increased from ~47% to 60% rows with fewer than 10 samples, but overall I think it is a net improvement. + + resstock-estimation: `pull request 67 `_ - Assignees: Joe + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 480 + :tags: workflow, internal gains, bugfix + :pullreq: 501 - **Date**: 2020-08-18 + **Date**: 2020-10-27 Title: - Addresses #479, garage zone infiltration not always added to model + Internal gain calcs for sizing updates/fixes Description: - Iterate all spaces in a thermal zone when checking for zone type; fixes missing infiltration for protruding garages in 1-story homes - For 1-story, SFD homes with protruding garages, we expect an effective leakage area object added to the model for the garage and garage attic spaces, as shown below. However, these only get added about half of the time. + For the purpose of calculating cooling and dehumidification loads for HVAC sizing, use simple internal gains equation from ANSI/RESNET/ICC 301 (consistent with HPXML workflow); this fixes a bug introduced in [#348](https://github.com/NREL/resstock/pull/348) that caused cooling capacities to be ~3x larger than they should be + Updates to be consistent with how the hpxml workflow processes internal gains. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: characteristics, vacancy, bugfix - :pullreq: 486 + :tags: mechanics, envelope, bugfix + :pullreq: 496 - **Date**: 2020-09-24 + **Date**: 2020-10-07 Title: - Fix/vacant units + Update partition wall area calculation for MF and SFA buildings Description: - Update spatial distribution of units based on total dwelling unit counts rather than occupied unit counts - After talking with @TobiAdekanye, we realized that the spatial distribution of dwelling units are based on only the occupied dwelling units. When the vacant units were pulled into ResStock, the TSV creation functions in sources/spatial/tsv_maker.py in the resstock-estimation repository should have been updated to acs_count instead of acs_occupied_count. This was an oversight when I merged in the Vacant Units. - - resstock-estimation: `pull request 56 `_ + Exclude existing shared walls when calculating the partition wall area of MF and SFA buildings + Updates how partition wall surface area is calculated so that shared walls in MF and SFA buildings do not count as existing partition wall mass. This means that MF and SFA building partition walls are now calculated the same as SFD buildings - as a direct proportion of the finished floor area. - Assignees: Tony + Assignees: Andrew Speake .. change:: - :tags: mechanics, envelope, bugfix - :pullreq: 496 + :tags: characteristics, vacancy, bugfix + :pullreq: 486 - **Date**: 2020-10-07 + **Date**: 2020-09-24 Title: - Update partition wall area calculation for MF and SFA buildings + Fix/vacant units Description: - Exclude existing shared walls when calculating the partition wall area of MF and SFA buildings - Updates how partition wall surface area is calculated so that shared walls in MF and SFA buildings do not count as existing partition wall mass. This means that MF and SFA building partition walls are now calculated the same as SFD buildings - as a direct proportion of the finished floor area. + Update spatial distribution of units based on total dwelling unit counts rather than occupied unit counts + After talking with @TobiAdekanye, we realized that the spatial distribution of dwelling units are based on only the occupied dwelling units. When the vacant units were pulled into ResStock, the TSV creation functions in sources/spatial/tsv_maker.py in the resstock-estimation repository should have been updated to acs_count instead of acs_occupied_count. This was an oversight when I merged in the Vacant Units. + + resstock-estimation: `pull request 56 `_ - Assignees: Andrew + Assignees: Anthony Fontanini .. change:: - :tags: workflow, internal gains, bugfix - :pullreq: 501 + :tags: workflow, envelope, feature + :pullreq: 485 - **Date**: 2020-10-27 + **Date**: 2020-09-23 Title: - Internal gain calcs for sizing updates/fixes + Roofing material options and tsvs updates Description: - For the purpose of calculating cooling and dehumidification loads for HVAC sizing, use simple internal gains equation from ANSI/RESNET/ICC 301 (consistent with HPXML workflow); this fixes a bug introduced in [#348](https://github.com/NREL/resstock/pull/348) that caused cooling capacities to be ~3x larger than they should be - Updates to be consistent with how the hpxml workflow processes internal gains. + Increase roofing material options; update roofing material tsv files to include these new options + Expand roof material options and update related tsv files. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: characteristics, climate zones, bugfix - :pullreq: 497 + :tags: characteristics, mechanics, feature + :pullreq: 478 - **Date**: 2020-11-10 + **Date**: 2020-09-09 Title: - Add IECC zone dependency to HVAC Cooling Type and some minor heat pump fixes + HVAC tsv restructuring Description: - Reintroduce IECC climate zone dependency to HVAC Cooling Type and some heat pump fixes - Addresses #64 by adding IECC zone as a dependency. Lumping some of the other dependencies to bring up sample sizes. Increased from ~47% to 60% rows with fewer than 10 samples, but overall I think it is a net improvement. + Restructure HVAC housing characteristics to 1) simplify the structure, 2) allow for integrating more local data sources, 3) update reference years for HVAC and refrigerator ages and efficiencies from 2009 to 2018, 4) add assumption comments to all HVAC-related housing characteristics, 5) improve Room AC efficiency distributions using ENERGY STAR saturation data, and 6) fix some incorrect assignment of Option=None heating systems + We have an inordinate number of tsvs presently describing the hvac systems in OpenStudio-BuildStock. This PR reorders and merges existing hvac tsvs while preserving the necessary interactions. The major changes to structure are to move from multiple heating fuel-specific efficiency TSV files to a single TSV for heating efficiencies. The "Is Heat Pump" TSV is also expanded to include ducted/non-ducted options for use as an interim dependency. - resstock-estimation: `pull request 67 `_ + resstock-estimation: `pull request 32 `_ - Assignees: Tony + Assignees: Tobi Adekanye, Eric Wilson .. change:: - :tags: workflow, appliances, bugfix - :pullreq: 504 + :tags: workflow, mechanics, bugfix + :pullreq: 480 - **Date**: 2020-11-22 + **Date**: 2020-08-18 Title: - Add monthly multiplier for cooking, clothes washer, clothes dryer, and dishwasher + Addresses #479, garage zone infiltration not always added to model Description: - Reintroduce monthly multipliers with stochastic load model for dishwasher, clothes washer and clothes dryer and cooking - The cooking schedule was previously (before the ResidentialScheduleGenerator was introduced) generated using weekend, weekday, and monthly multiplier schedule. Currently, they are generated using the Markov-chain by the ResidentialScheduleGenerator. This pull request adds monthly multipliers to the schedule so generated. + Iterate all spaces in a thermal zone when checking for zone type; fixes missing infiltration for protruding garages in 1-story homes + For 1-story, SFD homes with protruding garages, we expect an effective leakage area object added to the model for the garage and garage attic spaces, as shown below. However, these only get added about half of the time. - Assignees: Rajendra + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 518 + :tags: characteristics, vacancy, feature + :pullreq: 473 - **Date**: 2020-12-10 + **Date**: 2020-08-17 Title: - Account for collapsed units when determining geometry variables for infiltration calculation + Introduce Vacant Units Description: - Account for collapsed units when determining geometry variables (building floor/wall area and volume) in infiltration calculations; add airflow unit tests - Fixes how geometry variables (building ffa, building volume, and building exterior wall area) are calculated in the Airflow.rb measure when minimal_collapsed == True. The "collapsed" units were not originally accounted for when determining these variables, influencing the calculated leakage area at each unit. This changes the infiltration and HVAC sizing in SFA buildings, and most likely MF buildings as well. + Distinguish between vacant and occupied dwelling units using PUMS data + The purpose of the pull request is to introduce vacant units into the residential stock. This work was motivated by the following maps that shows the fraction of vacant units by building type and PUMA. + + resstock-estimation: `pull request 36 `_ - Assignees: Andrew + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 523 + :tags: workflow, schedules, bugfix + :pullreq: 477 - **Date**: 2020-12-23 + **Date**: 2020-08-13 Title: - Fix surface area reporting for collapsed buildings + Addresses #476, appliance design levels fluctuate between runs Description: - Fix for calculating door and below-grade wall area of multifamily and single-family attached buildings with collapsed geometries - Fixes below grade wall and door area calculations in SimulationOutputReport when minimal_collapsed = true for MF and SFA buildings. Previously, units_represented was not used to scale foundation wall or door area, and therefore areas were underestimated when building geometries were collapsed. + Fix for pseudo-random number generator that was generating non-deterministic occupancy schedules + Fixes an issue with sampling an integer without using the pseudo-random number generator seed. - Assignees: Andrew + Assignees: Joe Robertson .. change:: - :tags: characteristics, mechanics, bugfix - :pullreq: 522 + :tags: characteristics, plug loads, feature + :pullreq: 471 - **Date**: 2021-01-07 + **Date**: 2020-08-11 Title: - Fix: All buildings have double-loaded corridors + Separate plug load equations for SFD, SFA, MF Description: - In the Corridor.tsv, assign single-family attached, single-family detached, and mobile homes with a "Not Applicable" option - In the project_national/housing_characteristics/Corridor.tsv, all buildings are assigned a "Double-Loaded Corridor." However, the single-family detached, mobile homes, and single-family attached buildings do not have corridors. For single-family detached, mobile homes, and single-family attached buildings, measures/BuildExistingModel/measure.rb removes the calls to the ResidentialGeometryCreateMultifamily measure. + Based on RECS 2015, separate the plug load equations for single-family detached, single-family attached, and multifamily buildings + Using RECS 2015 a multilinear regression is performed to determine the annual MELS for ResStock. The dependent variables are the number of occupants (noccupants) and the finished floor area (ffa) of the dwelling unit. The MELS definition is a combination of microwave, television, humidifiers, and other devices. The RECS fields for these variables are KWHMICRO, KWHTVREL, KWHHUM, and KWHNEC, respectively. - Assignees: Tony + resstock-estimation: `pull request 45 `_ + + Assignees: Joe Robertson, Anthony Fontanini .. change:: - :tags: workflow, vacancy, bugfix - :pullreq: 527 + :tags: characteristics, setpoints, feature + :pullreq: 468 - **Date**: 2021-01-07 + **Date**: 2020-08-10 Title: - Make sure vacant units have zero ceiling fan energy + Update Setpoint and Setpoint Schedule Distributions Description: - Remove ceiling fan energy for vacant units - Vacant units currently have ceiling fan energy. This PR introduces an option where the ceiling fan energy is zero. The ratio of ceiling fans is kept the same, so 72% of units have ceiling fans for either occupied or vacant units. This ensures the counts of ceiling fans are consistent, but vacant units have no ceiling fan energy. + Update the dependencies for heating and cooling setpoint tsvs (Setpoint, Has Offset, Offset Magnitude, and Offset Period) to IECC climate zone + Updates the thermostat heating and cooling setpoint distributions (setpoint, has offset, offset magnitude, offset schedule) to be dependent on IECC climate zone instead of AIA zone. - Assignees: Tony + Assignees: Andrew Speake .. change:: - :tags: workflow, weather, bugfix - :pullreq: 528 + :tags: characteristics, heating fuel, feature + :pullreq: 474 - **Date**: 2021-01-11 + **Date**: 2020-08-10 Title: - Change to UTC time calculations to avoid DST messing things up + Feature/heating fuel puma Description: - Fix bug related to incorrect timestamps when using AMY weather file - Resolves the issue of timestamps being incorrect around the DST switchover time when using AMY weather files. + Update heating fuel distributions to be by Public Use Microdata Area (PUMA) rather than State + This pull request modifies the state level description of Heating Fuel type to PUMA. See the graphics below for modifications of heating fuel types. The data is based on PUMS 5-yr 2016, and for sample sizes that are less than 10, the state average is used. + + resstock-estimation: `pull request 49 `_ - Assignees: Rajendra + Assignees: Anthony Fontanini .. change:: - :tags: workflow, weather, bugfix - :pullreq: 530 + :tags: workflow, schedules, feature + :pullreq: 348 - **Date**: 2021-01-20 + **Date**: 2020-07-16 Title: - Bugfix for DST start hour and end date. + Generate schedule csv on the fly and use Schedule:File objects on its columns Description: - Fix DST start hour error and end date error - The PR fixes 2 issues with the current calculation of DST time column. - - Currently, DST spring forward occurs at 1:00 AM standard time. The time jumps from 0:59 to 2:00. It should jump from 1:59 to 3:00 instead. This fixes the problem. - The DST end date is currently one day behind what's specified in the options_lookup or weather file. This PR also fixes that. - The clocks are supposed to shift back by one hour at 2:00 AM on the same date as DST end date. See https://www.timeanddate.com/time/change/usa. + Major change to most occupant-related schedules. Occupant activities are now generated on-the-fly and saved to .csv files used by Schedule:File objects. Schedules are generated using time-inhomogenous Markov chains derived from American Time Use Survey data, supplemented with sampling duration and power level from NEEA RBSA data, as well as DHW draw duration and flow rate data from Aquacraft/AWWA data [(see pre-print for details)](https://arxiv.org/abs/2111.01881) + The Stochastic Occupancy Modelling introduces major change to most occupant-related schedules. Occupant activities are now generated on-the-fly and saved to .csv files used by Schedule:File objects. Schedules are generated using time-inhomogenous Markov chains derived from American Time Use Survey data, supplemented with sampling duration and power level from NEEA RBSA data, as well as DHW draw duration and flow rate data from Aquacraft/AWWA data. - Assignees: Rajendra + Assignees: Joe Robertson, Rajendra Adhikari .. change:: - :tags: workflow, envelope, bugfix - :pullreq: 537 + :tags: workflow, quantities of interest, feature + :pullreq: 460 - **Date**: 2021-01-26 + **Date**: 2020-07-08 Title: - Fix: Effective R Value Calculation for HVAC Sizing + Report peak kw Description: - Calculate slab surface effective R values used in HVAC sizing with unit-level variables - Fixes how the effective R value of a slab is calculated for use in the HVAC sizing measure. The effective R values were previously calculated use the slab area of the entire building footprint and the exposed perimeter of the individual unit, causing the R value to scale incorrectly with larger buildings. This calculates the R value using variables specific to the unit, not the building. + Report the annual peak use and timing using the quantities of interest measure + Report peak use and timing using the QOIReport measure. - Assignees: Andrew + Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_2_5_0.rst b/docs/read_the_docs/source/changelog/changelog_2_5_0.rst index e80f46b82c..deb6204f4c 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_5_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_5_0.rst @@ -7,691 +7,716 @@ v2.5.0 Changelog :released: 2022-02-09 .. change:: - :tags: software, openstudio, feature - :pullreq: 604 + :tags: workflow, mechanics, bugfix + :pullreq: 821 - **Date**: 2021-07-26 + **Date**: 2022-02-03 Title: - OS v3.2.1 (E+ v9.5) + Update national project YAMLs with unit counts from ACS 2019 5-year Description: - Update to OpenStudio v3.3.0 - Updates to OpenStudio v3.2.1 (EnergyPlus v9.5). + Update the number of units represented in the national project YAML files to the American Community Survey 2019 5-year estimate + In the YAML files, the n_buildings_represented was 110,000,000. This estimate is a bit low compared to the ACS 2019 5-year estimate of 136,569,411. + This PR updates the YAML files to include the ACS 2019 5-year estimate of the number of housing units. - Assignees: Scott + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, feature - :pullreq: 439 + :tags: workflow, mechanics, bugfix + :pullreq: 817 - **Date**: 2021-02-09 + **Date**: 2022-02-03 Title: - Single-Unit Geometry + Finished Roof Bugfix Description: - Model multifamily and single-family attached buildings as individual dwelling units instead of multiple units representing a building - Updates geometry measures and various measure resources to model MF and SFA homes as single units. The geometry measures now apply adiabatic boundary conditions to surfaces that would otherwise be shared in the current MF and SFA modeling approaches + Properly apply roof insulation when the attic type is Finished Attic or Cathedral Ceilings + Insulation Roof options are not applying insulation correctly because attic spaces are modeled as unfinished, and no applicable surfaces are found in the ResidentialConstructionsFinishedRoof measure. This PR applies roof insulation via the ResidentialConstructionsUnfinishedAttic instead. + This keeps attic spaces modeled as unfinished, correctly applies insulation, and better aligns with the resstock-hpxml attic construction. - Assignees: Andrew + Assignees: Andrew Speake .. change:: - :tags: characteristics, setpoints, feature - :pullreq: 541 + :tags: workflow, mechanics, feature + :pullreq: 818 - **Date**: 2021-02-15 + **Date**: 2022-02-02 Title: - Vacant Unit Heating Setpoints + ServerDirectoryCleanup debug argument Description: - Reduce vacant unit heating setpoints to 55ºF - Assign Vacant Unit Heating Setpoints to 55F. The assumption is close to a "don't freeze the pipes" instead of using occupied setpoints. - - resstock-estimation: `pull request 96 `_ + Add arguments to the ServerDirectoryCleanup measure for controlling deletion of files in the run folder + Setting to true would set all "retain" arguments to true. - Assignees: Tony + Assignees: Joe Robertson .. change:: - :tags: characteristics, climate zones, feature - :pullreq: 548 + :tags: workflow, emissions, feature + :pullreq: 791 - **Date**: 2021-02-18 + **Date**: 2022-02-01 Title: - Introduce CEC Climate Zones + ResStock-HPXML: Emissions calculations (e.g., CO2) Description: - Introduce a CEC Building Climate Zone tag for samples in California - This pull requests add the California Energy Commission (CEC) Building Climate Zones into ResStock. A given building sample is tagged with a CEC climate zone (1-16) if the building is in California. If the sample is outside of California the sample is tagged with "None". - - resstock-estimation: `pull request 99 `_ + Add ability to calculate emissions for various scenarios + ResStock-HPXML: CO2 Emissions calculations - Assignees: Tony, Eric + Assignees: Joe Robertson .. change:: - :tags: characteristics, lighting, feature - :pullreq: 545 + :tags: workflow, solar hot water, bugfix + :pullreq: 809 - **Date**: 2021-02-18 + **Date**: 2022-01-27 Title: - Increase LED saturation to 2019 projected values + Backport unit conversion bugfixes for solar hot model from OS-HPXML Description: - Increase LED saturation to approximately 2019 levels - LED saturation is one of the fastest-changing technologies. Previously, we estimated that the LED saturation was ~10% based on the 2015 U.S. Lighting Market Characterization. + Fixes unit conversion bugs in solar hot water model - Assignees: Tony, Eric + Assignees: Scott Horowitz .. change:: - :tags: workflow, water heater, feature - :pullreq: 483 + :tags: characteristics, envelope, bugfix + :pullreq: 789 - **Date**: 2021-07-19 + **Date**: 2022-01-18 Title: - Water Heater GEB + Backport material properties from ResStock-HPXML Description: - Introduce GEB capabilities for water heaters, including the ability to schedule setpoint and HPWH operating mode - Adding in new GEB related features, including: - - Allowing tanks to use either a mixed or stratified tank model (additional user argument) - Allowing setpoint to follow an hourly (8760) schedule rather than only fixed values. - Allowing HPWH operating mode to be scheduled (either "HP Only" or "standard"). This allows the elements to be disabled during peak periods. - Adding unmet shower (an unmet load metric for WHs) calculations into ResStock runs to quantify any unmet WH loads. - In addition to these GEB features, a few new HPWH options, corresponding the AO Smith's current product line, are added to options lookup as potential upgrade options. - - resstock-estimation: `pull request 150 `_ + Fixes for wall constructions: remove wood sheathing on CMU and brick walls; better data for exterior finish absorptances and wall densities + Update exterior finish absorptance and wall density values to align with ResStock-HPXML values. Also removes sheathing layer from CMU and brick wall types. - Assignees: Jeff, Joe, Andrew + Assignees: Andrew Speake .. change:: - :tags: characteristics, hvac, feature - :pullreq: 551 + :tags: characteristics, envelope, feature + :pullreq: 759 - **Date**: 2021-03-02 + **Date**: 2021-11-17 Title: - Room AC Setpoint Dependency + add geometry_story_bin, add story_bin as dependency to geometry_wall_… Description: - Introduce different cooling setpoint distributions for window ACs - Adds HVAC Cooling Type dependency to Cooling Setpoint.tsv. Cooling type is not queried in RECS, and setpoints are determined the same as before, however the underlying temperature data for Room ACs is reduced by 6F to better align with the 2009 Residential Appliance Saturation Study (RASS). + Add Geometry Story Bin tsv and Geometry Story Bin dependency to Geometry Wall Type + Resolves: + #[https://github.com/Missing building height dependency in Geometry Wall Type resstock-estimation#175] + #[https://github.com/Higher than expected brick %s in wall type in recent vintages resstock-estimation#145] - reverting fix for high brick %s in newer vintages - resstock-estimation: `pull request 96 `_ + resstock-estimation: `pull request 177 `_ - Assignees: Andrew, Tony + Assignees: Lixi Liu .. change:: - :tags: characteristics, hvac, feature - :pullreq: 549 + :tags: characteristics, envelope, bugfix + :pullreq: 759 - **Date**: 2021-03-02 + **Date**: 2021-11-17 Title: - Zonal Electric Heating Setpoints + add geometry_story_bin, add story_bin as dependency to geometry_wall_… Description: - Include electric zonal heating equipment as a dependency in heating setpoint-related tsvs - Adds zonal electric heating equipment as a dependency for heating setpoint-related tsvs (Heating Setpoint, Heating Setpoint Offset Period, Heating Setpoint Offset Magnitude and Heating Setpoint Has Offset). Zonal electric heating includes "Built-In Electric Units" and "Portable Electric Heaters" in RECS 2009. Additionally, all weekend daytime heating and cooling setpoint offsets are removed + Revert wall type constraint that assumes all brick facades built >1960 are wood-framed with 4" face brick. Also add constraint to force all buildings > 8 stories to have steel-framed wall type + Resolves: + #[https://github.com/Missing building height dependency in Geometry Wall Type resstock-estimation#175] + #[https://github.com/Higher than expected brick %s in wall type in recent vintages resstock-estimation#145] - reverting fix for high brick %s in newer vintages - resstock-estimation: `pull request 96 `_ + resstock-estimation: `pull request 177 `_ - Assignees: Tony + Assignees: Lixi Liu .. change:: - :tags: workflow, schedules, feature - :pullreq: 550 + :tags: workflow, climate zones, feature + :pullreq: 764 - **Date**: 2021-03-04 + **Date**: 2021-11-08 Title: - Apply schedule geo-temporal shifting + IECC Zone argument for ResidentialLocation Description: - Geo-temporal shifting of the stochastic load model schedules using the American Time Use Survey - The appliance schedules are shifted based on geography (state), day type(weekday/weekend), and month. - The amount of shift is defined in resources/measures/HPXMLtoOpenStudio/resources/schedules/weekday/state_and_monthly_schedule_shift.csv - and - resources/measures/HPXMLtoOpenStudio/resources/schedules/weekend/state_and_monthly_schedule_shift.csv - files. - - resstock-estimation: `pull request 101 `_ + Add optional argument to ResidentialLocation measure for setting the IECC climate zone + Backport water heater location logic (based on IECC zone) - Assignees: Rajendra + Assignees: Joe Robertson .. change:: - :tags: characteristics, envelope, feature - :pullreq: 561 + :tags: workflow, unmet hours, bugfix + :pullreq: 700 - **Date**: 2021-07-09 + **Date**: 2021-09-03 Title: - geometry wall type.tsv to create from Lightbox + Fix unmet hours Description: - Switch data source for `Geometry Wall Type.tsv` from RECS 2009 to Homeland Infrastructure Foundation-Level Data (HIFLD) Parcel data - replace existing geometry wall type.tsv with new tsv from Lightbox - add geometry wall exterior finish.tsv from Lightbox - update insulation wall.tsv per new wall type. - update options lookup per new wall type and exterior finish - - resstock-estimation: `pull request 109 `_ + Fixes hours setpoint not met output to exclude A) no heating and/or cooling equipment and B) finished basements + Excludes reported unmet hours for A) no heating and/or cooling equipment and B) finished basements. - Assignees: Lixi + Assignees: Scott Horowitz .. change:: - :tags: workflow, schedules, feature - :pullreq: 566 + :tags: workflow, hvac, bugfix + :pullreq: 694 - **Date**: 2021-04-02 + **Date**: 2021-08-31 Title: - Addresses #562, use Schedule:File with plug/fuel loads + Disaggregate fan coil fan energy use Description: - Use Schedule:File with well pump / vehicle plug loads, as well as gas grill / fireplace / lighting fuel loads. This enables the optional vacancy period to apply to these end uses - Populate well pump and vehicle plug loads, as well as grill / lighting / fireplace fuel loads, in the schedule csv. Remove weekday / weekend / monthly schedule arguments from ResidentialMiscLargeUncommonLoads measure and the options lookup. Apply vacancy to these plug/fuel loads. + Disaggregate the shared fan coil's fan energy use into heating and cooling + Was previously all lumped into ElectricityFansCooling with a FIXME. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, feature - :pullreq: 583 + :tags: characteristics, pv, feature + :pullreq: 673 - **Date**: 2021-04-29 + **Date**: 2021-08-25 Title: - Project yml updates + add PV distributions Description: - Update example project yaml files to use buildstockbatch input schema version 0.3 - From schema 0.2 to 0.3. + Add PV ownership and PV system size distributions using 2019 Tracking the Sun and GTM report on solar installation + This PR introduces PV systems into ResStock. - Assignees: Joe + Assignees: Lixi Liu .. change:: - :tags: workflow, mechanics, feature - :pullreq: 585 + :tags: characteristics, mechanical ventilation, feature + :pullreq: 675 - **Date**: 2021-05-03 + **Date**: 2021-08-19 Title: - dst=NA somehow shifted from AZ to AR + Update mechanical ventilation Description: - Update default daylight saving start and end dates to March 12 and November 5, respectively - AZ counties did not have daylight saving dates set to NA (instead, some AR counties did). This corrects that. - - This PR also updates daylight saving dates from April 7 to October 26 to March 12 through November 5 (current OS-HPXML default values). + Updates mechanical ventilation options/model to ASHRAE 62.2-2019 and adds a "Flow Rate, Mechanical Ventilation (cfm)" output + Updates mechanical ventilation to ASHRAE 62.2-2019. This affects both the Qfan requirement for a mechanical ventilation system as well as how mechanical ventilation interacts with infiltration on a timestep basis. Also adds a 'Flow Rate, Mechanical Ventilation (cfm)' cost multiplier. - Assignees: Joe + Assignees: Scott Horowitz .. change:: - :tags: workflow, hvac, feature - :pullreq: 586 + :tags: workflow, mechanics, feature + :pullreq: 661 - **Date**: 2021-07-01 + **Date**: 2021-08-16 Title: - Replace room-ac performance curves by Cutler curves + Clean up ServerDirectoryCleanup measure Description: - Switches room air conditioner model to use Cutler performance curves - Backports: - - Replace room-ac performance curves by Cutler curves OpenStudio-HPXML#698 - Room air conditioner performance curve bugfix OpenStudio-HPXML#701 - Allow CEER efficiency unit for room ac OpenStudio-HPXML#764 + Add arguments to the ServerDirectoryCleanup measure for controlling deletion of files in the run folder + Update this measure to have arguments for including/excluding files in the run directory. Would need to update the buildstockbatch workflow generator to accommodate this. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: characteristics, envelope, feature - :pullreq: 558 + :tags: workflow, cost multipliers, bugfix + :pullreq: 674 - **Date**: 5/11/221 + **Date**: 2021-08-05 Title: - New stories options for MF buildings + Exclude corridor doors in door area cost multiplier Description: - Remove 3 story limit for multi-family buildings, and instead use RECS data to allow for buildings up to 21 stories - Removes the artificial cap of 3 stories for MF buildings, and instead uses RECS data to allow for up to 21 stories. Horizontal location and level tsvs were updated to account for the new dependencies. ResidentialGeometryCreateMultifamily was also updated for error checking and to set the Middle-level units at the halfway point. Dependency options in the Window Areas and Geometry Garage tsvs are updated as well. - - resstock-estimation: `pull request 100 `_, `pull request 129 `_ + Exclude adiabatic doors when outputting the door area cost multiplier + Backports approach used by OS-HPXML, in which adiabatic doors are not included in the door area cost multiplier output. - Assignees: Andrew + Assignees: Andrew Speake .. change:: - :tags: workflow, sampling, feature - :pullreq: 584 + :tags: characteristics, infiltration, feature + :pullreq: 670 - **Date**: 2021-05-17 + **Date**: 2021-08-04 Title: - Enforce running sampling probability script, try 2 + Update infiltration Description: - Add a sampling probability column in the housing characteristics to define the probability a given column will be sampled - Add in a column called the sampling_probability to each housing characteristic. The sampling_probability is the probability that a given row in the housing characteristic TSV file is sampled. This value is calculated from the product of the marginal probability of each of the dependency values being sampled for that specific row. For each housing characteristic, the sampling_probability column should sum to 1.0 and have non-negative values. - - resstock-estimation: `pull request 127 `_ + Updates infiltration model pressure coefficient + Changes the pressure coefficient from 0.67 to 0.65 for consistency with OS-HPXML. Also updates a water heater option's flue input to be consistent with the OS-HPXML default logic. - Assignees: Joe + Assignees: Scott Horowitz .. change:: - :tags: characteristics, balancing areas, feature - :pullreq: 591 + :tags: characteristics, windows, feature + :pullreq: 649 - **Date**: 2021-05-21 + **Date**: 2021-07-27 Title: - ReEDS Balancing Areas + Adjust interior shading assumptions Description: - Add ReEDS balancing areas as a spatial field - This PR adds a TSV for the ReEDS balancing areas. There are 134 balancing areas. The balancing areas are a county mapping provided by the ReEDS team. - - resstock-estimation: `pull request 132 `_ + Reduces window interior shading during Winter to match ANSI/RESNET/ICC 301 assumption + Changes to winter interior shading factor = 85% instead of 70%, per ANSI/RESNET/ICC 301 Standard. - Assignees: Tony + Assignees: Scott Horowitz .. change:: - :tags: workflow, heat pumps, feature - :pullreq: 605 + :tags: characteristics, ceiling fan, feature + :pullreq: 652 - **Date**: 2021-07-13 + **Date**: 2021-07-27 Title: - HP defrost control + Update ceiling fan model Description: - Changes heat pump defrost control from OnDemand to Timed - Backports NREL/OpenStudio-HPXML#403 + Updates ceiling fan model based on ANSI/RESNET ICC 301 assumptions + Backports the ceiling fan model from OS-HPXML, which is based on ANSI/RESNET/ICC 301. - Assignees: Scott + Assignees: Scott Horowitz .. change:: - :tags: characteristics, bathrooms, feature - :pullreq: 601 + :tags: workflow, mechanics, bugfix + :pullreq: 653 - **Date**: 2021-06-10 + **Date**: 2021-07-27 Title: - Number of bathrooms + Hot water recirc pump bugfix, take 2 Description: - Update number of bathrooms assumption to match the Building America House Simulation Protocols - This PR makes two changes: - - Updates number of bathrooms to use the BAHSP equation (Nbedrooms/2 + 0.5) and fixes the values used for SFA/MF. - Rounds down the number of bathrooms to the nearest integer for the assumption of number of bath fans. (E.g., a 1.5 bathroom home will now have 1 bath fan instead of 1.5 bath fans.) + Fixes hot water distribution internal gains not being zeroed out during vacancies + Follow-up to #646. It turns out that the recirculation pump was correctly reflecting the vacancy status for a unit, so that code is reverting. While making the change, I noticed that the internal gains associated with the hot water distribution system were not being zeroed out for vacant units, so that is fixed here too - Assignees: Scott + Assignees: Scott Horowitz .. change:: - :tags: workflow, sampling, feature - :pullreq: 606 + :tags: software, openstudio, feature + :pullreq: 604 - **Date**: 2021-06-04 + **Date**: 2021-07-26 Title: - Sampling speed improvement + OS v3.2.1 (E+ v9.5) Description: - Speed up sampling algorithm by multiple orders of magnitude for large numbers of samples - Addresses a bottleneck in run_sampling.rb that occurs for large TSVs. + Update to OpenStudio v3.3.0 + Updates to OpenStudio v3.2.1 (EnergyPlus v9.5). - Assignees: Scott + Assignees: Scott Horowitz .. change:: - :tags: characteristics, lighting, feature - :pullreq: 619 + :tags: characteristics, windows, feature + :pullreq: 615 - **Date**: 2021-06-21 + **Date**: 2021-07-21 Title: - Backport ERI lighting calcs from restructure-v3 + Add more descriptive window options Description: - Use ANSI/RESNET/ICC 301 equations to calculate annual interior, exterior, and garage lighting energy - Backports the Energy Rating Index equations used to calculate interior, exterior, and garage lighting on https://github.com/NREL/resstock/tree/restructure-v3 + Update window type distributions using RECS 2015. Includes additional of frame material types (RECS 2015) and presence of storm windows (D&R International) + The previous limited description of windows caused a lack of variation in U-value and solar gains for windows + + resstock-estimation: `pull request 140 `_ - Assignees: Andrew + Assignees: Elaina Present, Anthony Fontanini, Prateek Munankarmi .. change:: - :tags: workflow, mechanics, feature - :pullreq: 559 + :tags: workflow, water heater, feature + :pullreq: 483 - **Date**: 2021-06-29 + **Date**: 2021-07-19 Title: - ResStock-HPXML: Apply tsv files to develop branch + Water Heater GEB Description: - Update tsv files for both the national and testing projects. Supports transition to ResStock-HPXML - ResStock-HPXML: Apply tsv files to develop branch + Introduce GEB capabilities for water heaters, including the ability to schedule setpoint and HPWH operating mode + Adding in new GEB related features, including: + Allowing tanks to use either a mixed or stratified tank model (additional user argument) + Allowing setpoint to follow an hourly (8760) schedule rather than only fixed values. + Allowing HPWH operating mode to be scheduled (either "HP Only" or "standard"). This allows the elements to be disabled during peak periods. + Adding unmet shower (an unmet load metric for WHs) calculations into ResStock runs to quantify any unmet WH loads. + In addition to these GEB features, a few new HPWH options, corresponding the AO Smith's current product line, are added to options lookup as potential upgrade options. - resstock-estimation: `pull request 136 `_ + resstock-estimation: `pull request 150 `_ - Assignees: Joe + Assignees: Jeff Maguire, Joe Robertson, Andrew Speake .. change:: - :tags: workflow, cost multipliers, feature - :pullreq: 634 + :tags: characteristics, windows, bugfix + :pullreq: 597 - **Date**: 2021-07-08 + **Date**: 2021-07-14 Title: - Duct cost multiplier - unconditioned area + WWR calculation for facades w/ doors Description: - Changes "Duct Surface Area (ft^2)" cost multiplier to "Duct Unconditioned Surface Area (ft^2)" - Converts "Duct Surface Area (ft^2)" cost multiplier to "Duct Unconditioned Surface Area (ft^2)". Provides consistency w/ ResStock-HPXML. Follow-up to #532. - - Only buildings where the primary duct location is living space or finished basement are affected; they now return zero (instead of non-zero) values for the cost multiplier. + Fixes window-to-wall ratio calculation for facades with doors + Fixes window-to-wall ratio calculation for facades with doors. Previously if a facade had a door, the WWR would be applied to the net wall area instead of gross wall area. Added a unit test that demonstrates the fix -- previously the front window area was 95.6 ft2, now it's 100 ft2 and matches the results from ResStock-HPXML. - Assignees: Scott + Assignees: Scott Horowitz .. change:: - :tags: characteristics, windows, feature - :pullreq: 615 + :tags: workflow, heat pumps, feature + :pullreq: 605 - **Date**: 2021-07-21 + **Date**: 2021-07-13 Title: - Add more descriptive window options + HP defrost control Description: - Update window type distributions using RECS 2015. Includes additional of frame material types (RECS 2015) and presence of storm windows (D&R International) - The previous limited description of windows caused a lack of variation in U-value and solar gains for windows - - resstock-estimation: `pull request 140 `_ + Changes heat pump defrost control from OnDemand to Timed + Backports NREL/OpenStudio-HPXML#403 - Assignees: Elaina, Tony, Prateek + Assignees: Scott Horowitz .. change:: - :tags: characteristics, windows, feature - :pullreq: 649 + :tags: characteristics, envelope, feature + :pullreq: 561 - **Date**: 2021-07-27 + **Date**: 2021-07-09 Title: - Adjust interior shading assumptions + geometry wall type.tsv to create from Lightbox Description: - Reduces window interior shading during Winter to match ANSI/RESNET/ICC 301 assumption - Changes to winter interior shading factor = 85% instead of 70%, per ANSI/RESNET/ICC 301 Standard. + Switch data source for `Geometry Wall Type.tsv` from RECS 2009 to Homeland Infrastructure Foundation-Level Data (HIFLD) Parcel data + replace existing geometry wall type.tsv with new tsv from Lightbox + add geometry wall exterior finish.tsv from Lightbox + update insulation wall.tsv per new wall type. + update options lookup per new wall type and exterior finish - Assignees: Scott + resstock-estimation: `pull request 109 `_ + + Assignees: Lixi Liu .. change:: - :tags: characteristics, ceiling fan, feature - :pullreq: 652 + :tags: workflow, cost multipliers, feature + :pullreq: 634 - **Date**: 2021-07-27 + **Date**: 2021-07-08 Title: - Update ceiling fan model + Duct cost multiplier - unconditioned area Description: - Updates ceiling fan model based on ANSI/RESNET ICC 301 assumptions - Backports the ceiling fan model from OS-HPXML, which is based on ANSI/RESNET/ICC 301. + Changes "Duct Surface Area (ft^2)" cost multiplier to "Duct Unconditioned Surface Area (ft^2)" + Converts "Duct Surface Area (ft^2)" cost multiplier to "Duct Unconditioned Surface Area (ft^2)". Provides consistency w/ ResStock-HPXML. Follow-up to #532. + Only buildings where the primary duct location is living space or finished basement are affected; they now return zero (instead of non-zero) values for the cost multiplier. - Assignees: Scott + Assignees: Scott Horowitz .. change:: - :tags: characteristics, infiltration, feature - :pullreq: 670 + :tags: workflow, hvac, feature + :pullreq: 586 - **Date**: 2021-08-04 + **Date**: 2021-07-01 Title: - Update infiltration + Replace room-ac performance curves by Cutler curves Description: - Updates infiltration model pressure coefficient - Changes the pressure coefficient from 0.67 to 0.65 for consistency with OS-HPXML. Also updates a water heater option's flue input to be consistent with the OS-HPXML default logic. + Switches room air conditioner model to use Cutler performance curves + Backports: + Replace room-ac performance curves by Cutler curves OpenStudio-HPXML#698 + Room air conditioner performance curve bugfix OpenStudio-HPXML#701 + Allow CEER efficiency unit for room ac OpenStudio-HPXML#764 - Assignees: Scott + Assignees: Joe Robertson .. change:: - :tags: characteristics, mechanical ventilation, feature - :pullreq: 675 + :tags: workflow, mechanics, feature + :pullreq: 559 - **Date**: 2021-08-19 + **Date**: 2021-06-29 Title: - Update mechanical ventilation + ResStock-HPXML: Apply tsv files to develop branch Description: - Updates mechanical ventilation options/model to ASHRAE 62.2-2019 and adds a "Flow Rate, Mechanical Ventilation (cfm)" output - Updates mechanical ventilation to ASHRAE 62.2-2019. This affects both the Qfan requirement for a mechanical ventilation system as well as how mechanical ventilation interacts with infiltration on a timestep basis. Also adds a 'Flow Rate, Mechanical Ventilation (cfm)' cost multiplier. + Update tsv files for both the national and testing projects. Supports transition to ResStock-HPXML + + resstock-estimation: `pull request 136 `_ - Assignees: Scott + Assignees: Joe Robertson .. change:: - :tags: characteristics, pv, feature - :pullreq: 673 + :tags: characteristics, lighting, feature + :pullreq: 619 - **Date**: 2021-08-25 + **Date**: 2021-06-21 Title: - add PV distributions + Backport ERI lighting calcs from restructure-v3 Description: - Add PV ownership and PV system size distributions using 2019 Tracking the Sun and GTM report on solar installation - This PR introduces PV systems into ResStock. + Use ANSI/RESNET/ICC 301 equations to calculate annual interior, exterior, and garage lighting energy + Backports the Energy Rating Index equations used to calculate interior, exterior, and garage lighting on https://github.com/NREL/resstock/tree/restructure-v3 - Assignees: Lixi + Assignees: Andrew Speake .. change:: - :tags: workflow, climate zones, feature - :pullreq: 764 + :tags: characteristics, balancing areas, bugfix + :pullreq: 613 - **Date**: 2021-11-08 + **Date**: 2021-06-18 Title: - IECC Zone argument for ResidentialLocation + Rename ReEDS to REEDS Description: - Add optional argument to ResidentialLocation measure for setting the IECC climate zone - Backport water heater location logic (based on IECC zone) + Fix name of ReEDS balancing areas + In the results.csv the ReEDS column gets interpreted as re_eds which makes the column hard to search for. Even though "ReEDS" is correct, it was decided that the TSV name will be "REEDS". + + resstock-estimation: `pull request 143 `_ - Assignees: Joe + Assignees: Anthony Fontanini .. change:: - :tags: characteristics, envelope, feature - :pullreq: 759 + :tags: characteristics, bathrooms, feature + :pullreq: 601 - **Date**: 2021-11-17 + **Date**: 2021-06-10 Title: - add geometry_story_bin, add story_bin as dependency to geometry_wall_… + Number of bathrooms Description: - Add Geometry Story Bin tsv and Geometry Story Bin dependency to Geometry Wall Type - Resolves: - - #[https://github.com/Missing building height dependency in Geometry Wall Type resstock-estimation#175] - #[https://github.com/Higher than expected brick %s in wall type in recent vintages resstock-estimation#145] - reverting fix for high brick %s in newer vintages + Update number of bathrooms assumption to match the Building America House Simulation Protocols + This PR makes two changes: + Updates number of bathrooms to use the BAHSP equation (Nbedrooms/2 + 0.5) and fixes the values used for SFA/MF. + Rounds down the number of bathrooms to the nearest integer for the assumption of number of bath fans. (E.g., a 1.5 bathroom home will now have 1 bath fan instead of 1.5 bath fans.) + + Assignees: Scott Horowitz - resstock-estimation: `pull request 177 `_ - Assignees: Lixi + .. change:: + :tags: characteristics, bathrooms, bugfix + :pullreq: 601 + + **Date**: 2021-06-10 + + Title: + Number of bathrooms + + Description: + Fixes number of bathrooms for single-family attached and multi-family buildings + This PR makes two changes: + Updates number of bathrooms to use the BAHSP equation (Nbedrooms/2 + 0.5) and fixes the values used for SFA/MF. + Rounds down the number of bathrooms to the nearest integer for the assumption of number of bath fans. (E.g., a 1.5 bathroom home will now have 1 bath fan instead of 1.5 bath fans.) + + Assignees: Scott Horowitz .. change:: - :tags: workflow, mechanics, feature - :pullreq: 661 + :tags: characteristics, mechanics, bugfix + :pullreq: 609 - **Date**: 2021-08-16 + **Date**: 2021-06-10 Title: - Clean up ServerDirectoryCleanup measure + Update sampling_probabilty column based on bug in tsv_dist Description: - Add arguments to the ServerDirectoryCleanup measure for controlling deletion of files in the run folder - Update this measure to have arguments for including/excluding files in the run directory. Would need to update the buildstockbatch workflow generator to accommodate this. + Sync the sample probabilities after a bug fix in tsv_dist + The tsv_dist function was updated in the EULP-uncertainty-quantification PR #27. This update was due to a bug in identifying dependency intersections. As a result, the sample_probability column has updated for many housing characteristics. + + resstock-estimation: `pull request 142 `_ - Assignees: Joe + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, feature - :pullreq: 818 + :tags: workflow, sampling, feature + :pullreq: 606 - **Date**: 2022-02-02 + **Date**: 2021-06-04 Title: - ServerDirectoryCleanup debug argument + Sampling speed improvement Description: - Add arguments to the ServerDirectoryCleanup measure for controlling deletion of files in the run folder - Setting to true would set all "retain" arguments to true. + Speed up sampling algorithm by multiple orders of magnitude for large numbers of samples + Addresses a bottleneck in run_sampling.rb that occurs for large TSVs. - Assignees: Joe + Assignees: Scott Horowitz .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 543 + :tags: characteristics, sampling, bugfix + :pullreq: 592 - **Date**: 2021-02-09 + **Date**: 2021-05-27 Title: - Speed up TSV fetching + Housing Characteristic Fixes Description: - Fixes significant runtime bottleneck in TSV fetching in BuildExistingModel & ApplyUpgrade measures - A bug in the buildstock.rb get_measure_args_from_option_names() method was causing the entirety of every TSV to be processed even when the option(s) of interest had already been found. As the number and length of TSVs has grown, so has this bottleneck. + Housing characteristics fixes based on more samples in testing + project_national + Add Geometry Attic Type.tsv + Ensure assumptions are consistent for 5 to 9 unit buildings and their number of units. The assumption was added that 5 to 9 unit buildings cannot be >10 stories was not transparent in Geometry Building Number Units MF.tsv, but is enforced in Geometry Stories. The sampling_probability is 0, so the option values are set to "Option=None". + Add Geometry Attic Type as a dependency in Insulation Unfinished Attic.tsv + Script Roof Material Finished Roof.tsv and Roof Material Unfinished Attic.tsv. + project_testing + Add Geometry Attic Type.tsv + Add Geometry Attic Type as a dependency in Insulation Unfinished Attic.tsv + Script Roof Material Finished Roof.tsv and Roof Material Unfinished Attic.tsv. + Add Geometry Attic Type as a dependency to Roof Material Finished Roof.tsv and Roof Material Unfinished Attic.tsv. + Add Geometry Stories as a dependency for Geometry Building Number Units MF.tsv + Pier and Beam Foundations cannot have garages + Add HVAC Cooling Type as a dependency to HVAC Cooling Efficiency.tsv - Assignees: Scott + resstock-estimation: `pull request 134 `_ + + Assignees: Anthony Fontanini .. change:: - :tags: characteristics, envelope, bugfix - :pullreq: 553 + :tags: characteristics, balancing areas, feature + :pullreq: 591 - **Date**: 2021-03-08 + **Date**: 2021-05-21 Title: - Bug Fix: Too many bedrooms for small units + ReEDS Balancing Areas Description: - Dwelling units that are 0-499 ft2 are limited to a maximum of 2 bedrooms - This pull request updates the number of bedrooms for small units. + Add ReEDS balancing areas as a spatial field + This PR adds a TSV for the ReEDS balancing areas. There are 134 balancing areas. The balancing areas are a county mapping provided by the ReEDS team. - resstock-estimation: `pull request 104 `_ + resstock-estimation: `pull request 132 `_ - Assignees: Tony + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 556 + :tags: workflow, sampling, feature + :pullreq: 584 - **Date**: 2021-03-16 + **Date**: 2021-05-17 Title: - Addresses #555, unfinished attic floor material layers are reversed + Enforce running sampling probability script, try 2 Description: - Reverses the material layers of the unfinished attic floor construction so that they are correctly ordered outside-to-inside - Unfinished attic floor material layers are reversed + Add a sampling probability column in the housing characteristics to define the probability a given column will be sampled + Add in a column called the sampling_probability to each housing characteristic. The sampling_probability is the probability that a given row in the housing characteristic TSV file is sampled. This value is calculated from the product of the marginal probability of each of the dependency values being sampled for that specific row. For each housing characteristic, the sampling_probability column should sum to 1.0 and have non-negative values. + + resstock-estimation: `pull request 127 `_ - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 560 + :tags: characteristics, envelope, feature + :pullreq: 558 - **Date**: 2021-03-25 + **Date**: 2021-05-11 Title: - Bugfix/invalid geometry garage size + New stories options for MF buildings Description: - Fixes invalid garage and living space dimension errors - The geometry measure is throwing an error due to garage sizes compared to the conditioned space size. We believe the error is due to the tucked garage is larger than either the depth or width of the first floor of the single-family detached unit. + Remove 3 story limit for multi-family buildings, and instead use RECS data to allow for buildings up to 21 stories + Removes the artificial cap of 3 stories for MF buildings, and instead uses RECS data to allow for up to 21 stories. Horizontal location and level tsvs were updated to account for the new dependencies. ResidentialGeometryCreateMultifamily was also updated for error checking and to set the Middle-level units at the halfway point. Dependency options in the Window Areas and Geometry Garage tsvs are updated as well. + + resstock-estimation: `pull request 100 `_, `pull request 129 `_ + + Assignees: Andrew Speake + + + .. change:: + :tags: workflow, mechanics, feature + :pullreq: 585 + + **Date**: 2021-05-03 + + Title: + dst=NA somehow shifted from AZ to AR - resstock-estimation: `pull request 106 `_ + Description: + Update default daylight saving start and end dates to March 12 and November 5, respectively + AZ counties did not have daylight saving dates set to NA (instead, some AR counties did). This corrects that. + This PR also updates daylight saving dates from April 7 to October 26 to March 12 through November 5 (current OS-HPXML default values). - Assignees: Tony + Assignees: Joe Robertson .. change:: - :tags: workflow, heat pumps, bugfix - :pullreq: 564 + :tags: workflow, mechanics, bugfix + :pullreq: 585 - **Date**: 2021-03-26 + **Date**: 2021-05-02 Title: - Fix the supplimental capacity to autosize and reorder for efficiency + dst=NA somehow shifted from AZ to AR Description: - Set all mini-split heat pump supplemental capacity to autosize - Make sure all the HVAC Heating Efficiency; MSHP options have the ResidentialHVACMiniSplitHeatPump argument supplemental_capacity=autosize. - - Reorder MSHP options based on efficiency. + Set AZ counties to NA daylight saving times instead of some AR counties + AZ counties did not have daylight saving dates set to NA (instead, some AR counties did). This corrects that - Assignees: Tony + Assignees: Joe Robertson .. change:: - :tags: workflow, schedules, bugfix - :pullreq: 571 + :tags: workflow, mechanics, feature + :pullreq: 583 - **Date**: 2021-04-08 + **Date**: 2021-04-29 Title: - Faster stochastic schedules + Project yml updates Description: - Reduce stochastic schedule generation runtime by over 50% - Related to NREL/OpenStudio-HPXML#697. - - ScheduleGenerator.create: - - develop: ~34 s - faster-schedules: ~10 s + Update example project yaml files to use buildstockbatch input schema version 0.3 + From schema 0.2 to 0.3. - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -706,13 +731,11 @@ v2.5.0 Changelog Description: Reduce stochastic schedule generation runtime by over 50% Related to NREL/OpenStudio-HPXML#706. - ScheduleGenerator.create: - develop: ~10 s faster-schedules2: ~7 s - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -730,276 +753,252 @@ v2.5.0 Changelog resstock-estimation: `pull request 123 `_ - Assignees: Lixi + Assignees: Lixi Liu .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 585 + :tags: workflow, schedules, bugfix + :pullreq: 571 - **Date**: 2021-05-02 + **Date**: 2021-04-08 Title: - dst=NA somehow shifted from AZ to AR + Faster stochastic schedules Description: - Set AZ counties to NA daylight saving times instead of some AR counties - AZ counties did not have daylight saving dates set to NA (instead, some AR counties did). This corrects that + Reduce stochastic schedule generation runtime by over 50% + Related to NREL/OpenStudio-HPXML#697. + ScheduleGenerator.create: + develop: ~34 s + faster-schedules: ~10 s - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: characteristics, sampling, bugfix - :pullreq: 592 + :tags: workflow, schedules, feature + :pullreq: 566 - **Date**: 2021-05-27 + **Date**: 2021-04-02 Title: - Housing Characteristic Fixes + Addresses #562, use Schedule:File with plug/fuel loads Description: - Housing characteristics fixes based on more samples in testing - project_national - Add Geometry Attic Type.tsv - Ensure assumptions are consistent for 5 to 9 unit buildings and their number of units. The assumption was added that 5 to 9 unit buildings cannot be >10 stories was not transparent in Geometry Building Number Units MF.tsv, but is enforced in Geometry Stories. The sampling_probability is 0, so the option values are set to "Option=None". - Add Geometry Attic Type as a dependency in Insulation Unfinished Attic.tsv - Script Roof Material Finished Roof.tsv and Roof Material Unfinished Attic.tsv. - project_testing - Add Geometry Attic Type.tsv - Add Geometry Attic Type as a dependency in Insulation Unfinished Attic.tsv - Script Roof Material Finished Roof.tsv and Roof Material Unfinished Attic.tsv. - Add Geometry Attic Type as a dependency to Roof Material Finished Roof.tsv and Roof Material Unfinished Attic.tsv. - Add Geometry Stories as a dependency for Geometry Building Number Units MF.tsv - Pier and Beam Foundations cannot have garages - Add HVAC Cooling Type as a dependency to HVAC Cooling Efficiency.tsv - - resstock-estimation: `pull request 134 `_ + Use Schedule:File with well pump / vehicle plug loads, as well as gas grill / fireplace / lighting fuel loads. This enables the optional vacancy period to apply to these end uses + Populate well pump and vehicle plug loads, as well as grill / lighting / fireplace fuel loads, in the schedule csv. Remove weekday / weekend / monthly schedule arguments from ResidentialMiscLargeUncommonLoads measure and the options lookup. Apply vacancy to these plug/fuel loads. - Assignees: Tony + Assignees: Joe Robertson .. change:: - :tags: characteristics, windows, bugfix - :pullreq: 597 + :tags: workflow, heat pumps, bugfix + :pullreq: 564 - **Date**: 2021-07-14 + **Date**: 2021-03-26 Title: - WWR calculation for facades w/ doors + Fix the supplimental capacity to autosize and reorder for efficiency Description: - Fixes window-to-wall ratio calculation for facades with doors - Fixes window-to-wall ratio calculation for facades with doors. Previously if a facade had a door, the WWR would be applied to the net wall area instead of gross wall area. Added a unit test that demonstrates the fix -- previously the front window area was 95.6 ft2, now it's 100 ft2 and matches the results from ResStock-HPXML. + Set all mini-split heat pump supplemental capacity to autosize + Make sure all the HVAC Heating Efficiency; MSHP options have the ResidentialHVACMiniSplitHeatPump argument supplemental_capacity=autosize. + Reorder MSHP options based on efficiency. - Assignees: Scott + Assignees: Anthony Fontanini .. change:: - :tags: characteristics, bathrooms, bugfix - :pullreq: 601 + :tags: workflow, mechanics, bugfix + :pullreq: 560 - **Date**: 2021-06-10 + **Date**: 2021-03-25 Title: - Number of bathrooms + Bugfix/invalid geometry garage size Description: - Fixes number of bathrooms for single-family attached and multi-family buildings - This PR makes two changes: - - Updates number of bathrooms to use the BAHSP equation (Nbedrooms/2 + 0.5) and fixes the values used for SFA/MF. - Rounds down the number of bathrooms to the nearest integer for the assumption of number of bath fans. (E.g., a 1.5 bathroom home will now have 1 bath fan instead of 1.5 bath fans.) + Fixes invalid garage and living space dimension errors + The geometry measure is throwing an error due to garage sizes compared to the conditioned space size. We believe the error is due to the tucked garage is larger than either the depth or width of the first floor of the single-family detached unit. + + resstock-estimation: `pull request 106 `_ - Assignees: Scott + Assignees: Anthony Fontanini .. change:: - :tags: characteristics, mechanics, bugfix - :pullreq: 609 + :tags: workflow, mechanics, bugfix + :pullreq: 556 - **Date**: 2021-06-10 + **Date**: 2021-03-16 Title: - Update sampling_probabilty column based on bug in tsv_dist + Addresses #555, unfinished attic floor material layers are reversed Description: - Sync the sample probabilities after a bug fix in tsv_dist - The tsv_dist function was updated in the EULP-uncertainty-quantification PR #27. This update was due to a bug in identifying dependency intersections. As a result, the sample_probability column has updated for many housing characteristics. - - resstock-estimation: `pull request 142 `_ + Reverses the material layers of the unfinished attic floor construction so that they are correctly ordered outside-to-inside + Unfinished attic floor material layers are reversed - Assignees: Tony + Assignees: Joe Robertson .. change:: - :tags: characteristics, balancing areas, bugfix - :pullreq: 613 + :tags: characteristics, envelope, bugfix + :pullreq: 553 - **Date**: 2021-06-18 + **Date**: 2021-03-08 Title: - Rename ReEDS to REEDS + Bug Fix: Too many bedrooms for small units Description: - Fix name of ReEDS balancing areas - In the results.csv the ReEDS column gets interpreted as re_eds which makes the column hard to search for. Even though "ReEDS" is correct, it was decided that the TSV name will be "REEDS". + Dwelling units that are 0-499 ft2 are limited to a maximum of 2 bedrooms + This pull request updates the number of bedrooms for small units. - resstock-estimation: `pull request 143 `_ + resstock-estimation: `pull request 104 `_ - Assignees: Tony + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 653 + :tags: workflow, schedules, feature + :pullreq: 550 - **Date**: 2021-07-27 + **Date**: 2021-03-04 Title: - Hot water recirc pump bugfix, take 2 + Apply schedule geo-temporal shifting Description: - Fixes hot water distribution internal gains not being zeroed out during vacancies - Follow-up to #646. It turns out that the recirculation pump was correctly reflecting the vacancy status for a unit, so that code is reverting. While making the change, I noticed that the internal gains associated with the hot water distribution system were not being zeroed out for vacant units, so that is fixed here too - - Assignees: Scott - - - .. change:: - :tags: workflow, cost multipliers, bugfix - :pullreq: 674 - - **Date**: 2021-08-05 - - Title: - Exclude corridor doors in door area cost multiplier + Geo-temporal shifting of the stochastic load model schedules using the American Time Use Survey + The appliance schedules are shifted based on geography (state), day type(weekday/weekend), and month. + The amount of shift is defined in resources/measures/HPXMLtoOpenStudio/resources/schedules/weekday/state_and_monthly_schedule_shift.csv + and + resources/measures/HPXMLtoOpenStudio/resources/schedules/weekend/state_and_monthly_schedule_shift.csv + files. - Description: - Exclude adiabatic doors when outputting the door area cost multiplier - Backports approach used by OS-HPXML, in which adiabatic doors are not included in the door area cost multiplier output. + resstock-estimation: `pull request 101 `_ - Assignees: Andrew + Assignees: Rajendra Adhikari .. change:: - :tags: workflow, hvac, bugfix - :pullreq: 694 + :tags: characteristics, hvac, feature + :pullreq: 551 - **Date**: 2021-08-31 + **Date**: 2021-03-02 Title: - Disaggregate fan coil fan energy use + Room AC Setpoint Dependency Description: - Disaggregate the shared fan coil's fan energy use into heating and cooling - Was previously all lumped into ElectricityFansCooling with a FIXME. + Introduce different cooling setpoint distributions for window ACs + Adds HVAC Cooling Type dependency to Cooling Setpoint.tsv. Cooling type is not queried in RECS, and setpoints are determined the same as before, however the underlying temperature data for Room ACs is reduced by 6F to better align with the 2009 Residential Appliance Saturation Study (RASS). + + resstock-estimation: `pull request 96 `_ - Assignees: Joe + Assignees: Andrew Speake, Anthony Fontanini .. change:: - :tags: workflow, unmet hours, bugfix - :pullreq: 700 + :tags: characteristics, hvac, feature + :pullreq: 549 - **Date**: 2021-09-03 + **Date**: 2021-03-02 Title: - Fix unmet hours + Zonal Electric Heating Setpoints Description: - Fixes hours setpoint not met output to exclude A) no heating and/or cooling equipment and B) finished basements - Excludes reported unmet hours for A) no heating and/or cooling equipment and B) finished basements. + Include electric zonal heating equipment as a dependency in heating setpoint-related tsvs + Adds zonal electric heating equipment as a dependency for heating setpoint-related tsvs (Heating Setpoint, Heating Setpoint Offset Period, Heating Setpoint Offset Magnitude and Heating Setpoint Has Offset). Zonal electric heating includes "Built-In Electric Units" and "Portable Electric Heaters" in RECS 2009. Additionally, all weekend daytime heating and cooling setpoint offsets are removed - Assignees: Scott + resstock-estimation: `pull request 96 `_ + + Assignees: Anthony Fontanini .. change:: - :tags: characteristics, envelope, bugfix - :pullreq: 759 + :tags: characteristics, climate zones, feature + :pullreq: 548 - **Date**: 2021-11-17 + **Date**: 2021-02-18 Title: - add geometry_story_bin, add story_bin as dependency to geometry_wall_… + Introduce CEC Climate Zones Description: - Revert wall type constraint that assumes all brick facades built >1960 are wood-framed with 4" face brick. Also add constraint to force all buildings > 8 stories to have steel-framed wall type - Resolves: - - #[https://github.com/Missing building height dependency in Geometry Wall Type resstock-estimation#175] - #[https://github.com/Higher than expected brick %s in wall type in recent vintages resstock-estimation#145] - reverting fix for high brick %s in newer vintages + Introduce a CEC Building Climate Zone tag for samples in California + This pull requests add the California Energy Commission (CEC) Building Climate Zones into ResStock. A given building sample is tagged with a CEC climate zone (1-16) if the building is in California. If the sample is outside of California the sample is tagged with "None". - resstock-estimation: `pull request 177 `_ + resstock-estimation: `pull request 99 `_ - Assignees: Lixi + Assignees: Anthony Fontanini, Eric Wilson .. change:: - :tags: characteristics, envelope, bugfix - :pullreq: 789 + :tags: characteristics, lighting, feature + :pullreq: 545 - **Date**: 2022-01-18 + **Date**: 2021-02-18 Title: - Backport material properties from ResStock-HPXML + Increase LED saturation to 2019 projected values Description: - Fixes for wall constructions: remove wood sheathing on CMU and brick walls; better data for exterior finish absorptances and wall densities - Update exterior finish absorptance and wall density values to align with ResStock-HPXML values. Also removes sheathing layer from CMU and brick wall types. + Increase LED saturation to approximately 2019 levels + LED saturation is one of the fastest-changing technologies. Previously, we estimated that the LED saturation was ~10% based on the 2015 U.S. Lighting Market Characterization. - Assignees: Andrew + Assignees: Anthony Fontanini, Eric Wilson .. change:: - :tags: workflow, solar hot water, bugfix - :pullreq: 809 + :tags: characteristics, setpoints, feature + :pullreq: 541 - **Date**: 2022-01-27 + **Date**: 2021-02-15 Title: - Backport unit conversion bugfixes for solar hot model from OS-HPXML + Vacant Unit Heating Setpoints Description: - Fixes unit conversion bugs in solar hot water model - Backport unit conversion bugfixes for solar hot model from OS-HPXML + Reduce vacant unit heating setpoints to 55ºF + Assign Vacant Unit Heating Setpoints to 55F. The assumption is close to a "don't freeze the pipes" instead of using occupied setpoints. + + resstock-estimation: `pull request 96 `_ - Assignees: Scott + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 821 + :tags: workflow, mechanics, feature + :pullreq: 439 - **Date**: 2022-02-03 + **Date**: 2021-02-09 Title: - Update national project YAMLs with unit counts from ACS 2019 5-year + Single-Unit Geometry Description: - Update the number of units represented in the national project YAML files to the American Community Survey 2019 5-year estimate - In the YAML files, the n_buildings_represented was 110,000,000. This estimate is a bit low compared to the ACS 2019 5-year estimate of 136,569,411. - - This PR updates the YAML files to include the ACS 2019 5-year estimate of the number of housing units. + Model multifamily and single-family attached buildings as individual dwelling units instead of multiple units representing a building + Updates geometry measures and various measure resources to model MF and SFA homes as single units. The geometry measures now apply adiabatic boundary conditions to surfaces that would otherwise be shared in the current MF and SFA modeling approaches - Assignees: Tony + Assignees: Andrew Speake .. change:: :tags: workflow, mechanics, bugfix - :pullreq: 817 + :pullreq: 543 - **Date**: 2022-02-03 + **Date**: 2021-02-09 Title: - Finished Roof Bugfix + Speed up TSV fetching Description: - Properly apply roof insulation when the attic type is Finished Attic or Cathedral Ceilings - Insulation Roof options are not applying insulation correctly because attic spaces are modeled as unfinished, and no applicable surfaces are found in the ResidentialConstructionsFinishedRoof measure. This PR applies roof insulation via the ResidentialConstructionsUnfinishedAttic instead. - - This keeps attic spaces modeled as unfinished, correctly applies insulation, and better aligns with the resstock-hpxml attic construction. + Fixes significant runtime bottleneck in TSV fetching in BuildExistingModel & ApplyUpgrade measures + A bug in the buildstock.rb get_measure_args_from_option_names() method was causing the entirety of every TSV to be processed even when the option(s) of interest had already been found. As the number and length of TSVs has grown, so has this bottleneck. - Assignees: Andrew + Assignees: Scott Horowitz diff --git a/docs/read_the_docs/source/changelog/changelog_3_0_0.rst b/docs/read_the_docs/source/changelog/changelog_3_0_0.rst index d9703eb235..890fd1bb62 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_0_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_0_0.rst @@ -7,192 +7,194 @@ v3.0.0 Changelog :released: 2023-02-03 .. change:: - :tags: workflow, mechanics, feature - :pullreq: 443 + :tags: software, openstudio, feature + :pullreq: 1015 - **Date**: 2022-02-10 + **Date**: 2023-02-01 Title: - ResStock-HPXML + Latest OS-HPXML Description: - Transition to using the HPXML-based workflow - Subtree resources/hpxml-measures to github.com/NREL/OpenStudio-HPXML. + Update to OpenStudio v3.5.1 + OS 3.5.1 - OpenStudio-HPXML: `pull request 372 `_ + OpenStudio-HPXML: `pull request 1251 `_ - Assignees: Joe, Andrew + Assignees: Joe Robertson, Scott Horowitz .. change:: - :tags: workflow, cost multipliers, feature - :pullreq: 870 + :tags: characteristics, income, feature + :pullreq: 1004 - **Date**: 2022-04-11 + **Date**: 2022-11-09 Title: - Unvented crawlspace upgrade + Add AMI + modified tsvs from resstock-estimation refactoring/opt Description: - Add a new "Floor Area, Foundation (ft^2)" cost multiplier - Unvented crawlspace upgrade + Add area median income + Using the traditional method of copying files over from resstock-estimation, add AMI and other modified tsvs from a recent set of resstock-estimation PRs refactoring and optimizing tsv_making processes. + + resstock-estimation: `pull request 243 `_, `pull request 302 `_, `pull request 304 `_ - Assignees: Joe + Assignees: Lixi Liu, Anthony Fontanini .. change:: - :tags: workflow, cost multipliers, feature - :pullreq: 848 + :tags: characteristics, floor area, feature + :pullreq: 978 - **Date**: 2022-04-06 + **Date**: 2022-10-27 Title: - Handle incremental costs of (1) adding attic insulation and (2) reducing (%) infiltration + AHS 2019 and 2021 data for simulated conditioned floor area Description: - Add a new "Floor Area, Attic * Insulation Increase (ft^2 * Delta R-value)" cost multiplier for handling incremental costs of adding attic insulation - Handle incremental costs of adding attic insulation + Modeled floor area based on AHS 2021 and AHS 2019 + Use the AHS 2019, 2021 data for the simulated conditioned floor area ResStock arguments. Link to the AHS table used is HERE. For multi-family the ACS multi-family building types were combined using a weighted average where there were enough samples. - Assignees: Joe + Assignees: Anthony Fontanini, Lixi Liu .. change:: - :tags: workflow, cost multipliers, feature - :pullreq: 848 + :tags: workflow, utility bills, feature + :pullreq: 984 - **Date**: 2022-04-06 + **Date**: 2022-09-09 Title: - Handle incremental costs of (1) adding attic insulation and (2) reducing (%) infiltration + Optionally calculate simple utility bills Description: - Allow air leakage % reduction upgrades (e.g., 25%), and add a new "Floor Area, Conditioned * Infiltration Reduction (ft^2 * Delta ACH50)" cost multiplier for handling incremental costs of such upgrades - Add generic multiplier argument to infiltration options to facilitate % reductions in ACH50 + Add ability to calculate simple utility bills for various scenarios + Call new ReportUtilityBills measure from OS-HPXML. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: characteristics, testing, feature - :pullreq: 828 + :tags: characteristics, mechanics, bugfix + :pullreq: 982 - **Date**: 2022-03-09 + **Date**: 2022-08-26 Title: - Changes after switching to ResStock-HPXML + Update join_tsv to use raw source_count Description: - For the testing project, sample equal distributions of (1) smooth and stochastic schedules (each 50%) and (2) faulted and non-faulted HVAC systems (each 50%) - project_testing/Schedules.tsv to equal distribution of Default and Stochastic - project_testing/HVAC System Is Faulted.tsv to equal distribution of No and Yes + Update low-sample downscaling logic to use raw source_weight, which leads to minor changes to Geometry Floor Area and HVAC Partial Space Conditioning + TSV changes from updating join_distributions_in_order to use raw source_weight (previously, it uses what is now called fallback_weight which artificially increases the weight of undersampled options, thus making it deviate more from the sample truth marginal distributions) - resstock-estimation: `pull request 193 `_ + resstock-estimation: `pull request 248 `_ - Assignees: Joe, Andrew + Assignees: Lixi Liu, Anthony Fontanini .. change:: - :tags: workflow, mechanics, feature - :pullreq: 839 + :tags: characteristics, mechanics, bugfix + :pullreq: 981 - **Date**: 2022-02-28 + **Date**: 2022-08-22 Title: - Extend ApplyUpgrade for upgrade measures + TSV changes from improved low samples handling Description: - Allow upgrade options to be defined in the lookup using measures other than ResStockArguments - Support "upgrade" measures that are not part of the OS-HPXML workflow, and are tacked on after model is created. + Remove Void from dependency columns in TSVs and update tests + Some TSVs have "Option=Void" as one of the available options. The idea behind Void is that certain dependency conditions are structurally impossible. For example, for "HVAC Heating Type and Fuel.tsv", it's impossible that "Heating Fuel" = Electricity and "HVAC Heating Efficiency" = "Fuel Boiler". So, this particular dependency condition get's Void option. + + resstock-estimation: `pull request 245 `_ - Assignees: Joe + Assignees: Rajendra Adhikari .. change:: - :tags: workflow, rim joists, feature - :pullreq: 831 + :tags: workflow, setpoints, bugfix + :pullreq: 975 - **Date**: 2022-02-16 + **Date**: 2022-08-17 Title: - Enable rim joists + Support auto_seasons arguments Description: - Enable rim joists for homes with basements/crawlspaces; assumes a height of 9.25 inches and calculates rim joist assembly R-value from new insulation arguments - Enable rim joists (set this by default, and r-value to foundation wall r-value); we could potentially enable rim joists between floors by adjusting average ceiling height, but we won't for now + Fix heating and cooling auto-season inputs + Looks like OS-HPXML auto_seasons related arguments may have been updated, but ResStockArguments subsequently was not. I believe this was not caught because our testing project does not currently sample any setpoint options which enable the auto_seasons arguments. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, hescore, feature - :pullreq: 782 + :tags: characteristics, hvac, feature + :pullreq: 964 - **Date**: 2022-02-14 + **Date**: 2022-07-15 Title: - HEScore Workflow + Introduce cooling partial space conditioning Description: - Enable the HEScore workflow to be run with BuildExistingModel - Enables to the HEScore workflow to be run from BuildExistingModel. A new argument os_hescore_directory is added in BuildExistingModel which points to a local checkout of https://github.com/NREL/OpenStudio-HEScore. + Add distributions for partial space cooling + Introduce partial space conditioning for cooling. - Assignees: Andrew + resstock-estimation: `pull request 235 `_, `pull request 233 `_, `pull request 241 `_ + + Assignees: Anthony Fontanini, Rajendra Adhikari .. change:: - :tags: characteristics, geography, feature - :pullreq: 874 + :tags: characteristics, mechanics, bugfix + :pullreq: 959 - **Date**: 2022-04-20 + **Date**: 2022-07-09 Title: - City Boundaries + Ll/rename sources Description: - Cities with more than 15,000 dwelling units are added as a geographic characteristic - Adding City boundaries as a housing characteristic in ResStock. This way users can aggregate directly by a given City. + Rename sources subfolders so all tsv_makers can be imported as packages + Rename sources folders so all tsv_makers can be imported as packages. Packages cannot contain names that start with a number. - resstock-estimation: `pull request 196 `_ + resstock-estimation: `pull request 238 `_ - Assignees: Tony + Assignees: Lixi Liu .. change:: - :tags: characteristics, mechanics, feature - :pullreq: 905 + :tags: characteristics, income, feature + :pullreq: 949 - **Date**: 2022-04-27 + **Date**: 2022-07-08 Title: - update tsvs with new sampling_prob + add income + tenure to floor_area Description: - Update tsvs with new sampling_probability calculation - TODO + Add Income and Tenure into Geometry Floor Area + Add Income and Tenure to Geometry Floor Area - resstock-estimation: `pull request 210 `_, `pull request 203 `_ + resstock-estimation: `pull request 233 `_ - Assignees: Lixi + Assignees: Lixi Liu .. change:: - :tags: characteristics, heat pumps, feature - :pullreq: 913 + :tags: characteristics, mechanics, bugfix + :pullreq: 934 - **Date**: 2022-05-02 + **Date**: 2022-06-02 Title: - Improve heat pump distributions for Texas and Florida + Fix/tsv tags sampling prob etc Description: - Improve distributions of heat pumps in the southeast U.S. by spliting IECC zone 2A into two zones: 2A (FL, GA, AL, MS) and 2A (TX, LA) - Currently using IECC climate zone for HVAC Heating Type - Zone 2A is 16%-20% HP, whereas Reportable Domain of TX (3%), FL (20%) - Solution: Split 2A into two chunks, 2A (FL, GA, AL, MS), and 2A (TX, LA) + Fix minor bug in sampling probability calculation - resstock-estimation: `pull request 209 `_ + resstock-estimation: `pull request 221 `_ - Assignees: Phil, Eric, Tony + Assignees: Lixi Liu, Anthony Fontanini .. change:: @@ -209,131 +211,131 @@ v3.0.0 Changelog Update PUMS tsvs from 2017 5-yrs to 2019 5-yrs, Add new tvs: Income, Income RECS2015, Federal Poverty Level, Tenure, and PUMA Metro Status (a few of them are explained in detail below.) - Assignees: Lixi, Tony, Nate + Assignees: Lixi Liu, Anthony Fontanini, Nate Moore .. change:: - :tags: characteristics, income, feature - :pullreq: 949 + :tags: characteristics, heat pumps, feature + :pullreq: 913 - **Date**: 2022-07-08 + **Date**: 2022-05-02 Title: - add income + tenure to floor_area + Improve heat pump distributions for Texas and Florida Description: - Add Income and Tenure into Geometry Floor Area - Add Income and Tenure to Geometry Floor Area + Improve distributions of heat pumps in the southeast U.S. by spliting IECC zone 2A into two zones: 2A (FL, GA, AL, MS) and 2A (TX, LA) + Currently using IECC climate zone for HVAC Heating Type + Zone 2A is 16%-20% HP, whereas Reportable Domain of TX (3%), FL (20%) + Solution: Split 2A into two chunks, 2A (FL, GA, AL, MS), and 2A (TX, LA) - resstock-estimation: `pull request 233 `_ + resstock-estimation: `pull request 209 `_ - Assignees: Lixi + Assignees: Phil White, Eric Wilson, Anthony Fontanini .. change:: - :tags: characteristics, hvac, feature - :pullreq: 964 + :tags: characteristics, mechanics, feature + :pullreq: 905 - **Date**: 2022-07-15 + **Date**: 2022-04-27 Title: - Introduce cooling partial space conditioning + update tsvs with new sampling_prob Description: - Add distributions for partial space cooling - Introduce partial space conditioning for cooling. + Update tsvs with new sampling_probability calculation - resstock-estimation: `pull request 235 `_, `pull request 233 `_, `pull request 241 `_ + resstock-estimation: `pull request 210 `_, `pull request 203 `_ - Assignees: Tony, Rajendra + Assignees: Lixi Liu .. change:: - :tags: workflow, emissions, feature - :pullreq: 791 + :tags: characteristics, geography, feature + :pullreq: 874 - **Date**: 2022-02-01 + **Date**: 2022-04-20 Title: - ResStock-HPXML: Emissions calculations (e.g., CO2) + City Boundaries Description: - Add ability to calculate emissions for various scenarios - ResStock-HPXML: CO2 Emissions calculations + Cities with more than 15,000 dwelling units are added as a geographic characteristic + Adding City boundaries as a housing characteristic in ResStock. This way users can aggregate directly by a given City. + + resstock-estimation: `pull request 196 `_ - Assignees: Joe + Assignees: Anthony Fontanini .. change:: - :tags: workflow, utility bills, feature - :pullreq: 984 + :tags: workflow, cost multipliers, feature + :pullreq: 870 - **Date**: 2022-09-09 + **Date**: 2022-04-11 Title: - Optionally calculate simple utility bills + Unvented crawlspace upgrade Description: - Add ability to calculate simple utility bills for various scenarios - Call new ReportUtilityBills measure from OS-HPXML. + Add a new "Floor Area, Foundation (ft^2)" cost multiplier - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: characteristics, floor area, feature - :pullreq: 978 + :tags: workflow, cost multipliers, feature + :pullreq: 848 - **Date**: 2022-10-27 + **Date**: 2022-04-06 Title: - AHS 2019 and 2021 data for simulated conditioned floor area + Handle incremental costs of (1) adding attic insulation and (2) reducing (%) infiltration Description: - Modeled floor area based on AHS 2021 and AHS 2019 - Use the AHS 2019, 2021 data for the simulated conditioned floor area ResStock arguments. Link to the AHS table used is HERE. For multi-family the ACS multi-family building types were combined using a weighted average where there were enough samples. + Add a new "Floor Area, Attic * Insulation Increase (ft^2 * Delta R-value)" cost multiplier for handling incremental costs of adding attic insulation + Handle incremental costs of adding attic insulation - Assignees: Tony, Lixi + Assignees: Joe Robertson .. change:: - :tags: characteristics, income, feature - :pullreq: 1004 + :tags: workflow, cost multipliers, feature + :pullreq: 848 - **Date**: 2022-11-09 + **Date**: 2022-04-06 Title: - Add AMI + modified tsvs from resstock-estimation refactoring/opt + Handle incremental costs of (1) adding attic insulation and (2) reducing (%) infiltration Description: - Add area median income - Using the traditional method of copying files over from resstock-estimation, add AMI and other modified tsvs from a recent set of resstock-estimation PRs refactoring and optimizing tsv_making processes. - - resstock-estimation: `pull request 243 `_, `pull request 302 `_, `pull request 304 `_ + Allow air leakage % reduction upgrades (e.g., 25%), and add a new "Floor Area, Conditioned * Infiltration Reduction (ft^2 * Delta ACH50)" cost multiplier for handling incremental costs of such upgrades + Add generic multiplier argument to infiltration options to facilitate % reductions in ACH50 - Assignees: Lixi, Tony + Assignees: Joe Robertson .. change:: - :tags: software, openstudio, feature - :pullreq: 1015 + :tags: characteristics, mechanics, bugfix + :pullreq: 877 - **Date**: 2023-02-01 + **Date**: 2022-04-04 Title: - Latest OS-HPXML + Reduce TSV Sizes Description: - Update to OpenStudio v3.5.1 - OS 3.5.1 + Reduce housing characteristic file size by relaxing the six digit float format in the housing characteristics + As housing characteristics get bigger, we are moving to a compact writing style. The 6-digit float format requirement was put in place when most of the characteristics were not scripted. Now that there is a standard workflow for creating the characteristics, the formatting requirements are being relaxed. This change should allow for more accurate characteristic distributions because the exponential format can be used. The change should also stop round-off errors. - OpenStudio-HPXML: `pull request 1251 `_ + resstock-estimation: `pull request 200 `_ - Assignees: Joe, Scott + Assignees: Anthony Fontanini .. change:: - :tags: workflow, mechanics, bugfix + :tags: characteristics, testing, feature :pullreq: 828 **Date**: 2022-03-09 @@ -342,149 +344,127 @@ v3.0.0 Changelog Changes after switching to ResStock-HPXML Description: - Clean up option names for natural ventilation and hot water distribution - TODO + For the testing project, sample equal distributions of (1) smooth and stochastic schedules (each 50%) and (2) faulted and non-faulted HVAC systems (each 50%) + project_testing/Schedules.tsv to equal distribution of Default and Stochastic + project_testing/HVAC System Is Faulted.tsv to equal distribution of No and Yes resstock-estimation: `pull request 193 `_ - Assignees: Joe - - - .. change:: - :tags: workflow, heat pumps, bugfix - :pullreq: 833 - - **Date**: 2022-02-16 - - Title: - Remove backup switchover temp for non dual fuel heat pumps - - Description: - Remove the zero degree switchover temperature for heat pump backup heating - Remove heat_pump_backup_heating_switchover_temp=0.0 for non dual fuel heat pumps. Leave heat_pump_backup_heating_switchover_temp=30.0 for dual fuel heat pumps. - - Assignees: Joe, Andrew + Assignees: Joe Robertson, Andrew Speake .. change:: :tags: workflow, mechanics, bugfix - :pullreq: 830 + :pullreq: 828 - **Date**: 2022-02-14 + **Date**: 2022-03-09 Title: - Model finished attics + Changes after switching to ResStock-HPXML Description: - For homes with a finished attic or cathedral ceilings, models a conditioned attic instead of a vented attic - Change geometry_attic_type=VentedAttic when Geometry Attic Type samples Finished Attic or Cathedral Ceilings. + Clean up option names for natural ventilation and hot water distribution + + resstock-estimation: `pull request 193 `_ - Assignees: Joe, Andrew + Assignees: Joe Robertson .. change:: - :tags: characteristics, mechanics, bugfix - :pullreq: 877 + :tags: workflow, mechanics, feature + :pullreq: 839 - **Date**: 2022-04-04 + **Date**: 2022-02-28 Title: - Reduce TSV Sizes + Extend ApplyUpgrade for upgrade measures Description: - Reduce housing characteristic file size by relaxing the six digit float format in the housing characteristics - As housing characteristics get bigger, we are moving to a compact writing style. The 6-digit float format requirement was put in place when most of the characteristics were not scripted. Now that there is a standard workflow for creating the characteristics, the formatting requirements are being relaxed. This change should allow for more accurate characteristic distributions because the exponential format can be used. The change should also stop round-off errors. - - resstock-estimation: `pull request 200 `_ + Allow upgrade options to be defined in the lookup using measures other than ResStockArguments + Support "upgrade" measures that are not part of the OS-HPXML workflow, and are tacked on after model is created. - Assignees: Tony + Assignees: Joe Robertson .. change:: - :tags: characteristics, mechanics, bugfix - :pullreq: 934 + :tags: workflow, rim joists, feature + :pullreq: 831 - **Date**: 2022-06-02 + **Date**: 2022-02-16 Title: - Fix/tsv tags sampling prob etc + Enable rim joists Description: - Fix minor bug in sampling probability calculation - TODO - - resstock-estimation: `pull request 221 `_ + Enable rim joists for homes with basements/crawlspaces; assumes a height of 9.25 inches and calculates rim joist assembly R-value from new insulation arguments + Enable rim joists (set this by default, and r-value to foundation wall r-value); we could potentially enable rim joists between floors by adjusting average ceiling height, but we won't for now - Assignees: Lixi, Tony + Assignees: Joe Robertson .. change:: - :tags: characteristics, mechanics, bugfix - :pullreq: 959 + :tags: workflow, heat pumps, bugfix + :pullreq: 833 - **Date**: 2022-07-09 + **Date**: 2022-02-16 Title: - Ll/rename sources + Remove backup switchover temp for non dual fuel heat pumps Description: - Rename sources subfolders so all tsv_makers can be imported as packages - Rename sources folders so all tsv_makers can be imported as packages. Packages cannot contain names that start with a number. - - resstock-estimation: `pull request 238 `_ + Remove the zero degree switchover temperature for heat pump backup heating + Remove heat_pump_backup_heating_switchover_temp=0.0 for non dual fuel heat pumps. Leave heat_pump_backup_heating_switchover_temp=30.0 for dual fuel heat pumps. - Assignees: Lixi + Assignees: Joe Robertson, Andrew Speake .. change:: - :tags: workflow, setpoints, bugfix - :pullreq: 975 + :tags: workflow, hescore, feature + :pullreq: 782 - **Date**: 2022-08-17 + **Date**: 2022-02-14 Title: - Support auto_seasons arguments + HEScore Workflow Description: - Fix heating and cooling auto-season inputs - Looks like OS-HPXML auto_seasons related arguments may have been updated, but ResStockArguments subsequently was not. I believe this was not caught because our testing project does not currently sample any setpoint options which enable the auto_seasons arguments. + Enable the HEScore workflow to be run with BuildExistingModel + Enables to the HEScore workflow to be run from BuildExistingModel. A new argument os_hescore_directory is added in BuildExistingModel which points to a local checkout of https://github.com/NREL/OpenStudio-HEScore. - Assignees: TODO + Assignees: Andrew Speake .. change:: - :tags: characteristics, mechanics, bugfix - :pullreq: 981 + :tags: workflow, mechanics, bugfix + :pullreq: 830 - **Date**: 2022-08-22 + **Date**: 2022-02-14 Title: - TSV changes from improved low samples handling + Model finished attics Description: - Remove Void from dependency columns in TSVs and update tests - Some TSVs have "Option=Void" as one of the available options. The idea behind Void is that certain dependency conditions are structurally impossible. For example, for "HVAC Heating Type and Fuel.tsv", it's impossible that "Heating Fuel" = Electricity and "HVAC Heating Efficiency" = "Fuel Boiler". So, this particular dependency condition get's Void option. - - resstock-estimation: `pull request 245 `_ + For homes with a finished attic or cathedral ceilings, models a conditioned attic instead of a vented attic + Change geometry_attic_type=VentedAttic when Geometry Attic Type samples Finished Attic or Cathedral Ceilings. - Assignees: Rajendra + Assignees: Joe Robertson, Andrew Speake .. change:: - :tags: characteristics, mechanics, bugfix - :pullreq: 982 + :tags: workflow, mechanics, feature + :pullreq: 443 - **Date**: 2022-08-26 + **Date**: 2022-02-10 Title: - Update join_tsv to use raw source_count + ResStock-HPXML Description: - Update low-sample downscaling logic to use raw source_weight, which leads to minor changes to Geometry Floor Area and HVAC Partial Space Conditioning - TSV changes from updating join_distributions_in_order to use raw source_weight (previously, it uses what is now called fallback_weight which artificially increases the weight of undersampled options, thus making it deviate more from the sample truth marginal distributions) + Transition to using the HPXML-based workflow + Subtree resources/hpxml-measures to github.com/NREL/OpenStudio-HPXML. - resstock-estimation: `pull request 248 `_ + OpenStudio-HPXML: `pull request 372 `_ - Assignees: Lixi, Tony + Assignees: Joe Robertson, Andrew Speake diff --git a/docs/read_the_docs/source/changelog/changelog_3_1_0.rst b/docs/read_the_docs/source/changelog/changelog_3_1_0.rst index 710a69396f..a4524965c7 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_1_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_1_0.rst @@ -7,191 +7,184 @@ v3.1.0 Changelog :released: 2023-05-25 .. change:: - :tags: workflow, battery, feature - :pullreq: 1009 + :tags: software, openstudio, feature + :pullreq: 1076 - **Date**: 2023-03-07 + **Date**: 2023-05-25 Title: - Stub battery tsv for testing project + Latest OS-HPXML, OS v3.6.1 Description: - Include battery modeling capabilities for project_testing - Stub new Battery.tsv. - Separate battery related arguments from PV in options_lookup. - Test battery options using testing project. - - resstock-estimation: `pull request 321 `_ + Update to OpenStudio v3.6.1 - Assignees: Joe + Assignees: Joe Robertson, Scott Horowitz .. change:: - :tags: workflow, mechanics, feature - :pullreq: 1042 + :tags: workflow, mechanics, bugfix + :pullreq: 1076 - **Date**: 2023-03-07 + **Date**: 2023-05-25 Title: - Check a buildstock csv against an options_lookup tsv + Pulls in upstream OS-HPXML fix related to [falling back to a WWR calculation when window placement fails](https://github.com/NREL/OpenStudio-HPXML/pull/1385) causing errors fitting windows Description: - Ability to check buildstock csv against an options lookup as a command line utility - Enable "integrity checks" on buildstock.csv + Pulls in upstream OS-HPXML fix related to [falling back to a WWR calculation when window placement fails](https://github.com/NREL/OpenStudio-HPXML/pull/1385) causing errors fitting windows - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, unavailable periods, feature - :pullreq: 1054 + :tags: documentation, data dictionary, feature + :pullreq: 1058 - **Date**: 2023-03-15 + **Date**: 2023-05-10 Title: - Support for power outages + Data dictionary + automated RTD generation Description: - Demonstrate new power outage modeling feature using upgrades specified in example project yml files - Support for power outages + Add data dictionary files for describing various outputs. Use these files to (1) check against integration test results, and (2) generate documentation tables + One of the pain points we experience when importing ResStock runs into SightGlass (resstock.nrel.gov) is that the outputs and format of the outputs from ResStock frequently change. This causes our data processing for that to break and require many hours of manual updating every time we go to bring new data in. + It would be really helpful to have a data dictionary of the outputs ResStock produces meaning every column name (including the input and output columns) in the results.csv and timeseries parquet files. It should also include some flags about which are end uses to include in the sum vs aggregates (net or totals), units, other random outputs like load, emissions, etc. To keep this in sync, it should be verified against the CI runs of ResStock and if there is a discrepancy you get a big ❌ on your checks. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, feature - :pullreq: 1056 + :tags: workflow, heat pumps, feature + :pullreq: 1071 - **Date**: 2023-03-21 + **Date**: 2023-05-09 Title: - Support sample_weight in buildstock.csv + Add capacity retention arguments for ASHP Description: - Ability to specify a "sample_weight" column in the precomputed buildstock.csv - Adds support for a sample_weight column in the precomputed buildstock.csv. By default, BuildExistingModel writes build_existing_model.sample_weight based on calculating n_buildings_represented / n_datapoints (this calculation is done in the workflow generator and then passed into the BuildExistingModel measure). Now, if sample_weight already exists in the buildstock.csv, it will write this value instead of the calculated one. + Connect ASHP to optional capacity retention temperature and fraction arguments (that already exist for MSHP) - Assignees: Joe + Assignees: Joe Robertson, Scott Horowitz .. change:: - :tags: characteristics, documentation, feature - :pullreq: 1069 + :tags: workflow, heat pumps, feature + :pullreq: 1072 - **Date**: 2023-05-01 + **Date**: 2023-05-09 Title: - Add descriptions to housing characteristics + HP heating capacity retention Description: - Add descriptions to the housing characteristics - Add a description tag to each of the housing characteristics. Add the source reports from resstock-estimation to resstock. + OS-HPXML now supports use of optional heat pump capacity retention temperature and fraction arguments (applicable to both ASHP and MSHP) + Adds optional inputs for defining heat pump capacity retention: + extension/HeatingCapacityRetention/Fraction + extension/HeatingCapacityRetention/Temperature - resstock-estimation: `pull request 366 `_ + OpenStudio-HPXML: `pull request 1383 `_ - Assignees: Tony + Assignees: Joe Robertson, Scott Horowitz .. change:: - :tags: workflow, heat pumps, feature - :pullreq: 1071 + :tags: characteristics, documentation, feature + :pullreq: 1069 - **Date**: 2023-05-09 + **Date**: 2023-05-01 Title: - Add capacity retention arguments for ASHP + Add descriptions to housing characteristics Description: - Connect ASHP to optional capacity retention temperature and fraction arguments (that already exist for MSHP) - Add capacity retention arguments for ASHP + Add descriptions to the housing characteristics + Add a description tag to each of the housing characteristics. Add the source reports from resstock-estimation to resstock. + + resstock-estimation: `pull request 366 `_ - Assignees: Joe, Scott + Assignees: Anthony Fontanini .. change:: - :tags: documentation, data dictionary, feature - :pullreq: 1058 + :tags: workflow, mechanics, feature + :pullreq: 1056 - **Date**: 2023-05-10 + **Date**: 2023-03-21 Title: - Data dictionary + automated RTD generation + Support sample_weight in buildstock.csv Description: - Add data dictionary files for describing various outputs. Use these files to (1) check against integration test results, and (2) generate documentation tables - One of the pain points we experience when importing ResStock runs into SightGlass (resstock.nrel.gov) is that the outputs and format of the outputs from ResStock frequently change. This causes our data processing for that to break and require many hours of manual updating every time we go to bring new data in. - - It would be really helpful to have a data dictionary of the outputs ResStock produces meaning every column name (including the input and output columns) in the results.csv and timeseries parquet files. It should also include some flags about which are end uses to include in the sum vs aggregates (net or totals), units, other random outputs like load, emissions, etc. To keep this in sync, it should be verified against the CI runs of ResStock and if there is a discrepancy you get a big ❌ on your checks. + Ability to specify a "sample_weight" column in the precomputed buildstock.csv + Adds support for a sample_weight column in the precomputed buildstock.csv. By default, BuildExistingModel writes build_existing_model.sample_weight based on calculating n_buildings_represented / n_datapoints (this calculation is done in the workflow generator and then passed into the BuildExistingModel measure). Now, if sample_weight already exists in the buildstock.csv, it will write this value instead of the calculated one. - Assignees: Joe + Assignees: Joe Robertson .. change:: - :tags: workflow, heat pumps, feature - :pullreq: 1072 + :tags: workflow, unavailable periods, feature + :pullreq: 1054 - **Date**: 2023-05-09 + **Date**: 2023-03-15 Title: - HP heating capacity retention + Support for power outages Description: - OS-HPXML now supports use of optional heat pump capacity retention temperature and fraction arguments (applicable to both ASHP and MSHP) - Adds optional inputs for defining heat pump capacity retention: - - extension/HeatingCapacityRetention/Fraction - extension/HeatingCapacityRetention/Temperature - - OpenStudio-HPXML: `pull request 1383 `_ + Demonstrate new power outage modeling feature using upgrades specified in example project yml files - Assignees: Joe, Scott + Assignees: Joe Robertson .. change:: - :tags: software, openstudio, feature - :pullreq: 1076 + :tags: workflow, mechanics, bugfix + :pullreq: 1054 - **Date**: 2023-05-25 + **Date**: 2023-03-15 Title: - Latest OS-HPXML, OS v3.6.1 + Pulls in upstream OS-HPXML fix related to [avoiding possible OpenStudio temporary directory collision](https://github.com/NREL/OpenStudio-HPXML/pull/1316) causing random errors Description: - Update to OpenStudio v3.6.1 - Latest OS-HPXML, OS v3.6.1 + Pulls in upstream OS-HPXML fix related to [avoiding possible OpenStudio temporary directory collision](https://github.com/NREL/OpenStudio-HPXML/pull/1316) causing random errors - Assignees: Joe, Scott + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 1054 + :tags: workflow, battery, feature + :pullreq: 1009 - **Date**: 2023-03-15 + **Date**: 2023-03-07 Title: - Pulls in upstream OS-HPXML fix related to [avoiding possible OpenStudio temporary directory collision](https://github.com/NREL/OpenStudio-HPXML/pull/1316) causing random errors + Stub battery tsv for testing project Description: - Pulls in upstream OS-HPXML fix related to [avoiding possible OpenStudio temporary directory collision](https://github.com/NREL/OpenStudio-HPXML/pull/1316) causing random errors - Pulls in upstream OS-HPXML fix related to [avoiding possible OpenStudio temporary directory collision](https://github.com/NREL/OpenStudio-HPXML/pull/1316) causing random errors + Include battery modeling capabilities for project_testing + Stub new Battery.tsv. + Separate battery related arguments from PV in options_lookup. + Test battery options using testing project. - Assignees: Joe + resstock-estimation: `pull request 321 `_ + + Assignees: Joe Robertson .. change:: - :tags: workflow, mechanics, bugfix - :pullreq: 1076 + :tags: workflow, mechanics, feature + :pullreq: 1042 - **Date**: 2023-05-25 + **Date**: 2023-03-07 Title: - Pulls in upstream OS-HPXML fix related to [falling back to a WWR calculation when window placement fails](https://github.com/NREL/OpenStudio-HPXML/pull/1385) causing errors fitting windows + Check a buildstock csv against an options_lookup tsv Description: - Pulls in upstream OS-HPXML fix related to [falling back to a WWR calculation when window placement fails](https://github.com/NREL/OpenStudio-HPXML/pull/1385) causing errors fitting windows - Pulls in upstream OS-HPXML fix related to [falling back to a WWR calculation when window placement fails](https://github.com/NREL/OpenStudio-HPXML/pull/1385) causing errors fitting windows + Ability to check buildstock csv against an options lookup as a command line utility + Enable "integrity checks" on buildstock.csv - Assignees: Joe + Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_3_1_1.rst b/docs/read_the_docs/source/changelog/changelog_3_1_1.rst index 7f02104ddc..3a4d019b32 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_1_1.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_1_1.rst @@ -19,6 +19,6 @@ v3.1.1 Changelog Use `Gem::Version` on buildstockbatch version string comparisons so that, e.g., '2023.10.0' < '2023.5.0' does not evaluate to true Patched release with version comparison fix - Assignees: Joe + Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_3_2_0.rst b/docs/read_the_docs/source/changelog/changelog_3_2_0.rst index fb16f1b825..28d6514a31 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_2_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_2_0.rst @@ -19,7 +19,7 @@ v3.2.0 Changelog Update TMY3 weather URL from the NREL Data Catalog The current link in the project YAMLs for the TMY weather files in NREL Data Catalog is out of date and missing the following Counties. This PR updates the link to the latest file on the NREL Data Catalog. - Assignees: Tony + Assignees: Anthony Fontanini .. change:: @@ -37,7 +37,7 @@ v3.2.0 Changelog OpenStudio-HPXML: `pull request 1391 `_ - Assignees: Prateek, Jeff, Tony, Joe + Assignees: Prateek Shrestha, Jeff Maguire, Anthony Fontanini, Joe Robertson .. change:: @@ -55,7 +55,7 @@ v3.2.0 Changelog resstock-estimation: `pull request 393 `_ - Assignees: Tony + Assignees: Anthony Fontanini .. change:: @@ -71,7 +71,7 @@ v3.2.0 Changelog Automate creation of new "Arguments" documentation sections for summarizing arguments (and their default values) in options_lookup.tsv By housing characteristic parameter, automates summarizing Arguments sets used in options_lookup.tsv (including Name, Required, Units, Type, Choices, Description). See below for example. - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -89,7 +89,7 @@ v3.2.0 Changelog resstock-estimation: `pull request 392 `_ - Assignees: Tony + Assignees: Anthony Fontanini .. change:: @@ -105,7 +105,7 @@ v3.2.0 Changelog Update to OpenStudio v3.7.0 OpenStudio 3.7.0/EnergyPlus 23.2.0 - Assignees: Joe, Scott + Assignees: Joe Robertson, Scott Horowitz .. change:: @@ -121,7 +121,7 @@ v3.2.0 Changelog Add ability to calculate detailed utility bills based on a user-specified TSV file of paths to JSON utility rate tariff files Add optional detailed_filepath yml argument for pointing to user-specified TSV file of electricity tariff file paths. The TSV file can contain electricity tariff file paths mapped by State, or any other parameter. - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -137,7 +137,7 @@ v3.2.0 Changelog Add ability to request timeseries resilience output from the yml file Include the new include_timeseries_resilience argument in example yml files. - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -155,7 +155,7 @@ v3.2.0 Changelog resstock-estimation: `pull request 385 `_ - Assignees: Lixi + Assignees: Lixi Liu .. change:: @@ -171,7 +171,7 @@ v3.2.0 Changelog Update `run_analysis.rb` to handle illegal path characters in upgrade names run_analysis.rb creates directories based on upgrade names, but these upgrade names may have illegal path characters in them (e.g., "/" if the upgrade name is "Higher efficiency ducted ASHP w/ elec backup "), resulting in an obscure error. It should more gracefully handle this situation and be able to run upgrades with these characters in the name. - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -187,7 +187,7 @@ v3.2.0 Changelog Update `run_analysis.rb` to map datapoints to run folder names when the `-k` argument is supplied Also, adds writing run folder names (e.g., "run1", "run2", etc.) to the "job_id" column when supplying the -k argument to run_analysis.rb (i.e., a map from datapoint to run folder). - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -205,7 +205,7 @@ v3.2.0 Changelog resstock-estimation: `pull request 388 `_ - Assignees: Rajendra + Assignees: Rajendra Adhikari .. change:: @@ -223,7 +223,7 @@ v3.2.0 Changelog resstock-estimation: `pull request 386 `_ - Assignees: Rajendra + Assignees: Rajendra Adhikari .. change:: @@ -241,7 +241,7 @@ v3.2.0 Changelog resstock-estimation: `pull request 386 `_ - Assignees: Rajendra + Assignees: Rajendra Adhikari .. change:: @@ -257,7 +257,7 @@ v3.2.0 Changelog Correct refrigerator rated annual kWh based on EF and an assumed volume of 20.9cft. Change the rated annual consumption of refrigerator and misc extra refrigerator in options_lookup.tsv - Assignees: Lixi + Assignees: Lixi Liu .. change:: @@ -273,7 +273,7 @@ v3.2.0 Changelog For heat pump upgrades, adds the ability to set the existing primary (non-shared) heating system as the backup system using only a single option from the lookup Uses ResStockArguments to add a new boolean argument heat_pump_backup_use_existing_system. - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -295,7 +295,7 @@ v3.2.0 Changelog resstock-estimation: `pull request 377 `_ - Assignees: Lixi, Joe + Assignees: Lixi Liu, Joe Robertson .. change:: @@ -311,7 +311,7 @@ v3.2.0 Changelog Fix square footage for a MF dwelling unit in the "3000-3999" CFA bin (from 33171 to 3171) This shows square footage for an MF housing bin of 3000-3999 to be 33171. I assume this is incorrect and a typo, but should be a quick fix - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -331,7 +331,7 @@ v3.2.0 Changelog OpenStudio-HPXML: `pull request 1414 `_ - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -351,7 +351,7 @@ v3.2.0 Changelog OpenStudio-HPXML: `pull request 1414 `_ - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -368,7 +368,7 @@ v3.2.0 Changelog Water Heater Efficiency|Other Fuel to model a wood storage water heater instead of no water heater. HVAC Heating Efficiency|Other to model a wood wall/floor furnace instead of no heating system. - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -384,7 +384,7 @@ v3.2.0 Changelog Set standard format for options_lookup In an effort to clean up resources/options_lookup.tsv, this sets a standard for what the file should look like. - Assignees: Rajendra, Tony + Assignees: Rajendra Adhikari, Anthony Fontanini .. change:: @@ -400,7 +400,7 @@ v3.2.0 Changelog Add ability to calculate simple utility bills based on a user-specified TSV file of utility rates Add optional simple_filepath yml argument for pointing to user-specified TSV file of utility rates. The TSV file can contain utility rates mapped by State, or any other parameter. - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -416,7 +416,7 @@ v3.2.0 Changelog Update characteristics to use EIA 2020 RECS Transitioning characteristics to use the EIA's 2020 RECS survey final characteristics. - Assignees: Tony + Assignees: Anthony Fontanini .. change:: @@ -432,7 +432,7 @@ v3.2.0 Changelog Add 2022 Cambium emissions data Cambium 2022 data is out. This issue is to update to the 2022 data. - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -446,10 +446,9 @@ v3.2.0 Changelog Description: Add Energystar Climate Zone for window upgrade specification - Add Energystar Climate Zone for window upgrade specification resstock-estimation: `pull request 369 `_ - Assignees: Lixi + Assignees: Lixi Liu diff --git a/docs/read_the_docs/source/changelog/changelog_dev.rst b/docs/read_the_docs/source/changelog/changelog_dev.rst index 770692aa7d..c77da2aae1 100644 --- a/docs/read_the_docs/source/changelog/changelog_dev.rst +++ b/docs/read_the_docs/source/changelog/changelog_dev.rst @@ -6,6 +6,89 @@ Development Changelog :version: v3.3.0 :released: pending + .. change:: + :tags: workflow, plug loads, feature + :pullreq: 1213 + + **Date**: 2024-05-21 + + Title: + Split out Other and TV plug loads + + Description: + Split out TV plug loads (calculated using an equation based on ANSI/RESNET/ICC 301) from other plug loads (calculated using updated regression equations based on RECS2020) + For TV, we are now using OS-HPXML defaults (i.e., TV = 413.0 + 69.0 * NumberofBedrooms based on ANSI/RESNET/ICC 301-2019, where NumberofBedrooms is adjusted based on NumberofResidents). + Create a new sources/recs/recs2020/plug_loads/mel_ann.py script. + + resstock-estimation: `pull request 401 `_ + + Assignees: Joe Robertson, Anthony Fontanini + + + .. change:: + :tags: workflow, mechanics, feature + :pullreq: 1230 + + **Date**: 2024-05-16 + + Title: + Run run_analysis in parallel + + Description: + Introduce a new optional `buildstock_csv_path` argument that supports parallel resstock runs using `run_analysis.rb` + I know this is an odd workflow, but I'd like to call resstock in parallel, to run multiple models (baseline only) built each with a precomputed buildstock.csv + + Assignees: Julien Marrec + + + .. change:: + :tags: workflow, reporting, feature + :pullreq: 1240 + + **Date**: 2024-05-16 + + Title: + Latest OS-HPXML + + Description: + Improves heating/cooling component loads; for timesteps where there is no heating/cooling load, assigns heat transfer to heating or cooling by comparing indoor temperature to the average of heating/cooling setpoints + Improves heating/cooling component loads; for timesteps where there is no heating/cooling load, assigns heat transfer to heating or cooling by comparing indoor temperature to the average of heating/cooling setpoints. + + Assignees: Andrew Speake + + + .. change:: + :tags: workflow, reporting, feature + :pullreq: 1240 + + **Date**: 2024-05-16 + + Title: + Latest OS-HPXML + + Description: + Additional geothermal loop default simulation outputs (number/length of boreholes) + Adds geothermal loop outputs (number/length of boreholes) to annual results output file. + + Assignees: Scott Horowitz + + + .. change:: + :tags: workflow, infiltration, feature + :pullreq: 1240 + + **Date**: 2024-05-16 + + Title: + Latest OS-HPXML + + Description: + Updates default `ShieldingofHome` to be "well-shielded" (from "normal") for single-family attached and multifamily dwelling units + Updates default ShieldingofHome to be "well-shielded" for single-family attached and multifamily dwelling units. + + Assignees: Scott Horowitz + + .. change:: :tags: software, openstudio, feature :pullreq: 1225 @@ -17,9 +100,8 @@ Development Changelog Description: Update to OpenStudio v3.8.0 - OpenStudio 3.8/EnergyPlus 24.1 - Assignees: Joe, Scott + Assignees: Joe Robertson, Scott Horowitz .. change:: @@ -37,7 +119,7 @@ Development Changelog OpenStudio-HPXML: `pull request 1691 `_ - Assignees: Scott + Assignees: Scott Horowitz .. change:: @@ -55,7 +137,7 @@ Development Changelog OpenStudio-HPXML: `pull request 1584 `_ - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -73,7 +155,7 @@ Development Changelog resstock-estimation: `pull request 406 `_ - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -93,7 +175,7 @@ Development Changelog OpenStudio-HPXML: `pull request 1634 `_ - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -111,7 +193,7 @@ Development Changelog resstock-estimation: `pull request 381 `_ - Assignees: Rajendra, Tony + Assignees: Rajendra Adhikari, Anthony Fontanini .. change:: @@ -129,7 +211,7 @@ Development Changelog OpenStudio-HPXML: `pull request 1611 `_ - Assignees: Joe, Yueyue + Assignees: Joe Robertson, Yueyue Zhou .. change:: @@ -147,7 +229,7 @@ Development Changelog OpenStudio-HPXML: `pull request 1636 `_ - Assignees: Scott + Assignees: Scott Horowitz .. change:: @@ -165,7 +247,7 @@ Development Changelog resstock-estimation: `pull request 400 `_ - Assignees: Lixi + Assignees: Lixi Liu .. change:: @@ -181,7 +263,7 @@ Development Changelog Move location of out-of-unit (shared) water heaters to conditioned mechanical room Move out-of-unit water heaters (i.e., Water Heater In Unit=No from Location=None to Location=Conditioned Mechanical Room (corresponds to OS-HPXML location: "other heated space"). - Assignees: Lixi, Jeff, Tony + Assignees: Lixi Liu, Jeff Maguire, Anthony Fontanini .. change:: @@ -199,7 +281,7 @@ Development Changelog OpenStudio-HPXML: `pull request 1622 `_ - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -217,7 +299,7 @@ Development Changelog OpenStudio-HPXML: `pull request 1597 `_ - Assignees: Scott + Assignees: Scott Horowitz .. change:: @@ -235,7 +317,7 @@ Development Changelog OpenStudio-HPXML: `pull request 1572 `_ - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -253,7 +335,7 @@ Development Changelog OpenStudio-HPXML: `pull request 1572 `_ - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -271,7 +353,7 @@ Development Changelog OpenStudio-HPXML: `pull request 1609 `_ - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -289,7 +371,7 @@ Development Changelog resstock-estimation: `pull request 361 `_ - Assignees: Jeff, Tony + Assignees: Jeff Maguire, Anthony Fontanini .. change:: @@ -305,7 +387,7 @@ Development Changelog Add optional switch to BuildExistingModel (defaulted to false) for modeling whole SFA/MF buildings Replaces building_id=ALL argument with an element in the HPXML file, which allows us to perform validation specific to whole MF building simulations - Assignees: Joe, Scott + Assignees: Joe Robertson, Scott Horowitz .. change:: @@ -323,7 +405,7 @@ Development Changelog resstock-estimation: `pull request 394 `_ - Assignees: Tony + Assignees: Anthony Fontanini .. change:: @@ -339,7 +421,7 @@ Development Changelog Reorganize the emissions and utility rates data folders such that their sources and functions are more clear Previously, it wasn't clear that the provided utility rate data was for demonstration purposes only. - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -355,7 +437,7 @@ Development Changelog Include additional 2022 Cambium 25-year LRMER emissions data Add 10 new "LRMER_xxx_25" data folders to resources/data/cambium/2022. - Assignees: Joe + Assignees: Joe Robertson .. change:: @@ -373,7 +455,7 @@ Development Changelog OpenStudio-HPXML: `pull request 1473 `_ - Assignees: Prateek + Assignees: Prateek Shrestha .. change:: @@ -395,7 +477,7 @@ Development Changelog OpenStudio-HPXML: `pull request 1583 `_, `pull request 1317 `_, `pull request 1558 `_ - Assignees: Yueyue, Scott, Joe + Assignees: Yueyue Zhou, Scott Horowitz, Joe Robertson .. change:: @@ -411,89 +493,6 @@ Development Changelog Remove old HPWH options from options_lookup Removing the old HPWH options from options_lookup.tsv - Assignees: Jeff - - - .. change:: - :tags: workflow, mechanics, feature - :pullreq: 1230 - - **Date**: 2024-05-16 - - Title: - Run run_analysis in parallel - - Description: - Introduce a new optional `buildstock_csv_path` argument that supports parallel resstock runs using `run_analysis.rb` - I know this is an odd workflow, but I'd like to call resstock in parallel, to run multiple models (baseline only) built each with a precomputed buildstock.csv - - Assignees: Julien - - - .. change:: - :tags: workflow, reporting, feature - :pullreq: 1240 - - **Date**: 2024-05-16 - - Title: - Latest OS-HPXML - - Description: - Improves heating/cooling component loads; for timesteps where there is no heating/cooling load, assigns heat transfer to heating or cooling by comparing indoor temperature to the average of heating/cooling setpoints - Improves heating/cooling component loads; for timesteps where there is no heating/cooling load, assigns heat transfer to heating or cooling by comparing indoor temperature to the average of heating/cooling setpoints. - - Assignees: Andrew - - - .. change:: - :tags: workflow, reporting, feature - :pullreq: 1240 - - **Date**: 2024-05-16 - - Title: - Latest OS-HPXML - - Description: - Additional geothermal loop default simulation outputs (number/length of boreholes) - Adds geothermal loop outputs (number/length of boreholes) to annual results output file. - - Assignees: Scott - - - .. change:: - :tags: workflow, infiltration, feature - :pullreq: 1240 - - **Date**: 2024-05-16 - - Title: - Latest OS-HPXML - - Description: - Updates default `ShieldingofHome` to be "well-shielded" (from "normal") for single-family attached and multifamily dwelling units - Updates default ShieldingofHome to be "well-shielded" for single-family attached and multifamily dwelling units. - - Assignees: Scott - - - .. change:: - :tags: workflow, plug loads, feature - :pullreq: 1213 - - **Date**: 2024-05-21 - - Title: - Split out Other and TV plug loads - - Description: - Split out TV plug loads (calculated using an equation based on ANSI/RESNET/ICC 301) from other plug loads (calculated using updated regression equations based on RECS2020) - For TV, we are now using OS-HPXML defaults (i.e., TV = 413.0 + 69.0 * NumberofBedrooms based on ANSI/RESNET/ICC 301-2019, where NumberofBedrooms is adjusted based on NumberofResidents). - Create a new sources/recs/recs2020/plug_loads/mel_ann.py script. - - resstock-estimation: `pull request 401 `_ - - Assignees: Joe, Tony + Assignees: Jeff Maguire From cfabc9ba078bdcc0dc721b9754e7d183b3170c88 Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Wed, 22 May 2024 14:44:53 -0700 Subject: [PATCH 14/21] Fix typo in 2_5_0 changelog. --- docs/read_the_docs/source/changelog/changelog_2_5_0.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/read_the_docs/source/changelog/changelog_2_5_0.rst b/docs/read_the_docs/source/changelog/changelog_2_5_0.rst index deb6204f4c..3d9a9816f6 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_5_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_5_0.rst @@ -110,7 +110,7 @@ v2.5.0 Changelog **Date**: 2021-11-17 Title: - add geometry_story_bin, add story_bin as dependency to geometry_wall_… + add geometry_story_bin, add story_bin as dependency to geometry_wall_type Description: Add Geometry Story Bin tsv and Geometry Story Bin dependency to Geometry Wall Type @@ -130,7 +130,7 @@ v2.5.0 Changelog **Date**: 2021-11-17 Title: - add geometry_story_bin, add story_bin as dependency to geometry_wall_… + add geometry_story_bin, add story_bin as dependency to geometry_wall_type Description: Revert wall type constraint that assumes all brick facades built >1960 are wood-framed with 4" face brick. Also add constraint to force all buildings > 8 stories to have steel-framed wall type From dc8370c84254abf206bcbcfbaa92d2b27dd32364 Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Wed, 22 May 2024 16:23:14 -0700 Subject: [PATCH 15/21] Minor update to dev changelog. --- docs/read_the_docs/source/changelog/changelog_dev.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/read_the_docs/source/changelog/changelog_dev.rst b/docs/read_the_docs/source/changelog/changelog_dev.rst index c77da2aae1..e0c1843676 100644 --- a/docs/read_the_docs/source/changelog/changelog_dev.rst +++ b/docs/read_the_docs/source/changelog/changelog_dev.rst @@ -132,7 +132,7 @@ Development Changelog HVAC Autosizing Limits Description: - HVAC + Sizing control option to specify max allowed airflow The PR aims to allow specifying upper limits for autosized capacities. OpenStudio-HPXML: `pull request 1584 `_ From 2a255cb0996dfaa051fa12ea4d553de31d7a3d2f Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Thu, 23 May 2024 10:38:28 -0700 Subject: [PATCH 16/21] Add issues to dev changelog, misc cleanup. --- .github/pull_request_template.md | 2 +- .../source/changelog/changelog_dev.rst | 29 +++++++++++++------ docs/read_the_docs/source/conf.py | 10 ++----- docs/read_the_docs/source/index.rst | 8 ++++- 4 files changed, 31 insertions(+), 18 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index b1db45441c..7088d3ae2e 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -9,6 +9,6 @@ Not all may apply: - [ ] Tests (and test files) have been updated - [ ] Documentation has been updated - [ ] If related to resstock-estimation, checklist includes [data dictionary](https://github.com/NREL/resstock/tree/develop/resources/data/dictionary), [source report](https://github.com/NREL/resstock/tree/develop/project_national/resources/source_report.csv), [options saturation](https://github.com/NREL/resstock/tree/develop/project_national/resources/options_saturations.csv), [options_lookup](https://github.com/NREL/resstock/blob/develop/resources/options_lookup.tsv). -- [ ] Add to the changelog_dev.rst file +- [ ] Add to the [changelog_dev.rst file](https://github.com/NREL/resstock/tree/develop/docs/read_the_docs/source/changelog/changelog_dev.rst) - [ ] `openstudio tasks.rb update_measures` has been run - [ ] No unexpected regression test changes on CI (checked comparison artifacts) diff --git a/docs/read_the_docs/source/changelog/changelog_dev.rst b/docs/read_the_docs/source/changelog/changelog_dev.rst index e0c1843676..167f0b6e41 100644 --- a/docs/read_the_docs/source/changelog/changelog_dev.rst +++ b/docs/read_the_docs/source/changelog/changelog_dev.rst @@ -9,6 +9,7 @@ Development Changelog .. change:: :tags: workflow, plug loads, feature :pullreq: 1213 + :tickets: 1206 **Date**: 2024-05-21 @@ -28,6 +29,7 @@ Development Changelog .. change:: :tags: workflow, mechanics, feature :pullreq: 1230 + :tickets: 1130 **Date**: 2024-05-16 @@ -70,6 +72,8 @@ Development Changelog Additional geothermal loop default simulation outputs (number/length of boreholes) Adds geothermal loop outputs (number/length of boreholes) to annual results output file. + OpenStudio-HPXML: `#1657 `_ + Assignees: Scott Horowitz @@ -101,6 +105,8 @@ Development Changelog Description: Update to OpenStudio v3.8.0 + OpenStudio-HPXML: `pull request 1630 `_ + Assignees: Joe Robertson, Scott Horowitz @@ -117,7 +123,7 @@ Development Changelog Update to new OS-HPXML defaults for duct insulation; 25% rectangular supply ducts and 100% rectangular return ducts (previously 100% round supply/return ducts) Adds optional inputs (Ducts/DuctShape and Ducts/DuctFractionRectangular); defaults to 25% rectangular supply ducts and 100% rectangular return ducts (previously 100% round supply/return ducts). - OpenStudio-HPXML: `pull request 1691 `_ + OpenStudio-HPXML: `#1470 `_, `pull request 1691 `_ Assignees: Scott Horowitz @@ -135,13 +141,13 @@ Development Changelog Sizing control option to specify max allowed airflow The PR aims to allow specifying upper limits for autosized capacities. - OpenStudio-HPXML: `pull request 1584 `_ + OpenStudio-HPXML: `#1530 `_, `#1556 `_, `pull request 1584 `_ Assignees: Joe Robertson .. change:: - :tags: workflow, hvac, bugfix + :tags: workflow, hvac, feature :pullreq: 1218 **Date**: 2024-04-09 @@ -155,6 +161,8 @@ Development Changelog resstock-estimation: `pull request 406 `_ + OpenStudio-HPXML: `#1561 `_ + Assignees: Joe Robertson @@ -197,7 +205,7 @@ Development Changelog .. change:: - :tags: workflow, hvac, feature + :tags: workflow, hvac, bugfix :pullreq: 1215 **Date**: 2024-03-11 @@ -209,7 +217,7 @@ Development Changelog Add ability to specify HVAC system autosizing factors for baseline buildings; autosizing factors are retained for upgrade buildings following the same approach for HVAC system capacities Allows optional HeatingAutosizingFactor, CoolingAutosizingFactor, BackupHeatingAutosizingFactor inputs to scale HVAC equipment autosizing results. - OpenStudio-HPXML: `pull request 1611 `_ + OpenStudio-HPXML: `#1561 `_, `pull request 1611 `_ Assignees: Joe Robertson, Yueyue Zhou @@ -279,7 +287,7 @@ Development Changelog Allow definition of multiple unavailable periods (i.e., vacancy, power outage) Update schedules_vacancy_period and schedules_power_outage_period arguments to support multiple periods (comma-separated?). Argument schedules_power_outage_window_natvent_availability would then need to also be comma-separated? - OpenStudio-HPXML: `pull request 1622 `_ + OpenStudio-HPXML: `#1618 `_, `pull request 1622 `_ Assignees: Joe Robertson @@ -297,7 +305,7 @@ Development Changelog Add ability to set either an "emergency" or "supplemental" heat pump backup sizing methodology Adds a HeatPumpBackupSizingMethodology element with choices of 'emergency' and 'supplemental'. Defaults to 'emergency', so results do not change by default. - OpenStudio-HPXML: `pull request 1597 `_ + OpenStudio-HPXML: `#1322 `_, `pull request 1597 `_ Assignees: Scott Horowitz @@ -369,7 +377,7 @@ Development Changelog Update hot water usage multipliers based on field data rather than engineering judgement Update hot water usage multipliers. Using field data from 1700 water heaters in New England to come up with the distribution. Based on data collected as part of PERFORM with Michael Blonsky, who shared the distribution with us. - resstock-estimation: `pull request 361 `_ + resstock-estimation: `#289 `_, `pull request 361 `_ Assignees: Jeff Maguire, Anthony Fontanini @@ -387,6 +395,8 @@ Development Changelog Add optional switch to BuildExistingModel (defaulted to false) for modeling whole SFA/MF buildings Replaces building_id=ALL argument with an element in the HPXML file, which allows us to perform validation specific to whole MF building simulations + OpenStudio-HPXML: `pull request 1594 `_ + Assignees: Joe Robertson, Scott Horowitz @@ -453,7 +463,7 @@ Development Changelog Add flexibility to specify location of the radiant barrier Allowing Radiant Barrier for Attic Floor - OpenStudio-HPXML: `pull request 1473 `_ + OpenStudio-HPXML: `#1435 `_, `pull request 1473 `_ Assignees: Prateek Shrestha @@ -483,6 +493,7 @@ Development Changelog .. change:: :tags: workflow, water heater, bugfix :pullreq: 1190 + :tickets: 1184 **Date**: 2024-01-12 diff --git a/docs/read_the_docs/source/conf.py b/docs/read_the_docs/source/conf.py index 27d1cc123c..8af61d694c 100644 --- a/docs/read_the_docs/source/conf.py +++ b/docs/read_the_docs/source/conf.py @@ -42,18 +42,14 @@ "changelog" ] -changelog_sections = [ - "workflow", - "characteristics", - "software", - "documentation" -] +# tags to sort sections +changelog_sections = ["workflow", "characteristics", "software", "documentation"] + # tags to sort on inside of sections changelog_inner_tag_sort = ["feature", "changed", "removed", "bug", "moved"] # how to render changelog links changelog_render_ticket = "http://www.github.com/nrel/resstock/issues/%s" - changelog_render_pullreq = {"default": "https://www.github.com/nrel/resstock/pull/%s"} # Add any paths that contain templates here, relative to this directory. diff --git a/docs/read_the_docs/source/index.rst b/docs/read_the_docs/source/index.rst index 6cbeac69cb..bc66eef2a9 100644 --- a/docs/read_the_docs/source/index.rst +++ b/docs/read_the_docs/source/index.rst @@ -30,6 +30,12 @@ Updates & Changelog .. toctree:: :maxdepth: 2 - :caption: Changes + :caption: Changes: changelog/index + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`search` From 7eaa64e45e692398269ac290979562744b6d7808 Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Tue, 4 Jun 2024 12:08:46 -0700 Subject: [PATCH 17/21] Add changelog entry and apply rubocop. --- .../source/changelog/changelog_dev.rst | 17 ++++- .../create_characteristics_rst.rb | 66 +++++++++---------- 2 files changed, 49 insertions(+), 34 deletions(-) diff --git a/docs/read_the_docs/source/changelog/changelog_dev.rst b/docs/read_the_docs/source/changelog/changelog_dev.rst index 167f0b6e41..c7ee7553f9 100644 --- a/docs/read_the_docs/source/changelog/changelog_dev.rst +++ b/docs/read_the_docs/source/changelog/changelog_dev.rst @@ -6,6 +6,22 @@ Development Changelog :version: v3.3.0 :released: pending + .. change:: + :tags: documentation, options_lookup, feature + :pullreq: 1249 + + **Date**: 2024-06-04 + + Title: + Adding options and option arguments to Read the Docs + + Description: + Adding to the read the docs documentation by articulating the options in project national and the arguments specified. One can now look at the descriptions of the arguments and documentation linked to OS-HPXML and see what arguments are currently being used in the baseline stock. + The updates combines two files automatically: "options_lookup.tsv" and the "project_national/resuources/options_saturations.csv". + + Assignees: Anthony Fontanini + + .. change:: :tags: workflow, plug loads, feature :pullreq: 1213 @@ -53,7 +69,6 @@ Development Changelog Latest OS-HPXML Description: - Improves heating/cooling component loads; for timesteps where there is no heating/cooling load, assigns heat transfer to heating or cooling by comparing indoor temperature to the average of heating/cooling setpoints Improves heating/cooling component loads; for timesteps where there is no heating/cooling load, assigns heat transfer to heating or cooling by comparing indoor temperature to the average of heating/cooling setpoints. Assignees: Andrew Speake diff --git a/docs/read_the_docs/source/workflow_inputs/create_characteristics_rst.rb b/docs/read_the_docs/source/workflow_inputs/create_characteristics_rst.rb index 7f59caa704..0456446f88 100644 --- a/docs/read_the_docs/source/workflow_inputs/create_characteristics_rst.rb +++ b/docs/read_the_docs/source/workflow_inputs/create_characteristics_rst.rb @@ -134,7 +134,7 @@ def get_measure_xml(filepath) lookup_file = File.join(resources_dir, 'options_lookup.tsv') option_sat_file = File.join('project_national', 'resources', 'options_saturations.csv') lookup_csv_data = CSV.open(lookup_file, col_sep: "\t").each.to_a -option_sat_csv_data = CSV.open(option_sat_file,quote_char: '"', col_sep: ",").each.to_a +option_sat_csv_data = CSV.open(option_sat_file, quote_char: '"', col_sep: ',').each.to_a source_report = CSV.read(File.join(File.dirname(__FILE__), '../../../../project_national/resources/source_report.csv'), headers: true) source_report.each do |row| @@ -203,7 +203,7 @@ def get_measure_xml(filepath) f.puts(name) f.puts('*' * name.size) f.puts - f.puts("From ``project_national`` the list of options, option stock sturation, and option arguments for the **#{parameter}** characteristic." ) + f.puts("From ``project_national`` the list of options, option stock sturation, and option arguments for the **#{parameter}** characteristic.") f.puts f.puts('.. list-table::') f.puts(' :header-rows: 1') @@ -225,47 +225,47 @@ def get_measure_xml(filepath) option_sat_csv_data.each do |param_option_row| # If the parameter does not match next next if param_option_row[1] != parameter - + # Insert the options and the stock saturation option = param_option_row[2] f.puts(" * - #{option}") - sat_percent = Float(param_option_row[3])*100.0 + sat_percent = Float(param_option_row[3]) * 100.0 if Integer(sat_percent.truncate()) == 100 - f.puts(" - %.3g%%" % [sat_percent]) + f.puts(' - %.3g%%' % [sat_percent]) else - f.puts(" - %.2g%%" % [sat_percent]) + f.puts(' - %.2g%%' % [sat_percent]) end # Check if there are arguments - if !r_arguments.empty? - # If there are arguments, go through options lookup to find the option - lookup_csv_data.each do |lookup_row| - next if lookup_row[0] != parameter - next if lookup_row[1] != option - - # When the option is found - if lookup_row[2] != 'ResStockArguments' - # Put all blank rows if there is no arguments - for a in 1..r_arguments.length() do - f.puts(" - ") - end - else - # If option specifies arguments, insert arguments according to the order of r_arguements - r_arguments.each do |argument| - # Look for each argument in r_arguments - found_arg = false - lookup_row[3..-1].each do |argument_value| - arg, value = argument_value.split('=') - if argument == arg - found_arg=true - f.puts(" - #{value}") - end - end - # if the argument is not found (a not specified optional argument) - if !found_arg - f.puts(" - ") + next unless !r_arguments.empty? + + # If there are arguments, go through options lookup to find the option + lookup_csv_data.each do |lookup_row| + next if lookup_row[0] != parameter + next if lookup_row[1] != option + + # When the option is found + if lookup_row[2] != 'ResStockArguments' + # Put all blank rows if there is no arguments + for a in 1..r_arguments.length() do + f.puts(' - ') + end + else + # If option specifies arguments, insert arguments according to the order of r_arguements + r_arguments.each do |argument| + # Look for each argument in r_arguments + found_arg = false + lookup_row[3..-1].each do |argument_value| + arg, value = argument_value.split('=') + if argument == arg + found_arg = true + f.puts(" - #{value}") end end + # if the argument is not found (a not specified optional argument) + if !found_arg + f.puts(' - ') + end end end end From dc9b2548a37681d85c249c346ed4d51efa75cba5 Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Wed, 5 Jun 2024 14:49:27 -0700 Subject: [PATCH 18/21] Minor lint. --- .../source/workflow_inputs/create_characteristics_rst.rb | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/read_the_docs/source/workflow_inputs/create_characteristics_rst.rb b/docs/read_the_docs/source/workflow_inputs/create_characteristics_rst.rb index 0456446f88..f31d102c08 100644 --- a/docs/read_the_docs/source/workflow_inputs/create_characteristics_rst.rb +++ b/docs/read_the_docs/source/workflow_inputs/create_characteristics_rst.rb @@ -247,7 +247,7 @@ def get_measure_xml(filepath) # When the option is found if lookup_row[2] != 'ResStockArguments' # Put all blank rows if there is no arguments - for a in 1..r_arguments.length() do + for _a in 1..r_arguments.length() do f.puts(' - ') end else From 6a9f13967b22450dcb8c95ff0bbe2e6e10ed1e4c Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Wed, 5 Jun 2024 14:49:50 -0700 Subject: [PATCH 19/21] Remove the old CHANGELOG.md. --- CHANGELOG.md | 383 --------------------------------------------------- 1 file changed, 383 deletions(-) delete mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md deleted file mode 100644 index 220740bf01..0000000000 --- a/CHANGELOG.md +++ /dev/null @@ -1,383 +0,0 @@ -## ResStock v3.3.0 (pending) - -Features -- Updates and enhancements to the ground source heat pump model; ability to describe detailed geothermal loop inputs ([#1187](https://github.com/NREL/resstock/pull/1187)) -- Add flexibility to specify location of the radiant barrier ([#1188](https://github.com/NREL/resstock/pull/1188)) -- Add ability to describe detailed performance data for variable-speed air-source HVAC systems ([#1188](https://github.com/NREL/resstock/pull/1188), [#1200](https://github.com/NREL/resstock/pull/1200)) -- Include additional 2022 Cambium 25-year LRMER emissions data ([#1194](https://github.com/NREL/resstock/pull/1194)) -- Add optional switch to BuildExistingModel (defaulted to false) for modeling whole SFA/MF buildings ([#1200](https://github.com/NREL/resstock/pull/1200)) -- Update hot water usage multipliers based on field data rather than engineering judgement ([#1210](https://github.com/NREL/resstock/pull/1210)) -- Allow definition of multiple unavailable periods (i.e., vacancy, power outage) ([#1209](https://github.com/NREL/resstock/pull/1209)) -- Add ability to set either an "emergency" or "supplemental" heat pump backup sizing methodology ([#1209](https://github.com/NREL/resstock/pull/1209)) -- Refrigerator energy use is now affected by its ambient temperature using hourly constant and temperature coefficients from ANSI/RESNET/ICC 301-2022 Addendum C ([#1209](https://github.com/NREL/resstock/pull/1209)) -- Add Metropolitan and Micropolitan Statistical Area tsv, County Metro Status tsv, and State Metro Median Income tsv ([#1212](https://github.com/NREL/resstock/pull/1212)) -- Add ability to specify HVAC system autosizing factors for baseline buildings; autosizing factors are retained for upgrade buildings following the same approach for HVAC system capacities ([#1215](https://github.com/NREL/resstock/pull/1215)) -- Update the stochastic schedule generator to produce updated other/TV plug load and ceiling fan schedules ([#1220](https://github.com/NREL/resstock/pull/1220)) -- Update to new OS-HPXML defaults for duct insulation; 25% rectangular supply ducts and 100% rectangular return ducts (previously 100% round supply/return ducts) ([#1233](https://github.com/NREL/resstock/pull/1233)) -- Update to OpenStudio v3.8.0 ([#1225](https://github.com/NREL/resstock/pull/1225)) -- Introduce a new optional `buildstock_csv_path` argument that supports parallel resstock runs using `run_analysis.rb` ([#1230](https://github.com/NREL/resstock/pull/1230)) -- Improves heating/cooling component loads; for timesteps where there is no heating/cooling load, assigns heat transfer to heating or cooling by comparing indoor temperature to the average of heating/cooling setpoints ([#1240](https://github.com/NREL/resstock/pull/1240)) -- Additional geothermal loop default simulation outputs (number/length of boreholes) ([#1240](https://github.com/NREL/resstock/pull/1240)) -- Updates default `ShieldingofHome` to be "well-shielded" (from "normal") for single-family attached and multifamily dwelling units ([#1240](https://github.com/NREL/resstock/pull/1240)) -- Split out TV plug loads (calculated using an equation based on ANSI/RESNET/ICC 301) from other plug loads (calculated using updated regression equations based on RECS2020) ([#1213](https://github.com/NREL/resstock/pull/1213)) -- Add options and option arguments to read-the-docs ([#1249](https://github.com/NREL/resstock/pull/1249)) - -Fixes -- Remove old HPWH options from options_lookup ([#1190](https://github.com/NREL/resstock/pull/1190)) -- Reorganize the emissions and utility rates data folders such that their sources and functions are more clear ([#1195](https://github.com/NREL/resstock/pull/1195)) -- Move location of out-of-unit (shared) water heaters to conditioned mechanical room ([#1201](https://github.com/NREL/resstock/pull/1201)) -- Update the Alaska residential stock characterization using the Alaska Retrofit Information System data ([#1214](https://github.com/NREL/resstock/pull/1214)) -- Enable HVAC airflow and capacity scaling factors to oversize or undersize the equipment ([#1218](https://github.com/NREL/resstock/pull/1218)) -- Update to RECS 2020 V7 data files ([#1164](https://github.com/NREL/resstock/pull/1199)) - -## ResStock v3.2.0 -###### December 19, 2023 - [Diff](https://github.com/NREL/resstock/compare/v3.1.1...v3.2.0) - -Features -- Add ability to calculate simple utility bills based on a user-specified TSV file of utility rates ([#1012](https://github.com/NREL/resstock/pull/1012)) -- Add 2022 Cambium emissions data ([#1038](https://github.com/NREL/resstock/pull/1038)) -- Update characteristics to use EIA 2020 RECS ([#1031](https://github.com/NREL/resstock/pull/1031)) -- Add Energystar Climate Zone for window upgrade specification ([#1080](https://github.com/NREL/resstock/pull/1080)) -- Include HVAC secondary heating capabilities for project_testing ([#1093](https://github.com/NREL/resstock/pull/1093)) -- For heat pump upgrades, adds the ability to set the existing primary (non-shared) heating system as the backup system using only a single option from the lookup ([#1074](https://github.com/NREL/resstock/pull/1074)) -- options_saturations.csv is added to project_*/resources/ folder ([#1132](https://github.com/NREL/resstock/pull/1132)) -- Update `run_analysis.rb` to map datapoints to run folder names when the `-k` argument is supplied ([#1138](https://github.com/NREL/resstock/pull/1138)) -- Add Water Heater Location and Geometry Space Combination, update Geometry Garage and Geometry Floor Area Bin to RECS2020, update RECS2020 microdata from v2 to v4, auto-generate buildstocks for yml_precomputed tests ([#1125](https://github.com/NREL/resstock/pull/1125)) -- Add ability to request timeseries resilience output from the yml file ([#1113](https://github.com/NREL/resstock/pull/1113)) -- Add ability to calculate detailed utility bills based on a user-specified TSV file of paths to JSON utility rate tariff files ([#1109](https://github.com/NREL/resstock/pull/1109)) -- Update to OpenStudio v3.7.0 ([#1144](https://github.com/NREL/resstock/pull/1144)) -- Automate creation of new "Arguments" documentation sections for summarizing arguments (and their default values) in options_lookup.tsv ([#1146](https://github.com/NREL/resstock/pull/1146)) -- Add variability in ground thermal conductivity ([#1165](https://github.com/NREL/resstock/pull/1165)) - -Fixes -- Set standard format for options_lookup ([#962](https://github.com/NREL/resstock/pull/962)) -- Model a wood storage water heater when "Other Fuel" is sampled from Water Heater Efficiency.tsv (allowing downstream modeling of clothes washer/dryer). Similarly, model a wood wall/floor furnace when "Other" is sampled from HVAC Heating Efficiency.tsv ([#947](https://github.com/NREL/resstock/pull/947)) -- Update ResStockArguments to support nonzero fraction of heat load served by the secondary heating system ([#1093](https://github.com/NREL/resstock/pull/1093)) -- Fix square footage for a MF dwelling unit in the "3000-3999" CFA bin (from 33171 to 3171) ([#1115](https://github.com/NREL/resstock/pull/1115)) -- Fix/clarify duct location assignment by defining Duct Location.tsv, making Duct Leakage and Insulation (formerly Duct) depend on Duct Location, and making HVAC Has Ducts depend on HVAC Has Shared Systems. Includes fixes on standalone and shared heating system assignment for Other Fuel. ([#1104](https://github.com/NREL/resstock/pull/1104), [#1112](https://github.com/NREL/resstock/pull/1112)) -- Correct refrigerator rated annual kWh based on EF and an assumed volume of 20.9cft. ([#1118](https://github.com/NREL/resstock/pull/1118)) -- Minor changes to heating and cooling setpoint TSV due to refactoring of prune_rules handling in resstock-estimation ([#1132](https://github.com/NREL/resstock/pull/1132)) -- Minor changes to heating and cooling setpoint TSV after a bug fix ([#1136](https://github.com/NREL/resstock/pull/1136)) -- Update `run_analysis.rb` to handle illegal path characters in upgrade names ([#1138](https://github.com/NREL/resstock/pull/1138)) -- Update to RECS 2020 V5 data files ([#1164](https://github.com/NREL/resstock/pull/1164)) -- Update TMY3 weather URL from the NREL Data Catalog ([#1182](https://github.com/NREL/resstock/pull/1182)) - -## ResStock v3.1.1 -###### November 28, 2023 - [Diff](https://github.com/NREL/resstock/compare/v3.1.0...v3.1.1) - -Fixes -- Use `Gem::Version` on buildstockbatch version string comparisons so that, e.g., '2023.10.0' < '2023.5.0' does not evaluate to true ([#1170](https://github.com/NREL/resstock/pull/1170)) - -## ResStock v3.1.0 -###### May 25, 2023 - [Diff](https://github.com/NREL/resstock/compare/v3.0.0...v3.1.0) - -Features -- Include battery modeling capabilities for project_testing ([#1009](https://github.com/NREL/resstock/pull/1009)) -- Ability to check buildstock csv against an options lookup as a command line utility ([#1042](https://github.com/NREL/resstock/pull/1042)) -- Demonstrate new power outage modeling feature using upgrades specified in example project yml files ([#1054](https://github.com/NREL/resstock/pull/1054)) -- Ability to specify a "sample_weight" column in the precomputed buildstock.csv ([#1056](https://github.com/NREL/resstock/pull/1056)) -- Add descriptions to the housing characteristics ([#1069](https://github.com/NREL/resstock/pull/1069)) -- Connect ASHP to optional capacity retention temperature and fraction arguments (that already exist for MSHP) ([#1071](https://github.com/NREL/resstock/pull/1071)) -- Add data dictionary files for describing various outputs. Use these files to (1) check against integration test results, and (2) generate documentation tables ([#1058](https://github.com/NREL/resstock/pull/1058)) -- OS-HPXML now supports use of optional heat pump capacity retention temperature and fraction arguments (applicable to both ASHP and MSHP) ([#1072](https://github.com/NREL/resstock/pull/1072)) -- Update to OpenStudio v3.6.1 ([#1076](https://github.com/NREL/resstock/pull/1076)) - -Fixes -- Pulls in upstream OS-HPXML fix related to [avoiding possible OpenStudio temporary directory collision](https://github.com/NREL/OpenStudio-HPXML/pull/1316) causing random errors ([#1054](https://github.com/NREL/resstock/pull/1054)) -- Pulls in upstream OS-HPXML fix related to [falling back to a WWR calculation when window placement fails](https://github.com/NREL/OpenStudio-HPXML/pull/1385) causing errors fitting windows ([#1076](https://github.com/NREL/resstock/pull/1076)) - -## ResStock v3.0.0 -###### February 3, 2023 - [Diff](https://github.com/NREL/resstock/compare/v2.5.0...v3.0.0) - -Features -- Transition to using the HPXML-based workflow ([#443](https://github.com/NREL/resstock/pull/443)) -- Add a new "Floor Area, Foundation (ft^2)" cost multiplier ([#870](https://github.com/NREL/resstock/pull/870)) -- Add a new "Floor Area, Attic * Insulation Increase (ft^2 * Delta R-value)" cost multiplier for handling incremental costs of adding attic insulation ([#842](https://github.com/NREL/resstock/pull/842)) -- Allow air leakage % reduction upgrades (e.g., 25%), and add a new "Floor Area, Conditioned * Infiltration Reduction (ft^2 * Delta ACH50)" cost multiplier for handling incremental costs of such upgrades ([#840](https://github.com/NREL/resstock/pull/840)) -- For the testing project, sample equal distributions of (1) smooth and stochastic schedules (each 50%) and (2) faulted and non-faulted HVAC systems (each 50%) ([#828](https://github.com/NREL/resstock/pull/828)) -- Allow upgrade options to be defined in the lookup using measures other than ResStockArguments ([#839](https://github.com/NREL/resstock/pull/839)) -- Enable rim joists for homes with basements/crawlspaces; assumes a height of 9.25 inches and calculates rim joist assembly R-value from new insulation arguments ([#831](https://github.com/NREL/resstock/pull/831)) -- Enable the HEScore workflow to be run with BuildExistingModel ([#782](https://github.com/NREL/resstock/pull/782)) -- Cities with more than 15,000 dwelling units are added as a geographic characteristic ([#874](https://github.com/NREL/resstock/pull/874)) -- Update tsvs with new sampling_probability calculation ([#905](https://github.com/NREL/resstock/pull/905)) -- Improve distributions of heat pumps in the southeast U.S. by spliting IECC zone 2A into two zones: 2A (FL, GA, AL, MS) and 2A (TX, LA) ([#913](https://github.com/NREL/resstock/pull/913)) -- Add Income and Tenure tsv, update PUMS tsvs from 2017 5-yrs to 2019 5-yrs, update dependencies and fix encoding error in Occupants.tsv ([#900](https://github.com/NREL/resstock/pull/900)) -- Add Income and Tenure into Geometry Floor Area ([#949](https://github.com/NREL/resstock/pull/949)) -- Add distributions for partial space cooling ([#964](https://github.com/NREL/resstock/pull/964)) -- Add ability to calculate emissions for various scenarios ([#791](https://github.com/NREL/resstock/pull/791)) -- Add ability to calculate simple utility bills for various scenarios ([#984](https://github.com/NREL/resstock/pull/984)) -- Modeled floor area based on AHS 2021 and AHS 2019 ([#978](https://github.com/NREL/resstock/pull/978)) -- Add area median income ([#1004](https://github.com/NREL/resstock/pull/1004)) -- Update to OpenStudio v3.5.1 ([#1006](https://github.com/NREL/resstock/pull/1015)) - -Fixes -- Clean up option names for natural ventilation and hot water distribution ([#828](https://github.com/NREL/resstock/pull/828)) -- Remove the zero degree switchover temperature for heat pump backup heating ([#833](https://github.com/NREL/resstock/pull/833)) -- For homes with a finished attic or cathedral ceilings, models a conditioned attic instead of a vented attic ([#830](https://github.com/NREL/resstock/pull/830)) -- Reduce housing characteristic file size by relaxing the six digit float format in the housing characteristics ([#877](https://github.com/NREL/resstock/pull/877)) -- Fix minor bug in sampling probability calculation ([#934](https://github.com/NREL/resstock/pull/934)) -- Rename sources subfolders so all tsv_makers can be imported as packages ([#959](https://github.com/NREL/resstock/pull/959)) -- Fix heating and cooling auto-season inputs ([#975](https://github.com/NREL/resstock/pull/975)) -- Remove Void from dependency columns in TSVs and update tests.([#981](https://github.com/NREL/resstock/pull/981)) -- Update low-sample downscaling logic to use raw source_weight, which leads to minor changes to Geometry Floor Area and HVAC Partial Space Conditioning ([#982](https://github.com/NREL/resstock/pull/982)) - -## ResStock v2.5.0 -###### February 9, 2022 - [Diff](https://github.com/NREL/OpenStudio-BuildStock/compare/v2.4.0...v2.5.0) - -Features -- Update to OpenStudio v3.3.0 ([#604](https://github.com/NREL/resstock/pull/604)) -- Model multifamily and single-family attached buildings as individual dwelling units instead of multiple units representing a building ([#439](https://github.com/NREL/resstock/pull/439)) -- Reduce vacant unit heating setpoints to 55ºF ([#541](https://github.com/NREL/resstock/pull/541)) -- Introduce a CEC Building Climate Zone tag for samples in California ([#548](https://github.com/NREL/resstock/pull/548)) -- Increase LED saturation to approximately 2019 levels ([#545](https://github.com/NREL/resstock/pull/545)) -- Introduce GEB capabilities for water heaters, including the ability to schedule setpoint and HPWH operating mode ([#483](https://github.com/NREL/resstock/pull/483)) -- Introduce different cooling setpoint distributions for window ACs ([#551](https://github.com/NREL/resstock/pull/551)) -- Include electric zonal heating equipment as a dependency in heating setpoint-related tsvs ([#549](https://github.com/NREL/resstock/pull/549)) -- Geo-temporal shifting of the stochastic load model schedules using the American Time Use Survey ([#550](https://github.com/NREL/resstock/pull/550)) -- Switch data source for `Geometry Wall Type.tsv` from RECS 2009 to Homeland Infrastructure Foundation-Level Data (HIFLD) Parcel data ([#561](https://github.com/NREL/resstock/pull/561)) -- Use Schedule:File with well pump / vehicle plug loads, as well as gas grill / fireplace / lighting fuel loads. This enables the optional vacancy period to apply to these end uses ([#566](https://github.com/NREL/resstock/pull/556)) -- Update example project yaml files to use buildstockbatch input schema version 0.3 ([#583](https://github.com/NREL/resstock/pull/583)) -- Update default daylight saving start and end dates to March 12 and November 5, respectively ([#585](https://github.com/NREL/resstock/pull/585)) -- Switches room air conditioner model to use Cutler performance curves ([#586](https://github.com/NREL/resstock/pull/586)) -- Remove 3 story limit for multi-family buildings, and instead use RECS data to allow for buildings up to 21 stories ([#558](https://github.com/NREL/resstock/pull/558)) -- Add a sampling probability column in the housing characteristics to define the probability a given column will be sampled ([#584](https://github.com/NREL/resstock/pull/584)) -- Add ReEDS balancing areas as a spatial field ([#591](https://github.com/NREL/resstock/pull/591)) -- Changes heat pump defrost control from OnDemand to Timed ([#605](https://github.com/NREL/resstock/pull/605)) -- Update number of bathrooms assumption to match the Building America House Simulation Protocols ([#601](https://github.com/NREL/resstock/pull/601)) -- Speed up sampling algorithm by multiple orders of magnitude for large numbers of samples ([#606](https://github.com/NREL/resstock/pull/606)) -- Use ANSI/RESNET/ICC 301 equations to calculate annual interior, exterior, and garage lighting energy ([#619](https://github.com/NREL/resstock/pull/619)) -- Update tsv files for both the national and testing projects. Supports transition to ResStock-HPXML ([#559](https://github.com/NREL/resstock/pull/559)) -- Changes "Duct Surface Area (ft^2)" cost multiplier to "Duct Unconditioned Surface Area (ft^2)" ([#634](https://github.com/NREL/resstock/pull/634)) -- Update window type distributions using RECS 2015. Includes additional of frame material types (RECS 2015) and presence of storm windows (D&R International) ([#615](https://github.com/NREL/resstock/pull/615)) -- Reduces window interior shading during Winter to match ANSI/RESNET/ICC 301 assumption ([#649](https://github.com/NREL/resstock/pull/649)) -- Updates ceiling fan model based on ANSI/RESNET ICC 301 assumptions ([#652](https://github.com/NREL/resstock/pull/652)) -- Updates infiltration model pressure coefficient ([#670](https://github.com/NREL/resstock/pull/670)) -- Updates mechanical ventilation options/model to ASHRAE 62.2-2019 and adds a "Flow Rate, Mechanical Ventilation (cfm)" output ([#675](https://github.com/NREL/resstock/pull/675)) -- Add PV ownership and PV system size distributions using 2019 Tracking the Sun and GTM report on solar installation. ([#673](https://github.com/NREL/resstock/pull/673)) -- Add optional argument to ResidentialLocation measure for setting the IECC climate zone ([#755](https://github.com/NREL/resstock/pull/764)) -- Add Geometry Story Bin tsv and Geometry Story Bin dependency to Geometry Wall Type. ([#759](https://github.com/NREL/resstock/pull/759)) -- Add arguments to the ServerDirectoryCleanup measure for controlling deletion of files in the run folder. ([#661](https://github.com/NREL/resstock/pull/661), [#818](https://github.com/NREL/resstock/pull/818)) - -Fixes -- Fixes significant runtime bottleneck in TSV fetching in BuildExistingModel & ApplyUpgrade measures ([#543](https://github.com/NREL/resstock/pull/543)) -- Dwelling units that are 0-499 ft2 are limited to a maximum of 2 bedrooms ([#553](https://github.com/NREL/resstock/pull/553)) -- Reverses the material layers of the unfinished attic floor construction so that they are correctly ordered outside-to-inside ([#556](https://github.com/NREL/resstock/pull/556)) -- Fixes invalid garage and living space dimension errors ([#560](https://github.com/NREL/resstock/pull/560)) -- Set all mini-split heat pump supplemental capacity to autosize ([#564](https://github.com/NREL/resstock/pull/564)) -- Reduce stochastic schedule generation runtime by over 50% ([#571](https://github.com/NREL/resstock/pull/571), [#577](https://github.com/NREL/resstock/pull/577)) -- Fixes the problem that `Heating Type=Void` is showing up in buildstock samples ([#568](https://github.com/NREL/resstock/pull/568)) -- Set AZ counties to NA daylight saving times instead of some AR counties ([#585](https://github.com/NREL/resstock/pull/585)) -- Housing characteristics fixes based on more samples in testing ([#592](https://github.com/NREL/resstock/pull/592)) -- Fixes window-to-wall ratio calculation for facades with doors ([#597](https://github.com/NREL/resstock/pull/597)) -- Fixes number of bathrooms for single-family attached and multi-family buildings ([#601](https://github.com/NREL/resstock/pull/601)) -- Sync the sample probabilities after a bug fix in tsv_dist ([#609](https://github.com/NREL/resstock/pull/609)) -- Fix name of ReEDS balancing areas ([#613](https://github.com/NREL/resstock/pull/613)) -- Fixes hot water distribution internal gains not being zeroed out during vacancies ([#653](https://github.com/NREL/resstock/pull/653)) -- Exclude adiabatic doors when outputting the door area cost multiplier ([#674](https://github.com/NREL/resstock/pull/674)) -- Disaggregate the shared fan coil's fan energy use into heating and cooling ([#694](https://github.com/NREL/resstock/pull/694)) -- Fixes hours setpoint not met output to exclude A) no heating and/or cooling equipment and B) finished basements ([#700](https://github.com/NREL/resstock/pull/700)) -- Revert wall type constraint that assumes all brick facades built >1960 are wood-framed with 4" face brick. Also add constraint to force all buildings > 8 stories to have steel-framed wall type ([#759](https://github.com/NREL/resstock/pull/759)) -- Fixes for wall constructions: remove wood sheathing on CMU and brick walls; better data for exterior finish absorptances and wall densities ([#789](https://github.com/NREL/resstock/pull/789)) -- Fixes unit conversion bugs in solar hot water model ([#809](https://github.com/NREL/resstock/pull/809)) -- Update the number of units represented in the national project YAML files to the American Community Survey 2019 5-year estimate ([#821](https://github.com/NREL/resstock/pull/821)) -- Properly apply roof insulation when the attic type is Finished Attic or Cathedral Ceilings ([#817](https://github.com/NREL/resstock/pull/817)) - -## ResStock v2.4.0 -###### January 27, 2021 - [Diff](https://github.com/NREL/OpenStudio-BuildStock/compare/v2.3.0...v2.4.0) - -Features -- Report the annual peak use and timing using the quantities of interest measure ([#458](https://github.com/NREL/resstock/pull/458)) -- Major change to most occupant-related schedules. Occupant activities are now generated on-the-fly and saved to .csv files used by Schedule:File objects. Schedules are generated using time-inhomogenous Markov chains derived from American Time Use Survey data, supplemented with sampling duration and power level from NEEA RBSA data, as well as DHW draw duration and flow rate data from Aquacraft/AWWA data [(see pre-print for details)](https://arxiv.org/abs/2111.01881) ([#348](https://github.com/NREL/resstock/pull/348)) -- Update the dependencies for heating and cooling setpoint tsvs (Setpoint, Has Offset, Offset Magnitude, and Offset Period) to IECC climate zone ([#468](https://github.com/NREL/resstock/pull/468)) -- Distinguish between vacant and occupied dwelling units using PUMS data ([#473](https://github.com/NREL/resstock/pull/473)) -- Update heating fuel distributions to be by Public Use Microdata Area (PUMA) rather than State ([#474](https://github.com/NREL/resstock/pull/474)) -- Restructure HVAC housing characteristics to 1) simplify the structure, 2) allow for integrating more local data sources, 3) update reference years for HVAC and refrigerator ages and efficiencies from 2009 to 2018, 4) add assumption comments to all HVAC-related housing characteristics, 5) improve Room AC efficiency distributions using ENERGY STAR saturation data, and 6) fix some incorrect assignment of Option=None heating systems ([#478](https://github.com/NREL/resstock/pull/478)) -- Increase roofing material options; update roofing material tsv files to include these new options ([#485](https://github.com/NREL/resstock/pull/485)) -- Update foundation type from the [Building Foundation Design Handbook](https://www.osti.gov/biblio/6980439-building-foundation-design-handbook) published in 1988 to RECS 2009 ([#492](https://github.com/NREL/resstock/pull/492)) -- Synchronize weather between ResStock and ComStock which increases the number of weather stations from 215 to 941 ([#507](https://github.com/NREL/resstock/pull/507)) -- Update Occupants per unit from RECS 2015 to PUMS 5-yr 2017 ([#509](https://github.com/NREL/resstock/pull/509])) -- Based on RECS 2015, separate the plug load equations for single-family detached, single-family attached, and multifamily buildings ([#471](https://github.com/NREL/resstock/pull/471)) -- Allow for plug load energy consumption to vary by Census Division and include additional "diversity" multiplier in plug load equations ([#511](https://github.com/NREL/resstock/pull/511)) -- Lighting saturations based on RECS 2015 with new building type and spatial dependencies ([#510](https://github.com/NREL/resstock/pull/510])) -- Introduce premium water heaters and heat pump water heaters into building stock, differentiate between central and in-unit water heating, and split water heater fuel and efficiency into different housing characteristics ([#513](https://github.com/NREL/resstock/pull/513)) -- Separate heat pump electric supplemental heating from total electric heating in output reporting ([#512](https://github.com/NREL/OpenStudio-BuildStock/pull/512)) -- Update the duct leakage "total" to "to outside" conversion to be based on ASHRAE Standard 152 ([#532](https://github.com/NREL/resstock/pull/532)) -- Allow for flexible weather regions based on weather data available and introduce TMY3 weather files for the new weather format ([#525](https://github.com/NREL/resstock/pull/525)) - -Fixes -- Fix for pseudo-random number generator that was generating non-deterministic occupancy schedules ([#477](https://github.com/NREL/resstock/pull/477)) -- Iterate all spaces in a thermal zone when checking for zone type; fixes missing infiltration for protruding garages in 1-story homes ([#480](https://github.com/NREL/resstock/pull/480)) -- Update spatial distribution of units based on total dwelling unit counts rather than occupied unit counts ([#486](https://github.com/NREL/resstock/pull/486)) -- Exclude existing shared walls when calculating the partition wall area of MF and SFA buildings ([#496](https://github.com/NREL/resstock/pull/496)) -- For the purpose of calculating cooling and dehumidification loads for HVAC sizing, use simple internal gains equation from ANSI/RESNET/ICC 301 (consistent with HPXML workflow); this fixes a bug introduced in [#348](https://github.com/NREL/resstock/pull/348) that caused cooling capacities to be ~3x larger than they should be ([#501](https://github.com/NREL/resstock/pull/501)) -- Reintroduce IECC climate zone dependency to HVAC Cooling Type and some heat pump fixes ([#497](https://github.com/NREL/resstock/pull/497)) -- Reintroduce monthly multipliers with stochastic load model for dishwasher, clothes washer and clothes dryer and cooking ([#504](https://github.com/NREL/resstock/pull/504)) -- Account for collapsed units when determining geometry variables (building floor/wall area and volume) in infiltration calculations; add airflow unit tests ([#518](https://github.com/NREL/resstock/pull/518)) -- Fix for calculating door and below-grade wall area of multifamily and single-family attached buildings with collapsed geometries ([#523](https://github.com/NREL/resstock/pull/523)) -- In the Corridor.tsv, assign single-family attached, single-family detached, and mobile homes with a "Not Applicable" option ([#502](https://github.com/NREL/resstock/pull/522)) -- Remove ceiling fan energy for vacant units ([#527](https://github.com/NREL/resstock/pull/527)) -- Fix bug related to incorrect timestamps when using AMY weather file ([#528](https://github.com/NREL/resstock/pull/528)) -- Fix DST start hour error and end date error ([#530](https://github.com/NREL/resstock/pull/530)) -- Calculate slab surface effective R values used in HVAC sizing with unit-level variables ([#537](https://github.com/NREL/resstock/pull/537)) - -## ResStock v2.3.0 -###### June 24, 2020 - [Diff](https://github.com/NREL/resstock/compare/v2.2.4...v2.3.0) - -Features -- Remove the single-family detached project, and remove PAT from the testing and multifamily projects ([#402](https://github.com/NREL/resstock/pull/402)) -- Relocate the data folder, along with tsv makers, to a separate private repository ([#401](https://github.com/NREL/resstock/pull/401)) -- Update the single-family detached and multifamily projects with more up-to-date lighting stock distributions ([#392](https://github.com/NREL/resstock/pull/392)) -- Update Insulation Finished Attic tsv with more options for insulation levels ([#395](https://github.com/NREL/resstock/pull/395)) -- Add ability to ignore comment lines with the "#" symbol ([#408](https://github.com/NREL/resstock/pull/408)) -- Update occupant and plug loads equations based on RECS 2015 data; replace floor area with occupants as independent variable in plug loads equation; allow modeling of zero-bedroom units (e.g., studios) ([#324](https://github.com/NREL/resstock/pull/324)) -- New geospatial characteristics have been added or updated. New geospatial characteristics are as follows: ASHRAE IECC Climate Zone 2004, State, County, PUMA, Census Division, Census Region, Building America Climate Zone, and ISO/RTO Region. The top level housing characteristic is now ASHRAE IECC Climate Zone 2004. Now using data from the American Community Survey Public Use Microdata Sample (ACS PUMS) for Building Type, Vintage, and Heating Fuel ([#416](https://github.com/NREL/resstock/pull/416)) -- Update HVAC System Cooling tsv with air-conditioning saturations ("None", "Room AC", or "Central AC") from American Housing Survey for Custom Region 04. Efficiency probabilities remain based on RECS 2009 ([#418](https://github.com/NREL/resstock/pull/418)) -- Diversify the timing heating and cooling setpoint setbacks ([#414](https://github.com/NREL/resstock/pull/414)) -- Reduce the number of appliances in multifamily units. Adding RECS building type as a dependencies to clothes washers, clothes dryers, dishwashers, refrigerators, extra refrigerators, and stand-alone freezers. Update refrigeration levels based on RECS 2009 age and shipment-weighted efficiency by year. Now using the American Housing Survey (AHS) for clothes washer and clothes dryer saturations. New geographic field, AHS Region, which uses the top 15 largest Core Based Statistical Areas (CBSAs) and Non-CBSA Census Divisions. ([420](https://github.com/NREL/resstock/pull/420)) -- Exterior lighting schedule changed from using interior lighting sunrise/sunset algorithm to T24 2016 Residential ACM Appendix C Table 8 Exterior Lighting Hourly Multiplier for weekdays and weekends ([#419](https://github.com/NREL/resstock/pull/419)) -- Increase the diversity of the floor areas that are simulated. Geometry House Size has been replaced by Geometry Floor Area Bin and Geometry Floor Area. Now using AHS for specifying the floor area. Floor areas differ by non-Core Based Statistical Areas (CBSAs) Census Divisions and the top 15 largest CBSAs ([#425](https://github.com/NREL/resstock/pull/425)) -- Increase the diversity of the infiltration simulated. Now using the Residential Diagnostics Database for the Infiltration housing characteristic ([#427](https://github.com/NREL/resstock/pull/427)) -- Allow a key value to be specified when outputting timeseries variables ([#438](https://github.com/NREL/resstock/pull/438)) - -Fixes -- Rename "project_multifamily_beta" to "project_national" ([#459](https://github.com/NREL/resstock/pull/459)) -- Add mini-split heat pump pan heater to custom meter for heating electricity ([#454](https://github.com/NREL/resstock/pull/454)) -- Assign daylight saving start/end dates based on county and not epw region ([#453](https://github.com/NREL/resstock/pull/453)) -- Update ceiling fan tsv to remove the "National Average" option, and instead sample 28% "None" and 72% "Standard Efficiency" ([#445](https://github.com/NREL/resstock/pull/445)) -- Remove Location Weather Filename and Location Weather Year tsvs, and update options lookup to reflect updated weather file changes; weather filenames are now required to match what is in the options lookup ([#432](https://github.com/NREL/resstock/pull/432)) -- Fix bug in QOI reporting measure where absence of any heating/cooling/overlap seasons would cause errors ([#433](https://github.com/NREL/resstock/pull/433)) -- Restructure unfinished attic and finished roof -related tsv files (i.e., insulation, roof material, and radiant barrier) and options ([#426](https://github.com/NREL/resstock/pull/426)) -- Exclude net site energy consumption from annual and timeseries simulation output ("total" now reflects net of pv); change `include_enduse_subcategories` argument default to "true"; report either total interior equipment OR each of its components ([#405](https://github.com/NREL/resstock/pull/405)) -- Refactor the tsv maker classes to accommodate more data sources ([#392](https://github.com/NREL/resstock/pull/392)) -- Allow a building to be simulated with no water heater; map the "Other Fuel" option from the Water Heater tsv to no water heater ([#375](https://github.com/NREL/resstock/pull/375)) -- Revert plug load schedule to RBSA for the National Average option ([#355](https://github.com/NREL/resstock/pull/355)) -- Removed the "Geometry Unit Stories SF" and "Geometry Unit Stories MF" housing characteristics. Unit stories are instead represented by the "Geometry Stories" housing characteristic ([#416](https://github.com/NREL/resstock/pull/416)) -- Diversify window to wall ratio variation using the Residential Building Stock Assessment (RBSA) II data ([#412](https://github.com/NREL/resstock/pull/412)) -- Fix bug in assigning small window areas to surfaces ([#452](https://github.com/NREL/resstock/pull/452)) - -## ResStock v2.2.5 -###### September 24, 2020 - [Diff](https://github.com/NREL/resstock/compare/v2.2.4...v2.2.5) - -Fixes -- Update the weather zip file url in each PAT project to point to a different location at data.nrel.gov ([#489](https://github.com/NREL/resstock/pull/489)) - -## ResStock v2.2.4 -###### April 28, 2020 - [Diff](https://github.com/NREL/resstock/compare/v2.2.3...v2.2.4) - -Fixes -- Fix bug in options lookup where buildings without heating systems were not being assigned the required "has_hvac_flue" airflow measure argument ([#442](https://github.com/NREL/resstock/pull/442)) - -## ResStock v2.2.3 -###### March 9, 2020 - [Diff](https://github.com/NREL/resstock/compare/v2.2.2...v2.2.3) - -Fixes -- Update the weather zip file url in each PAT project to point to data.nrel.gov ([#422](https://github.com/NREL/resstock/pull/422)) - -## ResStock v2.2.2 -###### February 19, 2020 - [Diff](https://github.com/NREL/resstock/compare/v2.2.1...v2.2.2) - -Fixes -- Update the datapoint initialization script to download weather files to a common zip filename ([#406](https://github.com/NREL/resstock/pull/406)) - -## ResStock v2.2.1 -###### February 7, 2020 - [Diff](https://github.com/NREL/resstock/compare/v2.2.0...v2.2.1) - -Features -- Update the multifamily project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls ([#382](https://github.com/NREL/resstock/pull/382)) - -Fixes -- Add generation of the Geometry Wall Type tsv file for the single-family detached project to the 2009 RECS tsv maker; this corrects the tsv file ([#387](https://github.com/NREL/resstock/pull/387)) -- Add generation of the Misc Pool tsv file (with Geometry Building Type and Location Region dependencies) to the 2009 RECS tsv maker; this also corrects having pool pumps for all homes ([#387](https://github.com/NREL/resstock/pull/387)) -- Refactor the RECS tsv makers for years 2009 and 2015 ([#382](https://github.com/NREL/resstock/pull/382)) - -## ResStock v2.2.0 -###### January 30, 2020 - [Diff](https://github.com/NREL/resstock/compare/v2.1.0...v2.2.0) - -Features -- The results csv now optionally reports annual totals for all end use subcategories, including appliances, plug loads, etc. ([#371](https://github.com/NREL/resstock/pull/371)) -- Split out national average options so not all homes have all miscellaneous equipment, and add none options to appliances ([#362](https://github.com/NREL/resstock/pull/362)) -- Update the single-family detached project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls ([#357](https://github.com/NREL/resstock/pull/357)) -- Made housing characteristics a consistent format. Added integrity check to ensure housing characteristics follow the guildelines specified in read-the-docs ([#353](https://github.com/NREL/resstock/pull/353)) -- Include additional "daylight saving time" and "utc time" columns to timeseries csv file to account for one hour forward and backward time shifts ([#346](https://github.com/NREL/resstock/pull/346)) -- Update bedrooms and occupants tsv files with options and probability distributions based on RECS 2015 data ([#340](https://github.com/NREL/resstock/pull/340)) -- Add new QOIReport measure for reporting seasonal quantities of interest for uncertainty quantification ([#334](https://github.com/NREL/resstock/pull/334)) -- Separate tsv files for bedrooms, cooking range schedule, corridor, holiday lighting, interior/other lighting use, pool schedule, plug loads schedule, and refrigeration schedule ([#338](https://github.com/NREL/resstock/pull/338)) - -Fixes -- Allow Wood Stove option as an upgrade, and account for wood heating energy in simulation output ([#372](https://github.com/NREL/resstock/pull/372)) -- Custom meters for ceiling fan, hot water recirc pump, and vehicle end use subcategories were not properly implemented ([#371](https://github.com/NREL/resstock/pull/371)) -- Some re-labeling of tsv files, such as "Geometry Building Type" to "Geometry Building Type RECS" and "Geometry Building Type FPL" to "Geometry Building Type ACS" ([#356](https://github.com/NREL/resstock/pull/356)) -- Removes option "Auto" from parameter "Occupants" in the options lookup file ([#360](https://github.com/NREL/resstock/pull/360)) -- Update the multifamily project's neighbors and orientation tsv files to have geometry building type dependency; remove the now obsolete "Geometry Is Multifamily Low Rise.tsv" file ([#350](https://github.com/NREL/resstock/pull/350)) -- Update each PAT project's AMI selection to "2.9.0" ([#346](https://github.com/NREL/resstock/pull/346)) -- Fixes for custom output meters: total site electricity double-counting exterior holiday lighting, and garage lighting all zeroes ([#349](https://github.com/NREL/resstock/pull/349)) -- Remove shared facades tsv files from the multifamily_beta and testing projects ([#301](https://github.com/NREL/resstock/pull/301)) -- Move redundant output meter code from individual reporting measures out into shared resource file ([#334](https://github.com/NREL/resstock/pull/334)) -- Fix for the power outages measure where the last hour of the day was not getting the new schedule applied ([#238](https://github.com/NREL/resstock/pull/238)) - -## ResStock v2.1.0 -###### November 5, 2019 - [Diff](https://github.com/NREL/resstock/compare/v2.0.0...v2.1.0) - -Features -- Update to OpenStudio v2.9.0 ([#322](https://github.com/NREL/resstock/pull/322)) -- Unit tests and performance improvements for integrity checks ([#228](https://github.com/NREL/resstock/pull/228), [#237](https://github.com/NREL/resstock/pull/237), [#239](https://github.com/NREL/resstock/pull/239)) -- Register climate zones (BA and IECC) based on the simulation EPW file ([#245](https://github.com/NREL/resstock/pull/245)) -- Split ResidentialLighting into separate ResidentialLightingInterior and ResidentialLightingOther (with optional exterior holiday lighting) measures ([#244](https://github.com/NREL/resstock/pull/244), [#252](https://github.com/NREL/resstock/pull/252)) -- Additional example workflow osw files using TMY/AMY2012/AMY2014 weather for use in regression testing ([#259](https://github.com/NREL/resstock/pull/259), [#261](https://github.com/NREL/resstock/pull/261)) -- Update all projects with new heating/cooling setpoint, offset, and magnitude distributions ([#272](https://github.com/NREL/resstock/pull/272)) -- Add new ResidentialDemandResponse measure that allows for 8760 DR schedules to be applied to heating/cooling schedules ([#276](https://github.com/NREL/resstock/pull/276)) -- Additional options for HVAC, dehumidifier, clothes washer, misc loads, infiltration, etc. ([#264](https://github.com/NREL/resstock/pull/264), [#278](https://github.com/NREL/resstock/pull/278), [#292](https://github.com/NREL/resstock/pull/292)) -- Add EV options and update ResidentialMiscLargeUncommonLoads measure with new electric vehicle argument ([#282](https://github.com/NREL/resstock/pull/282)) -- Update ResidentialSimulationControls measure to include a calendar year argument for controlling the simulation start day of week ([#287](https://github.com/NREL/resstock/pull/287)) -- Increase number of possible upgrade options from 10 to 25 ([#273](https://github.com/NREL/resstock/pull/273), [#293](https://github.com/NREL/resstock/pull/293)) -- Additional "max-tech" options for slab, wall, refrigerator, dishwasher, clothes washer, and lighting ([#296](https://github.com/NREL/resstock/pull/296)) -- Add references to ResStock trademark in both the license and readme files ([#302](https://github.com/NREL/resstock/pull/302)) -- Report all cost multipliers in the SimulationOutputReport measure ([#304](https://github.com/NREL/resstock/pull/304)) -- Add options for low flow fixtures ([#305](https://github.com/NREL/resstock/pull/305)) -- Add argument to BuildExistingModel measure that allows the user to ignore measures ([#310](https://github.com/NREL/resstock/pull/310)) -- Create example project yaml files for use with buildstockbatch ([#291](https://github.com/NREL/resstock/pull/291), [#314](https://github.com/NREL/resstock/pull/314)) -- Create a pull request template to facilitate development ([#317](https://github.com/NREL/resstock/pull/317)) -- Update documentation to clarify downselect logic parameters ([#321](https://github.com/NREL/resstock/pull/321)) -- Additional options for EnergyStar clothes washer, clothes dryer, dishwasher ([#329](https://github.com/NREL/resstock/pull/329), [#333](https://github.com/NREL/resstock/pull/333)) - -Fixes -- Bugfix for assuming that all simulations are exactly 365 days ([#255](https://github.com/NREL/resstock/pull/255)) -- Bugfix for heating coil defrost strategy ([#258](https://github.com/NREL/resstock/pull/258)) -- Various HVAC-related fixes for buildings with central systems ([#263](https://github.com/NREL/resstock/pull/263)) -- Update testing project to sweep through more options ([#280](https://github.com/NREL/resstock/pull/280)) -- Updates, edits, and clarification to the documentation ([#270](https://github.com/NREL/resstock/pull/270), [#274](https://github.com/NREL/resstock/pull/274), [#285](https://github.com/NREL/resstock/pull/285)) -- Skip any reporting measure output requests for datapoints that have been registered as invalid ([#286](https://github.com/NREL/resstock/pull/286)) -- Bugfix for when bedrooms are specified for each unit but bathrooms are not ([#295](https://github.com/NREL/resstock/pull/295)) -- Ensure that autosizing does not draw the whole tank volume in one minute for solar hot water storage tank ([#307](https://github.com/NREL/resstock/pull/307)) -- Remove invalid characters from option names for consistency with buildstockbatch ([#308](https://github.com/NREL/resstock/pull/308)) -- Bugfix for ducts occasionally getting placed in the garage attic instead of only unfinished attic ([#309](https://github.com/NREL/resstock/pull/309)) -- Able to get past runner values of any type, and not just as string ([#312](https://github.com/NREL/resstock/pull/312)) -- Log the error message along with the backtrace when an applied measure fails ([#315](https://github.com/NREL/resstock/pull/315)) -- Add tests to ensure that the Run Measure argument is correctly defined in all Apply Upgrade measures for all projects ([#320](https://github.com/NREL/resstock/pull/320)) -- Bugfix when specifying numbers of bedrooms to building units ([#330](https://github.com/NREL/resstock/pull/330)) -- Enforce rubocop as CI test so code with offenses cannot be merged ([#331](https://github.com/NREL/resstock/pull/331)) -- Bugfix for some clothes washer, dishwasher options causing increased energy consumption ([#329](https://github.com/NREL/resstock/pull/329), [#333](https://github.com/NREL/resstock/pull/333)) - - -## ResStock v2.0.0 -###### April 17, 2019 - [Diff](https://github.com/NREL/resstock/compare/v1.0.0...v2.0.0) - -Features -- Update to OpenStudio v2.8.0 ([#151](https://github.com/NREL/resstock/pull/151)) -- Add a multifamily project which includes housing characteristic distributions for single-family detached, single-family attached, and multifamily buildings ([#151](https://github.com/NREL/resstock/pull/151)) -- Ability to add central systems (boiler with baseboards, fan coil, PTAC) to multifamily buildings using the openstudio-standards gem ([#151](https://github.com/NREL/resstock/pull/151)) -- Ability to simulate large multifamily buildings using "collapsed" buildings with multipliers on building units ([#206](https://github.com/NREL/resstock/pull/206)) -- Automatically generate dependency graphs and a dependency wheel for each project ([#211](https://github.com/NREL/resstock/pull/211)) -- Add measures for calculating construction properties, modeling power outages and calculating resilience metrics, and calculating utility bills ([#151](https://github.com/NREL/resstock/pull/151)) -- Add measure for modeling shared multiifamily facades using adiabatic constructions ([#151](https://github.com/NREL/resstock/pull/151)) -- Relocate all measure unit tests, test osw files, and test osm files from archived OpenStudio-BEopt and into this repository ([#151](https://github.com/NREL/resstock/pull/151)) -- Create example workflow osw files for single-family detached, single-family attached, and multifamily buildings using TMY weather ([#151](https://github.com/NREL/resstock/pull/151)) - -Fixes -- Reporting measures read from ReportMeterData table to get disaggregated fan and pump energy ([#151](https://github.com/NREL/resstock/pull/151)) -- Break out central system heating, cooling, and pump energy in reporting measures ([#151](https://github.com/NREL/resstock/pull/151)) -- Use custom unit conversions script instead of that provided by OpenStudio SDK ([#216](https://github.com/NREL/resstock/pull/216)) - - -## ResStock v1.0.0 -###### April 17, 2019 \ No newline at end of file From c0beda78dd1de474338f47e9a2af38342d168514 Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Wed, 5 Jun 2024 14:50:02 -0700 Subject: [PATCH 20/21] Add a changelog entry. --- .../source/changelog/changelog_dev.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/read_the_docs/source/changelog/changelog_dev.rst b/docs/read_the_docs/source/changelog/changelog_dev.rst index c7ee7553f9..b7cb39e381 100644 --- a/docs/read_the_docs/source/changelog/changelog_dev.rst +++ b/docs/read_the_docs/source/changelog/changelog_dev.rst @@ -6,6 +6,21 @@ Development Changelog :version: v3.3.0 :released: pending + .. change:: + :tags: documentation, changelog, feature + :pullreq: 1244 + + **Date**: 2024-06-05 + + Title: + RTD: detailed changelog + + Description: + Adopt changelog approach from buildstockbatch. + + Assignees: Joe Robertson + + .. change:: :tags: documentation, options_lookup, feature :pullreq: 1249 From 3a10d59e8cdbb3e8afae63e5ff55532f96e8876d Mon Sep 17 00:00:00 2001 From: Joe Robertson Date: Wed, 5 Jun 2024 15:27:46 -0700 Subject: [PATCH 21/21] Quick run through with cleanup. --- .../source/changelog/changelog_2_0_0.rst | 24 +- .../source/changelog/changelog_2_1_0.rst | 153 ++++++------ .../source/changelog/changelog_2_2_0.rst | 55 ++--- .../source/changelog/changelog_2_2_1.rst | 12 +- .../source/changelog/changelog_2_2_2.rst | 2 +- .../source/changelog/changelog_2_2_3.rst | 2 +- .../source/changelog/changelog_2_2_4.rst | 2 +- .../source/changelog/changelog_2_2_5.rst | 2 +- .../source/changelog/changelog_2_3_0.rst | 114 ++++----- .../source/changelog/changelog_2_4_0.rst | 60 ++--- .../source/changelog/changelog_2_5_0.rst | 220 ++++++++---------- .../source/changelog/changelog_3_0_0.rst | 75 +++--- .../source/changelog/changelog_3_1_0.rst | 29 +-- .../source/changelog/changelog_3_1_1.rst | 4 +- .../source/changelog/changelog_3_2_0.rst | 67 +++--- .../source/changelog/changelog_dev.rst | 69 +++--- 16 files changed, 433 insertions(+), 457 deletions(-) diff --git a/docs/read_the_docs/source/changelog/changelog_2_0_0.rst b/docs/read_the_docs/source/changelog/changelog_2_0_0.rst index 77af19b060..fa5f066077 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_0_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_0_0.rst @@ -16,7 +16,7 @@ v2.0.0 Changelog Multifamily Description: - Update to OpenStudio v2.8.0 + Update to OpenStudio v2.8.0. Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz @@ -31,7 +31,7 @@ v2.0.0 Changelog Multifamily Description: - Add a multifamily project which includes housing characteristic distributions for single-family detached, single-family attached, and multifamily buildings + Add a multifamily project which includes housing characteristic distributions for single-family detached, single-family attached, and multifamily buildings. Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz @@ -46,7 +46,7 @@ v2.0.0 Changelog Multifamily Description: - Add measures for calculating construction properties, modeling power outages and calculating resilience metrics, and calculating utility bills + Add measures for calculating construction properties, modeling power outages and calculating resilience metrics, and calculating utility bills. Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz @@ -61,7 +61,7 @@ v2.0.0 Changelog Multifamily Description: - Add measure for modeling shared multiifamily facades using adiabatic constructions + Add measure for modeling shared multiifamily facades using adiabatic constructions. Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz @@ -76,7 +76,7 @@ v2.0.0 Changelog Multifamily Description: - Relocate all measure unit tests, test osw files, and test osm files from archived OpenStudio-BEopt and into this repository + Relocate all measure unit tests, test osw files, and test osm files from archived OpenStudio-BEopt and into this repository. Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz @@ -91,7 +91,7 @@ v2.0.0 Changelog Multifamily Description: - Create example workflow osw files for single-family detached, single-family attached, and multifamily buildings using TMY weather + Create example workflow osw files for single-family detached, single-family attached, and multifamily buildings using TMY weather. Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz @@ -106,7 +106,7 @@ v2.0.0 Changelog Multifamily Description: - Reporting measures read from ReportMeterData table to get disaggregated fan and pump energy + Reporting measures read from ReportMeterData table to get disaggregated fan and pump energy. Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz @@ -121,7 +121,7 @@ v2.0.0 Changelog Multifamily Description: - Break out central system heating, cooling, and pump energy in reporting measures + Break out central system heating, cooling, and pump energy in reporting measures. Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz @@ -136,7 +136,7 @@ v2.0.0 Changelog Use UnitConversions.convert(...) method Description: - Use custom unit conversions script instead of that provided by OpenStudio SDK + Use custom unit conversions script instead of that provided by OpenStudio SDK. Assignees: Joe Robertson @@ -151,7 +151,7 @@ v2.0.0 Changelog Dependency graphs and wheels Description: - Automatically generate dependency graphs and a dependency wheel for each project + Automatically generate dependency graphs and a dependency wheel for each project. I put together scripts in the docs folder to automatically generate dependency graphs and a dependency wheel for each in the OpenStudio-BuildStock repository. These scripts create a util folder if it doesn't exist and puts data for these visualizations. A project README.md file has been added to each where there is a link to the interactive dependency wheel. These visualizations are easily updated as they depend strictly on the TSV files. They are updated through a single regenerate_visualization.ipynb script. Assignees: Anthony Fontanini @@ -167,7 +167,7 @@ v2.0.0 Changelog Large buildings collapsed into minimal units Description: - Ability to simulate large multifamily buildings using "collapsed" buildings with multipliers on building units + Ability to simulate large multifamily buildings using "collapsed" buildings with multipliers on building units. Assignees: Joe Robertson @@ -182,7 +182,7 @@ v2.0.0 Changelog Multifamily Description: - Ability to add central systems (boiler with baseboards, fan coil, PTAC) to multifamily buildings using the openstudio-standards gem + Ability to add central systems (boiler with baseboards, fan coil, PTAC) to multifamily buildings using the openstudio-standards gem. Assignees: Joe Robertson, Maharshi Pathak, Scott Horowitz diff --git a/docs/read_the_docs/source/changelog/changelog_2_1_0.rst b/docs/read_the_docs/source/changelog/changelog_2_1_0.rst index 5177b1594b..2d6daa1a6a 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_1_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_1_0.rst @@ -16,7 +16,7 @@ v2.1.0 Changelog Update the cw options a bit Description: - Additional options for EnergyStar clothes washer, clothes dryer, dishwasher + Additional options for EnergyStar clothes washer, clothes dryer, dishwasher. Reduce IMEF on the "more" efficient option. Change drum volume on "most" efficient option. Add links in unit tests to actual clothes washer examples pulled from energystar. Assignees: Joe Robertson @@ -32,7 +32,7 @@ v2.1.0 Changelog Update the cw options a bit Description: - Bugfix for some clothes washer, dishwasher options causing increased energy consumption + Bugfix for some clothes washer, dishwasher options causing increased energy consumption. Reduce IMEF on the "more" efficient option. Change drum volume on "most" efficient option. Add links in unit tests to actual clothes washer examples pulled from energystar. Assignees: Joe Robertson @@ -48,7 +48,7 @@ v2.1.0 Changelog Enforce rubocop as separate ci test Description: - Enforce rubocop as CI test so code with offenses cannot be merged + Enforce rubocop as CI test so code with offenses cannot be merged. Code can no longer be committed to the repo with rubocop offenses. Assignees: Joe Robertson @@ -64,7 +64,7 @@ v2.1.0 Changelog Add more efficient options for dw, cw, cd Description: - Additional options for EnergyStar clothes washer, clothes dryer, dishwasher + Additional options for EnergyStar clothes washer, clothes dryer, dishwasher. We need "more efficient" options for idsm-scout and mf aedg. Currently, the dw, cw options are causing increased energy consumption. Janet had started to look into this. Turns out things related to the energy guide label, like rated_annual_energy, annual_cost, and test_date, had not been updated. Assignees: Joe Robertson @@ -80,7 +80,7 @@ v2.1.0 Changelog Fix assignment of bedrooms to units Description: - Bugfix when specifying numbers of bedrooms to building units + Bugfix when specifying numbers of bedrooms to building units. This fixes a bug when you try to assign, e.g., 3, 2, 1, 2, 2, 3 numbers of bedrooms to 6 building units. Assignees: Joe Robertson @@ -96,7 +96,7 @@ v2.1.0 Changelog Add more efficient options for dw, cw, cd Description: - Bugfix for some clothes washer, dishwasher options causing increased energy consumption + Bugfix for some clothes washer, dishwasher options causing increased energy consumption. We need "more efficient" options for idsm-scout and mf aedg. Currently, the dw, cw options are causing increased energy consumption. Janet had started to look into this. Turns out things related to the energy guide label, like rated_annual_energy, annual_cost, and test_date, had not been updated. Assignees: Joe Robertson @@ -144,7 +144,7 @@ v2.1.0 Changelog Talk to downselect point that datapoints are before downselect logic. Description: - Update documentation to clarify downselect logic parameters + Update documentation to clarify downselect logic parameters. Assignees: Joe Robertson @@ -159,7 +159,7 @@ v2.1.0 Changelog Fixes #319 Description: - Add tests to ensure that the Run Measure argument is correctly defined in all Apply Upgrade measures for all projects + Add tests to ensure that the Run Measure argument is correctly defined in all Apply Upgrade measures for all projects. Fixes #319. Added tests to ensure that the Run Measure argument is correctly defined in all Apply Upgrade measures for all projects. Assignees: Scott Horowitz @@ -175,7 +175,7 @@ v2.1.0 Changelog Example YAML file upload Description: - Create example project yaml files for use with buildstockbatch + Create example project yaml files for use with buildstockbatch. Some comments on correct defaults included, could use more. Assignees: Elaina Present @@ -191,7 +191,7 @@ v2.1.0 Changelog Create pull_request_template.md Description: - Create a pull request template to facilitate development + Create a pull request template to facilitate development. Start creating a pull request template. Assignees: Joe Robertson @@ -207,7 +207,7 @@ v2.1.0 Changelog Log the error string along with backtrace Description: - Log the error message along with the backtrace when an applied measure fails + Log the error message along with the backtrace when an applied measure fails. Currently, the apply_measure function only logs the error backtrace when the measure being applied fails, but not the actual error message. This fixes the issue, and logs the error message alongside the backtrace. Assignees: Rajendra Adhikari @@ -223,7 +223,7 @@ v2.1.0 Changelog Ehale ignore measures Description: - Add argument to BuildExistingModel measure that allows the user to ignore measures + Add argument to BuildExistingModel measure that allows the user to ignore measures. This branch adds the feature of being able to having the ResStock BuildExistingModel ignore measures. There will be a companion pull request to buildstockbatch that passes that argument through the project yml. Assignees: Elaine Hale @@ -239,8 +239,8 @@ v2.1.0 Changelog Get past runner values of any type Description: - Able to get past runner values of any type, and not just as string - Can only get runner past values as string + Able to get past runner values of any type, and not just as string. + Can only get runner past values as string. Assignees: Joe Robertson @@ -255,11 +255,11 @@ v2.1.0 Changelog Fixes/updates for SimulationOutputReport measure Description: - Report all cost multipliers in the SimulationOutputReport measure - Fix bug in cost multipliers for "minimally collapsed" building - SimulationOutputReport unit tests for "minimally collapsed" building - Report all cost multipliers in results csv - Regression tests include all cost multipliers + Report all cost multipliers in the SimulationOutputReport measure. + Fix bug in cost multipliers for "minimally collapsed" building. + SimulationOutputReport unit tests for "minimally collapsed" building. + Report all cost multipliers in results csv. + Regression tests include all cost multipliers. Assignees: Joe Robertson @@ -274,7 +274,7 @@ v2.1.0 Changelog Ducts sometimes placed in garage attic Description: - Bugfix for ducts occasionally getting placed in the garage attic instead of only unfinished attic + Bugfix for ducts occasionally getting placed in the garage attic instead of only unfinished attic. This changes the space type for the 1-story building garage attic from unfinished attic to garage attic. This should fix issues brought up by @jonwinkler. Assignees: Joe Robertson @@ -290,8 +290,8 @@ v2.1.0 Changelog Addresses #306 Description: - Ensure that autosizing does not draw the whole tank volume in one minute for solar hot water storage tank - setUseSideDesignFlowRate for solar hw measure + Ensure that autosizing does not draw the whole tank volume in one minute for solar hot water storage tank. + setUseSideDesignFlowRate for solar hw measure. Assignees: Joe Robertson @@ -306,8 +306,8 @@ v2.1.0 Changelog Remove invalid characters from option names Description: - Remove invalid characters from option names for consistency with buildstockbatch - Fixes options that would fail the validation proposed in NREL/buildstockbatch#99 + Remove invalid characters from option names for consistency with buildstockbatch. + Fixes options that would fail the validation proposed in NREL/buildstockbatch#99. Assignees: Nate Moore @@ -322,7 +322,7 @@ v2.1.0 Changelog Low flow fixture options Description: - Add options for low flow fixtures + Add options for low flow fixtures. Assignees: Joe Robertson @@ -353,10 +353,11 @@ v2.1.0 Changelog Add TM to ResStock and ComStock Description: - Add references to ResStock trademark in both the license and readme files + Add references to ResStock trademark in both the license and readme files. Added to first references in: - README.md - LICENSE.md + + - README.md + - LICENSE.md Assignees: Joe Robertson @@ -371,8 +372,8 @@ v2.1.0 Changelog Additional max-tech levels for options_lookup Description: - Additional "max-tech" options for slab, wall, refrigerator, dishwasher, clothes washer, and lighting - Added 112 lm/W LED option, EF 22.2 refrigerator option, R20 Whole Slab insulation option, Wood Stud R-13 with R-20 external XPS option, EnergyStar Most Efficient clothes washers, and EnergyStar Most Efficient Dishwashers at 199 rated Kwh + Additional "max-tech" options for slab, wall, refrigerator, dishwasher, clothes washer, and lighting. + Added 112 lm/W LED option, EF 22.2 refrigerator option, R20 Whole Slab insulation option, Wood Stud R-13 with R-20 external XPS option, EnergyStar Most Efficient clothes washers, and EnergyStar Most Efficient Dishwashers at 199 rated Kwh. Assignees: Elaina Present @@ -387,7 +388,7 @@ v2.1.0 Changelog Fix bug when you specify all br but not ba Description: - Bugfix for when bedrooms are specified for each unit but bathrooms are not + Bugfix for when bedrooms are specified for each unit but bathrooms are not. Assignees: Joe Robertson @@ -402,7 +403,7 @@ v2.1.0 Changelog Increase upgrade options from 20 to 25 Description: - Increase number of possible upgrade options from 10 to 25 + Increase number of possible upgrade options from 10 to 25. Assignees: Joe Robertson @@ -417,7 +418,7 @@ v2.1.0 Changelog Demand response Description: - Add new ResidentialDemandResponse measure that allows for 8760 DR schedules to be applied to heating/cooling schedules + Add new ResidentialDemandResponse measure that allows for 8760 DR schedules to be applied to heating/cooling schedules. New measure ResidentialDemandResponse that allows for 8760 DR schedules to be applied to heating and/or cooling schedules. Assignees: Andrew Speake @@ -433,7 +434,7 @@ v2.1.0 Changelog Add options and write EV code Description: - Add EV options and update ResidentialMiscLargeUncommonLoads measure with new electric vehicle argument + Add EV options and update ResidentialMiscLargeUncommonLoads measure with new electric vehicle argument. Also includes writing new options/arguments in measure.rb, which should be closely examined for errors due to my inexperience with that task. Assignees: Nate Moore @@ -449,8 +450,7 @@ v2.1.0 Changelog Add buildstockbatch ymls to each resstock project Description: - Create example project yaml files for use with buildstockbatch - For convenience. + Create example project yaml files for use with buildstockbatch for convenience. Assignees: Joe Robertson @@ -465,7 +465,7 @@ v2.1.0 Changelog Add year argument to simulation controls measure Description: - Update ResidentialSimulationControls measure to include a calendar year argument for controlling the simulation start day of week + Update ResidentialSimulationControls measure to include a calendar year argument for controlling the simulation start day of week. Assignees: Joe Robertson @@ -480,7 +480,7 @@ v2.1.0 Changelog Don't request output for "invalid" datapoints Description: - Skip any reporting measure output requests for datapoints that have been registered as invalid + Skip any reporting measure output requests for datapoints that have been registered as invalid. Assignees: Joe Robertson @@ -495,7 +495,7 @@ v2.1.0 Changelog Update testing project to sweep thru more options Description: - Update testing project to sweep through more options + Update testing project to sweep through more options. Assignees: Nate Moore @@ -510,7 +510,7 @@ v2.1.0 Changelog Minor readthedocs updates Description: - Updates, edits, and clarification to the documentation + Updates, edits, and clarification to the documentation. Assignees: Joe Robertson @@ -526,7 +526,7 @@ v2.1.0 Changelog Description: Additional options for HVAC, dehumidifier, clothes washer, misc loads, infiltration, etc. - Add items to options_lookup available in master branch + Add items to options_lookup available in master branch. Assignees: Nate Moore @@ -541,7 +541,7 @@ v2.1.0 Changelog Some RTD updates Description: - Updates, edits, and clarification to the documentation + Updates, edits, and clarification to the documentation. Assignees: Joe Robertson @@ -556,7 +556,7 @@ v2.1.0 Changelog Increase upgrade options from 10 to 20 Description: - Increase number of possible upgrade options from 10 to 25 + Increase number of possible upgrade options from 10 to 25. Assignees: Joe Robertson @@ -571,7 +571,7 @@ v2.1.0 Changelog Advanced tutorial updates Description: - Updates, edits, and clarification to the documentation + Updates, edits, and clarification to the documentation. Assignees: Joe Robertson @@ -603,10 +603,10 @@ v2.1.0 Changelog HVAC autosizing and add/replace fixes Description: - Various HVAC-related fixes for buildings with central systems - When a model has both a central system and non central system, don't autosize the non central system (e.g., central boiler with room ac) - Cannot have heating-only fan coil anymore; the ZoneHVACUnitHeater object was not being autosized correctly and was resulting in zero heating energy - Don't remove the cooling-only fan coil when applying a heating-only non central system (e.g., cooling-only fan coil with furnace) + Various HVAC-related fixes for buildings with central systems. + When a model has both a central system and non central system, don't autosize the non central system (e.g., central boiler with room ac). + Cannot have heating-only fan coil anymore; the ZoneHVACUnitHeater object was not being autosized correctly and was resulting in zero heating energy. + Don't remove the cooling-only fan coil when applying a heating-only non central system (e.g., cooling-only fan coil with furnace). Assignees: Joe Robertson @@ -621,7 +621,7 @@ v2.1.0 Changelog Addresses #243 and #254 Description: - Bugfix for assuming that all simulations are exactly 365 days + Bugfix for assuming that all simulations are exactly 365 days. Assignees: Joe Robertson @@ -636,8 +636,11 @@ v2.1.0 Changelog Additional example workflow osws Description: - Additional example workflow osw files using TMY/AMY2012/AMY2014 weather for use in regression testing - TMY, AMY2012, AMY2014. + Additional example workflow osw files using TMY/AMY2012/AMY2014 weather for use in regression testing: + + - TMY + - AMY2012 + - AMY2014 Assignees: Joe Robertson @@ -652,7 +655,7 @@ v2.1.0 Changelog Store example osw annual simulation results on ci Description: - Additional example workflow osw files using TMY/AMY2012/AMY2014 weather for use in regression testing + Additional example workflow osw files using TMY/AMY2012/AMY2014 weather for use in regression testing. Similar to how @shorowit does "regression testing" on https://github.com/NREL/OpenStudio-HPXML. Assignees: Joe Robertson @@ -668,7 +671,7 @@ v2.1.0 Changelog Typo in heating coil defrost strategy Description: - Bugfix for heating coil defrost strategy + Bugfix for heating coil defrost strategy. Assignees: Joe Robertson @@ -683,20 +686,28 @@ v2.1.0 Changelog Optional exterior "holiday" lights Description: - Split ResidentialLighting into separate ResidentialLightingInterior and ResidentialLightingOther (with optional exterior holiday lighting) measures + Split ResidentialLighting into separate ResidentialLightingInterior and ResidentialLightingOther (with optional exterior holiday lighting) measures. This involves modifications to: - ResidentialLightingOther measure - 4 new arguments (daily energy use, holiday period start, holiday period end, holiday schedule) - unit test for verifying that exterior lighting increases by, e.g., 41 days * 1.1 kWh/day = 45 kWh - lighting.rb - new apply_exterior_holiday method - assigning end use subcategories to all light objects - options_lookup.tsv and testing project - existing lighting options now get default holiday argument values - new lighting option to test exterior holiday lighting - SimulationOutputReport / TimeseriesCSVExport measures - custom meters for "garage lighting" and "exterior holiday lighting" - reporting "garage lighting" and "exterior holiday lighting" + + - ResidentialLightingOther measure + + - 4 new arguments (daily energy use, holiday period start, holiday period end, holiday schedule) + - unit test for verifying that exterior lighting increases by, e.g., 41 days * 1.1 kWh/day = 45 kWh + + - lighting.rb + + - new apply_exterior_holiday method + - assigning end use subcategories to all light objects + + - options_lookup.tsv and testing project + + - existing lighting options now get default holiday argument values + - new lighting option to test exterior holiday lighting + + - SimulationOutputReport / TimeseriesCSVExport measures + + - custom meters for "garage lighting" and "exterior holiday lighting" + - reporting "garage lighting" and "exterior holiday lighting" Assignees: Joe Robertson @@ -711,7 +722,7 @@ v2.1.0 Changelog Lighting measure changes Description: - Split ResidentialLighting into separate ResidentialLightingInterior and ResidentialLightingOther (with optional exterior holiday lighting) measures + Split ResidentialLighting into separate ResidentialLightingInterior and ResidentialLightingOther (with optional exterior holiday lighting) measures. Assignees: Joe Robertson @@ -726,7 +737,7 @@ v2.1.0 Changelog Register climate zones Description: - Register climate zones (BA and IECC) based on the simulation EPW file + Register climate zones (BA and IECC) based on the simulation EPW file. This is a pretty simple and straightforward PR: it adds two columns "climate_zone_ba" and "climate_zone_iecc" (based on the epw) to the results csv. Assignees: Joe Robertson @@ -742,7 +753,7 @@ v2.1.0 Changelog Integrity check unit tests Description: - Unit tests and performance improvements for integrity checks + Unit tests and performance improvements for integrity checks. Adds unit tests to make sure that the integrity checks are covering various potential scenarios that would cause errors. Each unit test consists of a housing_characteristics dir with custom TSVs and corresponding options in the test_options_lookup.tsv that should cause the error. The unit tests check that the appropriate error message is hit. Assignees: Scott Horowitz @@ -758,7 +769,7 @@ v2.1.0 Changelog Integrity check performance improvement Description: - Unit tests and performance improvements for integrity checks + Unit tests and performance improvements for integrity checks. Dramatically improves the speed of performing measure argument checks. Rather than checking every combination of option for every parameter that contributes to a single measure's arguments, we now pick options from each parameter in step. Assignees: Scott Horowitz @@ -774,7 +785,7 @@ v2.1.0 Changelog TSV Speed Improvements Description: - Unit tests and performance improvements for integrity checks + Unit tests and performance improvements for integrity checks. This PR substantially speeds up integrity checks for TSVs with large numbers of rows (and has the side benefit of speeding up sampling) by using caching. Assignees: Scott Horowitz diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_0.rst b/docs/read_the_docs/source/changelog/changelog_2_2_0.rst index 0f6b35ef99..ef1999714c 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_0.rst @@ -16,7 +16,7 @@ v2.2.0 Changelog Addresses #344, adjust timeseries csv index for DST Description: - Include additional "daylight saving time" and "utc time" columns to timeseries csv file to account for one hour forward and backward time shifts + Include additional "daylight saving time" and "utc time" columns to timeseries csv file to account for one hour forward and backward time shifts. The TimeseriesCSVExport measure outputs time at a constant interval across a year, regardless of time changes for daylight savings time. This can cause confusion, as E+ shifts schedules to account for DST, but our time output does not line up with this shift. Assignees: Joe Robertson @@ -32,7 +32,7 @@ v2.2.0 Changelog Addresses #344, adjust timeseries csv index for DST Description: - Update each PAT project's AMI selection to "2.9.0" + Update each PAT project's AMI selection to "2.9.0". The TimeseriesCSVExport measure outputs time at a constant interval across a year, regardless of time changes for daylight savings time. This can cause confusion, as E+ shifts schedules to account for DST, but our time output does not line up with this shift. Assignees: Joe Robertson @@ -48,7 +48,7 @@ v2.2.0 Changelog More none no natl avg Description: - Split out national average options so not all homes have all miscellaneous equipment, and add none options to appliances + Split out national average options so not all homes have all miscellaneous equipment, and add none options to appliances. Assignees: Anthony Fontanini @@ -79,7 +79,7 @@ v2.2.0 Changelog Addresses #352, optionally include annual totals for end use subcategories Description: - Custom meters for ceiling fan, hot water recirc pump, and vehicle end use subcategories were not properly implemented + Custom meters for ceiling fan, hot water recirc pump, and vehicle end use subcategories were not properly implemented. Can now optionally report (using the SimulationOutputReport measure) annual totals for end use subcategories (same as for the TimeseriesCSVExport measure) in the results csv. Measure also checks that the sum of the end use subcategories equals the reported interior equipment value. Assignees: Joe Robertson @@ -95,7 +95,7 @@ v2.2.0 Changelog Fixes wood stove upgrade Description: - Allow Wood Stove option as an upgrade, and account for wood heating energy in simulation output + Allow Wood Stove option as an upgrade, and account for wood heating energy in simulation output. I added a bugfix for the upgrade so that the EnergyPlus simulation is successful. Assignees: Scott Horowitz @@ -111,8 +111,8 @@ v2.2.0 Changelog Tsv wall w hcs reformat Description: - Update the single-family detached project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls - [Added the TSV for wall type, masonry and wood. added dependency to the Insulation Wall TSV; additional options for CMU walls(post-1950) and 3" wythe brick wall] + Update the single-family detached project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls. + Added the TSV for wall type, masonry and wood. added dependency to the Insulation Wall TSV; additional options for CMU walls(post-1950) and 3" wythe brick wall. Assignees: Maharshi Pathak @@ -127,8 +127,8 @@ v2.2.0 Changelog Mf renaming w hcs formating Description: - Some re-labeling of tsv files, such as "Geometry Building Type" to "Geometry Building Type RECS" and "Geometry Building Type FPL" to "Geometry Building Type ACS" - [Changes in the naming convention of hcs with the new hcs format included. ] + Some re-labeling of tsv files, such as "Geometry Building Type" to "Geometry Building Type RECS" and "Geometry Building Type FPL" to "Geometry Building Type ACS". + Changes in the naming convention of hcs with the new hcs format included. Assignees: Maharshi Pathak @@ -143,12 +143,13 @@ v2.2.0 Changelog Make housing characteristics format consistent. Description: - Made housing characteristics a consistent format. Added integrity check to ensure housing characteristics follow the guildelines specified in read-the-docs + Made housing characteristics a consistent format. Added integrity check to ensure housing characteristics follow the guildelines specified in read-the-docs. In the effort to make the format more consistent, the following format has been applied to the housing characteristics. Standardizing the format of the housing characteristics should make it easier to see differences in commits - All line terminators are '\r\n' which is consistent with Windows machines. - All Option columns have format '%.6f'. - All [For Reference Only] Source Sample Size columns are type 'int'. - All [For Reference Only] Source Weight columns are type 'int'. + + - All line terminators are '\r\n' which is consistent with Windows machines. + - All Option columns have format '%.6f'. + - All [For Reference Only] Source Sample Size columns are type 'int'. + - All [For Reference Only] Source Weight columns are type 'int'. Assignees: Anthony Fontanini @@ -163,7 +164,7 @@ v2.2.0 Changelog Remove "auto" option for number of occupants Description: - Removes option "Auto" from parameter "Occupants" in the options lookup file + Removes option "Auto" from parameter "Occupants" in the options lookup file. Assignees: Joe Robertson @@ -178,10 +179,10 @@ v2.2.0 Changelog Neighbors update Description: - Update the multifamily project's neighbors and orientation tsv files to have geometry building type dependency; remove the now obsolete "Geometry Is Multifamily Low Rise.tsv" file - Remove Geometry Is Multifamily Low Rise.tsv from all projects, and replace with Geometry Building Type.tsv as a dependency in the multifamily project - Use Geometry Building Type.tsv as dependency for Neighbors.tsv in multifamily project - Use Geometry Building Type.tsv as dependency for Orientation.tsv in multifamily project + Update the multifamily project's neighbors and orientation tsv files to have geometry building type dependency; remove the now obsolete "Geometry Is Multifamily Low Rise.tsv" file. + Remove Geometry Is Multifamily Low Rise.tsv from all projects, and replace with Geometry Building Type.tsv as a dependency in the multifamily project. + Use Geometry Building Type.tsv as dependency for Neighbors.tsv in multifamily project. + Use Geometry Building Type.tsv as dependency for Orientation.tsv in multifamily project. Assignees: Joe Robertson @@ -196,8 +197,8 @@ v2.2.0 Changelog Lighting fixes Description: - Fixes for custom output meters: total site electricity double-counting exterior holiday lighting, and garage lighting all zeroes - Addresses bugs in custom output meters found by @rajeee and @afontani: + Fixes for custom output meters: total site electricity double-counting exterior holiday lighting, and garage lighting all zeroes. + Addresses bugs in custom output meters found by @rajeee and @afontani. Assignees: Joe Robertson @@ -212,7 +213,7 @@ v2.2.0 Changelog RECS 2015 tsv maker Description: - Update bedrooms and occupants tsv files with options and probability distributions based on RECS 2015 data + Update bedrooms and occupants tsv files with options and probability distributions based on RECS 2015 data. Assignees: Joe Robertson @@ -227,7 +228,7 @@ v2.2.0 Changelog Remove shared facades Description: - Remove shared facades tsv files from the multifamily_beta and testing projects + Remove shared facades tsv files from the multifamily_beta and testing projects. Assignees: Joe Robertson @@ -242,7 +243,7 @@ v2.2.0 Changelog Updates to outage measure Description: - Fix for the power outages measure where the last hour of the day was not getting the new schedule applied + Fix for the power outages measure where the last hour of the day was not getting the new schedule applied. It looked like the last hour of the day wasn't getting the new schedule applied. This fixes that. I've also cleaned up some code and added some new unit tests. Assignees: Joe Robertson @@ -258,7 +259,7 @@ v2.2.0 Changelog Update sfd, mf, and testing tsv structure Description: - Separate tsv files for bedrooms, cooking range schedule, corridor, holiday lighting, interior/other lighting use, pool schedule, plug loads schedule, and refrigeration schedule + Separate tsv files for bedrooms, cooking range schedule, corridor, holiday lighting, interior/other lighting use, pool schedule, plug loads schedule, and refrigeration schedule. Assignees: Joe Robertson @@ -273,7 +274,7 @@ v2.2.0 Changelog Report quantities of interest Description: - Add new QOIReport measure for reporting seasonal quantities of interest for uncertainty quantification + Add new QOIReport measure for reporting seasonal quantities of interest for uncertainty quantification. Reporting quantities of interest for EULP uncertainty quantification. Assignees: Joe Robertson @@ -289,7 +290,7 @@ v2.2.0 Changelog Report quantities of interest Description: - Move redundant output meter code from individual reporting measures out into shared resource file + Move redundant output meter code from individual reporting measures out into shared resource file. Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_1.rst b/docs/read_the_docs/source/changelog/changelog_2_2_1.rst index db206b1c22..49ed79db29 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_1.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_1.rst @@ -16,7 +16,7 @@ v2.2.1 Changelog Addresses #386, fix misc pool tsv files and updates project_singlefamilydetached masonry walls Description: - Add generation of the Geometry Wall Type tsv file for the single-family detached project to the 2009 RECS tsv maker; this corrects the tsv file + Add generation of the Geometry Wall Type tsv file for the single-family detached project to the 2009 RECS tsv maker; this corrects the tsv file. Assignees: Joe Robertson @@ -31,8 +31,8 @@ v2.2.1 Changelog Addresses #386, fix misc pool tsv files and updates project_singlefamilydetached masonry walls Description: - Add generation of the Misc Pool tsv file (with Geometry Building Type and Location Region dependencies) to the 2009 RECS tsv maker; this also corrects having pool pumps for all homes - Fix pool pump probabilities + Add generation of the Misc Pool tsv file (with Geometry Building Type and Location Region dependencies) to the 2009 RECS tsv maker; this also corrects having pool pumps for all homes. + Fix pool pump probabilities. Assignees: Joe Robertson @@ -47,8 +47,8 @@ v2.2.1 Changelog Multifamily masonry walls Description: - Update the multifamily project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls - Adding in masonry walls via "Geometry Wall Type" tsv and adding a new dependency in "Insulation Wall". Mimics work done by Maharshi for project_singlefamily. Also created a new tsv_maker for RECS 2009 + Update the multifamily project with a Geometry Wall Type tsv file for sampling between wood stud and masonry walls. + Adding in masonry walls via "Geometry Wall Type" tsv and adding a new dependency in "Insulation Wall". Mimics work done by Maharshi for project_singlefamily. Also created a new tsv_maker for RECS 2009. Assignees: Janet Reyna @@ -63,7 +63,7 @@ v2.2.1 Changelog Multifamily masonry walls Description: - Refactor the RECS tsv makers for years 2009 and 2015 + Refactor the RECS tsv makers for years 2009 and 2015. Assignees: Janet Reyna diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_2.rst b/docs/read_the_docs/source/changelog/changelog_2_2_2.rst index f09d1cfc29..40adf86916 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_2.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_2.rst @@ -16,7 +16,7 @@ v2.2.2 Changelog Release 2_2_2 patch Description: - Update the datapoint initialization script to download weather files to a common zip filename + Update the datapoint initialization script to download weather files to a common zip filename. Current curl command in datapoint init script guaranteed aws s3 downloads to work, but not downloads from other hosts (e.g., dropbox). Changing the curl command to be more generic. Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_3.rst b/docs/read_the_docs/source/changelog/changelog_2_2_3.rst index 8fae39076b..61b12ee337 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_3.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_3.rst @@ -16,7 +16,7 @@ v2.2.3 Changelog Release 2_2_3 patch Description: - Update the weather zip file url in each PAT project to point to data.nrel.gov + Update the weather zip file url in each PAT project to point to data.nrel.gov. Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_4.rst b/docs/read_the_docs/source/changelog/changelog_2_2_4.rst index 54491ab0f7..eb1e996743 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_4.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_4.rst @@ -16,7 +16,7 @@ v2.2.4 Changelog Release 2_2_4 patch Description: - Fix bug in options lookup where buildings without heating systems were not being assigned the required "has_hvac_flue" airflow measure argument + Fix bug in options lookup where buildings without heating systems were not being assigned the required "has_hvac_flue" airflow measure argument. Argument has_hvac_flue for ResidentialAirflow wasn't being assigned when no heating system was sampled. The proposed solution here is to move the has_hvac_flue argument from the ResidentialAirflow measure out into the HVAC equipment measures (furnace, boiler, unit heater, shared systems). The value assigned to has_hvac_flue will be set as an additional property on the Building model object, and then the airflow measure will parse it from the Building model object. If it doesn't exist, then the value will be set to false. diff --git a/docs/read_the_docs/source/changelog/changelog_2_2_5.rst b/docs/read_the_docs/source/changelog/changelog_2_2_5.rst index fac6360ffb..d6a9886f36 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_2_5.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_2_5.rst @@ -16,7 +16,7 @@ v2.2.5 Changelog Release 2_2_5 patch Description: - Update the weather zip file url in each PAT project to point to a different location at data.nrel.gov + Update the weather zip file url in each PAT project to point to a different location at data.nrel.gov. Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_2_3_0.rst b/docs/read_the_docs/source/changelog/changelog_2_3_0.rst index 26b4774ce1..bda949ec78 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_3_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_3_0.rst @@ -16,7 +16,7 @@ v2.3.0 Changelog Rename multifamily_beta to national Description: - Rename "project_multifamily_beta" to "project_national" + Rename "project_multifamily_beta" to "project_national". Assignees: Joe Robertson @@ -31,7 +31,7 @@ v2.3.0 Changelog MSHP pan heater custom meter Description: - Add mini-split heat pump pan heater to custom meter for heating electricity + Add mini-split heat pump pan heater to custom meter for heating electricity. Exclude mshp pan heater from being added to the electric interior equipment meter. Instead, add it to the electric heating meter. Assignees: Joe Robertson @@ -47,7 +47,7 @@ v2.3.0 Changelog fix bug for small window areas Description: - Fix bug in assigning small window areas to surfaces + Fix bug in assigning small window areas to surfaces. @whiphi92 uncovered a bug that would throw an error when the calculated window area of a facade was less than the minimum allowable window area. This fix checks for that case and applies the invalid window area to the largest available surface. Assignees: Andrew Speake @@ -63,7 +63,7 @@ v2.3.0 Changelog Assign daylight saving dates based on County Description: - Assign daylight saving start/end dates based on county and not epw region + Assign daylight saving start/end dates based on county and not epw region. Assign dst_start_date and dst_end_date based on county instead of epw location. This eliminates the possibility of simulating a building without daylight saving dates when it is near, but not within, Arizona. Assignees: Joe Robertson @@ -79,8 +79,8 @@ v2.3.0 Changelog Update ceiling fan options Description: - Update ceiling fan tsv to remove the "National Average" option, and instead sample 28% "None" and 72% "Standard Efficiency" - Update ceiling fan options and tsvs according to: https://trello.com/c/yBmLc3OU/23-ceiling-fans + Update ceiling fan tsv to remove the "National Average" option, and instead sample 28% "None" and 72% "Standard Efficiency". + Update ceiling fan options and tsvs according to: https://trello.com/c/yBmLc3OU/23-ceiling-fans. Assignees: Joe Robertson @@ -95,9 +95,10 @@ v2.3.0 Changelog Specify key value in timeseries reporting Description: - Allow a key value to be specified when outputting timeseries variables + Allow a key value to be specified when outputting timeseries variables. Allows users to specify a key value when requesting timeseries csvs, for example: - output_variables: Surface Outside Face Incident Solar Radiation Rate per Area|Surface 2 outputs the variable for just Surface 2, instead of every surface. + + - output_variables: Surface Outside Face Incident Solar Radiation Rate per Area|Surface 2 outputs the variable for just Surface 2, instead of every surface. Assignees: Andrew Speake @@ -112,12 +113,13 @@ v2.3.0 Changelog Weather file update Description: - Remove Location Weather Filename and Location Weather Year tsvs, and update options lookup to reflect updated weather file changes; weather filenames are now required to match what is in the options lookup + Remove Location Weather Filename and Location Weather Year tsvs, and update options lookup to reflect updated weather file changes; weather filenames are now required to match what is in the options lookup. Presently, to update the weather year files, we would need to make changes to the Location Weather Filename and Location Weather Year tsvs. While this approach is fine with two weather years i.e. TMY3 and AMY weather files presently, it creates a 'ballooning' effect when one begins to add more weather years as the location weather filename tsv will need the addition of 216 EPWs to its rows and columns for each AMY year. To resolve this issue, we: - rename all epw weather filenames such that names are consistent between all years. New location weather filename data can be found here - delete location weather filename and location weather year as the names are now consistent between years - update options lookup tsv by adding weather filename arguments to the location tsv - update options lookup tsv by removing 'location weather filename' and 'location weather year' arguments + + - rename all epw weather filenames such that names are consistent between all years. New location weather filename data can be found here + - delete location weather filename and location weather year as the names are now consistent between years + - update options lookup tsv by adding weather filename arguments to the location tsv + - update options lookup tsv by removing 'location weather filename' and 'location weather year' arguments Assignees: Tobi Adekanye @@ -132,10 +134,11 @@ v2.3.0 Changelog ix qoi report measure to handle locations without a season Description: - Fix bug in QOI reporting measure where absence of any heating/cooling/overlap seasons would cause errors + Fix bug in QOI reporting measure where absence of any heating/cooling/overlap seasons would cause errors. The QOI report measure timing section has two errors: - If there are no days with mean daily temperature above 70F (summer), the measure will fail, as the summer season does not exist. Common in climate zones 7+ - The daily_vals object is comprised of two arrays, and the intent is to get the array length. This fixes the timing reporting in the measure. + + - If there are no days with mean daily temperature above 70F (summer), the measure will fail, as the summer season does not exist. Common in climate zones 7+ + - The daily_vals object is comprised of two arrays, and the intent is to get the array length. This fixes the timing reporting in the measure. Assignees: Matt Dahlhausen, Joe Robertson @@ -150,10 +153,12 @@ v2.3.0 Changelog Roofing material restructure Description: - Restructure unfinished attic and finished roof -related tsv files (i.e., insulation, roof material, and radiant barrier) and options + Restructure unfinished attic and finished roof -related tsv files (i.e., insulation, roof material, and radiant barrier) and options. Previously, we had: - No "None" option for Insulation Unfinished Attic.tsv - Roofing Material.tsv assigned roofing_material arguments for both ResidentialConstructionsUnfinishedAttic and ResidentialConstructionsFinishedRoof + + - No "None" option for Insulation Unfinished Attic.tsv + - Roofing Material.tsv assigned roofing_material arguments for both ResidentialConstructionsUnfinishedAttic and ResidentialConstructionsFinishedRoof + The issue with the previous is that if we try to upgrade just roofing_material, measure ResidentialConstructionsFinishedRoof is applied without all measure arguments specified. By adding the building type dependency to Insulation Unfinished Attic.tsv, Insulation Finished Roof.tsv, and both Roofing Material.tsv files, we can avoid this issue. Assignees: Joe Robertson @@ -169,8 +174,8 @@ v2.3.0 Changelog Update Water Heater=Other Fuel to map to no water heater Description: - Allow a building to be simulated with no water heater; map the "Other Fuel" option from the Water Heater tsv to no water heater - update cw, cd, dw, fixtures, distribution measures to skip when not finding a water heater + Allow a building to be simulated with no water heater; map the "Other Fuel" option from the Water Heater tsv to no water heater. + update cw, cd, dw, fixtures, distribution measures to skip when not finding a water heater. Assignees: Joe Robertson @@ -185,7 +190,7 @@ v2.3.0 Changelog Update Infiltration.tsv based on the Residential Diagnostics Database. Description: - Increase the diversity of the infiltration simulated. Now using the Residential Diagnostics Database for the Infiltration housing characteristic + Increase the diversity of the infiltration simulated. Now using the Residential Diagnostics Database for the Infiltration housing characteristic. The purpose of this pull request is to diversify and update the infiltration housing characteristic. Currently, infiltration is based on the regression from Chan et al. (also based on LBL ResDB). As the regression produces a single infiltration value for a given set of input parameters, the probability distributions specified in the Infiltration.tsv are binary (only 0 and 1). In reality, the distributions are more continuous. In this pull request, the Infiltration.tsv has been updated with data from the Residential Diagnostics Database (ResDB). The cumulative distribution functions (CDFs) for air change at 50 Pa (ACH50) have been downloaded from their website. Each CDF from the website was fit with a lognormal distribution. The fitted lognormal distribution is then used to assign probabilities into the infiltration bins in ResStock. @@ -204,11 +209,11 @@ v2.3.0 Changelog Add wwr variation per RBSA II data Description: - Diversify window to wall ratio variation using the Residential Building Stock Assessment (RBSA) II data + Diversify window to wall ratio variation using the Residential Building Stock Assessment (RBSA) II data. Per comments on that PR and discussion with @mdahlhausen, there are still changes that might happen before merging. - binned WWRs for multifamily and single family buildings from RBSA II data - for calculations, see WWR estimates in EULP calibration directory on sharepoint - Assuming '50 or more Unit' building type is midrise/highrise with default 30% WWR for all buildings + binned WWRs for multifamily and single family buildings from RBSA II data. + for calculations, see WWR estimates in EULP calibration directory on sharepoint. + Assuming '50 or more Unit' building type is midrise/highrise with default 30% WWR for all buildings. resstock-estimation: `pull request 21 `_ @@ -225,7 +230,7 @@ v2.3.0 Changelog Increase floor area diversity Description: - Increase the diversity of the floor areas that are simulated. Geometry House Size has been replaced by Geometry Floor Area Bin and Geometry Floor Area. Now using AHS for specifying the floor area. Floor areas differ by non-Core Based Statistical Areas (CBSAs) Census Divisions and the top 15 largest CBSAs + Increase the diversity of the floor areas that are simulated. Geometry House Size has been replaced by Geometry Floor Area Bin and Geometry Floor Area. Now using AHS for specifying the floor area. Floor areas differ by non-Core Based Statistical Areas (CBSAs) Census Divisions and the top 15 largest CBSAs. The purpose of this pull request is to diversify the floor area values that are simulated in ResStock. There are now two floor area bins housing characteristics, Geometry Floor Area Coarse and Geometry Floor Area Fine. These two housing characteristics are replacing the Geometry House Size housing characteristic. The Geometry Floor Area Coarse characteristics is meant to be used as a dependency for other RECS queries. The small number of bins (as before in Geometry House Size) does not slice RECS into many bins and retains reasonable sample sizes for housing characteristics dependent on Geometry Floor Area Coarse (Geometry Garage, Geometry Stories, Bedrooms, and Infiltration). The Geometry Floor Area Fine are bins based on the American Housing Survey (AHS). To maintain consistency between the two characteristics the bin sizes have been updated in Geometry Floor Area Coarse. The total_ffa and unit_ffa arguments in options_lookup.tsv are obtained from Geometry Floor Area Fine bin averages from RECS 2015. resstock-estimation: `pull request 19 `_ @@ -243,7 +248,7 @@ v2.3.0 Changelog Major appliance sat Description: - Reduce the number of appliances in multifamily units. Adding RECS building type as a dependencies to clothes washers, clothes dryers, dishwashers, refrigerators, extra refrigerators, and stand-alone freezers. Update refrigeration levels based on RECS 2009 age and shipment-weighted efficiency by year. Now using the American Housing Survey (AHS) for clothes washer and clothes dryer saturations. New geographic field, AHS Region, which uses the top 15 largest Core Based Statistical Areas (CBSAs) and Non-CBSA Census Divisions + Reduce the number of appliances in multifamily units. Adding RECS building type as a dependencies to clothes washers, clothes dryers, dishwashers, refrigerators, extra refrigerators, and stand-alone freezers. Update refrigeration levels based on RECS 2009 age and shipment-weighted efficiency by year. Now using the American Housing Survey (AHS) for clothes washer and clothes dryer saturations. New geographic field, AHS Region, which uses the top 15 largest Core Based Statistical Areas (CBSAs) and Non-CBSA Census Divisions. The purpose of this pull request is to reduce the number of appliances in multifamily units. The current assumption is that all units have Dishwashers and Clothes Washers. However multifamily units should have a lower probability of having laundry facilities (in unit) and extra refrigerators and stand-alone freezers. As a result, building type dependency was added to these characteristics and the fraction of units without the appliances is adjusted. Assignees: Anthony Fontanini @@ -259,7 +264,7 @@ v2.3.0 Changelog Update the ResidentialLightingOther schedule in the options_lookup.tsv Description: - Exterior lighting schedule changed from using interior lighting sunrise/sunset algorithm to T24 2016 Residential ACM Appendix C Table 8 Exterior Lighting Hourly Multiplier for weekdays and weekends + Exterior lighting schedule changed from using interior lighting sunrise/sunset algorithm to T24 2016 Residential ACM Appendix C Table 8 Exterior Lighting Hourly Multiplier for weekdays and weekends. The old schedules were from the T24 2016 Residential ACM, except they were using the residential MELS schedule instead of the exterior lighting schedule. This commit updates to use the properly intended exterior lighting schedule instead. See the T24 2016 Residential ACM and the Plug Loads and Lighting Modeling CASE report from Energy Solutions for more information. @@ -276,13 +281,13 @@ v2.3.0 Changelog Update to RECS 2015 Description: - Update occupant and plug loads equations based on RECS 2015 data; replace floor area with occupants as independent variable in plug loads equation; allow modeling of zero-bedroom units (e.g., studios) - To summarize, this: - solves for Nbr (in terms of Nocc) for: - sinks, showers, baths - range, dishwasher, clothes washer, clothes dryer - plug loads, large uncommon loads - replaces plug loads equation with RECS 2015-derived + Update occupant and plug loads equations based on RECS 2015 data; replace floor area with occupants as independent variable in plug loads equation; allow modeling of zero-bedroom units (e.g., studios). + To summarize, this solves for Nbr (in terms of Nocc) for: + + - sinks, showers, baths + - range, dishwasher, clothes washer, clothes dryer + - plug loads, large uncommon loads + - replaces plug loads equation with RECS 2015-derived resstock-estimation: `pull request 12 `_ @@ -299,7 +304,7 @@ v2.3.0 Changelog Fuzzy schedules Description: - Diversify the timing heating and cooling setpoint setbacks + Diversify the timing heating and cooling setpoint setbacks. Smears the Heating and Cooling offset schedules period +- 2hours around existing times. Assignees: Rajendra Adhikari @@ -315,7 +320,7 @@ v2.3.0 Changelog Geospatial Description: - New geospatial characteristics have been added or updated. New geospatial characteristics are as follows: ASHRAE IECC Climate Zone 2004, State, County, PUMA, Census Division, Census Region, Building America Climate Zone, and ISO/RTO Region. The top level housing characteristic is now ASHRAE IECC Climate Zone 2004. Now using data from the American Community Survey Public Use Microdata Sample (ACS PUMS) for Building Type, Vintage, and Heating Fuel + New geospatial characteristics have been added or updated. New geospatial characteristics are as follows: ASHRAE IECC Climate Zone 2004, State, County, PUMA, Census Division, Census Region, Building America Climate Zone, and ISO/RTO Region. The top level housing characteristic is now ASHRAE IECC Climate Zone 2004. Now using data from the American Community Survey Public Use Microdata Sample (ACS PUMS) for Building Type, Vintage, and Heating Fuel. This pull request is aimed at adding some spatial specification of ResStock samples. Currently, there are only two spatial descriptions in the housing characteristics: 1) Location (the epw weather file regions), and 2) Location Region (RECS defined Custom Regions) This pull request creates 10 housing characteristic files that help spatially define the location of a sampled housing unit. Assignees: Anthony Fontanini @@ -331,7 +336,7 @@ v2.3.0 Changelog Chicago AC saturation Description: - Update HVAC System Cooling tsv with air-conditioning saturations ("None", "Room AC", or "Central AC") from American Housing Survey for Custom Region 04. Efficiency probabilities remain based on RECS 2009 + Update HVAC System Cooling tsv with air-conditioning saturations ("None", "Room AC", or "Central AC") from American Housing Survey for Custom Region 04. Efficiency probabilities remain based on RECS 2009. During data source comparison, it was discovered that we probably have cooling saturation too low for Chicago. AHS is probably a better source for cooling saturation that we should use going forward. In the meantime, I pulled AC type saturation from AHS (None, Room AC , Central), and adjusted the distributions for each of these within the HVAC System Cooling tsv, but still using the efficiency breakdowns from RECS. Only CR04 was adjusted for the moment (which includes Chicago), using East North Central as an approximation for CR04 (the difference is the state of Wisconsin). In the future, we should probably separate saturation from efficiency in separate TSVs so we can use AHS for saturation and RECS for efficiency. Assignees: Janet Reyna @@ -347,8 +352,8 @@ v2.3.0 Changelog Geospatial Description: - Removed the "Geometry Unit Stories SF" and "Geometry Unit Stories MF" housing characteristics. Unit stories are instead represented by the "Geometry Stories" housing characteristic - This pull request is aimed at adding some spatial specification of ResStock samples. Currently, there are only two spatial descriptions in the housing characteristics: 1) Location (the epw weather file regions), and 2) Location Region (RECS defined Custom Regions) This pull request creates 10 housing characteristic files that help spatially define the location of a sampled housing unit + Removed the "Geometry Unit Stories SF" and "Geometry Unit Stories MF" housing characteristics. Unit stories are instead represented by the "Geometry Stories" housing characteristic. + This pull request is aimed at adding some spatial specification of ResStock samples. Currently, there are only two spatial descriptions in the housing characteristics: 1) Location (the epw weather file regions), and 2) Location Region (RECS defined Custom Regions) This pull request creates 10 housing characteristic files that help spatially define the location of a sampled housing unit. Assignees: Anthony Fontanini @@ -363,11 +368,11 @@ v2.3.0 Changelog Addresses #403, remove redundant enduses Description: - Exclude net site energy consumption from annual and timeseries simulation output ("total" now reflects net of pv); change `include_enduse_subcategories` argument default to "true"; report either total interior equipment OR each of its components - Remove all the net site columns - Leave total columns for both true and false - Total columns become net of pv - Change the default of include_enduse_subcategories from false to true + Exclude net site energy consumption from annual and timeseries simulation output ("total" now reflects net of pv); change `include_enduse_subcategories` argument default to "true"; report either total interior equipment OR each of its components. + Remove all the net site columns. + Leave total columns for both true and false. + Total columns become net of pv. + Change the default of include_enduse_subcategories from false to true. Assignees: Joe Robertson @@ -382,7 +387,7 @@ v2.3.0 Changelog Ignore comment lines Description: - Add ability to ignore comment lines with the "#" symbol + Add ability to ignore comment lines with the "#" symbol. This pull request is an effort to make the housing characteristics more machine-readable. The created by line is causing issues when reading the files programmatically. The resolution is that we have ResStock ignore comment lines. The comment lines begin with the "#" symbol. Assignees: Anthony Fontanini @@ -398,7 +403,7 @@ v2.3.0 Changelog adding in diversity to MF roof insulation. Description: - Update Insulation Finished Attic tsv with more options for insulation levels + Update Insulation Finished Attic tsv with more options for insulation levels. Improve diversity for MF roof insulation by manually copying SF roof insulation (from Insulation Unfinished Attic). In the future, script NAHB / RBSA to pull MF distribution and also improve attic / non-attic split. Assignees: Janet Reyna @@ -414,8 +419,7 @@ v2.3.0 Changelog revert national average plug load schedule to RBSAM-derived schedule,… Description: - Revert plug load schedule to RBSA for the National Average option - … which had accidentally been changed to CA Title 24 – CASE Plug Loads and Lighting Schedule + Revert plug load schedule to RBSA for the National Average option, which had accidentally been changed to CA Title 24 – CASE Plug Loads and Lighting Schedule. Assignees: Eric Wilson @@ -430,7 +434,7 @@ v2.3.0 Changelog Remove single-family detached, PAT projects Description: - Remove the single-family detached project, and remove PAT from the testing and multifamily projects + Remove the single-family detached project, and remove PAT from the testing and multifamily projects. Assignees: Joe Robertson @@ -445,8 +449,8 @@ v2.3.0 Changelog Move data folder into resstock-estimation Description: - Relocate the data folder, along with tsv makers, to a separate private repository - Folder data moved here: https://github.com/NREL/resstock-estimation + Relocate the data folder, along with tsv makers, to a separate private repository. + Folder data moved here: https://github.com/NREL/resstock-estimation. Assignees: Joe Robertson @@ -461,7 +465,7 @@ v2.3.0 Changelog Update lighting distribution. Description: - Update the single-family detached and multifamily projects with more up-to-date lighting stock distributions + Update the single-family detached and multifamily projects with more up-to-date lighting stock distributions. The old lighting distribution is weighted too heavily towards incandescent bulbs. New distribution data is from 2015 in the 2015 U.S. Lighting Market Characterization study. Option= 100% Incandescent include Incandescent, HID, Halogen, and Other. Option=100% CFL include CFL and LFL. Option=100% LED include LED. Assignees: Anthony Fontanini @@ -477,7 +481,7 @@ v2.3.0 Changelog Update lighting distribution. Description: - Refactor the tsv maker classes to accommodate more data sources + Refactor the tsv maker classes to accommodate more data sources. The old lighting distribution is weighted too heavily towards incandescent bulbs. New distribution data is from 2015 in the 2015 U.S. Lighting Market Characterization study. Option= 100% Incandescent include Incandescent, HID, Halogen, and Other. Option=100% CFL include CFL and LFL. Option=100% LED include LED. Assignees: Anthony Fontanini diff --git a/docs/read_the_docs/source/changelog/changelog_2_4_0.rst b/docs/read_the_docs/source/changelog/changelog_2_4_0.rst index 21757b6aa4..b659805146 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_4_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_4_0.rst @@ -16,7 +16,7 @@ v2.4.0 Changelog Fix: Effective R Value Calculation for HVAC Sizing Description: - Calculate slab surface effective R values used in HVAC sizing with unit-level variables + Calculate slab surface effective R values used in HVAC sizing with unit-level variables. Fixes how the effective R value of a slab is calculated for use in the HVAC sizing measure. The effective R values were previously calculated use the slab area of the entire building footprint and the exposed perimeter of the individual unit, causing the R value to scale incorrectly with larger buildings. This calculates the R value using variables specific to the unit, not the building. Assignees: Andrew Speake @@ -32,7 +32,7 @@ v2.4.0 Changelog Feature/weather infrastructure Description: - Allow for flexible weather regions based on weather data available and introduce TMY3 weather files for the new weather format + Allow for flexible weather regions based on weather data available and introduce TMY3 weather files for the new weather format. This PR generalizes the weather data available for a given AMY or TMY analysis. ResStock currently uses 941 static weather stations. The stations are used based on the Location.tsv. resstock-estimation: `pull request 95 `_ @@ -50,7 +50,7 @@ v2.4.0 Changelog Bugfix for DST start hour and end date. Description: - Fix DST start hour error and end date error + Fix DST start hour error and end date error. The PR fixes 2 issues with the current calculation of DST time column. Currently, DST spring forward occurs at 1:00 AM standard time. The time jumps from 0:59 to 2:00. It should jump from 1:59 to 3:00 instead. This fixes the problem. The DST end date is currently one day behind what's specified in the options_lookup or weather file. This PR also fixes that. @@ -69,7 +69,7 @@ v2.4.0 Changelog Update duct related calcs in airflow.rb Description: - Update the duct leakage "total" to "to outside" conversion to be based on ASHRAE Standard 152 + Update the duct leakage "total" to "to outside" conversion to be based on ASHRAE Standard 152. Addresses https://trello.com/c/VmcGehGM/62-duct-leakage-total. Assignees: Joe Robertson @@ -85,7 +85,7 @@ v2.4.0 Changelog Change to UTC time calculations to avoid DST messing things up Description: - Fix bug related to incorrect timestamps when using AMY weather file + Fix bug related to incorrect timestamps when using AMY weather file. Resolves the issue of timestamps being incorrect around the DST switchover time when using AMY weather files. Assignees: Rajendra Adhikari @@ -101,7 +101,7 @@ v2.4.0 Changelog Report supplemental electric heating Description: - Separate heat pump electric supplemental heating from total electric heating in output reporting + Separate heat pump electric supplemental heating from total electric heating in output reporting. Break "supplemental electric heating" out of "electric heating". This is important for heat pump analysis. @@ -118,7 +118,7 @@ v2.4.0 Changelog Fix: All buildings have double-loaded corridors Description: - In the Corridor.tsv, assign single-family attached, single-family detached, and mobile homes with a "Not Applicable" option + In the Corridor.tsv, assign single-family attached, single-family detached, and mobile homes with a "Not Applicable" option. In the project_national/housing_characteristics/Corridor.tsv, all buildings are assigned a "Double-Loaded Corridor." However, the single-family detached, mobile homes, and single-family attached buildings do not have corridors. For single-family detached, mobile homes, and single-family attached buildings, measures/BuildExistingModel/measure.rb removes the calls to the ResidentialGeometryCreateMultifamily measure. Assignees: Anthony Fontanini @@ -134,7 +134,7 @@ v2.4.0 Changelog Make sure vacant units have zero ceiling fan energy Description: - Remove ceiling fan energy for vacant units + Remove ceiling fan energy for vacant units. Vacant units currently have ceiling fan energy. This PR introduces an option where the ceiling fan energy is zero. The ratio of ceiling fans is kept the same, so 72% of units have ceiling fans for either occupied or vacant units. This ensures the counts of ceiling fans are consistent, but vacant units have no ceiling fan energy. Assignees: Anthony Fontanini @@ -150,7 +150,7 @@ v2.4.0 Changelog Fix surface area reporting for collapsed buildings Description: - Fix for calculating door and below-grade wall area of multifamily and single-family attached buildings with collapsed geometries + Fix for calculating door and below-grade wall area of multifamily and single-family attached buildings with collapsed geometries. Fixes below grade wall and door area calculations in SimulationOutputReport when minimal_collapsed = true for MF and SFA buildings. Previously, units_represented was not used to scale foundation wall or door area, and therefore areas were underestimated when building geometries were collapsed. Assignees: Andrew Speake @@ -166,7 +166,7 @@ v2.4.0 Changelog Feature/water heater update Description: - Introduce premium water heaters and heat pump water heaters into building stock, differentiate between central and in-unit water heating, and split water heater fuel and efficiency into different housing characteristics + Introduce premium water heaters and heat pump water heaters into building stock, differentiate between central and in-unit water heating, and split water heater fuel and efficiency into different housing characteristics. This pull request updates the water heater housing characteristics. resstock-estimation: `pull request 87 `_ @@ -184,7 +184,7 @@ v2.4.0 Changelog Account for collapsed units when determining geometry variables for infiltration calculation Description: - Account for collapsed units when determining geometry variables (building floor/wall area and volume) in infiltration calculations; add airflow unit tests + Account for collapsed units when determining geometry variables (building floor/wall area and volume) in infiltration calculations; add airflow unit tests. Fixes how geometry variables (building ffa, building volume, and building exterior wall area) are calculated in the Airflow.rb measure when minimal_collapsed == True. The "collapsed" units were not originally accounted for when determining these variables, influencing the calculated leakage area at each unit. This changes the infiltration and HVAC sizing in SFA buildings, and most likely MF buildings as well. Assignees: Andrew Speake @@ -200,7 +200,7 @@ v2.4.0 Changelog Multiplier updates to plug load measure Description: - Allow for plug load energy consumption to vary by Census Division and include additional "diversity" multiplier in plug load equations + Allow for plug load energy consumption to vary by Census Division and include additional "diversity" multiplier in plug load equations. This pull request separates out multipliers meant to adjust total energy and multipliers meant to adjust diversity of the results. The ResidentialMiscPlugLoads argument mult has been split into two multipliers (energy_mult and diversity_mult). The energy multiplier now allows the plug load energy use to vary with building type and RECS 2015 definition of Census Division (the Mountain division is split into North and South). The diversity_mult argument is simply the same as the previous definition of mult. @@ -220,7 +220,7 @@ v2.4.0 Changelog Add spatial and building type dependencies to lighting saturations Description: - Lighting saturations based on RECS 2015 with new building type and spatial dependencies + Lighting saturations based on RECS 2015 with new building type and spatial dependencies. This pull request updates the Lighting.tsv to include dependencies on building type and RECS 2015 definition of Census Division. The RECS 2015 definition of Census division is similar to the U.S. Census definition, except RECS breaks out the Mountain Census Division into a North and South Subdivision. resstock-estimation: `pull request 84 `_ @@ -238,7 +238,7 @@ v2.4.0 Changelog Add monthly multiplier for cooking, clothes washer, clothes dryer, and dishwasher Description: - Reintroduce monthly multipliers with stochastic load model for dishwasher, clothes washer and clothes dryer and cooking + Reintroduce monthly multipliers with stochastic load model for dishwasher, clothes washer and clothes dryer and cooking. The cooking schedule was previously (before the ResidentialScheduleGenerator was introduced) generated using weekend, weekday, and monthly multiplier schedule. Currently, they are generated using the Markov-chain by the ResidentialScheduleGenerator. This pull request adds monthly multipliers to the schedule so generated. Assignees: Rajendra Adhikari @@ -254,7 +254,7 @@ v2.4.0 Changelog Number of occupants based on PUMS Description: - Update Occupants per unit from RECS 2015 to PUMS 5-yr 2017 + Update Occupants per unit from RECS 2015 to PUMS 5-yr 2017. This pull request updates the number of occupants (that gets passed into the stochastic load generator) from RECS 2015 to PUMS 5-yr 2017. The switch to PUMS allows PUMA level spatial granularity in the distributions and leverages more than 6 million samples. Assignees: Anthony Fontanini @@ -270,7 +270,7 @@ v2.4.0 Changelog ResStock/ComStock weather syncronization Description: - Synchronize weather between ResStock and ComStock which increases the number of weather stations from 215 to 941 + Synchronize weather between ResStock and ComStock which increases the number of weather stations from 215 to 941. This pull request synchronizes the weather files for both ResStock and ComStock. Currently, ResStock uses 215 weather regions defined by county. ComStock uses 941 weather files also defined by county. For applications (especially GEB applications) where combined results from ResStock and ComStock are desired, it is important that the residential and commercial models use the same weather data. This way both residential and commercial models respond to hot days, cold days, rainy days together to predict more accurate combined loads. resstock-estimation: `pull request 58 `_ @@ -288,7 +288,7 @@ v2.4.0 Changelog Update Geometry Foundation Type to be Based on RECS Description: - Update foundation type from the [Building Foundation Design Handbook](https://www.osti.gov/biblio/6980439-building-foundation-design-handbook) published in 1988 to RECS 2009 + Update foundation type from the [Building Foundation Design Handbook](https://www.osti.gov/biblio/6980439-building-foundation-design-handbook) published in 1988 to RECS 2009. This pull request updates the Geometry Foundation Type.tsv from the "Building Foundation Design Handbook" published in 1988 to RECS 2009. The new TSV has dependencies on IECC Climate and Moisture regions and Vintage ACS. resstock-estimation: `pull request 63 `_, `pull request 73 `_ @@ -306,7 +306,7 @@ v2.4.0 Changelog Add IECC zone dependency to HVAC Cooling Type and some minor heat pump fixes Description: - Reintroduce IECC climate zone dependency to HVAC Cooling Type and some heat pump fixes + Reintroduce IECC climate zone dependency to HVAC Cooling Type and some heat pump fixes. Addresses #64 by adding IECC zone as a dependency. Lumping some of the other dependencies to bring up sample sizes. Increased from ~47% to 60% rows with fewer than 10 samples, but overall I think it is a net improvement. resstock-estimation: `pull request 67 `_ @@ -324,7 +324,7 @@ v2.4.0 Changelog Internal gain calcs for sizing updates/fixes Description: - For the purpose of calculating cooling and dehumidification loads for HVAC sizing, use simple internal gains equation from ANSI/RESNET/ICC 301 (consistent with HPXML workflow); this fixes a bug introduced in [#348](https://github.com/NREL/resstock/pull/348) that caused cooling capacities to be ~3x larger than they should be + For the purpose of calculating cooling and dehumidification loads for HVAC sizing, use simple internal gains equation from ANSI/RESNET/ICC 301 (consistent with HPXML workflow); this fixes a bug introduced in [#348](https://github.com/NREL/resstock/pull/348) that caused cooling capacities to be ~3x larger than they should be. Updates to be consistent with how the hpxml workflow processes internal gains. Assignees: Joe Robertson @@ -340,7 +340,7 @@ v2.4.0 Changelog Update partition wall area calculation for MF and SFA buildings Description: - Exclude existing shared walls when calculating the partition wall area of MF and SFA buildings + Exclude existing shared walls when calculating the partition wall area of MF and SFA buildings. Updates how partition wall surface area is calculated so that shared walls in MF and SFA buildings do not count as existing partition wall mass. This means that MF and SFA building partition walls are now calculated the same as SFD buildings - as a direct proportion of the finished floor area. Assignees: Andrew Speake @@ -356,7 +356,7 @@ v2.4.0 Changelog Fix/vacant units Description: - Update spatial distribution of units based on total dwelling unit counts rather than occupied unit counts + Update spatial distribution of units based on total dwelling unit counts rather than occupied unit counts. After talking with @TobiAdekanye, we realized that the spatial distribution of dwelling units are based on only the occupied dwelling units. When the vacant units were pulled into ResStock, the TSV creation functions in sources/spatial/tsv_maker.py in the resstock-estimation repository should have been updated to acs_count instead of acs_occupied_count. This was an oversight when I merged in the Vacant Units. resstock-estimation: `pull request 56 `_ @@ -374,7 +374,7 @@ v2.4.0 Changelog Roofing material options and tsvs updates Description: - Increase roofing material options; update roofing material tsv files to include these new options + Increase roofing material options; update roofing material tsv files to include these new options. Expand roof material options and update related tsv files. Assignees: Joe Robertson @@ -390,7 +390,7 @@ v2.4.0 Changelog HVAC tsv restructuring Description: - Restructure HVAC housing characteristics to 1) simplify the structure, 2) allow for integrating more local data sources, 3) update reference years for HVAC and refrigerator ages and efficiencies from 2009 to 2018, 4) add assumption comments to all HVAC-related housing characteristics, 5) improve Room AC efficiency distributions using ENERGY STAR saturation data, and 6) fix some incorrect assignment of Option=None heating systems + Restructure HVAC housing characteristics to 1) simplify the structure, 2) allow for integrating more local data sources, 3) update reference years for HVAC and refrigerator ages and efficiencies from 2009 to 2018, 4) add assumption comments to all HVAC-related housing characteristics, 5) improve Room AC efficiency distributions using ENERGY STAR saturation data, and 6) fix some incorrect assignment of Option=None heating systems. We have an inordinate number of tsvs presently describing the hvac systems in OpenStudio-BuildStock. This PR reorders and merges existing hvac tsvs while preserving the necessary interactions. The major changes to structure are to move from multiple heating fuel-specific efficiency TSV files to a single TSV for heating efficiencies. The "Is Heat Pump" TSV is also expanded to include ducted/non-ducted options for use as an interim dependency. resstock-estimation: `pull request 32 `_ @@ -408,7 +408,7 @@ v2.4.0 Changelog Addresses #479, garage zone infiltration not always added to model Description: - Iterate all spaces in a thermal zone when checking for zone type; fixes missing infiltration for protruding garages in 1-story homes + Iterate all spaces in a thermal zone when checking for zone type; fixes missing infiltration for protruding garages in 1-story homes. For 1-story, SFD homes with protruding garages, we expect an effective leakage area object added to the model for the garage and garage attic spaces, as shown below. However, these only get added about half of the time. Assignees: Joe Robertson @@ -424,7 +424,7 @@ v2.4.0 Changelog Introduce Vacant Units Description: - Distinguish between vacant and occupied dwelling units using PUMS data + Distinguish between vacant and occupied dwelling units using PUMS data. The purpose of the pull request is to introduce vacant units into the residential stock. This work was motivated by the following maps that shows the fraction of vacant units by building type and PUMA. resstock-estimation: `pull request 36 `_ @@ -458,7 +458,7 @@ v2.4.0 Changelog Separate plug load equations for SFD, SFA, MF Description: - Based on RECS 2015, separate the plug load equations for single-family detached, single-family attached, and multifamily buildings + Based on RECS 2015, separate the plug load equations for single-family detached, single-family attached, and multifamily buildings. Using RECS 2015 a multilinear regression is performed to determine the annual MELS for ResStock. The dependent variables are the number of occupants (noccupants) and the finished floor area (ffa) of the dwelling unit. The MELS definition is a combination of microwave, television, humidifiers, and other devices. The RECS fields for these variables are KWHMICRO, KWHTVREL, KWHHUM, and KWHNEC, respectively. resstock-estimation: `pull request 45 `_ @@ -476,7 +476,7 @@ v2.4.0 Changelog Update Setpoint and Setpoint Schedule Distributions Description: - Update the dependencies for heating and cooling setpoint tsvs (Setpoint, Has Offset, Offset Magnitude, and Offset Period) to IECC climate zone + Update the dependencies for heating and cooling setpoint tsvs (Setpoint, Has Offset, Offset Magnitude, and Offset Period) to IECC climate zone. Updates the thermostat heating and cooling setpoint distributions (setpoint, has offset, offset magnitude, offset schedule) to be dependent on IECC climate zone instead of AIA zone. Assignees: Andrew Speake @@ -492,7 +492,7 @@ v2.4.0 Changelog Feature/heating fuel puma Description: - Update heating fuel distributions to be by Public Use Microdata Area (PUMA) rather than State + Update heating fuel distributions to be by Public Use Microdata Area (PUMA) rather than State. This pull request modifies the state level description of Heating Fuel type to PUMA. See the graphics below for modifications of heating fuel types. The data is based on PUMS 5-yr 2016, and for sample sizes that are less than 10, the state average is used. resstock-estimation: `pull request 49 `_ @@ -510,7 +510,7 @@ v2.4.0 Changelog Generate schedule csv on the fly and use Schedule:File objects on its columns Description: - Major change to most occupant-related schedules. Occupant activities are now generated on-the-fly and saved to .csv files used by Schedule:File objects. Schedules are generated using time-inhomogenous Markov chains derived from American Time Use Survey data, supplemented with sampling duration and power level from NEEA RBSA data, as well as DHW draw duration and flow rate data from Aquacraft/AWWA data [(see pre-print for details)](https://arxiv.org/abs/2111.01881) + Major change to most occupant-related schedules. Occupant activities are now generated on-the-fly and saved to .csv files used by Schedule:File objects. Schedules are generated using time-inhomogenous Markov chains derived from American Time Use Survey data, supplemented with sampling duration and power level from NEEA RBSA data, as well as DHW draw duration and flow rate data from Aquacraft/AWWA data [(see pre-print for details)](https://arxiv.org/abs/2111.01881). The Stochastic Occupancy Modelling introduces major change to most occupant-related schedules. Occupant activities are now generated on-the-fly and saved to .csv files used by Schedule:File objects. Schedules are generated using time-inhomogenous Markov chains derived from American Time Use Survey data, supplemented with sampling duration and power level from NEEA RBSA data, as well as DHW draw duration and flow rate data from Aquacraft/AWWA data. Assignees: Joe Robertson, Rajendra Adhikari @@ -526,7 +526,7 @@ v2.4.0 Changelog Report peak kw Description: - Report the annual peak use and timing using the quantities of interest measure + Report the annual peak use and timing using the quantities of interest measure. Report peak use and timing using the QOIReport measure. Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_2_5_0.rst b/docs/read_the_docs/source/changelog/changelog_2_5_0.rst index 3d9a9816f6..7c6a206599 100644 --- a/docs/read_the_docs/source/changelog/changelog_2_5_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_2_5_0.rst @@ -16,7 +16,7 @@ v2.5.0 Changelog Update national project YAMLs with unit counts from ACS 2019 5-year Description: - Update the number of units represented in the national project YAML files to the American Community Survey 2019 5-year estimate + Update the number of units represented in the national project YAML files to the American Community Survey 2019 5-year estimate. In the YAML files, the n_buildings_represented was 110,000,000. This estimate is a bit low compared to the ACS 2019 5-year estimate of 136,569,411. This PR updates the YAML files to include the ACS 2019 5-year estimate of the number of housing units. @@ -33,7 +33,7 @@ v2.5.0 Changelog Finished Roof Bugfix Description: - Properly apply roof insulation when the attic type is Finished Attic or Cathedral Ceilings + Properly apply roof insulation when the attic type is Finished Attic or Cathedral Ceilings. Insulation Roof options are not applying insulation correctly because attic spaces are modeled as unfinished, and no applicable surfaces are found in the ResidentialConstructionsFinishedRoof measure. This PR applies roof insulation via the ResidentialConstructionsUnfinishedAttic instead. This keeps attic spaces modeled as unfinished, correctly applies insulation, and better aligns with the resstock-hpxml attic construction. @@ -50,7 +50,7 @@ v2.5.0 Changelog ServerDirectoryCleanup debug argument Description: - Add arguments to the ServerDirectoryCleanup measure for controlling deletion of files in the run folder + Add arguments to the ServerDirectoryCleanup measure for controlling deletion of files in the run folder. Setting to true would set all "retain" arguments to true. Assignees: Joe Robertson @@ -66,8 +66,8 @@ v2.5.0 Changelog ResStock-HPXML: Emissions calculations (e.g., CO2) Description: - Add ability to calculate emissions for various scenarios - ResStock-HPXML: CO2 Emissions calculations + Add ability to calculate emissions for various scenarios. + ResStock-HPXML: CO2 Emissions calculations. Assignees: Joe Robertson @@ -82,7 +82,7 @@ v2.5.0 Changelog Backport unit conversion bugfixes for solar hot model from OS-HPXML Description: - Fixes unit conversion bugs in solar hot water model + Fixes unit conversion bugs in solar hot water model. Assignees: Scott Horowitz @@ -97,7 +97,7 @@ v2.5.0 Changelog Backport material properties from ResStock-HPXML Description: - Fixes for wall constructions: remove wood sheathing on CMU and brick walls; better data for exterior finish absorptances and wall densities + Fixes for wall constructions: remove wood sheathing on CMU and brick walls; better data for exterior finish absorptances and wall densities. Update exterior finish absorptance and wall density values to align with ResStock-HPXML values. Also removes sheathing layer from CMU and brick wall types. Assignees: Andrew Speake @@ -113,30 +113,12 @@ v2.5.0 Changelog add geometry_story_bin, add story_bin as dependency to geometry_wall_type Description: - Add Geometry Story Bin tsv and Geometry Story Bin dependency to Geometry Wall Type + Add Geometry Story Bin tsv and Geometry Story Bin dependency to Geometry Wall Type. + Revert wall type constraint that assumes all brick facades built >1960 are wood-framed with 4" face brick. Also add constraint to force all buildings > 8 stories to have steel-framed wall type. Resolves: - #[https://github.com/Missing building height dependency in Geometry Wall Type resstock-estimation#175] - #[https://github.com/Higher than expected brick %s in wall type in recent vintages resstock-estimation#145] - reverting fix for high brick %s in newer vintages - - resstock-estimation: `pull request 177 `_ - - Assignees: Lixi Liu - - - .. change:: - :tags: characteristics, envelope, bugfix - :pullreq: 759 - - **Date**: 2021-11-17 - - Title: - add geometry_story_bin, add story_bin as dependency to geometry_wall_type - - Description: - Revert wall type constraint that assumes all brick facades built >1960 are wood-framed with 4" face brick. Also add constraint to force all buildings > 8 stories to have steel-framed wall type - Resolves: - #[https://github.com/Missing building height dependency in Geometry Wall Type resstock-estimation#175] - #[https://github.com/Higher than expected brick %s in wall type in recent vintages resstock-estimation#145] - reverting fix for high brick %s in newer vintages + + - Missing building height dependency in Geometry Wall Type (resstock-estimation#175) + - Higher than expected brick %s in wall type in recent vintages (resstock-estimation#145) - reverting fix for high brick %s in newer vintages resstock-estimation: `pull request 177 `_ @@ -153,8 +135,8 @@ v2.5.0 Changelog IECC Zone argument for ResidentialLocation Description: - Add optional argument to ResidentialLocation measure for setting the IECC climate zone - Backport water heater location logic (based on IECC zone) + Add optional argument to ResidentialLocation measure for setting the IECC climate zone. + Backport water heater location logic (based on IECC zone). Assignees: Joe Robertson @@ -169,7 +151,7 @@ v2.5.0 Changelog Fix unmet hours Description: - Fixes hours setpoint not met output to exclude A) no heating and/or cooling equipment and B) finished basements + Fixes hours setpoint not met output to exclude A) no heating and/or cooling equipment and B) finished basements. Excludes reported unmet hours for A) no heating and/or cooling equipment and B) finished basements. Assignees: Scott Horowitz @@ -185,7 +167,7 @@ v2.5.0 Changelog Disaggregate fan coil fan energy use Description: - Disaggregate the shared fan coil's fan energy use into heating and cooling + Disaggregate the shared fan coil's fan energy use into heating and cooling. Was previously all lumped into ElectricityFansCooling with a FIXME. Assignees: Joe Robertson @@ -201,7 +183,7 @@ v2.5.0 Changelog add PV distributions Description: - Add PV ownership and PV system size distributions using 2019 Tracking the Sun and GTM report on solar installation + Add PV ownership and PV system size distributions using 2019 Tracking the Sun and GTM report on solar installation. This PR introduces PV systems into ResStock. Assignees: Lixi Liu @@ -217,7 +199,7 @@ v2.5.0 Changelog Update mechanical ventilation Description: - Updates mechanical ventilation options/model to ASHRAE 62.2-2019 and adds a "Flow Rate, Mechanical Ventilation (cfm)" output + Updates mechanical ventilation options/model to ASHRAE 62.2-2019 and adds a "Flow Rate, Mechanical Ventilation (cfm)" output. Updates mechanical ventilation to ASHRAE 62.2-2019. This affects both the Qfan requirement for a mechanical ventilation system as well as how mechanical ventilation interacts with infiltration on a timestep basis. Also adds a 'Flow Rate, Mechanical Ventilation (cfm)' cost multiplier. Assignees: Scott Horowitz @@ -233,7 +215,7 @@ v2.5.0 Changelog Clean up ServerDirectoryCleanup measure Description: - Add arguments to the ServerDirectoryCleanup measure for controlling deletion of files in the run folder + Add arguments to the ServerDirectoryCleanup measure for controlling deletion of files in the run folder. Update this measure to have arguments for including/excluding files in the run directory. Would need to update the buildstockbatch workflow generator to accommodate this. Assignees: Joe Robertson @@ -249,7 +231,7 @@ v2.5.0 Changelog Exclude corridor doors in door area cost multiplier Description: - Exclude adiabatic doors when outputting the door area cost multiplier + Exclude adiabatic doors when outputting the door area cost multiplier. Backports approach used by OS-HPXML, in which adiabatic doors are not included in the door area cost multiplier output. Assignees: Andrew Speake @@ -265,7 +247,7 @@ v2.5.0 Changelog Update infiltration Description: - Updates infiltration model pressure coefficient + Updates infiltration model pressure coefficient. Changes the pressure coefficient from 0.67 to 0.65 for consistency with OS-HPXML. Also updates a water heater option's flue input to be consistent with the OS-HPXML default logic. Assignees: Scott Horowitz @@ -281,7 +263,7 @@ v2.5.0 Changelog Adjust interior shading assumptions Description: - Reduces window interior shading during Winter to match ANSI/RESNET/ICC 301 assumption + Reduces window interior shading during Winter to match ANSI/RESNET/ICC 301 assumption. Changes to winter interior shading factor = 85% instead of 70%, per ANSI/RESNET/ICC 301 Standard. Assignees: Scott Horowitz @@ -297,7 +279,7 @@ v2.5.0 Changelog Update ceiling fan model Description: - Updates ceiling fan model based on ANSI/RESNET ICC 301 assumptions + Updates ceiling fan model based on ANSI/RESNET ICC 301 assumptions. Backports the ceiling fan model from OS-HPXML, which is based on ANSI/RESNET/ICC 301. Assignees: Scott Horowitz @@ -313,7 +295,7 @@ v2.5.0 Changelog Hot water recirc pump bugfix, take 2 Description: - Fixes hot water distribution internal gains not being zeroed out during vacancies + Fixes hot water distribution internal gains not being zeroed out during vacancies. Follow-up to #646. It turns out that the recirculation pump was correctly reflecting the vacancy status for a unit, so that code is reverting. While making the change, I noticed that the internal gains associated with the hot water distribution system were not being zeroed out for vacant units, so that is fixed here too Assignees: Scott Horowitz @@ -345,7 +327,7 @@ v2.5.0 Changelog Add more descriptive window options Description: - Update window type distributions using RECS 2015. Includes additional of frame material types (RECS 2015) and presence of storm windows (D&R International) + Update window type distributions using RECS 2015. Includes additional of frame material types (RECS 2015) and presence of storm windows (D&R International). The previous limited description of windows caused a lack of variation in U-value and solar gains for windows resstock-estimation: `pull request 140 `_ @@ -363,12 +345,14 @@ v2.5.0 Changelog Water Heater GEB Description: - Introduce GEB capabilities for water heaters, including the ability to schedule setpoint and HPWH operating mode + Introduce GEB capabilities for water heaters, including the ability to schedule setpoint and HPWH operating mode. Adding in new GEB related features, including: - Allowing tanks to use either a mixed or stratified tank model (additional user argument) - Allowing setpoint to follow an hourly (8760) schedule rather than only fixed values. - Allowing HPWH operating mode to be scheduled (either "HP Only" or "standard"). This allows the elements to be disabled during peak periods. - Adding unmet shower (an unmet load metric for WHs) calculations into ResStock runs to quantify any unmet WH loads. + + - Allowing tanks to use either a mixed or stratified tank model (additional user argument) + - Allowing setpoint to follow an hourly (8760) schedule rather than only fixed values. + - Allowing HPWH operating mode to be scheduled (either "HP Only" or "standard"). This allows the elements to be disabled during peak periods. + - Adding unmet shower (an unmet load metric for WHs) calculations into ResStock runs to quantify any unmet WH loads. + In addition to these GEB features, a few new HPWH options, corresponding the AO Smith's current product line, are added to options lookup as potential upgrade options. resstock-estimation: `pull request 150 `_ @@ -386,7 +370,6 @@ v2.5.0 Changelog WWR calculation for facades w/ doors Description: - Fixes window-to-wall ratio calculation for facades with doors Fixes window-to-wall ratio calculation for facades with doors. Previously if a facade had a door, the WWR would be applied to the net wall area instead of gross wall area. Added a unit test that demonstrates the fix -- previously the front window area was 95.6 ft2, now it's 100 ft2 and matches the results from ResStock-HPXML. Assignees: Scott Horowitz @@ -402,8 +385,8 @@ v2.5.0 Changelog HP defrost control Description: - Changes heat pump defrost control from OnDemand to Timed - Backports NREL/OpenStudio-HPXML#403 + Changes heat pump defrost control from OnDemand to Timed. + Backports NREL/OpenStudio-HPXML#403. Assignees: Scott Horowitz @@ -418,11 +401,11 @@ v2.5.0 Changelog geometry wall type.tsv to create from Lightbox Description: - Switch data source for `Geometry Wall Type.tsv` from RECS 2009 to Homeland Infrastructure Foundation-Level Data (HIFLD) Parcel data - replace existing geometry wall type.tsv with new tsv from Lightbox - add geometry wall exterior finish.tsv from Lightbox + Switch data source for `Geometry Wall Type.tsv` from RECS 2009 to Homeland Infrastructure Foundation-Level Data (HIFLD) Parcel data. + replace existing geometry wall type.tsv with new tsv from Lightbox. + add geometry wall exterior finish.tsv from Lightbox. update insulation wall.tsv per new wall type. - update options lookup per new wall type and exterior finish + update options lookup per new wall type and exterior finish. resstock-estimation: `pull request 109 `_ @@ -439,7 +422,7 @@ v2.5.0 Changelog Duct cost multiplier - unconditioned area Description: - Changes "Duct Surface Area (ft^2)" cost multiplier to "Duct Unconditioned Surface Area (ft^2)" + Changes "Duct Surface Area (ft^2)" cost multiplier to "Duct Unconditioned Surface Area (ft^2)". Converts "Duct Surface Area (ft^2)" cost multiplier to "Duct Unconditioned Surface Area (ft^2)". Provides consistency w/ ResStock-HPXML. Follow-up to #532. Only buildings where the primary duct location is living space or finished basement are affected; they now return zero (instead of non-zero) values for the cost multiplier. @@ -456,11 +439,12 @@ v2.5.0 Changelog Replace room-ac performance curves by Cutler curves Description: - Switches room air conditioner model to use Cutler performance curves + Switches room air conditioner model to use Cutler performance curves. Backports: - Replace room-ac performance curves by Cutler curves OpenStudio-HPXML#698 - Room air conditioner performance curve bugfix OpenStudio-HPXML#701 - Allow CEER efficiency unit for room ac OpenStudio-HPXML#764 + + - Replace room-ac performance curves by Cutler curves OpenStudio-HPXML#698 + - Room air conditioner performance curve bugfix OpenStudio-HPXML#701 + - Allow CEER efficiency unit for room ac OpenStudio-HPXML#764 Assignees: Joe Robertson @@ -475,7 +459,7 @@ v2.5.0 Changelog ResStock-HPXML: Apply tsv files to develop branch Description: - Update tsv files for both the national and testing projects. Supports transition to ResStock-HPXML + Update tsv files for both the national and testing projects. Supports transition to ResStock-HPXML. resstock-estimation: `pull request 136 `_ @@ -492,8 +476,8 @@ v2.5.0 Changelog Backport ERI lighting calcs from restructure-v3 Description: - Use ANSI/RESNET/ICC 301 equations to calculate annual interior, exterior, and garage lighting energy - Backports the Energy Rating Index equations used to calculate interior, exterior, and garage lighting on https://github.com/NREL/resstock/tree/restructure-v3 + Use ANSI/RESNET/ICC 301 equations to calculate annual interior, exterior, and garage lighting energy. + Backports the Energy Rating Index equations used to calculate interior, exterior, and garage lighting on https://github.com/NREL/resstock/tree/restructure-v3. Assignees: Andrew Speake @@ -508,7 +492,7 @@ v2.5.0 Changelog Rename ReEDS to REEDS Description: - Fix name of ReEDS balancing areas + Fix name of ReEDS balancing areas. In the results.csv the ReEDS column gets interpreted as re_eds which makes the column hard to search for. Even though "ReEDS" is correct, it was decided that the TSV name will be "REEDS". resstock-estimation: `pull request 143 `_ @@ -517,25 +501,7 @@ v2.5.0 Changelog .. change:: - :tags: characteristics, bathrooms, feature - :pullreq: 601 - - **Date**: 2021-06-10 - - Title: - Number of bathrooms - - Description: - Update number of bathrooms assumption to match the Building America House Simulation Protocols - This PR makes two changes: - Updates number of bathrooms to use the BAHSP equation (Nbedrooms/2 + 0.5) and fixes the values used for SFA/MF. - Rounds down the number of bathrooms to the nearest integer for the assumption of number of bath fans. (E.g., a 1.5 bathroom home will now have 1 bath fan instead of 1.5 bath fans.) - - Assignees: Scott Horowitz - - - .. change:: - :tags: characteristics, bathrooms, bugfix + :tags: characteristics, bathrooms, feature, bugfix :pullreq: 601 **Date**: 2021-06-10 @@ -544,10 +510,11 @@ v2.5.0 Changelog Number of bathrooms Description: - Fixes number of bathrooms for single-family attached and multi-family buildings + Update number of bathrooms assumption to match the Building America House Simulation Protocols. This PR makes two changes: - Updates number of bathrooms to use the BAHSP equation (Nbedrooms/2 + 0.5) and fixes the values used for SFA/MF. - Rounds down the number of bathrooms to the nearest integer for the assumption of number of bath fans. (E.g., a 1.5 bathroom home will now have 1 bath fan instead of 1.5 bath fans.) + + - Updates number of bathrooms to use the BAHSP equation (Nbedrooms/2 + 0.5) and fixes the values used for SFA/MF. + - Rounds down the number of bathrooms to the nearest integer for the assumption of number of bath fans. (E.g., a 1.5 bathroom home will now have 1 bath fan instead of 1.5 bath fans.) Assignees: Scott Horowitz @@ -562,7 +529,7 @@ v2.5.0 Changelog Update sampling_probabilty column based on bug in tsv_dist Description: - Sync the sample probabilities after a bug fix in tsv_dist + Sync the sample probabilities after a bug fix in tsv_dist. The tsv_dist function was updated in the EULP-uncertainty-quantification PR #27. This update was due to a bug in identifying dependency intersections. As a result, the sample_probability column has updated for many housing characteristics. resstock-estimation: `pull request 142 `_ @@ -580,7 +547,7 @@ v2.5.0 Changelog Sampling speed improvement Description: - Speed up sampling algorithm by multiple orders of magnitude for large numbers of samples + Speed up sampling algorithm by multiple orders of magnitude for large numbers of samples. Addresses a bottleneck in run_sampling.rb that occurs for large TSVs. Assignees: Scott Horowitz @@ -596,20 +563,18 @@ v2.5.0 Changelog Housing Characteristic Fixes Description: - Housing characteristics fixes based on more samples in testing - project_national - Add Geometry Attic Type.tsv + Housing characteristics fixes based on more samples in testing. + Add Geometry Attic Type.tsv. Ensure assumptions are consistent for 5 to 9 unit buildings and their number of units. The assumption was added that 5 to 9 unit buildings cannot be >10 stories was not transparent in Geometry Building Number Units MF.tsv, but is enforced in Geometry Stories. The sampling_probability is 0, so the option values are set to "Option=None". - Add Geometry Attic Type as a dependency in Insulation Unfinished Attic.tsv + Add Geometry Attic Type as a dependency in Insulation Unfinished Attic.tsv. Script Roof Material Finished Roof.tsv and Roof Material Unfinished Attic.tsv. - project_testing - Add Geometry Attic Type.tsv - Add Geometry Attic Type as a dependency in Insulation Unfinished Attic.tsv + Add Geometry Attic Type.tsv. + Add Geometry Attic Type as a dependency in Insulation Unfinished Attic.tsv. Script Roof Material Finished Roof.tsv and Roof Material Unfinished Attic.tsv. Add Geometry Attic Type as a dependency to Roof Material Finished Roof.tsv and Roof Material Unfinished Attic.tsv. - Add Geometry Stories as a dependency for Geometry Building Number Units MF.tsv - Pier and Beam Foundations cannot have garages - Add HVAC Cooling Type as a dependency to HVAC Cooling Efficiency.tsv + Add Geometry Stories as a dependency for Geometry Building Number Units MF.tsv. + Pier and Beam Foundations cannot have garages. + Add HVAC Cooling Type as a dependency to HVAC Cooling Efficiency.tsv. resstock-estimation: `pull request 134 `_ @@ -644,7 +609,7 @@ v2.5.0 Changelog Enforce running sampling probability script, try 2 Description: - Add a sampling probability column in the housing characteristics to define the probability a given column will be sampled + Add a sampling probability column in the housing characteristics to define the probability a given column will be sampled. Add in a column called the sampling_probability to each housing characteristic. The sampling_probability is the probability that a given row in the housing characteristic TSV file is sampled. This value is calculated from the product of the marginal probability of each of the dependency values being sampled for that specific row. For each housing characteristic, the sampling_probability column should sum to 1.0 and have non-negative values. resstock-estimation: `pull request 127 `_ @@ -662,7 +627,7 @@ v2.5.0 Changelog New stories options for MF buildings Description: - Remove 3 story limit for multi-family buildings, and instead use RECS data to allow for buildings up to 21 stories + Remove 3 story limit for multi-family buildings, and instead use RECS data to allow for buildings up to 21 stories. Removes the artificial cap of 3 stories for MF buildings, and instead uses RECS data to allow for up to 21 stories. Horizontal location and level tsvs were updated to account for the new dependencies. ResidentialGeometryCreateMultifamily was also updated for error checking and to set the Middle-level units at the halfway point. Dependency options in the Window Areas and Geometry Garage tsvs are updated as well. resstock-estimation: `pull request 100 `_, `pull request 129 `_ @@ -680,7 +645,7 @@ v2.5.0 Changelog dst=NA somehow shifted from AZ to AR Description: - Update default daylight saving start and end dates to March 12 and November 5, respectively + Update default daylight saving start and end dates to March 12 and November 5, respectively. AZ counties did not have daylight saving dates set to NA (instead, some AR counties did). This corrects that. This PR also updates daylight saving dates from April 7 to October 26 to March 12 through November 5 (current OS-HPXML default values). @@ -697,8 +662,8 @@ v2.5.0 Changelog dst=NA somehow shifted from AZ to AR Description: - Set AZ counties to NA daylight saving times instead of some AR counties - AZ counties did not have daylight saving dates set to NA (instead, some AR counties did). This corrects that + Set AZ counties to NA daylight saving times instead of some AR counties. + AZ counties did not have daylight saving dates set to NA (instead, some AR counties did). This corrects that. Assignees: Joe Robertson @@ -713,7 +678,7 @@ v2.5.0 Changelog Project yml updates Description: - Update example project yaml files to use buildstockbatch input schema version 0.3 + Update example project yaml files to use buildstockbatch input schema version 0.3. From schema 0.2 to 0.3. Assignees: Joe Robertson @@ -729,11 +694,12 @@ v2.5.0 Changelog Faster stochastic schedules, second pass Description: - Reduce stochastic schedule generation runtime by over 50% + Reduce stochastic schedule generation runtime by over 50%. Related to NREL/OpenStudio-HPXML#706. ScheduleGenerator.create: - develop: ~10 s - faster-schedules2: ~7 s + + - develop: ~10 s + - faster-schedules2: ~7 s Assignees: Joe Robertson @@ -748,7 +714,7 @@ v2.5.0 Changelog Fix Heating Type = Void showing up in buildstock.csv Description: - Fixes the problem that `Heating Type=Void` is showing up in buildstock samples + Fixes the problem that `Heating Type=Void` is showing up in buildstock samples. Fixes the problem that Heating Type=Void is showing up in buildstock samples. resstock-estimation: `pull request 123 `_ @@ -766,11 +732,12 @@ v2.5.0 Changelog Faster stochastic schedules Description: - Reduce stochastic schedule generation runtime by over 50% + Reduce stochastic schedule generation runtime by over 50%. Related to NREL/OpenStudio-HPXML#697. ScheduleGenerator.create: - develop: ~34 s - faster-schedules: ~10 s + + - develop: ~34 s + - faster-schedules: ~10 s Assignees: Joe Robertson @@ -785,7 +752,7 @@ v2.5.0 Changelog Addresses #562, use Schedule:File with plug/fuel loads Description: - Use Schedule:File with well pump / vehicle plug loads, as well as gas grill / fireplace / lighting fuel loads. This enables the optional vacancy period to apply to these end uses + Use Schedule:File with well pump / vehicle plug loads, as well as gas grill / fireplace / lighting fuel loads. This enables the optional vacancy period to apply to these end uses. Populate well pump and vehicle plug loads, as well as grill / lighting / fireplace fuel loads, in the schedule csv. Remove weekday / weekend / monthly schedule arguments from ResidentialMiscLargeUncommonLoads measure and the options lookup. Apply vacancy to these plug/fuel loads. Assignees: Joe Robertson @@ -801,7 +768,7 @@ v2.5.0 Changelog Fix the supplimental capacity to autosize and reorder for efficiency Description: - Set all mini-split heat pump supplemental capacity to autosize + Set all mini-split heat pump supplemental capacity to autosize. Make sure all the HVAC Heating Efficiency; MSHP options have the ResidentialHVACMiniSplitHeatPump argument supplemental_capacity=autosize. Reorder MSHP options based on efficiency. @@ -818,7 +785,7 @@ v2.5.0 Changelog Bugfix/invalid geometry garage size Description: - Fixes invalid garage and living space dimension errors + Fixes invalid garage and living space dimension errors. The geometry measure is throwing an error due to garage sizes compared to the conditioned space size. We believe the error is due to the tucked garage is larger than either the depth or width of the first floor of the single-family detached unit. resstock-estimation: `pull request 106 `_ @@ -836,8 +803,8 @@ v2.5.0 Changelog Addresses #555, unfinished attic floor material layers are reversed Description: - Reverses the material layers of the unfinished attic floor construction so that they are correctly ordered outside-to-inside - Unfinished attic floor material layers are reversed + Reverses the material layers of the unfinished attic floor construction so that they are correctly ordered outside-to-inside. + Unfinished attic floor material layers are reversed. Assignees: Joe Robertson @@ -852,7 +819,7 @@ v2.5.0 Changelog Bug Fix: Too many bedrooms for small units Description: - Dwelling units that are 0-499 ft2 are limited to a maximum of 2 bedrooms + Dwelling units that are 0-499 ft2 are limited to a maximum of 2 bedrooms. This pull request updates the number of bedrooms for small units. resstock-estimation: `pull request 104 `_ @@ -870,12 +837,9 @@ v2.5.0 Changelog Apply schedule geo-temporal shifting Description: - Geo-temporal shifting of the stochastic load model schedules using the American Time Use Survey + Geo-temporal shifting of the stochastic load model schedules using the American Time Use Survey. The appliance schedules are shifted based on geography (state), day type(weekday/weekend), and month. - The amount of shift is defined in resources/measures/HPXMLtoOpenStudio/resources/schedules/weekday/state_and_monthly_schedule_shift.csv - and - resources/measures/HPXMLtoOpenStudio/resources/schedules/weekend/state_and_monthly_schedule_shift.csv - files. + The amount of shift is defined in resources/measures/HPXMLtoOpenStudio/resources/schedules/weekday/state_and_monthly_schedule_shift.csv and resources/measures/HPXMLtoOpenStudio/resources/schedules/weekend/state_and_monthly_schedule_shift.csv files. resstock-estimation: `pull request 101 `_ @@ -892,7 +856,7 @@ v2.5.0 Changelog Room AC Setpoint Dependency Description: - Introduce different cooling setpoint distributions for window ACs + Introduce different cooling setpoint distributions for window ACs. Adds HVAC Cooling Type dependency to Cooling Setpoint.tsv. Cooling type is not queried in RECS, and setpoints are determined the same as before, however the underlying temperature data for Room ACs is reduced by 6F to better align with the 2009 Residential Appliance Saturation Study (RASS). resstock-estimation: `pull request 96 `_ @@ -910,7 +874,7 @@ v2.5.0 Changelog Zonal Electric Heating Setpoints Description: - Include electric zonal heating equipment as a dependency in heating setpoint-related tsvs + Include electric zonal heating equipment as a dependency in heating setpoint-related tsvs. Adds zonal electric heating equipment as a dependency for heating setpoint-related tsvs (Heating Setpoint, Heating Setpoint Offset Period, Heating Setpoint Offset Magnitude and Heating Setpoint Has Offset). Zonal electric heating includes "Built-In Electric Units" and "Portable Electric Heaters" in RECS 2009. Additionally, all weekend daytime heating and cooling setpoint offsets are removed resstock-estimation: `pull request 96 `_ @@ -928,7 +892,7 @@ v2.5.0 Changelog Introduce CEC Climate Zones Description: - Introduce a CEC Building Climate Zone tag for samples in California + Introduce a CEC Building Climate Zone tag for samples in California. This pull requests add the California Energy Commission (CEC) Building Climate Zones into ResStock. A given building sample is tagged with a CEC climate zone (1-16) if the building is in California. If the sample is outside of California the sample is tagged with "None". resstock-estimation: `pull request 99 `_ @@ -946,7 +910,7 @@ v2.5.0 Changelog Increase LED saturation to 2019 projected values Description: - Increase LED saturation to approximately 2019 levels + Increase LED saturation to approximately 2019 levels. LED saturation is one of the fastest-changing technologies. Previously, we estimated that the LED saturation was ~10% based on the 2015 U.S. Lighting Market Characterization. Assignees: Anthony Fontanini, Eric Wilson @@ -980,7 +944,7 @@ v2.5.0 Changelog Single-Unit Geometry Description: - Model multifamily and single-family attached buildings as individual dwelling units instead of multiple units representing a building + Model multifamily and single-family attached buildings as individual dwelling units instead of multiple units representing a building. Updates geometry measures and various measure resources to model MF and SFA homes as single units. The geometry measures now apply adiabatic boundary conditions to surfaces that would otherwise be shared in the current MF and SFA modeling approaches Assignees: Andrew Speake @@ -996,7 +960,7 @@ v2.5.0 Changelog Speed up TSV fetching Description: - Fixes significant runtime bottleneck in TSV fetching in BuildExistingModel & ApplyUpgrade measures + Fixes significant runtime bottleneck in TSV fetching in BuildExistingModel & ApplyUpgrade measures. A bug in the buildstock.rb get_measure_args_from_option_names() method was causing the entirety of every TSV to be processed even when the option(s) of interest had already been found. As the number and length of TSVs has grown, so has this bottleneck. Assignees: Scott Horowitz diff --git a/docs/read_the_docs/source/changelog/changelog_3_0_0.rst b/docs/read_the_docs/source/changelog/changelog_3_0_0.rst index 890fd1bb62..6a09c0a6c9 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_0_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_0_0.rst @@ -16,8 +16,7 @@ v3.0.0 Changelog Latest OS-HPXML Description: - Update to OpenStudio v3.5.1 - OS 3.5.1 + Update to OpenStudio v3.5.1. OpenStudio-HPXML: `pull request 1251 `_ @@ -34,7 +33,7 @@ v3.0.0 Changelog Add AMI + modified tsvs from resstock-estimation refactoring/opt Description: - Add area median income + Add area median income. Using the traditional method of copying files over from resstock-estimation, add AMI and other modified tsvs from a recent set of resstock-estimation PRs refactoring and optimizing tsv_making processes. resstock-estimation: `pull request 243 `_, `pull request 302 `_, `pull request 304 `_ @@ -52,7 +51,7 @@ v3.0.0 Changelog AHS 2019 and 2021 data for simulated conditioned floor area Description: - Modeled floor area based on AHS 2021 and AHS 2019 + Modeled floor area based on AHS 2021 and AHS 2019. Use the AHS 2019, 2021 data for the simulated conditioned floor area ResStock arguments. Link to the AHS table used is HERE. For multi-family the ACS multi-family building types were combined using a weighted average where there were enough samples. Assignees: Anthony Fontanini, Lixi Liu @@ -68,7 +67,7 @@ v3.0.0 Changelog Optionally calculate simple utility bills Description: - Add ability to calculate simple utility bills for various scenarios + Add ability to calculate simple utility bills for various scenarios. Call new ReportUtilityBills measure from OS-HPXML. Assignees: Joe Robertson @@ -84,7 +83,7 @@ v3.0.0 Changelog Update join_tsv to use raw source_count Description: - Update low-sample downscaling logic to use raw source_weight, which leads to minor changes to Geometry Floor Area and HVAC Partial Space Conditioning + Update low-sample downscaling logic to use raw source_weight, which leads to minor changes to Geometry Floor Area and HVAC Partial Space Conditioning. TSV changes from updating join_distributions_in_order to use raw source_weight (previously, it uses what is now called fallback_weight which artificially increases the weight of undersampled options, thus making it deviate more from the sample truth marginal distributions) resstock-estimation: `pull request 248 `_ @@ -102,7 +101,7 @@ v3.0.0 Changelog TSV changes from improved low samples handling Description: - Remove Void from dependency columns in TSVs and update tests + Remove Void from dependency columns in TSVs and update tests. Some TSVs have "Option=Void" as one of the available options. The idea behind Void is that certain dependency conditions are structurally impossible. For example, for "HVAC Heating Type and Fuel.tsv", it's impossible that "Heating Fuel" = Electricity and "HVAC Heating Efficiency" = "Fuel Boiler". So, this particular dependency condition get's Void option. resstock-estimation: `pull request 245 `_ @@ -120,7 +119,7 @@ v3.0.0 Changelog Support auto_seasons arguments Description: - Fix heating and cooling auto-season inputs + Fix heating and cooling auto-season inputs. Looks like OS-HPXML auto_seasons related arguments may have been updated, but ResStockArguments subsequently was not. I believe this was not caught because our testing project does not currently sample any setpoint options which enable the auto_seasons arguments. Assignees: Joe Robertson @@ -136,7 +135,7 @@ v3.0.0 Changelog Introduce cooling partial space conditioning Description: - Add distributions for partial space cooling + Add distributions for partial space cooling. Introduce partial space conditioning for cooling. resstock-estimation: `pull request 235 `_, `pull request 233 `_, `pull request 241 `_ @@ -154,7 +153,7 @@ v3.0.0 Changelog Ll/rename sources Description: - Rename sources subfolders so all tsv_makers can be imported as packages + Rename sources subfolders so all tsv_makers can be imported as packages. Rename sources folders so all tsv_makers can be imported as packages. Packages cannot contain names that start with a number. resstock-estimation: `pull request 238 `_ @@ -172,8 +171,8 @@ v3.0.0 Changelog add income + tenure to floor_area Description: - Add Income and Tenure into Geometry Floor Area - Add Income and Tenure to Geometry Floor Area + Add Income and Tenure into Geometry Floor Area. + Add Income and Tenure to Geometry Floor Area. resstock-estimation: `pull request 233 `_ @@ -190,7 +189,7 @@ v3.0.0 Changelog Fix/tsv tags sampling prob etc Description: - Fix minor bug in sampling probability calculation + Fix minor bug in sampling probability calculation. resstock-estimation: `pull request 221 `_ @@ -207,8 +206,8 @@ v3.0.0 Changelog Add income, tenure, fix occupants Description: - Add Income and Tenure tsv, update PUMS tsvs from 2017 5-yrs to 2019 5-yrs, update dependencies and fix encoding error in Occupants.tsv - Update PUMS tsvs from 2017 5-yrs to 2019 5-yrs, + Add Income and Tenure tsv, update PUMS tsvs from 2017 5-yrs to 2019 5-yrs, update dependencies and fix encoding error in Occupants.tsv. + Update PUMS tsvs from 2017 5-yrs to 2019 5-yrs. Add new tvs: Income, Income RECS2015, Federal Poverty Level, Tenure, and PUMA Metro Status (a few of them are explained in detail below.) Assignees: Lixi Liu, Anthony Fontanini, Nate Moore @@ -224,10 +223,10 @@ v3.0.0 Changelog Improve heat pump distributions for Texas and Florida Description: - Improve distributions of heat pumps in the southeast U.S. by spliting IECC zone 2A into two zones: 2A (FL, GA, AL, MS) and 2A (TX, LA) - Currently using IECC climate zone for HVAC Heating Type - Zone 2A is 16%-20% HP, whereas Reportable Domain of TX (3%), FL (20%) - Solution: Split 2A into two chunks, 2A (FL, GA, AL, MS), and 2A (TX, LA) + Improve distributions of heat pumps in the southeast U.S. by spliting IECC zone 2A into two zones: 2A (FL, GA, AL, MS) and 2A (TX, LA). + Currently using IECC climate zone for HVAC Heating Type. + Zone 2A is 16%-20% HP, whereas Reportable Domain of TX (3%), FL (20%). + Solution: Split 2A into two chunks, 2A (FL, GA, AL, MS), and 2A (TX, LA). resstock-estimation: `pull request 209 `_ @@ -244,7 +243,7 @@ v3.0.0 Changelog update tsvs with new sampling_prob Description: - Update tsvs with new sampling_probability calculation + Update tsvs with new sampling_probability calculation. resstock-estimation: `pull request 210 `_, `pull request 203 `_ @@ -261,7 +260,7 @@ v3.0.0 Changelog City Boundaries Description: - Cities with more than 15,000 dwelling units are added as a geographic characteristic + Cities with more than 15,000 dwelling units are added as a geographic characteristic. Adding City boundaries as a housing characteristic in ResStock. This way users can aggregate directly by a given City. resstock-estimation: `pull request 196 `_ @@ -279,7 +278,7 @@ v3.0.0 Changelog Unvented crawlspace upgrade Description: - Add a new "Floor Area, Foundation (ft^2)" cost multiplier + Add a new "Floor Area, Foundation (ft^2)" cost multiplier. Assignees: Joe Robertson @@ -294,8 +293,8 @@ v3.0.0 Changelog Handle incremental costs of (1) adding attic insulation and (2) reducing (%) infiltration Description: - Add a new "Floor Area, Attic * Insulation Increase (ft^2 * Delta R-value)" cost multiplier for handling incremental costs of adding attic insulation - Handle incremental costs of adding attic insulation + Add a new "Floor Area, Attic * Insulation Increase (ft^2 * Delta R-value)" cost multiplier for handling incremental costs of adding attic insulation. + Handle incremental costs of adding attic insulation. Assignees: Joe Robertson @@ -310,8 +309,8 @@ v3.0.0 Changelog Handle incremental costs of (1) adding attic insulation and (2) reducing (%) infiltration Description: - Allow air leakage % reduction upgrades (e.g., 25%), and add a new "Floor Area, Conditioned * Infiltration Reduction (ft^2 * Delta ACH50)" cost multiplier for handling incremental costs of such upgrades - Add generic multiplier argument to infiltration options to facilitate % reductions in ACH50 + Allow air leakage % reduction upgrades (e.g., 25%), and add a new "Floor Area, Conditioned * Infiltration Reduction (ft^2 * Delta ACH50)" cost multiplier for handling incremental costs of such upgrades. + Add generic multiplier argument to infiltration options to facilitate % reductions in ACH50. Assignees: Joe Robertson @@ -326,7 +325,7 @@ v3.0.0 Changelog Reduce TSV Sizes Description: - Reduce housing characteristic file size by relaxing the six digit float format in the housing characteristics + Reduce housing characteristic file size by relaxing the six digit float format in the housing characteristics. As housing characteristics get bigger, we are moving to a compact writing style. The 6-digit float format requirement was put in place when most of the characteristics were not scripted. Now that there is a standard workflow for creating the characteristics, the formatting requirements are being relaxed. This change should allow for more accurate characteristic distributions because the exponential format can be used. The change should also stop round-off errors. resstock-estimation: `pull request 200 `_ @@ -344,9 +343,9 @@ v3.0.0 Changelog Changes after switching to ResStock-HPXML Description: - For the testing project, sample equal distributions of (1) smooth and stochastic schedules (each 50%) and (2) faulted and non-faulted HVAC systems (each 50%) - project_testing/Schedules.tsv to equal distribution of Default and Stochastic - project_testing/HVAC System Is Faulted.tsv to equal distribution of No and Yes + For the testing project, sample equal distributions of (1) smooth and stochastic schedules (each 50%) and (2) faulted and non-faulted HVAC systems (each 50%). + project_testing/Schedules.tsv to equal distribution of Default and Stochastic. + project_testing/HVAC System Is Faulted.tsv to equal distribution of No and Yes. resstock-estimation: `pull request 193 `_ @@ -363,7 +362,7 @@ v3.0.0 Changelog Changes after switching to ResStock-HPXML Description: - Clean up option names for natural ventilation and hot water distribution + Clean up option names for natural ventilation and hot water distribution. resstock-estimation: `pull request 193 `_ @@ -380,7 +379,7 @@ v3.0.0 Changelog Extend ApplyUpgrade for upgrade measures Description: - Allow upgrade options to be defined in the lookup using measures other than ResStockArguments + Allow upgrade options to be defined in the lookup using measures other than ResStockArguments. Support "upgrade" measures that are not part of the OS-HPXML workflow, and are tacked on after model is created. Assignees: Joe Robertson @@ -396,8 +395,8 @@ v3.0.0 Changelog Enable rim joists Description: - Enable rim joists for homes with basements/crawlspaces; assumes a height of 9.25 inches and calculates rim joist assembly R-value from new insulation arguments - Enable rim joists (set this by default, and r-value to foundation wall r-value); we could potentially enable rim joists between floors by adjusting average ceiling height, but we won't for now + Enable rim joists for homes with basements/crawlspaces; assumes a height of 9.25 inches and calculates rim joist assembly R-value from new insulation arguments. + Enable rim joists (set this by default, and r-value to foundation wall r-value); we could potentially enable rim joists between floors by adjusting average ceiling height, but we won't for now. Assignees: Joe Robertson @@ -412,7 +411,7 @@ v3.0.0 Changelog Remove backup switchover temp for non dual fuel heat pumps Description: - Remove the zero degree switchover temperature for heat pump backup heating + Remove the zero degree switchover temperature for heat pump backup heating. Remove heat_pump_backup_heating_switchover_temp=0.0 for non dual fuel heat pumps. Leave heat_pump_backup_heating_switchover_temp=30.0 for dual fuel heat pumps. Assignees: Joe Robertson, Andrew Speake @@ -428,7 +427,7 @@ v3.0.0 Changelog HEScore Workflow Description: - Enable the HEScore workflow to be run with BuildExistingModel + Enable the HEScore workflow to be run with BuildExistingModel. Enables to the HEScore workflow to be run from BuildExistingModel. A new argument os_hescore_directory is added in BuildExistingModel which points to a local checkout of https://github.com/NREL/OpenStudio-HEScore. Assignees: Andrew Speake @@ -444,7 +443,7 @@ v3.0.0 Changelog Model finished attics Description: - For homes with a finished attic or cathedral ceilings, models a conditioned attic instead of a vented attic + For homes with a finished attic or cathedral ceilings, models a conditioned attic instead of a vented attic. Change geometry_attic_type=VentedAttic when Geometry Attic Type samples Finished Attic or Cathedral Ceilings. Assignees: Joe Robertson, Andrew Speake @@ -460,7 +459,7 @@ v3.0.0 Changelog ResStock-HPXML Description: - Transition to using the HPXML-based workflow + Transition to using the HPXML-based workflow. Subtree resources/hpxml-measures to github.com/NREL/OpenStudio-HPXML. OpenStudio-HPXML: `pull request 372 `_ diff --git a/docs/read_the_docs/source/changelog/changelog_3_1_0.rst b/docs/read_the_docs/source/changelog/changelog_3_1_0.rst index a4524965c7..ffee1aeffa 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_1_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_1_0.rst @@ -16,7 +16,7 @@ v3.1.0 Changelog Latest OS-HPXML, OS v3.6.1 Description: - Update to OpenStudio v3.6.1 + Update to OpenStudio v3.6.1. Assignees: Joe Robertson, Scott Horowitz @@ -31,7 +31,7 @@ v3.1.0 Changelog Pulls in upstream OS-HPXML fix related to [falling back to a WWR calculation when window placement fails](https://github.com/NREL/OpenStudio-HPXML/pull/1385) causing errors fitting windows Description: - Pulls in upstream OS-HPXML fix related to [falling back to a WWR calculation when window placement fails](https://github.com/NREL/OpenStudio-HPXML/pull/1385) causing errors fitting windows + Pulls in upstream OS-HPXML fix related to [falling back to a WWR calculation when window placement fails](https://github.com/NREL/OpenStudio-HPXML/pull/1385) causing errors fitting windows. Assignees: Joe Robertson @@ -46,7 +46,7 @@ v3.1.0 Changelog Data dictionary + automated RTD generation Description: - Add data dictionary files for describing various outputs. Use these files to (1) check against integration test results, and (2) generate documentation tables + Add data dictionary files for describing various outputs. Use these files to (1) check against integration test results, and (2) generate documentation tables. One of the pain points we experience when importing ResStock runs into SightGlass (resstock.nrel.gov) is that the outputs and format of the outputs from ResStock frequently change. This causes our data processing for that to break and require many hours of manual updating every time we go to bring new data in. It would be really helpful to have a data dictionary of the outputs ResStock produces meaning every column name (including the input and output columns) in the results.csv and timeseries parquet files. It should also include some flags about which are end uses to include in the sum vs aggregates (net or totals), units, other random outputs like load, emissions, etc. To keep this in sync, it should be verified against the CI runs of ResStock and if there is a discrepancy you get a big ❌ on your checks. @@ -63,7 +63,7 @@ v3.1.0 Changelog Add capacity retention arguments for ASHP Description: - Connect ASHP to optional capacity retention temperature and fraction arguments (that already exist for MSHP) + Connect ASHP to optional capacity retention temperature and fraction arguments (that already exist for MSHP). Assignees: Joe Robertson, Scott Horowitz @@ -78,10 +78,11 @@ v3.1.0 Changelog HP heating capacity retention Description: - OS-HPXML now supports use of optional heat pump capacity retention temperature and fraction arguments (applicable to both ASHP and MSHP) + OS-HPXML now supports use of optional heat pump capacity retention temperature and fraction arguments (applicable to both ASHP and MSHP). Adds optional inputs for defining heat pump capacity retention: - extension/HeatingCapacityRetention/Fraction - extension/HeatingCapacityRetention/Temperature + + - extension/HeatingCapacityRetention/Fraction + - extension/HeatingCapacityRetention/Temperature OpenStudio-HPXML: `pull request 1383 `_ @@ -98,7 +99,7 @@ v3.1.0 Changelog Add descriptions to housing characteristics Description: - Add descriptions to the housing characteristics + Add descriptions to the housing characteristics. Add a description tag to each of the housing characteristics. Add the source reports from resstock-estimation to resstock. resstock-estimation: `pull request 366 `_ @@ -116,7 +117,7 @@ v3.1.0 Changelog Support sample_weight in buildstock.csv Description: - Ability to specify a "sample_weight" column in the precomputed buildstock.csv + Ability to specify a "sample_weight" column in the precomputed buildstock.csv. Adds support for a sample_weight column in the precomputed buildstock.csv. By default, BuildExistingModel writes build_existing_model.sample_weight based on calculating n_buildings_represented / n_datapoints (this calculation is done in the workflow generator and then passed into the BuildExistingModel measure). Now, if sample_weight already exists in the buildstock.csv, it will write this value instead of the calculated one. Assignees: Joe Robertson @@ -132,7 +133,7 @@ v3.1.0 Changelog Support for power outages Description: - Demonstrate new power outage modeling feature using upgrades specified in example project yml files + Demonstrate new power outage modeling feature using upgrades specified in example project yml files. Assignees: Joe Robertson @@ -147,7 +148,7 @@ v3.1.0 Changelog Pulls in upstream OS-HPXML fix related to [avoiding possible OpenStudio temporary directory collision](https://github.com/NREL/OpenStudio-HPXML/pull/1316) causing random errors Description: - Pulls in upstream OS-HPXML fix related to [avoiding possible OpenStudio temporary directory collision](https://github.com/NREL/OpenStudio-HPXML/pull/1316) causing random errors + Pulls in upstream OS-HPXML fix related to [avoiding possible OpenStudio temporary directory collision](https://github.com/NREL/OpenStudio-HPXML/pull/1316) causing random errors. Assignees: Joe Robertson @@ -162,7 +163,7 @@ v3.1.0 Changelog Stub battery tsv for testing project Description: - Include battery modeling capabilities for project_testing + Include battery modeling capabilities for project_testing. Stub new Battery.tsv. Separate battery related arguments from PV in options_lookup. Test battery options using testing project. @@ -182,8 +183,8 @@ v3.1.0 Changelog Check a buildstock csv against an options_lookup tsv Description: - Ability to check buildstock csv against an options lookup as a command line utility - Enable "integrity checks" on buildstock.csv + Ability to check buildstock csv against an options lookup as a command line utility. + Enable "integrity checks" on buildstock.csv. Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_3_1_1.rst b/docs/read_the_docs/source/changelog/changelog_3_1_1.rst index 3a4d019b32..cb8b2911bd 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_1_1.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_1_1.rst @@ -16,8 +16,8 @@ v3.1.1 Changelog Use gem version on bsb version strings Description: - Use `Gem::Version` on buildstockbatch version string comparisons so that, e.g., '2023.10.0' < '2023.5.0' does not evaluate to true - Patched release with version comparison fix + Use `Gem::Version` on buildstockbatch version string comparisons so that, e.g., '2023.10.0' < '2023.5.0' does not evaluate to true. + Patched release with version comparison fix. Assignees: Joe Robertson diff --git a/docs/read_the_docs/source/changelog/changelog_3_2_0.rst b/docs/read_the_docs/source/changelog/changelog_3_2_0.rst index 28d6514a31..38c205262d 100644 --- a/docs/read_the_docs/source/changelog/changelog_3_2_0.rst +++ b/docs/read_the_docs/source/changelog/changelog_3_2_0.rst @@ -16,7 +16,7 @@ v3.2.0 Changelog Update weather files from NREL Data Catalog Description: - Update TMY3 weather URL from the NREL Data Catalog + Update TMY3 weather URL from the NREL Data Catalog. The current link in the project YAMLs for the TMY weather files in NREL Data Catalog is out of date and missing the following Counties. This PR updates the link to the latest file on the NREL Data Catalog. Assignees: Anthony Fontanini @@ -32,7 +32,7 @@ v3.2.0 Changelog Geothermal loop & soil properties Description: - Updates and enhancements to the ground source heat pump model; ability to describe detailed geothermal loop inputs + Updates and enhancements to the ground source heat pump model; ability to describe detailed geothermal loop inputs. Allow inputs to describe a ground-source heat pump field (e.g., vertical vs horizontal, bore/trench length, etc.). OpenStudio-HPXML: `pull request 1391 `_ @@ -50,7 +50,7 @@ v3.2.0 Changelog Add variability in ground thermal conductivity Description: - Add variability in ground thermal conductivity + Add variability in ground thermal conductivity. Allow ground conductivity to vary by climate zone. The GeoVision task force report provided data by climate zone. The same data is used to fill out distributions by climate zone. resstock-estimation: `pull request 393 `_ @@ -68,7 +68,7 @@ v3.2.0 Changelog RTD: summarize lookup arguments Description: - Automate creation of new "Arguments" documentation sections for summarizing arguments (and their default values) in options_lookup.tsv + Automate creation of new "Arguments" documentation sections for summarizing arguments (and their default values) in options_lookup.tsv. By housing characteristic parameter, automates summarizing Arguments sets used in options_lookup.tsv (including Name, Required, Units, Type, Choices, Description). See below for example. Assignees: Joe Robertson @@ -84,7 +84,7 @@ v3.2.0 Changelog Update to RECS 2020 V5 data files Description: - Update to RECS 2020 V5 data files + Update to RECS 2020 V5 data files. Use RECS 2020 V5 microdata file to create the characteristics. There is very little impact as the update to RECS 2020 V5 is mainly adding columns with end-use energy and expenditures. There are some very small changes to some TSVs, but these changes result in no changes to the options_saturation file. resstock-estimation: `pull request 392 `_ @@ -102,8 +102,7 @@ v3.2.0 Changelog Latest OS-HPXML, OS v3.7.0 Description: - Update to OpenStudio v3.7.0 - OpenStudio 3.7.0/EnergyPlus 23.2.0 + Update to OpenStudio 3.7.0/EnergyPlus 23.2.0. Assignees: Joe Robertson, Scott Horowitz @@ -118,7 +117,7 @@ v3.2.0 Changelog Calculate detailed utility bills Description: - Add ability to calculate detailed utility bills based on a user-specified TSV file of paths to JSON utility rate tariff files + Add ability to calculate detailed utility bills based on a user-specified TSV file of paths to JSON utility rate tariff files. Add optional detailed_filepath yml argument for pointing to user-specified TSV file of electricity tariff file paths. The TSV file can contain electricity tariff file paths mapped by State, or any other parameter. Assignees: Joe Robertson @@ -134,7 +133,7 @@ v3.2.0 Changelog Add resilience arguments to yml files Description: - Add ability to request timeseries resilience output from the yml file + Add ability to request timeseries resilience output from the yml file. Include the new include_timeseries_resilience argument in example yml files. Assignees: Joe Robertson @@ -150,8 +149,8 @@ v3.2.0 Changelog Add water heater location Description: - Add Water Heater Location and Geometry Space Combination, update Geometry Garage and Geometry Floor Area Bin to RECS2020, update RECS2020 microdata from v2 to v4, auto-generate buildstocks for yml_precomputed tests - Added Water Heater Location.tsv + Add Water Heater Location and Geometry Space Combination, update Geometry Garage and Geometry Floor Area Bin to RECS2020, update RECS2020 microdata from v2 to v4, auto-generate buildstocks for yml_precomputed tests. + Added Water Heater Location.tsv. resstock-estimation: `pull request 385 `_ @@ -168,7 +167,7 @@ v3.2.0 Changelog run_analysis.rb: handle illegal upgrade names, provide run folder map Description: - Update `run_analysis.rb` to handle illegal path characters in upgrade names + Update `run_analysis.rb` to handle illegal path characters in upgrade names. run_analysis.rb creates directories based on upgrade names, but these upgrade names may have illegal path characters in them (e.g., "/" if the upgrade name is "Higher efficiency ducted ASHP w/ elec backup "), resulting in an obscure error. It should more gracefully handle this situation and be able to run upgrades with these characters in the name. Assignees: Joe Robertson @@ -184,7 +183,7 @@ v3.2.0 Changelog run_analysis.rb: handle illegal upgrade names, provide run folder map Description: - Update `run_analysis.rb` to map datapoints to run folder names when the `-k` argument is supplied + Update `run_analysis.rb` to map datapoints to run folder names when the `-k` argument is supplied. Also, adds writing run folder names (e.g., "run1", "run2", etc.) to the "job_id" column when supplying the -k argument to run_analysis.rb (i.e., a map from datapoint to run folder). Assignees: Joe Robertson @@ -200,7 +199,7 @@ v3.2.0 Changelog Update TSVs after bugfix Description: - Minor changes to heating and cooling setpoint TSV after a bug fix + Minor changes to heating and cooling setpoint TSV after a bug fix. Fix an elusive bug that causes a slight changes on the Heating Setpoint and Cooling Setpoint TSV on each run. This bug was a result of previous PR of refactoring prune_rules. resstock-estimation: `pull request 388 `_ @@ -218,7 +217,7 @@ v3.2.0 Changelog TSV changes from prune_rules refactor and adding options_saturations.csv Description: - Minor changes to heating and cooling setpoint TSV due to refactoring of prune_rules handling in resstock-estimation + Minor changes to heating and cooling setpoint TSV due to refactoring of prune_rules handling in resstock-estimation. Attempt at fixing ongoing issue with unexpected behavior of prune rules in #385 by refactoring and simplifying prune rule handling. resstock-estimation: `pull request 386 `_ @@ -236,7 +235,7 @@ v3.2.0 Changelog TSV changes from prune_rules refactor and adding options_saturations.csv Description: - options_saturations.csv is added to project_*/resources/ folder + options_saturations.csv is added to project_*/resources/ folder. Also add options_saturations.csv to resources. resstock-estimation: `pull request 386 `_ @@ -255,7 +254,7 @@ v3.2.0 Changelog Description: Correct refrigerator rated annual kWh based on EF and an assumed volume of 20.9cft. - Change the rated annual consumption of refrigerator and misc extra refrigerator in options_lookup.tsv + Change the rated annual consumption of refrigerator and misc extra refrigerator in options_lookup.tsv. Assignees: Lixi Liu @@ -270,7 +269,7 @@ v3.2.0 Changelog Heating system -> heat pump backup Description: - For heat pump upgrades, adds the ability to set the existing primary (non-shared) heating system as the backup system using only a single option from the lookup + For heat pump upgrades, adds the ability to set the existing primary (non-shared) heating system as the backup system using only a single option from the lookup. Uses ResStockArguments to add a new boolean argument heat_pump_backup_use_existing_system. Assignees: Joe Robertson @@ -287,11 +286,11 @@ v3.2.0 Changelog Description: Fix/clarify duct location assignment by defining Duct Location.tsv, making Duct Leakage and Insulation (formerly Duct) depend on Duct Location, and making HVAC Has Ducts depend on HVAC Has Shared Systems. Includes fixes on standalone and shared heating system assignment for Other Fuel. - Added Duct Location.tsv - Replaced Duct.tsv with Duct Leakage and Insulation.tsv - Added "HVAC Has Shared System" as dependency to HVAC Has Ducts.tsv - Fixed HVAC Shared Efficiencies.tsv - Fixed HVAC Heating Efficiency.tsv + Added Duct Location.tsv. + Replaced Duct.tsv with Duct Leakage and Insulation.tsv. + Added "HVAC Has Shared System" as dependency to HVAC Has Ducts.tsv. + Fixed HVAC Shared Efficiencies.tsv. + Fixed HVAC Heating Efficiency.tsv. resstock-estimation: `pull request 377 `_ @@ -308,8 +307,8 @@ v3.2.0 Changelog Typo for square feet area of multi-family Description: - Fix square footage for a MF dwelling unit in the "3000-3999" CFA bin (from 33171 to 3171) - This shows square footage for an MF housing bin of 3000-3999 to be 33171. I assume this is incorrect and a typo, but should be a quick fix + Fix square footage for a MF dwelling unit in the "3000-3999" CFA bin (from 33171 to 3171). + This shows square footage for an MF housing bin of 3000-3999 to be 33171. I assume this is incorrect and a typo, but should be a quick fix. Assignees: Joe Robertson @@ -324,7 +323,7 @@ v3.2.0 Changelog HVAC Secondary Heating, try 2 Description: - Include HVAC secondary heating capabilities for project_testing + Include HVAC secondary heating capabilities for project_testing. Support options sampled from HVAC Secondary Heating xxx. resstock-estimation: `pull request 375 `_ @@ -344,8 +343,8 @@ v3.2.0 Changelog HVAC Secondary Heating, try 2 Description: - Update ResStockArguments to support nonzero fraction of heat load served by the secondary heating system - Update the ResStockArguments measure to adjust the primary system's fraction of heat load served such that the sum of fractions does not exceed 1.0 + Update ResStockArguments to support nonzero fraction of heat load served by the secondary heating system. + Update the ResStockArguments measure to adjust the primary system's fraction of heat load served such that the sum of fractions does not exceed 1.0. resstock-estimation: `pull request 375 `_ @@ -364,7 +363,7 @@ v3.2.0 Changelog Model wood fuel when sampling "Other Fuel" for WH and "Other" for HVAC Description: - Model a wood storage water heater when "Other Fuel" is sampled from Water Heater Efficiency.tsv (allowing downstream modeling of clothes washer/dryer). Similarly, model a wood wall/floor furnace when "Other" is sampled from HVAC Heating Efficiency.tsv + Model a wood storage water heater when "Other Fuel" is sampled from Water Heater Efficiency.tsv (allowing downstream modeling of clothes washer/dryer). Similarly, model a wood wall/floor furnace when "Other" is sampled from HVAC Heating Efficiency.tsv. Water Heater Efficiency|Other Fuel to model a wood storage water heater instead of no water heater. HVAC Heating Efficiency|Other to model a wood wall/floor furnace instead of no heating system. @@ -381,7 +380,7 @@ v3.2.0 Changelog Clean up options_lookup.tsv in github actions Description: - Set standard format for options_lookup + Set standard format for options_lookup. In an effort to clean up resources/options_lookup.tsv, this sets a standard for what the file should look like. Assignees: Rajendra Adhikari, Anthony Fontanini @@ -397,7 +396,7 @@ v3.2.0 Changelog Simple bill calcs (enhancement) Description: - Add ability to calculate simple utility bills based on a user-specified TSV file of utility rates + Add ability to calculate simple utility bills based on a user-specified TSV file of utility rates. Add optional simple_filepath yml argument for pointing to user-specified TSV file of utility rates. The TSV file can contain utility rates mapped by State, or any other parameter. Assignees: Joe Robertson @@ -413,7 +412,7 @@ v3.2.0 Changelog Update to RECS 2020 data Description: - Update characteristics to use EIA 2020 RECS + Update characteristics to use EIA 2020 RECS. Transitioning characteristics to use the EIA's 2020 RECS survey final characteristics. Assignees: Anthony Fontanini @@ -429,7 +428,7 @@ v3.2.0 Changelog Update to 2022 Cambium release Description: - Add 2022 Cambium emissions data + Add 2022 Cambium emissions data. Cambium 2022 data is out. This issue is to update to the 2022 data. Assignees: Joe Robertson @@ -445,7 +444,7 @@ v3.2.0 Changelog Ll/energystar climate zones Description: - Add Energystar Climate Zone for window upgrade specification + Add Energystar Climate Zone for window upgrade specification. resstock-estimation: `pull request 369 `_ diff --git a/docs/read_the_docs/source/changelog/changelog_dev.rst b/docs/read_the_docs/source/changelog/changelog_dev.rst index b7cb39e381..cb22e79d7d 100644 --- a/docs/read_the_docs/source/changelog/changelog_dev.rst +++ b/docs/read_the_docs/source/changelog/changelog_dev.rst @@ -48,7 +48,7 @@ Development Changelog Split out Other and TV plug loads Description: - Split out TV plug loads (calculated using an equation based on ANSI/RESNET/ICC 301) from other plug loads (calculated using updated regression equations based on RECS2020) + Split out TV plug loads (calculated using an equation based on ANSI/RESNET/ICC 301) from other plug loads (calculated using updated regression equations based on RECS2020). For TV, we are now using OS-HPXML defaults (i.e., TV = 413.0 + 69.0 * NumberofBedrooms based on ANSI/RESNET/ICC 301-2019, where NumberofBedrooms is adjusted based on NumberofResidents). Create a new sources/recs/recs2020/plug_loads/mel_ann.py script. @@ -68,8 +68,8 @@ Development Changelog Run run_analysis in parallel Description: - Introduce a new optional `buildstock_csv_path` argument that supports parallel resstock runs using `run_analysis.rb` - I know this is an odd workflow, but I'd like to call resstock in parallel, to run multiple models (baseline only) built each with a precomputed buildstock.csv + Introduce a new optional `buildstock_csv_path` argument that supports parallel resstock runs using `run_analysis.rb`. + I know this is an odd workflow, but I'd like to call resstock in parallel, to run multiple models (baseline only) built each with a precomputed buildstock.csv. Assignees: Julien Marrec @@ -99,7 +99,7 @@ Development Changelog Latest OS-HPXML Description: - Additional geothermal loop default simulation outputs (number/length of boreholes) + Additional geothermal loop default simulation outputs (number/length of boreholes). Adds geothermal loop outputs (number/length of boreholes) to annual results output file. OpenStudio-HPXML: `#1657 `_ @@ -117,7 +117,7 @@ Development Changelog Latest OS-HPXML Description: - Updates default `ShieldingofHome` to be "well-shielded" (from "normal") for single-family attached and multifamily dwelling units + Updates default `ShieldingofHome` to be "well-shielded" (from "normal") for single-family attached and multifamily dwelling units. Updates default ShieldingofHome to be "well-shielded" for single-family attached and multifamily dwelling units. Assignees: Scott Horowitz @@ -133,7 +133,7 @@ Development Changelog OpenStudio 3.8/EnergyPlus 24.1 Description: - Update to OpenStudio v3.8.0 + Update to OpenStudio v3.8.0. OpenStudio-HPXML: `pull request 1630 `_ @@ -150,7 +150,7 @@ Development Changelog Updates duct effective R-values; allows duct shape inputs Description: - Update to new OS-HPXML defaults for duct insulation; 25% rectangular supply ducts and 100% rectangular return ducts (previously 100% round supply/return ducts) + Update to new OS-HPXML defaults for duct insulation; 25% rectangular supply ducts and 100% rectangular return ducts (previously 100% round supply/return ducts). Adds optional inputs (Ducts/DuctShape and Ducts/DuctFractionRectangular); defaults to 25% rectangular supply ducts and 100% rectangular return ducts (previously 100% round supply/return ducts). OpenStudio-HPXML: `#1470 `_, `pull request 1691 `_ @@ -168,7 +168,7 @@ Development Changelog HVAC Autosizing Limits Description: - Sizing control option to specify max allowed airflow + Sizing control option to specify max allowed airflow. The PR aims to allow specifying upper limits for autosized capacities. OpenStudio-HPXML: `#1530 `_, `#1556 `_, `pull request 1584 `_ @@ -186,8 +186,8 @@ Development Changelog HVAC Autosizing Factors Description: - Enable HVAC airflow and capacity scaling factors to oversize or undersize the equipment - Manually create new tsv files for assigning autosizing factor arguments introduced by NREL/OpenStudio-HPXML#1611 + Enable HVAC airflow and capacity scaling factors to oversize or undersize the equipment. + Manually create new tsv files for assigning autosizing factor arguments introduced by NREL/OpenStudio-HPXML#1611. resstock-estimation: `pull request 406 `_ @@ -206,10 +206,10 @@ Development Changelog Update Other, TV, and Ceiling Fan stochastic schedules Description: - Update the stochastic schedule generator to produce updated other/TV plug load and ceiling fan schedules + Update the stochastic schedule generator to produce updated other/TV plug load and ceiling fan schedules. generate TV schedules that follow the ATUS TV schedule fractions (distinct weekday/weekend) and multipliers (and not Other schedule fractions and multipliers). generate Other schedules that follow the new Other schedule fractions (still uses non-constant 2010 BAHSP monthly multipliers). - generate Ceiling Fan schedules that follow the new Ceiling Fan schedule fractions (also update multipliers to not follow Other multipliers, but rather Ceiling Fan multipliers that are a function of weather) + generate Ceiling Fan schedules that follow the new Ceiling Fan schedule fractions (also update multipliers to not follow Other multipliers, but rather Ceiling Fan multipliers that are a function of weather). OpenStudio-HPXML: `pull request 1634 `_ @@ -226,7 +226,7 @@ Development Changelog Integrate ARIS data Description: - Update the Alaska residential stock characterization using the Alaska Retrofit Information System data + Update the Alaska residential stock characterization using the Alaska Retrofit Information System data. Update housing characteristics for Alaska using ARIS dataset. Explicitly model wood heating for the national. resstock-estimation: `pull request 381 `_ @@ -244,7 +244,7 @@ Development Changelog HVAC Autosizing Factors Description: - Add ability to specify HVAC system autosizing factors for baseline buildings; autosizing factors are retained for upgrade buildings following the same approach for HVAC system capacities + Add ability to specify HVAC system autosizing factors for baseline buildings; autosizing factors are retained for upgrade buildings following the same approach for HVAC system capacities. Allows optional HeatingAutosizingFactor, CoolingAutosizingFactor, BackupHeatingAutosizingFactor inputs to scale HVAC equipment autosizing results. OpenStudio-HPXML: `#1561 `_, `pull request 1611 `_ @@ -262,7 +262,6 @@ Development Changelog Allow building site inputs Description: - nan Allow building site inputs; this is particularly useful when the building is located far from, or at a very different elevation than, the EPW weather station. When not provided, defaults to using EPW header values (as before). OpenStudio-HPXML: `pull request 1636 `_ @@ -280,8 +279,8 @@ Development Changelog Add SMI, MSA, Metro Status Description: - Add Metropolitan and Micropolitan Statistical Area tsv, County Metro Status tsv, and State Metro Median Income tsv - Added 3 new tsvs to support @SinounPhoung's socio-demographically differentiated Stochastic Occupant Schedule integration into ResStock + Add Metropolitan and Micropolitan Statistical Area tsv, County Metro Status tsv, and State Metro Median Income tsv. + Added 3 new tsvs to support @SinounPhoung's socio-demographically differentiated Stochastic Occupant Schedule integration into ResStock. resstock-estimation: `pull request 400 `_ @@ -298,7 +297,7 @@ Development Changelog Update water heater location Description: - Move location of out-of-unit (shared) water heaters to conditioned mechanical room + Move location of out-of-unit (shared) water heaters to conditioned mechanical room. Move out-of-unit water heaters (i.e., Water Heater In Unit=No from Location=None to Location=Conditioned Mechanical Room (corresponds to OS-HPXML location: "other heated space"). Assignees: Lixi Liu, Jeff Maguire, Anthony Fontanini @@ -314,8 +313,8 @@ Development Changelog BuildResidentialHPXML: multiple vacancy/outage periods Description: - Allow definition of multiple unavailable periods (i.e., vacancy, power outage) - Update schedules_vacancy_period and schedules_power_outage_period arguments to support multiple periods (comma-separated?). Argument schedules_power_outage_window_natvent_availability would then need to also be comma-separated? + Allow definition of multiple unavailable periods (i.e., vacancy, power outage). + Update schedules_vacancy_period and schedules_power_outage_period arguments to support multiple periods (comma-separated?). OpenStudio-HPXML: `#1618 `_, `pull request 1622 `_ @@ -332,7 +331,7 @@ Development Changelog HP backup sizing methodology Description: - Add ability to set either an "emergency" or "supplemental" heat pump backup sizing methodology + Add ability to set either an "emergency" or "supplemental" heat pump backup sizing methodology. Adds a HeatPumpBackupSizingMethodology element with choices of 'emergency' and 'supplemental'. Defaults to 'emergency', so results do not change by default. OpenStudio-HPXML: `#1322 `_, `pull request 1597 `_ @@ -350,7 +349,7 @@ Development Changelog ANSI 301-2022: load profile schedules Description: - Refrigerator energy use is now affected by its ambient temperature using hourly constant and temperature coefficients from ANSI/RESNET/ICC 301-2022 Addendum C + Refrigerator energy use is now affected by its ambient temperature using hourly constant and temperature coefficients from ANSI/RESNET/ICC 301-2022 Addendum C. Default fridge schedule is now an actuated EMS program. Daily schedule is a function of hour and space temperature. OpenStudio-HPXML: `pull request 1572 `_ @@ -368,7 +367,6 @@ Development Changelog ANSI 301-2022: load profile schedules Description: - nan Various schedule fractions/multipliers updates (e.g., appliances, lighting, fixtures, occupancy, ceiling fan). OpenStudio-HPXML: `pull request 1572 `_ @@ -386,7 +384,6 @@ Development Changelog ANSI 301-2022: load profile schedules Description: - nan For ceiling fans, add a LabelEnergyUse (W) input as an alternative to Efficiency (cfm/W). OpenStudio-HPXML: `pull request 1609 `_ @@ -404,7 +401,7 @@ Development Changelog Updating hot water fixtures multipliers based on field data. Description: - Update hot water usage multipliers based on field data rather than engineering judgement + Update hot water usage multipliers based on field data rather than engineering judgement. Update hot water usage multipliers. Using field data from 1700 water heaters in New England to come up with the distribution. Based on data collected as part of PERFORM with Michael Blonsky, who shared the distribution with us. resstock-estimation: `#289 `_, `pull request 361 `_ @@ -422,8 +419,8 @@ Development Changelog Whole MF building models: Replace building_id=ALL argument with an HPXML element Description: - Add optional switch to BuildExistingModel (defaulted to false) for modeling whole SFA/MF buildings - Replaces building_id=ALL argument with an element in the HPXML file, which allows us to perform validation specific to whole MF building simulations + Add optional switch to BuildExistingModel (defaulted to false) for modeling whole SFA/MF buildings. + Replaces building_id=ALL argument with an element in the HPXML file, which allows us to perform validation specific to whole MF building simulations. OpenStudio-HPXML: `pull request 1594 `_ @@ -440,8 +437,8 @@ Development Changelog Update characteristics using 2020 RECS v7 data Description: - Update to RECS 2020 V7 data files - Updates RECS 2020 data from v5 to v7. There are some new EV variables to be leveraged by the ResStock/TEMPO project. I am not sure what V6 was as there is no documentation. + Update to RECS 2020 V7 data files. + Updates RECS 2020 data from v5 to v7. There are some new EV variables to be leveraged by the ResStock/TEMPO project. resstock-estimation: `pull request 394 `_ @@ -458,7 +455,7 @@ Development Changelog Reorganize emissions and utility bills data folders Description: - Reorganize the emissions and utility rates data folders such that their sources and functions are more clear + Reorganize the emissions and utility rates data folders such that their sources and functions are more clear. Previously, it wasn't clear that the provided utility rate data was for demonstration purposes only. Assignees: Joe Robertson @@ -474,7 +471,7 @@ Development Changelog 2022 Cambium: add 25 year levelization scenarios Description: - Include additional 2022 Cambium 25-year LRMER emissions data + Include additional 2022 Cambium 25-year LRMER emissions data. Add 10 new "LRMER_xxx_25" data folders to resources/data/cambium/2022. Assignees: Joe Robertson @@ -490,8 +487,8 @@ Development Changelog Adding flexibility to specify location of the radiant barrier Description: - Add flexibility to specify location of the radiant barrier - Allowing Radiant Barrier for Attic Floor + Add flexibility to specify location of the radiant barrier. + Allowing Radiant Barrier for Attic Floor. OpenStudio-HPXML: `#1435 `_, `pull request 1473 `_ @@ -509,7 +506,7 @@ Development Changelog BuildResidentialHPXML: detailed performance data arguments Description: - Add ability to describe detailed performance data for variable-speed air-source HVAC systems + Add ability to describe detailed performance data for variable-speed air-source HVAC systems. Updated assumptions for variable-speed air conditioners, heat pumps, and mini-splits. Also allows detailed heating and cooling performance data (min/max COPs and capacities at different outdoor temperatures) as an optional set of inputs. Data can be sourced from e.g. NEEP's Cold Climate Air Source Heat Pump List. @@ -531,8 +528,8 @@ Development Changelog Remove old HPWH options from options_lookup Description: - Remove old HPWH options from options_lookup - Removing the old HPWH options from options_lookup.tsv + Remove old HPWH options from options_lookup. + Removing the old HPWH options from options_lookup.tsv. Assignees: Jeff Maguire