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.
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:
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.
Create New Job
To create a new job, click + New Job on the top-left corner of your screen.
Upload Input files
To run a basic job, the fields highlighted in red below need to be set correctly.
Proceed as follows:
- Edit the job name to one of your choice, here we use Basic Job: HPCC Stage
- Check that the Job Type is Basic.
- Upload the project archive required for this run.
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.
Select FINE™/Turbo by entering "NUMECA" in the textbox search field, shown highlighted in red, and clicking on the FINE™/Turbo icon.
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
The screenshot below, with modified fields shows how your Software Settings setup page should look on completion of this step.
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>
-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**
The Rescale Platform allows you to Purchase License at a competitive rate. This tutorial will use the Purchase License option.
Click Next or Hardware Settings to proceed with this tutorial.
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:
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.
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
Click Save and Next to proceed.
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.
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.
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:
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.
Upon completion of the job, you will be presented with the Results page, as shown below.
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.