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 Multi-Processing 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
User is 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
Multi-processing job using 4 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 4 cores to come from the same machine, as multi-processing needs cores to be on the same machine
Distributed Analysis and Multi-Processing in the Same Job
Distributed-processing using 4 engines and multi-processing using 4 cores, using a total of 16 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