README.md

Electric Vehicle Charging Infrastructure Simulator (ELVIS)

This repository contains the source code for Elvis, a planning and management tool for electric vehicles charging infrastructure.

Installation

Install using pip

To install the package simply run

pip install py-elvis

This installs the package locally using pip and installs required packages, if not available.

Manually download and locally install the elvis package

This may be useful if you want to add changes to the package. Then download or checkout this repository and in the top level that contains the setup.py file, run

pip install -r requirements.txt
python setup.py install

This installs the package locally using pip and installs required packages, if not available.

Usage

Following, a simple example using one of the pre-defined scenario configurations

from elvis import ScenarioConfig, simulate, num_time_steps

import yaml
with open("elvis/data/config_builder/office.yaml", 'r') as f:
    yaml_str = yaml.safe_load(f)
config_from_yaml = ScenarioConfig.from_yaml(yaml_str)

results = simulate(config_from_yaml, start_date='2020-01-01 00:00:00', end_date='2020-12-31 23:00:00', resolution='01:00:00')
load_profile = results.aggregate_load_profile(8760)

import matplotlib.pyplot as plt
plt.plot(load_profile)

Acknowledgement

This work was supported in part by Stromnetz Berlin, as well as the Federal Minister for Environment, Nature Conservation and Nuclear Safety (BMU) through the research project FlexNet4E-Mobility (funding reference 16EM3147-2) and the Federal Ministry for Economic Affairs and Energy (BMWi) throught the project Neue Berliner Luft (funding reference 01MZ18013E).