ANSYS Batch Tutorials

This tutorial will introduce you to submitting ANSYS jobs in batch to the Rescale platform. We will create an input file from the respective ANSYS software, start a Rescale job, submit, and transfer the results back to ANSYS.

Pre-processing activities (e.g. geometry, mesh/model) are already completed and all solver and setup settings are already determined as well. Unlike job submission through RSM, you do not need to launch Rescale Desktops. You can use your own ANSYS software and license or reach out to us and purchase some Elastic License Units (ELUs).

Important: ANSYS Workbench converts all input data into one unit system. To avoid any confusing conversions, specify a consistent unit system throughout your workflow (e.g. Geometry, Engineering data).

In this section, we will solve an ANSYS Fluent job in batch. To obtain the files needed to follow this tutorial, click on the "Job Setup" link below and clone the job hosting the file. Next, click "Save" on the job to have a copy of the files in your Rescale cloud files.

Import Job Setup Get Job Results

The input files are:

tjunction_plot.cas.gz - Compressed Case File

run_plot.jou - Journal File

Creating Case and Journal files

The tutorial example is a T-junction of two fluids at different temperatures using ANSYS Fluent version 18. The case file tjunction_plot.cas.gz is already available to you. The steps involved to create a case file are:

  • On Fluent, go to the File tab, then select Export > Case..., and this will open a window browser

  • Name the file with a .cas or .cas.gz extension and select the location where this file will be exported to.

This file contains all pre-processing settings, and solver and physics setup that have been configured in the GUI, as per your standard workflow.

Fluent Export Case File

You will also need a journal file which contains all the necessary commands that you would like to execute using Fluent during a batch run. The journal file run_plot.jou is already available to you. The steps involved to create a journal file are:

  • On a Windows Explorer window, right mouse click > New > Text Document (or similar for other OS).

  • Give the file a name, with extension .jou. Accept the change to file extension.

  • Double-click the file to open it and enter the journal commands, then save the file.

The journal file will look like this:

/file/set-batch-options no yes yes no
/file/read-case tjunction_plot.cas
/solve/initialize/initialize/
/solve/iterate 500
/file/write-case-data tjunction_plot%i.cas.gz
/exit yes

The journal file shown above reads the case file, sets the batch options, initializes, runs the calculation for 500 iterations, and finally writes a case and a data file when the solution has converged to a prescribed limit.

This file is written using the ANSYS FLuent Text User Interface (TUI). For more information about using specific text interface commands, please refer to ANSYS Online Documentation here.

Rescale Job Setup

After obtaining the necessary ANSYS Fluent files, we will now submit a Basic job on Rescale. For more information on launching a basic job, please refer to the tutorial here.

Setup: Input File(s)

  • Go onto the Rescale plaftorm, click on + New Job on the top left. Name your job and make sure the Job Type is set to Basic.

  • Next upload the journal and case files as input files.

Fluent Input Files

Setup: Software Settings

Click Next to move onto the Software Settings section of the setup.

  • You can scroll down or use the search bar to select ANSYS Fluent. The Analysis Options will display and select version 18.0.

  • In the command window, you will need to specify the journal file name under the angle bracket <journal filnename>. We would also like to see the solution residual. To do this, we command to keep the graphics windows using the -gu option.

  • Next under Licensing Options, select Use Existing License and enter your ANSYS server connection port numbers under License and ANSYS License Interconnect respectively.

For this tutorial, the software settings page will look as shown below.

Fluent Software Settings

Setup: Hardware Settings

The next step is to select the desired hardware for the job. Click on the Hardware Settings icon.

  • Select your desired core type and the numbers of cores that you want to use for this job. For this tutorial, select Onyx and 4 cores.

Your Hardware Settings screen screen should look like this:

Fluent Hardware Settings

Setup: Review

There are no post-processing settings in this tutorial. Click on the Review icon. Check that the setup is correct by reviewing the Basic Job Summary table. It should look like this:

Fluent Job Review

Job Submission and Monitor

Once you have reviewed your setup, you are ready to submit your job. Click Submit and you will move on from the Setup page to the Status page in the Rescale platform. Here, you will be able to monitor the job progress in a gantt chart like format, see a date and time stamped log and live-tail the status and output of your job using the Live-tail window. A guide on "Monitoring Status" on Rescale is found here.

Fluent live tailing example

In this example, we have configured the simulation to output a residual plot at every iteration, which will show up under the Live Tailing window as a residual.jpeg file. You can open this graph at any time to monitor the progress of the solution's convergence.

Fluent Simulation Residual

Viewing Results

Once the job is completed, you can either view the results on your local workstation or on a Rescale Desktop. Both methods are presented below:

On your Local Workstation

Once the job is completed, you can select the file(s) that you wish to download.

Note: If you have large output files, it is recommended that windows users use Rescale Transfer Manager (RTM) to download files faster onto your on-premises workstation. More information about RTM can be found here. Linux or Mac user can use Rescale CLI to download larger output files.

  • Go to the results page of the completed job, find and select the tjunction_plot0245.dat.gz

  • Go to Actions and click on Download selected files, give it a few seconds for it download to your computer

Fluent Import Data

  • Launch Fluent . Go to File tab, then select Import > Data... , to load the solution data file

On a Rescale Desktop

Once the job is completed, follow these steps to view results on a Rescale Desktop:

Set up a Desktop Session:

  • Under 1.Choose Configuration dropdown, select the hardware for your Desktop Session
  • Under 2.Add Software dropdown, select ANSYS Fluids Desktop
  • Under 3.Jobs dowpdown, search for the job you wish to add by typing the name and/or browsing through the list. Click Add to add a job to the Desktop
  • Once the Desktop session is started, launch Fluent
  • On Fluent, go to the File tab, then select Import > Data... . Navigate to the mapped directories. it is common to map to the Z: drive, but the attached job could be in the X: or Y: drives as well depending on your setup. Click on tjunction_plot0245.dat.gz file to load the solution data file and click Open

