Skip to content

Commit 866554b

Browse files
Merge pull request #5 from VarunArora1988/main
R2025a
2 parents 2ea4dc9 + f94a52e commit 866554b

24 files changed

+34
-9
lines changed

.github/workflows/ci.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ jobs:
4747
- name: Setup MATLAB
4848
uses: matlab-actions/setup-matlab@v2
4949
with:
50-
release: R2024b
50+
release: R2025a
5151
cache: true
5252
products: |
5353
Simulink
11.2 KB
Binary file not shown.

Model/TractorEnergyComputation.slx

-3.48 KB
Binary file not shown.

Overview/html/TractorModelOverview.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,9 @@
77
To make changes, update the MATLAB code and republish this document.
88
-->
99
<title>Tractor Model with Simscape</title>
10-
<meta name="generator" content="MATLAB 24.2">
10+
<meta name="generator" content="MATLAB 25.1">
1111
<link rel="schema.DC" href="http://purl.org/dc/elements/1.1/">
12-
<meta name="DC.date" content="2025-02-18">
12+
<meta name="DC.date" content="2025-12-11">
1313
<meta name="DC.source" content="TractorModelOverview.m">
1414
<style type="text/css">
1515
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}
@@ -147,7 +147,7 @@ <h2 id="6">Model</h2>
147147
</ul>
148148
</div>
149149
<p class="footer">Copyright 2024 - 2025 The MathWorks, Inc.<br>
150-
<a href="https://www.mathworks.com/products/matlab/">Published with MATLAB&reg; R2024b</a>
150+
<a href="https://www.mathworks.com/products/matlab/">Published with MATLAB&reg; R2025a</a>
151151
<br>
152152
</p>
153153
</div>

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,6 @@ agricultural drive cycle.
4545
## Setup
4646
* Clone the project repository.
4747
* Open TractorSimscape.prj to get started with the project.
48-
* Requires MATLAB&reg; release R2024b or newer.
48+
* Requires MATLAB&reg; release R2025a or newer.
4949

50-
Copyright 2024 - 2025 The MathWorks, Inc.
50+
Copyright 2024 - 2026 The MathWorks, Inc.

Scripts/html/TractorEnergyComputationModelOverview.html

