Update Power Split Drive Unit component and impacted components. Add tests.

Author: Isaac-Ito-MW

Components/Engine/Engine_refsub_Basic.mdl

@@ -18,10 +18,10 @@
 motorDriveUnit.dampSpringStiffness_Nm_per_rad = 10000;
 motorDriveUnit.dampSpringFriction_Nm_per_rpm = 100;
 
-smoothing.mdu_dampSpringVelTol_rpm = 0.1;
+smoothing.MDU_dampSpringVelTol_rpm = 0.1;
 
 %% Initial conditions
 
-initial.motorDriveUnitTemperature_degC = 20;
+initial.MDU_Temperature_K = 273.15 + 20;
 
-initial.AirTemp_degC = 20;
+initial.MDU_AirTemp_K = 273.15 + 20;

Components/Engine/Harness/Engine_Component_harness_model.mdl

@@ -0,0 +1,47 @@
+# Motor Drive Unit Component
+
+This is a model of motor drive unit (MDU),
+which is a system of electric motor and its controller.
+The MDU model included in this component is highly abstract
+and simulates the behavior of power conversion
+between electric power and mechanical power
+with the considerations for the power conversion efficiency.
+
+The component is provided as a block in
+Simulink library file
+
+- `MotorDriveUnit_refsub_library.mdl`
+
+It is designed to be used as a reusable model.
+The content of the block is
+`MotorDriveUnit_refsub_Basic.mdl`,
+and its parameters are defined in
+`MotorDriveUnit_refsub_Basic_params.m`.
+
+`Harness` folder contains the following harness model
+to run simulation with the Engine component.
+
+- `MotorDriveUnit_Component_harness_model.mdl`
+
+## Test Cases
+
+`TestCases` folder contains Live Scripts
+that are used to visually inspect the simulation behaviors
+of the model in various simulation scenarios as follows.
+
+- Constant ...
+  All inputs are constant.
+  This is used to check that the harness model runs.
+
+- Start engine 1 ...
+  Starting the engine with a motor is simulated.
+  This first case is configured for a light mechanical load,
+  with which engine can start without a reduction gear.
+
+- Start engine 2 ...
+  This is the same as the above case, but
+  it is configured for a heavy mechanical load,
+  similar to a passenger vehicle.
+  A reduction gear is used to increase torque from engine.
+
+_Copyright 2022 The MathWorks, Inc._

Components/MotorDriveUnit/Harness/MotorDriveUnit_Component_harness_model.mdl

@@ -50,8 +50,7 @@
     fullfile(TopFolder, "Test", "MotorDriveUnit_Component_UnitTest_MQC.m"), ...
     fullfile(TopFolder, "TestCases", "MotorDriveUnit_Component_testcase_Constant.mlx"), ...
     fullfile(TopFolder, "TestCases", "MotorDriveUnit_Component_testcase_Drive.mlx"), ...
-    fullfile(TopFolder, "Utility", "MotorDriveUnit_Component_plotResultInputs.m"), ...
-    fullfile(TopFolder, "Utility", "MotorDriveUnit_Component_plotResultOutputs.m"), ...
+    fullfile(TopFolder, "Utility", "MotorDriveUnit_Component_plotResults.m"), ...
     fullfile(TopFolder, "MotorDriveUnit_refsub_Basic_params.m")], ...
   Producing = coverageReport );
 
@@ -61,4 +60,4 @@
 
 results = run(runner, suite);
 
-disp(results)
+assertSuccess(results)

Components/MotorDriveUnit/MotorDriveUnit_refsub_Basic.mdl

@@ -0,0 +1,29 @@
+function fig = MotorDriveUnit_Component_plotResults(nvpairs)
+% plots the simulation result.
+
+% Copyright 2021-2022 The MathWorks, Inc.
+
+arguments
+  nvpairs.SimData timetable
+  nvpairs.FigureHeight (1,1) {mustBePositive} = 300
+end
+
+sigNames = [ ...
+  "Motor torque command",...
+  "Axle clutch switch", ...
+  "Axle speed input", ...
+  "Axle torque input", ...
+  "Motor power rate", ...
+  "Motor speed", ...
+  "Motor temperature", ...
+  "Battery power", ...
+  "Battery current", ...
+  "Battery voltage", ...
+  "Battery SOC" ];
+
+for i = 1 : numel(sigNames)
+  fig = plotSimulationResultSignal(SimData = nvpairs.SimData, SignalName = sigNames(i));
+  fig.Position(4) = nvpairs.FigureHeight;
+end
+
+end  % function