Running an Optimization

Different Categories of Optimization

Optimizations fit into two different categories:

Each category has different methods you can use to launch the optimization. We'll cover the different methods next.

Optimizing a Single Configuration

You can optimize a single configuration using any of the techniques listed below.

Optimizing Directly From the Config View Context Menu

To use this method, activate the Config View and right-click on the topmost node of the configuration you wish to optimize. The context menu shown below will be displayed.

Optimize Directly From the Context Menu
Optimize Directly From the Context Menu

Choose Optimize Configuration as shown above. This will optimize the selected configuration directly without launching any dialog box.

Automatically Resetting Filter Parameters to Their Defaults

For certain optimization types, you have the option of either starting the optimization using the current filter parameter values or resetting them to the defaults before running the optimization. Other optimization types have their own immutable reset logic as part of the optimization itself. These two groups of optimization types are listed below.

To require an automatic reset to be done for the first two optimization types listed above, choose Tools, Application Options, User Interface from the main menu. This will display the UI Options property page shown below.

Option to Automatically Reset Filter Parameters Before Optimizing
Option to Automatically Reset Filter Parameters Before Optimizing

Check this option and choose OK. When this option is checked and you run an optimization that's of one of the first two types listed above, MSO will always reset the configuration's filter parameters to their defaults before optimizing.

When you run an optimization from this context menu, if there is no graph currently displayed having traces from the configuration you're optimizing, you won't be able to see the results as they unfold. Make sure that such a graph is visible before running an optimization from the context menu.

Optimizing Using a Dialog Box Via the Config View Context Menu

To optimize using this method, activate the Config View and right-click on the topmost node of all configurations. The context menu shown below will be displayed.

Optimize Using a Dialog From the Context Menu
Optimize Using a Dialog From the Context Menu

Choose the Optimize One Configuration item as shown above. This will launch the Single-Configuration Optimization Dialog described below.

Optimizing Using the Toolbar Button

To run an optimization using this technique, click the Optimize One Configuration button on the toolbar. See the illustration below.

Optimize Using the Toolbar Button
Optimize Using the Toolbar Button

This will launch the Single-Configuration Optimization Dialog described below.

Optimizing Using the Main Menu

You can run an optimization from the main menu by choosing Config, Optimize One as shown in the figure below.

Optimize a Single Configuration Using the Main Menu
Optimize a Single Configuration Using the Main Menu

This will launch the Single-Configuration Optimization Dialog.

The Single-Configuration Optimization Dialog

The Single-Configuration Optimization Dialog is shown in the figure below.

The Single-Configuration Optimization Dialog
The Single-Configuration Optimization Dialog

The controls of this dialog are described below.

The Configuration List Box

The Configuration List Box lists the names of all the configurations in the project.

To optimize a configuration, you can select its name with the mouse or the keyboard arrow keys, then do one of the following:

The Reset Filter Parameters Checkbox

If this checkbox is checked and the configuration you've chosen to optimize uses one of the optimization types that allow filter parameters to be reset, MSO will reset all filter parameters of the chosen configuration to their default values before optimizing.

The Display of Configuration Notes

This display works similarly to the configuration notes browsing feature, displaying the notes you created for the selected configuration if any. These notes may have other information added to them as described next.

Before the dialog is displayed, all configurations are checked for their ability to be optimized. If the checking process reports an error or warning, that message text is generated and displayed along with any configuration notes that may be present. Different combinations of configuration notes and error/warning message text are displayed as follows.

The latter case is demonstrated in the image above, showing both an error message and the configuration notes appropriately labeled. When a configuration that cannot be optimized is selected, the OK button of the dialog is disabled, and double-clicking on the configuration has no effect. This is also illustrated in the image above.

If a configuration has warning text (but not error text) associated with it, it can be chosen for optimization in this dialog.

Optimizing Multiple Configurations

There are two ways to optimize multiple configurations. These are listed below.

  1. Run the optimization from the Multiple-Configuration Optimization Dialog that's launched from a context menu in the Config View.
  2. Choose Config, Optimize Multiple from the main menu to invoke the Multiple-Configuration Optimization Dialog.

Optimizing Using a Dialog Box Via the Config View Context Menu

To optimize multiple configurations using this method, activate the Config View and right-click on the topmost node of all configurations. The context menu shown below will be displayed.

Optimize Multiple Configurations Using a Dialog From the Context Menu
Optimize Multiple Configurations Using a Dialog From the Context Menu

Choose the Optimize Multiple Configurations item as shown above. This will launch the Multiple-Configuration Optimization Dialog described below.

Optimizing Using the Main Menu

You can optimize multiple configurations from the main menu by choosing Config, Optimize Multiple as shown in the figure below.

Optimize Multiple Configurations Using the Main Menu
Optimize Multiple Configurations Using the Main Menu

This will launch the Multiple-Configuration Optimization Dialog.

The Multiple-Configuration Optimization Dialog

The Multiple-Configuration Optimization Dialog is shown in the figure below.

The Multiple-Configuration Optimization Dialog
The Multiple-Configuration Optimization Dialog

The controls of this dialog are described below.

The Configurations and Graphs Property Grid

