Vehicle Energy Consumption in Python: A tool to simulate load flexibility of electric vehicle fleets.
Project description
Welcome to VencoPy!
- Authors: Niklas Wulff, Fabia Miorelli
- Contact: niklas.wulff@dlr.de
- Version: 0.1.4
Contents
Description
A data processing tool offering hourly demand and flexibility profiles for future electric vehicle fleets in an aggregated manner.
Installation
Install using the environment management system conda, open the conda console navigate to your VencoPy folder and run the following commands
conda env create -f requirements.yml
[confirm]
An environment named "VencoPy_env" will be created. Activate by entering
conda activate VencoPy_env
Build your package locally (compared to from the package index PyPI) by navigating to the folder that you checked out and typing
pip install .
Navigate to a parent directory where you want to create your VencoPy user folder in and type
vencopy
You will be prompted for a userfolder name, type it and hit enter. Your VencoPy user folder will now be created. It will look like this:
FOLDERNAME
├── config
│ ├── evaluatorConfig.yaml
│ ├── flexConfig.yaml
│ ├── globalConfig.yaml
│ ├── gridConfig.yaml
│ ├── localPathConfig.yaml
│ └── parseConfig.yaml
├── output
│ ├── tripConfig.yamldataParser
│ ├── evaluator
│ ├── flexEstimator
│ ├── gridModeler
│ └── tripDiaryBuilder
├── tutorials
│ └── ..
└── run.py
The configs in the config folder are the main interface between the user and the code. In order to learn more about them, check out our tutorials. For this you won't need any additional data.
To run VencoPy in full mode, you will need the data set Mobilität in Deutschland (German for mobility in Germany), you can request it here from the clearingboard transport: https://daten.clearingstelle-verkehr.de/order-form.html Currently, VencoPy is only tested with the B2 data set.
In your localPathConfig.yaml, please enter the path to your local MiD STATA folder, it will end on .../B2/STATA/. Now open your user folder in an IDE, configure your interpreter (environment) or type:
python run.py
and enjoy the tool!
Codestyle
We use PEP-8, with the exception of lowerCamelCase for method and variable names as well as UpperCamelCase for classes.
Documentation
The documentation can be found here: https://vencopy.readthedocs.io/en/latest/index.html To build the documentation from a conda bash with an activated environment type:
sphinx-build -b html ./docs/ ./build/
Useful Links
- Documentation: https://vencopy.readthedocs.io/en/latest/index.html#
- Source code: https://gitlab.com/dlr-ve/vencopy
- PyPI release: https://pypi.org/project/vencopy
- Licence: https://opensource.org/licenses/BSD-3-Clause
Want to contribute?
Great, welcome on the VP team! Please read our contribute section in the documentation and reach out to Niklas(niklas.wulff@dlr.de).
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for vencopy-0.1.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8ae36498abbf825750140758eb58bf9635ceacfb99bff071d96fbc2f1c71b32c |
|
MD5 | 2b481851c08f0a82e780661209ddc8b9 |
|
BLAKE2b-256 | eae908380090bd47b3f47c3627a047256bdfeb89c72aed8044c2345890baa79f |