emobpy

emobpy is a python tool that can create vehicle time series for battery electric vehicles. Three different time series can be created: vehicle electricity consumption time series, grid availability time series and actual charging time series. The electricity consumption time series are created based on mobility statistics.

Vehicle electricity consumption time series (VECTS)

The VECTS contain the state of a vehicle at each point in time. The states vary according to the mobility of drivers. Possible states are at home, workplace, shopping, errands, escort, leisure, and driving. For the state "Driving", the distance travelled is also provided in the time series. The time resolution can be established initially, but in fact, it depends on the available statistics (our examples contains 30 minutes time steps). Two groups of drivers can be distinguished commuters or non-commuters. Commuters perform the same trip to work every weekday and with the same distance home-work-home, in this group can be identified employed people and students where the main destination is workplace or university. While for the free time group, every day a new trip is drawn with different trip purposes. The daily number of trips, the departure time and trip purpose, and distance travelled are determined based on statistics of mobility surveys. Other considerations can also be set up. For instance, the number of working hours per day, the first and last state of the day can be established as "at home", and "driving" state must always be in between of two different states, that is to say, that a determined state cannot be followed by another state unless driving state is in between.

Grid availability time series (GATS)

Several GATS can be created from a determined VECTS. Different plug-in stations can be available for a vehicle depending on a particular state. The plug-in stations of a determined state can be chosen based on a probability distribution that adds up 100%. The plug-in stations defined in this tool are "home", "public", "maker", "workplace", "fast" and "none", although more user-defined plug-in stations can be established. The plug-in stations have an associated capacity per time resolution and "none" has zero capacity. Different scenarios of grid availability can be modelled. For example, in one scenario fast charge cannot be available, while for other scenarios fast charge can only be available for the driving state.

Actual charging time series (ACTS)

The ACTS contains at each point on time information of the plug-in stations available such as the capacity allocated to them. An ACTS is the one that indicates the actual consumption of electricity from the grid of a vehicle according to its driving behaviour and grid availability. There are different scenarios available to create ACTS. For example, "Immediate-Full capacity" scenarios that informs the energy drawn from the grid at maximum capacity of respective plug-in station until the battery is fully charged , or "Immediate-Balanced" scenario that creates a time series taking into account the duration of a vehicle in a plug-in station and the energy required to get the battery fully charged, allowing to charge the battery a lower capacity than the maximum capacity available in the charging point.

Instructions

This tool has been tested in window 7 and Ubuntu 18.04.

it is recommended to create a python environment to install the dependencies with the versions indicated in requirements.txt:

• Pandas
• Numpy
• Numba

Optional for parallel

• Ray (linux support only)
• Multiprocessing

Instalation:

pip install emobpy

Usage

There are notebooks in the "example" directory with examples of usage.