JOSS paper submission

.github/workflows/draft-pdf.yml

@@ -0,0 +1,23 @@
+on: [push]
+
+jobs:
+  paper:
+    runs-on: ubuntu-latest
+    name: Paper Draft
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Build draft PDF
+        uses: openjournals/openjournals-draft-action@master
+        with:
+          journal: joss
+          # This should be the path to the paper within your repo.
+          paper-path: ./docs/paper.md
+      - name: Upload
+        uses: actions/upload-artifact@v1
+        with:
+          name: paper
+          # This is the output path where Pandoc will write the compiled
+          # PDF. Note, this should be the same directory as the input
+          # paper.md
+          path: ./docs/paper.pdf

docs/paper.bib

@@ -0,0 +1,41 @@
+@misc {90.1,
+    title={ANSI/ASHRAE/IES 90.1-2019, Energy Standard for Buildings Except Low-Rise Residential Buildings},
+    author={{ASHRAE}},
+    organization={ASHRAE},
+    institution={ASHRAE},
+    address={Atlanta, GA},
+    year={2019}
+}
+
+@misc{tspr,
+    title={TSPR Washington State Analysis Tool},
+    author={{Pacific Northwest National Laboratory}},
+    howpublished={\url{https://energycode.pnl.gov/HVACSystemPerformance/}},
+    note={Accessed: 2024-04-044}
+}
+
+@report{impl_ctrl,
+    title={Implementation of Energy Code Controls Requirements in New Commercial Buildings},
+    author={{Rosenberg, M.I., P.R. Hart, M. Hatten, D. Jones, and M. Cooper}},
+    year={2017}
+}
+
+@report{impa_ctrl,
+    title={Impacts of commercial building controls on energy savings and peak load reduction},
+    author={{Fernandez, Nicholas EP, et al.}},
+    year={2017}
+}
+
+@misc{os,
+    title={OpenStudio},
+    author={{National Renewable Energy Laboratory, Argonne National Laboratory, Lawrence Berkeley National Laboratory, Oak Ridge National Laboratory, Pacific Northwest National Laboratory}},
+    howpublished={\url{https://openstudio.net/}},
+    note={Accessed: 2024-04-04}
+}
+
+@misc{osm,
+    title={OpenStudio SDK User Docs: Getting Started - About Measures},
+    author={{National Renewable Energy Laboratory, Argonne National Laboratory, Lawrence Berkeley National Laboratory, Oak Ridge National Laboratory, Pacific Northwest National Laboratory}},
+    howpublished={\url{https://nrel.github.io/OpenStudio-user-documentation/getting_started/about_measures/}},
+    note={Accessed: 2024-05-28}
+}

docs/paper.md

@@ -0,0 +1,53 @@
+---
+title: 'Control Strainer (ConStrain): a data-driven control verification framework'
+tags:
+  - python
+  - energy
+  - building
+  - control
+  - simulation
+  - hvac
+authors:
+  - name: Xuechen Lei
+    orcid: 0000-0003-3310-9750
+    affiliation: 1
+  - name: Jérémy Lerond
+    orcid: 0000-0002-1630-6886
+    affiliation: 1
+  - name: Yun Joon Jung
+    orcid: 0000-0003-1311-8932
+    affiliation: 1
+  - name: Julian Slane-Holloway
+    orcid: 0009-0008-9572-9123
+    affiliation: 1
+  - name: Fan Feng
+    orcid: 0000-0002-6230-0063
+    affiliation: 1
+  - name: Yan Chen
+    orcid: 0000-0002-2988-9136
+    affiliation: 1
+
+affiliations:
+ - name: Pacific Northwest National Laboratory, Richland, WA, USA
+   index: 1
+date: 28 May 2024
+bibliography: paper.bib
+---
+
+# Summary
+
+The Control Strainer, or `ConStrain`, is a python-based framework that can be used by energy modelers, building engineers, and researchers to conduct consistent and automated verification of building system controls using either timeseries generated from whole-building energy simulations or from actual building automation system trend data. `ConStrain` is made of two distinct components: an expandable control verification algorithms library, and a standardized performance evaluation and reporting workflow framework. At its roots, `ConStrain`'s verification library was developed with the verification of control related building energy code requirements in mind, but it is built such that its library is expandable and can cover user-customized control verifications.
+
+# Statement of need
+
+Advances in building control have shown significant potential for improving building energy performance and decarbonization. Studies show that designs utilizing optimized controls that are properly tuned could cut commercial building energy consumption by approximately 29% - equivalent to 4-5 Quads, or 4-5% of the energy consumed in the United States [@impa_ctrl]. Driven by the significant control-related energy-saving potential, commercial building energy codes (such as American Society of Heating, Refrigerating and Air-Conditioning Engineers (ASHRAE) 90.1 [@90.1]) have progressed with many control-related addenda. For example, from the publication of 90.1-2004 to 90.1-2016 (four code cycles), 30% of the new requirements are related to building control (with most of them focused on Heating, Ventilation, and Air Conditioning (HVAC) system control) [@impl_ctrl].
+
+However, one of the challenges to realizing those savings is the correct implementation of such advanced control strategies and regularly verifying their actual operational performance. A field study found that only 50% of systems observed have their control system correctly configured to meet the energy codes requirement, and control-related compliance verification is typically not included in the commissioning scope. Current control verification is often conducted manually, which is time-consuming, ad-hoc, incomplete, and error-prone.
+
+`ConStrain` can be used as a standalone tool and, with its Python Application Programming Interface (API), can also be integrated into established workflows of third-party tools and practices. For instance, `ConStrain` has been successfully integrated as part of the continuous integration software development process of whole-building energy simulation-based software tool (e.g., Washington State's Total System Performance Ratio Analysis Tool [@tspr]) to make sure that software code contributions as well as simulation software updates do not have unexpected impacts on the simulated performance of building system controls. Moreover, a set of `OpenStudio` [@os] measures [@osm] have also been developed to enable building energy modelers using `OpenStudio` to have access to perform verification on their models with minimal configurations required.
+
+# Acknowledgements
+
+ConStrain was developed at the Pacific Northwest National Laboratory and was funded under contract with the U.S. Department of Energy (DOE). It is actively being developed as an open-source project.
+
+# References