[](https://github.com/blue-marble/gridpath/actions/workflows/test_gridpath.yml)
[](https://gridpath.readthedocs.io/en/latest/?badge=latest)
[](https://coveralls.io/github/blue-marble/gridpath?branch=main)
[](https://github.com/psf/black)
[](https://github.com/blue-marble/gridpath/actions/workflows/black.yml)
[](https://zenodo.org/badge/latestdoi/65574330)
# Welcome to GridPath
<p align="center" width="100%">
<img src="https://github.com/blue-marble/gridpath/blob/main/doc/graphics/gridpath_logo.png?raw=true" width="20%"/>
</p>
GridPath is a versatile power-system planning platform capable of a range of
planning approaches including production-cost, capacity-expansion,
asset-valuation, and reliability modeling.
# Documentation
GridPath's documentation is hosted on [Read the Docs](https://gridpath.readthedocs.io/en/latest/).
# Installation
## Python
GridPath is tested on Python 3.9, 3.10, and 3.11. Get one of those Python versions [here](https://www.python.org/downloads/ "Python download").
## GridPath Python environment
You should create a Python environment for your GridPath installation, e.g. via
`venv`, [a lightweight environment manager](https://docs.python.org/3/library/venv.html "venv")
that is part of the standard Python distribution. Make sure to [create](https://docs.python.org/3/library/venv.html#creating-virtual-environments "create") [activate](https://docs.python.org/3/library/venv.html#how-venvs-work "activate") the environment before installing GridPath.
## Install GridPath from PyPi
Once you have _created and activated_ the GridPath Python environment, you
can install the latest version of GridPath from PyPi with:
```bash
pip install GridPath
```
## Install GridPath from source
You can alternatively download the GridPath source code and install from
source.
```bash
pip install .[all]
```
**NOTE:** If you plan to edit the GridPath code, you should install with the `-e` flag.
## Solver
You will need a solver to use this platform. GridPath assumes you will be using Cbc (Coin-or branch and cut) by default, but you can specify a
different solver.
# Usage
## The gridpath_run and gridpath_run_e2e commands
If you install GridPath via the setup script following the instructions above,
you can use the command `gridpath_run` to run a scenario from any directory
-- as long as your GridPath Python environment is enabled -- as follows:
```bash
gridpath_run --scenario SCENARIO_NAME --scenario_location
/PATH/TO/SCENARIO
```
If you are using the database, you can use the command `gridpath_run_e2e` to
run GridPath end-to-end, i.e. get inputs for the scenario from the database,
solve the scenario problem, import the results into the database, and
process them. Refer to the documentation for how to build the database.
```bash
gridpath_run_e2e --scenario SCENARIO_NAME --scenario_location
/PATH/TO/SCENARIO
```
To see usage and other optional arguments, e.g. how to specify a
solver, check the help menu, e.g.:
```bash
gridpath_run --help
```
Raw data
{
"_id": null,
"home_page": "https://www.gridpath.io",
"name": "GridPath",
"maintainer": "Blue Marble Analytics LLC",
"docs_url": null,
"requires_python": null,
"maintainer_email": "info@gridpath.io",
"keywords": "energy, electricity, power, renewables, planning, operations",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/bf/dd/669816af59113fac652de6b27581d2558dcafd17fd5b41293a24d5fa113a/gridpath-2024.2.0.tar.gz",
"platform": "MacOS",
"description": "[](https://github.com/blue-marble/gridpath/actions/workflows/test_gridpath.yml)\n[](https://gridpath.readthedocs.io/en/latest/?badge=latest)\n[](https://coveralls.io/github/blue-marble/gridpath?branch=main)\n[](https://github.com/psf/black)\n[](https://github.com/blue-marble/gridpath/actions/workflows/black.yml)\n[](https://zenodo.org/badge/latestdoi/65574330)\n\n# Welcome to GridPath\n\n<p align=\"center\" width=\"100%\">\n <img src=\"https://github.com/blue-marble/gridpath/blob/main/doc/graphics/gridpath_logo.png?raw=true\" width=\"20%\"/>\n</p>\n\n\n\n\nGridPath is a versatile power-system planning platform capable of a range of\nplanning approaches including production-cost, capacity-expansion, \nasset-valuation, and reliability modeling.\n\n# Documentation\nGridPath's documentation is hosted on [Read the Docs](https://gridpath.readthedocs.io/en/latest/).\n\n# Installation\n\n## Python\nGridPath is tested on Python 3.9, 3.10, and 3.11. Get one of those Python versions [here](https://www.python.org/downloads/ \"Python download\").\n\n## GridPath Python environment\nYou should create a Python environment for your GridPath installation, e.g. via \n`venv`, [a lightweight environment manager](https://docs.python.org/3/library/venv.html \"venv\") \nthat is part of the standard Python distribution. Make sure to [create](https://docs.python.org/3/library/venv.html#creating-virtual-environments \"create\") [activate](https://docs.python.org/3/library/venv.html#how-venvs-work \"activate\") the environment before installing GridPath.\n\n## Install GridPath from PyPi\n\nOnce you have _created and activated_ the GridPath Python environment, you \ncan install the latest version of GridPath from PyPi with:\n\n```bash\npip install GridPath\n```\n\n## Install GridPath from source\n\nYou can alternatively download the GridPath source code and install from \nsource.\n\n```bash\npip install .[all]\n```\n\n**NOTE:** If you plan to edit the GridPath code, you should install with the `-e` flag.\n\n## Solver\nYou will need a solver to use this platform. GridPath assumes you will be using Cbc (Coin-or branch and cut) by default, but you can specify a \ndifferent solver.\n\n\n# Usage\n\n## The gridpath_run and gridpath_run_e2e commands\nIf you install GridPath via the setup script following the instructions above, \nyou can use the command `gridpath_run` to run a scenario from any directory \n-- as long as your GridPath Python environment is enabled -- as follows:\n```bash\ngridpath_run --scenario SCENARIO_NAME --scenario_location \n/PATH/TO/SCENARIO \n```\n\nIf you are using the database, you can use the command `gridpath_run_e2e` to \nrun GridPath end-to-end, i.e. get inputs for the scenario from the database, \nsolve the scenario problem, import the results into the database, and \nprocess them. Refer to the documentation for how to build the database.\n\n```bash\ngridpath_run_e2e --scenario SCENARIO_NAME --scenario_location \n/PATH/TO/SCENARIO \n```\n\nTo see usage and other optional arguments, e.g. how to specify a \nsolver, check the help menu, e.g.:\n```bash\ngridpath_run --help\n```\n",
"bugtrack_url": null,
"license": "Apache v2",
"summary": "A versatile simulation and optimization platform for power-system planning and operations.",
"version": "2024.2.0",
"project_urls": {
"Discussions": "https://github.com/blue-marble/gridpath/discussions",
"Documentation": "https://gridpath.readthedocs.io/en/latest/",
"Homepage": "https://www.gridpath.io",
"Issues": "https://github.com/blue-marble/gridpath/issues",
"Source Code": "https://github.com/blue-marble/gridpath"
},
"split_keywords": [
"energy",
" electricity",
" power",
" renewables",
" planning",
" operations"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "af680033559852d93ccae64370ab1c3a992d7f203b4351431892dd3c696cb070",
"md5": "5a5efef3123544bf7235f41dadeaa9d7",
"sha256": "3b886127cd16e07a1417d52f1481d4a06d1a1901e7a5e62ab5ceeb0b051d8e42"
},
"downloads": -1,
"filename": "GridPath-2024.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5a5efef3123544bf7235f41dadeaa9d7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 1365638,
"upload_time": "2024-10-04T20:16:23",
"upload_time_iso_8601": "2024-10-04T20:16:23.058087Z",
"url": "https://files.pythonhosted.org/packages/af/68/0033559852d93ccae64370ab1c3a992d7f203b4351431892dd3c696cb070/GridPath-2024.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bfdd669816af59113fac652de6b27581d2558dcafd17fd5b41293a24d5fa113a",
"md5": "84e7c2128ea3ec8809ecac05ed2a3ded",
"sha256": "edd9fba1e0a74ba5936bc572b5c46d91be222b20cd50b011f204ee6f9f2d0787"
},
"downloads": -1,
"filename": "gridpath-2024.2.0.tar.gz",
"has_sig": false,
"md5_digest": "84e7c2128ea3ec8809ecac05ed2a3ded",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 644996,
"upload_time": "2024-10-04T20:16:24",
"upload_time_iso_8601": "2024-10-04T20:16:24.783351Z",
"url": "https://files.pythonhosted.org/packages/bf/dd/669816af59113fac652de6b27581d2558dcafd17fd5b41293a24d5fa113a/gridpath-2024.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-04 20:16:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "blue-marble",
"github_project": "gridpath",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "alabaster",
"specs": [
[
"==",
"0.7.16"
]
]
},
{
"name": "aniso8601",
"specs": [
[
"==",
"9.0.1"
]
]
},
{
"name": "asttokens",
"specs": [
[
"==",
"2.4.1"
]
]
},
{
"name": "attrs",
"specs": [
[
"==",
"24.2.0"
]
]
},
{
"name": "babel",
"specs": [
[
"==",
"2.16.0"
]
]
},
{
"name": "black",
"specs": [
[
"==",
"24.8.0"
]
]
},
{
"name": "bokeh",
"specs": [
[
"==",
"2.2.3"
]
]
},
{
"name": "certifi",
"specs": [
[
"==",
"2024.8.30"
]
]
},
{
"name": "charset-normalizer",
"specs": [
[
"==",
"3.3.2"
]
]
},
{
"name": "click",
"specs": [
[
"==",
"8.1.7"
]
]
},
{
"name": "coverage",
"specs": [
[
"==",
"7.6.1"
]
]
},
{
"name": "coveralls",
"specs": [
[
"==",
"4.0.1"
]
]
},
{
"name": "decorator",
"specs": [
[
"==",
"5.1.1"
]
]
},
{
"name": "df2img",
"specs": [
[
"==",
"0.2.19"
]
]
},
{
"name": "dill",
"specs": [
[
"==",
"0.3.7"
]
]
},
{
"name": "dnspython",
"specs": [
[
"==",
"2.4.2"
]
]
},
{
"name": "docopt",
"specs": [
[
"==",
"0.6.2"
]
]
},
{
"name": "docutils",
"specs": [
[
"==",
"0.20.1"
]
]
},
{
"name": "eventlet",
"specs": [
[
"==",
"0.33.3"
]
]
},
{
"name": "executing",
"specs": [
[
"==",
"2.1.0"
]
]
},
{
"name": "fastjsonschema",
"specs": [
[
"==",
"2.20.0"
]
]
},
{
"name": "Flask",
"specs": [
[
"==",
"2.0.1"
]
]
},
{
"name": "Flask-RESTful",
"specs": [
[
"==",
"0.3.9"
]
]
},
{
"name": "Flask-SocketIO",
"specs": [
[
"==",
"4.3.2"
]
]
},
{
"name": "greenlet",
"specs": [
[
"==",
"3.1.1"
]
]
},
{
"name": "GridPath",
"specs": [
[
"==",
"2024.2.0"
]
]
},
{
"name": "gurobipy",
"specs": [
[
"==",
"11.0.3"
]
]
},
{
"name": "idna",
"specs": [
[
"==",
"3.10"
]
]
},
{
"name": "imagesize",
"specs": [
[
"==",
"1.4.1"
]
]
},
{
"name": "ipython",
"specs": [
[
"==",
"8.28.0"
]
]
},
{
"name": "itsdangerous",
"specs": [
[
"==",
"2.2.0"
]
]
},
{
"name": "jedi",
"specs": [
[
"==",
"0.19.1"
]
]
},
{
"name": "Jinja2",
"specs": [
[
"==",
"3.0.3"
]
]
},
{
"name": "jsonschema",
"specs": [
[
"==",
"4.23.0"
]
]
},
{
"name": "jsonschema-specifications",
"specs": [
[
"==",
"2023.12.1"
]
]
},
{
"name": "jupyter_core",
"specs": [
[
"==",
"5.7.2"
]
]
},
{
"name": "kaleido",
"specs": [
[
"==",
"0.2.1"
]
]
},
{
"name": "MarkupSafe",
"specs": [
[
"==",
"2.1.5"
]
]
},
{
"name": "matplotlib-inline",
"specs": [
[
"==",
"0.1.7"
]
]
},
{
"name": "mypy-extensions",
"specs": [
[
"==",
"1.0.0"
]
]
},
{
"name": "nbformat",
"specs": [
[
"==",
"5.10.4"
]
]
},
{
"name": "networkx",
"specs": [
[
"==",
"3.1"
]
]
},
{
"name": "nose",
"specs": [
[
"==",
"1.3.7"
]
]
},
{
"name": "numpy",
"specs": [
[
"==",
"1.26.4"
]
]
},
{
"name": "packaging",
"specs": [
[
"==",
"24.1"
]
]
},
{
"name": "pandas",
"specs": [
[
"==",
"2.2.1"
]
]
},
{
"name": "parso",
"specs": [
[
"==",
"0.8.4"
]
]
},
{
"name": "pathspec",
"specs": [
[
"==",
"0.12.1"
]
]
},
{
"name": "pexpect",
"specs": [
[
"==",
"4.9.0"
]
]
},
{
"name": "pillow",
"specs": [
[
"==",
"10.4.0"
]
]
},
{
"name": "platformdirs",
"specs": [
[
"==",
"4.3.6"
]
]
},
{
"name": "plotly",
"specs": [
[
"==",
"5.24.1"
]
]
},
{
"name": "ply",
"specs": [
[
"==",
"3.11"
]
]
},
{
"name": "prompt_toolkit",
"specs": [
[
"==",
"3.0.48"
]
]
},
{
"name": "pscript",
"specs": [
[
"==",
"0.7.5"
]
]
},
{
"name": "psutil",
"specs": [
[
"==",
"5.9.6"
]
]
},
{
"name": "ptyprocess",
"specs": [
[
"==",
"0.7.0"
]
]
},
{
"name": "pure_eval",
"specs": [
[
"==",
"0.2.3"
]
]
},
{
"name": "Pygments",
"specs": [
[
"==",
"2.18.0"
]
]
},
{
"name": "Pyomo",
"specs": [
[
"==",
"6.8.0"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
"==",
"2.9.0.post0"
]
]
},
{
"name": "python-engineio",
"specs": [
[
"==",
"3.14.2"
]
]
},
{
"name": "python-socketio",
"specs": [
[
"==",
"4.6.1"
]
]
},
{
"name": "pytz",
"specs": [
[
"==",
"2024.2"
]
]
},
{
"name": "PyUtilib",
"specs": [
[
"==",
"6.0.0"
]
]
},
{
"name": "PyYAML",
"specs": [
[
"==",
"6.0.2"
]
]
},
{
"name": "referencing",
"specs": [
[
"==",
"0.35.1"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.32.3"
]
]
},
{
"name": "rpds-py",
"specs": [
[
"==",
"0.20.0"
]
]
},
{
"name": "six",
"specs": [
[
"==",
"1.16.0"
]
]
},
{
"name": "snowballstemmer",
"specs": [
[
"==",
"2.2.0"
]
]
},
{
"name": "Sphinx",
"specs": [
[
"==",
"7.2.6"
]
]
},
{
"name": "sphinx-argparse",
"specs": [
[
"==",
"0.4.0"
]
]
},
{
"name": "sphinxcontrib-applehelp",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "sphinxcontrib-devhelp",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "sphinxcontrib-htmlhelp",
"specs": [
[
"==",
"2.1.0"
]
]
},
{
"name": "sphinxcontrib-jsmath",
"specs": [
[
"==",
"1.0.1"
]
]
},
{
"name": "sphinxcontrib-qthelp",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "sphinxcontrib-serializinghtml",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "stack-data",
"specs": [
[
"==",
"0.6.3"
]
]
},
{
"name": "tenacity",
"specs": [
[
"==",
"9.0.0"
]
]
},
{
"name": "tornado",
"specs": [
[
"==",
"6.4.1"
]
]
},
{
"name": "traitlets",
"specs": [
[
"==",
"5.14.3"
]
]
},
{
"name": "typing_extensions",
"specs": [
[
"==",
"4.12.2"
]
]
},
{
"name": "tzdata",
"specs": [
[
"==",
"2024.2"
]
]
},
{
"name": "urllib3",
"specs": [
[
"==",
"2.2.3"
]
]
},
{
"name": "wcwidth",
"specs": [
[
"==",
"0.2.13"
]
]
},
{
"name": "websocket-client",
"specs": [
[
"==",
"1.8.0"
]
]
},
{
"name": "Werkzeug",
"specs": [
[
"==",
"2.0.2"
]
]
}
],
"lcname": "gridpath"
}
