Multipurpose Probabilistic Software For Statistical, Sensitivity and Reliability Analysis
Multipurpose Probabilistic Software For Statistical, Sensitivity and Reliability Analysis
Multipurpose Probabilistic Software For Statistical, Sensitivity and Reliability Analysis
PROGRAM DOCUMENTATION
Revision 12/2004, FReET version 1.1
Part – 2
FReET M/A User Manual
Cervenka Consulting
Prof. Drahomı́r Novák, Ph.D.
Saumannova 10, 615 00 Brno
Czech Republic
phone: +420603172861
e-mail: [email protected]
University address: Institute of Structural Mechanics
Faculty of Civil Engineering, Brno University of Technology
Veveri 95, 602 00 Brno, Czech Republic
Part 2
User Manual
Written by:
Drahomı́r Novák, Miroslav Vořechovský,
Radoslav Rusina & David Lehký
Contents
1 INTRODUCTION 2
2 FILE 3
2.1 Open a FReET data file (File/Open) . . . . . . . . . . . . . . . . . . . . . . 3
2.2 Saving a file (File/Save/Save as) . . . . . . . . . . . . . . . . . . . . . . . . 3
2.3 Ending FReET (File/Exit) . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
4 STOCHASTIC MODEL 5
4.1 Random variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
4.2 Statistical correlation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1
1 INTRODUCTION
1 INTRODUCTION
The purpose of this manual is to provide a full description of the graphic user interface
of program FReET. This document is compatible with FReET version 1.1 released in
12.2004. The multipurpose probabilistic software FReET has been developed for sta-
tistical, sensitivity and reliability analysis of both simple and computationally intensive
user-defined engineering problems. An emphasize is on small-sample reliability techniques
which use very small number of simulations. The main aim of the software is to enable
a probabilistic treatment of complex engineering problems coded into deterministic soft-
ware where classical reliability approaches are not feasible. The software is designed in
the form suitable for relatively easy probabilistic assessment of any user-defined problem.
The name of the software reflects this strategy – FReET is the acronym for Feasible
REliability Engineering Tool.
FReET can be utilized in two versions – as “stand alone” multipurpose program for
any user-defined problem (M-version) and as module integrated with ATENA (A-version).
This manual provides the descriptions of general features of the software valid for both ver-
sions. Main differences between two versions are described in the chapter Response/Limit
state function definition. If necessary, the differences are mentioned as a remark related to
M or A-versions in other chapters of this manual. The main aim of this text is to describe
how to efficiently utilize software FReET with all details and possibilities provided by the
graphic user interface.
FReET A-version has been integrated with advanced nonlinear fracture mechanics
software for computational analysis of concrete structures – the finite element program
ATENA (Cervenka Consulting, Prague, Czech Republic), the integration is controlled by
SARA Studio software shell. Full understanding of the concept of this complex integration
is beyond the framework of this text. The user of A-version of FReET should get next
information support from ATENA and SARA documentations.
Although some examples are included in this manual to support the description of
some software functions, a systematic treatment of examples is not covered. It is a subject
of a separate document – FReET Part 3 – Benchmarks and Examples. The description of
theoretical methods implemented in FReET is provided in FReET Part 2 – Theory.
2
FREET – Program Documentation User Manual
2 FILE
2.1 Open a FReET data file (File/Open)
A FReET file can be opened by this command. A classical window shown in Fig. 1 will
appear after using this command. FReET files have extension *.fre and contain input data
and results.
Input *.fre files with benchmarks can be found in subdirectory Examples of the program
FReET in case of the default setting is used during installation of the program. History
of recently opened files is saved during one activation of FReET under File menu for easy
handling.
Note: In case that FReET HASP (hardlock) is not found, the program is functioning
as a demo version with several restrictions, which is announced. One restriction is that
only rectangular distribution is allowed for basic random variables. In case *.fre file is
opened under running demo version all distributions are changed to rectangular ones.
3
3 MAIN PROGRAM TREE
• Stochastic Model
Basic random variables of the problem are defined here by statistical moments or/and
statistical parameters including theirs statistical correlation.
4
FREET – Program Documentation User Manual
4 STOCHASTIC MODEL
4.1 Random variables
The window “Random Variables”, Fig. 4, allows the user-friendly input of basic random
variables of analyzed user-defined problem. Uncertainties are modelled as random vari-
ables described by their probability density functions (PDF). Every random variable has
the name and is described by theoretical probability distribution and statistical character-
istics, statistical parameters or by combination of characteristics and parameters – button
”Descriptors”. The user can select from the set of selected theoretical models like normal,
lognormal, Weibull, rectangular, etc. The model is selected from the list of distributions
which will appear when clicking on ”Distribution”, Fig. 6. They are ordered approximately
according to the expected frequency of the use for practical problems. Both 2-parametric
and 3-parametric are included. Note, that also negative forms of some distributions are
included. 28 distributions are included:
• Deterministic
• Normal
• Lognormal (2par)
• Lognormal (3par)
• Raileigh
• Raileigh negative
• Gamma (2par)
• Gamma (3par)
• Exponential
• Exponential negative
• Gumbel min EV I
• Gumbel max EV I
5
4.1 Random variables 4 STOCHASTIC MODEL
• Rectangular
• Triangular
• Laplace
• Pareto
• Logistic
• Half-Normal
• Half-Normal negative
• Beta
• Student t
Note, that some distributions can be defined by a certain setting of parameters of other
distributions. The simpler forms are included in the list to allow easy handling by user.
Details on probability distributions are in theory guide of FReET.
Random variable can be described also by raw data here – select ”Distribution support
calculation” and ”Raw Data”, Fig 7. In this case the name of input text file with statistical
set arranged in columns or rows in ASCII format is required or data can be directly written
into the edit box. Then selection ”Calculate parameters” will cause also curve fitting - the
selection of most suitable probability distribution is performed, distributions are ordered
according to the confidence levels SL of curve fitting. By clicking ”Apply” the result of
raw data assessment is transferred into variable definition window.
Random variables should be basically described by statistical characteristics (statistical
moments): Mean value, standard deviation (or coefficient of variation) and coefficient of
skewness, respectively. Exceptionally also 4th statistical moment, kurtosis, is used (Beta
distribution). Standard deviation or coefficient of variation is recalculated automatically
with respect to mean value when entering the value. Optionally, statistical characteris-
tics or statistical parameters or combination of characteristics and parameters are used to
describe distribution (menu ”Descriptors”). Parameters symbols are unique for each dis-
tribution and the meaning of parameters is explained fully in theory guide of FReET. The
shape of probability distribution of particular random variable is shown in main graphical
window, checkbox ”Drawing” serves for selection of probability distribution (PDF), Fig.
4, or cumulative probability distribution (CPDF), Fig. 5, windows.
Random variables can be divided into several categories (see bottom of the window).
User can select a new category and within a selected category a new variable. This option
is included in order to make handling of large number of random variables easier and more
transparent. The result of this step is the set of defined input parameters for computational
model – random variables.
The category “Comparative values” is always included in window and can be used in
the limit state function definition (”Simulation Results Assessment”, ”LSF definition”).
6
FREET – Program Documentation User Manual
But this category is not always utilized: in case we analyze only a response function or
all variables of limit state function are defined directly only using equation interpreter
or DLL function (section 5.1). Note, that in case we achieved results through FReET
usage, analysis is performed and ”Simulation results assessment” we can still decide to
go back to ”Comparative values” definition in ”Stochastic model”. In such case of new
comparative definition, it is not necessary to perform a time-consuming simulation again.
Button ”Comparative values only” should by selected in ”General Data” window. Then
7
4.1 Random variables 4 STOCHASTIC MODEL
comparative values will be only sampled and the user can skip ”Model analysis” and to
go quickly to ”Simulation Results Assessment”.
8
FREET – Program Documentation User Manual
There is additional option for calculation at the level of selected PDF model: ”Dis-
tribution support calculation” and ”Details” buttons allow recalculation of characteristics
and parameters, probabilities, percentiles, etc., Fig. 8. This probability distribution cal-
culator enables to have overall numerical information on selected distribution.
9
4.2 Statistical correlation 4 STOCHASTIC MODEL
variables defined in special DLL unit written in C++, FORTRAN or other programming
languages. The structure of a special DLL unit of M-version is described in chapter 5.1.
In case that only a simple function is treated using equation interpreter (chapter 5.1), the
list of variables names and related categories will appear in equation interpreter window.
A-version: Input parameters of ATENA deterministic computational model are trans-
ferred into FReET (name and deterministic value). Groups in FReET are equivalent to
numbers of materials defined in ATENA. Number of transferred random variables of the
model (both material and geometrical) can be initially filtered (decreased) at the level
of SARA Studio. Additional random variables can be defined by “New variable” button
to form limit state function in the category ”Comparative values”. This is necessary if
reliability analysis is planned – ATENA provides response function (maximum capacity
corresponding to peak load, deflection or crack width) and these quantities should be
”compared” (with load, maximum allowable deflection or maximum crack width) in order
to form limit state function.
In order to support the input of statistical characteristics for basic random variables
the possibility to work with user-defined database was worked out. The user can click on
”Database” button of ”Distribution support calculation” and the hierarchical structure
according to the database file will appear, Fig. 9. The user can go throw the structure
to search for characteristics. If they are found, the user can transfer them automatically
into random variable description table. The structure of database file is self-explanatory,
the number of hierarchical levels is not limited. The text file of the database named
DATABASE.txt should be in the same directory as FReET program. It can be updated,
modified or replaced according to the need of particular application. The flexible structure
of database file is shown in Fig. 10.
10
FREET – Program Documentation User Manual
11
5.1 FReET M-version 5 RESPONSE/LIMIT STATE FUNCTION DEFINITION
B
G(X) = A − (1)
C
Program units in C++ and Fortran are shown in Fig. 13 and Fig. 14. Note that:
A = input(0), B = input(1), C = input(2) in C++ and A = input(1), B = input(2),
C = input(3) in Fortran. Note, that the number of random variables in DLL function
should correspond with number of random variables defined in ”Stochastic model”. This
is fully the responsibility of an user, FReET cannot check this fundamental requirement.
12
FREET – Program Documentation User Manual
13
6.2 Check samples 6 LATIN HYPERCUBE SAMPLING
14
FREET – Program Documentation User Manual
If user clicks on diagonal, upper part window will show associated sampled variable, Fig.
17. If the click is targeted to correlation coefficient out of diagonal, the image of sampled
values is shown where correlation is clearly visible, Fig. 18. Cartesian or parallel coordi-
nates can be selected. Before model analysis is performed, the option ”g(X) <= 0” is not
active (”Not drawn” is shown). After performing model analysis a particular limit state
function can be selected here. Then generated points located in safe region are shown by
green dots, in failure region by red dots (Cartesian coordinates plot).
15
6.3 Model analysis 6 LATIN HYPERCUBE SAMPLING
Repetitive calculation of response/limit state functions is started when the user activates
this button. Repetitive calculation is performed and results are collected.
M-version: Analyzed user-defined function defined by equation interpreter or using
the DLL function unit is repeatedly solved here. First, the user has to use double-click on
”New Model Function” definition, a new line will appear. Then there are two possibilities
to define response/limit state functions. The button ”a+b” will activate the equation
interpreter window, Fig. 12. This option can be used for simpler functions only. For more
complicated functions the concept of DLL function has to be used as described in section
5.1. By clicking on ”...” button, FReET will require to input name of DLL function which
contains response/limit state function. The names of internal functions programmed inside
of DLL function are indicated on the screen (Exported functions), Fig. 19. ”Run Model
Analysis” will finally start real simulation.
Note, that not only one function can be defined here. FReET allows to define several
functions here and in consequent step – simulation – to treat them simultaneously. Every
function will use the same set of randomly generated realizations of random variables, they
are common for all functions. The user should take into account overall time of whole
simulation in case of computationally demanding response/limit state functions.
A-version: All random solutions of nonlinear fracture mechanics analysis are per-
formed via SARA Studio environment and output files of ATENA numerical outputs are
saved. Responses associated with monitoring points are transferred into FReET after
simulation process is finished.
16
FREET – Program Documentation User Manual
Z =R−E (2)
17
7.3 Sensitivity analysis 7 SIMULATION RESULTS ASSESSMENT
18
FREET – Program Documentation User Manual
strong sensitivity (bigger variable smaller response). Positive and negative sensitivity is
shown in separate columns. There are two ways of graphical representation – cartesian
and parallel coordinates representations. Parallel coordinate representation provides an
insight into analyzed problem. Random variables are ordered with respect of the sensitiv-
ity expressed by nonparametric rank-order correlation coefficient. Positive and negative
sensitivity is shown in Fig. 22 and Fig. 23 (parallel coordinates) and in Fig. 24 and Fig.
25 (cartesian coordinates).
Note 1: When the user assess this relative measure of sensitivity it is necessary to take into
account the signs of input random variables considered in Stochastic model. Therefore an
option to change the sign of variable (x−1 ) is included here. This option is recommended
to use in case the negative signs are considered for some basic input random variables in
”Stochastic model” for correct understanding of sensitivity results.
Note 2: ”What–if–study” known as deterministic sensitivity analysis can be done easily
by FReET. To study absolute influence of a specific input variable, we can consider it as
random variable with rectangular distribution and to keep other variables as determin-
istic. Only this one variable is then sampled - consequent model analysis will provide a
clear influence of this variable. Sensitivity window in cartesian coordinates will provide
just functional relationship between variable, varying between upper and lower limits of
rectangular distribution, and response variable, Fig. 26indicates a linear influence of a
variable.
19
7.3 Sensitivity analysis 7 SIMULATION RESULTS ASSESSMENT
20
FREET – Program Documentation User Manual
21
REFERENCES REFERENCES
describe the most suitable models are treated using a standard Kolmogorov-Smirnov test,
curve fitting (CF) procedure. The most suitable model is listed in CF - Distribution at
the top according to the significance level (CF - SL). ”Distribution details” button enables
the same features as in case of basic random variables input in ”Stochastic model”. For
example, confidence intervals for results can be easily determined utilizing the possibility.
Following alternatives are implemented:
• Failure probability estimation (CF - pf ) based on the selection of the most suitable
theoretical model for PDF of safety margin (curve fitting approach);
References
[1] Červenka, V. & Pukl, R. (2003). ”ATENA Program Documentation – Theory.” Cer-
venka Consulting, Prague, Czech Republic.
[2] Červenka, V. & Pukl, R. (2003). ”ATENA Program Documentation – User’s guide.”
Cervenka Consulting, Prague, Czech Republic.
[3] Novák, D., Vořechovský, M., Teplý, B., Keršner, Z. & Lehký, D. (2004). ”FReET
Program Documentation – Part 1 – Theory.” Brno/Cervenka Consulting, Prague, Czech
Republic.
[4] Novák, D. & Lehký, D. (2004). ”FReET Program Documentation – Part 3 – Bench-
marks.” Brno/Cervenka Consulting, Prague, Czech Republic.
[5] Červenka, V. & Pukl, R. (2004). ”SARA Program Documentation – User’s guide.”
Cervenka Consulting, Prague, Czech Republic.
22