SU2 DOE Tutorial

This tutorial will introduce you to setting up a SU2 DOE job on Rescale. Using the Rescale DOE functionality, we can characterize the performance of the airfoil under a range of angles of attack in a single job.

This example performs a inviscid, transonic, angle of attack sweep on a NACA 0012 airfoil. The job is configured on the Parallel Settings page to step through angle of attacks from -4° to +15° in 1° increments. The DOE job type will create and run 20 different cases by modifying the template input file used on the Templates page. This job is configured to use two slots, each with two cores, so four total cores are being used during the job. Each case will be run in an available two-core slot until all the cases in the DOE are completed.

Click on the Import Job Files button below to access the job files for this tutorial

Import Job Setup Get Job Results

  • Click on +New Job to start a new job. Name the job appropriately
  • Change the Job Type to DOE

Upload Files

  • On the pop window, click Yes to confirm the Job Type as DOE. Now, the workflow Diagram changes from Job Type to DOE

Confirm DOE

  • Upload the mesh_NACA0012_inv.su2 file as an input file
  • Click on Next

Upload Files

The Parallel Settings stage is where the parameter space for your DOE is defined. In this tutorial, the variable, angle of Attack (AoA) for the airfoil is defined here.

  • Check the box for Specify your variables here

  • Under Select a Variable Type, select the radio button for Cross Product. Selecting Cross Product allows you to create multiple variables in a specified domain (with a specified increment). The platform then automatically performs runs for every combination of the variables. Selecting Monte Carlo you can specify variables to sampled from a variety of probability distributions. The platform again automatically performs runs for every combination of the variables. For this tutorial, however, we will continue with the specified variable option

  • Create a variable, AoA with a Min Value of -4, Max Value of 15 and an Increment of 1. This will create 20 child runs, each with an AoA varying from -4 to 15

  • Click on Add. The variable AoA is added to the DOE

  • Click on Next

    Parallel Settings

Alternatively, you can specify the variables in a angle.csv file which would look like:


For simulation codes requiring fixed width input, or input in a specific notation, using the comma separated variable (CSV) file input option will ensure each value is substituted into your populated input file in exactly the form required.

Template files for DOE jobs are simulation input files in which the values of parameters have been replaced with string references to those parameters. These string references are substituted with the actual parameter values at runtime. The populated template file can be given a modified file name to be passed to the analysis executable.

  • Use the Choose File button to upload the file, NACA0012_template.cfg and edit the processed file name to be NACA0012.cfg as shown below.

  • Click on Next

    Upload Template

    Rename Template

For each run, a unique input file named NACA0012.cfg is created from the template and values substituted for the parameter AoA. The AoA specified in NACA0012_template.cfg is:

AOA= ${AoA}

In each of the child runs, in NACA0012.cfg, these values will be replaced with the reference value. In this tutorial, the first chil run will have:

AOA= -4.0
  • Under Software Settings, search for the software. Select SU2

    Select Software

  • Select the version as 7.0.5

  • The command should be autofilled

  • Change the input file name from <config-file> to NACA0012.cfg (as in the templates section)

  • Click on Next

Select Version

The hardware settings allow you to decide how many simultaneous runs of your analysis will take place. For software that can take advantage of multiple cores, e.g. MPI codes, you can increase the value of Cores / slot to dedicate more cores to each DOE task. If you selected 3 task slots, three simultaneous runs would take place.

  • Under Hardware Settings, select the desired hardware and specify the number of Slots and Cores. In this case, we can select Number of Cores per Slot of 2 and the Number of Task Slots as 2

Hardware Settings

Post Processing

Move to Post Processing section to include a python script, Enter the command as shown below to post process results sorted in tabular format for CL, CD and CMz, corresponding to each run and AoA, displayed under Results.

Hardware Settings

Save the job and move to the Review section. The job is now ready to be run by clicking on the blue button labeled Submit.

  • Click Submit

When running a DOE Job Type, the Status page will allow users to monitor their runtime files for multiple cases running concurrently using Rescale's Live Tailing feature. In this case, since Task Slots equals 2, two child runs are active at a time.

In the screenshot below, run 5 and 10 of the DOE are executing.

Hardware Settings

When all of the runs have completed the Status page should look like the one shown below. The Job Logs indicate the status of each child run.

Hardware Settings

The Results page allows you to examine the duration of each run defined in the job, download a zip archive consisting of run files for every case (when complete), download a zip archive consisting of run files for an individual case, or inspect an individual run more closely.

Hardware Settings

The Results page for Run 14 is highlighted below.

Hardware Settings