approximate_control_variate
- pydantic model dakota.spec.method.approximate_control_variate.ApproximateControlVariateSelection
Generated model for ApproximateControlVariateSelection
Show JSON schema
{ "title": "ApproximateControlVariateSelection", "description": "Generated model for ApproximateControlVariateSelection", "type": "object", "properties": { "approximate_control_variate": { "$ref": "#/$defs/ApproximateControlVariateConfig", "x-aliases": [ "acv_sampling" ], "x-materialization": [ { "ir_key": "method.algorithm", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "APPROX_CONTROL_VARIATE" } ] } }, "$defs": { "AcvIndependentSampling": { "additionalProperties": false, "description": "Sampling scheme within the approximate control variate (ACV) algorithm that employs independent samples (IS) across model pairings", "properties": { "acv_independent_sampling": { "const": true, "default": true, "description": "Sampling scheme within the approximate control variate (ACV) algorithm that employs independent samples (IS) across model pairings", "title": "Acv Independent Sampling", "type": "boolean", "x-aliases": [ "acv_is" ], "x-materialization": [ { "ir_key": "method.sub_method", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_ACV_IS" } ] } }, "title": "AcvIndependentSampling", "type": "object" }, "AcvMultifidelity": { "additionalProperties": false, "description": "Approximate control variate (ACV) algorithm that employs a nested pyramid sample pattern, similar to MFMC", "properties": { "acv_multifidelity": { "const": true, "default": true, "description": "Approximate control variate (ACV) algorithm that employs a nested pyramid sample pattern, similar to MFMC", "title": "Acv Multifidelity", "type": "boolean", "x-aliases": [ "acv_mf" ], "x-materialization": [ { "ir_key": "method.sub_method", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_ACV_MF" } ] } }, "title": "AcvMultifidelity", "type": "object" }, "AcvRecursiveDiff": { "additionalProperties": false, "description": "Sampling scheme within the approximate control variate (ACV) algorithm that employs weighted recursive differences (RD) across model pairings", "properties": { "acv_recursive_diff": { "const": true, "default": true, "description": "Sampling scheme within the approximate control variate (ACV) algorithm that employs weighted recursive differences (RD) across model pairings", "title": "Acv Recursive Diff", "type": "boolean", "x-aliases": [ "acv_rd" ], "x-materialization": [ { "ir_key": "method.sub_method", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_ACV_RD" } ] } }, "title": "AcvRecursiveDiff", "type": "object" }, "ApproximateControlVariateConfig": { "additionalProperties": false, "description": "Approximate control variate (ACV) sampling methods for UQ", "properties": { "model_pointer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Identifier for model block to be used by a method", "title": "Model Pointer", "x-block-pointer": "model", "x-materialization": [ { "ir_key": "method.model_pointer", "ir_value_type": "String", "storage_type": "DIRECT_VALUE" } ] }, "rng": { "anyOf": [ { "$ref": "#/$defs/RngOptionsContext2Mt19937" }, { "$ref": "#/$defs/RngOptionsContext2Rnum2" } ], "description": "Selection of a random number generator", "title": "Rng", "x-model-default": "RngOptionsContext2Mt19937", "x-union-pattern": 1 }, "max_function_evaluations": { "default": 9223372036854775807, "description": "Stopping criterion based on maximum function evaluations", "minimum": 0, "title": "Max Function Evaluations", "type": "integer", "x-materialization": [ { "ir_key": "method.max_function_evaluations", "ir_value_type": "size_t", "storage_type": "DIRECT_VALUE" } ] }, "max_iterations": { "default": 9223372036854775807, "description": "Number of iterations allowed for optimizers and adaptive UQ methods", "minimum": 0, "title": "Max Iterations", "type": "integer", "x-materialization": [ { "ir_key": "method.max_iterations", "ir_value_type": "size_t", "storage_type": "DIRECT_VALUE" } ] }, "convergence_tolerance": { "anyOf": [ { "$ref": "#/$defs/MethodConvergenceTolWithTypeContext3ConvergenceTol" }, { "type": "null" } ], "argument": "value", "default": null, "description": "Stopping criterion based on relative error reduction" }, "sample_type": { "anyOf": [ { "$ref": "#/$defs/MethodSampleTypeLhsMcLhs" }, { "$ref": "#/$defs/MethodSampleTypeLhsMcRandom" }, { "type": "null" } ], "default": null, "description": "Selection of sampling strategy", "title": "Sample Type", "x-union-pattern": 2 }, "seed_sequence": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Sequence of seed values for multi-stage random sampling", "title": "Seed Sequence", "x-materialization": [ { "ir_key": "method.random_seed_sequence", "ir_value_type": "SizetArray", "storage_type": "DIRECT_VALUE" } ] }, "fixed_seed": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Reuses the same seed value for multiple random sampling sets", "title": "Fixed Seed", "x-materialization": [ { "ir_key": "method.fixed_seed", "ir_value_type": "bool", "storage_type": "PRESENCE_TRUE" } ] }, "solver_metric": { "anyOf": [ { "$ref": "#/$defs/MethodMlmfSolverMetricAverageEstimatorVariance" }, { "$ref": "#/$defs/MethodMlmfSolverMetricNormEstimatorVariance" }, { "$ref": "#/$defs/MethodMlmfSolverMetricMaxEstimatorVariance" }, { "type": "null" } ], "default": null, "description": "Metric employed during numerical solutions in sampling-based multifidelity UQ methods.", "title": "Solver Metric", "x-union-pattern": 2 }, "optimization_solver": { "anchor": true, "anyOf": [ { "$ref": "#/$defs/MethodMlmfSubProblemSolverSqp" }, { "$ref": "#/$defs/MethodMlmfSubProblemSolverNip" }, { "$ref": "#/$defs/MethodMlmfSubProblemSolverGlobalLocal" }, { "$ref": "#/$defs/MethodMlmfSubProblemSolverCompetedLocal" }, { "type": "null" } ], "default": null, "description": "Optimization Solver", "title": "Optimization Solver", "x-union-pattern": 2 }, "solution_mode": { "anyOf": [ { "$ref": "#/$defs/OnlinePilot" }, { "$ref": "#/$defs/OfflinePilot" }, { "$ref": "#/$defs/OnlineProjection" }, { "$ref": "#/$defs/OfflineProjection" } ], "description": "Solution mode for multilevel/multifidelity methods", "title": "Solution Mode", "x-model-default": "OnlinePilot", "x-union-pattern": 1 }, "pilot_samples": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Initial set of samples for multilevel/multifidelity sampling methods.", "title": "Pilot Samples", "x-aliases": [ "initial_samples" ], "x-materialization": [ { "ir_key": "method.nond.pilot_samples", "ir_value_type": "SizetArray", "storage_type": "DIRECT_VALUE" } ] }, "id_method": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Name the method block; helpful when there are multiple", "title": "Id Method", "x-materialization": [ { "ir_key": "method.id", "ir_value_type": "String", "storage_type": "DIRECT_VALUE" } ] }, "output": { "anyOf": [ { "$ref": "#/$defs/Debug" }, { "$ref": "#/$defs/Verbose" }, { "$ref": "#/$defs/Normal" }, { "$ref": "#/$defs/Quiet" }, { "$ref": "#/$defs/Silent" } ], "description": "Control how much method information is written to the screen and output file", "title": "Output", "x-model-default": "Normal", "x-union-pattern": 1 }, "final_solutions": { "default": 0, "description": "Number of designs returned as the best solutions", "minimum": 0, "title": "Final Solutions", "type": "integer", "x-materialization": [ { "ir_key": "method.final_solutions", "ir_value_type": "size_t", "storage_type": "DIRECT_VALUE" } ] }, "solution_approach": { "anchor": true, "anyOf": [ { "$ref": "#/$defs/AcvIndependentSampling" }, { "$ref": "#/$defs/AcvMultifidelity" }, { "$ref": "#/$defs/AcvRecursiveDiff" } ], "description": "Solution Approach", "title": "Solution Approach", "x-union-pattern": 4 }, "search_model_graphs": { "anyOf": [ { "$ref": "#/$defs/ApproximateControlVariateSearchModelGraphs" }, { "type": "null" } ], "default": null, "description": "Perform a recursion of admissible DAGs for a given model ensemble" }, "truth_fixed_by_pilot": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Option to suppress any increment to the number of truth samples", "title": "Truth Fixed By Pilot", "x-materialization": [ { "ir_key": "method.nond.truth_fixed_by_pilot", "ir_value_type": "bool", "storage_type": "PRESENCE_TRUE" } ] }, "export_sample_sequence": { "anyOf": [ { "$ref": "#/$defs/ApproximateControlVariateExportSampleSequence" }, { "type": "null" } ], "default": null, "description": "Enable export of multilevel/multifidelity sample sequences to individual files", "x-materialization": [ { "ir_key": "method.nond.export_sample_sequence", "ir_value_type": "bool", "storage_type": "PRESENCE_TRUE" } ] } }, "required": [ "solution_approach" ], "title": "ApproximateControlVariateConfig", "type": "object", "x-model-validations": [ { "validationContext": "methodseedsequencemixin", "validationErrorMessage": "For methodseedsequencemixin, all elements of seed_sequence must be >= 0.", "validationFields": [ "seed_sequence" ], "validationLiterals": [], "validationRuleName": "check_nonnegative_list" } ] }, "ApproximateControlVariateExportSampleSequence": { "additionalProperties": false, "description": "Enable export of multilevel/multifidelity sample sequences to individual files", "properties": { "format": { "anchor": true, "anyOf": [ { "$ref": "#/$defs/MethodExportSamplesFormatCustomAnnotated" }, { "$ref": "#/$defs/MethodExportSamplesFormatAnnotated" }, { "$ref": "#/$defs/MethodExportSamplesFormatFreeform" } ], "description": "Tabular Format", "title": "Format", "x-model-default": "MethodExportSamplesFormatAnnotated", "x-union-pattern": 1 } }, "title": "ApproximateControlVariateExportSampleSequence", "type": "object" }, "ApproximateControlVariateSearchModelGraphs": { "additionalProperties": false, "description": "Perform a recursion of admissible DAGs for a given model ensemble", "properties": { "model_selection": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Perform a recursion of admissible model subsets for a given model ensemble", "title": "Model Selection", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.selection", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "ALL_MODEL_COMBINATIONS" } ] }, "dag_recursion": { "anchor": true, "anyOf": [ { "$ref": "#/$defs/ApproximateControlVariateSearchModelGraphsNoRecursion" }, { "$ref": "#/$defs/KlRecursion" }, { "$ref": "#/$defs/PartialRecursion" }, { "$ref": "#/$defs/ApproximateControlVariateSearchModelGraphsFullRecursion" } ], "description": "DAG Ensemble Generation Option", "title": "Dag Recursion", "x-union-pattern": 4 } }, "required": [ "dag_recursion" ], "title": "ApproximateControlVariateSearchModelGraphs", "type": "object" }, "ApproximateControlVariateSearchModelGraphsFullRecursion": { "additionalProperties": false, "description": "Perform a full recursion of all admissible DAGs for a given model ensemble", "properties": { "full_recursion": { "const": true, "default": true, "description": "Perform a full recursion of all admissible DAGs for a given model ensemble", "title": "Full Recursion", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "FULL_GRAPH_RECURSION" } ] } }, "title": "ApproximateControlVariateSearchModelGraphsFullRecursion", "type": "object" }, "ApproximateControlVariateSearchModelGraphsNoRecursion": { "additionalProperties": false, "description": "Do not recur over admissible DAGs for a given model ensemble", "properties": { "no_recursion": { "const": true, "default": true, "description": "Do not recur over admissible DAGs for a given model ensemble", "title": "No Recursion", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "NO_GRAPH_RECURSION" } ] } }, "title": "ApproximateControlVariateSearchModelGraphsNoRecursion", "type": "object" }, "Debug": { "additionalProperties": false, "description": "Level 5 of 5 - maximum", "properties": { "debug": { "const": true, "default": true, "description": "Level 5 of 5 - maximum", "title": "Debug", "type": "boolean", "x-materialization": [ { "ir_key": "method.output", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "DEBUG_OUTPUT" } ] } }, "title": "Debug", "type": "object" }, "KlRecursion": { "additionalProperties": false, "description": "Model graph enumeration that follows the ACV-KL partitioning scheme", "properties": { "kl_recursion": { "const": true, "default": true, "description": "Model graph enumeration that follows the ACV-KL partitioning scheme", "title": "Kl Recursion", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "KL_GRAPH_RECURSION" } ] } }, "title": "KlRecursion", "type": "object" }, "MethodConvergenceTolWithTypeContext3Absolute": { "additionalProperties": false, "description": "Use absolute statistical metrics for assessing convergence in adaptive UQ methods", "properties": { "absolute": { "const": true, "default": true, "description": "Use absolute statistical metrics for assessing convergence in adaptive UQ methods", "title": "Absolute", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.convergence_tolerance_type", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "ABSOLUTE_CONVERGENCE_TOLERANCE" } ] } }, "title": "MethodConvergenceTolWithTypeContext3Absolute", "type": "object" }, "MethodConvergenceTolWithTypeContext3ConvergenceTol": { "additionalProperties": false, "description": "Stopping criterion based on relative error reduction", "properties": { "value": { "default": -1.7976931348623157e+308, "description": "Stopping criterion based on relative error reduction", "title": "Value", "type": "number", "x-materialization": [ { "ir_key": "method.convergence_tolerance", "ir_value_type": "Real", "storage_type": "DIRECT_VALUE" }, { "ir_key": "method.jega.percent_change", "ir_value_type": "Real", "storage_type": "DIRECT_VALUE" } ] }, "convergence_tolerance_type": { "anchor": true, "anyOf": [ { "$ref": "#/$defs/MethodConvergenceTolWithTypeContext3Relative" }, { "$ref": "#/$defs/MethodConvergenceTolWithTypeContext3Absolute" }, { "type": "null" } ], "default": null, "description": "Convergence tolerance type", "title": "Convergence Tolerance Type", "x-union-pattern": 2 } }, "title": "MethodConvergenceTolWithTypeContext3ConvergenceTol", "type": "object" }, "MethodConvergenceTolWithTypeContext3Relative": { "additionalProperties": false, "description": "Assess convergence in adaptive UQ methods using statistical metrics that are relative to a benchmark", "properties": { "relative": { "const": true, "default": true, "description": "Assess convergence in adaptive UQ methods using statistical metrics that are relative to a benchmark", "title": "Relative", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.convergence_tolerance_type", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "RELATIVE_CONVERGENCE_TOLERANCE" } ] } }, "title": "MethodConvergenceTolWithTypeContext3Relative", "type": "object" }, "MethodExportSamplesFormatAnnotated": { "additionalProperties": false, "description": "Selects annotated tabular file format", "properties": { "annotated": { "const": true, "default": true, "description": "Selects annotated tabular file format", "title": "Annotated", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "TABULAR_ANNOTATED" } ] } }, "title": "MethodExportSamplesFormatAnnotated", "type": "object" }, "MethodExportSamplesFormatCustomAnnotated": { "additionalProperties": false, "description": "Selects custom-annotated tabular file format", "properties": { "custom_annotated": { "$ref": "#/$defs/MethodExportSamplesFormatCustomAnnotatedConfig", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "TABULAR_NONE" } ], "x-model-default": "MethodExportSamplesFormatCustomAnnotatedConfig" } }, "title": "MethodExportSamplesFormatCustomAnnotated", "type": "object" }, "MethodExportSamplesFormatCustomAnnotatedConfig": { "additionalProperties": false, "description": "Selects custom-annotated tabular file format", "properties": { "header": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Enable header row in custom-annotated tabular file", "title": "Header", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "AUGMENT_ENUM", "stored_value": "TABULAR_HEADER" } ] }, "eval_id": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Enable evaluation ID column in custom-annotated tabular file", "title": "Eval Id", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "AUGMENT_ENUM", "stored_value": "TABULAR_EVAL_ID" } ] }, "interface_id": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Enable interface ID column in custom-annotated tabular file", "title": "Interface Id", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "AUGMENT_ENUM", "stored_value": "TABULAR_IFACE_ID" } ] } }, "title": "MethodExportSamplesFormatCustomAnnotatedConfig", "type": "object" }, "MethodExportSamplesFormatFreeform": { "additionalProperties": false, "description": "Selects freeform file format", "properties": { "freeform": { "const": true, "default": true, "description": "Selects freeform file format", "title": "Freeform", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "TABULAR_NONE" } ] } }, "title": "MethodExportSamplesFormatFreeform", "type": "object" }, "MethodMlmfSolverMetricAverageEstimatorVariance": { "additionalProperties": false, "description": "Utilize the estimator variance averaged over the QoI as the solver metric for sampling-based multifidelity methods.", "properties": { "average_estimator_variance": { "const": true, "default": true, "description": "Utilize the estimator variance averaged over the QoI as the solver metric for sampling-based multifidelity methods.", "title": "Average Estimator Variance", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.estimator_variance_metric", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "AVG_ESTVAR_METRIC" } ] } }, "title": "MethodMlmfSolverMetricAverageEstimatorVariance", "type": "object" }, "MethodMlmfSolverMetricMaxEstimatorVariance": { "additionalProperties": false, "description": "Utilize the maximum estimator variance as the solver metric for sampling-based multifidelity methods.", "properties": { "max_estimator_variance": { "const": true, "default": true, "description": "Utilize the maximum estimator variance as the solver metric for sampling-based multifidelity methods.", "title": "Max Estimator Variance", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.estimator_variance_metric", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "MAX_ESTVAR_METRIC" } ] } }, "title": "MethodMlmfSolverMetricMaxEstimatorVariance", "type": "object" }, "MethodMlmfSolverMetricNormEstimatorVariance": { "additionalProperties": false, "description": "Utilize a p-norm over the vector of QoI estimator variances as the solver metric for sampling-based multifidelity methods.", "properties": { "norm_estimator_variance": { "$ref": "#/$defs/MethodMlmfSolverMetricNormEstimatorVarianceConfig", "x-materialization": [ { "ir_key": "method.nond.estimator_variance_metric", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "NORM_ESTVAR_METRIC" } ] } }, "required": [ "norm_estimator_variance" ], "title": "MethodMlmfSolverMetricNormEstimatorVariance", "type": "object" }, "MethodMlmfSolverMetricNormEstimatorVarianceConfig": { "additionalProperties": false, "description": "Utilize a p-norm over the vector of QoI estimator variances as the solver metric for sampling-based multifidelity methods.", "properties": { "norm_order": { "default": 2.0, "description": "Utilize the response covariance metric for guiding adaptive refinement during UQ.", "minimum": 1.0, "title": "Norm Order", "type": "number", "x-materialization": [ { "ir_key": "method.nond.estimator_variance_metric_norm_order", "ir_value_type": "Real", "storage_type": "DIRECT_VALUE" } ] } }, "title": "MethodMlmfSolverMetricNormEstimatorVarianceConfig", "type": "object" }, "MethodMlmfSubProblemSolverCompetedLocal": { "additionalProperties": false, "description": "Use a competed local solver scheme for solving an optimization sub-problem", "properties": { "competed_local": { "const": true, "default": true, "description": "Use a competed local solver scheme for solving an optimization sub-problem", "title": "Competed Local", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.opt_subproblem_solver", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_NPSOL_OPTPP" } ] } }, "title": "MethodMlmfSubProblemSolverCompetedLocal", "type": "object" }, "MethodMlmfSubProblemSolverGlobalLocal": { "additionalProperties": false, "description": "Use a hybrid global-local scheme for solving an optimization sub-problem", "properties": { "global_local": { "const": true, "default": true, "description": "Use a hybrid global-local scheme for solving an optimization sub-problem", "title": "Global Local", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.opt_subproblem_solver", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_DIRECT_NPSOL_OPTPP" } ] } }, "title": "MethodMlmfSubProblemSolverGlobalLocal", "type": "object" }, "MethodMlmfSubProblemSolverNip": { "additionalProperties": false, "description": "Use a nonlinear interior point method for solving an optimization sub-problem", "properties": { "nip": { "const": true, "default": true, "description": "Use a nonlinear interior point method for solving an optimization sub-problem", "title": "Nip", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.opt_subproblem_solver", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_OPTPP" } ] } }, "title": "MethodMlmfSubProblemSolverNip", "type": "object" }, "MethodMlmfSubProblemSolverSqp": { "additionalProperties": false, "description": "Use a sequential quadratic programming method for solving an optimization sub-problem", "properties": { "sqp": { "const": true, "default": true, "description": "Use a sequential quadratic programming method for solving an optimization sub-problem", "title": "Sqp", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.opt_subproblem_solver", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_NPSOL" } ] } }, "title": "MethodMlmfSubProblemSolverSqp", "type": "object" }, "MethodSampleTypeLhsMcLhs": { "additionalProperties": false, "description": "Uses Latin Hypercube Sampling (LHS) to sample variables", "properties": { "lhs": { "const": true, "default": true, "description": "Uses Latin Hypercube Sampling (LHS) to sample variables", "title": "Lhs", "type": "boolean", "x-materialization": [ { "ir_key": "method.sample_type", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_LHS" } ] } }, "title": "MethodSampleTypeLhsMcLhs", "type": "object" }, "MethodSampleTypeLhsMcRandom": { "additionalProperties": false, "description": "Uses purely random Monte Carlo sampling to sample variables", "properties": { "random": { "const": true, "default": true, "description": "Uses purely random Monte Carlo sampling to sample variables", "title": "Random", "type": "boolean", "x-materialization": [ { "ir_key": "method.sample_type", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_RANDOM" } ] } }, "title": "MethodSampleTypeLhsMcRandom", "type": "object" }, "Normal": { "additionalProperties": false, "description": "Level 3 of 5 - default", "properties": { "normal": { "const": true, "default": true, "description": "Level 3 of 5 - default", "title": "Normal", "type": "boolean", "x-materialization": [ { "ir_key": "method.output", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "NORMAL_OUTPUT" } ] } }, "title": "Normal", "type": "object" }, "OfflinePilot": { "additionalProperties": false, "description": "Specify a solution mode that excludes the pilot cost from sample allocation logic", "properties": { "offline_pilot": { "$ref": "#/$defs/OfflinePilotConfig", "x-materialization": [ { "ir_key": "method.nond.ensemble_pilot_solution_mode", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "OFFLINE_PILOT" } ], "x-model-default": "OfflinePilotConfig" } }, "title": "OfflinePilot", "type": "object" }, "OfflinePilotConfig": { "additionalProperties": false, "description": "Specify a solution mode that excludes the pilot cost from sample allocation logic", "properties": { "final_statistics": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotFinalStatisticsEstimatorPerformance" }, { "$ref": "#/$defs/OfflinePilotFinalStatisticsQoiStatistics" }, { "type": "null" } ], "default": null, "description": "Indicate the type of final statistics to be returned by a UQ method", "title": "Final Statistics", "x-union-pattern": 2 } }, "title": "OfflinePilotConfig", "type": "object" }, "OfflinePilotFinalStatisticsQoiStatistics": { "additionalProperties": false, "description": "Return the quantity of interest (QoI) statistics as the final results of a UQ method", "properties": { "qoi_statistics": { "$ref": "#/$defs/OfflinePilotFinalStatisticsQoiStatisticsConfig", "x-materialization": [ { "ir_key": "method.nond.final_statistics", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "QOI_STATISTICS" } ] } }, "required": [ "qoi_statistics" ], "title": "OfflinePilotFinalStatisticsQoiStatistics", "type": "object" }, "OfflinePilotFinalStatisticsQoiStatisticsConfig": { "additionalProperties": false, "description": "Return the quantity of interest (QoI) statistics as the final results of a UQ method", "properties": { "final_moments": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsNone" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsStandard" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsCentral" } ], "description": "Output moments of the specified type and include them within the set of final statistics.", "title": "Final Moments", "x-model-default": "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsStandard", "x-union-pattern": 1 }, "distribution": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsDistributionCumulative" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsDistributionComplementary" } ], "description": "Placeholder for future capabilities", "title": "Distribution", "x-model-default": "OnlinePilotFinalStatisticsQoiStatisticsDistributionCumulative", "x-union-pattern": 1 } }, "title": "OfflinePilotFinalStatisticsQoiStatisticsConfig", "type": "object" }, "OfflineProjection": { "additionalProperties": false, "description": "Specify a solution mode that estimates performance based on projecting initial correlation/variance estimates from an offline pilot sample", "properties": { "offline_projection": { "const": true, "default": true, "description": "Specify a solution mode that estimates performance based on projecting initial correlation/variance estimates from an offline pilot sample", "title": "Offline Projection", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.ensemble_pilot_solution_mode", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "OFFLINE_PILOT_PROJECTION" } ] } }, "title": "OfflineProjection", "type": "object" }, "OnlinePilot": { "additionalProperties": false, "description": "Specify a solution mode that includes the pilot cost within the sample allocation logic", "properties": { "online_pilot": { "$ref": "#/$defs/OnlinePilotConfig", "x-materialization": [ { "ir_key": "method.nond.ensemble_pilot_solution_mode", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "ONLINE_PILOT" } ], "x-model-default": "OnlinePilotConfig" } }, "title": "OnlinePilot", "type": "object" }, "OnlinePilotConfig": { "additionalProperties": false, "description": "Specify a solution mode that includes the pilot cost within the sample allocation logic", "properties": { "relaxation": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotRelaxationFactorSequence" }, { "$ref": "#/$defs/OnlinePilotRelaxationFixedFactor" }, { "$ref": "#/$defs/OnlinePilotRelaxationRecursiveFactor" }, { "type": "null" } ], "default": null, "description": "For an online pilot mode, apply under-relaxation to the shared sample increments", "title": "Relaxation", "x-union-pattern": 2 }, "final_statistics": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotFinalStatisticsEstimatorPerformance" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatistics" }, { "type": "null" } ], "default": null, "description": "Indicate the type of final statistics to be returned by a UQ method", "title": "Final Statistics", "x-union-pattern": 2 } }, "title": "OnlinePilotConfig", "type": "object" }, "OnlinePilotFinalStatisticsEstimatorPerformance": { "additionalProperties": false, "description": "Return estimator performance as the final results of a UQ method", "properties": { "estimator_performance": { "const": true, "default": true, "description": "Return estimator performance as the final results of a UQ method", "title": "Estimator Performance", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.final_statistics", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "ESTIMATOR_PERFORMANCE" } ] } }, "title": "OnlinePilotFinalStatisticsEstimatorPerformance", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatistics": { "additionalProperties": false, "description": "Return the quantity of interest (QoI) statistics as the final results of a UQ method", "properties": { "qoi_statistics": { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsConfig", "x-materialization": [ { "ir_key": "method.nond.final_statistics", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "QOI_STATISTICS" } ] } }, "required": [ "qoi_statistics" ], "title": "OnlinePilotFinalStatisticsQoiStatistics", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatisticsConfig": { "additionalProperties": false, "description": "Return the quantity of interest (QoI) statistics as the final results of a UQ method", "properties": { "final_moments": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsNone" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsStandard" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsCentral" } ], "description": "Output moments of the specified type and include them within the set of final statistics.", "title": "Final Moments", "x-model-default": "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsStandard", "x-union-pattern": 1 }, "distribution": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsDistributionCumulative" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsDistributionComplementary" } ], "description": "Placeholder for future capabilities", "title": "Distribution", "x-model-default": "OnlinePilotFinalStatisticsQoiStatisticsDistributionCumulative", "x-union-pattern": 1 } }, "title": "OnlinePilotFinalStatisticsQoiStatisticsConfig", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatisticsDistributionComplementary": { "additionalProperties": false, "description": "Placeholder for future capabilities", "properties": { "complementary": { "const": true, "default": true, "description": "Placeholder for future capabilities", "title": "Complementary", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.distribution", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "COMPLEMENTARY" } ] } }, "title": "OnlinePilotFinalStatisticsQoiStatisticsDistributionComplementary", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatisticsDistributionCumulative": { "additionalProperties": false, "description": "Placeholder for future capabilities", "properties": { "cumulative": { "const": true, "default": true, "description": "Placeholder for future capabilities", "title": "Cumulative", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.distribution", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "CUMULATIVE" } ] } }, "title": "OnlinePilotFinalStatisticsQoiStatisticsDistributionCumulative", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsCentral": { "additionalProperties": false, "description": "Output central moments and include them within the set of final statistics.", "properties": { "central": { "const": true, "default": true, "description": "Output central moments and include them within the set of final statistics.", "title": "Central", "type": "boolean", "x-materialization": [ { "enum_scope": "Pecos", "ir_key": "method.nond.final_moments", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "CENTRAL_MOMENTS" } ] } }, "title": "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsCentral", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsNone": { "additionalProperties": false, "description": "Omit moments from the set of final statistics.", "properties": { "none": { "const": true, "default": true, "description": "Omit moments from the set of final statistics.", "title": "None", "type": "boolean", "x-materialization": [ { "enum_scope": "Pecos", "ir_key": "method.nond.final_moments", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "NO_MOMENTS" } ] } }, "title": "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsNone", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsStandard": { "additionalProperties": false, "description": "Output standardized moments and include them within the set of final statistics.", "properties": { "standard": { "const": true, "default": true, "description": "Output standardized moments and include them within the set of final statistics.", "title": "Standard", "type": "boolean", "x-materialization": [ { "enum_scope": "Pecos", "ir_key": "method.nond.final_moments", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "STANDARD_MOMENTS" } ] } }, "title": "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsStandard", "type": "object" }, "OnlinePilotRelaxationFactorSequence": { "additionalProperties": false, "description": "For under-relaxation of shared sample increments, apply a sequence of factors, one per iteration", "properties": { "factor_sequence": { "description": "For under-relaxation of shared sample increments, apply a sequence of factors, one per iteration", "items": { "type": "number" }, "title": "Factor Sequence", "type": "array", "x-materialization": [ { "ir_key": "method.nond.relaxation.factor_sequence", "ir_value_type": "RealVector", "storage_type": "DIRECT_VALUE" } ] } }, "required": [ "factor_sequence" ], "title": "OnlinePilotRelaxationFactorSequence", "type": "object" }, "OnlinePilotRelaxationFixedFactor": { "additionalProperties": false, "description": "For under-relaxation of shared sample increments, apply a fixed factor that is invariant with iteration", "properties": { "fixed_factor": { "description": "For under-relaxation of shared sample increments, apply a fixed factor that is invariant with iteration", "title": "Fixed Factor", "type": "number", "x-materialization": [ { "ir_key": "method.nond.relaxation.fixed_factor", "ir_value_type": "Real", "storage_type": "DIRECT_VALUE" } ] } }, "required": [ "fixed_factor" ], "title": "OnlinePilotRelaxationFixedFactor", "type": "object" }, "OnlinePilotRelaxationRecursiveFactor": { "additionalProperties": false, "description": "For under-relaxation of shared sample increments, apply a recursive factor on each iteration that advances the relaxation factor toward 1", "properties": { "recursive_factor": { "description": "For under-relaxation of shared sample increments, apply a recursive factor on each iteration that advances the relaxation factor toward 1", "title": "Recursive Factor", "type": "number", "x-materialization": [ { "ir_key": "method.nond.relaxation.recursive_factor", "ir_value_type": "Real", "storage_type": "DIRECT_VALUE" } ] } }, "required": [ "recursive_factor" ], "title": "OnlinePilotRelaxationRecursiveFactor", "type": "object" }, "OnlineProjection": { "additionalProperties": false, "description": "Specify a solution mode that estimates performance based on projecting initial correlation / covariance estimates from an online pilot sample", "properties": { "online_projection": { "const": true, "default": true, "description": "Specify a solution mode that estimates performance based on projecting initial correlation / covariance estimates from an online pilot sample", "title": "Online Projection", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.ensemble_pilot_solution_mode", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "ONLINE_PILOT_PROJECTION" } ] } }, "title": "OnlineProjection", "type": "object" }, "PartialRecursion": { "additionalProperties": false, "description": "Perform a partial recursion of admissible DAGs", "properties": { "partial_recursion": { "$ref": "#/$defs/PartialRecursionConfig", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "PARTIAL_GRAPH_RECURSION" } ] } }, "required": [ "partial_recursion" ], "title": "PartialRecursion", "type": "object" }, "PartialRecursionConfig": { "additionalProperties": false, "description": "Perform a partial recursion of admissible DAGs", "properties": { "depth_limit": { "description": "Throttle the depth for a partial recursion of admissible DAGs", "title": "Depth Limit", "type": "integer", "x-materialization": [ { "ir_key": "method.nond.graph_depth_limit", "ir_value_type": "unsigned short", "storage_type": "DIRECT_VALUE" } ] } }, "required": [ "depth_limit" ], "title": "PartialRecursionConfig", "type": "object" }, "Quiet": { "additionalProperties": false, "description": "Level 2 of 5 - less than normal", "properties": { "quiet": { "const": true, "default": true, "description": "Level 2 of 5 - less than normal", "title": "Quiet", "type": "boolean", "x-materialization": [ { "ir_key": "method.output", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "QUIET_OUTPUT" } ] } }, "title": "Quiet", "type": "object" }, "RngOptionsContext2Mt19937": { "additionalProperties": false, "description": "Generates random numbers using the Mersenne twister", "properties": { "mt19937": { "const": true, "default": true, "description": "Generates random numbers using the Mersenne twister", "title": "Mt19937", "type": "boolean", "x-materialization": [ { "ir_key": "method.random_number_generator", "ir_value_type": "String", "storage_type": "PRESENCE_LITERAL", "stored_value": "mt19937" } ] } }, "title": "RngOptionsContext2Mt19937", "type": "object" }, "RngOptionsContext2Rnum2": { "additionalProperties": false, "description": "Generates pseudo-random numbers using the Pecos package", "properties": { "rnum2": { "const": true, "default": true, "description": "Generates pseudo-random numbers using the Pecos package", "title": "Rnum2", "type": "boolean", "x-materialization": [ { "ir_key": "method.random_number_generator", "ir_value_type": "String", "storage_type": "PRESENCE_LITERAL", "stored_value": "rnum2" } ] } }, "title": "RngOptionsContext2Rnum2", "type": "object" }, "Silent": { "additionalProperties": false, "description": "Level 1 of 5 - minimum", "properties": { "silent": { "const": true, "default": true, "description": "Level 1 of 5 - minimum", "title": "Silent", "type": "boolean", "x-materialization": [ { "ir_key": "method.output", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "SILENT_OUTPUT" } ] } }, "title": "Silent", "type": "object" }, "Verbose": { "additionalProperties": false, "description": "Level 4 of 5 - more than normal", "properties": { "verbose": { "const": true, "default": true, "description": "Level 4 of 5 - more than normal", "title": "Verbose", "type": "boolean", "x-materialization": [ { "ir_key": "method.output", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "VERBOSE_OUTPUT" } ] } }, "title": "Verbose", "type": "object" } }, "additionalProperties": false, "required": [ "approximate_control_variate" ] }
- field approximate_control_variate: ApproximateControlVariateConfig [Required]
- classmethod get_registry() dict[str, type[MethodSelection]]
Get registry, performing deferred registration on first call
- classmethod get_union()
Generate Union from all registered selections
- pydantic model dakota.spec.method.approximate_control_variate.ApproximateControlVariateConfig
Approximate control variate (ACV) sampling methods for UQ
Show JSON schema
{ "title": "ApproximateControlVariateConfig", "description": "Approximate control variate (ACV) sampling methods for UQ", "type": "object", "properties": { "model_pointer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Identifier for model block to be used by a method", "title": "Model Pointer", "x-block-pointer": "model", "x-materialization": [ { "ir_key": "method.model_pointer", "ir_value_type": "String", "storage_type": "DIRECT_VALUE" } ] }, "rng": { "anyOf": [ { "$ref": "#/$defs/RngOptionsContext2Mt19937" }, { "$ref": "#/$defs/RngOptionsContext2Rnum2" } ], "description": "Selection of a random number generator", "title": "Rng", "x-model-default": "RngOptionsContext2Mt19937", "x-union-pattern": 1 }, "max_function_evaluations": { "default": 9223372036854775807, "description": "Stopping criterion based on maximum function evaluations", "minimum": 0, "title": "Max Function Evaluations", "type": "integer", "x-materialization": [ { "ir_key": "method.max_function_evaluations", "ir_value_type": "size_t", "storage_type": "DIRECT_VALUE" } ] }, "max_iterations": { "default": 9223372036854775807, "description": "Number of iterations allowed for optimizers and adaptive UQ methods", "minimum": 0, "title": "Max Iterations", "type": "integer", "x-materialization": [ { "ir_key": "method.max_iterations", "ir_value_type": "size_t", "storage_type": "DIRECT_VALUE" } ] }, "convergence_tolerance": { "anyOf": [ { "$ref": "#/$defs/MethodConvergenceTolWithTypeContext3ConvergenceTol" }, { "type": "null" } ], "argument": "value", "default": null, "description": "Stopping criterion based on relative error reduction" }, "sample_type": { "anyOf": [ { "$ref": "#/$defs/MethodSampleTypeLhsMcLhs" }, { "$ref": "#/$defs/MethodSampleTypeLhsMcRandom" }, { "type": "null" } ], "default": null, "description": "Selection of sampling strategy", "title": "Sample Type", "x-union-pattern": 2 }, "seed_sequence": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Sequence of seed values for multi-stage random sampling", "title": "Seed Sequence", "x-materialization": [ { "ir_key": "method.random_seed_sequence", "ir_value_type": "SizetArray", "storage_type": "DIRECT_VALUE" } ] }, "fixed_seed": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Reuses the same seed value for multiple random sampling sets", "title": "Fixed Seed", "x-materialization": [ { "ir_key": "method.fixed_seed", "ir_value_type": "bool", "storage_type": "PRESENCE_TRUE" } ] }, "solver_metric": { "anyOf": [ { "$ref": "#/$defs/MethodMlmfSolverMetricAverageEstimatorVariance" }, { "$ref": "#/$defs/MethodMlmfSolverMetricNormEstimatorVariance" }, { "$ref": "#/$defs/MethodMlmfSolverMetricMaxEstimatorVariance" }, { "type": "null" } ], "default": null, "description": "Metric employed during numerical solutions in sampling-based multifidelity UQ methods.", "title": "Solver Metric", "x-union-pattern": 2 }, "optimization_solver": { "anchor": true, "anyOf": [ { "$ref": "#/$defs/MethodMlmfSubProblemSolverSqp" }, { "$ref": "#/$defs/MethodMlmfSubProblemSolverNip" }, { "$ref": "#/$defs/MethodMlmfSubProblemSolverGlobalLocal" }, { "$ref": "#/$defs/MethodMlmfSubProblemSolverCompetedLocal" }, { "type": "null" } ], "default": null, "description": "Optimization Solver", "title": "Optimization Solver", "x-union-pattern": 2 }, "solution_mode": { "anyOf": [ { "$ref": "#/$defs/OnlinePilot" }, { "$ref": "#/$defs/OfflinePilot" }, { "$ref": "#/$defs/OnlineProjection" }, { "$ref": "#/$defs/OfflineProjection" } ], "description": "Solution mode for multilevel/multifidelity methods", "title": "Solution Mode", "x-model-default": "OnlinePilot", "x-union-pattern": 1 }, "pilot_samples": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Initial set of samples for multilevel/multifidelity sampling methods.", "title": "Pilot Samples", "x-aliases": [ "initial_samples" ], "x-materialization": [ { "ir_key": "method.nond.pilot_samples", "ir_value_type": "SizetArray", "storage_type": "DIRECT_VALUE" } ] }, "id_method": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Name the method block; helpful when there are multiple", "title": "Id Method", "x-materialization": [ { "ir_key": "method.id", "ir_value_type": "String", "storage_type": "DIRECT_VALUE" } ] }, "output": { "anyOf": [ { "$ref": "#/$defs/Debug" }, { "$ref": "#/$defs/Verbose" }, { "$ref": "#/$defs/Normal" }, { "$ref": "#/$defs/Quiet" }, { "$ref": "#/$defs/Silent" } ], "description": "Control how much method information is written to the screen and output file", "title": "Output", "x-model-default": "Normal", "x-union-pattern": 1 }, "final_solutions": { "default": 0, "description": "Number of designs returned as the best solutions", "minimum": 0, "title": "Final Solutions", "type": "integer", "x-materialization": [ { "ir_key": "method.final_solutions", "ir_value_type": "size_t", "storage_type": "DIRECT_VALUE" } ] }, "solution_approach": { "anchor": true, "anyOf": [ { "$ref": "#/$defs/AcvIndependentSampling" }, { "$ref": "#/$defs/AcvMultifidelity" }, { "$ref": "#/$defs/AcvRecursiveDiff" } ], "description": "Solution Approach", "title": "Solution Approach", "x-union-pattern": 4 }, "search_model_graphs": { "anyOf": [ { "$ref": "#/$defs/ApproximateControlVariateSearchModelGraphs" }, { "type": "null" } ], "default": null, "description": "Perform a recursion of admissible DAGs for a given model ensemble" }, "truth_fixed_by_pilot": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Option to suppress any increment to the number of truth samples", "title": "Truth Fixed By Pilot", "x-materialization": [ { "ir_key": "method.nond.truth_fixed_by_pilot", "ir_value_type": "bool", "storage_type": "PRESENCE_TRUE" } ] }, "export_sample_sequence": { "anyOf": [ { "$ref": "#/$defs/ApproximateControlVariateExportSampleSequence" }, { "type": "null" } ], "default": null, "description": "Enable export of multilevel/multifidelity sample sequences to individual files", "x-materialization": [ { "ir_key": "method.nond.export_sample_sequence", "ir_value_type": "bool", "storage_type": "PRESENCE_TRUE" } ] } }, "$defs": { "AcvIndependentSampling": { "additionalProperties": false, "description": "Sampling scheme within the approximate control variate (ACV) algorithm that employs independent samples (IS) across model pairings", "properties": { "acv_independent_sampling": { "const": true, "default": true, "description": "Sampling scheme within the approximate control variate (ACV) algorithm that employs independent samples (IS) across model pairings", "title": "Acv Independent Sampling", "type": "boolean", "x-aliases": [ "acv_is" ], "x-materialization": [ { "ir_key": "method.sub_method", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_ACV_IS" } ] } }, "title": "AcvIndependentSampling", "type": "object" }, "AcvMultifidelity": { "additionalProperties": false, "description": "Approximate control variate (ACV) algorithm that employs a nested pyramid sample pattern, similar to MFMC", "properties": { "acv_multifidelity": { "const": true, "default": true, "description": "Approximate control variate (ACV) algorithm that employs a nested pyramid sample pattern, similar to MFMC", "title": "Acv Multifidelity", "type": "boolean", "x-aliases": [ "acv_mf" ], "x-materialization": [ { "ir_key": "method.sub_method", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_ACV_MF" } ] } }, "title": "AcvMultifidelity", "type": "object" }, "AcvRecursiveDiff": { "additionalProperties": false, "description": "Sampling scheme within the approximate control variate (ACV) algorithm that employs weighted recursive differences (RD) across model pairings", "properties": { "acv_recursive_diff": { "const": true, "default": true, "description": "Sampling scheme within the approximate control variate (ACV) algorithm that employs weighted recursive differences (RD) across model pairings", "title": "Acv Recursive Diff", "type": "boolean", "x-aliases": [ "acv_rd" ], "x-materialization": [ { "ir_key": "method.sub_method", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_ACV_RD" } ] } }, "title": "AcvRecursiveDiff", "type": "object" }, "ApproximateControlVariateExportSampleSequence": { "additionalProperties": false, "description": "Enable export of multilevel/multifidelity sample sequences to individual files", "properties": { "format": { "anchor": true, "anyOf": [ { "$ref": "#/$defs/MethodExportSamplesFormatCustomAnnotated" }, { "$ref": "#/$defs/MethodExportSamplesFormatAnnotated" }, { "$ref": "#/$defs/MethodExportSamplesFormatFreeform" } ], "description": "Tabular Format", "title": "Format", "x-model-default": "MethodExportSamplesFormatAnnotated", "x-union-pattern": 1 } }, "title": "ApproximateControlVariateExportSampleSequence", "type": "object" }, "ApproximateControlVariateSearchModelGraphs": { "additionalProperties": false, "description": "Perform a recursion of admissible DAGs for a given model ensemble", "properties": { "model_selection": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Perform a recursion of admissible model subsets for a given model ensemble", "title": "Model Selection", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.selection", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "ALL_MODEL_COMBINATIONS" } ] }, "dag_recursion": { "anchor": true, "anyOf": [ { "$ref": "#/$defs/ApproximateControlVariateSearchModelGraphsNoRecursion" }, { "$ref": "#/$defs/KlRecursion" }, { "$ref": "#/$defs/PartialRecursion" }, { "$ref": "#/$defs/ApproximateControlVariateSearchModelGraphsFullRecursion" } ], "description": "DAG Ensemble Generation Option", "title": "Dag Recursion", "x-union-pattern": 4 } }, "required": [ "dag_recursion" ], "title": "ApproximateControlVariateSearchModelGraphs", "type": "object" }, "ApproximateControlVariateSearchModelGraphsFullRecursion": { "additionalProperties": false, "description": "Perform a full recursion of all admissible DAGs for a given model ensemble", "properties": { "full_recursion": { "const": true, "default": true, "description": "Perform a full recursion of all admissible DAGs for a given model ensemble", "title": "Full Recursion", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "FULL_GRAPH_RECURSION" } ] } }, "title": "ApproximateControlVariateSearchModelGraphsFullRecursion", "type": "object" }, "ApproximateControlVariateSearchModelGraphsNoRecursion": { "additionalProperties": false, "description": "Do not recur over admissible DAGs for a given model ensemble", "properties": { "no_recursion": { "const": true, "default": true, "description": "Do not recur over admissible DAGs for a given model ensemble", "title": "No Recursion", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "NO_GRAPH_RECURSION" } ] } }, "title": "ApproximateControlVariateSearchModelGraphsNoRecursion", "type": "object" }, "Debug": { "additionalProperties": false, "description": "Level 5 of 5 - maximum", "properties": { "debug": { "const": true, "default": true, "description": "Level 5 of 5 - maximum", "title": "Debug", "type": "boolean", "x-materialization": [ { "ir_key": "method.output", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "DEBUG_OUTPUT" } ] } }, "title": "Debug", "type": "object" }, "KlRecursion": { "additionalProperties": false, "description": "Model graph enumeration that follows the ACV-KL partitioning scheme", "properties": { "kl_recursion": { "const": true, "default": true, "description": "Model graph enumeration that follows the ACV-KL partitioning scheme", "title": "Kl Recursion", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "KL_GRAPH_RECURSION" } ] } }, "title": "KlRecursion", "type": "object" }, "MethodConvergenceTolWithTypeContext3Absolute": { "additionalProperties": false, "description": "Use absolute statistical metrics for assessing convergence in adaptive UQ methods", "properties": { "absolute": { "const": true, "default": true, "description": "Use absolute statistical metrics for assessing convergence in adaptive UQ methods", "title": "Absolute", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.convergence_tolerance_type", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "ABSOLUTE_CONVERGENCE_TOLERANCE" } ] } }, "title": "MethodConvergenceTolWithTypeContext3Absolute", "type": "object" }, "MethodConvergenceTolWithTypeContext3ConvergenceTol": { "additionalProperties": false, "description": "Stopping criterion based on relative error reduction", "properties": { "value": { "default": -1.7976931348623157e+308, "description": "Stopping criterion based on relative error reduction", "title": "Value", "type": "number", "x-materialization": [ { "ir_key": "method.convergence_tolerance", "ir_value_type": "Real", "storage_type": "DIRECT_VALUE" }, { "ir_key": "method.jega.percent_change", "ir_value_type": "Real", "storage_type": "DIRECT_VALUE" } ] }, "convergence_tolerance_type": { "anchor": true, "anyOf": [ { "$ref": "#/$defs/MethodConvergenceTolWithTypeContext3Relative" }, { "$ref": "#/$defs/MethodConvergenceTolWithTypeContext3Absolute" }, { "type": "null" } ], "default": null, "description": "Convergence tolerance type", "title": "Convergence Tolerance Type", "x-union-pattern": 2 } }, "title": "MethodConvergenceTolWithTypeContext3ConvergenceTol", "type": "object" }, "MethodConvergenceTolWithTypeContext3Relative": { "additionalProperties": false, "description": "Assess convergence in adaptive UQ methods using statistical metrics that are relative to a benchmark", "properties": { "relative": { "const": true, "default": true, "description": "Assess convergence in adaptive UQ methods using statistical metrics that are relative to a benchmark", "title": "Relative", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.convergence_tolerance_type", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "RELATIVE_CONVERGENCE_TOLERANCE" } ] } }, "title": "MethodConvergenceTolWithTypeContext3Relative", "type": "object" }, "MethodExportSamplesFormatAnnotated": { "additionalProperties": false, "description": "Selects annotated tabular file format", "properties": { "annotated": { "const": true, "default": true, "description": "Selects annotated tabular file format", "title": "Annotated", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "TABULAR_ANNOTATED" } ] } }, "title": "MethodExportSamplesFormatAnnotated", "type": "object" }, "MethodExportSamplesFormatCustomAnnotated": { "additionalProperties": false, "description": "Selects custom-annotated tabular file format", "properties": { "custom_annotated": { "$ref": "#/$defs/MethodExportSamplesFormatCustomAnnotatedConfig", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "TABULAR_NONE" } ], "x-model-default": "MethodExportSamplesFormatCustomAnnotatedConfig" } }, "title": "MethodExportSamplesFormatCustomAnnotated", "type": "object" }, "MethodExportSamplesFormatCustomAnnotatedConfig": { "additionalProperties": false, "description": "Selects custom-annotated tabular file format", "properties": { "header": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Enable header row in custom-annotated tabular file", "title": "Header", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "AUGMENT_ENUM", "stored_value": "TABULAR_HEADER" } ] }, "eval_id": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Enable evaluation ID column in custom-annotated tabular file", "title": "Eval Id", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "AUGMENT_ENUM", "stored_value": "TABULAR_EVAL_ID" } ] }, "interface_id": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Enable interface ID column in custom-annotated tabular file", "title": "Interface Id", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "AUGMENT_ENUM", "stored_value": "TABULAR_IFACE_ID" } ] } }, "title": "MethodExportSamplesFormatCustomAnnotatedConfig", "type": "object" }, "MethodExportSamplesFormatFreeform": { "additionalProperties": false, "description": "Selects freeform file format", "properties": { "freeform": { "const": true, "default": true, "description": "Selects freeform file format", "title": "Freeform", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "TABULAR_NONE" } ] } }, "title": "MethodExportSamplesFormatFreeform", "type": "object" }, "MethodMlmfSolverMetricAverageEstimatorVariance": { "additionalProperties": false, "description": "Utilize the estimator variance averaged over the QoI as the solver metric for sampling-based multifidelity methods.", "properties": { "average_estimator_variance": { "const": true, "default": true, "description": "Utilize the estimator variance averaged over the QoI as the solver metric for sampling-based multifidelity methods.", "title": "Average Estimator Variance", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.estimator_variance_metric", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "AVG_ESTVAR_METRIC" } ] } }, "title": "MethodMlmfSolverMetricAverageEstimatorVariance", "type": "object" }, "MethodMlmfSolverMetricMaxEstimatorVariance": { "additionalProperties": false, "description": "Utilize the maximum estimator variance as the solver metric for sampling-based multifidelity methods.", "properties": { "max_estimator_variance": { "const": true, "default": true, "description": "Utilize the maximum estimator variance as the solver metric for sampling-based multifidelity methods.", "title": "Max Estimator Variance", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.estimator_variance_metric", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "MAX_ESTVAR_METRIC" } ] } }, "title": "MethodMlmfSolverMetricMaxEstimatorVariance", "type": "object" }, "MethodMlmfSolverMetricNormEstimatorVariance": { "additionalProperties": false, "description": "Utilize a p-norm over the vector of QoI estimator variances as the solver metric for sampling-based multifidelity methods.", "properties": { "norm_estimator_variance": { "$ref": "#/$defs/MethodMlmfSolverMetricNormEstimatorVarianceConfig", "x-materialization": [ { "ir_key": "method.nond.estimator_variance_metric", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "NORM_ESTVAR_METRIC" } ] } }, "required": [ "norm_estimator_variance" ], "title": "MethodMlmfSolverMetricNormEstimatorVariance", "type": "object" }, "MethodMlmfSolverMetricNormEstimatorVarianceConfig": { "additionalProperties": false, "description": "Utilize a p-norm over the vector of QoI estimator variances as the solver metric for sampling-based multifidelity methods.", "properties": { "norm_order": { "default": 2.0, "description": "Utilize the response covariance metric for guiding adaptive refinement during UQ.", "minimum": 1.0, "title": "Norm Order", "type": "number", "x-materialization": [ { "ir_key": "method.nond.estimator_variance_metric_norm_order", "ir_value_type": "Real", "storage_type": "DIRECT_VALUE" } ] } }, "title": "MethodMlmfSolverMetricNormEstimatorVarianceConfig", "type": "object" }, "MethodMlmfSubProblemSolverCompetedLocal": { "additionalProperties": false, "description": "Use a competed local solver scheme for solving an optimization sub-problem", "properties": { "competed_local": { "const": true, "default": true, "description": "Use a competed local solver scheme for solving an optimization sub-problem", "title": "Competed Local", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.opt_subproblem_solver", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_NPSOL_OPTPP" } ] } }, "title": "MethodMlmfSubProblemSolverCompetedLocal", "type": "object" }, "MethodMlmfSubProblemSolverGlobalLocal": { "additionalProperties": false, "description": "Use a hybrid global-local scheme for solving an optimization sub-problem", "properties": { "global_local": { "const": true, "default": true, "description": "Use a hybrid global-local scheme for solving an optimization sub-problem", "title": "Global Local", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.opt_subproblem_solver", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_DIRECT_NPSOL_OPTPP" } ] } }, "title": "MethodMlmfSubProblemSolverGlobalLocal", "type": "object" }, "MethodMlmfSubProblemSolverNip": { "additionalProperties": false, "description": "Use a nonlinear interior point method for solving an optimization sub-problem", "properties": { "nip": { "const": true, "default": true, "description": "Use a nonlinear interior point method for solving an optimization sub-problem", "title": "Nip", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.opt_subproblem_solver", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_OPTPP" } ] } }, "title": "MethodMlmfSubProblemSolverNip", "type": "object" }, "MethodMlmfSubProblemSolverSqp": { "additionalProperties": false, "description": "Use a sequential quadratic programming method for solving an optimization sub-problem", "properties": { "sqp": { "const": true, "default": true, "description": "Use a sequential quadratic programming method for solving an optimization sub-problem", "title": "Sqp", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.opt_subproblem_solver", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_NPSOL" } ] } }, "title": "MethodMlmfSubProblemSolverSqp", "type": "object" }, "MethodSampleTypeLhsMcLhs": { "additionalProperties": false, "description": "Uses Latin Hypercube Sampling (LHS) to sample variables", "properties": { "lhs": { "const": true, "default": true, "description": "Uses Latin Hypercube Sampling (LHS) to sample variables", "title": "Lhs", "type": "boolean", "x-materialization": [ { "ir_key": "method.sample_type", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_LHS" } ] } }, "title": "MethodSampleTypeLhsMcLhs", "type": "object" }, "MethodSampleTypeLhsMcRandom": { "additionalProperties": false, "description": "Uses purely random Monte Carlo sampling to sample variables", "properties": { "random": { "const": true, "default": true, "description": "Uses purely random Monte Carlo sampling to sample variables", "title": "Random", "type": "boolean", "x-materialization": [ { "ir_key": "method.sample_type", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_RANDOM" } ] } }, "title": "MethodSampleTypeLhsMcRandom", "type": "object" }, "Normal": { "additionalProperties": false, "description": "Level 3 of 5 - default", "properties": { "normal": { "const": true, "default": true, "description": "Level 3 of 5 - default", "title": "Normal", "type": "boolean", "x-materialization": [ { "ir_key": "method.output", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "NORMAL_OUTPUT" } ] } }, "title": "Normal", "type": "object" }, "OfflinePilot": { "additionalProperties": false, "description": "Specify a solution mode that excludes the pilot cost from sample allocation logic", "properties": { "offline_pilot": { "$ref": "#/$defs/OfflinePilotConfig", "x-materialization": [ { "ir_key": "method.nond.ensemble_pilot_solution_mode", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "OFFLINE_PILOT" } ], "x-model-default": "OfflinePilotConfig" } }, "title": "OfflinePilot", "type": "object" }, "OfflinePilotConfig": { "additionalProperties": false, "description": "Specify a solution mode that excludes the pilot cost from sample allocation logic", "properties": { "final_statistics": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotFinalStatisticsEstimatorPerformance" }, { "$ref": "#/$defs/OfflinePilotFinalStatisticsQoiStatistics" }, { "type": "null" } ], "default": null, "description": "Indicate the type of final statistics to be returned by a UQ method", "title": "Final Statistics", "x-union-pattern": 2 } }, "title": "OfflinePilotConfig", "type": "object" }, "OfflinePilotFinalStatisticsQoiStatistics": { "additionalProperties": false, "description": "Return the quantity of interest (QoI) statistics as the final results of a UQ method", "properties": { "qoi_statistics": { "$ref": "#/$defs/OfflinePilotFinalStatisticsQoiStatisticsConfig", "x-materialization": [ { "ir_key": "method.nond.final_statistics", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "QOI_STATISTICS" } ] } }, "required": [ "qoi_statistics" ], "title": "OfflinePilotFinalStatisticsQoiStatistics", "type": "object" }, "OfflinePilotFinalStatisticsQoiStatisticsConfig": { "additionalProperties": false, "description": "Return the quantity of interest (QoI) statistics as the final results of a UQ method", "properties": { "final_moments": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsNone" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsStandard" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsCentral" } ], "description": "Output moments of the specified type and include them within the set of final statistics.", "title": "Final Moments", "x-model-default": "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsStandard", "x-union-pattern": 1 }, "distribution": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsDistributionCumulative" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsDistributionComplementary" } ], "description": "Placeholder for future capabilities", "title": "Distribution", "x-model-default": "OnlinePilotFinalStatisticsQoiStatisticsDistributionCumulative", "x-union-pattern": 1 } }, "title": "OfflinePilotFinalStatisticsQoiStatisticsConfig", "type": "object" }, "OfflineProjection": { "additionalProperties": false, "description": "Specify a solution mode that estimates performance based on projecting initial correlation/variance estimates from an offline pilot sample", "properties": { "offline_projection": { "const": true, "default": true, "description": "Specify a solution mode that estimates performance based on projecting initial correlation/variance estimates from an offline pilot sample", "title": "Offline Projection", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.ensemble_pilot_solution_mode", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "OFFLINE_PILOT_PROJECTION" } ] } }, "title": "OfflineProjection", "type": "object" }, "OnlinePilot": { "additionalProperties": false, "description": "Specify a solution mode that includes the pilot cost within the sample allocation logic", "properties": { "online_pilot": { "$ref": "#/$defs/OnlinePilotConfig", "x-materialization": [ { "ir_key": "method.nond.ensemble_pilot_solution_mode", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "ONLINE_PILOT" } ], "x-model-default": "OnlinePilotConfig" } }, "title": "OnlinePilot", "type": "object" }, "OnlinePilotConfig": { "additionalProperties": false, "description": "Specify a solution mode that includes the pilot cost within the sample allocation logic", "properties": { "relaxation": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotRelaxationFactorSequence" }, { "$ref": "#/$defs/OnlinePilotRelaxationFixedFactor" }, { "$ref": "#/$defs/OnlinePilotRelaxationRecursiveFactor" }, { "type": "null" } ], "default": null, "description": "For an online pilot mode, apply under-relaxation to the shared sample increments", "title": "Relaxation", "x-union-pattern": 2 }, "final_statistics": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotFinalStatisticsEstimatorPerformance" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatistics" }, { "type": "null" } ], "default": null, "description": "Indicate the type of final statistics to be returned by a UQ method", "title": "Final Statistics", "x-union-pattern": 2 } }, "title": "OnlinePilotConfig", "type": "object" }, "OnlinePilotFinalStatisticsEstimatorPerformance": { "additionalProperties": false, "description": "Return estimator performance as the final results of a UQ method", "properties": { "estimator_performance": { "const": true, "default": true, "description": "Return estimator performance as the final results of a UQ method", "title": "Estimator Performance", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.final_statistics", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "ESTIMATOR_PERFORMANCE" } ] } }, "title": "OnlinePilotFinalStatisticsEstimatorPerformance", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatistics": { "additionalProperties": false, "description": "Return the quantity of interest (QoI) statistics as the final results of a UQ method", "properties": { "qoi_statistics": { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsConfig", "x-materialization": [ { "ir_key": "method.nond.final_statistics", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "QOI_STATISTICS" } ] } }, "required": [ "qoi_statistics" ], "title": "OnlinePilotFinalStatisticsQoiStatistics", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatisticsConfig": { "additionalProperties": false, "description": "Return the quantity of interest (QoI) statistics as the final results of a UQ method", "properties": { "final_moments": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsNone" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsStandard" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsCentral" } ], "description": "Output moments of the specified type and include them within the set of final statistics.", "title": "Final Moments", "x-model-default": "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsStandard", "x-union-pattern": 1 }, "distribution": { "anyOf": [ { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsDistributionCumulative" }, { "$ref": "#/$defs/OnlinePilotFinalStatisticsQoiStatisticsDistributionComplementary" } ], "description": "Placeholder for future capabilities", "title": "Distribution", "x-model-default": "OnlinePilotFinalStatisticsQoiStatisticsDistributionCumulative", "x-union-pattern": 1 } }, "title": "OnlinePilotFinalStatisticsQoiStatisticsConfig", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatisticsDistributionComplementary": { "additionalProperties": false, "description": "Placeholder for future capabilities", "properties": { "complementary": { "const": true, "default": true, "description": "Placeholder for future capabilities", "title": "Complementary", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.distribution", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "COMPLEMENTARY" } ] } }, "title": "OnlinePilotFinalStatisticsQoiStatisticsDistributionComplementary", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatisticsDistributionCumulative": { "additionalProperties": false, "description": "Placeholder for future capabilities", "properties": { "cumulative": { "const": true, "default": true, "description": "Placeholder for future capabilities", "title": "Cumulative", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.distribution", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "CUMULATIVE" } ] } }, "title": "OnlinePilotFinalStatisticsQoiStatisticsDistributionCumulative", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsCentral": { "additionalProperties": false, "description": "Output central moments and include them within the set of final statistics.", "properties": { "central": { "const": true, "default": true, "description": "Output central moments and include them within the set of final statistics.", "title": "Central", "type": "boolean", "x-materialization": [ { "enum_scope": "Pecos", "ir_key": "method.nond.final_moments", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "CENTRAL_MOMENTS" } ] } }, "title": "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsCentral", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsNone": { "additionalProperties": false, "description": "Omit moments from the set of final statistics.", "properties": { "none": { "const": true, "default": true, "description": "Omit moments from the set of final statistics.", "title": "None", "type": "boolean", "x-materialization": [ { "enum_scope": "Pecos", "ir_key": "method.nond.final_moments", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "NO_MOMENTS" } ] } }, "title": "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsNone", "type": "object" }, "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsStandard": { "additionalProperties": false, "description": "Output standardized moments and include them within the set of final statistics.", "properties": { "standard": { "const": true, "default": true, "description": "Output standardized moments and include them within the set of final statistics.", "title": "Standard", "type": "boolean", "x-materialization": [ { "enum_scope": "Pecos", "ir_key": "method.nond.final_moments", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "STANDARD_MOMENTS" } ] } }, "title": "OnlinePilotFinalStatisticsQoiStatisticsFinalMomentsStandard", "type": "object" }, "OnlinePilotRelaxationFactorSequence": { "additionalProperties": false, "description": "For under-relaxation of shared sample increments, apply a sequence of factors, one per iteration", "properties": { "factor_sequence": { "description": "For under-relaxation of shared sample increments, apply a sequence of factors, one per iteration", "items": { "type": "number" }, "title": "Factor Sequence", "type": "array", "x-materialization": [ { "ir_key": "method.nond.relaxation.factor_sequence", "ir_value_type": "RealVector", "storage_type": "DIRECT_VALUE" } ] } }, "required": [ "factor_sequence" ], "title": "OnlinePilotRelaxationFactorSequence", "type": "object" }, "OnlinePilotRelaxationFixedFactor": { "additionalProperties": false, "description": "For under-relaxation of shared sample increments, apply a fixed factor that is invariant with iteration", "properties": { "fixed_factor": { "description": "For under-relaxation of shared sample increments, apply a fixed factor that is invariant with iteration", "title": "Fixed Factor", "type": "number", "x-materialization": [ { "ir_key": "method.nond.relaxation.fixed_factor", "ir_value_type": "Real", "storage_type": "DIRECT_VALUE" } ] } }, "required": [ "fixed_factor" ], "title": "OnlinePilotRelaxationFixedFactor", "type": "object" }, "OnlinePilotRelaxationRecursiveFactor": { "additionalProperties": false, "description": "For under-relaxation of shared sample increments, apply a recursive factor on each iteration that advances the relaxation factor toward 1", "properties": { "recursive_factor": { "description": "For under-relaxation of shared sample increments, apply a recursive factor on each iteration that advances the relaxation factor toward 1", "title": "Recursive Factor", "type": "number", "x-materialization": [ { "ir_key": "method.nond.relaxation.recursive_factor", "ir_value_type": "Real", "storage_type": "DIRECT_VALUE" } ] } }, "required": [ "recursive_factor" ], "title": "OnlinePilotRelaxationRecursiveFactor", "type": "object" }, "OnlineProjection": { "additionalProperties": false, "description": "Specify a solution mode that estimates performance based on projecting initial correlation / covariance estimates from an online pilot sample", "properties": { "online_projection": { "const": true, "default": true, "description": "Specify a solution mode that estimates performance based on projecting initial correlation / covariance estimates from an online pilot sample", "title": "Online Projection", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.ensemble_pilot_solution_mode", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "ONLINE_PILOT_PROJECTION" } ] } }, "title": "OnlineProjection", "type": "object" }, "PartialRecursion": { "additionalProperties": false, "description": "Perform a partial recursion of admissible DAGs", "properties": { "partial_recursion": { "$ref": "#/$defs/PartialRecursionConfig", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "PARTIAL_GRAPH_RECURSION" } ] } }, "required": [ "partial_recursion" ], "title": "PartialRecursion", "type": "object" }, "PartialRecursionConfig": { "additionalProperties": false, "description": "Perform a partial recursion of admissible DAGs", "properties": { "depth_limit": { "description": "Throttle the depth for a partial recursion of admissible DAGs", "title": "Depth Limit", "type": "integer", "x-materialization": [ { "ir_key": "method.nond.graph_depth_limit", "ir_value_type": "unsigned short", "storage_type": "DIRECT_VALUE" } ] } }, "required": [ "depth_limit" ], "title": "PartialRecursionConfig", "type": "object" }, "Quiet": { "additionalProperties": false, "description": "Level 2 of 5 - less than normal", "properties": { "quiet": { "const": true, "default": true, "description": "Level 2 of 5 - less than normal", "title": "Quiet", "type": "boolean", "x-materialization": [ { "ir_key": "method.output", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "QUIET_OUTPUT" } ] } }, "title": "Quiet", "type": "object" }, "RngOptionsContext2Mt19937": { "additionalProperties": false, "description": "Generates random numbers using the Mersenne twister", "properties": { "mt19937": { "const": true, "default": true, "description": "Generates random numbers using the Mersenne twister", "title": "Mt19937", "type": "boolean", "x-materialization": [ { "ir_key": "method.random_number_generator", "ir_value_type": "String", "storage_type": "PRESENCE_LITERAL", "stored_value": "mt19937" } ] } }, "title": "RngOptionsContext2Mt19937", "type": "object" }, "RngOptionsContext2Rnum2": { "additionalProperties": false, "description": "Generates pseudo-random numbers using the Pecos package", "properties": { "rnum2": { "const": true, "default": true, "description": "Generates pseudo-random numbers using the Pecos package", "title": "Rnum2", "type": "boolean", "x-materialization": [ { "ir_key": "method.random_number_generator", "ir_value_type": "String", "storage_type": "PRESENCE_LITERAL", "stored_value": "rnum2" } ] } }, "title": "RngOptionsContext2Rnum2", "type": "object" }, "Silent": { "additionalProperties": false, "description": "Level 1 of 5 - minimum", "properties": { "silent": { "const": true, "default": true, "description": "Level 1 of 5 - minimum", "title": "Silent", "type": "boolean", "x-materialization": [ { "ir_key": "method.output", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "SILENT_OUTPUT" } ] } }, "title": "Silent", "type": "object" }, "Verbose": { "additionalProperties": false, "description": "Level 4 of 5 - more than normal", "properties": { "verbose": { "const": true, "default": true, "description": "Level 4 of 5 - more than normal", "title": "Verbose", "type": "boolean", "x-materialization": [ { "ir_key": "method.output", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "VERBOSE_OUTPUT" } ] } }, "title": "Verbose", "type": "object" } }, "additionalProperties": false, "required": [ "solution_approach" ], "x-model-validations": [ { "validationContext": "methodseedsequencemixin", "validationErrorMessage": "For methodseedsequencemixin, all elements of seed_sequence must be >= 0.", "validationFields": [ "seed_sequence" ], "validationLiterals": [], "validationRuleName": "check_nonnegative_list" } ] }
- Fields:
- field convergence_tolerance: MethodConvergenceTolWithTypeContext3ConvergenceTol | None = None
Stopping criterion based on relative error reduction
- field export_sample_sequence: ApproximateControlVariateExportSampleSequence | None = None
Enable export of multilevel/multifidelity sample sequences to individual files
- field final_solutions: int = 0
Number of designs returned as the best solutions
- Constraints:
ge = 0
- field fixed_seed: Literal[True] | None = None
Reuses the same seed value for multiple random sampling sets
- field id_method: str | None = None
Name the method block; helpful when there are multiple
- field max_function_evaluations: int = 9223372036854775807
Stopping criterion based on maximum function evaluations
- Constraints:
ge = 0
- field max_iterations: int = 9223372036854775807
Number of iterations allowed for optimizers and adaptive UQ methods
- Constraints:
ge = 0
- field model_pointer: str | None = None
Identifier for model block to be used by a method
- field optimization_solver: MethodMlmfSubProblemSolverSqp | MethodMlmfSubProblemSolverNip | MethodMlmfSubProblemSolverGlobalLocal | MethodMlmfSubProblemSolverCompetedLocal | None = None
Optimization Solver
- field output: Debug | Verbose | Normal | Quiet | Silent [Optional]
Control how much method information is written to the screen and output file
- field pilot_samples: list[int] | None = None
Initial set of samples for multilevel/multifidelity sampling methods.
- field rng: RngOptionsContext2Mt19937 | RngOptionsContext2Rnum2 [Optional]
Selection of a random number generator
- field sample_type: MethodSampleTypeLhsMcLhs | MethodSampleTypeLhsMcRandom | None = None
Selection of sampling strategy
- field search_model_graphs: ApproximateControlVariateSearchModelGraphs | None = None
Perform a recursion of admissible DAGs for a given model ensemble
- field seed_sequence: list[int] | None = None
Sequence of seed values for multi-stage random sampling
- field solution_approach: AcvIndependentSampling | AcvMultifidelity | AcvRecursiveDiff [Required]
Solution Approach
- field solution_mode: OnlinePilot | OfflinePilot | OnlineProjection | OfflineProjection [Optional]
Solution mode for multilevel/multifidelity methods
- field solver_metric: MethodMlmfSolverMetricAverageEstimatorVariance | MethodMlmfSolverMetricNormEstimatorVariance | MethodMlmfSolverMetricMaxEstimatorVariance | None = None
Metric employed during numerical solutions in sampling-based multifidelity UQ methods.
- field truth_fixed_by_pilot: Literal[True] | None = None
Option to suppress any increment to the number of truth samples
Generated Pydantic models for method.approximate_control_variate
- pydantic model dakota.spec.method.approximate_control_variate.AcvIndependentSampling
Sampling scheme within the approximate control variate (ACV) algorithm that employs independent samples (IS) across model pairings
Show JSON schema
{ "title": "AcvIndependentSampling", "description": "Sampling scheme within the approximate control variate (ACV) algorithm that employs independent samples (IS) across model pairings", "type": "object", "properties": { "acv_independent_sampling": { "const": true, "default": true, "description": "Sampling scheme within the approximate control variate (ACV) algorithm that employs independent samples (IS) across model pairings", "title": "Acv Independent Sampling", "type": "boolean", "x-aliases": [ "acv_is" ], "x-materialization": [ { "ir_key": "method.sub_method", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_ACV_IS" } ] } }, "additionalProperties": false }
- field acv_independent_sampling: Literal[True] = True
Sampling scheme within the approximate control variate (ACV) algorithm that employs independent samples (IS) across model pairings
- pydantic model dakota.spec.method.approximate_control_variate.AcvMultifidelity
Approximate control variate (ACV) algorithm that employs a nested pyramid sample pattern, similar to MFMC
Show JSON schema
{ "title": "AcvMultifidelity", "description": "Approximate control variate (ACV) algorithm that employs a nested pyramid sample pattern, similar to MFMC", "type": "object", "properties": { "acv_multifidelity": { "const": true, "default": true, "description": "Approximate control variate (ACV) algorithm that employs a nested pyramid sample pattern, similar to MFMC", "title": "Acv Multifidelity", "type": "boolean", "x-aliases": [ "acv_mf" ], "x-materialization": [ { "ir_key": "method.sub_method", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_ACV_MF" } ] } }, "additionalProperties": false }
- field acv_multifidelity: Literal[True] = True
Approximate control variate (ACV) algorithm that employs a nested pyramid sample pattern, similar to MFMC
- pydantic model dakota.spec.method.approximate_control_variate.AcvRecursiveDiff
Sampling scheme within the approximate control variate (ACV) algorithm that employs weighted recursive differences (RD) across model pairings
Show JSON schema
{ "title": "AcvRecursiveDiff", "description": "Sampling scheme within the approximate control variate (ACV) algorithm that employs weighted recursive differences (RD) across model pairings", "type": "object", "properties": { "acv_recursive_diff": { "const": true, "default": true, "description": "Sampling scheme within the approximate control variate (ACV) algorithm that employs weighted recursive differences (RD) across model pairings", "title": "Acv Recursive Diff", "type": "boolean", "x-aliases": [ "acv_rd" ], "x-materialization": [ { "ir_key": "method.sub_method", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "SUBMETHOD_ACV_RD" } ] } }, "additionalProperties": false }
- field acv_recursive_diff: Literal[True] = True
Sampling scheme within the approximate control variate (ACV) algorithm that employs weighted recursive differences (RD) across model pairings
- pydantic model dakota.spec.method.approximate_control_variate.ApproximateControlVariateExportSampleSequence
Enable export of multilevel/multifidelity sample sequences to individual files
Show JSON schema
{ "title": "ApproximateControlVariateExportSampleSequence", "description": "Enable export of multilevel/multifidelity sample sequences to individual files", "type": "object", "properties": { "format": { "anchor": true, "anyOf": [ { "$ref": "#/$defs/MethodExportSamplesFormatCustomAnnotated" }, { "$ref": "#/$defs/MethodExportSamplesFormatAnnotated" }, { "$ref": "#/$defs/MethodExportSamplesFormatFreeform" } ], "description": "Tabular Format", "title": "Format", "x-model-default": "MethodExportSamplesFormatAnnotated", "x-union-pattern": 1 } }, "$defs": { "MethodExportSamplesFormatAnnotated": { "additionalProperties": false, "description": "Selects annotated tabular file format", "properties": { "annotated": { "const": true, "default": true, "description": "Selects annotated tabular file format", "title": "Annotated", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "TABULAR_ANNOTATED" } ] } }, "title": "MethodExportSamplesFormatAnnotated", "type": "object" }, "MethodExportSamplesFormatCustomAnnotated": { "additionalProperties": false, "description": "Selects custom-annotated tabular file format", "properties": { "custom_annotated": { "$ref": "#/$defs/MethodExportSamplesFormatCustomAnnotatedConfig", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "TABULAR_NONE" } ], "x-model-default": "MethodExportSamplesFormatCustomAnnotatedConfig" } }, "title": "MethodExportSamplesFormatCustomAnnotated", "type": "object" }, "MethodExportSamplesFormatCustomAnnotatedConfig": { "additionalProperties": false, "description": "Selects custom-annotated tabular file format", "properties": { "header": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Enable header row in custom-annotated tabular file", "title": "Header", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "AUGMENT_ENUM", "stored_value": "TABULAR_HEADER" } ] }, "eval_id": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Enable evaluation ID column in custom-annotated tabular file", "title": "Eval Id", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "AUGMENT_ENUM", "stored_value": "TABULAR_EVAL_ID" } ] }, "interface_id": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Enable interface ID column in custom-annotated tabular file", "title": "Interface Id", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "AUGMENT_ENUM", "stored_value": "TABULAR_IFACE_ID" } ] } }, "title": "MethodExportSamplesFormatCustomAnnotatedConfig", "type": "object" }, "MethodExportSamplesFormatFreeform": { "additionalProperties": false, "description": "Selects freeform file format", "properties": { "freeform": { "const": true, "default": true, "description": "Selects freeform file format", "title": "Freeform", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.export_samples_format", "ir_value_type": "unsigned short", "storage_type": "PRESENCE_ENUM", "stored_value": "TABULAR_NONE" } ] } }, "title": "MethodExportSamplesFormatFreeform", "type": "object" } }, "additionalProperties": false }
- field format: MethodExportSamplesFormatCustomAnnotated | MethodExportSamplesFormatAnnotated | MethodExportSamplesFormatFreeform [Optional]
Tabular Format
- pydantic model dakota.spec.method.approximate_control_variate.ApproximateControlVariateSearchModelGraphs
Perform a recursion of admissible DAGs for a given model ensemble
Show JSON schema
{ "title": "ApproximateControlVariateSearchModelGraphs", "description": "Perform a recursion of admissible DAGs for a given model ensemble", "type": "object", "properties": { "model_selection": { "anyOf": [ { "const": true, "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Perform a recursion of admissible model subsets for a given model ensemble", "title": "Model Selection", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.selection", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "ALL_MODEL_COMBINATIONS" } ] }, "dag_recursion": { "anchor": true, "anyOf": [ { "$ref": "#/$defs/ApproximateControlVariateSearchModelGraphsNoRecursion" }, { "$ref": "#/$defs/KlRecursion" }, { "$ref": "#/$defs/PartialRecursion" }, { "$ref": "#/$defs/ApproximateControlVariateSearchModelGraphsFullRecursion" } ], "description": "DAG Ensemble Generation Option", "title": "Dag Recursion", "x-union-pattern": 4 } }, "$defs": { "ApproximateControlVariateSearchModelGraphsFullRecursion": { "additionalProperties": false, "description": "Perform a full recursion of all admissible DAGs for a given model ensemble", "properties": { "full_recursion": { "const": true, "default": true, "description": "Perform a full recursion of all admissible DAGs for a given model ensemble", "title": "Full Recursion", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "FULL_GRAPH_RECURSION" } ] } }, "title": "ApproximateControlVariateSearchModelGraphsFullRecursion", "type": "object" }, "ApproximateControlVariateSearchModelGraphsNoRecursion": { "additionalProperties": false, "description": "Do not recur over admissible DAGs for a given model ensemble", "properties": { "no_recursion": { "const": true, "default": true, "description": "Do not recur over admissible DAGs for a given model ensemble", "title": "No Recursion", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "NO_GRAPH_RECURSION" } ] } }, "title": "ApproximateControlVariateSearchModelGraphsNoRecursion", "type": "object" }, "KlRecursion": { "additionalProperties": false, "description": "Model graph enumeration that follows the ACV-KL partitioning scheme", "properties": { "kl_recursion": { "const": true, "default": true, "description": "Model graph enumeration that follows the ACV-KL partitioning scheme", "title": "Kl Recursion", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "KL_GRAPH_RECURSION" } ] } }, "title": "KlRecursion", "type": "object" }, "PartialRecursion": { "additionalProperties": false, "description": "Perform a partial recursion of admissible DAGs", "properties": { "partial_recursion": { "$ref": "#/$defs/PartialRecursionConfig", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "PARTIAL_GRAPH_RECURSION" } ] } }, "required": [ "partial_recursion" ], "title": "PartialRecursion", "type": "object" }, "PartialRecursionConfig": { "additionalProperties": false, "description": "Perform a partial recursion of admissible DAGs", "properties": { "depth_limit": { "description": "Throttle the depth for a partial recursion of admissible DAGs", "title": "Depth Limit", "type": "integer", "x-materialization": [ { "ir_key": "method.nond.graph_depth_limit", "ir_value_type": "unsigned short", "storage_type": "DIRECT_VALUE" } ] } }, "required": [ "depth_limit" ], "title": "PartialRecursionConfig", "type": "object" } }, "additionalProperties": false, "required": [ "dag_recursion" ] }
- Fields:
- field dag_recursion: ApproximateControlVariateSearchModelGraphsNoRecursion | KlRecursion | PartialRecursion | ApproximateControlVariateSearchModelGraphsFullRecursion [Required]
DAG Ensemble Generation Option
- field model_selection: Literal[True] | None = None
Perform a recursion of admissible model subsets for a given model ensemble
- pydantic model dakota.spec.method.approximate_control_variate.ApproximateControlVariateSearchModelGraphsFullRecursion
Perform a full recursion of all admissible DAGs for a given model ensemble
Show JSON schema
{ "title": "ApproximateControlVariateSearchModelGraphsFullRecursion", "description": "Perform a full recursion of all admissible DAGs for a given model ensemble", "type": "object", "properties": { "full_recursion": { "const": true, "default": true, "description": "Perform a full recursion of all admissible DAGs for a given model ensemble", "title": "Full Recursion", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "FULL_GRAPH_RECURSION" } ] } }, "additionalProperties": false }
- Fields:
- field full_recursion: Literal[True] = True
Perform a full recursion of all admissible DAGs for a given model ensemble
- pydantic model dakota.spec.method.approximate_control_variate.ApproximateControlVariateSearchModelGraphsNoRecursion
Do not recur over admissible DAGs for a given model ensemble
Show JSON schema
{ "title": "ApproximateControlVariateSearchModelGraphsNoRecursion", "description": "Do not recur over admissible DAGs for a given model ensemble", "type": "object", "properties": { "no_recursion": { "const": true, "default": true, "description": "Do not recur over admissible DAGs for a given model ensemble", "title": "No Recursion", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "NO_GRAPH_RECURSION" } ] } }, "additionalProperties": false }
- Fields:
- field no_recursion: Literal[True] = True
Do not recur over admissible DAGs for a given model ensemble
- pydantic model dakota.spec.method.approximate_control_variate.KlRecursion
Model graph enumeration that follows the ACV-KL partitioning scheme
Show JSON schema
{ "title": "KlRecursion", "description": "Model graph enumeration that follows the ACV-KL partitioning scheme", "type": "object", "properties": { "kl_recursion": { "const": true, "default": true, "description": "Model graph enumeration that follows the ACV-KL partitioning scheme", "title": "Kl Recursion", "type": "boolean", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "KL_GRAPH_RECURSION" } ] } }, "additionalProperties": false }
- Fields:
- field kl_recursion: Literal[True] = True
Model graph enumeration that follows the ACV-KL partitioning scheme
- pydantic model dakota.spec.method.approximate_control_variate.PartialRecursion
Perform a partial recursion of admissible DAGs
Show JSON schema
{ "title": "PartialRecursion", "description": "Perform a partial recursion of admissible DAGs", "type": "object", "properties": { "partial_recursion": { "$ref": "#/$defs/PartialRecursionConfig", "x-materialization": [ { "ir_key": "method.nond.search_model_graphs.recursion", "ir_value_type": "short", "storage_type": "PRESENCE_ENUM", "stored_value": "PARTIAL_GRAPH_RECURSION" } ] } }, "$defs": { "PartialRecursionConfig": { "additionalProperties": false, "description": "Perform a partial recursion of admissible DAGs", "properties": { "depth_limit": { "description": "Throttle the depth for a partial recursion of admissible DAGs", "title": "Depth Limit", "type": "integer", "x-materialization": [ { "ir_key": "method.nond.graph_depth_limit", "ir_value_type": "unsigned short", "storage_type": "DIRECT_VALUE" } ] } }, "required": [ "depth_limit" ], "title": "PartialRecursionConfig", "type": "object" } }, "additionalProperties": false, "required": [ "partial_recursion" ] }
- field partial_recursion: PartialRecursionConfig [Required]
Perform a partial recursion of admissible DAGs
- pydantic model dakota.spec.method.approximate_control_variate.PartialRecursionConfig
Perform a partial recursion of admissible DAGs
Show JSON schema
{ "title": "PartialRecursionConfig", "description": "Perform a partial recursion of admissible DAGs", "type": "object", "properties": { "depth_limit": { "description": "Throttle the depth for a partial recursion of admissible DAGs", "title": "Depth Limit", "type": "integer", "x-materialization": [ { "ir_key": "method.nond.graph_depth_limit", "ir_value_type": "unsigned short", "storage_type": "DIRECT_VALUE" } ] } }, "additionalProperties": false, "required": [ "depth_limit" ] }
- Fields:
- field depth_limit: int [Required]
Throttle the depth for a partial recursion of admissible DAGs

