# eco4cast
[](https://colab.research.google.com/github/AIRI-Institute/eco4cast/blob/main/examples/eco4cast_demo/quick_start_guide.ipynb)
+ [About eco4cast :clipboard:](#1)
+ [Installation :wrench:](#2)
+ [Usage examples :computer:](#3)
+ [Citing](#4)
<!-- + [Feedback :envelope:](#6) -->
## About eco4cast :clipboard: <a name="1"></a>
This package is designed to reduce CO2 emissions while training neural network models. The main idea of the package is to run the learning process at certain time intervals on certain Google Cloud servers with minimal emissions. A neural network (TCN) trained on the historical data of 13 zones is used to predict emissions for 24 hours ahead.
Currently supported Google Cloud zones: 'southamerica-east1-b', 'northamerica-northeast2-b', 'europe-west6-b', 'europe-west3-b', 'europe-central2-b', 'europe-west1-b', 'europe-west8-a', 'northamerica-northeast1-b', 'europe-southwest1-c', 'europe-west2-b', 'europe-north1-b', 'europe-west9-b', 'europe-west4-b' .
## Installation <a name="2"></a>
Package can be installed using Pypi:
```
pip install eco4cast
```
## Usage examples <a name="3"></a>
There are several usage examples you can use to start working with eco4cast package. They are listed in [examples folder](https://github.com/AIRI-Institute/eco4cast/tree/main/examples).
### Example of using eco4cast with Google Cloud
You can use eco4cast to reduce your carbon footprint with the help of Google Cloud virtual machines and moving between zones to reach minimal emission coefficient. In this Colab notebook you can find step-by-step tutorial on setting up your first training process using eco4cast and Google Cloud [](https://colab.research.google.com/github/AIRI-Institute/eco4cast/blob/main/examples/eco4cast_demo/quick_start_guide.ipynb)
### Example of using eco4cast locally
You can use eco4cast to reduce your carbon footprint by training during times with minimal emission in your region. In this Colab notebook you can find step-by-step guide on starting training locally [](https://colab.research.google.com/github/AIRI-Institute/eco4cast/blob/main/examples/eco4cast_local_demo/local_quick_start_guide.ipynb).
Available electricitymaps zones to work locally:
"BR-CS" (Central Brazil), "CA-ON" (Canada Ontario) , "CH" (Switzerland), "DE" (Germany),
"PL" (Poland), "BE" (Belgium), "IT-NO" (North Italy), "CA-QC" (Canada Quebec), "ES" (Spain),
"GB" (Great Britain), "FI" (Finland), "FR" (France) "NL" (Netherlands)
## Citing <a name="4"></a>
Paper info
<!-- ## Feedback <a name="6"></a>
email? -->
Raw data
{
"_id": null,
"home_page": "https://github.com/AIRI-Institute/eco4cast",
"name": "eco4cast",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9,<4.0",
"maintainer_email": "",
"keywords": "co2 emission,google cloud,pytorch",
"author": "Mikhail Tiutiulnikov",
"author_email": "tiutiulnikov@airi.net",
"download_url": "https://files.pythonhosted.org/packages/a4/4b/ebb891e498e2b23eacae433d3a698871ef6c7d64da065f239e8dda72c0d9/eco4cast-0.0.8.tar.gz",
"platform": null,
"description": "# eco4cast\n\n[](https://colab.research.google.com/github/AIRI-Institute/eco4cast/blob/main/examples/eco4cast_demo/quick_start_guide.ipynb)\n\n+ [About eco4cast :clipboard:](#1)\n+ [Installation :wrench:](#2)\n+ [Usage examples :computer:](#3)\n+ [Citing](#4)\n<!-- + [Feedback :envelope:](#6) -->\n\n\n\n## About eco4cast :clipboard: <a name=\"1\"></a> \nThis package is designed to reduce CO2 emissions while training neural network models. The main idea of the package is to run the learning process at certain time intervals on certain Google Cloud servers with minimal emissions. A neural network (TCN) trained on the historical data of 13 zones is used to predict emissions for 24 hours ahead.\n\nCurrently supported Google Cloud zones: 'southamerica-east1-b', 'northamerica-northeast2-b', 'europe-west6-b', 'europe-west3-b', 'europe-central2-b', 'europe-west1-b', 'europe-west8-a', 'northamerica-northeast1-b', 'europe-southwest1-c', 'europe-west2-b', 'europe-north1-b', 'europe-west9-b', 'europe-west4-b' .\n\n## Installation <a name=\"2\"></a> \nPackage can be installed using Pypi:\n```\npip install eco4cast\n```\n\n## Usage examples <a name=\"3\"></a> \nThere are several usage examples you can use to start working with eco4cast package. They are listed in [examples folder](https://github.com/AIRI-Institute/eco4cast/tree/main/examples). \n\n### Example of using eco4cast with Google Cloud\nYou can use eco4cast to reduce your carbon footprint with the help of Google Cloud virtual machines and moving between zones to reach minimal emission coefficient. In this Colab notebook you can find step-by-step tutorial on setting up your first training process using eco4cast and Google Cloud [](https://colab.research.google.com/github/AIRI-Institute/eco4cast/blob/main/examples/eco4cast_demo/quick_start_guide.ipynb)\n\n### Example of using eco4cast locally\nYou can use eco4cast to reduce your carbon footprint by training during times with minimal emission in your region. In this Colab notebook you can find step-by-step guide on starting training locally [](https://colab.research.google.com/github/AIRI-Institute/eco4cast/blob/main/examples/eco4cast_local_demo/local_quick_start_guide.ipynb). \n\nAvailable electricitymaps zones to work locally: \n\"BR-CS\" (Central Brazil), \"CA-ON\" (Canada Ontario) , \"CH\" (Switzerland), \"DE\" (Germany),\n\"PL\" (Poland), \"BE\" (Belgium), \"IT-NO\" (North Italy), \"CA-QC\" (Canada Quebec), \"ES\" (Spain), \n\"GB\" (Great Britain), \"FI\" (Finland), \"FR\" (France) \"NL\" (Netherlands)\n\n## Citing <a name=\"4\"></a>\nPaper info\n\n\n<!-- ## Feedback <a name=\"6\"></a>\nemail? -->",
"bugtrack_url": null,
"license": "",
"summary": "This package is designed to reduce CO2 emissions while training neural networks using Google Cloud.",
"version": "0.0.8",
"project_urls": {
"Homepage": "https://github.com/AIRI-Institute/eco4cast",
"Repository": "https://github.com/AIRI-Institute/eco4cast"
},
"split_keywords": [
"co2 emission",
"google cloud",
"pytorch"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0865dda9360ec406f1b73a7d73c195a3c5cb6b09333f4610c74c111c73485955",
"md5": "e0de1d6837560a721276722474dacd46",
"sha256": "74858d230bd78f3c81cf4b48f5da06ffcc47d961f7717c6458ccecc042daf2a5"
},
"downloads": -1,
"filename": "eco4cast-0.0.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e0de1d6837560a721276722474dacd46",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9,<4.0",
"size": 17679301,
"upload_time": "2023-08-16T05:59:41",
"upload_time_iso_8601": "2023-08-16T05:59:41.844806Z",
"url": "https://files.pythonhosted.org/packages/08/65/dda9360ec406f1b73a7d73c195a3c5cb6b09333f4610c74c111c73485955/eco4cast-0.0.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a44bebb891e498e2b23eacae433d3a698871ef6c7d64da065f239e8dda72c0d9",
"md5": "687500ecff4f5ff86b553de445929125",
"sha256": "12dd66799ccf4dcab56f642333d8e0d2c371377a42f4e2eda436881ae0319cdd"
},
"downloads": -1,
"filename": "eco4cast-0.0.8.tar.gz",
"has_sig": false,
"md5_digest": "687500ecff4f5ff86b553de445929125",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9,<4.0",
"size": 17322072,
"upload_time": "2023-08-16T05:59:47",
"upload_time_iso_8601": "2023-08-16T05:59:47.547788Z",
"url": "https://files.pythonhosted.org/packages/a4/4b/ebb891e498e2b23eacae433d3a698871ef6c7d64da065f239e8dda72c0d9/eco4cast-0.0.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-16 05:59:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AIRI-Institute",
"github_project": "eco4cast",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "eco4cast"
}
JSON
