Manuale FTOOL
Manuale FTOOL
Manuale FTOOL
November 2003
TABLE OF CONTENTS
FTOOL IN USE ....................................................................................................................................................................... 3
FTOOL AUTHORSHIP ........................................................................................................................................................... 3
GENERAL CONCEPT ............................................................................................................................................................... 3
DOWNLOADING FTOOL ....................................................................................................................................................... 4
BACKGROUND ....................................................................................................................................................................... 4
NEW FEATURES OF THE LATEST VERSION 2.11 (AUGUST 2002)........................................................................................... 5
NEW FEATURES OF VERSION 2.10 (NOVEMBER 2001).......................................................................................................... 6
NEW FEATURES OF VERSION 2.09 (JANUARY 2001) ............................................................................................................. 6
NEW FEATURES OF VERSION 2.08 (AUGUST 2000)............................................................................................................... 7
NEW FEATURES OF VERSION 2.07 (APRIL 2000)................................................................................................................... 7
NEW FEATURES OF VERSION 2.06 (FEBRUARY 2000)........................................................................................................... 8
ADDITIONAL CREDITS ........................................................................................................................................................... 8
FILE OPERATIONS............................................................................................................................................................... 9
THE FILE MENU .................................................................................................................................................................... 9
EXPORTING SCREEN DISPLAY IMAGES THROUGH THE CLIPBOARD ...................................................................................... 10
MODEL CREATION AND MANIPULATION ................................................................................................................. 11
THE EDIT TOOLBAR ............................................................................................................................................................. 11
MEMBERS AND NODES ........................................................................................................................................................ 11
CREATION OF DIMENSION LINES......................................................................................................................................... 11
KEYBOARD MODE ............................................................................................................................................................... 12
SELECTION MODE ............................................................................................................................................................... 12
UNDO AND REDO ................................................................................................................................................................. 12
THE TRANSFORM MENU ....................................................................................................................................................... 13
VISUALIZATION CONTROLS.......................................................................................................................................... 14
THE VISUALIZATION CONTROL TOOLBAR ............................................................................................................................. 14
COORDINATE CONTROL ...................................................................................................................................................... 14
THE DISPLAY MENU ............................................................................................................................................................. 15
CONFIGURATIONS ............................................................................................................................................................ 16
THE OPTIONS MENU ............................................................................................................................................................ 16
FORMATTING UNITS AND NUMBERS ................................................................................................................................... 16
UNIT SYSTEMS .................................................................................................................................................................... 17
NODE AND MEMBER ATTRIBUTES............................................................................................................................. 21
CONTROL OF NODE AND MEMBER ATTRIBUTES................................................................................................................. 21
FEATURES COMMON TO SUB-MENUS .................................................................................................................................. 21
MATERIAL P ARAMETERS .................................................................................................................................................... 22
MEMBER SECTION PROPERTIES .......................................................................................................................................... 22
SUPPORT CONDITIONS ......................................................................................................................................................... 24
CONNECTION OF MEMBER ENDS TO NODES ....................................................................................................................... 25
CONSTRAINTS ON MEMBER DEFORMATIONS ...................................................................................................................... 25
DEFINING THE APPLIED LOADS .................................................................................................................................. 26
THE LOAD CONTROL TOOLBAR ........................................................................................................................................... 26
GENERAL INFORMATION ..................................................................................................................................................... 26
NODAL LOADS..................................................................................................................................................................... 28
MOMENTS ACTING ON MEMBER ENDS ............................................................................................................................... 28
LINEAR AND UNIFORMLY DISTRIBUTED LOADS ................................................................................................................. 29
TEMPERATURE CHANGES .................................................................................................................................................... 29
RESULTS ............................................................................................................................................................................... 30
THE RESULTS TOOLBAR ....................................................................................................................................................... 30
RESULT MODES ................................................................................................................................................................... 30
SIGN CONVENTION FOR INTERNAL FORCES AND MOMENTS .............................................................................................. 31
SCALING OF DIAGRAMS AND INFLUENCE LINES ................................................................................................................. 33
NUMERICAL DISPLAY OF RESULTS ..................................................................................................................................... 34
2
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
FTOOL in Use
FTOOL Authorship
Luiz Fernando Martha
Associate Professor
Pontifical Catholic University of Rio de Janeiro (PUC-Rio)
Department of Civil Engineering and
Computer Graphics Technology Group (Tecgraf/PUC-Rio)
Rua Marquês de São Vicente, 225, Gávea
22453-900 - Rio de Janeiro, RJ - BRASIL
Phone: 55+21+3114-1190
Fax: 55+21+3114-1195
e-mail: lfm@tecgraf.puc-rio.br
URL: http://www.tecgraf.puc-rio.br/~lfm
General Concept
FTOOL is a program designed for instruction on the analysis of plane frame structures. It
fulfills a need not often explored by educational programs that usually focus on analytical
(numerical) techniques, or by the educational versions of commercial programs. The ob-
jective of FTOOL is to motivate learning of structural behavior. Educational experiences
in this area have shown that knowledge of structural behavior is essential for better un-
derstanding of the analytical methods learning process.
3
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
FTOOL provides a simple analysis program that merges, in the same interface, resources
for effective creation and manipulation of the model (pre-processing), linked to a fast and
effective code for visualization of the results (post-processing). Users of this educa-
tional version are free to apply and re-distribute the program as they wish. However,
neither the author nor the PUC-Rio University or any other related institution is responsi-
ble for the incorrect use of the program and its results. The author and PUC-Rio have no
legal responsibility for any damage caused directly or indirectly to a person or a com-
pany, resulting from the application of any information or the utilization of the program.
Users are responsible for all conclusions made through the program. There is no com-
mitment of satisfactory performance or any kind of warranty.
Downloading FTOOL
• Ftool Version 2.11 for Windows:
ftp://ftp.tecgraf.puc-rio.br/pub/users/lfm/ftool211win.zip
• Ftool Version 2.11 for Linux:
ftp://ftp.tecgraf.puc-rio.br/pub/users/lfm/ftool211linux.tgz
the available version is compatible to library glibc 2.0 for Linux and operates li-
braries of OSF Motif (http://www.openmotif.org).
• Download of this guidebook in CHM (Compiled HTML Help):
ftp://ftp.tecgraf.puc-rio.br/pub/users/lfm/ftool211pt.chm (Portuguese)
ftp://ftp.tecgraf.puc-rio.br/pub/users/lfm/ftool211en.chm (English)
• Download of this guidebook in Portuguese (PDF format):
ftp://ftp.tecgraf.puc-rio.br/pub/users/lfm/ftoolman211pt.pdf (Portuguese)
ftp://ftp.tecgraf.puc-rio.br/pub/users/lfm/ftoolman211en.pdf (English)
Background
FTOOL (Two-dimensional Frame Analysis Tool) was initially developed through an in-
tegrated research project coordinated by Professor Marcelo Gattass from the Computer
Department of PUC-Rio and leader of the Computer Graphics Technology Group
(Tecgraf/PUC-Rio). Professor Gattass received support form CNPq (National Council for
Scientific and Technologic Development). The responsiblility for the program is now
with Professor Luiz Fernando Martha from the Department of Civil Engineering of the
PUC-Rio. Graduate students Eduardo Thadeu Leite Corseuil, Vinícius Samu de Fi-
gueiredo and Adriane Cavalieri Barbosa, from Department of Civil Engineering of PUC-
Rio, contributed to the development of the program as research assistants from March of
1991 until December of 1992. The program was developed originally on a DOS platform
and went through some initial improvements until April of 1995.
4
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
from the PhD student of PUC-Rio Ivan Fábio Menezes, (currently professor of the De-
partment of Computer Science of PUC-Rio).
From 1997 to 1998, FTOOL was revised by Professor Luiz Fernando Martha, who used
the interface system IUP and the graphics system CD, both developed by Tecgraf/PUC-
Rio. This graphics interface allows the program to be executed on both Windows and
Unix. In February of 1998, version 2.00 was launched. Successive versions of FTOOL
were then introduced, each one with small improvements.
In August 2000, version 2.08 was also launched on the Linux platform. In version 2.09
(January of 2001) specific procedures for supporting instruction on structural analysis
were incorporated: inextensible and infinitely rigid members, and member end moments
loading. In the 2.10 version (November 2001) display of influence lines were added. In
the last version, version 2.11 (August, 2002), the definition of member cross-sections was
improved.
Other improvements include property attributes and the ability of FTOOL to import
model attributes from other files, option to select the member side (tension or compres-
sion) to draw bending moment diagrams, and option to draw result values transversely to
the members. Throughout its use, FTOOL has shown to be a suitable tool for engineering
instruction and has been used in Structural Analysis, Concrete Structures and Steel Struc-
tures courses of Civil Engineering in several Brazilian and overseas universities.
5
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
6
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
ter visual result. The display of internal force diagrams was also improved: in
each member, the diagram is offset by eventual hinges at the ends.
7
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
• Modified fence selection such that, when no object is selected, selection is auto-
matically geared to beam members.
Additional Credits
• The first version of this manual (for version 2.07) was created by Luis Fernando
Kaefer, PhD student of the Polytechnic School of the University of São Paulo
(EPUSP), Department of Engineering of Structures and Foundations (PEF) and
Laboratory of Computational Mechanics (LMC).
• The implementation of multiple types of transverse sections in the FTOOL was
contributed by Christiana Niskier, graduate student in Civil Engineering in PUC-
Rio.
• The update of manual for version 2.11 was contributed by Pedro Cordeiro
Marques, undergraduate student in Civil Engineering in PUC-Rio.
8
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
File Operations
The File Menu
The drop down File menu controls file operations in FTOOL.
• Show the Sign Convention for the internal processing associated with FTOOL
(Sign Convention) – see details of the sign convention in the Post-Processing sec-
tion;
• Create a new model (New);
• Open a model from an existing file on a disk (Open);
• Save the current model in a file (Save) or under a different name (Save as);
• Import properties from another FTOOL file (Import Properties);
• Export images from the screen (Export Screen) to the Windows transfer area
(Clipboard) or to files with specific formats;
• Verify the total number of members and nodes in the model (Totals);
• Establish the limit of the work window (Limits);
• Exit the program (Exit).
The Import Properties option in the File menu reads all the global parameters (units sys-
tem, visualization parameters, etc.) into the current model, as well as all the attributes
(property of materials and section tables, etc.) that exist in another file created by
FTOOL. When this option is selected the program asks the user to indicate the file to im-
port. Attribute tables can also be imported separately (see sections Node and Member At-
tributes and Defining the Applied Loads)
9
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
The most commonly used commands in the File menu are arranged in a toolbar at the top
of the screen:
• Choose the option Export Screen/Clipboard in the File menu, press the key, or
press Ctrl+C. This will copy all images on the main screen (not just what is cur-
rently selected).
• Open the program into which you want to import the image, MS-Word for exam-
ple. In MS-Word for versions NT, 2000 or XP, select option Paste in menu Edit
or press Ctrl+V. It is possible to choose the option Paste Special, then, the option
Picture. In Windows, DO NOT select the option Picture (Enhanced Metafile) –
this creates an extremely large image. For Windows, the option Picture generates
a small image that can be scaled by pressing the mouse button over one of the
corners of the selected image.
• Edit the pasted figure. In Windows 95 or 98, circles resulting from rotation or
moments might appear black when editing the figure. It has not been discovered
how to prevent this. To correct it, select the object and change the background
color to white (or to the color of the background). This problem does not occur for
Windows NT, 2000 or XP. You can make the lines thicker (1/2 pt or 3/4 pt are
good options), change the colors of lines, etc.
• If you are printing to a black and white printer, best results are obtained if the op-
tion Black and White Image is selected before exporting the image. Use the option
Black Foreground from menu Display.
10
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
For the insertion of members, nodes, or dimension lines in FTOOL, the program auto-
matically snaps the mouse cursor to an existing unit (a node or a member). The creation
process can be facilitated by enabling a Grid of points and using the Snap feature. (See
section on Visualization Controls).
In the same way, a node is created by selecting the button and clicking with the mouse
at a point within the model display area. If the clicked point is on an existing member, the
member is divided in two members with insertion of the new node.
The insertion of "lines" with the mouse for creation of members is made with two clicks:
one for the first node of the member and the next click for the second node. Usually the
creation of lines using a mouse follows the rule "press button - drag mouse – release but-
ton". The "two clicks" method used in FTOOL allows the user to stop the insertion of
members after the first point by clicking with the right mouse button or by pressing Esc
on the keyboard. This type of method also allows the user to zoom in or move the draw-
ing window after entering the first node and before entering with the second, etc.
11
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
The creation of a dimension line through the "three clicks" method allows the user to
suspend the insertion of the line before entering the final points, by clicking with the right
mouse button or by pressing Esc on the keyboard. This type of interaction also allows the
user to zoom in or to move the viewing window after entering the first point or the sec-
ond point and before entering the third.
Keyboard Mode
After selecting the button , nodes and members can be created by entering coordinates
into the pop-up box fields. The Tolerance value is used for the "attraction" of existing
nodes/members (never use null value for tolerance).
Selection Mode
The button turns on "selection" mode. In this mode, right-clicking the mouse on a
member or node displays its attributes in a menu on the side of the screen. Use the left
button to select an item (the program never allows members and nodes to be selected si-
multaneously).
The selection of a set of members or a set of nodes can be made clicking the left button of
mouse concurrently with the Shift key. A set of members/nodes can also be selected by
defining an enclosing rectangle. To do this, press and hold the left button of the mouse
and drag it to define the rectangle. Release the mouse button to complete the rectangle.
Once nodes and members are selected, actions can be executed upon them. To delete
entities push the button. To transform the selected entities, use the Transform menu
(See section below). The user can also apply attributes or loads to the selected members
or nodes – this is discussed later.
12
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
The Transform menu lists options to manipulate the nodes or members that have already
been created. There are options to move (Move), to reflect (Mirror), to rotate (Rotate), to
apply a scale factor (Scale) and to repeat the last transformation (Repeat). If the option
Leave Original is selected, the transformation is applied on a copy of the selected entities.
13
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
Visualization Controls
The Visualization Control Toolbar
This toolbar groups all the controls for the model visualization window.
The option to Fit and center on the screen scales the structure image to fill the screen.
The scale of the image on the screen can be modified in several ways, the first of which
zooms based on a defined zoom rectangle (Define a rectangle to focus the display). The
entry of two opposing corners of the zoom rectangle is completed with "two clicks" of
the mouse. The "two clicks" approach permits the user to cancel the visualization area
after the first point of the rectangle by clicking with the right button of the mouse or by
pressing Esc. If the two mouse clicks are at the same point on the screen there will be a
"central" zoom at this point. The Zoom In icon increases the size of the model on the
screen, while Zoom Out button decreases the size. The dial at the base of the toolbar al-
lows for real-time zoom control of the model.
Coordinate Control
In this toolbar at the bottom of the display, the (H) and (V) text fields show the size of the
visualization window and enable the user to alter these values. The (X) and (Y) fields
show the position of the cursor in the screen. The (Grid) check box enables the option to
display a grid of points on the screen, and the (Snap) check box activates the "attraction"
of the cursor to the points of the grid.
14
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
15
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
Configurations
The Options Menu
Currently, the options in FTOOL configurable by the user include the physical unit sys-
tems and the format for numerical values. The option Units & Number Formatting within
the Options menu accesses parameters for these configurations.
16
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
Unit Systems
The following tables show the unit systems implemented in FTOOL for each parameter
and the corresponding factors of conversion for the units used internally by the program
(indicated in boldface).
The first unit of each parameter appears automatically when the user selects SI units (In-
ternational System) or US units (American System).
The conversions for units that have ton-force (tf) are: 1 tf = 103 kg⋅g.
• Pascal Units:
1 Pa = 1 N/m2
1 kPa = 103 N/m2 = 1 kN/m2
1 MPa = 106 N/m2 = 103 kN/m2 = 1 N/mm2
1 GPa = 109 N/m2 = 106 kN/m2 = 1 kN/mm2
17
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
18
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
19
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
20
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
The icons shown in the next figure allow the user to manage these property sets.
To create a new set of properties, select the button and assign the new set a unique
name. The button imports a list of property sets from another file generated by
FTOOL. Duplicate property sets in the imported file are ignored. The internal function
21
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
that compresses the property sets just eliminates those which are not in use in the current
model.
Material Parameters
To create a new set of material parameters, select button and specify a unique name
(figure below to the left). Default values of material parameters are available for steel or
concrete.
Material parameters include Young’s modulus, specific weight (not currently used by
FTOOL) and coefficient of thermal expansion (if temperature loadings are applied).
Based on the type of section selected, the parameters that define the features of that sec-
tion are then defined along the side of the screen under the schematic drawing.
22
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
23
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
Support Conditions
Through this submenu, the user defines constraints on components of displacements in
the x and y directions and the rotation around the z-axis. The support orientation angle
(for skew supports) is also defined, as well as any prescribed values of displacement or
rotation. Non-rigid supports may be modeled by specifying values for corresponding
stiffness of linear-elastic springs.
24
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
25
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
General Information
• Load Definition
The loads definition system follows the same procedures as the one that defines
member properties. A type of load associated with a user-supplied name is created
and added to the corresponding load list. The figure below shows a drop-down list of
distributed loads defined by the user in a specific analysis. The values of load associ-
ated with the selected name are automatically displayed in the fields of submenu and
can be edited.
26
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
The icons shown in the figure below are used to manipulate the load in a list:
The current load will be applied to the selected elements (members or nodes). The
members of interest must be selected and the load is applied through the button
for members, or the button for the nodes.
27
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
Nodal Loads
This sub-menu allows the user to define the concentrated loads on structure nodes. It uses
the global coordinate system.
28
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
Temperature Changes
This sub-menu allows the user to define a linear temperature gradient over the member
depth. The user specifies the temperature on the section’s top edge (i.e., on the positive
side of local Y-axis) and on the bottom edge (i.e., on negative side of local Y-axis).
FTOOL must have access to the section depth to impose this loading – even for "generic"
sections.
29
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
Results
The Results Toolbar
Result Modes
There are two methods to obtain and display analysis results for structures in FTOOL.
These are the Diagram and Influence Line modes of operation. Select the desired mode of
operation using the drop-down menu shown above.
In Diagram mode, FTOOL automatically analyzes the structure as required using the
stiffness method to construct the requested diagrams: axial forces, shear forces, bending
moments, or deformed shape. Use the slider bar to modify the scaling of displayed dia-
grams as desired. Just clicking on the appropriate button switches the display to show the
quantity desired. Values at locations along members can be displayed. Place the mouse
cursor over a point on the member and click the right mouse button. Values are shown in
a window created at the right side of the display at specified increments along the mem-
ber.
In Influence Line mode, the applied loads on the structure are ignored. First click on the
button for the desired type of influence line (e.g., shear or moment). Now place the
mouse cursor at some point along a member and click the left mouse button. FTOOL im-
poses the required unit loading and displacement discontinuity to create the influence
30
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
line, which is displayed on the structural model. Move the mouse cursor to a position on
another member and click the right mouse button. This displays numerical values of the
influence line along that member.
31
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
Shear forces:
Shear forces on the diagram below are positive.
Bending Moments:
The sign convention shown below is adopted: positive moments causing com-
pression on the top fibers of members and tension on the bottom fibers. Bend-
ing moment diagrams may be displayed on the tension side (Brazilian conven-
tion) or on the compression side (common U.S.A. convention) of the mem-
bers. Use the File → Sign Convention menu to select the "tension" or "com-
pression" convention for the plotting of bending moment diagrams. When
adopting the tension side option, positive bending moments are displayed on
the bottom side; and, when adopting the compression side option, positive
bending moments are displayed on the top side
32
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
Similarly, the influence lines also have a single initial scale. This scale can be modified
using the slider bar at the left of the Results toolbar.
33
Ftool – Version 2.11– Aug. 2002 Manual in English – Nov. 2003
34