User manual - Field analyses¶
- The interface allows to launch the following types of field analysis:
- Model evaluations
- Central tendency analysis
1- Model evaluation¶
The user may evaluate the physical model for defined input values.
- Create a new model evaluation through:
The Definition item in the context menu of the relevant model in the study tree
The Model evaluation box of the model diagram
The New evaluation item in the context menu of the Evaluation section
1-1 Definition¶
When this analysis is required, the following window appears to set its parameters.
- When an evaluation is required, a window appears, in order to set up:
- The outputs of interest (Select outputs - default: all outputs are evaluated). At least one variable must be selected to validate the window.
- The value of the input variables (default: value in the physical model definition). The values are expected to be floating points or integer.
1-2 Launch¶
When the «Model Evaluation» window is validated, a new element appears in the study tree, below Evaluation.
- Its context menu has the following actions:
- Rename: Rename the analysis
- Modify: Reopen the setting window to change the analysis parameters
- Remove: Remove the analysis from the study
This item is associated with a window showing the parameter list, a progress bar and Run/Stop buttons, to launch or stop the analysis.
1-3 Results¶
When the evaluation is finished, a result window appears. This window gathers the following tabs:
The Result tab shows for the selected output (left column):
- the Trajectory tab shows the output values versus the mesh vertices.
- Use the Graph settings window to set up graphical parameters.
- Graph interactivity:
- Right-click to select the points of trajectories
- Left-click to translate the graph
- Mouse wheel up/down to zoom in/zoom out
The Table tab presents the resulting output values for each mesh nodes. The table can be exported (Export button).
- Table interactivity:
- Left-click (optional: + Ctrl) on lines to select them
- Left-click on column header to sort values in ascending or descending order
- Left-click on a column header and drag it in another place to change columns order
The Input tab shows:
The Table tab reminds the input point. The table can be exported (Export button).
- Table interactivity:
- Left-click (optional: + Ctrl) on lines to select them
- Left-click on column header to sort values in ascending or descending order
- Left-click on a column header and drag it in another place to change columns order
The Parameters tab reminds the user of all the parameters values to perform the analysis.
The Model tab shows the model content used to perform the analysis.
2- Central tendency analysis¶
The central tendency analysis can only be performed with the MonteCarlo sampling method. In order to perform a central tendency analysis, build first a probabilistic model.
- New central tendency analysis can be created thanks to:
the context menu of the probabilistic model item
the Central tendency box of the model diagram
the context menu of the Central tendency item (if it already exists)
2-1 Definition¶
- When an analysis is required, a window appears, in order to set up:
- the outputs of interest (Select outputs - default: all outputs are analyzed)
- Stopping criteria of the algorithm (Select at least one criterion to validate the window):
- the maximum computation time in days(d), hours(h), minutes(m) or seconds(s) (default: one minute)
- the maximum sampling size (default: 10000, expected: integer)
- Evaluation parameter: the block size – the number of runs launched simultaneously – for parallelization purposes (default=1; expected= integer). It must be less than the maximum sampling size.
- Advanced Parameters (default: hidden):
- the Karhunen-Loeve threshold (default: 1e-5, expected: float)
- the seed of the random generator (default: 0, positive integer expected)
2-2 Launch¶
When the Central tendency window is validated, a new element appears in the study tree, below Central tendency.
- Its context menu has the following actions:
- Rename: Rename the analysis
- Modify: Reopen the setting window to change the analysis parameters
- Remove: Remove the analysis from the study
This item is associated with a window showing the parameter list, a progress bar and Run/Stop buttons, to launch or stop the analysis.
2-3 Results¶
When the analysis is finished or stopped, a result window appears.
The Trajectories tab, the Result/Table tab, the Bag chart tab, the Functional bag chart tab, the Input/Table tab and the Plot matrix tab are linked: when the user selects some points in one of these tabs, they are automatically selected in the other tabs.
The results window gathers the following tabs:
The Result tab shows for the selected output (left column):
- the Trajectories tab shows for each input point, the output values versus the mesh vertices.
- Use the Graph settings window to set up graphical parameters and select the trajectories to display
- Graph interactivity:
- Right-click to select the points of trajectories
- Left-click to translate the graph
- Mouse wheel up/down to zoom in/zoom out
The Table tab presents the resulting output values for each input values (lines) and each mesh nodes (columns). The table can be exported (Export button).
- Table interactivity:
- Left-click (optional: + Ctrl) on lines to select them
- Left-click on column header to sort values in ascending or descending order
- Left-click on a column header and drag it in another place to change columns order
- the Bag chart tab shows the explained variance (PC2 (=second principal component) versus PC1 (=first principal component)).
- Use the Graph settings window to set up graphical parameters.
- Graph interactivity:
- Right-click to select points
- Left-click to translate the graph
- Mouse wheel up/down to zoom in/zoom out
- the Functional bag chart tab shows the 50% and 95% quantiles.
- Use the Graph settings window to set up graphical parameters.
- Graph interactivity:
- Right-click to select trajectories
- Left-click to translate the graph
- Mouse wheel up/down to zoom in/zoom out
- the Mean trajectory tab shows the mean and 5% and 95% quantiles of the trajectories.
- Use the Graph settings window to set up graphical parameters and select the trajectories to display
- Graph interactivity:
- Left-click to translate the graph
- Mouse wheel up/down to zoom in/zoom out
The Input tab shows:
The Table tab presents the input sample generated by the Monte Carlo sampling method. The table can be exported (Export button).
- Table interactivity:
- Left-click (optional: + Ctrl) on lines to select them
- Left-click on column header to sort values in ascending or descending order
- Left-click on a column header and drag it in another place to change columns order
The Plot matrix tab: histograms of the distribution of each variable (diagonal) and scatter plots between each couple of input variables (off-diagonal).
- Use the Graph settings window to set up graphical parameters.
- Graph interactivity:
- Right-click to select points
- Left-click to translate the graph
- Mouse wheel up/down to zoom in/zoom out
The Decomposition tab shows the result of the Karhunen-Loeve decomposition, for the selected output (left column):
the Modes tab shows the modes of the Karhunen Loeve decomposition.
- Use the Graph settings window to set up graphical parameters and select the trajectories to display
- Graph interactivity:
- Right-click to select the points of trajectories
- Left-click to translate the graph
- Mouse wheel up/down to zoom in/zoom out
The Eigenvalues tab presents the eigenvalues of the modes and a plot of the cumulative eigenvalue sum.
- Use the Graph settings window to set up graphical parameters and select the trajectories to display
- Graph interactivity:
- Left-click to translate the graph
- Mouse wheel up/down to zoom in/zoom out
the ξi tab shows the projections of the trajectories in the Karhunen-Loeve decomposition:
the PDF/CDF tab presents the PDF/CDF of the ξi sample together with the distribution PDF
- Use the Graph settings window to set up graphical parameters and select the ξi and the graphic type: PDF or CDF (default: PDF)
- Graph interactivity:
- Right-click to select the points of trajectories
- Left-click to translate the graph
- Mouse wheel up/down to zoom in/zoom out
The Plot matrix tab: histograms of the distribution of each variable (diagonal) and scatter plots between each couple of ξi variables (off-diagonal).
- Use the Graph settings window to set up graphical parameters.
- Graph interactivity:
- Right-click to select points
- Left-click to translate the graph
- Mouse wheel up/down to zoom in/zoom out
The Correlation tab presents the empirical correlation of the output between the nodes of the mesh.
- Use the Graph settings window to set up graphical parameters.
- Graph interactivity:
- Left-click to translate the graph
- Mouse wheel up/down to zoom in/zoom out
The Parameters tab reminds the user of all the parameters values to perform the analysis.
The Model tab shows the model content used to perform the analysis.