Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
andrewlyden authored Jun 17, 2024
1 parent c58b125 commit 60b7b8d
Showing 1 changed file with 24 additions and 1 deletion.
25 changes: 24 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,9 @@ This tool was developed as part of a PhD, "Modelling and Design of Local Energy
git clone git@github.com:andrewlyden/PyLESA.git
```

3. Install the `PyLESA` python virtual environment. If using Linux:
3. Install the `PyLESA` python virtual environment.

If using Linux:
```
python3.10 -m venv venv
source venv/bin/activate
Expand All @@ -38,12 +40,22 @@ python -m pip install -r requirements.txt

6. Using a terminal (e.g. PowerShell) within the clone of the `PyLESA` git repo, run:

If using Linux:

```python
source venv/bin/activate
python -m pylesa --help # to display help messages
python -m pylesa ./inputs/{name of Excel input file}.xlsx my/existing/output/directory --overwrite
```

If using Windows and Powershell:

```python
.\venv\Scripts\activate.ps1
python -m pylesa --help # to display help messages
python -m pylesa ./inputs/{name of Excel input file}.xlsx my/existing/output/directory --overwrite
```

Running `python -m pylesa --help` will display the following help message:
![pylesa usage](./img/pylesa_usage.png)

Expand All @@ -54,13 +66,24 @@ A video discussing how to run `PyLESA` is available here: https://youtu.be/QsJut
## Testing
The `PyLESA` source code is tested using [pytest](https://docs.pytest.org/en/8.2.x/). The tests can be run locally by running the following command:

If using Linux:

```python
source venv/bin/activate
python -m pytest -svv
# for test coverage reporting run:
python -m pytest --cov=pylesa -svv --cov-report term-missing
```

If using Windows and Powershell:

```python
.\venv\Scripts\activate.ps1
python -m pytest -svv
# for test coverage reporting run:
python -m pytest --cov=pylesa -svv --cov-report term-missing
```

## References

PhD Thesis - Modelling and design of local energy systems incorporating heat pumps, thermal storage, future tariffs, and model predictive control (https://doi.org/10.48730/8nz5-xb46)
Expand Down

0 comments on commit 60b7b8d

Please sign in to comment.