Skip to content

Commit 5e1189c

Browse files
committed
updated tutorials for clarity and removed unusable ones (may be brought back later)
1 parent bc8173f commit 5e1189c

8 files changed

+191
-518
lines changed

_posts/2015-06-14-Boeing_737-800.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -18,11 +18,11 @@ This tutorial shows how the user can setup a conventional configuration aircraft
1818

1919
### Steps to simulate the aircraft's performance over a mission :
2020

21-
1) Locate the tutorial script folder, /Tutorials, from your project folder as described in the Download guide. If using the command line, cd to this directory.
21+
1) Locate the folder where you have the tutorial repository. If using the command line, cd to this directory.
2222

2323
2) Open the tut_mission_B737.py script in your favorite editor or IDE. The script is setup to run the B737 on its design mission. Run it in your IDE. If using the command line use the command
2424

25-
<pre><code class="python"> $python tut_mission_B737_800.py </code></pre>
25+
<pre><code class="python"> python tut_mission_B737_800.py </code></pre>
2626

2727
3) A few plots depicting the variation of the different aircraft performance parameters over the course of the mission are shown.
2828

_posts/2015-06-15-Lithium_Air_Regional_Jet_Sizing.md

-65
This file was deleted.

_posts/2015-06-15-Turbofan_Network.md

+8-9
Original file line numberDiff line numberDiff line change
@@ -14,12 +14,12 @@ permalink: /guides/turbofan_network.html
1414

1515
## Turbofan Modeling Tutorial
1616

17-
The tutorial describes how the energy network in SUAVE can be used to build a model of a turbofan engine. Once this is clear to the user, then the understanding the setup of the other gasturbine models, the ducted fan and the turbojet should not be very difficult. The turbofan model is built using the different turbofan components as its building blocks and then linking the inputs and outputs of the different components. The script to follow is the tut_mission_B737.py script that was used in the [Boeing 737-800 Analysis Tutorial](/guides/boeing_737-800.html)
17+
This tutorial describes how the energy network framework in SUAVE can be used to build a model of a turbofan engine. Once this is clear to the user, understanding the setup of the other gasturbine models, the ducted fan and the turbojet will be much easier. The turbofan model is built with several turbofan components as its building blocks. These are then linked together through their inputs and outputs. The script to follow is the tut_mission_B737.py script that was used in the [Boeing 737-800 Analysis Tutorial](/guides/boeing_737-800.html)
1818

1919

2020
### Setting up the Turbofan model
2121

22-
First the turbofan energy energy network is instantiated. The parameters associated with the network as a whole are assigned.
22+
First the turbofan energy network is instantiated. The parameters associated with the network as a whole are assigned.
2323

2424
<pre><code class="python"># ------------------------------------------------------------------
2525
# Turbofan Network
@@ -42,14 +42,14 @@ turbofan.working_fluid = SUAVE.Attributes.Gases.Air()
4242
Then the different components are added
4343

4444

45-
### Components :
45+
### Components
4646

4747
The basic components used to model the turbofan are described below.
4848

4949

5050
#### Ram
5151

52-
The 'Ram' component is used to convert the freestream quantities that are passed into the Turbofan network into stagnation quantities. As the turbofan network is based on a 1D gasdynamic analysis, most of the energy transfer across the different components are modelled as changes in the stagnation quantities. Thus the Ram component acts as a preprocessor converting the input 'Conditions' into quantities required by the network.
52+
The 'Ram' component is used to convert the freestream quantities that are passed into the turbofan network into stagnation quantities. As the turbofan network is based on a 1D gasdynamic analysis, most of the energy transfer across the different components are modelled as changes in the stagnation quantities. Thus the Ram component acts as a preprocessor converting the input conditions into quantities required by the network.
5353

5454
<pre><code class="python"># ------------------------------------------------------------------
5555
# Component 1 - Ram
@@ -66,7 +66,7 @@ turbofan.append(ram)
6666

6767
#### Nozzle
6868

69-
The 'Nozzle' component is used to model the inlet diffuser and the outlet fan and compressor nozzles as shown below.
69+
The 'Nozzle' component is used to model the inlet diffuser, the outlet fan, and the compressor nozzles as shown below.
7070

7171

7272
<pre><code class="python"># ------------------------------------------------------------------
@@ -147,7 +147,7 @@ turbofan.append(compressor)
147147

148148
#### Fan
149149

150-
A fan component is also added to the network. To model turbojets, the fan component and the fan nozzle are not added but all the other components remain the same.
150+
A fan component is also added to the network. If you were to model a turbojet, the fan component and the fan nozzle would not be added but all the other components would remain the same.
151151

152152
<pre><code class="python"># ------------------------------------------------------------------
153153
# Component 10 - Fan
@@ -167,7 +167,7 @@ turbofan.append(fan)
167167

168168
#### Combustor
169169

170-
The combustor component is where the the fuel to air ratio is computed and this is used to compute the sfc and the thrust later in the network.
170+
The combustor component is where the the fuel to air ratio is computed. It is also used to compute the sfc and the thrust later in the network.
171171

