Context Menu Tools

Table of Contents

  1. Dakota Order Input Utility
  2. Markup File
  3. Recognize as Analysis Driver

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."

alt text

alt text

alt text

Markup File

Introduction to Markup

Commonly, black-box simulation models receive text files as their input. The process of communicating between Dakota and the external black-box simulation models is often made easier if we can apply markup to the simulation model's text input file. "Markup" typically refers to defining variables using a delimiter (such as surrounding curly braces).

Once markup has been applied to the input file, your Dakota analysis driver can apply a pre-processing tool (such as APREPRO or DPREPRO) to the marked-up file, which replaces the markup syntax with the latest variable values from the current Dakota iteration.

Recommended Further Reading

"Markup File" Tool

If you have a text file that you'd like to apply pre-processing markup to, right-click on that file and choose "Markup file" from the context menu.

alt text

alt text

At this stage, you may wish to manually apply your favorite pre-processing markup style to the file contents by editing directly into the text window. If you have another file that has input parameters already defined (for instance, a BMF file), use the "Import variables" file importer to populate this dialog with information about what variable labels to use for pre-processing:

alt text

Observe that the "Stamps" group on the right side has been populated with buttons representing our variable labels. To use these stamp buttons, simply highlight the portion of text in the text window that you want to replace, and click the appropriate stamp button to replace it.

Note: Pre-processing markup style is defined in the Highlighter section of the Preferences dialog.

When you're done, your marked-up file may look something like this.

alt text

Recognize as Analysis Driver

Suppose you already have a script file you want to use as an analysis driver. You’ve imported it into your workspace, but wizards (like the New Dakota Study wizard) don’t recognize it as a valid analysis driver. That is because the Dakota GUI depends on a concept known as an interface manifest to enforce a handshake between Dakota and its analysis drivers. The interface manifest is simply a file that declares what input parameters a given analysis driver expects to receive, and what output results it can produce.

To make an interface manifest for arbitrary script files, simply right-click on the file in the Project Explorer and choose “Recognize as Dakota Analysis Driver.”

alt text

As of version 6.15.0, Dakota GUI observes the following extensions as candidates for analysis driver recognition: .py, .bat, .sh, .csh, .java, .perl, .pl, .ps1, and .vbs.

When you choose this option, the following dialog will appear:

alt text

This dialog allows you to define an interface manifest for your analysis driver. Use the “Add” and “Remove” buttons to create parameter and result labels. Or, use the file selector labeled “Already have parameter and result labels defined?” to import parameter and response labels from another source (such as a BMF file, an IWF file, or even a pre-existing Dakota study).

When you’re done, the dialog should look something like the following:

alt text

Click OK to create the interface manifest (.im) file for your script. Your arbitrary script is now compatible with the rest of Dakota GUI.