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

PropertyDescription
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 XSet to true to show a vertical grid line.
Grid YSet 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 ColorSpecify a plot color.
Record Plot Data AsSpecify the selected format of the file to be saved if the Result File property is specified.
Result FileSpecify 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.
TitleSpecify the title of the Histogram.
X LabelSpecify the label of the x-axis of the Histogram.
Y LabelSpecify the label of the y-axis of the Histogram.
Number Of BinsSpecify 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


  1. Create a Histogram element to represent a Classifier, e.g., Hinge Analysis.
  2. 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.
  3. Specify other Histogram properties if necessary (see the property table).
  4. Drag the Histogram to a Simulation Configuration.
  5. Make sure that the value of the UI property of the Simulation Configuration is set to the created Histogram.
  6. 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.

The Histogram is exported as a CSV file.