MCPcopy Index your code
hub / github.com/RAMP-project/RAMP-mobility

github.com/RAMP-project/RAMP-mobility @v0.3.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.3.1 ↗ · + Follow
49 symbols 234 edges 40 files 3 documented · 6%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

RAMP-mobility: a RAMP application for generating bottom-up stochastic electric vehicles load profiles.


Overview

RAMP-mobility is an original application of the open-source RAMP software engine, tailored to the generation of European electric vehicles mobility and charging profiles at high temporal resolution (1-min).

This repository contains the complete RAMP-Mobility model, entirely developed in Python 3.6. The model is currently released as v1.0. It includes a minimum 'quick-start' documentation (see below), complemented by the code being fully commented in each line to allow a complete understanding of it. A more thorougly documented version of the repository is under development and should be released soon, alongside a Journal publication.

In the while, further details about the conceptual and mathematical model formulation of the RAMP software engine can be found in the original RAMP Journal publication (https://doi.org/10.1016/j.energy.2019.04.097). What is more, you are welcome to join our Gitter chat to discuss doubts and make questions about the code!

Quick start

Please refer to the complete getting started guide for instructions on how to run RAMP-Mobility. This includes information about installation and Python dependencies, as well as a minimum walkthrough of model structure and usage.

Model description

RAMP-mobility covers 28 European countries, namely: EU27 minus Cyprus and Malta, plus Norway, Switzerland and the UK. The model consists of 2 main modules:

Module 1: bottom-up stochastic simulation of electric vehicle mobility profiles

Module 2: simulation, for each electric vehicle, of a charging profile based on the previously obtained mobility pattern

Four pre-defined charging strategies are implemented, to simulate different plausible scenarios:

  1. Uncontrolled: The base case, where no control over the user behaviour is applied. If the charging point is available, the battery is charged immediately at the nominal power, until a user-defined value of SOCmax.
  2. Perfect Foresight: Strategy aiming at quantifying the possibility to implement a Vehicle-to-grid solution. If the charging point is available, the car is charged right before the end of the parking, at the nominal power, until the SOC satisfies the needs of the following journey. This allows to compute the part of the vehicle's battery available to the system, without affecting the user driving range.
  3. Night Charge: First smart charging strategy. It aims at shifting the charging events to the night period. The car is charged only if the charging point is available and the parking happens during nighttime.
  4. RES Integration: Second smart charging method. Has the goal of coupling the renewable power generation with the transport sector. The car is charged only if the charging point is available and the parking happens during periods when there is excess of renewable power production. As this condition is evaluated through the residual load curve, a file containing it should be provided in the folder "Input_data/Residual Load duration curve".

Authors

The model has been developed by:

Andrea Mangipinto

Politecnico di Milano, Italy

Francesco Lombardi

TU Delft, Netherlands

@FrLomb (Correspondence should be sent to: f.lombardi@tudelft.nl)

Francesco Sanvito

Politecnico di Milano, Italy

@FrancescoSanvi2

Sylvain Quoilin

KU Leuven, Belgium

Matija Pavičević

KU Leuven, Belgium

Emanuela Colombo

Politecnico di Milano, Italy

Citing

Please cite the original Journal publication if you use RAMP in your research: F. Lombardi, S. Balderrama, S. Quoilin, E. Colombo, Generating high-resolution multi-energy load profiles for remote areas with an open-source stochastic model, Energy, 2019, https://doi.org/10.1016/j.energy.2019.04.097.

Additionally, you may cite the EMP-E presentation of RAMP-mobility: A. Mangipinto, F. Lombardi, F. Sanvito, S. Quoilin, M. Pavičević, E. Colombo, RAMP-mobility: time series of electric vehicle consumption and charging strategies for all European countries, EMP-E, 2020, https://doi.org/10.13140/RG.2.2.29560.26880

Contribute

This project is open-source. Interested users are therefore invited to test, comment or contribute to the tool. Submitting issues is the best way to get in touch with the development team, which will address your comment, question, or development request in the best possible way. We are also looking for contributors to the main code, willing to contibute to its capabilities, computational-efficiency, formulation, etc.

License

Copyright 2020 RAMP-Mobility, contributors listed in Authors

Licensed under the European Union Public Licence (EUPL), Version 1.2-or-later; you may not use this file except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License

Core symbols most depended-on inside this repo

Shape

Function 40
Method 7
Class 2

Languages

Python100%

Modules by API surface

ramp_mobility/post_process/post_process.py24 symbols
ramp_mobility/utils.py10 symbols
ramp_mobility/core_model/core.py9 symbols
ramp_mobility/core_model/initialise.py4 symbols
ramp_mobility/core_model/stochastic_process_mobility.py1 symbols
ramp_mobility/core_model/charging_process.py1 symbols

For agents

$ claude mcp add RAMP-mobility \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page