Skip to content

Commit

Permalink
Merge pull request #241 from jsiirola/pr-template
Browse files Browse the repository at this point in the history
Add a PR template, update README formatting
  • Loading branch information
bknueven authored Jul 13, 2021
2 parents fe51d24 + 45ca6b2 commit 1ca3d8a
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 12 deletions.
15 changes: 15 additions & 0 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
## Fixes # .

## Summary/Motivation:


## Changes proposed in this PR:
-
-

### Legal Acknowledgement

By contributing to this software project, I have read the [contribution guide](https://github.com/grid-parity-exchange/Egret/blob/main/CONTRIBUTING.md) and agree to the following terms and conditions for my contribution:

1. I agree my contributions are submitted under the BSD license.
2. I represent I am authorized to make the contributions and grant the license. If my employer has rights to intellectual property that includes these contributions, I represent that I have received permission to make contributions and grant the required license on behalf of that employer.
25 changes: 13 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Major features:
* Generic handling of data across model formulations
* Declarative model representation to support formulation development

EGRET is available under the BSD License (see LICENSE.txt)
EGRET is available under the BSD License (see [LICENSE.txt](https://github.com/grid-parity-exchange/Egret/blob/main/LICENSE.txt))

### Installation

Expand All @@ -20,7 +20,7 @@ EGRET is available under the BSD License (see LICENSE.txt)
* Download (or clone) EGRET from this GitHub site.
* From the main EGRET folder (i.e., the folder containing setup.py), use a terminal (or the Anaconda prompt for Windows users) to run setup.py to install EGRET into your Python installation - as follows:

pip install -e .
pip install -e .

### Requirements

Expand All @@ -31,27 +31,28 @@ EGRET is available under the BSD License (see LICENSE.txt)

We additionally recommend that EGRET users install the open source CBC MIP solver. The specific mechanics of installing CBC are platform-specific. When using Anaconda on Linux and Mac platforms, this can be accomplished simply by:

conda install -c conda-forge coincbc
conda install -c conda-forge coincbc

The COIN-OR organization - who developers CBC - also provides pre-built binaries for a full range of platforms on https://bintray.com/coin-or/download.

### Testing the Installation

To test the functionality of the unit commitment aspects of EGRET, execute the following command from the EGRET models/tests sub-directory:

pytest test_unit_commitment.py
pytest test_unit_commitment.py

If EGRET can find a commerical MIP solver on your system via Pyomo, EGRET will execute a large test suite including solving several MIPs to optimality. If EGRET can only find an open-source solver, it will execute a more limited test suite which mostly relies on solving LP relaxations. Example output is below.

=================================== test session starts ==================================<br/>
platform darwin -- Python 3.7.7, pytest-5.4.2, py-1.8.1, pluggy-0.13.0<br/>
rootdir: /home/some-user/egret<br/>
collected 21 items<br/>
<br/>
test_unit_commitment.py s.................... [100%]<br/>
<br/>
========================= 20 passed, 1 skipped in 641.80 seconds =========================<br/>
```
=================================== test session starts ==================================
platform darwin -- Python 3.7.7, pytest-5.4.2, py-1.8.1, pluggy-0.13.0
rootdir: /home/some-user/egret
collected 21 items
test_unit_commitment.py s.................... [100%]
========================= 20 passed, 1 skipped in 641.80 seconds =========================
```

### How to Cite EGRET in Your Research

Expand Down

0 comments on commit 1ca3d8a

Please sign in to comment.