Skip to content

Commit 60aecf5

Browse files
authored
Merge pull request #1885 from pnnl/RCT/JDJ/update-README
RCT/JDJ/update readme
2 parents 81812ba + 9305646 commit 60aecf5

File tree

1 file changed

+24
-11
lines changed

1 file changed

+24
-11
lines changed

README.md

Lines changed: 24 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -28,11 +28,16 @@ Ruleset Checking Tool for ANSI/ASHRAE/IES Standard 90.1-2019 Appendix G
2828
This package provides a reference implementation of a Ruleset Checking Tool (RCT) in support of ASHRAE Standard 229P. The RCT is not intended to be a normative part of the proposed standard, so use with Std 229P is optional. This RCT implementation is specific to ANSI/ASHRAE/IES Standard 90.1-2019 Appendix G and does not support any other rulesets. Final release of this package is dependent upon acceptance and publication of ASHRAE Standard 229P.
2929

3030
## Install it from PyPI
31-
31+
By default, the package includes the ASHRAE 90.1-2019 PRM ruleset.
3232
```bash
3333
pip install ruleset-checking-tool
3434
```
3535

36+
To install additional rulesets, you can install them as optional dependencies. For example, to install the ASHRAE 90.1-2022 ruleset, you can run:
37+
```bash
38+
pip install ruleset-checking-tool[ashrae9012022]
39+
```
40+
3641
## Usage
3742

3843
```py
@@ -113,17 +118,25 @@ The following provides some useful commands as you get started developing the RC
113118
This package is developed using Poetry to manage packages during the build process. First, follow the instruction from [poetry](https://python-poetry.org/docs/) to install the package.
114119
Any new dependencies that are added to the package must be included in the pyproject.toml. The package is currently being developed for Python 3.10. This version of Python must be installed on your machine for Poetry to work properly.
115120

116-
Now tests can be run by first installing dependencies and then running pytest.
117-
1. `poetry install`
118-
2. `poetry run pytest`
119-
- To see a coverage report, use `poetry run pytest --cov`
120-
- To have pytest watch for file changes, use `poetry run ptw`
121+
By default, the RCT package includes the ASHRAE 90.1-2019 PRM ruleset.
122+
`poetry install`
123+
124+
To install additional rulesets, you can install them as optional dependencies. For example, to install the ASHRAE 90.1-2022 ruleset, you can run:
125+
`poetry install --extras ashrae9012022`
126+
127+
You can also install all available rulesets by running:
128+
`poetry install --all-extras`
129+
130+
Now tests can be run by first installing dependencies and then running pytest.
131+
`poetry run pytest`
132+
- To see a coverage report, use `poetry run pytest --cov`
133+
- To have pytest watch for file changes, use `poetry run ptw`
121134

122-
You can also package with poetry to test the CLI tool.
123-
2. `poetry run rct229 test`
135+
You can also package with poetry to test the CLI tool.
136+
`poetry run rct229 test`
124137

125-
Run with example ASHRAE 90.1 2019 RPDs.
126-
1. `poetry run rct229 evaluate -rs ashrae9012019 -f examples\chicago_demo\baseline_model.json -f examples\chicago_demo\proposed_model.json -f examples\chicago_demo\user_model.json -r ASHRAE9012019_DETAIL`
138+
Run with example ASHRAE 90.1 2019 RPDs.
139+
`poetry run rct229 evaluate -rs ashrae9012019 -f examples\chicago_demo\baseline_model.json -f examples\chicago_demo\proposed_model.json -f examples\chicago_demo\user_model.json -r ASHRAE9012019_DETAIL`
127140

128141

129142
### Developer Notes
@@ -165,7 +178,7 @@ Before committing changes you should run the following commands from the `rulese
165178
2. Add a new item to the `rules_dict` in the rulset's `rct229/rulesets/<RULESET>/__init__.py` file with the unique rule ID and desired rule section and number.
166179
3. Create the new rule module in the ruleset directory following the typical procedure, but using the unique rule ID as the rule's class name.
167180
```python
168-
class PRM9012019Rule86h31(RuleDefinitionBase):
181+
class PRM9012019Rule86h31(RuleDefinitionBase):
169182
```
170183

171184
- For renumbering a rule to remain in the same section:

0 commit comments

Comments
 (0)