Skip to content

Commit dbd3867

Browse files
chapman178chapman178
committed
Help files v1.1.3.40
Updated all help files to be more helpful. Made several small bug fixes. 1) Changed enthalpy to entropy in the SS_plot function. 2) updated output dx value in the 1D-heatXfer blocks, CN and FDI.
1 parent ef51887 commit dbd3867

File tree

97 files changed

+14324
-2451
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

97 files changed

+14324
-2451
lines changed

‎Trunk/BlockGuide.html‎

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,9 +50,12 @@ <h2> Table of Contents</h2>
5050
<ol>
5151
Preface<br>
5252
General Modeling Concepts
53-
<br><a href="TMATS_Library/TMATS_Support/Tools_TMATS.html">T-MATS Simulink Tools</a>
53+
<br><a href="TMATS_Tools/Tools_TMATS.html">T-MATS Simulink Tools</a>
5454
<br><a href="TMATS_Library/TMATS_Support/FunM_TMATS.html">T-MATS MATLAB functions</a>
55-
<br><a href="TMATS_Library/TMATS_Support/FunM_TMATSC.html">T-MATS_Cantera MATLAB functions</a>
55+
<br><a href="TMATS_Library/TMATS_Support/FunM_TMATSC.html">T-MATS Cantera MATLAB functions</a>
56+
<br><a href="TMATS_Tools/GasTableBuilder/GasTableBuilder_TMATS.html">T-MATS Cantera Gas Table Builder</a></li>
57+
<br><a href="TMATS_Library/TMATS_Support/colorguide_TMATS.html">T-MATS Color Guide</a></li>
58+
<br><a href="TMATS_Library/TMATS_Support/nomenclature_TMATS.html">T-MATS Nomenclature</a></li>
5659
<h3>T-MATS Simulink Block Sets</h3>
5760
<li> Effectors and Controls Blocks
5861
<ol>
@@ -94,6 +97,7 @@ <h3>T-MATS Simulink Block Sets</h3>
9497
<li><a href="TMATS_Library/TMATS_Support/Solver_TMATS_Linearize.html">Linearize</a></li>
9598
<li><a href="TMATS_Library/TMATS_Support/Solver_TMATS_MS.html">Model source</a></li>
9699
<li><a href="TMATS_Library/TMATS_Support/Solver_TMATS_NEr.html">Normalized Error</a></li>
100+
<li><a href="TMATS_Library/TMATS_Support/Solver_TMATS_OLI.html">Outerloop integrator</a></li>
97101
<li><a href="TMATS_Library/TMATS_Support/Solver_TMATS_PR.html">Parameter ramp</a></li>
98102
<li><a href="TMATS_Library/TMATS_Support/Solver_TMATS_PS.html">Parameter step</a></li>
99103
<li><a href="TMATS_Library/TMATS_Support/Solver_TMATS_PWLinearize.html">Piecewise linear model generator</a></li>
@@ -132,14 +136,17 @@ <h3>T-MATS Simulink Block Sets</h3>
132136
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_CmpVG.html">CompressorVG</a></li>
133137
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_Dct.html">Duct</a></li>
134138
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_FPC.html">Flow path characteristics</a></li>
139+
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_GBox.html"> Gearbox </a></li>
135140
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_HtXferEff.html">Heat exchanger (NTU method)</a></li>
136141
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_HeatSoak.html">Heat soak(Lump)</a></li>
137142
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_Inlet.html">Inlet</a></li>
138143
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_Mix.html">Mixer</a></li>
139144
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_Noz.html">Nozzle</a></li>
140145
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_NozVar.html">Variable area nozzle</a></li>
146+
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_PGen.html"> Power Generator </a></li>
141147
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_SFC.html">Specific fuel consumption (SFC) calculator</a></li>
142148
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_Shft.html">Shaft</a></li>
149+
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_Splt.html">Splitter</a></li>
143150
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_StCalc.html">Static parameter calculator</a></li>
144151
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_Trb.html">Turbine</a></li>
145152
<li><a href="TMATS_Library/TMATS_Support/Turbo_TMATS_TrbNPSS.html">Turbine NPSS maps</a></li>

‎Trunk/Install_TMATS.m‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@ function Install_TMATS()
33

44
% TMATSver and date must remain in the listed form for the ver command to work
55
% properly.
6-
TMATSver = '1.1.3.39';
7-
TMATSdate = 'Aug-28-2017';
6+
TMATSver = '1.1.3.40';
7+
TMATSdate = 'Sept-19-2017';
88

99
error = 0;
1010
TMATSInstallmsg = 'Install T-MATS matlab toolbox? Note: Installation will add MATLAB paths and generate MEX files.';

