On this page
Magic Model Analyst 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 itd 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 | Description |
|---|---|
| Dynamic | Set to true to open the Histogram during multiple executions to show dynamic results. Otherwise, the Histogram is opened 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 | Set to true to show a vertical grid line. |
| Grid Y | Set to true to show a horizontal grid line. |
Keep Open After Termination | Set to true to keep the Histogram open after the termination of the simulation. |
| Plot Color | Specify a plot color. |
| Record Plot Data As | Specify the selected format of the file to be saved if the Result File property is specified. |
| Result File | Specify the name of the file to be saved with the results in the file format specified in the Record Plot Data As property. Otherwise, the results are saved in a model element. |
| Title | Specify the title of the Histogram. |
| X Label | Specify the label of the x-axis of the Histogram. |
| Y Label | Specify the label of the y-axis of the Histogram. |
| Number Of Bins | Specify the number of data bins in which the results are distributed. Otherwise, the number of bins is dynamic, depending on the number of samples. |
Note
The Histogram can be used only as a local user interface, and the Number Of Runs property of the SImulation Configuration must be set to more than 1.
Using the Histogram
To use the Histogram
- Create a Histogram element to represent a Classifier, e.g., Hinge Analysis.
- In the Specification window of the Histogram, specify the Value property and the properties whose values will be monitored in the Histogram. These properties must be the members of the Classifier represented by the Histogram, e.g., hinge.clearance.
- Specify other Histogram properties if necessary (see the property table).
- Drag the Histogram to a Simulation Configuration.
- Make sure that the value of the UI property of the Simulation Configuration is set to the created Histogram.
Run the Simulation Configuration.
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 then exported as a CSV file, as shown below.
