On this page
Cameo Simulation Toolkit introduces built-in support for Monte Carlo analysis, allowing you to manage uncertainties and estimate how random variation of sensitive parameters affects the overall performance of the system being modeled. A Histogram shows the density of the underlying distribution of data and estimates the probability density function of underlying variables. The total area of the Histogram used for probability density is always normalized to 1. A Histogram also allows you to dynamically view updates on those statistical values during the simulation. In addition, you can customize the properties, including title, plot color, and labels. For more information about using the Histogram in your model, see the <install_root>\samples\simulation\HingeMonteCarloAnalysis.mdzip sample as a demonstration.
A Histogram with dynamic statistical results (N, Mean, SD, and OutOfSpec).
Properties of the Histogram
The Specification dialog of the Histogram contains the properties you can select and modify to change the display of the Histogram, as shown below.
The properties of the Histogram in its Specification dialog.
The following table describes the function of each property in the Specification dialog of the Histogram
| Property | Function |
|---|---|
| Dynamic | If true, opening the Histogram during multiple executions shows dynamic results. Otherwise, the Histogram will be open when all executions are completed. Note When the Dynamic property is set to true, the animation of the Histogram with dynamic statistical results (N, Mean, SD, and OutOfSpec) is available. |
| Grid X | To show or hide a vertical grid line. |
| Grid Y | To show or hide a horizontal grid line. |
Keep Open After Termination | To keep the Histogram open after the termination of the simulation. |
| Plot Color | To specify a plot color. |
| Record Plot Data As | To specify the selected format of the file to be saved if Result File is specified. |
| Result File | To specify the file name to be saved from the results in the selected file format specified in the Record Plot Data As property. Otherwise, the results will be saved into model elements. |
| Title | To specify the title of the Histogram. |
| X Label | To specify the label of the x-axis of the Histogram. |
| Y Label | To specify the label of the y-axis of the Histogram. |
Note
The Histogram can be used only as a local user interface, and the Number Of Runs «SimulationConfig» must be more than 1.
Using the Histogram
To use the Histogram
- Create a Histogram element to a Represents Classifier, e.g., Hinge Analysis.
- In the Specification window, specify the Value tag definition and properties whose values will be monitored in the Histogram. These properties must be the members of the Classifier represented by the Histogram element, e.g., hinge.clearance.
- Set other properties as necessary, as shown in the property table, e.g., Name, Title, and Dynamic.
- Drag the Histogram to the Monte Carlo Analysis «SimulationConfig».
- Verify that UI = Histogram is shown in the «SimulationConfig».
Run the Monte Carlo Analysis «SimulationConfig».
Tips
You can export the Histogram data as a CSV file by clicking the 
icon at the top-left of the Histogram pane. The Histogram is exported as a CSV file, shown below.
