Chapter 4. Inspecting Dakota Studies Using the GUI

Once you have a Dakota input file imported into the GUI, there are many available options for inspecting it.  The text editor is the most obvious way to simply view an input file, but there are other ways to inspect it.

Tree in the Project Navigator View

A Dakota input file can be expanded in the project navigator view's tree to reveal its content hierarchically:


The Settings View

The Dakota GUI includes a helpful view simply called the Settings view.  This becomes available if you switch to the “Next Gen Workflow” perspective (select Window > Perspective > Open Perspective > Other, then select Next Gen Workflow from the list of perspectives).  You can also manually turn it on by going to the list of views (Window > Show View > Other... then select General > Settings).

By default, the Settings view is docked on the far right side of the screen:


When you select a Dakota keyword (either in the project navigator view, or in the text editor), the Settings view detects which keyword has been selected and displays options for editing it and its child keywords.

For instance, if you select the “interface” keyword in a Dakota input file, the following displays in the Settings view:


In this example, the Settings view provides a graphical representation of all possible options you can specify for the “interface” section of a Dakota input file.  Similar graphical views are available for other Dakota keywords.

  • Note:  Less common options for Dakota keywords are suppressed, but can be viewed by checking the “Show advanced options” checkbox.

Opening help in the GUI

The Dakota Reference Manual is directly embedded in the GUI for easy access.  There are multiple ways to launch it:

  • Right-click on a Dakota keyword in the project navigator view and select “Open in Dakota Reference Manual.”  This will take you directly to the manual page relevant to that keyword.
  • Click on a ? icon in the Settings view (see the above section).  This will also take you directly to the manual page relevant to that keyword.
  • Select Help > Dakota Reference Manual from the top-level menus.  This opens the Dakota Reference Manual’s introductory page.

To configure which version of the Dakota Reference Manual to launch, use the Dakota Preferences page (see Chapter 2).

Error messages in the text editor

The Dakota GUI’s text editor provides some basic error marking functionality that can help with malformed Dakota input files.  For example, in this screenshot, we have a continuous_design section of a variables block, stating that it will have 3 variables.  However, only 2 variables are specified below; this prompts an error to be displayed, warning us about the discrepancy.  Keywords relevant to the error are marked with red underlines.  Tooltip text help (i.e. the pale yellow box pictured here) can be viewed if you hover over the red X icons to the left; doing this provides more information about what is specifically wrong with your file.


Dakota Order Input Utility

If you have imported an old Dakota input file that used to work, but now has syntax errors, you may want to try applying the Dakota Order Input Utility on it.  This utility attempts to reorganize your input file according to current Dakota language standards.

To access the Order Input Utility, right-click on a Dakota input file and select “Dakota Order Input Utility.”

Note:  You will need to configure the path to the Order Input Utility by going to Window > Preferences > Dakota.