# EnergyPlus Regressions
[](https://energyplusregressiontool.readthedocs.io/en/latest/?badge=latest)
[](https://github.com/NREL/EnergyPlusRegressionTool/actions/workflows/test.yml)
[](https://github.com/NREL/EnergyPlusRegressionTool/actions/workflows/release.yml)
[](https://github.com/NREL/EnergyPlusRegressionTool/actions/workflows/flake8.yml)
[](https://coveralls.io/github/NREL/EnergyPlusRegressionTool?branch=master)
## Overview
This library provides tools for performing regressions between EnergyPlus builds.
Developers often propose changes to EnergyPlus for:
- New feature development
- Defect repair
- Refactoring for structure or performance
When a developer proposes these changes, those code changes must be tested prior to accepting them into the main branch.
A continuous integration system runs the tests and provides results, but there can be a sometimes lengthy delay waiting on those results, depending on how busy the system is at that time.
This set of tools provides a way to run these regressions locally.
## Usage
This tool works on all three major platforms: Windows, Mac, and Ubuntu (LTS).
GitHub Actions test on multiple platforms, and it is regularly used on all three as well.
To install the tool, simply `pip` install it into your Python environment (either system or virtual environment)
The project page on PyPi is: https://pypi.org/project/energyplus-regressions/.
- Download using Pip (`pip install energyplus-regressions`).
- Once installed into the Python install, there will be a binary available to run: `energyplus_regression_runner`.
## Development
For setting up a development environment to do _work_ on this tool, the steps are pretty minimal:
- Install Python, if needed
- Clone this repository (`git clone https://github.com/NREL/EnergyPlusRegressionTool`)
- Install dependencies (`pip3 install -r requirements.txt`)
## Documentation
Program documentation, including user guide and typical workflows, are available in the documentation.
This documentation is written using RST with Sphinx, and published on [ReadTheDocs](https://energyplusregressiontool.readthedocs.io/en/latest/).
## Testing
Exhaustive unit tests have been added to the "underneath the hood" code, like the functions that calculate diffs and run builds.
The unit tests are run on [Github Actions](https://github.com/NREL/EnergyPlusRegressionTool/actions).
The GUI code is not unit tested, but tested routinely on all platforms.
Raw data
{
"_id": null,
"home_page": "https://github.com/NREL/EnergyPlusRegressionTool",
"name": "energyplus-regressions",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": "",
"keywords": "energyplus_launch,ep_launch,EnergyPlus,eplus,Energy+,Building Simulation,Whole Building Energy Simulation,Heat Transfer,HVAC,Modeling",
"author": "Edwin Lee, for NREL, for United States Department of Energy",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/b0/6c/d536a0f9a8166da20dac4bc8e2b4711d78f6e0c4a99b4524ae62bf594904/energyplus_regressions-2.0.3.tar.gz",
"platform": "Linux (Tested on Ubuntu)",
"description": "# EnergyPlus Regressions\n\n[](https://energyplusregressiontool.readthedocs.io/en/latest/?badge=latest)\n[](https://github.com/NREL/EnergyPlusRegressionTool/actions/workflows/test.yml)\n[](https://github.com/NREL/EnergyPlusRegressionTool/actions/workflows/release.yml)\n[](https://github.com/NREL/EnergyPlusRegressionTool/actions/workflows/flake8.yml)\n[](https://coveralls.io/github/NREL/EnergyPlusRegressionTool?branch=master)\n\n## Overview\n\nThis library provides tools for performing regressions between EnergyPlus builds.\nDevelopers often propose changes to EnergyPlus for:\n\n - New feature development\n - Defect repair\n - Refactoring for structure or performance\n\nWhen a developer proposes these changes, those code changes must be tested prior to accepting them into the main branch.\nA continuous integration system runs the tests and provides results, but there can be a sometimes lengthy delay waiting on those results, depending on how busy the system is at that time.\nThis set of tools provides a way to run these regressions locally.\n\n## Usage\n\nThis tool works on all three major platforms: Windows, Mac, and Ubuntu (LTS).\nGitHub Actions test on multiple platforms, and it is regularly used on all three as well.\n\nTo install the tool, simply `pip` install it into your Python environment (either system or virtual environment)\nThe project page on PyPi is: https://pypi.org/project/energyplus-regressions/. \n\n - Download using Pip (`pip install energyplus-regressions`).\n - Once installed into the Python install, there will be a binary available to run: `energyplus_regression_runner`. \n\n## Development\n\nFor setting up a development environment to do _work_ on this tool, the steps are pretty minimal:\n - Install Python, if needed\n - Clone this repository (`git clone https://github.com/NREL/EnergyPlusRegressionTool`)\n - Install dependencies (`pip3 install -r requirements.txt`)\n\n## Documentation\n\nProgram documentation, including user guide and typical workflows, are available in the documentation.\nThis documentation is written using RST with Sphinx, and published on [ReadTheDocs](https://energyplusregressiontool.readthedocs.io/en/latest/).\n\n## Testing\n\nExhaustive unit tests have been added to the \"underneath the hood\" code, like the functions that calculate diffs and run builds.\nThe unit tests are run on [Github Actions](https://github.com/NREL/EnergyPlusRegressionTool/actions).\nThe GUI code is not unit tested, but tested routinely on all platforms.\n\n\n",
"bugtrack_url": null,
"license": "ModifiedBSD",
"summary": "A Python 3 library for evaluating regressions between EnergyPlus builds.",
"version": "2.0.3",
"split_keywords": [
"energyplus_launch",
"ep_launch",
"energyplus",
"eplus",
"energy+",
"building simulation",
"whole building energy simulation",
"heat transfer",
"hvac",
"modeling"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3edbaa7527777e622cadcc16f50a166305f79aeed3e417d270d4b6378b48bf94",
"md5": "db8c9a9b3be50d2674e7fbe74f9207f6",
"sha256": "a6688747455e61dcec0f7d182b95ce4a59f77102545c56028cdfc93108bb2b1e"
},
"downloads": -1,
"filename": "energyplus_regressions-2.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "db8c9a9b3be50d2674e7fbe74f9207f6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 158392,
"upload_time": "2023-04-14T15:26:51",
"upload_time_iso_8601": "2023-04-14T15:26:51.053668Z",
"url": "https://files.pythonhosted.org/packages/3e/db/aa7527777e622cadcc16f50a166305f79aeed3e417d270d4b6378b48bf94/energyplus_regressions-2.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b06cd536a0f9a8166da20dac4bc8e2b4711d78f6e0c4a99b4524ae62bf594904",
"md5": "30d576833fafc321bb9b20c34d09a0a1",
"sha256": "9e436754a6f96020d4406568748e2779418af0cce21db624e56ac3f55ea26195"
},
"downloads": -1,
"filename": "energyplus_regressions-2.0.3.tar.gz",
"has_sig": false,
"md5_digest": "30d576833fafc321bb9b20c34d09a0a1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.5",
"size": 144705,
"upload_time": "2023-04-14T15:26:52",
"upload_time_iso_8601": "2023-04-14T15:26:52.358214Z",
"url": "https://files.pythonhosted.org/packages/b0/6c/d536a0f9a8166da20dac4bc8e2b4711d78f6e0c4a99b4524ae62bf594904/energyplus_regressions-2.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-14 15:26:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "NREL",
"github_project": "EnergyPlusRegressionTool",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "energyplus-regressions"
}
JSON
