22.2.1. Running Autodyn using the AUTODYNWRAPPER

Autodyn can be executed from the operating system command line by using the AUTODYNWRAPPER.

The following command can be used to run Autodyn from the command line, using the AUTODYNWRAPPER, which accepts a number of command line arguments:

<installation path>/v242/Tools/mono/Linux64/bin/mono <installation path>/v242/autodyn/bin/AUTODYNWRAPPER.exe -i ./admodel_0.ad

The following table describes the command line arguments that can be used to control Autodyn file operations and execution behavior at start-up.

Argument

Operation Type

Operation

-i "<Autodyn model file>"

Batch (Serial\Parallel)

<Autodyn model file> is the name of the model file (including the path, if necessary). Using this option will run Autodyn in batch mode.

-beta

 

When running in batch mode, the model will run without beta options by default. Specifying this option will enable the model to run with beta features on.

-np <number of worker processes>

Batch (Parallel)

<number of worker processes> must be an integer that indicates the number of worker processes that will be used for the simulation. This option will have no effect on models that do not have the parallel options turned on.

-mpi <mpi type>

Batch (Parallel)

<mpi type> must be either intelmpi, intelmpi2018, or openmpi.

intelmpi will run with the default version of Intel MPI (currently 2021.11) which is provided in the Ansys Install. intelmpi2018 will run with Intel MPI version 2018.3.222 which is also provided with the Ansys Install. openmpi runs with Open MPI.

-machines "<machine name>"

Batch (Distributed Parallel)

<machine name> must be a string containing a list of node names (computer names) that will be used to run the worker executables, and the number of worker processes that will be run on each machine. The master executable is run on the local machine (which is called the head node) by default. The string should be constructed with a machine name followed by a colon followed by the number of workers to be run on the machine. Multiple node definitions should be separated by commas; for example "MachineA:2,MachineB:3".


Note:  When running a model with the AUTODYNWRAPPER using MPI parallel, it is assumed that the MPI files used are those included with the Ansys installation. It is possible to specify a different location for the MPI files by setting an environment variable:

  • For Intel MPI, the I_MPI_ROOT environment variable can be set; for example:

    setenv I_MPI_ROOT /opt/intel/compilers_and_libraries_2019.3.199/linux/mpi/intel64
  • For Open MPI, the OPAL_PREFIX environment variable can be set; for example:

    setenv OPAL_PREFIX <install dir>/tp/MPI/OpenMPI/4.0.5/linx64/

When running in batch mode, it is possible to request the creation of a save file and to stop the solve process before the end of the run by placing data files in the data directory where the model input and output files are located.

Putting an empty file named endbat.dat in the data folder will cause a simulation to stop at the end of the current cycle. Once stopped, Autodyn will delete the endbat.dat file.

Putting an empty file named savenow.dat in the data folder will force the simulation to write a restart file at the end of the current cycle. Once the restart file has been written out, Autodyn will delete the savenow.dat file and it must be re-created to write out a new restart file.