Fluent Import Data

Fluent Import Data

At this point, you can proceed to your post-processing activities as you would normally do after solving an Ansys Fluent simulation interactively.

Fluent contour result

ANSYS Fluent also has the capability of allowing users to modify or extend the behavior of the physics and solver setup. User defined functions (UDF) can be used to perform actions such as impose boundary conditions, physical and chemical processes, heat transfer and phase changes.

In this section we present instructions using Fluent User Defined Functions (UDF) in batch mode on the Rescale platform.

This guide will assume that you already have developed a UDF ready for compilation in a Fluent job. For assistance on creating or debugging UDFs please contact ANSYS Support directly. Here is a guide by ANSYS on using UDFs in Fluent.

Compilation of UDFs in Batch

To utilize a UDF during a batch run, the UDF source code must first be compiled and accessible by Fluent. We will demonstrate a workflow that compiles the UDF at runtime before the main solution solve or iteration process. We will accomplish this by adding commands to an existing example journal file. Depending on your workflow and the size of the compilation libraries, it is possible to have these UDF libraries pre-compiled and included as input files to your batch job. But generally UDFs are straightforward codes, so runtime compilation is a short opertation and avoids any platform inconsistencies.

Example Journal File

The following is an example of a journal file that compiles a user-created custom_UDF.c file in current directory (with the journal file) and loads the resulting UDF libraries. The UDF is compiled with the default library name libudf and creates a correspondingly named directory structure with the shared libraries.

Here, the compilation and load commands (shown in bold) are sequential and take place before the solution initilization. But you can perform these operations anywhere they fit into your workflow.

 
/file/set-batch-options no yes yes no
/file/read-case example.cas 
/define/user-defined/compiled-functions compile libudf yes custom_UDF.c ""

/define/user-defined/compiled-functions load libudf
/solve/initialize/initialize
/solve/iterate 1000
/parallel/timer/usage
/file/write-case-data example-%i.cas
/exit yes

There are two specific syntax things to note here. The first, is that after the UDF source code file name, there are two double quotes "" present. The second is the blank line after the compile command. This ensures that the compile function does not attempt to treat following lines as additional file names to include in the compile. The blank line is necessary after the compilation command but does not need to precede or follow the load command.

Making an Explicit UDF Call

Occassionally you will have to call a UDF function before or after a solution process to set up a boundary condition or perform some sort of post-processing step. You can call that UDF function explicitly in your journal file with an execute-on-demand call where appropriate:

/define/user-defined/execute-on-demand "FunctionName::libudf"

Running on Multiple Nodes

Another thing to note is that due to the nature of UDF function calls, all nodes need access to the compiled UDF libraries. By default, ANSYS Fluent jobs are set to run in the ~/work directory which is local to the head node. Depending on the behavior of the function, the slave node processes may need to access a common file or library. In this case, the job should be run out of the NFS mounted directory, ~/work/shared. So simply prepend move and change directory commands on the "Software Settings" page before you launch Fluent (not in the journal file):

mv * shared
cd shared
fluent 3ddp -gu -ssh -cnf=$FLUENT_HOSTS -t$RESCALE_CORES_PER_SLOT -i example.jou

So again, if you are running on multiple cores on a single node, this step is unnecessary since the local file system can be accessed by all the cores on that node.

This tutorial focuses on static structural analysis for a tapered beam in ANSYS Mechanical 18.0 and demonstrates how to submit the run as a batch job on the Rescale platform. The example model is a 15-foot long tapered I-beam made of steel. It's fixed at the larger end and a 500-lb force is applied at the smaller end. To obtain the Workbench project file (.wbpz) for the tutorial, please click on the Import Workbench project link below and click on the Save option located on the top right corner of the job submission page to have a copy of this file in your Rescale cloud files.

Import Workbench Project Import Job Setup Get Job Results

Creating input file from Workbench

Before we create the input file, please check that the status of the pre-processing cells before the setup are complete (Green check marks).

Workbench Component System

  • You can follow these steps to create the input file - Once all definitions are completed, double click on Setup (A5). In the ANSYS Mechancial window, highlight the Solution (A6) state in the tree on the left, then go to Tools > Write Input File...

Mechanical GUI Input File

  • You will be prompted to a "Save as" window. Choose the appropriate file name and directory. For this example, we name it: input_batch.dat.

Rescale job submission

  • Go onto the Rescale platform, start and name a new job, and upload the input file that you generated from Workbench. You can either upload the input file from your local computer or from the Rescale cloud files.

  • For this example, configure the software settings by selecting Ansys Mechanical version 18.0. For more information on launching a basic job, please refer to the tutorial here.

  • Under the command window, you will need to specify the input file name under the angle bracket <input-file>. In this tutorial, the command will be as highlighted below in the picture.

Job Submission sofware setting

  • Specify your license option, and move onto hardware settings. This example will be run on 4 Onyx cores. There is no post-processing options here.

  • Submit your job, and feel free to monitor the status of your job and get information about your cluster in real-time. A guide on "Monitoring Status" on Rescale is found here.

Viewing Results

Once the job is completed, you can either view the results on your local workstation or on a Rescale Desktop. Both methods are presented below:

On your Local Workstation

Once the job is completed, you can select the file(s) that you wish to download.

