ANSYS EDT (formerly HFSS)
From the ANSYS EDT Website: ANSYS Electronics Desktop is the premier, unified platform for electromagnetic, circuit and system simulation. Gold-standard tools like ANSYS HFSS, Maxwell, Q3D Extractor, and Simplorer are built natively in the Electronics Desktop, which serves as a universal Pre/Post processor for these tools.
- Students authorized by the WAMI research group
- WAMI Faculty
- Desktop PC
Running ANSYS EDT (formerly HFSS) on CIRCE
The ANSYS EDT (formerly HFSS) user guide is essential to understanding the application and making the most of it. The guide and this page should help you to get started with your simulations. Please refer to the Documentation section for a link to the guide.
- Note on CIRCE: Make sure to run your jobs from your $WORK directory!
- Note: Scripts are provided as examples only. Your SLURM executables, tools, and options may vary from the example below. For help on submitting jobs to the queue, see our SLURM User’s Guide.
1. Ensure that your project file resides on your CIFS drive, preferably under the Ansoft folder. The example below assumes that my project file exists under:
- /work/u/user/Ansoft/ExampleModel* on CIRCE
- W:\Ansoft\ExampleModel* for CIFS mounted on Windows
- \\cifs.rc.usf.edu\work\Ansoft\ExampleModel* for CIFS
These paths are all equivalent and point to the same storage location. (Note: your CIFS drive may be mapped to another drive letter besides ‘W’)
Previous issues using Ansys EDT on the WORK filesystem have been resolved.
2. Using the CIRCE/SC Desktop Environment, connect to circe.rc.usf.edu and log in with your USF NetID credentials.
3. Go to Applications > System Tools > Terminal to start a command-line session.
4. Load the Ansys EDT module:
[user@itn0 ~]$ module add apps/ansysEM/2021r1
5. Change to the directory in which your model resides:
[user@itn0 ~]$ cd $WORK/Ansoft/ExampleModel [user@itn0 ExampleModel]$
6. (Optional) From here, you can open the Ansys EDT graphical interface (GUI) in order to view and edit your files. As long as you have the module loaded from step 4, you can open the GUI from the command line:
[user@itn0 ~]$ ansysedt
Please note, however, that you must follow step 7 below in order to submit your job to the cluster.
7. Submit the job using the sbatch command:
[user@itn0 ~]$ sbatch --job-name="MyModel.aedt" --nodes=1 --ntasks-per-node=4 --time=01:00:00 $ansysedt_slurm
In the example above, we are submitting a job to analyze the designs in MyModel.aedt using 4 processors on a single server with a maximum runtime of 1 hour.
Batch Execution Options
Submitting your job to CIRCE allows for several modes of operation, depending on how your analysis settings are configured. For jobs using the direct sequential solver, we can utilize multiple processors on a single server to facilitate speed-up of the application and shared memory. Continuing with the previous example of submitting such a job:
[user@itn0 ~]$ sbatch --job-name="MyModel.aedt" --nodes=1 --ntasks-per-node=4 --time=01:00:00 --mem-per-cpu=8192 $ansysedt_slurm
The key option for using the sequential solver is to set --nodes equal to 1 and to have --ntasks-per-node be less than or equal to 16. This time, we are also requesting 8.0 GB of memory (expressed in megabytes) on the server by setting the --mem option. The value for --mem can vary from less than 1.0G for normal jobs up to 180G for large memory jobs. Note that some nodes have a maximum of 28 GB available.
For jobs configured to use Solver Domains, we can use the Distributed analysis type. Distributed analysis allows us to not only utilize multiple processors on a server, but to utilize multiple servers together in order to reach a solution even more quickly. Here’s an example submission below:
The key options for using the distributed (DSO) solver are:
1. Ensure that Domain Decomposition is selected as the solution option in the Analysis > Solution Setup > Options tab
2. Ensure that --nodes >= 2
3. Ensure that --ntasks-per-node <= 16
4. Ensure that --mem-per-cpu <= (28 / ntasks-per-node)
You must specify your job run-time using the --time option if your job will run for longer than 1 hour. The time format is in HH:MM:SS. The Below example shows a distributed job using 8 processors on 4 nodes, for a total of 32 processors using 64 GB of memory running for up to 24 hours.
user@itn0 ~]$ sbatch --job-name="MyModel.aedt" --nodes=4 --ntasks-per-node=8 --time=24:00:00 --mem-per-cpu=2048 $ansysedt_slurm
Job Status and Progress Information
You can view the state of your job in the scheduler by running
[user@itn0 ~]$ squeue -u user
You can also watch the Ansys EDT job log, once the job has started (entered the ‘R’ state), in order to see the progress of the analysis. This can be done by ‘tailing’ the output file. Using the command below, output that is generated by Ansys EDT is automatically printed to your screen as it arrives. The log file name is <MyProjectFile>.aedt.out.<JobIdNumber> where <MyProjectFile> is the file name submitted for analysis and <JobIdNumber> is the Job ID number as shown in the first column of the squeue output. This is illustrated below:
[user@itn0 ExampleModel]$ tail -f MyExample.aedt.8788700.out [progress: 2%] (2) helical_antenna - HFSSDesign1 - Setup1: Solving Ports on Local Machine - RUNNING: Building matrix (9:42:03 AM Jun 7, 2017) [progress: 8%] (2) helical_antenna - HFSSDesign1 - Setup1: Solving Ports on Local Machine - RUNNING: Building matrix (9:42:06 AM Jun 7, 2017) [progress: 20%] (2) helical_antenna - HFSSDesign1 - Setup1: Solving Ports on Local Machine - RUNNING: Building matrix (9:42:08 AM Jun 7, 2017) [progress: 0%] (2) helical_antenna - HFSSDesign1 - Setup1: Port-Refining Mesh on Local Machine - RUNNING: (9:42:10 AM Jun 7, 2017) [progress: 15%] (2) helical_antenna - HFSSDesign1 - Setup1: Port-Refining Mesh on Local Machine - RUNNING: Reading the mesh stats. (9:42:32 AM Jun 7, 2017) [progress: 50%] (2) helical_antenna - HFSSDesign1 - Setup1: Port-Refining Mesh on Local Machine - RUNNING: Reading the mesh stats. (9:42:46 AM Jun 7, 2017) [progress: 75%] (2) helical_antenna - HFSSDesign1 - Setup1: Port-Refining Mesh on Local Machine - RUNNING: Morphing the mesh for curved surfaces (9:42:58 AM Jun 7, 2017)
Home Page, User Guides, and Manuals
- Ansys EDT Home Page
Benchmarks, Known Tests, Examples, Tutorials, and Other Resources
- Ansys EDT Examples
More Job Information
See the following for more detailed job submission information:
Report bugs with ANSYS EDT (formerly HFSS) to the IT Help Desk: email@example.com