venco.py

A data processing tool offering demand and flexibility profiles for future electric vehicle fleets in an aggregated manner.
https://gitlab.com/dlr-ve/esy/vencopy/vencopy

Category: Consumption
Sub Category: Mobility and Transportation

Last synced: about 4 hours ago
JSON representation

Repository metadata

A data processing tool offering demand and flexibility profiles for future electric vehicle fleets in an aggregated manner.

https://gitlab.com/dlr-ve/esy/vencopy/vencopy/blob/main/

          # Welcome to venco.py!

- Authors: Niklas Wulff, Fabia Miorelli
- Contact: vencopy@dlr.de

# Contents

- [Description](#description)
- [Installation](#installation)
- [Codestyle](#codestyle)
- [Documentation](#documentation)
- [Useful Links](#useful-links)
- [Want to contribute?](#want-to-contribute)

## Description

A data processing tool estimating hourly electric demand and flexibility profiles for future 
electric vehicle fleets. Profiles are targeted to be scalable for the use in large-scale
energy system models. 

## Installation

Depending on if you want to use venco.py or if you want to contribute, there are
two different installation procedures described in venco.py's documentation:

[I want to apply the tool](https://dlr-ve.gitlab.io/esy/vencopy/vencopy/gettingstarted/installation.html#installation-for-users)

[I want to contribute to the codebase, the documentation or the tutorials](https://dlr-ve.gitlab.io/esy/vencopy/vencopy/gettingstarted/installation.html#installation-for-developers)

In order to start using venco.py, check out our [tutorials](https://dlr-ve.gitlab.io/esy/vencopy/vencopy/gettingstarted/start.html). For this you won't need any additional data.

To run venco.py 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 
Alternatively you can use venco.py with any National Travel Survey or mobility pattern dataset.


## Codestyle

We use PEP-8, with the exception of UpperCamelCase for class names.

## Documentation

The documentation can be found here: https://dlr-ve.gitlab.io/esy/vencopy/vencopy/
To be able to build the documentation locally on your machine you should additionally install the following three packages in your vencopy environment : sphinx, sphinx_rtd_theme and rst2pdf.
After that you can build the documentation locally from a conda bash with the following command:

```python
sphinx-build -b html ./docs/ ./build/
```

## Useful Links

- Documentation: https://dlr-ve.gitlab.io/esy/vencopy/vencopy/
- Source code: https://gitlab.com/dlr-ve/esy/vencopy/vencopy
- PyPI release: https://pypi.org/project/vencopy/
- Licence: https://opensource.org/licenses/BSD-3-Clause

## Want to contribute?

Please read our contribute section in the documentation and reach out to Fabia
(fabia.miorelli@dlr.de). If you experience difficulties on set up or have other technical questions, join our
[gitter community](https://gitter.im/vencopy/community)

        

Owner metadata


Committers metadata

Last synced: about 2 months ago

Total Commits: 1,163
Total Committers: 13
Avg Commits per committer: 89.462
Development Distribution Score (DDS): 0.711

Commits in past year: 24
Committers in past year: 1
Avg Commits per committer in past year: 24.0
Development Distribution Score (DDS) in past year: 0.0

Name Email Commits
Fabia Miorelli f****i@d****e 336
Miorelli F****i@d****e 335
wulf_ni n****f@d****e 266
Jagmann l****n@d****e 91
Lisa Jagmann l****n@g****m 56
Wulff N****f@d****e 35
butt_pa p****e@d****e 25
Butte P****e@d****e 9
Wetzel, Manuel m****l@d****e 5
Benjamin Fuchs b****s@d****e 2
Hedda Gardian h****n@g****m 1
Mitra s****a@d****e 1
hc h****s@d****e 1

Committer domains:


Issue and Pull Request metadata

Last synced: about 2 months ago

Score: 2.5649493574615367