Updated 2022-06-24

Abaqus

Batch Mode: Run Abaqus on the Cluster

Overview

  • Abaqus is a licensed simulation software that provides for "both the modeling and analysis of mechanical components and assemblies (pre-processing) and visualizing the finite element analysis result" Source: Wiki.
  • This guide will focus on two parts of Abaqus:
    • Submitting a simulation in batch mode
    • Opening the results in Abaqus (interactively)
  • This guide focuses on the batch (non-interactive) part, for the interactive part see the Abaqus interactive guide below

Important

Running Abaqus uses up licenses

  • In the PBS script, load Abaqaus with module load <abaqus version>. Find available versions with module avail abaqus
  • Make sure you use the interactive option in the computation portion of the PBS script. For example, to run Abaqus on an input file called abaqus_demo.inp, use the line:
  • abaqus job=abaqus_demo input=abaqus_demo.inp cpus=<#ofCpus> interactive
  • Running in Parallel: if using multiple cores, add the option cpus=x, and make sure x is the number of total cores you requested in the top (directives) part of the PBS script

Walkthrough: Run Abaqus on the Cluster

  • This walkthrough will use a simple abaqus input file, abaqus_demo.inp. Credit for the input script goes to Tennessee Tech.
  • Input Script (abaqus_demo.inp) can be found here
  • PBS Script (abaqus.pbs) can be found here
  • After logging in, You can transfer the files to your account on the cluster to follow along. The file transfer guide may be helpful.

Part 1: The PBS Script

#PBS -N abaqus_demo
#PBS -A <charge-account>   # starts with "p-" or "GT-"
#PBS -q inferno
#PBS -l nodes=1:ppn=4
#PBS -l pmem=2gb
#PBS -l walltime=00:30:00
#PBS -j oe
#PBS -o abaqus_demo.out

cd $PBS_O_WORKDIR

module load abaqus/2020

abaqus job=abaqus_demo input=abaqus_demo.inp cpus=4 interactive

  • The #PBS directives are standard, requesting just 30 minutes of walltime and 1 node with 4 cores. More on #PBS directives can be found in the PBS guide
    • $PBS_O_WORKDIR is simply a variable that represents the directory you submit the PBS script from. Make sure the .inp abaqus script you want to run (in this case, abaqus_demo.inp) is in the same directory you put the PBS script.
  • module load abaqus/2020 loads the 2020 version of Abaqus. To see what Abaqus versions are available, run module avail abaqus
  • The last line runs abaqus. Make sure you include the interactive option
  • For multiple cpus (parallel) use the cpus= flag. Make sure it is equal to the number of cores you requested in the #PBS directives part of the script.

Part 2: Submit Job and Check Status

  • Be sure to change to the directory that contains the PBS Script
  • qsub abaqus.pbs
  • Check job status with qstat -t <jobid>, replacing the number with the job id returned after running qsub
  • You can delete the job with qdel <jobid> , again replacing the number with the jobid returned after running qsub

Part 3: Collecting Results

  • In the directory where you submitted the PBS script, you should see all the generated output files, such as the abaqus_demo.dat and abaqus_demo.odb files. Use cat abaqus_demo.out to view information on the completed job, which should like:
---------------------------------------
Begin PBS Prologue Thu Jun 23 15:47:13 EDT 2022
Job ID:     4650913.sched-torque.pace.gatech.edu
User ID:    rrahaman6
Job name:   abaqus_demo
Queue:      inferno
End PBS Prologue Thu Jun 23 15:47:13 EDT 2022
---------------------------------------
Unloading mvapich2 module to avoid internal conflict with Abaqus.
Please report Abaqus license server issues to coe-software@coe.gatech.edu.
OIT-ART PACE does not maintain this license server directly.
For software issues not related to the license server, please contact PACE
support at pace-support@oit.gatech.edu
Analysis initiated from SIMULIA established products
Abaqus JOB abaqus_demo
Abaqus 2020
Abaqus License Manager checked out the following licenses:
Abaqus/Foundation checked out 5 tokens from Flexnet server abaquslic.ecs.gatech.edu.
<1425 out of 1631 licenses remain available>.
Begin Analysis Input File Processor
Thu 23 Jun 2022 03:47:16 PM EDT
Run pre
Thu 23 Jun 2022 03:47:17 PM EDT
End Analysis Input File Processor
Begin Abaqus/Standard Analysis
Thu 23 Jun 2022 03:47:17 PM EDT
Run standard
Thu 23 Jun 2022 03:47:18 PM EDT
End Abaqus/Standard Analysis
Begin SIM Wrap-up
Thu 23 Jun 2022 03:47:18 PM EDT
Run SMASimUtility
Thu 23 Jun 2022 03:47:18 PM EDT
End SIM Wrap-up
Abaqus JOB abaqus_demo COMPLETED
---------------------------------------
Begin PBS Epilogue Thu Jun 23 15:47:18 EDT 2022
Job ID:     4650913.sched-torque.pace.gatech.edu
User ID:    rrahaman6
Job name:   abaqus_demo
Resources:  nodes=1:ppn=4,pmem=2gb,walltime=00:30:00,neednodes=1:ppn=4
Rsrc Used:  cput=00:00:03,vmem=0kb,walltime=00:00:05,mem=0kb,energy_used=0
Queue:      inferno
Nodes:
atl1-1-02-010-17-r.pace.gatech.edu
End PBS Epilogue Thu Jun 23 15:47:18 EDT 2022
---------------------------------------

  • After the result files are produced, you can move the files off the cluster, refer to the file transfer guide for help.
  • Congratulations! You successfully ran an abaqus input file on the cluster.

Running Abaqus CAE Python

Users that need to run Python scripts that use import abaqus using Abaqus CAE can do it using the following template:

#!/bin/bash
#PBS -N abaqus_python       # job name
#PBS -l nodes=1:ppn=8       # number of nodes and cores per node required
#PBS -l pmem=2gb            # memory per task
#PBS -l walltime=10:00:00   # duration of the job
#PBS -q inferno         # queue name (where job is submitted)
#PBS -j oe                  # combine output and error messages into 1 file
#PBS -o abaqus_python..out  # output file name
#PBS -m abe                 # event notification, set to email on start, end, or fail

cd $PBS_O_WORKDIR
echo "Started on `/bin/hostname`"
module load abaqus/2020
# user supplies their own script
abaqus cae noGUI=user_python_script.py

Run Abaqus Interactively

Overview

  • After you have run the above abaqus solver on an input file, you can view the results interactively.
  • This guide will focus on running this interactive side of Abaqus on the cluster

Set up Interactive (VNC) Session

  • Please see the VNC guide for instructions on how to set up the Interactive VNC session

Start Abaqus on VNC

  • Open terminal in the vnc window by clicking top left Applications > System Tools > scroll down to terminal
  • All commands here on will be typed in terminal in VNC
  • To see available versions of Abaqus run
module avail abaqus
  • Load abaqus module and start abaqus
module load <version of abaqus>  #example: module load abaqus/2020
  • To start abaqus, run abaqus cae

Screenshot

Opening Output Files

  • Simply click File --> open to open whatever files you wish.
  • Here is the example opening the abaqus_demo.odb file from the abaqus batch job