diff --git a/FunctionLibrary/BatteryManagementSystem.mlx b/FunctionLibrary/BatteryManagementSystem.mlx index bc23b3b..0ce81f0 100644 Binary files a/FunctionLibrary/BatteryManagementSystem.mlx and b/FunctionLibrary/BatteryManagementSystem.mlx differ diff --git a/FunctionLibrary/BatteryModeling.mlx b/FunctionLibrary/BatteryModeling.mlx index fa76f39..64fdad9 100644 Binary files a/FunctionLibrary/BatteryModeling.mlx and b/FunctionLibrary/BatteryModeling.mlx differ diff --git a/FunctionLibrary/CreateScenario.mlx b/FunctionLibrary/CreateScenario.mlx index 822ccd7..2d9be8e 100644 Binary files a/FunctionLibrary/CreateScenario.mlx and b/FunctionLibrary/CreateScenario.mlx differ diff --git a/Images/image_8.png b/Images/image_8.png index cc7d769..02e6f03 100644 Binary files a/Images/image_8.png and b/Images/image_8.png differ diff --git a/InstructorResources/Solutions/BatteryChargerSoln.mlx b/InstructorResources/Solutions/BatteryChargerSoln.mlx index e3c8431..ab57861 100644 Binary files a/InstructorResources/Solutions/BatteryChargerSoln.mlx and b/InstructorResources/Solutions/BatteryChargerSoln.mlx differ diff --git a/InstructorResources/Solutions/EVBatteryDesignSoln.mlx b/InstructorResources/Solutions/EVBatteryDesignSoln.mlx index bb63445..a3f9909 100644 Binary files a/InstructorResources/Solutions/EVBatteryDesignSoln.mlx and b/InstructorResources/Solutions/EVBatteryDesignSoln.mlx differ diff --git a/InstructorResources/Solutions/HowDoBatteryWorkSoln.mlx b/InstructorResources/Solutions/HowDoBatteryWorkSoln.mlx index c14b573..22c3ff1 100644 Binary files a/InstructorResources/Solutions/HowDoBatteryWorkSoln.mlx and b/InstructorResources/Solutions/HowDoBatteryWorkSoln.mlx differ diff --git a/InstructorResources/Solutions/ModelingWithMATLABSoln.mlx b/InstructorResources/Solutions/ModelingWithMATLABSoln.mlx index e264e0c..cb39b07 100644 Binary files a/InstructorResources/Solutions/ModelingWithMATLABSoln.mlx and b/InstructorResources/Solutions/ModelingWithMATLABSoln.mlx differ diff --git a/InstructorResources/Solutions/ModelingWithSimscapeSoln.mlx b/InstructorResources/Solutions/ModelingWithSimscapeSoln.mlx index d06aa7f..d382e3f 100644 Binary files a/InstructorResources/Solutions/ModelingWithSimscapeSoln.mlx and b/InstructorResources/Solutions/ModelingWithSimscapeSoln.mlx differ diff --git a/InstructorResources/Solutions/ModelingWithSimulinkSoln.mlx b/InstructorResources/Solutions/ModelingWithSimulinkSoln.mlx index 2e830f8..781e4c2 100644 Binary files a/InstructorResources/Solutions/ModelingWithSimulinkSoln.mlx and b/InstructorResources/Solutions/ModelingWithSimulinkSoln.mlx differ diff --git a/InstructorResources/Solutions/StateOfChargeSoln.mlx b/InstructorResources/Solutions/StateOfChargeSoln.mlx index 40d554f..8ff9ccc 100644 Binary files a/InstructorResources/Solutions/StateOfChargeSoln.mlx and b/InstructorResources/Solutions/StateOfChargeSoln.mlx differ diff --git a/InstructorResources/Solutions/ThermalModelingSoln.mlx b/InstructorResources/Solutions/ThermalModelingSoln.mlx index f08ac56..88ab49d 100644 Binary files a/InstructorResources/Solutions/ThermalModelingSoln.mlx and b/InstructorResources/Solutions/ThermalModelingSoln.mlx differ diff --git a/MainMenu.mlx b/MainMenu.mlx index 4f9e831..a07a535 100644 Binary files a/MainMenu.mlx and b/MainMenu.mlx differ diff --git a/README.md b/README.md index d7d4b44..5ea0dca 100644 --- a/README.md +++ b/README.md @@ -1,26 +1,16 @@ # Battery Systems: introduction - -[![View on File Exchange](https://www.mathworks.com/matlabcentral/images/matlab-file-exchange.svg)](https://www.mathworks.com/matlabcentral/fileexchange/172770-battery-systems-introduction) or [![Open in MATLAB Online](https://www.mathworks.com/images/responsive/global/open-in-matlab-online.svg)](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Battery-Systems&project=BatterySystem.prj&file=README.mlx) - -[![MATLAB Versions Tested](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2FMathWorks-Teaching-Resources%2FBattery-Systems%2Frelease%2FImages%2FTestedWith.json)](https://MathWorks-Teaching-Resources.github.io/Battery-Systems) - -**Curriculum Module** - -_Created with R2024a. Compatible with R2024a and later releases._ - # Information This curriculum module contains interactive [ MATLAB® live scripts](https://www.mathworks.com/products/matlab/live-editor.html) that contain learning material covering the fundamental concepts and terminology of battery systems. The focus is on designing and modeling battery systems using different tools (MATLAB, Simulink, and Simscape). - ## Background You can use these live scripts as demonstrations in lectures, class activities, or interactive assignments outside class. This module covers basic battery pack design, battery cell modeling (electrical and thermal), and the basics of battery management systems. It also includes examples of modeling using different approaches (MATLAB, Simulink, and Simscape) and State of Charge (SoC) estimation. -The instructions inside the live scripts will guide you through the exercises and activities. Get started with each live script by running it one section at a time. To stop running the script or a section midway (for example, when an animation is in progress), use the EndIcon.png Stop button in the **RUN** section of the **Live Editor** tab in the MATLAB Toolstrip. +The instructions inside the live scripts will guide you through the exercises and activities. Get started with each live script by running it one section at a time. To stop running the script or a section midway (for example, when an animation is in progress), use the image_0.png Stop button in the **RUN** section of the **Live Editor** tab in the MATLAB Toolstrip. ## Contact Us @@ -35,14 +25,14 @@ This module assumes knowledge of electrical circuits as discussed in [DC Circuit ### Accessing the Module ### **On MATLAB Online:** -Use the [OpenInMO.png](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Battery-Systems&project=BatterySystem.prj) link to download the module. You will be prompted to log in or create a MathWorks account. The project will be loaded, and you will see an app with several navigation options to get you started. +Use the [image_1.png](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Battery-Systems&project=BatterySystem.prj) link to download the module. You will be prompted to log in or create a MathWorks account. The project will be loaded, and you will see an app with several navigation options to get you started. ### **On Desktop:** Download or clone this repository. Open MATLAB, navigate to the folder containing these scripts, and double\-click [BatterySystem.prj](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Battery-Systems&project=BatterySystem.prj&file=README.mlx). It will add the appropriate files to your MATLAB path and open an app that asks you where you would like to start. -Ensure you have all the required products (listed below) installed. If you need to include a product, add it using the Add\-On Explorer. To install an add\-on, go to the **Home** tab and select AddOnsIcon.png **Add-Ons** > **Get Add-Ons**. +Ensure you have all the required products (listed below) installed. If you need to include a product, add it using the Add\-On Explorer. To install an add\-on, go to the **Home** tab and select image_2.png **Add-Ons** > **Get Add-Ons**. ## Products @@ -74,26 +64,32 @@ This module uses all of the following products: ## [**BatteryModeling.mlx**](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Battery-Systems&project=BatterySystem.prj&file=&file=FunctionLibrary/BatteryModeling.mlx) | | | | :-- | :-- | -| energy-storage.svg
| **In this script, students will...**
$\bullet$ Learn about battery modeling principles.
$\bullet$ Conduct experimental observations and data analysis.
$\bullet$ Develop and calibrate an equivalent circuit model for a battery cell.
| +| image_5.svg
| **In this script, students will...**
$\bullet$ Learn about battery modeling principles.
$\bullet$ Conduct experimental observations and data analysis.
$\bullet$ Develop and calibrate an equivalent circuit model for a battery cell.
| | | | ## [**ThermalModeling.mlx**](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Battery-Systems&project=BatterySystem.prj&file=Scripts/ThermalModeling.mlx) | | | | :-- | :-- | -| Thermal.svg
| **In this script, students will...**
$\bullet$ Learn about battery thermal modeling principles.
$\bullet$ Develop a computation model of battery heating and cooling.
$\bullet$ Compare different heating and cooling scenarios.
| +| image_6.svg
| **In this script, students will...**
$\bullet$ Learn about battery thermal modeling principles.
$\bullet$ Develop a computation model of battery heating and cooling.
$\bullet$ Compare different heating and cooling scenarios.
| | | | ## [**BatteryManagementSystem.mlx**](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Battery-Systems&project=BatterySystem.prj&file=&file=FunctionLibrary/BatteryManagementSystem.mlx) | | | | :-- | :-- | -| SoC.png
| **In this script, students will...**
$\bullet$ Learn about constant voltage and constant current charging.
$\bullet$ Develop algorithms to estimate a battery state of charge (SoC).
| +| image_7.png
| **In this script, students will...**
$\bullet$ Learn about constant voltage and constant current charging.
$\bullet$ Develop algorithms to estimate a battery state of charge (SoC).
| | | | # Related Courseware Modules +## [Power Electronics](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Power-Electronics&project=PowerElectronics.prj&file=README.mlx) +| | | +| :-- | :-- | +| image_8.png
| **Available on:**
[image_9.png](https://www.mathworks.com/matlabcentral/fileexchange/173035-power-electronics)
[image_10.png](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Power-Electronics&project=PowerElectronics.prj&file=README.mlx)
[GitHub](https://github.com/MathWorks-Teaching-Resources/Power-Electronics)
| +| | | + ## [ DC Circuit Analysis](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/DC-Circuit-Analysis&project=DCCircuitAnalysis.prj) | | | | :-- | :-- | -| image_8.png
| **Available on:**
[OpenInFX.png](https://www.mathworks.com/matlabcentral/fileexchange/103375-dc-circuit-analysis)
[OpenInMO.png](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/DC-Circuit-Analysis&project=DCCircuitAnalysis.prj)
[GitHub](https://github.com/MathWorks-Teaching-Resources/DC-Circuit-Analysis)
| +| image_11.png
| **Available on:**
[image_12.png](https://www.mathworks.com/matlabcentral/fileexchange/103375-dc-circuit-analysis)
[image_13.png](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/DC-Circuit-Analysis&project=DCCircuitAnalysis.prj)
[GitHub](https://github.com/MathWorks-Teaching-Resources/DC-Circuit-Analysis)
| | | | diff --git a/README.mlx b/README.mlx index 5532f6d..ff33646 100644 Binary files a/README.mlx and b/README.mlx differ diff --git a/Scripts/BatteryCharger.mlx b/Scripts/BatteryCharger.mlx index fcfba81..9c93d5c 100644 Binary files a/Scripts/BatteryCharger.mlx and b/Scripts/BatteryCharger.mlx differ diff --git a/Scripts/EVBatteryDesign.mlx b/Scripts/EVBatteryDesign.mlx index 4330fe0..5a5c230 100644 Binary files a/Scripts/EVBatteryDesign.mlx and b/Scripts/EVBatteryDesign.mlx differ diff --git a/Scripts/HowDoBatteryWork.mlx b/Scripts/HowDoBatteryWork.mlx index 5ba5108..81758ea 100644 Binary files a/Scripts/HowDoBatteryWork.mlx and b/Scripts/HowDoBatteryWork.mlx differ diff --git a/Scripts/ModelingWithMATLAB.mlx b/Scripts/ModelingWithMATLAB.mlx index f7838ed..8b3e95d 100644 Binary files a/Scripts/ModelingWithMATLAB.mlx and b/Scripts/ModelingWithMATLAB.mlx differ diff --git a/Scripts/ModelingWithSimscape.mlx b/Scripts/ModelingWithSimscape.mlx index 0a4610e..71823bb 100644 Binary files a/Scripts/ModelingWithSimscape.mlx and b/Scripts/ModelingWithSimscape.mlx differ diff --git a/Scripts/ModelingWithSimulink.mlx b/Scripts/ModelingWithSimulink.mlx index 2e4c426..8809c9f 100644 Binary files a/Scripts/ModelingWithSimulink.mlx and b/Scripts/ModelingWithSimulink.mlx differ diff --git a/Scripts/StateOfCharge.mlx b/Scripts/StateOfCharge.mlx index 9bb268a..d316f60 100644 Binary files a/Scripts/StateOfCharge.mlx and b/Scripts/StateOfCharge.mlx differ diff --git a/Scripts/ThermalModeling.mlx b/Scripts/ThermalModeling.mlx index a639123..adbbf35 100644 Binary files a/Scripts/ThermalModeling.mlx and b/Scripts/ThermalModeling.mlx differ diff --git a/SoftwareTests/PostFiles/PostBatteryChargerSoln.m b/SoftwareTests/PostFiles/PostBatteryChargerSoln.m new file mode 100644 index 0000000..fb41932 --- /dev/null +++ b/SoftwareTests/PostFiles/PostBatteryChargerSoln.m @@ -0,0 +1,3 @@ +% Post-run script for BatteryChargerSoln.mlx +% ---- Post-run commands ----- + diff --git a/SoftwareTests/PostFiles/PostEVBatteryDesignSoln.m b/SoftwareTests/PostFiles/PostEVBatteryDesignSoln.m new file mode 100644 index 0000000..802dd38 --- /dev/null +++ b/SoftwareTests/PostFiles/PostEVBatteryDesignSoln.m @@ -0,0 +1,3 @@ +% Post-run script for EVBatteryDesignSoln.mlx +% ---- Post-run commands ----- + diff --git a/SoftwareTests/PostFiles/PostHowDoBatteryWorkSoln.m b/SoftwareTests/PostFiles/PostHowDoBatteryWorkSoln.m new file mode 100644 index 0000000..4d573d0 --- /dev/null +++ b/SoftwareTests/PostFiles/PostHowDoBatteryWorkSoln.m @@ -0,0 +1,3 @@ +% Post-run script for HowDoBatteryWorkSoln.mlx +% ---- Post-run commands ----- + diff --git a/SoftwareTests/PostFiles/PostModelingWithMATLABSoln.m b/SoftwareTests/PostFiles/PostModelingWithMATLABSoln.m new file mode 100644 index 0000000..7980b43 --- /dev/null +++ b/SoftwareTests/PostFiles/PostModelingWithMATLABSoln.m @@ -0,0 +1,3 @@ +% Post-run script for ModelingWithMATLABSoln.mlx +% ---- Post-run commands ----- + diff --git a/SoftwareTests/PostFiles/PostModelingWithSimscapeSoln.m b/SoftwareTests/PostFiles/PostModelingWithSimscapeSoln.m new file mode 100644 index 0000000..1d77305 --- /dev/null +++ b/SoftwareTests/PostFiles/PostModelingWithSimscapeSoln.m @@ -0,0 +1,3 @@ +% Post-run script for ModelingWithSimscapeSoln.mlx +% ---- Post-run commands ----- + diff --git a/SoftwareTests/PostFiles/PostModelingWithSimulinkSoln.m b/SoftwareTests/PostFiles/PostModelingWithSimulinkSoln.m new file mode 100644 index 0000000..498d735 --- /dev/null +++ b/SoftwareTests/PostFiles/PostModelingWithSimulinkSoln.m @@ -0,0 +1,3 @@ +% Post-run script for ModelingWithSimulinkSoln.mlx +% ---- Post-run commands ----- + diff --git a/SoftwareTests/PostFiles/PostStateOfChargeSoln.m b/SoftwareTests/PostFiles/PostStateOfChargeSoln.m new file mode 100644 index 0000000..5ee4eb0 --- /dev/null +++ b/SoftwareTests/PostFiles/PostStateOfChargeSoln.m @@ -0,0 +1,3 @@ +% Post-run script for StateOfChargeSoln.mlx +% ---- Post-run commands ----- + diff --git a/SoftwareTests/PostFiles/PostThermalModelingSoln.m b/SoftwareTests/PostFiles/PostThermalModelingSoln.m new file mode 100644 index 0000000..89b72a3 --- /dev/null +++ b/SoftwareTests/PostFiles/PostThermalModelingSoln.m @@ -0,0 +1,3 @@ +% Post-run script for ThermalModelingSoln.mlx +% ---- Post-run commands ----- + diff --git a/SoftwareTests/PreFiles/PreBatteryChargerSoln.m b/SoftwareTests/PreFiles/PreBatteryChargerSoln.m new file mode 100644 index 0000000..5c05521 --- /dev/null +++ b/SoftwareTests/PreFiles/PreBatteryChargerSoln.m @@ -0,0 +1,5 @@ +% Pre-run script for BatteryChargerSoln.mlx +% ---- Known Issues ----- +KnownIssuesID = ""; +% ---- Pre-run commands ----- + diff --git a/SoftwareTests/PreFiles/PreEVBatteryDesignSoln.m b/SoftwareTests/PreFiles/PreEVBatteryDesignSoln.m new file mode 100644 index 0000000..a0ca069 --- /dev/null +++ b/SoftwareTests/PreFiles/PreEVBatteryDesignSoln.m @@ -0,0 +1,5 @@ +% Pre-run script for EVBatteryDesignSoln.mlx +% ---- Known Issues ----- +KnownIssuesID = ""; +% ---- Pre-run commands ----- + diff --git a/SoftwareTests/PreFiles/PreHowDoBatteryWorkSoln.m b/SoftwareTests/PreFiles/PreHowDoBatteryWorkSoln.m new file mode 100644 index 0000000..c22a726 --- /dev/null +++ b/SoftwareTests/PreFiles/PreHowDoBatteryWorkSoln.m @@ -0,0 +1,5 @@ +% Pre-run script for HowDoBatteryWorkSoln.mlx +% ---- Known Issues ----- +KnownIssuesID = ""; +% ---- Pre-run commands ----- + diff --git a/SoftwareTests/PreFiles/PreModelingWithMATLABSoln.m b/SoftwareTests/PreFiles/PreModelingWithMATLABSoln.m new file mode 100644 index 0000000..4a9055c --- /dev/null +++ b/SoftwareTests/PreFiles/PreModelingWithMATLABSoln.m @@ -0,0 +1,5 @@ +% Pre-run script for ModelingWithMATLABSoln.mlx +% ---- Known Issues ----- +KnownIssuesID = ""; +% ---- Pre-run commands ----- + diff --git a/SoftwareTests/PreFiles/PreModelingWithSimscapeSoln.m b/SoftwareTests/PreFiles/PreModelingWithSimscapeSoln.m new file mode 100644 index 0000000..7bdc955 --- /dev/null +++ b/SoftwareTests/PreFiles/PreModelingWithSimscapeSoln.m @@ -0,0 +1,5 @@ +% Pre-run script for ModelingWithSimscapeSoln.mlx +% ---- Known Issues ----- +KnownIssuesID = ""; +% ---- Pre-run commands ----- + diff --git a/SoftwareTests/PreFiles/PreModelingWithSimulinkSoln.m b/SoftwareTests/PreFiles/PreModelingWithSimulinkSoln.m new file mode 100644 index 0000000..ed57700 --- /dev/null +++ b/SoftwareTests/PreFiles/PreModelingWithSimulinkSoln.m @@ -0,0 +1,5 @@ +% Pre-run script for ModelingWithSimulinkSoln.mlx +% ---- Known Issues ----- +KnownIssuesID = ""; +% ---- Pre-run commands ----- + diff --git a/SoftwareTests/PreFiles/PreStateOfChargeSoln.m b/SoftwareTests/PreFiles/PreStateOfChargeSoln.m new file mode 100644 index 0000000..505aa09 --- /dev/null +++ b/SoftwareTests/PreFiles/PreStateOfChargeSoln.m @@ -0,0 +1,5 @@ +% Pre-run script for StateOfChargeSoln.mlx +% ---- Known Issues ----- +KnownIssuesID = ""; +% ---- Pre-run commands ----- + diff --git a/SoftwareTests/PreFiles/PreThermalModelingSoln.m b/SoftwareTests/PreFiles/PreThermalModelingSoln.m new file mode 100644 index 0000000..54b90dd --- /dev/null +++ b/SoftwareTests/PreFiles/PreThermalModelingSoln.m @@ -0,0 +1,5 @@ +% Pre-run script for ThermalModelingSoln.mlx +% ---- Known Issues ----- +KnownIssuesID = ""; +% ---- Pre-run commands ----- +