Table of Contents
pip install stor4buildThe stor4build command includes three subcommands at this time:
run-icetank- Runs the chiller-based ice tank Python plugin case with a specified capacity. Using--chwwill use the chilled water version.size-icetank- Runs the chiller-based ice tank Python plugin case with a size based on the baseline model and discharge window parameters. Using--chwwill use the chilled water version.run-dxcoil- Runs the native E+ DX coil packaged ice TES system with autosizing.
Further information is available with the --help option.
To set up a Visual Studio Code development environment, first install Python. Then install Visual Studio code and the Python extension(s) from Microsoft. Next, install hatch with
pip install hatchClone the repository to the location of your choice and open the directory with Visual Studio Code. In the root folder of the repo, execute the following to generate an environment that has everything that is needed:
hatch env createTo point Visual Studio Code at the created environment, find the environment with
hatch run python -c "import sys;print(sys.executable)"and copy the result. In Visual Studio Code, hit ctrl-shift-P to bring up the command palette, select "Python: Select Interpreter", and paste in the result from above. Any warnings (yellow squiqqly underlines) in the source files should go away. To make sure that everything has worked, run
hatch shellto enter the environment that was created, and then execute
stor4build --helpYou should see the help output from the tool.
A simple flask-based web api is included. To run it, a PostgreSQL database storing the baseline models and weather is required. That setup is not described here yet. The following four environment variables need to be set:
FLASK_TIMESCALE_HOST
FLASK_TIMESCALE_DB
FLASK_TIMESCALE_USERNAME
FLASK_TIMESCALE_PASSWORD
Standard password rules apply. To launch the back end (that does the calculation) run
flask --app stor4build.api runThis will start up the flask development server and output will appear on the console. The API accepts JSON inputs in the form described in the schema directory in the file stor4build.json. Example inputs and scripts to send them to the API are in the resources and scripts directories.
| Prototype | Supported TES |
|---|---|
| SecondarySchool | DX coil packaged ice |
| PrimarySchool | DX coil packaged ice |
| SmallOffice | DX coil packaged ice |
| MediumOffice | DX coil packaged ice |
| LargeOffice | ThermalTank |
| SmallHotel | DX coil packaged ice |
| LargeHotel | ThermalTank |
| Warehouse | DX coil packaged ice |
| RetailStandalone | DX coil packaged ice |
| RetailStripmall | DX coil packaged ice |
| QuickServiceRestaurant | DX coil packaged ice |
| FullServiceRestaurant | DX coil packaged ice |
| MidriseApartment | TBD |
| HighriseApartment | TBD |
| Hospital | ThermalTank |
| Outpatient | DX coil packaged ice |
| Laboratory | DX coil packaged ice |
| LargeDataCenterHighITE | ThermalTank |
| LargeDataCenterLowITE | ThermalTank |
| SmallDataCenterHighITE | TBD |
| SmallDataCenterLowITE | TBD |
| Courthouse | ThermalTank |
| College | ThermalTank |
stor4build is distributed under the terms of the BSD-3-Clause license.