OS-HPXML 1.11

.github/workflows/config.yml

@@ -14,23 +14,31 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
   cancel-in-progress: true
 
+env:
+  OS_VERSION: "3.11.0"
+  OS_SHA: 241b8abb4d
+  OS_URL: https://github.com/NREL/OpenStudio/releases/download
+
 jobs:
   run-ruleset-tests:
-    runs-on: ubuntu-22.04
-    container:
-      image: docker://nrel/openstudio:3.10.0
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
         with:
           ref: ${{ github.head_ref }}
 
       - name: Install software
         run: |
-          rm -f Gemfile.lock && bundle install
           export DEBIAN_FRONTEND=noninteractive
           sudo apt update
           sudo -E apt-get install -y wget unzip python3-sphinx-rtd-theme
 
+      - name: Install OpenStudio
+        run: |
+          wget -q -O OpenStudio.deb ${OS_URL}/v${OS_VERSION}/OpenStudio-${OS_VERSION}+${OS_SHA}-Ubuntu-24.04-x86_64.deb
+          sudo dpkg -i OpenStudio.deb
+          rm OpenStudio.deb
+
       - name: Check HPXMLs
         shell: bash
         run: |
@@ -43,13 +51,7 @@ jobs:
 
       - name: Run ruleset tests
         run: |
-          bundle exec rake test_rulesets
-
-      - name: Store code coverage
-        uses: actions/upload-artifact@v4
-        with:
-          path: coverage
-          name: coverage
+          openstudio tasks.rb ruleset_tests
 
       - name: Build documentation
         run: |
@@ -68,21 +70,21 @@ jobs:
           path: docs/_build/html/
 
   run-sample-files1-tests:
-    runs-on: ubuntu-22.04
-    container:
-      image: docker://nrel/openstudio:3.10.0
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
         with:
           ref: ${{ github.head_ref }}
 
-      - name: Install software
+      - name: Install OpenStudio
         run: |
-          rm -f Gemfile.lock && bundle install
+          wget -q -O OpenStudio.deb ${OS_URL}/v${OS_VERSION}/OpenStudio-${OS_VERSION}+${OS_SHA}-Ubuntu-24.04-x86_64.deb
+          sudo dpkg -i OpenStudio.deb
+          rm OpenStudio.deb
 
       - name: Run Sample Files 1 tests
         run: |
-          bundle exec rake test_sample_files1
+          openstudio tasks.rb sample_files_tests1
 
       - name: Store results
         uses: actions/upload-artifact@v4
@@ -91,21 +93,21 @@ jobs:
           name: test_results_sample_files1
 
   run-sample-files2-tests:
-    runs-on: ubuntu-22.04
-    container:
-      image: docker://nrel/openstudio:3.10.0
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
         with:
           ref: ${{ github.head_ref }}
 
-      - name: Install software
+      - name: Install OpenStudio
         run: |
-          rm -f Gemfile.lock && bundle install
+          wget -q -O OpenStudio.deb ${OS_URL}/v${OS_VERSION}/OpenStudio-${OS_VERSION}+${OS_SHA}-Ubuntu-24.04-x86_64.deb
+          sudo dpkg -i OpenStudio.deb
+          rm OpenStudio.deb
 
       - name: Run Sample Files 2 tests
         run: |
-          bundle exec rake test_sample_files2
+          openstudio tasks.rb sample_files_tests2
 
       - name: Store results
         uses: actions/upload-artifact@v4
@@ -114,21 +116,21 @@ jobs:
           name: test_results_sample_files2
 
   run-real-home-tests:
-    runs-on: ubuntu-22.04
-    container:
-      image: docker://nrel/openstudio:3.10.0
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
         with:
           ref: ${{ github.head_ref }}
 
-      - name: Install software
+      - name: Install OpenStudio
         run: |
-          rm -f Gemfile.lock && bundle install
+          wget -q -O OpenStudio.deb ${OS_URL}/v${OS_VERSION}/OpenStudio-${OS_VERSION}+${OS_SHA}-Ubuntu-24.04-x86_64.deb
+          sudo dpkg -i OpenStudio.deb
+          rm OpenStudio.deb
 
       - name: Run Real Home tests
         run: |
-          bundle exec rake test_real_homes
+          openstudio tasks.rb real_home_tests
 
       - name: Store results
         uses: actions/upload-artifact@v4
@@ -137,21 +139,21 @@ jobs:
           name: test_results_real_homes
 
   run-other-tests:
