# createRulesetModelDescription
[](https://github.com/JasonGlazer/createRulesetModelDescription/actions/workflows/flake8.yml)
[](https://github.com/JasonGlazer/createRulesetModelDescription/actions/workflows/build_and_test.yml)
An EnergyPlus utility that creates an Ruleset Model Description (RMD) file based on output (and some input) from a simulation.
## Background
The RMD file is based on a schema being developed as part of the writing of ASHRAE Standard 229P:
Title:
- Protocols for Evaluating Ruleset Implementation in Building Performance Modeling Software
Purpose:
- This standard establishes tests and acceptance criteria for implementation of rulesets (e.g., modeling rules) and related reporting in building performance modeling software.
Scope:
- This standard applies to building performance modeling software that implements rulesets.
- This standard applies to rulesets associated with new or existing buildings and their systems, system controls, their sites, and other aspects of buildings described by the ruleset implementation being evaluated.
The development of the RMD schema to support the standard is going on here:
https://github.com/open229/ruleset-model-description-schema
## Overview
The utility is intended to be used at a command line prompt:
```
energyplus_create_rmd in.epJSON
```
where in.epJSON is the name of the EnergyPlus input file with path in the epJSON format.
EnergyPlus version 22.2.0 or newer is required to use the utility.
## epJSON Format
To create an epJSON file from an EnergyPlus IDF file use ConvertInputFormat.exe that comes with EnergyPlus.
To convert files, at the command prompt type:
```
ConvertInputFormat in.idf
```
Where in.idf is the name of the EnergyPlus input file with path in the IDF format. The utility will convert the file into a file with the same name
but the extension .epJSON in the JSON format.
For additional help with ConvertInputFormat at the command prompt in the directory with the EnergyPlus application, type:
```
ConvertInputFormat --help
```
## Required Input File Changes
The EnergyPlus input file has some added requirements to be used with the createRulesetModelDescription utility.
- many tabular output reports are used so the Output:Table:SummaryReports should be set to AllSummary, AllSummaryMonthly, or AllSummaryMonthlyAndSizingPeriod:
```
Output:Table:SummaryReports,
AllSummaryMonthly; !- Report 1 Name
```
Additional warning messages may appear when including the monthly predefined reports.
- the JSON output format is used so that should be enabled for both timeseries and tabular output:
```
Output:JSON,
TimeSeriesAndTabular, !- Option Type
Yes, !- Output JSON
No, !- Output CBOR
No; !- Output MessagePack
```
This will create filename_out.json files when EnergyPlus is run at the command line.
Note: This utility was designed to work with files produced using EnergyPlus at the command line. Some file renaming might be necessary if using EP-Launch.
If using EP-Launch the eplusout.json and eplusout_hourly.json files may be found in the EPTEMP directory without the specific file name.
- SI units should be used so
```
OutputControl:Table:Style,
HTML, !- Column Separator
None; !- Unit Conversion
```
- hourly output for each schedule needs to be created using the following
```
Output:Variable,
*,
schedule value,
hourly;
```
This will create filenameout_hourly.json files when EnergyPlus is run at the command line. If using EP-Launch this files may be found in the EPTEMP directory without the specific file name.
- add output schedules reports
```
Output:Schedules,
Hourly;
```
This produces a summary report in the EIO file and the Initialization Summary related to schedules. While it is not currently used by the script it probably will be used
in the future.
- add space type tags by using the Space input object
```
Space,
core_space, !- Name
Core_ZN, !- Zone Name
autocalculate, !- Ceiling Height
autocalculate, !- Volume
autocalculate, !- Floor Area {m2}
OFFICE_OPEN_PLAN, !- Space Type
OFFICE_BUILDINGS_OFFICE_SPACE, !- Tag 1
OFFICE; !- Tag 2
```
The fields should be completed as described below:
- the Space Type field should be set to the appropriate option for lighting_space_type see LightingSpaceOptions2019ASHRAE901TG37 for the list of options.
- the Tag 1 field should be set to the the appropriate option for ventilations_space_type see VentilationSpaceOptions2019ASHRAE901 for the list of options.
- the Tag 2 field should be set to the the appropriate option for service_water_heating_space_type see ServiceWaterHeatingSpaceOptions2019ASHRAE901 for the list of options.
These enumerated lists are found here:
https://github.com/open229/ruleset-model-description-schema/blob/master/docs229/Enumerations2019ASHRAE901.schema.md
If you had not been using the Space input object before, set the numeric inputs to 'autocalculate'.
It is usually easier to make these changes prior to converting the file into the epJSON format.
## Weather File
When selecting the EPW weather file, make sure the STAT file is present in the same directory. This file is needed for the fully populate the Climatic Data Summary tabular
report which is used to identify the ASHRAE climate zone.
## Output
The resulting Ruleset Model Description file will be created in the same directory as the epJSON file with the same name and the file extension .rmd
Raw data
{
"_id": null,
"home_page": "https://github.com/JasonGlazer/createRulesetModelDescription",
"name": "energyplus-ruleset-model",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "energyplus",
"author": "Jason Glazer",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/b4/04/a6a32466caf711978a2c768724ac346395e743417f78dbad40a78d8d906f/energyplus_ruleset_model-0.5.tar.gz",
"platform": null,
"description": "# createRulesetModelDescription\n\n[](https://github.com/JasonGlazer/createRulesetModelDescription/actions/workflows/flake8.yml)\n[](https://github.com/JasonGlazer/createRulesetModelDescription/actions/workflows/build_and_test.yml)\n\nAn EnergyPlus utility that creates an Ruleset Model Description (RMD) file based on output (and some input) from a simulation. \n\n## Background\n\nThe RMD file is based on a schema being developed as part of the writing of ASHRAE Standard 229P:\n\nTitle:\n\n - Protocols for Evaluating Ruleset Implementation in Building Performance Modeling Software\n\nPurpose:\n\n - This standard establishes tests and acceptance criteria for implementation of rulesets (e.g., modeling rules) and related reporting in building performance modeling software.\n\nScope:\n\n - This standard applies to building performance modeling software that implements rulesets.\n - This standard applies to rulesets associated with new or existing buildings and their systems, system controls, their sites, and other aspects of buildings described by the ruleset implementation being evaluated.\n\nThe development of the RMD schema to support the standard is going on here:\n\nhttps://github.com/open229/ruleset-model-description-schema\n\n## Overview\n\nThe utility is intended to be used at a command line prompt:\n\n```\n energyplus_create_rmd in.epJSON\n```\n\nwhere in.epJSON is the name of the EnergyPlus input file with path in the epJSON format. \n\nEnergyPlus version 22.2.0 or newer is required to use the utility.\n\n## epJSON Format\n\nTo create an epJSON file from an EnergyPlus IDF file use ConvertInputFormat.exe that comes with EnergyPlus. \n\nTo convert files, at the command prompt type:\n\n```\n ConvertInputFormat in.idf\n```\n\nWhere in.idf is the name of the EnergyPlus input file with path in the IDF format. The utility will convert the file into a file with the same name\nbut the extension .epJSON in the JSON format. \n\nFor additional help with ConvertInputFormat at the command prompt in the directory with the EnergyPlus application, type:\n\n```\n ConvertInputFormat --help\n```\n\n## Required Input File Changes\n\nThe EnergyPlus input file has some added requirements to be used with the createRulesetModelDescription utility.\n\n - many tabular output reports are used so the Output:Table:SummaryReports should be set to AllSummary, AllSummaryMonthly, or AllSummaryMonthlyAndSizingPeriod:\n\n``` \n Output:Table:SummaryReports,\n AllSummaryMonthly; !- Report 1 Name\n``` \n\nAdditional warning messages may appear when including the monthly predefined reports.\n\n - the JSON output format is used so that should be enabled for both timeseries and tabular output:\n\n``` \n Output:JSON,\n TimeSeriesAndTabular, !- Option Type\n Yes, !- Output JSON\n No, !- Output CBOR\n No; !- Output MessagePack\n```\n\nThis will create filename_out.json files when EnergyPlus is run at the command line. \n\nNote: This utility was designed to work with files produced using EnergyPlus at the command line. Some file renaming might be necessary if using EP-Launch. \nIf using EP-Launch the eplusout.json and eplusout_hourly.json files may be found in the EPTEMP directory without the specific file name.\n\n - SI units should be used so\n\n``` \n OutputControl:Table:Style,\n HTML, !- Column Separator\n None; !- Unit Conversion\n```\n - hourly output for each schedule needs to be created using the following\n \n```\n Output:Variable,\n *,\n schedule value,\n hourly;\n```\n\nThis will create filenameout_hourly.json files when EnergyPlus is run at the command line. If using EP-Launch this files may be found in the EPTEMP directory without the specific file name.\n\n - add output schedules reports\n \n```\n Output:Schedules,\n Hourly;\n```\n\nThis produces a summary report in the EIO file and the Initialization Summary related to schedules. While it is not currently used by the script it probably will be used \nin the future.\n\n\n - add space type tags by using the Space input object\n\n```\n Space,\n core_space, !- Name\n Core_ZN, !- Zone Name\n autocalculate, !- Ceiling Height\n autocalculate, !- Volume\n autocalculate, !- Floor Area {m2}\n OFFICE_OPEN_PLAN, !- Space Type\n OFFICE_BUILDINGS_OFFICE_SPACE, !- Tag 1\n OFFICE; !- Tag 2\n```\n\nThe fields should be completed as described below:\n\n - the Space Type field should be set to the appropriate option for lighting_space_type see LightingSpaceOptions2019ASHRAE901TG37 for the list of options.\n - the Tag 1 field should be set to the the appropriate option for ventilations_space_type see VentilationSpaceOptions2019ASHRAE901 for the list of options.\n - the Tag 2 field should be set to the the appropriate option for service_water_heating_space_type see ServiceWaterHeatingSpaceOptions2019ASHRAE901 for the list of options.\n\nThese enumerated lists are found here:\n\nhttps://github.com/open229/ruleset-model-description-schema/blob/master/docs229/Enumerations2019ASHRAE901.schema.md\n\nIf you had not been using the Space input object before, set the numeric inputs to 'autocalculate'.\n\nIt is usually easier to make these changes prior to converting the file into the epJSON format.\n\n## Weather File\n\nWhen selecting the EPW weather file, make sure the STAT file is present in the same directory. This file is needed for the fully populate the Climatic Data Summary tabular \nreport which is used to identify the ASHRAE climate zone.\n\n## Output\n\nThe resulting Ruleset Model Description file will be created in the same directory as the epJSON file with the same name and the file extension .rmd\n\n\n\n\n",
"bugtrack_url": null,
"license": "ModifiedBSD",
"summary": "A Python tool for generating RMDs.",
"version": "0.5",
"split_keywords": [
"energyplus"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e262c0d807e6b43f39854f35f3fe58e9bebae59ba3dda881ab4b7dd03dd63d38",
"md5": "bbed357df15bd510f323af13973d2cc9",
"sha256": "02a8f0432892c01df54d75db5a8b889d9fdd52fe58df1ea1ce32d7c1d0b527ef"
},
"downloads": -1,
"filename": "energyplus_ruleset_model-0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bbed357df15bd510f323af13973d2cc9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 17211,
"upload_time": "2023-04-14T16:23:34",
"upload_time_iso_8601": "2023-04-14T16:23:34.054801Z",
"url": "https://files.pythonhosted.org/packages/e2/62/c0d807e6b43f39854f35f3fe58e9bebae59ba3dda881ab4b7dd03dd63d38/energyplus_ruleset_model-0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b404a6a32466caf711978a2c768724ac346395e743417f78dbad40a78d8d906f",
"md5": "a86f7bca5fcfd89397424c704f3cd8d6",
"sha256": "9ba091f225fa03949b2fc7e6f6263f59b5c8216b8ad6876cfc0e062d84da96dc"
},
"downloads": -1,
"filename": "energyplus_ruleset_model-0.5.tar.gz",
"has_sig": false,
"md5_digest": "a86f7bca5fcfd89397424c704f3cd8d6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 17488,
"upload_time": "2023-04-14T16:23:35",
"upload_time_iso_8601": "2023-04-14T16:23:35.438679Z",
"url": "https://files.pythonhosted.org/packages/b4/04/a6a32466caf711978a2c768724ac346395e743417f78dbad40a78d8d906f/energyplus_ruleset_model-0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-14 16:23:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "JasonGlazer",
"github_project": "createRulesetModelDescription",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "energyplus-ruleset-model"
}
JSON
