ecl-logo Documentation
ECL`

AnalyzeDesignOfExperiment

AnalyzeDesignOfExperiment[protocols, ObjectiveFunctionobjectiveFunction, ParameterSpaceparameters]analysisObject

Analyze the data objects within the list of input protocols, applying the objectiveFunction to each data object, and returning an analysisObject that details the parameters that optimize the objectiveFunction with the set of input protocols.

Details

    Input
    Output
    Method Options
    Messages
  • MismatchedParameterSpaceThe input ParameterSpace found in the specified options does not match the ParameterSpace found in the analysis object linked via the UpdateAnalysis option.
    MultipleTypesMultiple different types of protocols were found in the input list, `1`. This is not currently supported since comparing across different protocol types (e.g. HPLC and NMR) may not be possible.
    NoObjectiveFunctionNo objective function was found in the input or options. The analysis of a Design of Experiment run requires an objective function to be set.
    NoOptionsNo explicitly specified experiment parameters were found in this list of protocols, `1`. Please ensure that each protocol was made with explicitly defined options (e.g. FlowRate->1 Milli Liter / Minute).
    NoParameterSpaceNo ParameterSpace was found in the inputs. This needs to be set.
    ParameterNotFoundOne, or more, of the parameters in ParameterSpace was not found amongst the experimental parameters set in the input protocol objects.
    UnknownExperimentThe current experiment type, `1`, is not supported by AnalyzeDesignOfExperiment. Bear with us since this function is so new.

Examples

open allclose all

Basic Examples  (3)

Running AnalyzeDesignOfExperiment on a list of protocols and setting the UpdateAnalysis option will update the existing analysis object and return it:

Running AnalyzeDesignOfExperiment on a list of protocols returns an analysis object:

Running AnalyzeDesignOfExperiment on a protocol returns an analysis object:

Additional Examples  (6)

Running AnalyzeDesignOfExperiment on a protocols with multiple data on multiple parameters in the parameter space returns an analysis object:

Running AnalyzeDesignOfExperiment on a protocols with multiple data returns an analysis object:

Running AnalyzeDesignOfExperiment on multiple protocols with multiple data can update an existing analysis object:

Running AnalyzeDesignOfExperiment on multiple protocols with multiple data on multiple parameters in the parameter space returns an analysis object:

Running AnalyzeDesignOfExperiment works on an Absorbance Spectroscopy Protocol:

Setting the UpdateAnalysis option will append objective function evaluations to the existing analysis object:

Options  (4)

Method  (1)

Setting the Method option specifies the optimization algorithm specified during the design of experiment run:

ObjectiveFunction  (1)

Setting the ObjectiveFunction option specifies the scoring function that determines the best experimental parameters used in the design of experiment run:

ParameterSpace  (1)

Setting the ParameterSpace option specifies the independent variables that were used in the design of experiment run:

UpdateAnalysis  (1)

The analysis object passed through the UpdateAnalysis option provides a template for all the other options:

Messages  (7)

MismatchedParameterSpace  (1)

Calling AnalyzeDesignOfExperiment with a parameter space that does not match the ParameterSpace of the analysis object to be updated results in an error:

MultipleTypes  (1)

Using protocols with different types will result in a MultipleTypes error:

NoObjectiveFunction  (1)

Forgetting to set the ObjectiveFunction option will result in an error:

NoOptions  (1)

Calling AnalyzeDesignOfExperiment on a protocol that was generated without explicitly defined options throws an error:

NoParameterSpace  (1)

Forgetting to set the ParameterSpace option will result in an error:

ParameterNotFound  (1)

Calling AnalyzeDesignOfExperiment on an unknown option/parameter of the input protocol will result in an error:

UnknownExperiment  (1)

Using an unsupported protocol type in the input will result in an error, sorry:

Last modified on Wed 17 Sep 2025 18:45:27