Manually resolved merge conflict (#37)

Because I created a PR, I can't be a reviewer. Ok to bypass the review step.

Author: Isaac-Ito-MW

BEVProjectDescription.html

@@ -19,7 +19,7 @@
 
 win.Name = "BEV Project Navigator";
 win.Width = 560;
-win.Height = 660;
+win.Height = 680;
 
 width_unit = LiteApp5.Utility.Constant.Width{"unitwidth"};
 indent = width_unit * 2;
@@ -119,11 +119,23 @@
 row = NewRow(layout, column);
 LiteApp5.Component.Label(NewSlot(layout, row, Width=indent), Text="");
 
-target_app = "Vehicle1DPerformanceDesignApp";
+target_description_page = "Vehicle1D_Description.html";
+LiteApp5.Utility.getFileFullPath(target_description_page);
+
+link_ui = LiteApp5.Component.Hyperlink(NewSlot(layout, row));
+link_ui.HyperlinkText = "Vehicle1D description";
+link_ui.Tooltip = "Open page: " + target_description_page;
+link_ui.HyperlinkClickedCallback = @() open_target_page(target_description_page);
+
+%%
+row = NewRow(layout, column);
+LiteApp5.Component.Label(NewSlot(layout, row, Width=indent), Text="");
+
+target_app = "Vehicle1DPerformanceDesignApp_Basic";
 LiteApp5.Utility.getFileFullPath(target_app);
 
 link_ui = LiteApp5.Component.Hyperlink(NewSlot(layout, row));
-link_ui.HyperlinkText = "Vehicle1D performance design app";
+link_ui.HyperlinkText = "Vehicle1D performance design app for Basic model";
 link_ui.Tooltip = "Open app: " + target_app;
 link_ui.HyperlinkClickedCallback = @() open_app(target_app);
 
@@ -141,7 +153,7 @@
 LiteApp5.Utility.getFileFullPath(target_description_page);
 
 link_ui = LiteApp5.Component.Hyperlink(NewSlot(layout, row));
-link_ui.HyperlinkText = "MDU description page";
+link_ui.HyperlinkText = "MDU description";
 link_ui.Tooltip = "Open page: " + target_description_page;
 link_ui.HyperlinkClickedCallback = @() open_target_page(target_description_page);
 

BEVProjectNavigator.m

@@ -0,0 +1,25 @@
+function App = Vehicle1DPerformanceDesignApp_Basic()
+%% Vehicle1D performance design app for Basic vehicle1d model
+
+% Copyright 2025 The MathWorks, Inc.
+
+arguments (Output)
+  App (1,:) Vehicle1DPerformanceDesignAppMain
+end  % arguments
+
+parameter_file = "Vehicle1D_refsub_Basic_params";
+block_path = "Vehicle1D_refsub_Basic/Longitudinal Vehicle";
+
+% Load block parameters to the base workspace.
+disp("Loading parameters: <a href=""matlab:edit('"+ parameter_file +"')"">" + parameter_file + "</a>")
+evalin("base", parameter_file)
+
+% Open the app with the target block initially loaded.
+vehicle_app = Vehicle1DPerformanceDesignAppMain(BlockPath=block_path);
+
+vehicle_app.Window.HeaderUI.AppSourceName = mfilename;
+
+if nargout > 0
+  App = vehicle_app;
+end  % if
+end  % function

Components/Vehicle1D/Model-Basic/Vehicle1DPerformanceDesignApp_Basic.m

@@ -0,0 +1,98 @@
+classdef Vehicle1DPerformanceDesignApp_Basic_uitest < matlab.uitest.TestCase
+  %% Class implementation of UI test
+  % Overview of App Testing Framework
+  % https://www.mathworks.com/help/matlab/matlab_prog/overview-of-app-testing-framework.html
+  %
+  % Table of Verifications, Assertions, and Other Qualifications
+  % https://www.mathworks.com/help/matlab/matlab_prog/types-of-qualifications.html
+
+  % Overview of App Testing Framework
+  % https://www.mathworks.com/help/matlab/matlab_prog/overview-of-app-testing-framework.html
+
+  % Copyright 2024-2025 The MathWorks, Inc.
+
+  properties
+
+    % Do not specify the class name for a property to hold a handle to an app.
+    % For class-based test apps, the class name is the app name, making
+    % it difficult to use a common teardown if the class name is specified here.
+    App (1,1)
+
+  end  % properties
+
+  methods (TestMethodSetup)
+    % Functions in the TestMethodSetup section always run before
+    % each test defined in the Test section runs.
+
+    function test_method_setup(testcase)
+      %%
+      close all
+      bdclose all
+
+      % addTeardown adds a function which always runs after each test.
+      % Even if the execution of a test ends with an error, the teardown function runs.
+      addTeardown(testcase, @close_all)
+
+      function close_all
+        close all
+        bdclose all
+
+        % Delete the app's figure object from memory.
+        if isstruct(testcase.App)
+          % Function-based app
+          if not(isfield(testcase.App, "Window"))
+            % There is no window to close.
+
+            return
+
+          end  % if
+          % App.Window is a struct field which does not trigger destructor.
+          % Delete the figure directly.
+          delete(testcase.App.Window.MainFigure)
+        else
+          % Class-based app
+          % App.Window's destructor deletes the figure.
+          delete(testcase.App.Window)
+        end  % if
+      end  % nested function
+    end  % function
+
+  end  % methods
+
+  methods (Test)
+    % Functions in the Test section are the tests.
+    % Before a function in this section runs, the functions defined in the TestMethodSetup section run.
+
+    %% Minimum quality check (MQC)
+    % Check that models, scripts, functions, and classes run right out of the box.
+
+    function MQC_App_1(testcase)
+      verifyWarningFree(testcase, @() target())
+      function target()
+        testcase.App = Vehicle1DPerformanceDesignApp_Basic;  % !test-target
+      end  % nested function
+    end  % function
+
+    %% Other tests
+
+    function test_vehicle_mass(testcase)
+      % Check that the parameter values are loaded as expected.
+      testcase.App = Vehicle1DPerformanceDesignApp_Basic;
+      sscval = testcase.App.VehicleMassUI.SimscapeValue;
+      expected = value(sscval, "kg");
+      actual = 2400;
+      verifyEqual(testcase, expected, actual)
+    end  % function
+
+    function test_frontal_area(testcase)
+      % Check that the parameter values are loaded as expected.
+      testcase.App = Vehicle1DPerformanceDesignApp_Basic;
+      sscval = testcase.App.FrontalAreaUI.SimscapeValue;
+      expected = value(sscval, "m^2");
+      actual = 0.9 * 1.921 * 1.624;
+      verifyEqual(testcase, expected, actual, RelTol=0.01)
+    end  % function
+
+  end  % methods
+
+end  % classdef

Components/Vehicle1D/Model-Basic/Vehicle1DPerformanceDesignApp_Basic_uitest.m

@@ -143,6 +143,8 @@ function delete(App)
         App.SelectorUI.ModelFileFullPath = modelfile_fullpath;
         % Block path in the drop down uses " / " as the subsystem separator.
         App.SelectorUI.BlockPathDropDownUI.Value = replace(App.BlockPath, "/", " / ");
+
+        App.SelectorUI.GetParametersFromBlockCallback()
       end  % if
 
       Show(App.Window)
@@ -185,26 +187,71 @@ function delete(App)
 
     function getParametersFromVehicleBlock(App)
       %%
+      % This function collects parameters from the block in the model specified by
+      % the block selector.
+      % If a block parameter is a workspace variable, it must have been loaded
+      % in the base workspace. If it's not loaded, the physical value UI component
+      % shows an inline error.
 
       App.ModelName = App.SelectorUI.ModelName;
       App.BlockPath = App.SelectorUI.BlockPath;
 
-      previous_parameters = App.Parameters;
-      App.Parameters = setup_all_data(App);
+      % Before updating UI components, turn off the plot auto-update because
+      % all UI components whose value changes call auto-update,
+      % which is unecessary and noticeably slows down the update.
+      previous_auto_update_value = App.AutoUpdateUI.Value;
+      App.AutoUpdateUI.Value = false;
 
-      if not(App.BlockIsReady)
-        % There was an issue in getting parameters from the block.
-        % Recover the previous state.
-        App.Parameters = previous_parameters;
-        App.BlockPath = "";
+      % Full enum name is returned, e.g., "sdl.enum.VehicleParameterizationType.Regular".
+      full_enum_name = get_param(App.BlockPath, "vehParamType");
+      % Get the last part, which is the enum element name, e.g. "Regular".
+      enum_element_name = extractAfter(full_enum_name,  asManyOfPattern(wildcardPattern + "."));
 
-        return
+      if enum_element_name ~= "Regular"
+        id = App.errorID + ":InvalidBlockParameter";
+        msg = LiteApp5.Utility.i18n("Only ""Regular"" Parameterization type for Longitudinal Vehicle block is supported.");
+
+        throw(MException(id, msg))
 
       end  % if
 
-      setParametersToUIComponents(App)
-      auto_update_plot(App)
+      App.VehicleMassUI.ValueEditFieldUI.Value = get_param(App.BlockPath, "M_vehicle");
+      App.VehicleMassUI.UnitDropDownUI.MainDropDown.Value = get_param(App.BlockPath, "M_vehicle_unit");
+
+      % R_tireroll (tire rolling radius) is skipped because it is not used in the app.
+
+      App.TireRollingCoefficientUI.Value = get_param(App.BlockPath, "C_tireroll");
+
+      App.AirDragCoefficientUI.Value = get_param(App.BlockPath, "C_airdrag");
+
+      App.FrontalAreaUI.Value = get_param(App.BlockPath, "A_front");
+      App.FrontalAreaUI.Unit = get_param(App.BlockPath, "A_front_unit");
+
+      App.GravitationalAccelerationUI.Value = get_param(App.BlockPath, "g");
+      App.GravitationalAccelerationUI.Unit = get_param(App.BlockPath, "g_unit");
+
+      % !todo: Air density should be public in Longitudinal Vehicle block.
+      % App.AirDensityUI.Value = get_param(App.BlockPath, "air_density");
+      % App.AirDensityUI.Unit = get_param(App.BlockPath, "air_density_unit");
+
+      % Deselect the preset because parameters are read from the specified block.
+      App.PresetUI.MainListBox.Value = {};
+
+      % -----------------------------------------------------------------------
+
+      % Synchronize the Parameters property based on the updated UI components
+      % and update other UI components for the derived parameters.
+      getParametersFromUIComponents(App)
+      App.Parameters = update_states(App.Parameters);
+      App.RoadLoadAUI.SimscapeValue = App.Parameters.RoadLoadA;
+      App.RoadLoadCUI.SimscapeValue = App.Parameters.RoadLoadC;
+      App.MaximumForceUI.SimscapeValue = App.Parameters.MaximumForce;
+      App.MaximumClimbPowerUI.SimscapeValue = App.Parameters.MaximumClimbPower;
 
+      % Recover the previous auto-update state for the plot button.
+      App.AutoUpdateUI.Value = previous_auto_update_value;
+
+      auto_update_plot(App)
     end  % function
 
     function setParametersToVehicleBlock(App)
@@ -264,14 +311,6 @@ function performancePlot(App, NameValuePair)
     function getParametersFromUIComponents(App)
       %%
 
-      if App.UseGUI
-        id = App.errorID + "AppNotVisible";
-        msg = "App must be visible before calling getParametersFromUIComponents";
-        % When this assertion fails, the app is not visible yet.
-        % Thus, show the error message in the Command Window.
-        assert(App.Window.MainFigure.Visible == "on", id, msg)
-      end  % if
-
       % Vehicle ---------------------------------------------------------------
 
       App.Parameters.VehicleMass = App.VehicleMassUI.SimscapeValue;
@@ -771,31 +810,6 @@ function callback_AutoUpdate(App)
         App.UpdateButtonUI.MainButton.Enable = "on";
       end  % if
     end  % function
-
-%{
-    function callback_LoadParametersFromBlock(App)
-      %%
-      [App.Parameters, error_message] = getParametersFromBlock(App.Parameters, App.BlockPath);
-      if error_message ~= ""
-        % Do not issue an error and return from here.
-        % Fallback data are loaded in case of an error.
-        % if App.UseGUI && isprop(App, "Window") && isprop(App.Window, "MainFigure") && App.Window.MainFigure.Visible
-          uialert(App.Window.MainFigure, error_message, "Alert")
-        % else
-        %   % App is not visible.
-        %   warning("Vehicle1DPerformanceDesignAppMain:ErrorInGetParametersFromBlock", error_message);
-        % end  % if, App UI or Command Window
-      end  % if, error
-
-      App.Parameters = update_states(App.Parameters);
-
-      setParametersToComponents(App)
-
-      if App.AutoUpdateUI.Value
-        performancePlot(App, ParentAxes=App.ParentAxes)
-      end  % if, propagation
-    end  % function
-%}
 
     function setParametersToUIComponents(App, NameValuePairs)
       %%

Components/Vehicle1D/Utility-Vehicle1D/Vehicle1DPerformanceDesignAppMain.m

@@ -305,6 +305,7 @@
       Param.MaximumForce = simscape.Value(val_F, "N");
     end  % function
 
+    %{
     function ParamString = Stringify(Param)
       %%
       arguments (Output)
@@ -330,9 +331,14 @@
       end  % for
       ParamString = join(line_str, newline);
     end  % function
+    %}
 
     function Param = getParametersFromBlock(Param, BlockPath)
       %%
+      % This function collects block parameters from the specified block and
+      % stores the parameters as simscape.Value objects.
+      % If a block parameter is a workspace variable, it is evaluated to get a numeric value.
+
       arguments (Input)
         Param
         BlockPath (1,1) string = ""
@@ -381,7 +387,18 @@
       function sscval = get_simscape_value(name)
         v = double(block_properties(name));
         if isnan(v)
-          v = evalin("base", block_properties(name));
+          try
+            v = evalin("base", block_properties(name));
+          catch exception
+            % This exception can happen when, for example, the block property is referring to
+            % a workspace variable which is not loaded.
+            id = Param.errorID + "EvalutionFailureForBlockProperty";
+            msg = LiteApp5.Utility.i18n("The evaluation of the specified block property failed: ") + name + newline + ...
+              LiteApp5.Utility.i18n("The property value was " + block_properties(name));
+
+            throw(MException(id, msg))
+
+          end  % if
         end  % if
         u = block_properties(name + "_unit");
         sscval = simscape.Value(v, u);

Components/Vehicle1D/Utility-Vehicle1D/Vehicle1DPerformanceParameters.m

@@ -37,7 +37,7 @@ in the BEV model.
  alt="Screenshot of the simulation result plots"
  width="700">
 
-BEV Project navigator App
+BEV Project Navigator App
 
 <img src="Utility/screenshot-BEV-project-navigator-app.png"
  alt="Screenshot of the longitudinal vehicle performance design app"
@@ -212,4 +212,4 @@ vehicle system-level applications using abstract models.
 
 See [`license.txt`](license.txt).
 
-_Copyright 2020-2024 The MathWorks, Inc._
+_Copyright 2020-2025 The MathWorks, Inc._