Run a Basic FINE™/Turbo Computation

This example shows how to submit a job on the Rescale platform. The simulation software used is FINE™/Turbo from NUMECA, a powerful commercial computational flow dynamics (CFD) simulation code. Please contact us if you're having trouble.

workflow

About this simulation

This example uses the FINE™/Turbo solver to run a 3D steady state simulation of a high pressure centrifugal compressor (HPCC) stage including an impeller with splitters and a vaned diffuser. For more information about the HPCC test case and detailed model setup tutorial, please refer to the NUMECA documentation or contact NUMECA support.

You must zip your FINE™/Turbo project input files. You can assign any name to the zip archive, however all of the following FINE™/Turbo input files are required:

project.zip:

  • ./project_file.iec
  • ./_mesh/mesh_file.igg
  • ./_mesh/mesh_file.bcs
  • ./_mesh/mesh_file.cgns
  • ./_mesh/mesh_file.geom
  • ./_mesh/mesh_file.*

For this example, upload the hpcc_stage.zip archive. Contact Rescale or NUMECA to obtain a copy.

Sign Up and Log In

If you have not done so already, you will need to sign up for a Rescale account. After signing up for a free trial, you will receive a verification email (this can take up to 20 minutes), in which you will find a link to the platform site. Log-in to the platform site and you will be greeted with a welcome screen.

WelcomePage.png

Create New Job

To create a new job, click + New Job on the top-left corner of your screen.

NewJobButton.png

Upload Input files

To run a basic job, the fields highlighted in red below need to be set correctly.

BasicJobSettings_1.png

Proceed as follows:

  1. Edit the job name to one of your choice, here we use Basic Job: HPCC Stage
  2. Check that the Job Type is Basic.
  3. Upload the project archive required for this run. uploading

All necessary input files are inside the compressed hpcc_stage.zip archive. Contact Rescale or NUMECA to obtain a copy.

On completion, the Input Files setup page should look like that shown below. To move on to the next part of the Setup process, click the Next button at the top right of the page or the Software icon.

input files completed

Software Settings

Select FINE™/Turbo by entering "NUMECA" in the textbox search field, shown highlighted in red, and clicking on the FINE™/Turbo icon.

basic job software settings

The next stage of software setup is to choose the version number of the analysis code selected and to specify the Command text field that defines the command line used to run the simulation.

Be sure to select FINE™/Turbo version 10.1 and edit the Command field to read as follows:

fine-turbo -p hpcc_stage.iec -m _mesh/hpcc_mesh1.igg -c 0

The Rescale platform automatically extracts the files from the project archive (hpcc_stage.zip) into your Root folder and prepares the selected computation run files prior to beginning the simulation. It respects the subfolder structure of the zipped archive (please keep in mind while writing the file paths in the job command as shown in this example, the mesh files are inside the subfolder _mesh/).

The screenshot below, with modified fields shows how your Software Settings setup page should look on completion of this step.

command example

For reference, here is the usage of the fine-turbo command syntax:

fine-turbo -p <project_path/name.iec> -m <mesh_path/name.igg> -c <computation_index>

where

  • -p, --project Project path and filename (*.iec) **required**
  • -m, --mesh Mesh files path and name (*.igg) **required**
  • -c, --computation Computation index (integer, zero indexed following same order as _Computations List_ in GUI **required**
  • -n, --no-partition Run job in parallel mode without virtual partitioning (some modules may be incompatible with virtual partitioning, consult FINE™/Turbo documentation) **optional**
  • -d, --double-precision Enable double-precision solver **optional**

License Options

The Rescale Platform allows you to Purchase License at a competitive rate. This tutorial will use the Purchase License option.

purchase license

If you're an existing NUMECA customer, then you may Provide Existing License information. For setting up and using an existing license file please contact Rescale or NUMECA support teams.

Click Next or Hardware Settings to proceed with this tutorial.

Hardware Settings

For a basic FINE™/Turbo job, there are a few hardware settings to edit: Core Types, Number of Cores and Maximum Job Duration.

These choices affect the job cost, please review the Hourly Price Summary section to estimate the job final price.

For this example we'll choose Nickel Core Type at instant rate and allocate a Number of Cores of 32. The job will complete in less than one hour. Please set the Maximum Job Duration to 1 hour.

The following screen shot exemplifies these choices: hardware settings

Click Save and Next to proceed.

Specify a Post Processing Script

You can add a post-processing script to your job as an input file, or utilize Rescale's post-processing functionality by adding a post-processing step to your job setup. In this example, we will demonstrate running a post processing script to generate a visualization from the simulation results.

The post processing step gets run automatically after all analyses jobs finish; this is particularly handy for jobs that generate large amounts of data from multiple nodes.

post processing settings

In the post processing setup page, upload the postproc.py script into the Post-processing Files list, and in the Post-processing command window, enter

cfview101 redirect -batch -macro ./postproc.py > postproc.log

post processing command

Click Save and Next to proceed.

Review and Submit

review and submit The Review page shows a summary of the job prior to submission. If everything is satisfactory, click the Submit button to begin the job.

Status

The Status page allows you to monitor your analysis after the job has been submitted. The job workflow icons, highlighted in red on the right hand side of the page, allow you to navigate between the job Setup, Status, Results and Charts pages.

job status page

Ongoing job stages will show a blue progress bar. Completed steps will show a green progress bar and a check mark. Timing of each job step is listed as well.

The Status page also allows you to view the contents of output files in realtime. This is known as live tailing a file. This can be very useful in monitoring the progress of a job. In this case, the two output files of particular interest are:

  • <computation_folder>/process_output.log
  • <computation_folder>/rescale_solver.log

The process_output.log file is created for every Rescale job and contains all the terminal output (stdout in Linux parlance) from the command as it is executed. The rescale_solver.log file is a file specific to the FINE™/Turbo computation and contains information on the progress of the simulation.

To live tail a file, click on the name of the file you want to view, for example, hpcc_stage_SA_000_cpb/rescale-solver.log. The monitoring frame updates under the status bar.

Results

Upon completion of the job, you will be presented with the Results page, as shown below.

result files

From this page you can do several things:

  • You can download all files using the blue Download button.
  • You can use the Actions menu, highlighted in red, to act on groups of selected files.
  • The Action buttons, allow you to view, download, delete, or make individual files available for future jobs.

For more information on how to download and manipulate files on the Rescale platform, please see the Downloading Data article.


We hope you've found this tutorial useful. For feedback and questions please contact Rescale or NUMECA support teams.