A software for sizing Heat Pump Water Heaters for buildings
Project description
EcosizerEngine
Requirements:
This software requires a python version greater than or equal to 3.11 to be installed in the environment it is running in.
Using the package in scripts:
-
Install the package with pip
$ pip install ecoengine
-
To import and use the tools in this package, add the following import statement to your script:
from ecoengine import *
You should now be able to use the features of EcosizerEngine in your script
Running locally in a container:
First, clone the EcosizerEngine repo from github
$ git clone https://github.com/EcotopeResearch/EcosizerEngine.git
Depending on what type of environment you want to run the code in, please follow the appropriate steps.
Steps for installing in a virtual environment:
-
Navigate to the EcosizerEngine directory. This should be the same directory level as src/, setup.py, and this README document.
-
Run the following command:
$ pip install -e .
This will install the ecosizer-engine package locally in editable format, such that changes you make in the source code here will be reflected in implementation. This pip install should also install all dependencies for ecosizer-engine (i.e. numpy, scipy, pytest, and plotly)
Steps for installing using docker container:
-
Navigate to the EcosizerEngine directory.
-
Build container with docker file
$ docker build -t ecosizerengine:latest .
-
Run docker container
$ docker run -it ecosizerengine bash
-
When you are done messing about in the docker image, just type the command
$ exit
or press ctrl+c then ctrl+d
Steps for installing conda environment from the Anaconda prompt:
-
Navigate to the EcosizerEngine directory.
-
Create new environment from .yml file.
$ conda env create --file EcosizerEngine.yml
If the environment creation doesn't work, make sure Anaconda is up-to-date with
$ conda update --all
If that doesn't work, you may need to force Anaconda to download and use python 3.11 (it defaults to 3.9) by making another environment
$ conda create -n py311 python=3.11
$ conda activate py311
$ conda env create --file EcosizerEngine.yml
-
Check that the environment was created
$ conda env list
-
Activate the new environment
$ conda activate EcosizerEngine
If an environment already exits it can be removed with:
$ conda remove --name EcosizerEngine --all
All the available environment can be found with:
$ conda env list
Testing:
From the parent directory, type
$ python -m pytest
This will run all unit tests for the package
Updating Documentation:
-
If not installed in environment: pip install sphinx and numpydocs
-
navigate to docs directory and run:
$ make html
Updating version on pypi
-
If you haven't installed them before, pip install build and twine
$ python -m pip install --upgrade build
$ python -m pip install --user --upgrade twine
-
Update the version number in setup.cfg
-
Run the following commands from the project root directory:
$ python -m build
$ python -m twine upload dist/*
Contact Information
To get in touch with Ecotope Inc. go here: http://ecotope.com/contact/
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ecoengine-1.0.9-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9f4e2a8c0ff296040356238bf8df07c80949e6a3e6079709e5f8457a5773d7c8 |
|
MD5 | ba8091675f6422c69b0f65d138dee295 |
|
BLAKE2b-256 | bcad073a8840c1ac1308588ad3639651a696537a20f5f3e4e29bb7e4a04b1375 |