Initial commit for R2024b

Author: VarunArora1988

.github/workflows/ci.yml

@@ -9,7 +9,7 @@
 # For details about the syntax of this file, see
 # https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions
 
-# Copyright 2024 The MathWorks, Inc.
+# Copyright 2024 - 2025 The MathWorks, Inc.
 
 name: CI using MATLAB
 
@@ -42,14 +42,21 @@ jobs:
     steps:
 
       - name: Check out repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Setup MATLAB
-        uses: matlab-actions/setup-matlab@v1
+        uses: matlab-actions/setup-matlab@v2
         with:
-          release: R2024a
+          release: R2024b
+          cache: true
+          products: |
+            Simulink
+            Simscape
+            Simscape_Driveline
+            Simscape_Fluids
+            MATLAB_Test
 
       - name: Run tests
-        uses: matlab-actions/run-command@v1
+        uses: matlab-actions/run-command@v2
         with:
           command: openProject(pwd); TestRunner;

Component/Transmission/HydrostaticCVT.slx

@@ -5,7 +5,7 @@
 % visualize energy charts for a tractor.
 %
 
-% Copyright 2024 The MathWorks, Inc.
+% Copyright 2024 - 2025 The MathWorks, Inc.
 
 %% Tractor For Tillage Operation
 %
@@ -75,10 +75,24 @@
 % <<TransmissionEnergySankeyDiagram.png>>
 %
 
+%%
+%
+% 4. *Perform Transmission Trade-Off Study for a Tractor:* You can
+% select transmission hydraulic components from available options that 
+% minimize energy consumption for a specific agricultural drive cycle.
+%
+
+%%
+%
+% <<TransmissionTradeOffHeatmap.png>>
+%
+
 %% Workflows  
 %
 % * <matlab:open('TransmissionEnergyChartingWorkflow.mlx') Create Transmission 
 % Energy Charting for a Tractor>
+% * <matlab:open('TransmissionTradeOffStudyWorkflow.mlx') Perform 
+% Transmission Trade-Off Study for a Tractor>
 %
 %% Model
 %

Model/TractorEnergyComputation.slx

@@ -7,9 +7,9 @@
 To make changes, update the MATLAB code and republish this document.
       -->
 <title>Tractor Model with Simscape</title>
-<meta name="generator" content="MATLAB 24.1">
+<meta name="generator" content="MATLAB 24.2">
 <link rel="schema.DC" href="http://purl.org/dc/elements/1.1/">
-<meta name="DC.date" content="2024-07-11">
+<meta name="DC.date" content="2025-02-18">
 <meta name="DC.source" content="TractorModelOverview.m">
 <style type="text/css">
 html,body,div,span,applet,object,iframe,h1,h2,h3,h4,h5,h6,p,blockquote,pre,a,abbr,acronym,address,big,cite,code,del,dfn,em,font,img,ins,kbd,q,s,samp,small,strike,strong,tt,var,b,u,i,center,dl,dt,dd,ol,ul,li,fieldset,form,label,legend,table,caption,tbody,tfoot,thead,tr,th,td{margin:0;padding:0;border:0;outline:0;font-size:100%;vertical-align:baseline;background:transparent}body{line-height:1}ol,ul{list-style:none}blockquote,q{quotes:none}blockquote:before,blockquote:after,q:before,q:after{content:'';content:none}:focus{outine:0}ins{text-decoration:none}del{text-decoration:line-through}table{border-collapse:collapse;border-spacing:0}
@@ -87,10 +87,10 @@ <h2>Contents</h2>
 <a href="#1">Tractor For Tillage Operation</a>
 </li>
 <li>
-<a href="#3">Workflows</a>
+<a href="#5">Workflows</a>
 </li>
 <li>
-<a href="#4">Model</a>
+<a href="#6">Model</a>
 </li>
 </ul>
 </div>
@@ -124,24 +124,30 @@ <h2 id="1">Tractor For Tillage Operation</h2>
 <p>3. <b>Create Transmission Energy Charting for a Tractor:</b> After you create the tractor energy computation model, you can compute the transmission losses and visualize the energy flow from the engine to the wheels. To create the transmission energy charting for a tractor, see <a href="matlab:open('TransmissionEnergyChartingWorkflow.mlx')">Create Transmission Energy Charting for a Tractor</a>. This figure shows the energy flow of the tractor and was generated using the Create Transmission Energy Charting for a Tractor workflow.</p>
 <p>
 <img vspace="5" hspace="5" src="TransmissionEnergySankeyDiagram.png" alt=""> </p>
