Exports surrogate model in user-selected format

Topics

This keyword is related to the topics:

surrogate_models

Specification

Alias: none

Argument(s): none

Required/Optional

Description of Group

Dakota Keyword

Dakota Keyword Description

Optional

filename_prefix

User-customizable portion of exported model filenames

Required

formats

Formats for surrogate model export

Description

Export the surrogate for later evaluation using the surfpack exectuable (bin/surfpack) or a user-developed tool. Export format is controlled using the formats specification. Four formats are available in Dakota; however, not all have been enabled for all surrogates.

The four formats are:

text_archive - Plain-text, machine-readable archive for use with the surfpack executable
binary_archive - Binary, machine-readable archive for use with the surfpack executable
algebraic_file - Plain-text, human-readable file intended for use with user-created tools; not compatible with the surfpack executable
algebraic_console - Print the model in algebraic format to the screen; not compatible with the surfpack executable

Most global surrogates can be exported in all four formats. These include:

Gaussian process (keyword gaussian_process surfpack)
Artificial neural network (keyword neural_network)
Radial basis Funtions (keyword radial_basis)
Polynomial (keyword polynomial)

However, for Multivariate Adaptive Regression Spline (keyword mars) and moving least squares (keyword moving_least_squares) models, only text_archive and binary_archive formats may be used.

Currently, no other surrogate models can be exported. In addition, Dakota cannot import models that have been exported. They are strictly for use with external tools.

Default Behavior

No export.

Expected Output

Output depends on selected format; see the formats specification.

Additional Discussion

The Dakota examples folder includes a demonstration of using the surfpack executable with an exported model file.