-    runs-on: ubuntu-22.04
-    container:
-      image: docker://nrel/openstudio:3.10.0
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
         with:
           ref: ${{ github.head_ref }}
 
-      - name: Install software
+      - name: Install OpenStudio
         run: |
-          rm -f Gemfile.lock && bundle install
+          wget -q -O OpenStudio.deb ${OS_URL}/v${OS_VERSION}/OpenStudio-${OS_VERSION}+${OS_SHA}-Ubuntu-24.04-x86_64.deb
+          sudo dpkg -i OpenStudio.deb
+          rm OpenStudio.deb
 
       - name: Run Other tests
         run: |
-          bundle exec rake test_other
+          openstudio tasks.rb other_tests
 
       - name: Store results
         uses: actions/upload-artifact@v4
@@ -165,18 +167,22 @@ jobs:
       - uses: actions/checkout@v4
         with:
           ref: ${{ github.head_ref }}
-      - name: Install software and run test
+      - name: Install software
         shell: pwsh
         run: |
-          $env:OS_VERSION="3.10.0"
-          $env:OS_SHA="86d7e215a1"
-          Invoke-WebRequest -OutFile Windows.tar.gz -URI "https://github.com/NREL/OpenStudio/releases/download/v${env:OS_VERSION}/OpenStudio-${env:OS_VERSION}+${env:OS_SHA}-Windows.tar.gz"
+          Invoke-WebRequest -OutFile Windows.tar.gz -URI "${env:OS_URL}/v${env:OS_VERSION}/OpenStudio-${env:OS_VERSION}+${env:OS_SHA}-Windows.tar.gz"
           tar -xzf Windows.tar.gz
-          & .\OpenStudio-${env:OS_VERSION}+${env:OS_SHA}-Windows\bin\openstudio.exe workflow\energy_rating_index.rb -x workflow\sample_files\base.xml --daily ALL --add-component-loads --diagnostic-output
-          & .\OpenStudio-${env:OS_VERSION}+${env:OS_SHA}-Windows\bin\openstudio.exe workflow\energy_rating_index.rb -x workflow\sample_files\base-versions-multiple-sf.xml
+      - name: Run simulation test
+        shell: pwsh
+        run: |
+          & .\OpenStudio-${env:OS_VERSION}+${env:OS_SHA}-Windows\bin\openstudio.exe workflow\energy_rating_index.rb -x workflow\sample_files\base.xml --diagnostic-output
+      - name: Run simulation test2
+        shell: pwsh
+        run: |
+          & .\OpenStudio-${env:OS_VERSION}+${env:OS_SHA}-Windows\bin\openstudio.exe workflow\energy_rating_index.rb -x workflow\sample_files\base-versions-multiple-sf.xml --daily ALL --add-component-loads
 
   merge-results:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     needs: [run-sample-files1-tests, run-sample-files2-tests, run-real-home-tests, run-other-tests]
     steps:
       - uses: actions/checkout@v4
@@ -213,7 +219,7 @@ jobs:
 
   compare-results:
     if: github.event_name == 'pull_request'
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     needs: merge-results
     steps:
       - uses: actions/checkout@v4
@@ -263,7 +269,7 @@ jobs:
           name: comparisons
 
   update-results:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     needs: merge-results
     steps:
       - uses: actions/checkout@v4

Changelog.md

@@ -1,6 +1,9 @@
 ## OpenStudio-ERI v1.12.0
 
 __New Features__
+- Updates to OpenStudio 3.11/EnergyPlus 25.2.
+- Updates to HPXML v5.0-rc1.
+  - **Breaking change**: HPXML namespace changed from http://hpxmlonline.com/2023/09 to http://hpxmlonline.com/2025/12.
 - The `NominalCapacity` input for batteries is no longer used.
 
 ## OpenStudio-ERI v1.11.1

docs/source/usage_instructions.rst

@@ -6,7 +6,7 @@ Setup
 
 To get started:
 
-#. Either download `OpenStudio 3.10.0 <https://github.com/NREL/OpenStudio/releases/tag/v3.10.0>`_ and install the Command Line Interface/EnergyPlus components, or use the `nrel/openstudio docker image <https://hub.docker.com/r/nrel/openstudio>`_.
+#. Either download `OpenStudio 3.11.0 <https://github.com/NREL/OpenStudio/releases/tag/v3.11.0>`_ and install the Command Line Interface/EnergyPlus components, or use the `nrel/openstudio docker image <https://hub.docker.com/r/nrel/openstudio>`_.
 #. Download the `latest release <https://github.com/NREL/OpenStudio-ERI/releases>`_ release.
 
 .. note::