Note: If you have large output files, it is recommended that windows users use Rescale Transfer Manager (RTM) to download files faster onto your on-premises workstation. More information about RTM can be found here. Linux or Mac user can use Rescale CLI to download larger output files.

  • Go to the job results page, click Download with Rescale Transfer Manager. If a warning message pops up, click on Open Rescale.TransferClient.UI

  • A Browse for folder window will open, select a destination where you want to save the job results and click ok. It will download and wait until the status shows "Complete". The files will be saved into a folder named after the job.

RST Download Results

  • Go to Workbench, hightlight the Solution (A6) state on the tree on the left, then go to Tools > Read Result Files...

  • An Open window will display. Find the directory you specified earlier. This example is a Rescale Basic job and the output files will be under the "run1" folder. Select the "file.rst" file and click open. Wait for the results to completely load into ANSYS Mechanical. One way to verify this is to look at the tree and the Solution (A6) state should appear green check marked

On a Rescale Desktop

Once the job is completed, you can follow these steps to view results on a Rescale Desktop:

Upload your .wpbz workbench archive file to the Rescale Cloud. Click on Files and on Upload from this computer. This will open up a window. Navigate to the location where the '.wpbz` file is located. Click on the file and click Open

mechanical-workbench-archive.png

Set up a Desktop Session:

  • Under 1.Choose Configuration dropdown, select the hardware for your Desktop Session
  • Under 2.Add Software dropdown, select ANSYS Structures Desktop
  • Under 3.Jobs dowpdown, search for the job you wish to add by typing the name and/or browsing through the list. Click Add to add a job to the Desktop
  • Once the Desktop session is started, launch Ansys Workbench located on the rescale desktop
  • Download the `.wpbz' workbench archive file from Rescale Cloud Files as follows - Click on Cloud Files icon located on the Rescale Desktop. On the Rescale window, go to the Files tab and check the box next to the archived workbench file. Click on Actions > Download selected file. The file is downloaded to the Downloads directory on the Rescale Desktop

download-workbench-archive.png

  • In ANSYS Mechanical, you can restore the project archive by clicking on File and Restore Archive. Navigate to the location where the .wpbz file is located and click on it. In this example, it is saved as mechanical-batch-single-.wbpz
  • In the outline tree, hightlight the Solution (A6) state on the tree on the left, then go to Tools > Read Result Files...

Mechanical GUI Read Results

  • In the Open window, find the directory you specified earlier. This example is a Rescale Basic job and the output files will be under the "run1" folder. Select the file.rst file and click Open . Wait for the results to completely load into ANSYS Mechanical. One way to verify this is to look at the tree and the Solution (A6) state should appear "green check marked"

Mechanical GUI Open Results

Important: You must preserve the directory where the .rst and all other result files are located. Failure to do so may result in files not loading on Workbench.

At this point, you can proceed to your post-processing activities as you would normally do after solving an Ansys Mechanical simulation in the Workbench GUI.

The focus of this section is for ANSYS Mechanical in batch mode for multi frame analysis. In several cases, the analysis may consist of more than one system. Therefore, an input file must be generated for each system. In this example, the solution for tapered beam from previous section is the base analysis. We are interested in finding the critical load of the beam under buckling using Eigenvalue Buckling analysis. To continue, we need a second input file in System B plus the restart files from System A. Refer to ANSYS documentation for more information about multiframe restart and APDL.

Import Workbench Project Import Job Setup Get Job Results

Creating input file from workbench

  • For a multiframe restart, create the required connections between the two systems on workbench and then solve the base analysis as shown in the previous section. After the first system's run has been completed, read the result files in the first system as shown in the previous section under the heading Viewing Results

  • Please check that the status of all pre-processing cells are complete (Green check marks). Addtionally, check that the two systems are connected and that the solution from system A is connected to the setup of system B.

Multiple Analysis in Batch

  • Open ANSYS Mechanical and hightlight the Solution (B6) state instead to write a second input file.

  • Start a new job and upload this new input file. For this eignevalue buckling example, we also have to upload the .rnnn, .rdb, and .ldhi restart files from the base analysis.

Multiple Analysis in Batch

Rescale job submission

The rest of the workflow for job submission is the same as previous section. After the job submission, please make sure to include the updated job files to the rescale desktop for viewing the results.

Viewing results

Upload your archived workbench file to the rescale cloud and download it to the rescale desktop. Restore the archive file on workbench and hightlight the Solution (B6) state to read the new result file.

The simulation in this example calculated a load multiplier of 4.709. Since we applied 500 lbs of force, this means that the critical buckling load is 2355 lbs of force.

Mechanical GUI Buckling Profile

This tutorial focuses on static structural analysis for a tapered beam in ANSYS Mechanical 19.0 and demonstrates how to submit the run as a batch job on the Rescale platform. The example model is a 15-foot long tapered I-beam made of steel. It's fixed at the larger end and a 500-lb force is applied at the smaller end. To obtain the Workbench project file (.wbpz) for the tutorial, please click on the Import Workbench project link below and click on the Save option located on the top right corner of the job submission page to have a copy of this file in your Rescale cloud files.

Import Workbench Project Import Job Setup Get Job Results

Creating input file from Workbench

  • Before we create the input file, please check that the status of the pre-processing cells before the setup are complete (Green check marks).

Workbench Component System

  • You can follow these steps to create the input file - Once all definitions are completed, double click on Setup (A5). In the ANSYS Mechancial window, highlight the Solution (A6) state in the tree on the left, then go to Tools > Write Input File...

Mechanical GUI Input File

  • You will be prompted to a "Save as" window. Choose the appropriate file name and directory. For this example, we name it: input_batch.dat.

Rescale job submission

  • Go onto the Rescale platform, start and name a new job, and upload the input file that you generated from Workbench. You can either upload the input file from your local computer or from the Rescale cloud files.

  • For this example, configure the software settings by selecting Ansys Mechanical version 19.0. For more information on launching a basic job, please refer to the tutorial here.

  • Under the command window, you will need to specify the input file name under the angle bracket <input-file>. In this tutorial, the command will be as highlighted below in the picture.

Job Submission sofware setting

  • Specify your license option, and move onto hardware settings. This example will be run on 4 Onyx cores. There is no post-processing options here.

  • Submit your job, and feel free to monitor the status of your job and get information about your cluster in real-time. A guide on "Monitoring Status" on Rescale is found here.

Viewing Results

Once the job is completed, you can either view the results on your local workstation or on a Rescale Desktop. Both methods are presented below:

On your Local Workstation

Once the job is completed, you can select the file(s) that you wish to download.

Note: If you have large output files, it is recommended that windows users use Rescale Transfer Manager (RTM) to download files faster onto your on-premises workstation. More information about RTM can be found here. Linux or Mac user can use Rescale CLI to download larger output files.

  • Go to the job results page, click Download with Rescale Transfer Manager. If a warning message pops up, click on Open Rescale.TransferClient.UI

  • A Browse for folder window will open, select a destination where you want to save the job results and click ok. It will download and wait until the status shows "Complete". The files will be saved into a folder named after the job.

RST Download Results

  • Go to Workbench, hightlight the Solution (A6) state on the tree on the left, then go to Tools > Read Result Files...

  • An Open window will display. Find the directory you specified earlier. This example is a Rescale Basic job and the output files will be under the "run1" folder. Select the "file.rst" file and click open. Wait for the results to completely load into ANSYS Mechanical. One way to verify this is to look at the tree and the Solution (A6) state should appear green check marked

On a Rescale Desktop

Once the job is completed, you can follow these steps to view results on a Rescale Desktop:

Upload your .wpbz workbench archive file to the Rescale Cloud. Click on Files and on Upload from this computer. This will open up a window. Navigate to the location where the '.wpbz` file is located. Click on the file and click Open