‎Trunk/TMATS_Library/Lib_Cntrl_FirstOrderSensor_TMATS.slx‎

17 Bytes
Binary file not shown.

‎Trunk/TMATS_Library/Lib_HeatXfer_1DtransconductionCN_TMATS.slx‎

9 Bytes
Binary file not shown.

‎Trunk/TMATS_Library/Lib_HeatXfer_1DtransconductionFDI_TMATS.slx‎

14 Bytes
Binary file not shown.

‎Trunk/TMATS_Library/MATLAB_Scripts/+TMATS/SSplot.m‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -169,7 +169,7 @@ function SSplot(filename, StationVarVec, varargin)
169169
hold on
170170
plot([s(1),s(end)],[Tt(1),Tt(end)],'b')
171171
ylabel(sprintf('Temperatures, %cR',char(176)));
172-
xlabel(sprintf('Enthalpy, BTU/(%cR*lbm)',char(176)));
172+
xlabel(sprintf('Entropy, BTU/(%cR*lbm)',char(176)));
173173

174174
end
175175

‎Trunk/TMATS_Library/TMATS_Support/ColorGuide_TMATS.html‎

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
<script type="text/javascript"
2+
src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
3+
</script>
4+
5+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
6+
7+
<head>
8+
<link rel="stylesheet" href="stylesheet_TMATS.css">
9+
</head>
10+
11+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
12+
13+
<title>
14+
T-MATS: Color Guide
15+
</title>
16+
17+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
18+
19+
<body>
20+
<h1>
21+
T-MATS: Color Guide
22+
</h1>
23+
<hr>
24+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
25+
26+
<div class="background">
27+
Background
28+
</div>
29+
30+
<p>
31+
To aid in simulation setup, the inputs and outputs of T-MATS blocks are color coded according to the table below.
32+
</p>
33+
34+
35+
<br><hr><br>
36+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
37+
38+
<div class="table_caption">
39+
Color Guide
40+
</div>
41+
42+
<table>
43+
<tr><th> Color </th><th >Description</th></tr>
44+
<tr><td><font color="blue"> Blue </font></td><td>Gas path information containing flow, enthalpy, total temperature, total pressure, and flow composition (typically fuel to air ratio (FAR))</td></tr>
45+
<tr><td> <font color="darkgreen"> Dark Green </font> </td><td>Independent variable</td></tr>
46+
<tr><td> <font color="limegreen"> Green </font></td><td>Dependent variable</td></tr>
47+
<tr><td> <font color="red"> Red </font></td><td>Independent variable that is obtained through integration in a dynamic simulation, but may be solved for by the solver in a steady state simulation (e.g. shaft speed)</td></tr>
48+
<tr><td> <font color="magenta"> Magenta </font></td><td>Dependent variable that is integrated in a dynamic simulation, but may be used as a dependent variable in the iterative solver in the steady state simulation (e.g. Ndot)</td></tr>
49+
<tr><td> <font color="lightpink"> Pink </font></td><td>Contributor to the calculation of a dependent variable (e.g. torque)</td></tr>
50+
<tr><td> <font color="orange"> Yellow </font></td><td>Effector command (e.g. fuel flow), not typically used by the solver</td></tr>
51+
</table>
52+
53+
54+
<br><br>
55+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
56+
</body>

‎Trunk/TMATS_Library/TMATS_Support/Control_TMATS_1OA.html‎

Lines changed: 120 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -2,31 +2,133 @@
22
src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
33
</script>
44