Lines changed: 28 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,9 @@
77
To make changes, update the MATLAB code and republish this document.
88
-->
99
<title>Tractor Energy Computation Model</title>
10-
<meta name="generator" content="MATLAB 24.1">
10+
<meta name="generator" content="MATLAB 25.1">
1111
<link rel="schema.DC" href="http://purl.org/dc/elements/1.1/">
12-
<meta name="DC.date" content="2024-07-12">
12+
<meta name="DC.date" content="2025-12-11">
1313
<meta name="DC.source" content="TractorEnergyComputationModelOverview.m">
1414
<style type="text/css">
1515
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}
@@ -119,63 +119,88 @@ <h2 id="1">Model Overview</h2>
119119
<p>
120120
<a href="matlab:open_system(%22TractorEnergyComputation%22)">Open the Tractor Energy Computation model</a>
121121
</p>
122+
<pre class="codeinput">open_system(<span class="string">'TractorEnergyComputation'</span>);
123+
set_param(find_system(bdroot,<span class="string">'FindAll'</span>,<span class="string">'on'</span>,<span class="string">'type'</span>,<span class="string">'annotation'</span>,<span class="string">'Tag'</span>,<span class="string">'ModelFeatures'</span>),<span class="string">'Interpreter'</span>,<span class="string">'off'</span>);
124+
</pre>
122125
<img vspace="5" hspace="5" src="TractorEnergyComputationModelOverview_01.png" alt=""> <p>The model represents a tractor attached to an implement. The tractor consists of the tractor body and powertrain attached to four tires: two front tires and two rear tires. The tractor body and powertrain constitutes of the engine, which is mated with the transmission and the body. The transmission is a hydrostatic continuously variable transmission (CVT) with one transmission pump and two hydraulic motors, one mounted on the front axle and one on the rear axle. The implement is connected to the rear axle and provides thrust to the rear left tire and rear right tire. The scenario subsystem models the initial conditions for tire-soil and implement-soil interaction. The Driver Controls subsystem provides the engine speed, transmission pump displacement, and implement depth commands for the Tractor subsystem. You can visualize the energy flow in the transmission by looking inside the Transmission Energy Chart Dashboard subsystem. The System Signals subsystem combines key measured signals. The Energy Calculations subsystem computes the energy consumed by the various components of the transmission.</p>
123126
<p>
124127
<a href="matlab:open_system(%22TractorEnergyComputation/Tractor%22)">Open the Tractor Subsystem</a>
125128
</p>
129+
<pre class="codeinput">open_system(<span class="string">'TractorEnergyComputation/Tractor'</span>);
130+
</pre>
126131
<img vspace="5" hspace="5" src="TractorEnergyComputationModelOverview_02.png" alt=""> <h2 id="3">Tractor Body and Powertrain Subsystem</h2>
127132
<p>The tractor body and powertrain is comprised of the engine, which is mated with the hydrostatic CVT and the vehicle body. The Vehicle Body block models the tractor body. The vehicle body is connected to the tires and transmits normal loads to and from the tires.</p>
128133
<p>
129134
<a href="matlab:open_system(%22TractorEnergyComputation/Tractor/Tractor%20Body%20and%20Powertrain/Speed%20Source%20-%20Engine%22)">Open Engine Subsystem</a>
130135
</p>
136+
<pre class="codeinput">open_system(<span class="string">'TractorEnergyComputation/Tractor/Tractor Body and Powertrain/Speed Source - Engine'</span>);
137+
</pre>
131138
<img vspace="5" hspace="5" src="TractorEnergyComputationModelOverview_03.png" alt=""> <p>An Ideal Angular Velocity Source block models the tractor engine. This tractor engine operates at fixed speed through governor control for implement load requirement. The driver control system provides the speed command to the engine. A rotational motion sensor and torque sensor measure the engine speed and torque respectively.</p>
132139
<p>
133140
<a href="matlab:open_system('TractorEnergyComputation/Tractor/Tractor%20Body%20and%20Powertrain/Hydrostatic%20CVT')">Open Hydrostatic CVT Subsystem</a>
134141
</p>
142+
<pre class="codeinput">open_system(<span class="string">'TractorEnergyComputation/Tractor/Tractor Body and Powertrain/Hydrostatic CVT'</span>);
143+
</pre>
135144
<img vspace="5" hspace="5" src="TractorEnergyComputationModelOverview_04.png" alt=""> <p>A hydrostatic CVT consists of one transmission pump that drives transmission fluid SAE 5W-30 to two hydraulic fixed-displacement motors. A variable-displacement pump models the transmission pump. One motor is mounted on the front axle and the other on the rear axle. The transmission pump receives displacement command from the driver control system. Pipes model the hydraulic resistance of the transmission circuit. A fixed-displacement charge pump, that is run by an engine, replenishes lost fluid due to the volumetric inefficiency of the transmission pump and motors and also provides power for auxilliary functions. Check valves prevent backflow to the charge pump. Pressure relief valves release excess pressure from the system. Flow rate sensors measure the volumetric flow and pressure sensors measure pressure across various transmission components. Rotational motion sensors and torque sensors measure the motor speed and torque, respectively.</p>
136145
<h2 id="6">Tire Model</h2>
137146
<p>A custom Simscape component block models the front left tire, front right tire, rear left tire, and rear right tire.</p>
138147
<p>
139148
<a href="matlab:open_system('TractorEnergyComputation/Tractor/Front%20Left%20Tire')">Open Front Left Tire Subsystem</a>
140149
</p>
150+
<pre class="codeinput">open_system(<span class="string">'TractorEnergyComputation/Tractor/Tire FL'</span>);
151+
</pre>
141152
<img vspace="5" hspace="5" src="TractorEnergyComputationModelOverview_05.png" alt=""> <p>The Tire-Soil Interaction block is a custom Simscape component that models the longitudinal tire-soil interaction and characterized based on Bekker equation. The interaction physics include tire tractive effort with slip, compaction, and flexing effects. You can optionally include the effects of tire inertia. The custom block has a mechanical rotational conserving port connected to the differential mounted on front axle. The custom block has a mechanical translational conserving port for the wheel hub through which the tire thrust is applied to the vehicle. Port <b>N</b> is a physical signal input port that applies the normal force acting on the tire. The force is considered positive if it acts downwards. Port <b>S</b> is a physical signal output port that reports the tire slip.</p>
142153
<p>Physical signal ports <b>tc</b> , <b>tphi</b> , and <b>tk</b> are the cohesion of the terrain, the angle of internal shearing resistance of the terrain, and the shear deformation parameter of the terrain, respectively. Physical signal ports <b>tykc</b> , <b>tykphi</b> , and <b>tyn</b> are the soil sinkage cohesion moduli, the soil sinkage friction moduli, and the soil sinkage exponent, respectively.</p>
143154
<h2 id="8">Implement Subsystem</h2>
144155
<p>The Implement subsystem models an implement attached to a tractor using a custom Simscape component.</p>
145156
<p>
146157
<a href="matlab:open_system('TractorEnergyComputation/Implement')">Open Implement Subsystem</a>
147158
</p>
159+
<pre class="codeinput">open_system(<span class="string">'TractorEnergyComputation/Implement'</span>,<span class="string">'force'</span>);
160+
</pre>
148161
<img vspace="5" hspace="5" src="TractorEnergyComputationModelOverview_06.png" alt=""> <p>The implement draft force is the horizontal component of the force required to pull the implement. Draft force is specified by an empirical relation as a function of field velocity. You can also provide the implement draft force as a custom function. The draft force is negative when field velocity is positive. The Implement block has a mechanical translational conserving port associated with the horizontal motion of the implement. Connect the resulting traction motion developed by tractor body to this port.</p>
149162
<p>Ports <b>ST</b> , <b>d</b> are the physical signal input ports of the Implement block that represent soil texture and depth of tillage, respectively. Port <b>VF</b> is physical signal output port for vertical force exerted by implement on the tractor. The implement vertical force is positive if acting upwards.</p>
150163
<h2 id="10">Scenario Subsystem</h2>
151164
<p>The Scenario subsystem provides the initial conditions for tire-soil and implement-soil interaction.</p>
152165
<p>
153166
<a href="matlab:open_system('TractorEnergyComputation/Scenaio')">Open Scenario Subsystem</a>
154167
</p>
168+
<pre class="codeinput">open_system(<span class="string">'TractorEnergyComputation/Scenario'</span>);
169+
</pre>
155170
<img vspace="5" hspace="5" src="TractorEnergyComputationModelOverview_07.png" alt=""> <p>The Front Left Tire Parameters, Front Right Tire Parameters, Rear Left Tire Parameters and Rear Right Tire Parameters subsystems consist of parameters such as <b>tykc</b> (soil sinkage cohesion moduli), <b>tykphi</b> (soil sinkage friction moduli), <b>tyn</b> (soil sinkage exponent), <b>tc</b> (cohesion of the terrain), <b>tphi</b> (angle of internal shearing resistance of the terrain), and <b>tk</b> (shear deformation parameter of the terrain). You can specify the soil texture in the Implement-Soil Scenario subsystem if the implement draft force prediction method is based on the empirical relation as per ASABE 497.5 Standard in the Implement block.</p>
156171
<h2 id="12">Driver Controls Subsystem</h2>
157172
<p>The Driver Controls subsystem provides the engine speed, transmission pump displacement commands to the Tractor subsystem.</p>
158173
<p>
159174
<a href="matlab:open_system('TractorEnergyComputation/Driver%20Controls')">Open Driver Controls Subsystem</a>
160175
</p>
176+
<pre class="codeinput">open_system(<span class="string">'TractorEnergyComputation/Driver Controls'</span>);
177+
</pre>
161178
<img vspace="5" hspace="5" src="TractorEnergyComputationModelOverview_08.png" alt=""> <p>You can specify the implement depth command if the implement draft force prediction method is based on the empirical relation as per ASABE 497.5 Standard in the Implement block.</p>
162179
<h2 id="14">Energy Calculations Subsystem</h2>
163180
<p>The Energy Calculations subsystem computes the energy consumed by the various components of the transmission.</p>
164181
<p>
165182
<a href="matlab:open_system('TractorEnergyComputation/System%20Signals%20and%20Information/Power%20and%20Energy%20Calculations')">Open Energy Calculations Subsystem</a>
166183
</p>
184+
<pre class="codeinput">open_system(<span class="string">'TractorEnergyComputation/System Signals and Information/Power and Energy Calculations'</span>);
185+
</pre>
167186
<img vspace="5" hspace="5" src="TractorEnergyComputationModelOverview_09.png" alt=""> <p>
168187
<a href="matlab:open_system('TractorEnergyComputation/System%20Signals%20and%20Information/Power%20and%20Energy%20Calculations/Pump%20Computation/Pump%20Input%20Energy%20Computation')">Open Transmission Pump Input Energy Computation Subsystem</a>
169188
</p>
189+
<pre class="codeinput">open_system(<span class="string">'TractorEnergyComputation/System Signals and Information/Power and Energy Calculations/Pump Computation/Pump Input Energy Computation'</span>);
190+
</pre>
170191
<img vspace="5" hspace="5" src="TractorEnergyComputationModelOverview_10.png" alt=""> <p>You can compute the transmission pump input energy as a product of the engine speed and engine torque.</p>
171192
<p>
172193
<a href="matlab:open_system('TractorEnergyComputation/System%20Signals%20and%20Information/Power%20and%20Energy%20Calculations/Pump%20Computation/Pump%20Output%20Energy%20Computation')">Open Transmission Pump Output Energy Computation Subsystem</a>
173194
</p>
195+
<pre class="codeinput">open_system(<span class="string">'TractorEnergyComputation/System Signals and Information/Power and Energy Calculations/Pump Computation/Pump Output Energy Computation'</span>);
196+
</pre>
174197
<img vspace="5" hspace="5" src="TractorEnergyComputationModelOverview_11.png" alt=""> <p>You can compute the transmission pump output energy as a product of the pump volumetric flow rate and the pressure difference across the pump.</p>
175198
<h2 id="18">Transmission Energy Chart Dashboard</h2>
176199
<p>
177200
<a href="matlab:open_system('TractorEnergyComputation/Transmission%20Energy%20Chart%20Dashboard')">Open Transmission Energy Chart Dashboard Subsystem</a>
178201
</p>
202+
<pre class="codeinput">open_system(<span class="string">'TractorEnergyComputation/Transmission Energy Chart Dashboard'</span>);
203+
</pre>
179204
<img vspace="5" hspace="5" src="TractorEnergyComputationModelOverview_12.png" alt=""> <p>You can visualize the energy flow in the transmission by looking inside the Transmission Energy Chart Dashboard subsystem. Values in blue rectangles represent energy states for various components in a forward gear and values in yellow rectangles represent energy states for the same components in the reverse gear.</p>
180205
<h2 id="20">Useful Links</h2>
181206
<div>
@@ -189,7 +214,7 @@ <h2 id="20">Useful Links</h2>
189214
</ul>
190215
</div>
191216
<p class="footer">Copyright 2024 The MathWorks, Inc.<br>
192-
<a href="https://www.mathworks.com/products/matlab/">Published with MATLAB&reg; R2024a</a>
217+
<a href="https://www.mathworks.com/products/matlab/">Published with MATLAB&reg; R2025a</a>
193218
<br>
194219
</p>
195220
</div>
187 Bytes
Loading
15.6 KB
Loading
22 KB
Loading
15.7 KB
Loading

0 commit comments

Comments
 (0)