Professional Documents
Culture Documents
This workbook is designed for use in Live instructor-led training and for OnDemand self-study. The explanations
and demonstrations are provided by the instructor in the classroom, or in the OnDemand eLectures of this course
available on the Bentley LEARNserver (learn.bentley.com).
This practice workbook is formatted for on-screen viewing using a PDF reader. It is also available as a PDF
document in the dataset for this course.
TRNC 02961-1/0001
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 1
Description and Objectives
Course Description
In this workbook, we will learn the fundamental skills to perform a collapse analysis using seismic results.
Skills Taught
Dynamic Response Input: Define the dynamic response input file to generate equivalent static loads for collapse analysis.
Dynamic Response Analysis: Perform an earthquake analysis with the dynamic response input.
Collapse Input: Define a collapse input file using the equivalent static loads as the load sequence.
Dynamic Response Input: Define the dynamic response input file to generate collapse input.
Collapse Input: Define a collapse input file using the dynamic response analysis as the load sequence.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 2
Creating the Spectral Collapse Analysis Directory
In this section, we will create the time history collapse analysis directory.
Create the directory for the time history collapse analysis: Spectral Collapse
Copy dynmod.dat, dynmas.dat, seainp.dat, and sacinp.dat from the reference analysis files directory provided with this training and paste them in the
current work directory.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 3
Create the Dynamic Response Input File
In this section, we will create the dynamic response input file to define the dynamic response options, the load case output options and the time history load
case input.
1. Launch the Datagen program by clicking on Modeler icon in the Interactive window of SACS Executive.
Click on the Create New Data File radio button in the Data Generator Dialog. Click OK.
Click on the Dynamic tab in the Select File Type dialog and select Spectral Earthquake Input File option. Click OK.
First, we will define the general dynamic response program options. This line will define the dynamic response analysis type as a base driven spectral
analysis, determine the number of modes used for the analysis and some general geometric parameters for the model. Go to Home > Tools > Insert
Input Line in the menu bar and select DROPT.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 4
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 5
Enter the following options in the Line Assistant:
Vertical Coordinate: +Z
Note: If input for an option is not specified. The value should be left blank and SACS will use the default option.
Structural damping is required for a dynamic response analysis. We will now define the structural damping using the SDAMP line. Go to Home > Tools >
Insert Input Line in the menu bar and select SDAMP. Enter the following options:
We need to tell SACS that the dynamic response analysis should generate equivalent static loads and there are a few options that need to be defined as
well. Go to Home > Tools > Insert Input Line in the menu bar and select EQKLOD. Enter the following options:
Load Type: BS
We can now enter the spectral load data to the input file. First, we will need to add a load header line to indicate the load data for SACS. Go to Home >
Tools > Insert Input Line in the menu bar and select LOAD.
There are a variety of ways to enter spectral loads into SACS dynamic response. In this example, we will be using a API spectral analysis load. Go to
Home > Tools > Insert Input Line in the menu bar and select SPLAPI. Enter the following options:
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 6
Y-Direction Soil Type: B
Finally, enter END at the end of the file to indicate that the input file is complete.
Go to File > Save As in the menu bar and save the file as dyrinp.dat in the current working directory.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 7
Creating the Spectral Earthquake Analysis Run File.
In this section, we will create the spectral earthquake analysis run file and run the analysis. In the current directory, there should be four input files: dynmas.dat
containing the dynamic mass matrix information, dynmod.dat containing the dynamic mode shape information, sacinp.dat containing the model information,
and dyrinp.dat containing the dynamic response options and spectral earthquake input information.
Earthquake Options
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 8
The analysis generator settings shall look like following:
Click Run Analysis to run the analysis. A SACS OCI file dyroci.eqksp should be generate containing the equivalent static loads with the maximum base
shear from the spectral earthquake analysis.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 9
Create the Collapse Input File
The spectral earthquake analysis generates an OCI file with the maximum base shear, but we need to tell collapse to use that load as our pushover load case.
In this section, we will create the collapse input file for the collapse analysis.
1. Launch the Datagen program by clicking on Modeler icon in the Interactive window of SACS Executive.
Click on the Create New Data File radio button in the Data Generator Dialog. Click OK.
Click on the Static tab in the Select File Type dialog and select Collapse Input File option. Click OK.
First, we will define the general collapse program options. These options are mainly related to the non-linear convergence criteria (e.g. number of
iterations and convergence tolerances) and general behavior of the structure (e.g. joint flexibility, member elasticity, local buckling effects, etc.). Go to
Home > Tools > Insert Input Line in the menu bar and select CLPOPT.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 10
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 11
For this exercise, we will mostly be using default convergence criteria which can be found on the CLPOPT line in the Collapse manual. Enter the following
options in the Line Assistant:
Include Sub-Incrementation: No
Note: If input for an option is not specified. The value should be left blank and SACS will use the default option.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 12
Next, we will define the load sequence and enter the gravity loading as the first load cases in the sequence. Go to Home > Tools > Insert Input Line in
the menu bar and select LDSEQ. Enter the following options:
Number of Increments: 1
Number of Increments: 1
Number of Increments: 1
We still need to define the seismic load as part of our load sequence. Go to Home > Tools > Insert Input Line in the menu bar and select LDSEQ. Enter
the following options:
Finally, enter END at the end of the file to indicate that the input file is complete.
Go to File > Save As in the menu bar and save the file as clpinp.spclp in the current working directory.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 13
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 14
Creating the Collapse Analysis Run File.
In this section, we will create the collapse analysis run file and run the analysis. In the current directory, there should be three input files: dyroci.eqksp containing
the model information and seismic equivalent static load, seainp.dat containing the gravity load case information, and clpinpt.spclp containing the collapse
options and load sequence information.
Solve Options
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 15
The analysis generator settings shall look like following:
Click Run Analysis to run the analysis. A new window Analysis Output should appear showing some key information from the collapse analysis. The table
includes the solve number (NSLV); the load case, increment, and loop; the critical deflection and rotation information and the deflection difference used for
convergence. This table is useful for troubleshooting various convergence errors that may be occurring during the course of the analysis.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 16
Creating the Time History Collapse Analysis Directory
In this section, we will create the time history collapse analysis directory.
Create the directory for the time history collapse analysis: Time History Collapse
Copy dynmod.dat, dynmas.dat, dyrthi.elcentro, seainp.dat, and sacinp.dat from the reference analysis files directory provided with this training and
paste them in the current work directory.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 17
Create the Dynamic Response Input File
In this section, we will create the dynamic response input file to define the dynamic response options, the load case output options and the time history load
case input.
1. Launch the Datagen program by clicking on Modeler icon in the Interactive window of SACS Executive.
Click on the Create New Data File radio button in the Data Generator Dialog. Click OK.
Click on the Dynamic tab in the Select File Type dialog and select Time History Earthquake Input File option. Click OK.
First, we will define the general dynamic response program options. This line will define the dynamic response analysis type as a base driven time history
analysis, determine the number of modes used for the analysis and some general geometric parameters for the model. Go to Home > Tools > Insert
Input Line in the menu bar and select DROPT.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 18
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 19
Enter the following options in the Line Assistant:
Vertical Coordinate: +Z
Note: If input for an option is not specified. The value should be left blank and SACS will use the default option.
Structural damping is required for a dynamic response analysis. We will now define the structural damping using the SDAMP line. Go to Home > Tools >
Insert Input Line in the menu bar and select SDAMP. Enter the following options:
We can now enter the time history load data to the input file. First, we will need to add a load header line to indicate the load data for SACS. Go to Home >
Tools > Insert Input Line in the menu bar and select LOAD.
There are a variety of ways to enter time history loads into SACS dynamic response. In this example, we will be using a separate time history input file.
We will also need to convert each time step into a load case for the collapse analysis and create a collapse input file with each load step included as part
of the load sequence. We can define the time history source and tell SACS to automatically generate the SACS OCI file and collapse input file using the
THLOAD line. Go to Home > Tools > Insert Input Line in the menu bar and select THLOAD. Enter the following options:
Note: Additional charts and reports may be generated using selection input but will not be utilized in this example.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 20
We need to define the time integration controls for the time history input. This will determine the length of time, time interval for each time step and the
minimum integration time step. Go to Home > Tools > Insert Input Line in the menu bar and select TIME. Enter the following options:
Finally, enter END at the end of the file to indicate that the input file is complete.
Go to File > Save As in the menu bar and save the file as dyrinp.dat in the current working directory.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 21
Create the Collapse Input File
The time history seismic collapse analysis will automatically generate a collapse input file, but we need to define some of the collapse options and initial load
sequence parameters in a partial input file. In this section, we will create the collapse input file for the dynamic response analysis.
1. Launch the Datagen program by clicking on Modeler icon in the Interactive window of SACS Executive.
Click on the Create New Data File radio button in the Data Generator Dialog. Click OK.
Click on the Static tab in the Select File Type dialog and select Collapse Input File option. Click OK.
First, we will define the general collapse program options. These options are mainly related to the non-linear convergence criteria (e.g. number of
iterations and convergence tolerances) and general behavior of the structure (e.g. joint flexibility, member elasticity, local buckling effects, etc.). Go to
Home > Tools > Insert Input Line in the menu bar and select CLPOPT.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 22
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 23
For this exercise, we will mostly be using default convergence criteria which can be found on the CLPOPT line in the Collapse manual. Enter the following
options in the Line Assistant:
Include Sub-Incrementation: No
Note: If input for an option is not specified. The value should be left blank and SACS will use the default option.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 24
Next, we will define the load sequence and enter the gravity loading as the first load case in the sequence. Go to Home > Tools > Insert Input Line in the
menu bar and select LDAPL. Enter the following options:
Number of Increments: 5
Finally, enter END at the end of the file to indicate that the input file is complete.
Go to File > Save As in the menu bar and save the file as clpinp.thclp in the current working directory.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 25
Creating the Time History Collapse Analysis Run File.
In this section, we will create the time history collapse analysis run file and run the analysis. In the current directory, there should be seven input files: dynmas.dat
containing the dynamic mass matrix information, dynmod.dat containing the dynamic mode shape information, sacinp.dat containing the model information,
seainp.dat containing the load case information, dyrthi.elcentro containing the time history accelerations, clpinp.dat containing the collapse options and load
sequence and dyrinp.dat containing the dynamic response options and time history input information.
Solve Options
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 26
Time History Input File: dyrthi.elcentro
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 27
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 28
Click Run Analysis to run the analysis. A new window Analysis Output should appear showing some key information from the collapse analysis. The table
includes the solve number (NSLV); the load case, increment, and loop; the critical deflection and rotation information and the deflection difference used for
convergence. This table is useful for troubleshooting various convergence errors that may be occurring during the course of the analysis.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 29
Check the Analysis Results
In this section, we will review any warnings or errors that appear in the error log and check some key data in the dynamic response listing file.
1. After the analysis finishes, check the Error Log in SACS Executive to make sure that there is no error message reported. You should get a couple of
maximum iteration warnings and warnings regarding the structural collapse.
Open the dynamic response listing file in the Files tab in SACS Executive by double-clicking on the file. You can search for a number of reports that were
specified on the CLPRPT line here. You can also search for PLASTICITY to find which members yield and at what load step. This can be useful for finding
view later in collapse view.
*** PLASTICITY OCCURRED ON MEMBER 838- 807 AT LOAD STEP 21
Note: You can search WARNING, ERROR, and INFO in your text editor to find the logged information in the listing file.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 30
The collapse solution summary can be found towards the end of the file. It contains the same information that was displayed in the Analysis Output
window.
*************** COLLAPSE SOLUTION SUMMARY ***************
LOAD SEQUENCE 1
LOAD LOAD NO. * MAXIMUM DEFLECTION * ** MAXIMUM ROTATION ** ** SOLUTION DATA ** *** REACTION SUMMATION ***
INCR CASE FACTOR LOOPS DEFL. JOINT DOF ROT. JOINT DOF MAX. JOINT DOF FX FY FZ
1 EQKS 0.20 1 -0.366 830 DZ 0.0017846 838 RX 2 836 DY 0.00 0.00 321.78
2 EQKS 0.40 1 -0.733 830 DZ 0.0035697 838 RX 2 836 DY 0.00 0.00 643.56
3 EQKS 0.60 1 -1.100 830 DZ 0.0053546 838 RX 2 836 DY 0.00 0.00 965.34
4 EQKS 0.80 1 -1.468 830 DZ 0.0071386 838 RX 2 836 DY 0.00 0.00 1287.12
5 EQKS 1.00 1 -1.837 830 DZ 0.0089211 838 RX 2 836 DY 0.00 0.00 1608.90
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 31
Also, since the joint strength check option is selected, a joint failure summary report is included in the dynamic response listing file.
****************** JOINT FAILURE SUMMARY REPORT ******************
LOAD SEQUENCE 1
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 32
Check the Analysis Results Using Collapse View
In this section, we will review view some results in the collapse restart file using collapse view.
1. The dynamic response listing file is quite useful for quickly accessing a lot of data and diagnosing and potential modeling or convergence errors that might
have occurred, but collapse view provides a great way to visualize the results and generate additional reports and graphs. Double-click on the collapse
restart file, clprst.dat in the Files tab in SACS Executive to open it in collapse view. You should see something like this:
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 33
The first thing that we typically want to view in collapse view is the deflected shape with plasticity. Select Load Step > General > Last to display the final
load step where the structure collapses. You can use the other buttons under Load Step > General to navigate to other load steps.
Note: Sometimes the final load step may show some odd geometries with members disconnected and deformed in unnatural positions. Keep in mind that
the collapse analysis only will stop after the deflection criteria is met which may require a sudden collapse of the structure. The prior load step is
usually more beneficial for illustrative purposes in these cases.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 34
We can also animate the loads sequence selecting Load Step > Animation > Animate to open the Loadstep Animation dialog. Enter the following
information and click Play to start the animation:
Starting Loadstep: 30
Ending Loadstep: 37
Additional reports can be generated without the user modifying the collapse input file and rerunning the analysis. Select File > Generate Report to open
the Report Selection dialog. Select Work Done from the Report Type drop-down menu and click OK to generate a report with work done on the structure
during the pushover analysis.
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 35
We can also generate graphs using collapse view. Select Load Step > General > Graphs to open the Graph Settings and Format dialog. Select Load Step
in the X-Axis window and Base Shear in the Y-Axis window. Click Add to add the graph to the list of saved graphs. Click Show Graphs to display the
graph. You should see something like this:
Copyright © Bentley Systems, Incorporated DO NOT DISTRIBUTE – Printing for student use is permitted 36