-<h2 id="3">Workflows</h2>
+<p>4. <b>Perform Transmission Trade-Off Study for a Tractor:</b> You can select transmission hydraulic components from available options that minimize energy consumption for a specific agricultural drive cycle.</p>
+<p>
+<img vspace="5" hspace="5" src="TransmissionTradeOffHeatmap.png" alt=""> </p>
+<h2 id="5">Workflows</h2>
 <div>
 <ul>
 <li>
 <a href="matlab:open('TransmissionEnergyChartingWorkflow.mlx')">Create Transmission Energy Charting for a Tractor</a>
 </li>
+<li>
+<a href="matlab:open('TransmissionTradeOffStudyWorkflow.mlx')">Perform Transmission Trade-Off Study for a Tractor</a>
+</li>
 </ul>
 </div>
-<h2 id="4">Model</h2>
+<h2 id="6">Model</h2>
 <div>
 <ul>
 <li>
 <a href="matlab:open_system('TractorEnergyComputation.slx')">Tractor Energy Computation Model</a>
 </li>
 </ul>
 </div>
-<p class="footer">Copyright 2024 The MathWorks, Inc.<br>
-<a href="https://www.mathworks.com/products/matlab/">Published with MATLAB&reg; R2024a</a>
+<p class="footer">Copyright 2024 - 2025 The MathWorks, Inc.<br>
+<a href="https://www.mathworks.com/products/matlab/">Published with MATLAB&reg; R2024b</a>
 <br>
 </p>
 </div>
@@ -154,7 +160,7 @@ <h2 id="4">Model</h2>
 % visualize energy charts for a tractor.
 %
 
-% Copyright 2024 The MathWorks, Inc.
+% Copyright 2024 - 2025 The MathWorks, Inc.
 
 %% Tractor For Tillage Operation
 %
@@ -224,10 +230,24 @@ <h2 id="4">Model</h2>
 % <<TransmissionEnergySankeyDiagram.png>>
 %
 
+%%
+%
+% 4. *Perform Transmission Trade-Off Study for a Tractor:* You can
+% select transmission hydraulic components from available options that 
+% minimize energy consumption for a specific agricultural drive cycle.
+%
+
+%%
+%
+% <<TransmissionTradeOffHeatmap.png>>
+%
+
 %% Workflows  
 %
 % * <matlab:open('TransmissionEnergyChartingWorkflow.mlx') Create Transmission 
 % Energy Charting for a Tractor>
+% * <matlab:open('TransmissionTradeOffStudyWorkflow.mlx') Perform 
+% Transmission Trade-Off Study for a Tractor>
 %
 %% Model
 %

Overview/TractorModelOverview.m

@@ -36,10 +36,15 @@ the engine to the wheels.
 
 ![](Overview/html/TransmissionEnergySankeyDiagram.png)
 
+4. Perform Transmission Trade-Off Study for a Tractor for a given 
+agricultural drive cycle.
+
+![](Overview/html/TransmissionTradeOffHeatmap.png)
+
 
 ## Setup 
 * Clone the project repository.
 * Open TractorSimscape.prj to get started with the project. 
-* Requires MATLAB® release R2024a or newer.
+* Requires MATLAB® release R2024b or newer.
 
-Copyright 2024 The MathWorks, Inc.
+Copyright 2024 - 2025 The MathWorks, Inc.

Overview/html/TractorEnergyComputationModel.png

@@ -3,4 +3,5 @@
 % Copyright 2024 The MathWorks, Inc.
 
 web('TractorModelOverview.html') 
-open_system('TractorEnergyComputation')
+open_system('TractorEnergyComputation')
+run TractorEnergyComputationInput

Overview/html/TractorModelOverview.html

@@ -1,6 +1,6 @@
 % Code to initialize parameters for TractorEnergyComputation
 
-% Copyright 2024 The MathWorks, Inc.
+% Copyright 2024 - 2025 The MathWorks, Inc.
 
 %% Tractor Parameters
 
@@ -70,7 +70,7 @@
 finalDrive.gearRatioRear       = 4;                    % (1) Carrier to drive shaft teeth ratio
 finalDrive.gearRatioFront      = 2;                    % (1) Carrier to drive shaft teeth ratio
 finalDrive.gearRatioFinalDrive = 1;                    % (1) Follower to base teeth ratio
-finalDrive.inertiaDriveshaft   = 15;                   % (kg-m^2) Drive shaft inertia
+finalDrive.inertiaDriveshaft   = 1;                    % (kg-m^2) Drive shaft inertia
 
 %% Hydrostatic Transmission Parameters
 % Pump and Motor Parameters
@@ -110,6 +110,7 @@
 
 implement.depth1Tillage                    = 9;        % (cm) Tillage depth 1
 implement.depth2Tillage                    = 10;       % (cm) Tillage depth 2
+implement.depth3Tillage                    = 8;        % (cm) Tillage depth for transmission trade-off study
 implement.angleRake                        = 55;       % (deg) Rake angle of implement tool
 implement.numberTools                      = 5;        % (1) Number of tools for a narrow implement