Mastan Tutorial
Mastan Tutorial
version 1.0
Developed by:
Ronald D. Ziemian
Associate Professor of Civil Engineering
Bucknell University
William McGuire
Professor of Civil Engineering, Emeritus
Cornell University
MATLAB is a registered trademark of The MathWorks, Inc., 3 Apple Hill Drive, Natick, MA 01760-2098.
Getting Started
Two versions of MASTAN2 have been provided on your CD-ROM. The difference between these
versions is that one requires the user to have access to MATLAB from their computer and the other does
not. If MATLAB is available on your computer, Method 1 is recommended for starting MASTAN2.
Method 1 (Users who have access to MATLAB): Copy the appropriate MASTAN2 folder from your CD
to your computer (see installation instructions). Start the MATLAB program. From the MATLAB
Command Window select File and then Set Path. From the Path Browser window click on the
Browse button and set the Current Directory to the location of the MASTAN2 folder. Select File-
Exit to exit the Path Browser. To avoid having to do this each time you start the MATLAB program,
you can use the Add to Path. option located in the Path menu of the Path Browser window. This can
add the MASTAN2 directory to your MATLAB path settings. After using either of these procedures,
type mastan2 (only lower case letters with no spaces) at the MATLAB command line prompt >> and the
MASTAN2 graphical user interface (GUI) should start. If the GUI does not start, and you get the
message ??? Undefined function or variable 'mastan2, you have not properly set the current directory
or path to point to your MASTAN2 folder.
Method 2 (PC-Users who do not have access to MATLAB): A version of MASTAN2 that runs from the
MATLAB Runtime Server is also included on your CD. Copy the folder labeled MASTAN2 from your
CD to your computer. Locate this folder on your computers hard drive and start the application by
double clicking on the matlab or matlab.exe icon. Note that this version provides all the same
functionality except you cannot prepare user defined code that will interact with MASTAN2.
Window Layout
Pull-down menus
Overview:
In order to minimize the learning
time for MASTAN2, its graphical
user interface (GUI) has been
designed using a simple and
consistent two menu approach.
Using a pull-down menu at the top
of the GUI, a command is selected.
Main model window
Parameters are then defined in the
bottom menu bar and the command
is executed by using the Apply
button.
Geometry definition
Columns: W10x45
24-0
A = 13.3 in2
I = 248 in4
Z = 54.9 in3
Girders: W27x84
A = 24.8 in2
I = 2850 in4 20-0 40-0
Z = 244 in3
All members: A36 Steel
E = 29,000 ksi
y = 36 ksi
Geometry Definition
Notes:
a. Edit boxes will accept math expressions. For example, typing 24*12 is the
same as typing 240. In all cases, only one value may be executed in any edit
box.
b. A three dimensional structure is defined by providing the number of frames (a
value greater than 1) and the appropriate spacing.
Geometry Definition (cont.)
Notes:
1. MASTAN2 will work for any consistent set of units. In this
example all force units are in kips and all length units are in
inches.
2. Similar to section properties, properties for more than one material
can be defined and assigned to different elements.
Loads and Support Conditions
Notes:
1. Red arrows indicate the degrees of freedom at a node that are
restrained.
2. MASTAN2 provides the opportunity to analyze structures as two
or three dimensional. For two dimensional analyses, only degrees
of freedom in the x-y plane need to be restrained. On a related
topic, additional section properties would be needed to analyze
this system as three-dimensional.
Loads and Support Cond. (cont.)
Part II: Loads
1. From the Conditions menu select Define Forces.
2. At the bottom menu bar, click in the edit box just to the right of PX = and
change the 0 to 32.
3. Create the list of nodes to be assigned this force by clicking on the upper left
node of the model. Click on the Apply button.
4. Click in the edit box just to the right of PX = and change the 32 to 0 and
then click in the edit box just to the right of PY = and change the 0 to -320.
5. Create the list of nodes to be assigned this force by first clearing the node list
by clicking on the Clr button and then clicking on the node at the top of the
center column. Click on the Apply button.
6. Repeat steps 4 and 5 using PY = -160 and applying this force to the upper
right node of the model. From the View menu select Fit. MASTAN2
Notes:
1. To remove a support or load condition from a node or group of nodes, first
create the node list and then with all conditions blank or zero, click on Apply.
2. Green arrows represent applied forces.
3. The conditions at a node may be checked with
Geometry-Information-Node.
First-Order Elastic Analysis
1. From the Analysis menu select 1st-Order Elastic.
2. At the bottom menu bar, click on the pop-up menu just to the right of
Analysis Type: and select Planar Frame (x-y).
3. Click on the Apply button to perform the analysis.
Although the following steps are not required for us to proceed, this is a good
time to perform them.
a. From the File menu select Define Title. At the bottom menu bar, click in
the edit box to the right of Title: and type in a brief description of this
effort. This text might include the model title, your name, and/or the
assignment number. Click on the Apply button.
b. From the File menu select Save As.... After selecting your destination
folder, type in the filename example and click Save. Note that the top of
the window has now changed to include the file name and directory as
well as the time the file was last saved. MASTAN2
Note:
Only alpha-numeric file names may be used.
Results
Note:
Information printed to the main text window will remain, even after the Cancel button
is clicked, until the Clear button is clicked. In this way, additional information such as
the results from a different analysis can be added later.
Plotting with MSAPLOT
1. To use the plotting module that is provided with MASTAN2, select
MSAPlot from the Results menu.
Part I. Axes Definition
1. From the MSAPlot Curves menu select Define X-Data.
2. At the center of the bottom menu bar, click on the pop-up menu and
select Displacement.
3. Click in the edit box to the right of Node # and type 4.
4. Click on the Apply button (x-axis is now defined but nothing plotted).
5. Repeat steps 1 to 4, using Define Y-Data to monitor the Applied
Force or Moment above the center column. Set Node # to 5, d.o.f. to
y (vertical force), and the scale to -1 (to plot in upper right quadrant).
Notes:
1. In MSAPlot, all node and element numbers must be typed; clicking on a node or
element in the MASTAN2 window will not automatically enter its number in a
MSAPlot menu.
2. If an error is made while using Define, redefine the parameters and select Apply.
3. By also using Define Z-Data, MSAPlot can create three-dimensional plots.
Plotting with MSAPLOT (cont.)
Part II. Generate a Curve
1. From the MSAPlot Curves menu select Generate Curve(s).
2. Click in the edit box to the right of Label and type 1st-Order Elastic (or
some other description to appear in the plots legend).
3. Click on the Apply button and the response curve is drawn. MASTAN2
Part III. Plot Attributes
1. From the Axes menu select Plot Title.
2. At the bottom menu bar, click on edit box and enter a title.
3. Click on the Apply button.
4. From the Axes menu select X-Attributes.
5. Click on the edit box to the right of Label and change X to Lateral
Displacement (in.). Click on the edit box to the right of Max: and type 5.
6. Click on the Apply button.
7. Repeat steps 4 to 6, using Y-Attributes to define the y-label as P (kips) and
increasing the number of Divisions to 8. MASTAN2
Note:
The legend can be dragged to anywhere on the screen by clicking on
it and holding the mouse button down to move it.
Other Methods of Analysis
MASTAN2 provides six different methods of analysis. These will be illustrated
by using the current example problem and plotted results.
Part I. Second-order Elastic
1. From the MASTAN2 Analysis menu select 2nd-Order Elastic.
2. At the bottom menu bar, click on the pop-up menu just to the right of
Analysis Type: and select Planar Frame (x-y).
3. Click on the Apply button to perform the analysis.
4. From the Results menu select MSAPlot.
5. From the MSAPlot Curves menu select Generate Curve(s).
6. At the bottom menu bar, click in the edit box to the right of Label and type
2nd-Order Elastic.
7. Click on the pop-up menu just to the right of Color and select red.
8. Click on the Apply button and the response curve is added to the plot.
Notes:
MASTAN2
1. Steps 4 to 8 assume that the x- and y-data plot parameters were defined as
previously described.
2. Diagrams, specific node and element results, and reports can be
generated for all methods of analysis in the same manner as
they were for the first-order elastic analysis.
Other Methods of Analysis (cont.)
Part II. First-order Inelastic
1. From the MASTAN2 Analysis menu select 1st-Order Inelastic.
2. At the bottom menu bar, click on the pop-up menu just to the right of
Analysis Type: and select Planar Frame (x-y).
3. Click on the edit box to the right of Max # of Incrs: and change the 10
to 20. The analysis will stop when either excessive deflections are
detected or 20 load increments are applied or a maximum applied load
ratio (Max. Appl. Ratio) of 1.0 is reached.
4. Click on the Apply button to perform the analysis. Note the analysis
stops as a result of Excessive Deflections (most likely indicating the
formation of a mechanism). Click on No to discontinue the analysis.
5. Note that the analysis stopped after 14 load increments. Click on the
pop-up menu just to the left of Apply and select Continue Prev.
6. Click on the edit box to the right of Max # of Incrs: and change 20 to
15. This will let the analysis run for one additonal increment.
MASTAN2 Menus:
MSAPlot Menus:
Save
Write a MASTAN2 file to disk
Save As
New Clear existing model and all attributes
Define Title
Print Photo ... Provide a model description
Create Report ...
Print a photo of the current window
Quit
Write a text report
Exit MASTAN2
MASTAN2: View
Exit MSAPlot
MSAPlot: View
View
Rotate view of plot about an axis
Rotate
Select a pre-defined view
Defined Views !
Labels !
Turn on and off visual plot entities such as
Display Settings grids, axes, and legend
Axes
Provide a title that is located at the top of the plot
Plot Title
X-Attributes Define X-, Y-, or Z- axes attributes such as label,
Y-Attributes number of tick marks, and minimum/maximum
Z-Attributes limits
Curves
Define the response data that should be plotted on
Define X-Data the X-, Y-, or Z- axis
Define Y-Data
Define Z-Data Using the data-to-axis relationships defined in the
above and the curve graphical attributes prescribed
Generate Curve(s) in this option, generate a two- or three-dimensional
Modify Curve(s) response curve
Erase Curve(s) Change an existing curves graphical attributes
such as label, color, style, and line weight
Good Luck !
Additional Information
Additional information and updates for MASTAN2
may be provided in a homepage located at the
following URL:
http://www.wiley.com/college/engin/McGuire
MASTAN2
Developed by: Version 1.0
Ronald D. Ziemian
Associate Professor of Civil Engineering
Bucknell University
William McGuire
Professor of Civil Engineering, Emeritus
Cornell University
Copyright 2000
R.D. Ziemian and
W. McGuire
All rights reserved.