mathworks / Simscape-Battery-Electric-Vehicle-Model

A Battery Electric Vehicle (BEV) model in Simscape for longitudinal powertrain analysis

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Battery Electric Vehicle Model in Simscape™

View Battery Electric Vehicle Model in Simscape on File Exchange

Version 2.2

Introduction

This is a MATLAB® Project containing a Battery Electric Vehicle (BEV) model and its components such as motor, high voltage battery, and longitudinal vehicle. This project demonstrates Simscape's modular and multi-fidelity modeling technology.

The abstract BEV model is built in a simple and modular fashion, and it can run faster than real-time. It is suitable as a baseline model for drive cycle simulation to estimate vehicle's electrical efficiency and other vehicle-level information.

This project also contains the model of a detailed permanent magnet synchronous motor (PMSM) and controller. It captures the detailed behaviors of the AC motor drive unit and can estimate the electrical efficiency at the unit level.

A Live Script demonstrates how to obtain the electrical efficiency from the slow but detailed motor drive unit and use the result as the block parameter of the simple but fast motor drive block in the BEV model.

Screenshot of the battery electric vehicle model

Screenshot of the simulation result plots

Watch the YouTube video introducing the model.

What's New in 2.2 (September, 2023)

  • The project has been updated to MATLAB R2023b.
  • MATLAB Build Tool is used to automate tasks to generate HTML files and Jupyter notebooks from all Live Scripts in the project.
  • GitHub Actions has been updated to generate and upload test report and coverage report.
  • GitHub Actions also generates Jupyter notebooks from Live Scripts. Jupyter notebooks can be viewed in the repo in the browser.

What's New in 2.1 (March, 2023)

  • The project has been updated to MATLAB R2023a.
  • A shortcut button to open MATLAB Test Manager is added in the Project Shortcuts tab of the toolstrip. MATLAB Test Manager requires the MATLAB Test license.

See Change Log for more details.

What's New in 2.0 (February, 2023)

  • BEV system model uses updated components and has simpler and easier configurability for selecting vehicle speed reference input.
  • High voltage battery component provides four different models: Basic, System simple, System, and System tabulated. They are all system level models and abstract, but they prodive different fidelity levels of the model. See README in Components > BatteryHighVoltage for more details.
  • Motor drive unit component provides four different models: Basic, Basic thermal, System, and System tabulated. They are all system level models and abstract, but they prodive different fidelity levels of the model. See README in Components > MotorDriveUnit for more details.
  • A detailed battery model built with a custom Simscape library has been removed. This project will remain focused on vehicle system-level applications using abstract models in future updates. A new project Electric Vehicle Design with Simscape serves as an alternative for detailed model applications.

See Change Log for more details.

Tool Requirements

Supported MATLAB Version: R2023b or newer releases

Required: MATLAB, Simulink®, Powertrain Blockset, Simscape, Simscape Driveline™, Simscape Electrical™

Optional: MATLAB Test, Parallel Computing Toolbox™

How to Use

Open BatteryElectricVehicle.prj in MATLAB, and it will automatically open the project main page BEV_main_script.html. The script contains the description of the model and hyperlinks to models and scripts.

How to Use in MATLAB Online

You can try this in MATLAB Online. In MATLAB Online, from the HOME tab in the toolstrip, select Add-Ons > Get Add-Ons to open the Add-On Explorer. Then search for the submission name, navigate to the submission page, click Add button, and select Save to MATLAB Drive.

Additional Notes

See Also

Electric Vehicle Design with Simscape provides BEV design workflows using detailed models for detailed analysis. Note that the BEV model in Simscape project (the current project you are viewing) is focused on vehicle system-level applications using abstract models.

Hybrid Electric Vehicle Model in Simscape provides an abstract power-split HEV model. The level of abstraction is similar to the BEV model in Simscape project.

License

See license.txt.


Copyright 2020-2023 The MathWorks, Inc.

About

A Battery Electric Vehicle (BEV) model in Simscape for longitudinal powertrain analysis

License:Other


Languages

Language:Jupyter Notebook 69.4%Language:MATLAB 15.3%Language:HTML 15.2%