# EVsSimulator
A realistic V2X Simulation Environment for large scale EV charging optimization!
<!-- Bullet points with all the benefits -->
## Features
* The simulator can be used to evaluate any type of algorithm to gain insights into its efficiency.
* The “gym environment” can readily support the development of RL algorithms.
* Uses only open-source data.
* Replays of simulations are saved and can be solved optimally using the Gurobi Solver.
* Easy to incorporate additional functionality for any use-case.
* Does not simulate the grid yet, but groups EV chargers at the level of the transformer/ parking lot, etc, so extra functionality can be easily added.
Focused on **realistic** parameters and **fully customizable**:
* Transformer models
* Max Current
* Charging Stations models
* Min and Max charge/discharge power/ Current
* Voltage and phases, AC or DC
* Charge and discharge efficiency
* List of connected transformers
* Electric Vehicles models
* Connected charging station and port
* Min and Max battery energy level
* Time of arrival and departure
* Energy at arrival/ desired energy at departure
* Min and Max current /power levels
* Constant-Current/ Constant-Voltage load-curve option
## Data sources
* The number and the topology of Transformers, Charging stations, and Electric Vehicles are parameterizable.
* Charging/ Discharging prices are based on historical day-ahead prices.
* EV spawn rate, time of stay, and energy required are based on realistic distributions ElaadNL,time, day, month and year.
* EV and Charger characteristics are based on real EVs and chargers existing in NL.
## File Structure
```bash
├── EVsSimulator
│ ├── __init__.py
│ ├── baselines
│ │ ├── __init__.py
│ │ ├── DDPG
│ │ ├── DT
│ │ ├── gurobi_models
```
## Citation
If you use this code in your research, please cite it using the following BibTeX entry:
```bibtex
@misc{EVsSimulator,
}
```
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details
```
Raw data
{
"_id": null,
"home_page": "",
"name": "EVsSimulator",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "gym,Reinforcement Learning,V2X,EVs,EVsSimulator,Electric Vehicles,Electric Vehicle Simulator",
"author": "Stavros Orfanoudakis",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/64/41/64a4ef4a2ac507e8c6ef7ddb79da9158d8cfb8c6cc6030778627a99ba287/EVsSimulator-0.0.12.tar.gz",
"platform": null,
"description": "# EVsSimulator\r\nA realistic V2X Simulation Environment for large scale EV charging optimization!\r\n\r\n<!-- Bullet points with all the benefits -->\r\n## Features\r\n\r\n* The simulator can be used to evaluate any type of algorithm to gain insights into its efficiency.\r\n* The \u201cgym environment\u201d can readily support the development of RL algorithms.\r\n* Uses only open-source data.\r\n* Replays of simulations are saved and can be solved optimally using the Gurobi Solver.\r\n* Easy to incorporate additional functionality for any use-case.\r\n* Does not simulate the grid yet, but groups EV chargers at the level of the transformer/ parking lot, etc, so extra functionality can be easily added.\r\n\r\n\r\nFocused on **realistic** parameters and **fully customizable**:\r\n* Transformer models\r\n * Max Current\r\n* Charging Stations models\r\n * Min and Max charge/discharge power/ Current\r\n * Voltage and phases, AC or DC\r\n * Charge and discharge efficiency\r\n * List of connected transformers\r\n* Electric Vehicles models\r\n * Connected charging station and port\r\n * Min and Max battery energy level\r\n * Time of arrival and departure\r\n * Energy at arrival/ desired energy at departure\r\n * Min and Max current /power levels\r\n * Constant-Current/ Constant-Voltage load-curve option \r\n\r\n\r\n## Data sources\r\n* The number and the topology of Transformers, Charging stations, and Electric Vehicles are parameterizable.\r\n* Charging/ Discharging prices are based on historical day-ahead prices.\r\n* EV spawn rate, time of stay, and energy required are based on realistic distributions ElaadNL,time, day, month and year.\r\n* EV and Charger characteristics are based on real EVs and chargers existing in NL.\r\n\r\n## File Structure\r\n```bash\r\n\u251c\u2500\u2500 EVsSimulator\r\n\u2502 \u251c\u2500\u2500 __init__.py\r\n\u2502 \u251c\u2500\u2500 baselines\r\n\u2502 \u2502 \u251c\u2500\u2500 __init__.py\r\n\u2502 \u2502 \u251c\u2500\u2500 DDPG\r\n\u2502 \u2502 \u251c\u2500\u2500 DT\r\n\u2502 \u2502 \u251c\u2500\u2500 gurobi_models\r\n\r\n```\r\n\r\n## Citation\r\nIf you use this code in your research, please cite it using the following BibTeX entry:\r\n```bibtex\r\n@misc{EVsSimulator,\r\n\r\n}\r\n```\r\n\r\n## License\r\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details\r\n```\r\n\r\n",
"bugtrack_url": null,
"license": "",
"summary": "A realistic V2X environment using gym",
"version": "0.0.12",
"project_urls": null,
"split_keywords": [
"gym",
"reinforcement learning",
"v2x",
"evs",
"evssimulator",
"electric vehicles",
"electric vehicle simulator"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "97df8d3cb7428a03164f28881c83aefe89bd2c9b5506cfe4489140bcf0b4b974",
"md5": "f84625ded7675402de9a6b09f9c2d540",
"sha256": "d2bf1918c20839aa71eaa050797cb27ce240992dc2fe1bd360c6f3a9e56d01ca"
},
"downloads": -1,
"filename": "EVsSimulator-0.0.12-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f84625ded7675402de9a6b09f9c2d540",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 2776080,
"upload_time": "2024-03-07T21:26:27",
"upload_time_iso_8601": "2024-03-07T21:26:27.108858Z",
"url": "https://files.pythonhosted.org/packages/97/df/8d3cb7428a03164f28881c83aefe89bd2c9b5506cfe4489140bcf0b4b974/EVsSimulator-0.0.12-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "644164a4ef4a2ac507e8c6ef7ddb79da9158d8cfb8c6cc6030778627a99ba287",
"md5": "23b08f2c1aead9bd754935e8f4200a31",
"sha256": "e98a435b69ea2751ff30fa89fde7fbdbc792d648f46c4129122b3590b49f8748"
},
"downloads": -1,
"filename": "EVsSimulator-0.0.12.tar.gz",
"has_sig": false,
"md5_digest": "23b08f2c1aead9bd754935e8f4200a31",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 2685229,
"upload_time": "2024-03-07T21:26:30",
"upload_time_iso_8601": "2024-03-07T21:26:30.527933Z",
"url": "https://files.pythonhosted.org/packages/64/41/64a4ef4a2ac507e8c6ef7ddb79da9158d8cfb8c6cc6030778627a99ba287/EVsSimulator-0.0.12.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-07 21:26:30",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "evssimulator"
}
JSON