172172
<pre><code class="python"># ------------------------------------------------------------------
173173
# Component 7 - Combustor
@@ -178,7 +178,6 @@ combustor.tag = 'combustor'
178178

179179
# setup
180180
combustor.efficiency = 0.99
181-
combustor.alphac = 1.0
182181
combustor.turbine_inlet_temperature = 1450
183182
combustor.pressure_ratio = 0.95
184183
combustor.fuel_data = SUAVE.Attributes.Propellants.Jet_A()
@@ -246,7 +245,7 @@ turbofan.thrust = thrust
246245

247246
### Sizing the Turbofan
248247

249-
Once the network is built, it is essential to size the engine with a set of sizing conditions. The sizing function 'turbofan_sizing' takes in the model of the turbofan and the mach number and the altitude for which the turbofan is sized. The sizing thrust is an engine/network property (defined in the 'Setting up the Turbofan model' section above. The function takes these quantities and computes the design mass flow rate through the components. Once sized, the network/engine can be added to the vehicle as shown in the B737 tutorial.
248+
Once the network is built, it is essential to size the engine with a set of sizing conditions. The sizing function 'turbofan_sizing' takes in the model of the turbofan and the mach number and the altitude for which the turbofan is sized. The sizing thrust is an engine/network property (defined in the 'Setting up the Turbofan model' section above). The function takes these quantities and computes the design mass flow rate through the components. Once sized, the network/engine can be added to the vehicle as shown in the B737 tutorial.
250249

251250
<pre><code class="python">#bypass ratio closer to fan
252251

_posts/2015-06-17-Payload_Range_Diagram.md

+10-15
Original file line numberDiff line numberDiff line change
@@ -9,18 +9,18 @@ permalink: /guides/payload_range_diagram.html
99
---
1010

1111
### Embraer E-190 Payload Range Diagram Tutorial
12-
1) Locate the tutorial script folder. If necessary cd to this directory.
12+
1) Locate the tutorial script folder.
1313

1414
2) Open the test_payload_range.py script in your favorite editor or IDE.
1515

16-
3) Similar to the B737-800 Tutorial, the setup is divided into steps, but in this case the setup is imported from other script (test_mission_Embraer_E190_constThr).
16+
3) Similar to the B737-800 Tutorial, the setup is divided into steps.
1717

1818
4) For the Payload Range Diagram, besides the vehicle and mission, the user must provide the following inputs:
1919

20-
* **cruise_segment_tag**: You must inform the tag of the segment that will have the length modified in order to comply with required fuel burn for each one of the payload range diagram points.
20+
* **cruise_segment_tag**: You must enter the tag of the segment which will have its length modified in order to comply with required fuel burn for each one of the payload range diagram points.
2121
* **reserves**: This will be considered as a fixed fuel reserve for all the diagram points.
2222

23-
5) The tutorial presents the following definition (line 36):
23+
5) The tutorial presents the following definition:
2424

2525
~~~
2626
# run payload diagram
@@ -29,21 +29,16 @@ reserves = 1750.
2929
payload_range_results = payload_range(vehicle,mission,cruise_segment_tag,reserves)
3030
~~~
3131

32-
6) First, let's just run it as it is for now. Run the script in either the IDE or in a terminal:
32+
6) First, let's just run it as it is for now. Run the script in either the IDE or in a terminal as `python tut_payload_range.py`
3333

34-
~~~
35-
$python tut_payload_range.py
36-
~~~
37-
38-
7) After all the calculation the payload diagram will be ploted, and the data will be stored in a file named 'PayloadRangeDiagram.dat', in the folder where you run the script.
34+
7) After the calculations are completed, the payload diagram will be plotted and the data will be stored in a file named 'PayloadRangeDiagram.dat'. This is in the folder where you run the script.
3935

40-
8) You can try to modify vehicle and/or mission parameters, e see how the payload range diagram is affected. For now, let's add some drag counts to the airplane:
36+
8) You can try to modify vehicle and/or mission parameters and see how the payload range diagram is affected. For now, let's add some drag counts to the airplane:
4137

4238
* Locate and open the script test_mission_Embraer_E190_constThr.py, in the tutorial folder (this is the script that contains the vehicle and mission setups)
43-
* Locate ``` base_analysis() ``` and then the Aerodynamics Analysis text block (line 144)
44-
* Add 50 drag counts to the vehicle (line 132): <br>
45-
`aerodynamics.settings.drag_coefficient_increment = 0.0050 `
39+
* Locate ``` base_analysis() ``` and then the Aerodynamics Analysis text block (line 113)
40+
* Add 50 drag counts to the vehicle (line 115): `aerodynamics.settings.drag_coefficient_increment = 0.0050 `
4641
* Rerun the script as before and notice the changes in the results.
4742

48-
9) Similarly the mission parameters can be changed. Again, let's the user decide what changes they want to explore.
43+
9) Similarly the mission parameters can be changed. Again, this lets the user decide what changes they want to explore.
4944

0 commit comments

Comments
 (0)