5-
<font size="6" color="Magenta">T-MATS: 1st Order Actuator Library Block</font>
6-
<p>This block models a generic actuator with a first order lag.</p>
7-
$$
8-
\frac {Y(s)}{X(s)} = \frac {Gain}{\tau s+1}
9-
$$
10-
<p>Additionally nonlinearities have been included to allow for actuator deadbands, rate limits
11-
and saturation points. Deadbands are used to simulate the mechanical play in the system. Rate limits can be
12-
set to simulate physical movement limitations of the actuator. </p>
13-
<font size="5" color="Blue">1-O Actuator Inputs:</font>
14-
<table border="1"> <tr><td>1-O Actuator Input</td><td>Description</td></tr>
5+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
6+
7+
<head>
8+
<link rel="stylesheet" href="stylesheet_TMATS.css">
9+
</head>
10+
11+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
12+
13+
<title>
14+
T-MATS: Help for 1st Order Actuator Library Block
15+
</title>
16+
17+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
18+
19+
<body>
20+
<h1>
21+
T-MATS: 1st Order Actuator Library Block
22+
</h1>
23+
<hr>
24+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
25+
26+
<div class="purpose">
27+
Purpose
28+
</div>
29+
30+
<p>
31+
This block can be used to model a generic actuator with a first order lag.
32+
</p>
33+
34+
35+
<br>
36+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
37+
38+
<div class="background">
39+
Background
40+
</div>
41+
42+
<p>
43+
A standard form of the first order differential equation used is as follows:
44+
45+
$$ \tau * \frac{dy}{dt} + y = k*x(t) $$
46+
47+
in which <i>k</i> is the gain and \( \tau \) is the time constant for the system.
48+
The laplace transform of the above equation is more commonly used and is as follows:
49+
50+
$$ \frac{Y(s)}{X(s)} = \frac{k}{\tau*s+1}$$
51+
52+
<p>
53+
This block operates by multiplying the initial input by the gain, dividing it by the
54+
time constant, and then integrating the result with respect to time to solve the above equation. Feedback is also
55+
utilized, as the result of the integration is divided by the time constant
56+
and then passed back to the start of the loop.
57+
</p>
58+
<p>
59+
During the second iteration (and those afterwards), the input value is again multiplied by the
60+
gain and divided by the time constant, but before being integrated, the previously determined result
61+
is subtracted from the new value, and the result is integrated. This process repeats as many times as necessary.
62+
<br>
63+
<p>
64+
In addition to the above, nonlinearities have been included to allow for actuator deadbands, rate limits,
65+
and saturation points. Deadbands are used to simulate the mechanical play in the system. Rate limits can be
66+
set to simulate physical movement limitations of the actuator. The saturation points are used to impose upper
67+
and lower limits on the output signal. More information on these attributes can be found in the MATLAB documentation
68+
for the backlash, rate limiter, and saturation blocks, respectively.
69+
70+
</p>
71+
72+
<br>
73+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
74+
75+
<div class="instructions">
76+
Instructions
77+
</div>
78+
79+
<p>
80+
To use this block, the user must specifiy the gain (Gain_M), the time constant (Tau_M),
81+
and the initial conditions (IC_M) by double clicking the block. If the user wishes to utilize the nonlinearities,
82+
the user must also specify the saturation points, deadband, or rate limit depending on which options they are using.
83+
<ul>
84+
<li> Connect the input (command) and output (actual) values to the corresponding places on the block.
85+
<li> Double click the block and specify the gain, time constant, and initial conditions.
86+
<li> Double click the block and specify the saturation points, deadband, and/or rate limit to use the nonlinearities.
87+
</ul>
88+
</p>
89+
90+
<br><hr><br>
91+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
92+
93+
<div class="inputs">
94+
1st Order Actuator Inputs
95+
</div>
96+
97+
<table>
98+
<tr><th> Input </th><th >Description</th></tr>
1599
<tr><td>Command</td><td>Control commanded value (X)</td></tr>
16100
</table>
17-
<br>
18-
<font size="5" color="Blue">1-O Actuator Outputs:</font>
19-
<table border="1"> <tr><td>1-O Actuator Output</td><td>Description</td></tr>
101+
102+
<br><br>
103+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
104+
105+
<div class="outputs">
106+
1st Order Actuator Outputs
107+
</div>
108+
109+
<table>
110+
<tr><th> Output </th><th> Description </th></tr>
20111
<tr><td>Actual</td><td>Actual value (Y)</td></tr>
21112
</table>
22-
<br>
23-
<font size="5" color="Blue">1-O Actuator Mask Variables: </font>
24-
<table border="1"> <tr><td>1-O Actuator Mask Variable</td><td>Description</td></tr>
113+
114+
<br><br>
115+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
116+
117+
<div class="maskvars">
118+
1st Order Actuator Mask Variables
119+
</div>
120+
121+
<table>
122+
<tr><th> Mask Variable </th><th> Description </th></tr>
25123
<tr><td>Gain_M</td><td>Actuator gain</td></tr>
26-
<tr><td>Tau_M</td><td>Actuator time constant(\( \tau \))</td></tr>
124+
<tr><td>Tau_M</td><td>Actuator time constant (\( \tau \))</td></tr>
27125
<tr><td>IC_M</td><td>Actuator initial condition </td></tr>
28126
<tr><td>MaxSat_M</td><td>Actuator Max saturation point</td></tr>
29127
<tr><td>MinSat_M</td><td>Actuator Min saturation point</td></tr>
30128
<tr><td>deadband_M</td><td>Acturator deadband</td></tr>
31129
<tr><td>rateLimit_M</td><td>Acturator rate limit</td></tr>
32-
</table>
130+
</table>
131+
132+
<br><br>
133+
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
134+
</body>

0 commit comments

Comments
 (0)