Skip to content

Commit 1281867

Browse files
authored
Merge pull request #40 from su2code/move_tutorials
Move tutorials
2 parents 6dd1b02 + 2309eb5 commit 1281867

File tree

197 files changed

+149
-144
lines changed

Some content is hidden

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

197 files changed

+149
-144
lines changed
-6 KB
Binary file not shown.

_docs_v7/Build-SU2-Linux-MacOS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ permalink: /docs_v7/Build-SU2-Linux-MacOS/
44
redirect_from: /docs/Build-SU2-From-Source/
55
---
66

7-
For information on how to build older versions of SU2, have a look [here](/docs_v7/Build-from-Source/).
7+
For information on how to build older versions of SU2, have a look [here](/docs/Build-from-Source/).
88

99
Note that the following guide works only on Linux/MacOS and on Windows using Cygwin or the [Linux Subsystem](https://docs.microsoft.com/en-us/windows/wsl/install-win10).
1010

_tutorials/compressible_flow/Inviscid_Bump.md renamed to _tutorials/compressible_flow/Inviscid_Bump/Inviscid_Bump.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ complexity: basic
1212
follows:
1313
---
1414

15-
![Channel Mach](../../Inviscid_Bump/images/channel_mach.png)
15+
![Channel Mach](../../tutorials_files/compressible_flow/Inviscid_Bump/images/channel_mach.png)
1616

1717
## Goals
1818

@@ -52,7 +52,7 @@ There is also a set of inlet/outlet conditions for transonic flow available in t
5252

5353
The channel is of length 3L with a height L and a circular bump centered along the lower wall with height 0.1L. For the SU2 mesh, L = 1.0 was chosen, as seen in the figure of the mesh below. The mesh is composed of quadrilaterals with 256 nodes along the length of the channel and 128 nodes along the height. The following figure contains a view of the mesh topology (a coarser mesh is shown for clarity).
5454

55-
![Channel Mesh](../../Inviscid_Bump/images/channel_mesh_bcs.png)
55+
![Channel Mesh](../../tutorials_files/compressible_flow/Inviscid_Bump/images/channel_mesh_bcs.png)
5656
Figure (1): The computational mesh with boundary conditions highlighted.
5757

5858
The boundary conditions for the channel are also highlighted in the figure. Inlet, outlet, and Euler wall boundary conditions are used. The Euler wall boundary condition enforces flow tangency at the upper and lower walls.
@@ -152,8 +152,8 @@ The channel simulation for the 256x128 node mesh is relatively small, so this ca
152152
153153
The following images show some SU2 results for the inviscid channel problem.
154154
155-
![Channel Mach](../../Inviscid_Bump/images/channel_mach.png)
155+
![Channel Mach](../../tutorials_files/compressible_flow/Inviscid_Bump/images/channel_mach.png)
156156
Figure (2): Mach number contours for the 2D channel.
157157
158-
![Channel Pressure](../../Inviscid_Bump/images/channel_pressure.png)
158+
![Channel Pressure](../../tutorials_files/compressible_flow/Inviscid_Bump/images/channel_pressure.png)
159159
Figure (3): Pressure contours for the 2D channel.

_tutorials/compressible_flow/Inviscid_ONERAM6.md renamed to _tutorials/compressible_flow/Inviscid_ONERAM6/Inviscid_ONERAM6.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ complexity: basic
1212
follows:
1313
---
1414

15-
![ONERA M6 Cp](../../Inviscid_ONERAM6/images/oneram6_cp.png)
15+
![ONERA M6 Cp](../../tutorials_files/compressible_flow/Inviscid_ONERAM6/images/oneram6_cp.png)
1616

1717
## Goals
1818

@@ -52,10 +52,10 @@ These transonic flow conditions will cause the typical "lambda" shock along the
5252

5353
The computational domain is a large parallelepiped with the wing half-span mounted on one boundary in the x-z plane. The mesh consists of 582,752 tetrahedral elements and 108,396 nodes. Three boundary conditions are employed: Euler wall on the wing surface, a far-field characteristic-based condition on the far-field markers, and a symmetry boundary condition for the marker where the wing half-span is attached. The symmetry condition acts to mirror the flow about the x-z plane, reducing the complexity of the mesh and the computational cost. Images of the entire domain and the triangular elements on the wing surface are shown below.
5454

55-
![ONERA M6 Mesh](../../Inviscid_ONERAM6/images/oneram6_mesh_bcs.png)
55+
![ONERA M6 Mesh](../../tutorials_files/compressible_flow/Inviscid_ONERAM6/images/oneram6_mesh_bcs.png)
5656
Figure (1): Far-field view of the computational mesh with boundary conditions.
5757

58-
![ONERA M6 Surface Mesh](../../Inviscid_ONERAM6/images/oneram6_wing_mesh.png)
58+
![ONERA M6 Surface Mesh](../../tutorials_files/compressible_flow/Inviscid_ONERAM6/images/oneram6_wing_mesh.png)
5959
Figure (2): Close-up view of the unstructured mesh on the top surface of the ONERA M6 wing.
6060

6161
### Configuration File Options
@@ -189,14 +189,14 @@ If SU2 has been built with parallel support, the recommended method for running
189189
190190
Results are here given for the SU2 solution of inviscid flow over the ONERA M6 wing.
191191
192-
![ONERA M6 Cp](../../Inviscid_ONERAM6/images/oneram6_cp.png)
192+
![ONERA M6 Cp](../../tutorials_files/compressible_flow/Inviscid_ONERAM6/images/oneram6_cp.png)
193193
Figure (3): Cp contours on the upper surface of the ONERA M6.
194194
195-
![ONERA M6 Mach](../../Inviscid_ONERAM6/images/oneram6_mach.png)
195+
![ONERA M6 Mach](../../tutorials_files/compressible_flow/Inviscid_ONERAM6/images/oneram6_mach.png)
196196
Figure (4): Mach number contours on the upper surface of the ONERA M6 wing. Notice the "lambda" shock pattern typically seen on the upper surface.
197197
198-
![ONERA M6 Coefficients](../../Inviscid_ONERAM6/images/oneram6_coefficients.png)
198+
![ONERA M6 Coefficients](../../tutorials_files/compressible_flow/Inviscid_ONERAM6/images/oneram6_coefficients.png)
199199
Figure (5): Convergence of the non-dimensional coefficients.
200200
201-
![ONERA M6 Convergence](../../Inviscid_ONERAM6/images/oneram6_convergence.png)
201+
![ONERA M6 Convergence](../../tutorials_files/compressible_flow/Inviscid_ONERAM6/images/oneram6_convergence.png)
202202
Figure (6): Convergence of the density residual (speed up x20, iteration based).

_tutorials/compressible_flow/Inviscid_Wedge.md renamed to _tutorials/compressible_flow/Inviscid_Wedge/Inviscid_Wedge.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ complexity: basic
1212
follows:
1313
---
1414

15-
![Wedge Mach](../../Inviscid_Wedge/images/wedge_mach.png)
15+
![Wedge Mach](../../tutorials_files/compressible_flow/Inviscid_Wedge/images/wedge_mach.png)
1616

1717
## Goals
1818

@@ -49,7 +49,7 @@ This problem will solve for the flow over the wedge with these conditions:
4949

5050
The wedge mesh is a structured mesh (75x50) of rectangular elements with a total of 3,750 nodes. The upper and lower wall of the geometry are solid (`MARKER_EULER`), and the lower wall has a 10 degree wedge starting at x = 0.5. Figure (1) shows the mesh with the boundary markers and flow conditions highlighted.
5151

52-
![Wedge Mach](../../Inviscid_Wedge/images/wedge_mesh_bcs.png)
52+
![Wedge Mach](../../tutorials_files/compressible_flow/Inviscid_Wedge/images/wedge_mesh_bcs.png)
5353
Figure (1): The computational mesh with boundary conditions highlighted.
5454

5555
For this test case, the inlet marker will be set to a `MARKER_SUPERSONIC_INLET` boundary condition, while the outlet marker will be set to the `MARKER_OUTLET` condition. In supersonic flow, all characteristics are incoming to the domain at the entrance (inlet marker), and therefore, all flow quantities can be specified, i.e., no information travels upstream.
@@ -174,8 +174,8 @@ The wedge simulation is small and will execute quickly on a single workstation o
174174
175175
The following images show some SU2 results for the supersonic wedge problem.
176176
177-
![Wedge Mach](../../Inviscid_Wedge/images/wedge_mach.png)
177+
![Wedge Mach](../../tutorials_files/compressible_flow/Inviscid_Wedge/images/wedge_mach.png)
178178
Figure (2): Mach contours showing the oblique shock for supersonic flow over a wedge.
179179
180-
![Wedge Pressure](../../Inviscid_Wedge/images/wedge_pressure.png)
180+
![Wedge Pressure](../../tutorials_files/compressible_flow/Inviscid_Wedge/images/wedge_pressure.png)
181181
Figure (3): Pressure contours (N/m2) for supersonic flow over a wedge.

_tutorials/compressible_flow/Laminar_Cylinder.md renamed to _tutorials/compressible_flow/Laminar_Cylinder/Laminar_Cylinder.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ complexity: basic
1212
follows:
1313
---
1414

15-
![Cylinder Mach](../../Laminar_Cylinder/images/cylinder_mach.png)
15+
![Cylinder Mach](../../tutorials_files/compressible_flow/Laminar_Cylinder/images/cylinder_mach.png)
1616

1717
## Goals
1818

@@ -53,7 +53,7 @@ This problem will solve the for the external, compressible flow over the cylinde
5353

5454
The problem geometry is 2D. The mesh has 26,192 triangular elements and 13,336 points. It is fine near the surface of the cylinder to resolve the boundary layer. The exterior boundary is approximately 15 diameters away from the cylinder surface to avoid interaction between the boundary conditions. Far-field boundary conditions are used at the outer boundary. No-slip boundary conditions are placed on the surface of the cylinder.
5555

56-
![Cylinder Mesh](../../Laminar_Cylinder/images/cylinder_mesh.png)
56+
![Cylinder Mesh](../../tutorials_files/compressible_flow/Laminar_Cylinder/images/cylinder_mesh.png)
5757
Figure (1): The computational mesh for the 2D cylinder test case.
5858

5959
The outer boundary in red is the far-field, and the small circle in the center is the cylinder which uses the Navier-Stokes Wall boundary condition.
@@ -105,11 +105,11 @@ The cylinder simulation for the 13,336 node mesh is small and will execute relat
105105
106106
The following results show the flow around the cylinder as calculated by SU2 (note that these were for a slightly higher Mach number of 0.3).
107107
108-
![Cylinder Pressure](../../Laminar_Cylinder/images/cylinder_pressure.png)
108+
![Cylinder Pressure](../../tutorials_files/compressible_flow/Laminar_Cylinder/images/cylinder_pressure.png)
109109
Figure (2): Pressure contours around the cylinder.
110110
111-
![Cylinder Viscosity](../../Laminar_Cylinder/images/cylinder_lam_visc.png)
111+
![Cylinder Viscosity](../../tutorials_files/compressible_flow/Laminar_Cylinder/images/cylinder_lam_visc.png)
112112
Figure (3): Laminar viscosity contours for this steady, low Reynolds number flow.
113113
114-
![Cylinder Mach](../../Laminar_Cylinder/images/cylinder_mach.png)
114+
![Cylinder Mach](../../tutorials_files/compressible_flow/Laminar_Cylinder/images/cylinder_mach.png)
115115
Figure (4): Mach number contours around the cylinder with streamlines. Note the large laminar separation region behind the cylinder at Re = 40.

_tutorials/compressible_flow/Laminar_Flat_Plate.md renamed to _tutorials/compressible_flow/Laminar_Flat_Plate/Laminar_Flat_Plate.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ complexity: basic
1212
follows:
1313
---
1414

15-
![Lam Plate Profile](../../Laminar_Flat_Plate/images/lam_plate_velocity_profile.png)
15+
![Lam Plate Profile](../../tutorials_files/compressible_flow/Laminar_Flat_Plate/images/lam_plate_velocity_profile.png)
1616

1717
## Goals
1818

@@ -41,11 +41,11 @@ The following tutorial will walk you through the steps required when solving for
4141

4242
In his PhD dissertation in 1908, H. Blasius obtained what is now referred to as the Blasius equation for incompressible, laminar flow over a flat plate:
4343

44-
![Blasius Equation](../../Laminar_Flat_Plate/images/blasius.png)
44+
![Blasius Equation](../../tutorials_files/compressible_flow/Laminar_Flat_Plate/images/blasius.png)
4545

4646
The third-order, ordinary differential equation can be solved numerically using a shooting method resulting in the well-known laminar boundary layer profile. Using the numerical solution, an expression for the skin friction coefficient along the flat plate can also be derived:
4747

48-
![Blasius Cf](../../Laminar_Flat_Plate/images/blasius_cf.png)
48+
![Blasius Cf](../../tutorials_files/compressible_flow/Laminar_Flat_Plate/images/blasius_cf.png)
4949

5050
where Re_x is the Reynolds number along the plate. In this tutorial, we will perform a solution of nearly incompressible (low Mach number) laminar flow over a flat plate and compare our results against the analytical Blasius solutions for the profile shape and skin friction coefficient along the plate. This problem has become a classic test case for viscous flow solvers. More detail on the Blasius solution and the similarity variables can be found in Chapter 18 of Fundamentals of Aerodynamics (Fourth Edition) by John D. Anderson, Jr. and most other texts on aerodynamics.
5151

@@ -63,7 +63,7 @@ This problem will solve the for the flow over the flat plate with these conditio
6363

6464
The computational mesh for the flat plate is composed of quadrilaterals with 65 nodes in both the x- and y-directions. The flat plate is along the lower boundary of the domain (y = 0) starting at x = 0 m and is of length 0.3048 m (1 ft). In the figure of the mesh, this corresponds to the Navier-Stokes (no-slip) boundary condition highlighted in green. The domain extends a distance upstream of the flat plate, and a symmetry boundary condition is used to simulate a free-stream approaching the plate in this region (highlighted in purple). Axial stretching of the mesh is used to aid in resolving the region near the start of the plate where the no-slip boundary condition begins at x = 0 m, as shown in Figure (1).
6565

66-
![Lam Plate Mesh](../../Laminar_Flat_Plate/images/lam_plate_mesh_bcs.png)
66+
![Lam Plate Mesh](../../tutorials_files/compressible_flow/Laminar_Flat_Plate/images/lam_plate_mesh_bcs.png)
6767
Figure (1): Figure of the computational mesh with boundary conditions.
6868

6969
Because the flow is subsonic and disturbances caused by the presence of the plate can propagate both upstream and downstream, characteristic-based, subsonic inlet and outlet boundary conditions are used for the flow entrance plane (red) and the outflow regions along the upper region of the domain and the exit plane at x = 0.3048 m (blue).
@@ -131,11 +131,11 @@ The flat plate simulation for the 65x65 node mesh is small and will execute rela
131131
132132
Results are given here for the SU2 solution of laminar flow over the flat plate. The results show excellent agreement with the closed-form Blasius solution.
133133
134-
![Lam Plate Mach](../../Laminar_Flat_Plate/images/lam_plate_mach.png)
134+
![Lam Plate Mach](../../tutorials_files/compressible_flow/Laminar_Flat_Plate/images/lam_plate_mach.png)
135135
Figure (2): Mach contours for the laminar flat plate.
136136
137-
![Lam Plate Profile](../../Laminar_Flat_Plate/images/lam_plate_velocity_profile.png)
137+
![Lam Plate Profile](../../tutorials_files/compressible_flow/Laminar_Flat_Plate/images/lam_plate_velocity_profile.png)
138138
Figure (3): Velocity data was extracted from the exit plane of the mesh (x = 0.3048 m) near the wall, and the boundary layer velocity profile was plotted compared to and using the similarity variables from the Blasius solution.
139139
140-
![Lam Plate Cf](../../Laminar_Flat_Plate/images/lam_plate_skin_friction.png)
140+
![Lam Plate Cf](../../tutorials_files/compressible_flow/Laminar_Flat_Plate/images/lam_plate_skin_friction.png)
141141
Figure (4): A plot of the skin friction coefficient along the plate created using the values written in the surface_flow.csv file and compared to Blasius.

_tutorials/compressible_flow/NICFD_nozzle.md renamed to _tutorials/compressible_flow/NICFD_nozzle/NICFD_nozzle.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ complexity: advanced
1212
follows:
1313
---
1414

15-
![NICFD nozzle Mach](../../NICFD_nozzle/images/mach_isolines.png)
15+
![NICFD nozzle Mach](../../tutorials_files/compressible_flow/NICFD_nozzle/images/mach_isolines.png)
1616

1717
## Goals
1818

@@ -60,7 +60,7 @@ In design conditions, the total to exhaust pressure ratio of the nozzle is 3.125
6060

6161
The total length of the nozzle is 0.123 m, with an inlet height of 0.036 m and a throat height of 0.0084 m. The mesh is composed of quadrilateral elements, with 3,540 elements and 3,660 nodes. The figure shows the mesh topology and an indication of the boundary conditions. Characteristic-based Riemann boundary conditions are used on the INFLOW and OUTFLOW boundaries. The Navier-Stokes adiabatic wall condition is imposed on the WALL boundary. The symmetry boundary condition is used at the SYMMETRY boundary. The symmetry condition mirrors the flow about the x axis, thus allowing to reduce the size of the mesh and the computational cost.
6262

63-
![NICFD nozzle mesh](../../NICFD_nozzle/images/mesh.png)
63+
![NICFD nozzle mesh](../../tutorials_files/compressible_flow/NICFD_nozzle/images/mesh.png)
6464
Figure (1): Computational mesh.
6565

6666
### Configuration File Options
@@ -217,8 +217,8 @@ The nozzle simulation is relatively small and will execute quickly on a single w
217217
Results are given here for the SU2 solution of supersonic non-ideal compressible flow in the converging-diverging nozzle. As part of this tutorial, a coarse mesh was provided, but for comparison, results obtained by using a refined mesh (80,223 elements and 80,840 points) as well as experimental results are shown.
218218
The figures below compare pressure and Mach number trends along the nozzle axis obtained from SU2 flow solutions and experimental data. Numerical results agree with the experimental data from the TROVA wind tunnel.
219219

220-
![NICFD nozzle results A](../../NICFD_nozzle/images/nozzle_geometry_schlieren.png)
221-
![NICFD nozzle results B](../../NICFD_nozzle/images/Pressure_SU2_experiments.png)
222-
![NICFD nozzle results C](../../NICFD_nozzle/images/Mach_SU2_experiments.png)
220+
![NICFD nozzle results A](../../tutorials_files/compressible_flow/NICFD_nozzle/images/nozzle_geometry_schlieren.png)
221+
![NICFD nozzle results B](../../tutorials_files/compressible_flow/NICFD_nozzle/images/Pressure_SU2_experiments.png)
222+
![NICFD nozzle results C](../../tutorials_files/compressible_flow/NICFD_nozzle/images/Mach_SU2_experiments.png)
223223

224224
Figure (2): (a) Geometry of the test section and schlieren image of the nozzle flow. (b, c) Comparison Pressure (b) and Mach number (c) profiles of the experimental results of Spinelli *et al* (black dots with error bars) against SU2 computational results for the test case mesh (red lines) and a reference fine mesh (blue lines).

_tutorials/compressible_flow/Transitional_Flat_Plate.md renamed to _tutorials/compressible_flow/Transitional_Flat_Plate/Transitional_Flat_Plate.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ complexity: basic
1212
follows:
1313
---
1414

15-
![lam_to_turb](../../Transitional_Flat_Plate/images/lam_to_turb.png)
15+
![lam_to_turb](../../tutorials_files/compressible_flow/Transitional_Flat_Plate/images/lam_to_turb.png)
1616

1717
## Goals
1818

@@ -48,7 +48,7 @@ The length of the flat plate is 1.5 meters, and it is represented by an adiabati
4848

4949
The mesh used for this tutorial, which consists of 41,412 quadrilaterals, is shown below.
5050

51-
![Flat Plate](../../Transitional_Flat_Plate/images/FlatPMesh.png)
51+
![Flat Plate](../../tutorials_files/compressible_flow/Transitional_Flat_Plate/images/FlatPMesh.png)
5252

5353
Figure (1): Mesh with boundary conditions (red: inlet, blue:outlet, orange:symmetry, green:wall)
5454

@@ -114,15 +114,15 @@ To run this test case, follow these steps at a terminal command line:
114114

115115
The figure below compares the skin friction results obtained by the B-C transition model to the experimental data.
116116

117-
![SK_Cf_Rex](../../Transitional_Flat_Plate/images/Cf_Rex_SK.png)
117+
![SK_Cf_Rex](../../tutorials_files/compressible_flow/Transitional_Flat_Plate/images/Cf_Rex_SK.png)
118118

119119
Figure (2): Comparison of the skin friction coefficients for the Schubauer & Klebanoff case.
120120

121121
## Notes
122122

123123
By changing the freestream velocity and turbulence intensity options in the config file with the values given in the table below, you may also simulate other very popular zero pressure gradient transitional flat plate test cases. You may use the same grid file for these test cases.
124124

125-
![other_cases_table](../../Transitional_Flat_Plate/images/other_transition_cases.png)
125+
![other_cases_table](../../tutorials_files/compressible_flow/Transitional_Flat_Plate/images/other_transition_cases.png)
126126

127127
## References
128128

0 commit comments

Comments
 (0)