Supercomputing Networking Research Education Ohio Supercomputer Center Site Map Staff Directory Support
Supercomputing image

ANSYS

Introduction

ANSYS is an engineering package and support routine for general-purpose, finite-element analysis: statics, mode frequency, stability analysis, heat transfer, magnetostatics, coupled field analysis, and modeling. ANSYS was developed and is supported by ANSYS, Inc.

Academic Use
OSC has an "Academic Teaching Advanced " license for ANSYS. This permits academic use of the software by Ohio faculty and students and has some node and element restrictions. For academic users not on the OSU campus, OSC must pay an additional fee to Ansys to validate their use. For this reason, such new users must have their department chairperson confirm their requirement for ANSYS. Users should already know how to use ANSYS.

Version

Version 11.0 is currently available at OSC.

Availability

ANSYS is available on the Glenn Cluster, the Itanium 2 Cluster, the BALE Cluster and the Altix.

Usage

Use of ANSYS for academic purposes requires validation. To obtain validation please complete and return "Academic Agreement to Use ANSYS." This can be obtained from your site consultant or from the files ansys.pdf, ansys.ps, or ansys.txt located in the Academic Agreement Forms.

ANSYS supports X11 Windows and 3-D devices. PostScript and HP-GL output are available through the DISPLAY program.

Usage: General

ANSYS can only be run on OSC systems, but it can be run in interactive mode or in batch mode. Interactive mode is similar to running ANSYS on a desktop machine in that the graphical user interface will be sent from OSC and displayed on the local machine. Batch mode means that you will submit the ANSYS job to be run at a later time by providing all of the ANSYS menu commands needed to run the simulation asynchronously.

Interactive jobs are run on the login machine of the cluster, and are limited to approimately 1gb of memory and 1 hour of CPU time. Batch jobs can request days of computing time, up to the limits of the individual systems, which can be found in the computing pages. Batch jobs run on on eof th ecompute nodes of the system and not on the login node.

The intention is that users can run ANSYS interactively for the purpose of building their model and preparing their input file. Once developed this input file can then be run in batch mode

The ANSYS commands are placed in your execution path with a module load command. ANSYS is normally started by typing the version specific command, e.g. ansys110. For convenience, OSC has created a symbolic link from the name ansys to the actual command (e.g. ansys110). The ANSYS utility programs (see below) are located in the same path.

module load ansys

Following a successful loading of a version of ANSYS, you simply use the ansys command:

ansys <switch options> <file>

The ansys command takes a number of Unix-style switches and parameters.

The -j Switch

The ansys command accepts a -j switch. It specifies the "job id," which determines the naming of output files. The default is the name of the input file.

The -d Switch

The ansys command accepts a -d switch. It specifies the device type. The value can be X11, x11, X11C, x11c, or 3D.

The -m Switch

The ansys command accepts a -m switch. It specifies the amount of working storage obtained from the system. The units are megawords.

The memory requirement for the entire execution will be approximately 5300000 words more than the -m specification. This is calculated for you if you use ansnqs to construct an NQS request.

The -b [nolist] Switch

The ansys command accepts a -b switch. It specifies that no user input is expected (batch execution).

The -s [noread] Switch

The ansys command accepts a -s switch. By default, the start-up file is read during an interactive session and not read during batch execution. These defaults may be changed with the -s command line argument. The noread option of the -s argument specifies that the start-up file is not to be read, even during an interactive session. Conversely, the -s argument with the -b batch argument forces the reading of the start-up file during batch execution.

The -g [off] Switch

The ansys command accepts a -g switch. It specifies that the ANSYS graphical user interface started automatically.

ANSYS parameters

ANSYS parameters may be assigned values on the ansys command. The parameter must be at least two characters long and must be a legal parameter name. The ANSYS parameter that is to be assigned a value should be given on the command line with a preceding dash (-), a space immediately after, and the value immediately after the space:

module load ansys
ansys -pval1 -10.2 -EEE .1e6
sets pval1 to -10.2 and EEE to 100000

Unix Interactive, ANSYS Interactive

To run ANSYS interactively enter: ansys

To run ANSYS non-interactively, enter: ansys -g off <ansys.in >ansys.out

Sample Batch Script

For a given model, preparing the input file has resulted in the following commands neededing to be run once within ANSYS:

RESUME    		      
/PREP7    		      
D,30557,VOLT,1    		      
FINISH    		      
/SOLU    		      
/STATUS,SOLU   		      
SOLVE    		      
Y   		      
FINISH    		      
/POST1   		      
SET,FIRST   		      
PRNSOL,DOF,   		      
CONTINUOUS   		      
FINISH   		      
/EXIT,NOSAV 

These commands can be put in a file called ansys.in.

Assume that it is known that this solution will take approximately 20 hours. To include some margin of error, 30 hours will be requested. This is a serial applicaiton, so only 1 processor is needed. The corresponding batch script would look like:

#PBS -N ansys_test  
#PBS -l walltime=30:00:00  
#PBS -l nodes=1:ppn=1  
#PBS -j oe    
cd $TMPDIR  
cp $PBS_O_WORKDIR/* .    
module load ansys  
ansys < ansys.in   
cp * $PBS_O_WORKDIR

If the above script is saved in the file submit_ansys.job, then the job would be submitted with the command:

qsub submit_ansys.job

Information on how to monitor the job can be found in the computing environments section.

Documentation

Online help is available from the graphical user interface (ansys -g).

A number of example input files are provided by the vendor. These are located in the directory /usr/local/ansys/11.0/v110/ansys/data/verif.