Using the Command Line to Submit HPC Jobs

Ansys Electronics Desktop can be run from the command line. When using the command line to perform HPC jobs, take the following into consideration.

Distributed Jobs

An Ansys EM batch job which distributes the analysis over several hosts may also be called a distributed job. To submit a distributed job, the following Ansys EM desktop command line options should be used:

• The -Distributed option should be present, and the -Local option should be absent. When running as a batch job under one of the schedulers with direct integration, this option is a directive to the job to 1) obtain the list of hosts allocated to the job, directly from the scheduler, and to 2) use the scheduler to launch the analysis engines on the hosts allocated to the job. The -Distributed option may now have additional options, such as includetypes=xxx, excludetypes=xxx, maxlevels=n, and numlevel1=n, where n indicates and integer, and xxx indicates a list of distribution types or "default".
• The -Machinelist num=num_distributed_engines option must be included, where num_distributed_engines is the total number of analysis engines to be started on the hosts assigned to the job.

Other examples:

• Serial Job on a Single Processor
• Distributed Job Using Four Processors
• Multiprocessing Job Using Four Cores
• Distributed Analysis and Multiprocessing in the Same Job

Serial Job on a Single Processor

Suppose Ansys Electronics Desktop is installed at "C:\Program Files\AnsysEM\v242\Win64\ and you are using RSM for DSO:

C:\Program Files\AnsysEM\v242\win64\ansysedt.exe -ng -BatchSolve -machinelist num=2

-monitor \\shared_drive\projs\OptimTee.aedt

Using LSF for remote-analysis/DSO

bsub -n 1 C:\Program Files\AnsysEM\v242\win64\ansysedt.exe -ng -BatchSolve -machinelist num=3 -monitor -local \\shared_drive\projs\OptimTee.aedt

Distributed Job Using Four Processors

Ansoft RSM

C:\Program Files\AnsysEM\v242\win64\ansysedt.exe -ng -Batchsolve -monitor -Distributed

-machinelist list="10.1.1.221, 10.1.1.222, 10.1.1.223, 10.1.1.224" \\shared_drive\projs\OptimTee.aedt

LSF

bsub -n 4 C:\Program Files\AnsysEM\v242\win64\ansysedt.exe -ng -Batchsolve -monitor

-Distributed -machinelist num=4

\\shared_drive\projs\OptimTee.aedt

Multiprocessing Job Using Four Cores

bsub -n 4 -R "span[ptile=4]" C:\Program Files\AnsysEM\v242\win64\ansysedt.exe -ng -monitor

-Local -BatchSolve -machinelist num=4 -batchoptions \\shared_drive\registry.txt \\shared_drive\projs\OptimTee.aedt

This requests four cores to come from the same machine as multiprocessing requires cores to be on the same machine

Distributed Analysis and Multiprocessing in the Same Job

Distributed processing using four engines and multiprocessing using four cores, using a total of sixteen cores

bsub -n 16 -R "span[ptile=4]" c:Program Files\AnsysEM\v242\win64\ansysedt.exe -ng

-BatchSolve -Distributed -machinelist num=4

-batchoptions \\shared_drive\registry.txt

\\shared_drive\projs\OptimTee.aedt