mechanical-workbench-archive.png

Set up a Desktop Session:

  • Under 1.Choose Configuration dropdown, select the hardware for your Desktop Session
  • Under 2.Add Software dropdown, select ANSYS Structures Desktop
  • Under 3.Jobs dowpdown, search for the job you wish to add by typing the name and/or browsing through the list. Click Add to add a job to the Desktop
  • Once the Desktop session is started, launch Ansys Workbench located on the rescale desktop
  • Download the `.wpbz' workbench archive file from Rescale Cloud Files as follows - Click on Cloud Files icon located on the Rescale Desktop. On the Rescale window, go to the Files tab and check the box next to the archived workbench file. Click on Actions > Download selected file. The file is downloaded to the Downloads directory on the Rescale Desktop

download-workbench-archive.png

  • In ANSYS Mechanical, you can restore the project archive by clicking on File and Restore Archive. Navigate to the location where the .wpbz file is located and click on it. In this example, it is saved as mech-batch-single-v19.wbpz
  • In the outline tree, hightlight the Solution (A6) state on the tree on the left, then go to Tools > Read Result Files...

Mechanical GUI Read Results

  • In the Open window, find the directory you specified earlier. This example is a Rescale Basic job and the output files will be under the "run1" folder. Select the file.rst file and click Open . Wait for the results to completely load into ANSYS Mechanical. One way to verify this is to look at the tree and the Solution (A6) state should appear "green check marked"

Mechanical GUI Open Results

Important: You must preserve the directory where the .rst and all other result files are located. Failure to do so may result in files not loading on Workbench.

At this point, you can proceed to your post-processing activities as you would normally do after solving an Ansys Mechanical simulation in the Workbench GUI.

The focus of this section is for ANSYS Mechanical in batch mode for multi frame analysis. In several cases, the analysis may consist of more than one system. Therefore, an input file must be generated for each system. In this example, the solution for tapered beam from previous section is the base analysis. We are interested in finding the critical load of the beam under buckling using Eigenvalue Buckling analysis. To continue, we need a second input file in System B plus the restart files from System A. Refer to ANSYS documentation for more information about multiframe restart and APDL.

Import Workbench Project Import Job Setup Get Job Results

Creating input file from workbench

  • For a multiframe restart, create the required connections between the two systems on workbench and then solve the base analysis as shown in the previous section. After the first system's run has been completed, read the result files in the first system as shown in the previous section under the heading Viewing Results

  • Please check that the status of all pre-processing cells are complete (Green check marks). Addtionally, check that the two systems are connected and that the solution from system A is connected to the setup of system B.

Multiple Analysis in Batch

  • Open ANSYS Mechanical and hightlight the Solution (B6) state instead to write a second input file.

  • Start a new job and upload this new input file. For this eignevalue buckling example, we also have to upload the .rnnn, .rdb, and .ldhi restart files from the base analysis.

Multiple Analysis in Batch

Rescale job submission

The rest of the workflow for job submission is the same as previous section. After the job submission, please make sure to include the updated job files to the rescale desktop for viewing the results.

Viewing results

Upload your archived workbench file to the rescale cloud and download it to the rescale desktop. Restore the archive file on workbench and hightlight the Solution (B6) state to read the new result file.

The simulation in this example calculated a load multiplier of 4.7012. Since we applied 500 lbs of force, this means that the critical buckling load is 2350.6 lbs of force.

Mechanical GUI Buckling Profile

The focus of this section is on setting up an ANSYS Icepak 18.2 case to run in batch. This example case is also used in our ANSYS RSM Electronics tutorial using RSM job submission. In this tutorial we will show a workflow entirely within the Rescale platform. We demonstrate how to launch a Rescale Desktop, load an Icepak case, how to pack it for batch submission, and finally how to run this ANSYS Icepak case in batch. Once you are comfortable with the Rescale platform, you can tailor the workflow to suit your needs. For the basics on Rescale batch, please refer to our guide.

Prepare a simulation

To begin, we will go over how to create an input file in ANSYS Icepak, followed by the Job Setup in the Rescale platform.

First, please use the link below to clone the "ANSYS Icepak Example" job. Next, click "Save" on the job to have a copy of the files in your Rescale cloud files. Note, although you can run this job directly, to continue with this tutorial do not submit this case directly. We are cloning the job in order to import the simulation file (ansys-icepak-packed.tzr) into your account.

Import Job Setup Get Job Results

Simulation setup on Rescale

In this part of tutorial, we will show you how to export a simulation ready for batch submission from ANSYS Icepak using Rescale Desktops. If you have a prepared simulation .tzr file in your local environment ready for batch submission, feel free to skip the next few sections. You can go ahead and begin the batch submission section. Or if you want to just create the packed .tzr from the Icepak GUI, you can skip to this section before going on to batch submission. Otherwise, please continue:

Launching a Remote Desktop on Rescale

  • Start by selecting the "Desktops" option in the Rescale platform Web UI.

  • Select "New Custom Desktop" button in the upper left hand corner. This should bring you to a new page where you can give the desktop name an instance if you choose to. Here we've named this desktop "ANSYS Icepak Desktop".

  • Under "1. Choose Configuration", select the basic "Windows" configuration.

  • Expand the drop-down menu for "2. Add Software." Search for or select from the menu: "ANSYS Icepak Desktop".

  • A "Select License - ANSYS Icepak Desktop" pop-up menu should now appear. Enter your appropriate ANSYS license information and click "ok" to continue.

  • You can now also select which version of Icepak you want to use. We will choose "18.2" for this tutorial.

  • Expand the drop-down menu for "3. Add Jobs". Again, you can search for or select from the menu the job you cloned: "ANSYS Icepak Example". Click "Add" under actions.

After making the selections, your screen should look like the following:

Icepak Desktop Setup


  • You can then begin to launch the desktop by clicking on the "Launch" button in the lower right hand corner of the page. This should bring up the following confirmation dialog:

Icepak Desktop Launch


  • If the settings appear to be correct, click "Launch" in this menu to start the desktop server. This process should take approximately 5-10 minutes to spin up a new Windows server instance. Please refresh the page every few minutes to update the status of the server. In the "4. Logs" menu once the message "Server(s) Started" is reported the desktop should be ready to use.

  • Click on the "Connect" button to bring up the connection options. You can choose to connect using your own Windows RDP client or an the "In-Browser Desktop" that we will use in this case. Please refer to our guide for more information Windows RDP and/or configuring a Rescale Desktop.

Creating an input file from the Icepak GUI

  • Once connected to the Windows desktop, launch ANSYS Icepak by double clicking the "Icepak 18.2" shortcut found on the desktop.

  • A "Welcome to Icepak" dialog box should appear. Select the "Unpack" button.

  • If you attached the cloned job, in the "File selection" menu navigate to the Desktop and select the "attached_jobs" shortcut. This should bring you to the folder that the attached clone job files were extracted to. Select the "input" folder. Finally select the simulation file ansys-icepak-packed.tzr to open.

  • In your normal workflow instead of "Unpacking" a job, you would build or modify your model in this step. Once the desired changes have been made, you can "Pack" the simulation again ready for Icepak batch submission.

  • So if the case is prepared and ready to be analyzed, you can "Pack" the simulation into a .tzr file by selecting the File > Pack project:

Icepak Desktop Pack TZR


The following dialog should appear:

Icepak Desktop Pack Dialog


  • Enter a filename and path for this file. Here for the purposes of the demonstration, we are using the same filename ansys-icepak-packed.tzr in a different directory path.

Uploading the Simulation File to the Rescale Cloud

  • If you created the packed .tzr file from a Rescale Desktop, you can now upload the file to Rescale by running the "Cloud Files" icon on the desktop. Select the option to "Upload from this computer". Navigate to the path of the file and select the newly "packed" ansys-icepak-packed.tzr.

Icepak Desktop Upload File


If you save this file in the job folder, you use our "Sync Files" feature to directly import those files into your Rescale account. Please refer to our guide on File Transfer for more information.

  • If you created the packed simulation file from your local desktop environment, you can upload the file using similarly from the Web UI Files option.

Terminate the Desktop

Since we have prepared our simulation and uploaded the file back to the Rescale Cloud, we are done using our Icepak GUI for the time being. We can now shutdown this Desktop instance. You can choose to keep the instance running to perform post-processing after the simulation is completed.

  • In the Rescale Web UI, select "Desktops".

  • Check the "Select" tickbox under your Desktop instance. This instance should be easily identified if you provided it a name earlier.

  • Click the red "Terminate" button near the top of the page to shutdown this instance.

  • For a guide on using the Rescale desktop please refer to our guide here

Submitting Your Job in Batch

Now with the prepared simulation .tzr file, we can set up a Rescale job to submit in batch.

  • Go onto the Rescale platform Web UI and select "+ New Job".

  • Feel free to rename the job by clicking on the pencil icon next to the job name ("Untitled Job") at the top of the page.

  • Click on "Use files from cloud storage" and select the .tzr file you uploaded from the Desktop instance:

Job Submission Files


  • Or you can also choose to upload a .tzr file from your local machine using the "Upload from this computer" button at this stage as well.

  • Now we can configure our software package options on the "Software Settings" page. You can search for or directly select the tile for ANSYS Icepak:

Job Submission Sofware Selection


  • This should now bring you to the software configuration page for that package.

  • Under the command window, you will need to specify the input file name inside the angle brackets <input-file>. In this case, replace <input-file> with ansys-icepak-packed.tzr:

Job Submission Sofware and License Configuration


  • Below, on this same page, please specify the appropriate license options.

  • Now we can select the type and number of cores to run on in the "Hardware Settings" page.

  • Choose 2 or more cores for this Icepak problem. This tutorial will be run on 8 Onyx cores and should complete in approximately 16 minutes.

  • There is no need to specify any "Post Processing" options for this tutorial.

  • After reviewing your selections, your case should now be ready for batch submission at this point.

  • Click the blue "Submit" button in the top right corner on any of the job configuration pages or in the middle of the "Review" page.

  • Alternatively, instead of submitting the job, you can elect to "Save" the problem setup to be run at some later time.

  • You can monitor the status of your job and get information about your cluster in real-time. Here you can see the live-tailing of the output "process_output.log" as the case begins to run:

Live Tailing


  • A guide on "Monitoring Status" on Rescale is found here.

  • Once the job has completed its run, you can "Download" all of the output files from the "Results" page. You can also launch another Desktop and attach this job to perform post-processing.

  • A guide on "Managing your Job Results" on Rescale is found here.

This tutorial shows how to run an ANSYS HFSS simulation model in batch mode on Rescale's ScaleX platform. Once you are comfortable with the Rescale platform, you can tailor the workflow to suit your needs. For basics on Rescale batch, please refer to our guide.

This tutorial is based on a cutout section of a PCI Express Gen 3 printed circuit board. The study is a single frequency sweep to calculate the S-parameters of the section edges.

ANSYS HFSS PCIe model

To obtain the files needed to follow this tutorial, click on the "Job Setup" link below and clone the job hosting the file. Next, click the "Save" icon to have a copy of the files in your Rescale cloud files.

Note : although you can run this job directly, to continue with this tutorial do not submit it directly. We are cloning the job in order to import the simulation input file ansys-hfss-electronics-example.aedtz into your account. You can also obtain the results of the job by clicking on "Get Job Results".


Import Job Setup Get Job Results


Creating input file

For running an ANSYS HFSS Job, we need to create a .aedtz archive file from the ANSYS Electronics desktop. You can create this file on your local ANSYS Electronics desktop. Rescale also offers the Remote Desktop option, where you can launch an ANSYS HFSS desktop to use the software as it's explained in the next section below.

If you have an archived simulation .aedtz file in your local environment ready for batch submission, feel free to skip the next few sections. You can go ahead and begin the batch submission section. Or if you want to just create the packed .aedtz from the ANSYS HFSS GUI, you can skip to this section before going on to batch submission. Otherwise, please continue:

Launching a Remote Desktop on Rescale

  • Start by selecting the "Desktops" option in the Rescale platform Web UI.

  • Select "New Custom Desktop" button in the upper left hand corner. This should take you to the Desktop Configuration page. Give the Desktop a name. Here we've named this desktop "ANSYS HFSS Desktop".

  • Under "1. Choose Configuration", select the basic Windows configuration.

  • Expand the drop-down menu for "2. Add Software." Search for or select from the menu: ANSYS HFSS Desktop.

  • A "Select License - ANSYS HFSS Desktop" pop-up menu should now appear. Enter your appropriate ANSYS license information and click "ok" to continue.

  • You can now also select which version of HFSS you want to use. We will choose 19.0 for this tutorial.

  • Expand the drop-down menu for "3. Add Jobs". Again, you can search for or select from the menu the job you cloned: ANSYS HFSS Tutorial. Click "Add" under actions.

After making the selections, your screen should look like the following:

ANSYS HFSS desktop


  • You can then begin to launch the desktop by clicking on the "Launch" button in the lower right hand corner of the page. This should bring up a confirmation dialog.

  • If the settings appear to be correct, click "Launch" in this menu to start the desktop server. This process should take approximately 5-10 minutes to spin up a new Windows server instance. Please refresh the page every few minutes to update the status of the server. In the "4. Logs" menu once the message "Server(s) Started" is reported the desktop should be ready to use.

  • Click on the "Connect" button to bring up the connection options. You can choose to connect using your own Windows RDP client or an the "In-Browser Desktop" that we will use in this case. Please refer to our guide for more information about Windows RDP and/or configuring a Rescale Desktop.

Creating an input file from the ANSYS Electronics desktop

Please follow these steps if you want to open the tutorial files on a Rescale Desktop -

  • Once connected to the Windows desktop, launch ANSYS Electronics Desktop by double clicking the ANSYS Electronics Desktop 19.0 shortcut found on the desktop.

  • If you attached the cloned job, in the "File selection" menu, navigate to the Desktop and select the "attached_jobs" shortcut. This should bring you to the folder that the attached clone job files were extracted to. Select the "input" folder. Finally select the simulation file .aedt to open.

  • If you want to use you own ANSYS HFSS file, you can upload the file to Rescale cloud and download it on the HFSS desktop you launched. Please refer to the File Transfer section for Uploading to Rescale Cloud Files and Downloading from Rescale Cloud Files.

  • After you have made the necessary changes to your HFSS case file, click on File > Archive to create an archived input file.

ANSYS HFSS Input File

Uploading the Simulation File to the Rescale Cloud

  • If you created the archived .aedtz file from a Rescale Desktop, you can now upload the file to Rescale by clicking on the "Cloud Files" icon on the desktop. Select the option to "Upload from this computer". Navigate to the path of the file and select the newly archived .aedtz.

ANSYS HFSS Cloud File


  • If you created the archived simulation file from your local desktop environment, you can upload the file similarly from the Web UI Files option.

Terminate the Desktop

Since we have prepared our simulation and uploaded the file back to the Rescale Cloud, we are done using our ANSYS Electronics GUI for the time being. We can now shutdown this Desktop instance. You can choose to keep the instance running to perform post-processing after the simulation is completed.

  • In the Rescale Web UI, select "Desktops".

  • Check the "Select" tickbox under your Desktop instance. This instance should be easily identified if you provided it a name earlier.

  • Click the red "Terminate" button near the top of the page to shutdown this instance.

  • For a guide on using the Rescale desktop please refer to our guide here

Submitting the Job

  • This section will show how to submit the archived .aedtz that you created from ANSYS Electronics desktop. To start a new job, login to the the rescale platfrom and click on + New Job button on the top left corner. For more information on launching a basic job, please refer to the tutorial here.

Input files

  • First, you need to include the input files needed for the batch run. For the ANSYS HFSS case, we need to include the .aedtz file which we created as shown in the previous section.

  • If you created the file locally, you can use the Upload from this computer option. If you have the input file on the Rescale cloud, click on Use files from cloud storage and search for the file you created. After including the input files, click on software settings option.

ANSYS HFSS Job Start

Software settings

  • In the software settings page, search for ANSYS HFSS software and click on it.

  • The Analysis Option window opens up where you can select the software version and edit the command to run a ANSYS HFSS batch job. In the command line, Replace the placeholder with your HFSS .aedtzfile.

ANSYS HFSS Software Settings

  • NOTE : If you are using HFSS on Azure, refer to the HFSS FAQs for addtional command lines.

  • You can also specify design options in HFSS. Please refer to the HFSS FAQs for more information about design options. If you don't wish to specify any design option, simply delete the < design-options > placeholder.

  • Additionally, you can specify to distribute the tasks manually or automatically. Please refer to the HFSS FAQs for more information on manual vs automatic task distribution.

ANSYS HFSS Commands

Hardware settings

  • In the hardware settings page, you can specify the core type and number of cores. For this example, we will choose the core type as Onyx and number of cores = 8. You can find a summary of the hardware on the right side of the jot setup page.

  • There is no need to specify any "Post Processing" options for this tutorial.

Monitoring your job

  • After reviewing your selections, your case should now be ready for batch submission at this point.

  • Click the blue "Submit" button in the top right corner on any of the job configuration pages or in the middle of the "Review" page.

  • Alternatively, instead of submitting the job, you can elect to "Save" the problem setup to be run at some later time.

  • You can monitor the status of your job and get information about your cluster in real-time. Here you can see the live-tailing of the output "process_output.log" as the case begins to run:

ANSYS HFSS Monitoring Job

  • A guide on "Monitoring Status" on Rescale can be found here.

Viewing Results

  • Once the job has completed its run, you can "Download" all of the output files from the "Results" page. You can also launch another Desktop and attach this job to perform post-processing.

  • A guide on "Managing your Job Results" on Rescale can be found here.

  • When you attach the completed job, Rescale will create two folders - input and run1 inside the desktop > attached_job > [job folder] folder. The run1 has three folder with the extensions - ".aedb" , ".aedt.batchinfo" and ".aedtresults". It additionally has a .aedt file as well.

  • To view the results, open ANSYS Electronics desktop and open the .aedt file inside the run1 folder. The results will automatically be loaded into ANSYS Electronics desktop. You can proceed to post process on the software.

ANSYS HFSS Result File

This tutorial shows how to run an ANSYS Maxwell simulation model in batch mode on Rescale's ScaleX platform. Once you are comfortable with the Rescale platform, you can tailor the workflow to suit your needs. For basics on Rescale batch, please refer to our guide.

This tutorial is based on a magnetostatic analysis of a rotational actuator. It is a parametric study of torque and inductance characteristics vs. position with an excitation current of 675.5 A

ANSYS Maxwell model

To obtain the files needed to follow this tutorial, click on the Import Job Setup link below to clone this job hosting the file. Next, click the Save icon to have a copy of the files in your Rescale cloud files.

Note : although you can run this job directly, to continue with this tutorial do not submit it directly. We are cloning the job in order to import the simulation input file rotational-actuator.aedtz into your account. You can also obtain the results of the job by clicking on Get Job Results.


Import Job Setup Get Job Results


Creating input file

For running an ANSYS Maxwell Job, we need to create an .aedtz archive file from the ANSYS Electronics desktop. You can create this file on your local ANSYS Electronics desktop. Rescale also offers the Remote Desktop option, where you can launch an ANSYS Maxwell desktop to use the software, which is explained in the next section below.

If you have an archived simulation .aedtz file in your local environment ready for batch submission, feel free to skip the next few sections. You can go ahead and begin the batch submission section. Or if you want to just create the packed .aedtz from the ANSYS Maxwell GUI, you can skip to this section before going on to batch submission. Otherwise, please continue:

Launching a Remote Desktop on Rescale

  • Start by selecting the "Desktops" option in the Rescale platform Web UI.

  • Select "New Custom Desktop" button in the upper left hand corner. This should take you to the Desktop Configuration page. Give the Desktop a name. Here we've named this desktop "ANSYS Maxwell Desktop".

  • Under "1. Choose Configuration", select the basic Windows configuration.

  • Expand the drop-down menu for "2. Add Software." Search for or select from the menu: ANSYS Maxwell Desktop.

  • A "Select License - ANSYS Maxwell Desktop" pop-up menu should now appear. Enter your appropriate ANSYS license information and click "ok" to continue.

  • You can now also select which version of Maxwell you want to use. We will choose 19.0 for this tutorial.

  • Expand the drop-down menu for "3. Add Jobs". Again, you can search for or select from the menu the job you cloned: ANSYS Maxwell Tutorial. Click "Add" under actions.

After making the selections, your screen should look like the following:

ANSYS Maxwell desktop


  • You can then begin to launch the desktop by clicking on the "Launch" button in the lower right hand corner of the page. This should bring up a confirmation dialog.

  • If the settings appear to be correct, click "Launch" in this menu to start the desktop server. This process should take approximately 5-10 minutes to spin up a new Windows server instance. Please refresh the page every few minutes to update the status of the server. In the "4. Logs" menu, the Desktop will be ready to launch once the "Server Started" message is displayed.

  • Click on the "Connect" button to bring up the connection options. You can choose to connect using your own Windows RDP client or the "In-Browser Desktop" that we will use in this tutorial. Please refer to our guide for more information about Windows RDP and/or configuring a Rescale Desktop.

Creating an input file from the ANSYS Electronics desktop

Please follow these steps if you want to open the tutorial files on a Rescale Desktop:

  • Once connected to the Windows desktop, launch ANSYS Electronics Desktop by double clicking the ANSYS Electronics Desktop 19.0 shortcut found on the desktop.

  • If you attached the cloned job, in the "File selection" menu, navigate to the Desktop and select the attached_jobs shortcut. This should bring you to the folder that the attached clone job files were extracted to. Select the "input" folder. Finally select the simulation file .aedt to open.

  • If you want to use you own ANSYS Maxwell file, you can upload the file to Rescale file storage and then download it on the Maxwell desktop you launched. Please refer to the File Transfer section for Uploading to Rescale Cloud Files and Downloading from Rescale Cloud Files.

  • After you have made the necessary changes to your Maxwell file, click on File > Archive to create an archived input file.

ANSYS Maxwell Input File

Uploading the Simulation File to the Rescale Cloud

  • If you created the archived .aedtz file from a Rescale Desktop, you can now upload the file to Rescale by clicking on the "Cloud Files" icon on the desktop. Select the option to "Upload from this computer". Navigate to the path of the file and select the newly archived .aedtz.

ANSYS Maxwell Cloud File


  • If you created the archived simulation file from your local desktop environment, you can upload the file similarly from the Web UI Files option.

Terminate the Desktop

Since we have prepared our simulation and uploaded the file back to the Rescale Cloud, we are done using our ANSYS Electronics GUI for the time being. We can now shutdown this Desktop instance. You can choose to keep the instance running to perform post-processing after the simulation is completed.

  • In the Rescale Web UI, select "Desktops".

  • Check the "Select" tickbox under your Desktop instance. This instance should be easily identified if you provided it a name earlier.

  • Click the red "Terminate" button near the top of the page to shutdown this instance.

  • For a guide on using the Rescale desktop please refer to our guide here

Submitting the Job

  • This section will show how to submit the archived .aedtz that you created from ANSYS Electronics desktop. To start a new job, login to the the rescale platfrom and click on + New Job button on the top left corner. For more information on launching a basic job, please refer to the tutorial here.

Input files

  • First, you need to include the input files needed for the batch run. For the ANSYS Maxwell case, we need to include the .aedtz file which we created as shown in the previous section.

  • If you created the file locally, you can use the Upload from this computer option. If you have the input file on the Rescale cloud, click on Use files from cloud storage and search for the file you created. After including the input files, click on software settings option.

ANSYS Maxwell Job Start

Software settings

  • In the software settings page, search for ANSYS Maxwell software and click on it.

ANSYS Maxwell Software Settings

  • The Analysis Option window opens up where you can select the software version and edit the command to run a ANSYS Maxwell batch job. In the command line, replace the placeholder with your Maxwell .aedtzfile.

  • Additionally, you can specify to distribute the tasks manually or automatically by replacing the place holder < int > with an appropriate number. Please refer to the Maxwell FAQs for more information on manual vs automatic task distribution.

  • For this example, TASK_PER_NODE is set to 2 (Which is manual mode)

  • NOTE : If you are using Maxwell on Azure, refer to the Maxwell FAQs for addtional command lines.

  • You can also specify design options in Maxwell. Please refer to the Maxwell FAQs for more information about design options. If you don't wish to specify any design option, simply delete the < design-options > placeholder.

ANSYS Maxwell Commands

Hardware settings

  • In the hardware settings page, you can specify the core type and number of cores. For this example, we will choose the core type as Onyx and number of cores = 8. You can find a summary of the hardware on the right side of the jot setup page.

  • There is no need to specify any "Post Processing" options for this tutorial.

Monitoring your job

  • After reviewing your selections, your case should now be ready for batch submission at this point.

  • Click the blue Submit button in the top right corner on any of the job configuration pages or in the middle of the "Review" page.

  • Alternatively, instead of submitting the job, you can elect to Save the problem setup to be run at some later time.

  • You can monitor the status of your job and get information about your cluster in real-time. Here you can see the live-tailing of the output process_output.log as the case begins to run:

ANSYS Maxwell Monitoring Job

  • A guide on Monitoring Status on Rescale can be found here.

Viewing Results

  • Once the job has completed its run, you can "Download" all of the output files from the "Results" page. You can also launch another Desktop and attach this job to perform post-processing.

  • A guide on "Managing your Job Results" on Rescale can be found here.

  • When you attach the completed job, Rescale will create two folders - input and run1 inside the desktop > attached_job > [job folder] folder. The run1 has three folder with the extensions - ".aedb" , ".aedt.batchinfo" and ".aedtresults". It additionally has a .aedt file as well.

ANSYS Maxwell Result File

  • To view the results, open ANSYS Electronics desktop and open the .aedt file inside the run1 folder. The results will automatically be loaded into ANSYS Electronics desktop. You can proceed to post process on the software.

ANSYS Maxwell Results