Each row of this control has a checkbox you use to specify that the given configuration is to be optimized. The left column contains the name of the configuration. The right column, when its button on the right side is clicked, displays a drop-down list of all the graphs in the project that have traces associated with that configuration. If only one such graph exists for a given configuration, it will be selected for you automatically. Otherwise, you'll need to select which graph is to be displayed when the optimization of that configuration is performed.

The checkbox state can be toggled in three ways.

The Reset Filter Parameters Checkbox

If this checkbox is checked and a configuration you've chosen to optimize uses one of the optimization types that allow filter parameters to be reset, MSO will reset all filter parameters of that configuration to their default values before optimizing it.

The Auto Assign Button

Pressing this button invokes MSO's automatic graph assignment algorithm to assign graphs to configurations. Since there can be multiple graphs having traces belonging to a given configuration, there can be more than one candidate graph for a given configuration. This process works in the following way.

If all configurations have a graph assigned to them, this button will be disabled.

The Display of Configuration Notes

This display works similarly to the configuration notes browsing feature, displaying the notes you created for the selected configuration if any. These notes may have other information added to them as described next.

Before the dialog is displayed, all configurations are checked for their ability to be optimized. If a configuration cannot be optimized, due to having no filters or if all parameters of all filters are locked, error message text is generated and displayed along with any configuration notes that may be present. Different combinations of configuration notes and error message text are displayed as follows.

The latter case is demonstrated in the image above, showing both an error message and the configuration notes appropriately labeled.

If a configuration has either an error or warning displayed (such as the "Baseline" configuration in the figure above), it cannot be optimized from this dialog. In such cases, the row containing the configuration information will be grayed out. Its checkbox will be unchecked and disabled, and its drop-down list disabled. The row can still be selected as shown above.

Disabling the Frequency Range Warning

If the configuration has a warning message regarding the frequency range of optimization vs. the allowed PEQ center frequency range, you can include it in a multiple-configuration optimization by first disabling the warning on the UI Options page of the Application Options property sheet, then returning to this dialog to select the configuration.

General Considerations

The configuration selection state, the graph to be displayed when optimizing each configuration, and the choice of whether to reset filter parameters are all saved from one invocation of this dialog to another, and also saved with the project.

Because of the automated nature of optimizing multiple configurations, the results are automatically saved to each configuration. There is no dialog box shown at the end of an optimization allowing you to reject the results as there is when optimizing a single configuration.

A Warning

Optimizing multiple configurations using this feature is for experienced users only. One problem encountered by some new users is that after performing an optimization using MSO, entering its calculated filter information into their DSP device, then measuring all subs together, they find that MSO's predictions don't match the final measured results. This problem is the subject of the FAQ, and can be time-consuming to track down. If you encounter such a problem, optimizing multiple configurations using this feature will not fix it. Instead, it will multiply the problem, causing even more trouble for you and anyone who tries to help find a solution. Before using the multiple-configuration optimization, you'll need to do the following.

Only after successfully performing these steps should you try optimizing multiple configurations using this technique.

Manually Resetting Configuration Filter Parameters

In addition to the methods described above for automatically resetting the filter parameters of configurations to their defaults before optimizing, you can also reset filter parameters manually. There are two ways to do this.

More discussion about filter parameter resetting can be found in the Tips and Tricks section.

Resetting Filter Parameters Using the Context Menu

Using the context menu to reset filter parameters is illustrated in the figure below.

Resetting Filter Parameters Using the Context Menu
Resetting Filter Parameters Using the Context Menu

Using the Filter Reset Dialog to reset filter parameters is illustrated in the section below.

Using The Filter Reset Dialog

The Filter Reset Dialog is described below.

The Filter Reset Dialog
The Filter Reset Dialog

The Configuration Selection List View

Select the configurations whose filter parameters you wish to reset using the checkboxes in this list view. Since this operation causes significant changes to the selected configurations, you'll be presented with a message box asking you to confirm your selection upon pressing the OK button.

Using With Multiple-Configuration Optimization

There might be a rare situation in which you want to optimize multiple configurations, but reset the filter parameters of only some of them. In the Multiple-Configuration Optimization Dialog, the choice of resetting filter parameters is an "all or nothing" proposition with regard to the chosen configurations. In such a situation, you can use the Filter Reset Dialog to reset the filter parameters of just the configurations you want, then in the Multiple-Configuration Optimization Dialog, uncheck the Reset filter parameters to default values for each configuration before optimizing checkbox before pressing OK to start the optimization.

After an Optimization is Started

After starting an optimization using one of the techniques described above, the Output Window will show a running status of the current optimization, including the applicable optimization errors, in the Optimization Status tab. An example of the Output Window display is shown below.

Display of the Error in the Output Window
Display of the Error in the Output Window

If you have a graph open with traces having the Plot live data when optimizing property checked, these traces will update in an animated fashion each time the optimizer reaches an improved solution.

While a single optimization is running, you can either wait for the optimization to complete or stop it early. To stop it early, press the Stop Optimization button on the toolbar or use the Alt+S keyboard shortcut. In either case, MSO will ask you whether you want to keep the results the optimizer computed or revert to the original state. Click the appropriate button on the dialog box to proceed.

If you choose to stop the optimization while a multiple-configuration optimization is running, the currently running optimization will be stopped, and MSO will ask you whether you want to keep its results or revert it to the original state. The results of all optimizations that were previously run will still be retained, and all pending scheduled optimizations will be canceled.

When an optimization is finished, the relevant plot will display the final optimized result.