ANSYS EDT (formerly HFSS)

Revision as of 20:44, 23 March 2021 by Tgreen (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Description

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.

Version

  • 2021r1

Authorized Users

  • Students authorized by the WAMI research group
  • WAMI Faculty

Platforms

  • CIRCE cluster
  • 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)


Documentation

Home Page, User Guides, and Manuals

Benchmarks, Known Tests, Examples, Tutorials, and Other Resources

  • Ansys EDT Examples
    • /apps/AnsysEM/2021r1/AnsysEM20.1/Linux64/Examples

More Job Information

See the following for more detailed job submission information:

Reporting Bugs

Report bugs with ANSYS EDT (formerly HFSS) to the IT Help Desk: rc-help@usf.edu

Retrieved from "https://wiki.rc.usf.edu/index.php?title=ANSYS_EDT_(formerly_HFSS)&oldid=2373"