ANSYS Maxwell Batch Tutorials

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.

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 box 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
  • 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 Rescale platform 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 additional 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 Emerald 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.
  • 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