# setEstimatedValues

Update experiments with estimated model initial states and parameter values

## Syntax

```experiment = setEstimatedValues(experiment0,parameters) ```

## Description

`experiment = setEstimatedValues(experiment0,parameters)` updates the experiment with the estimated model initial states and parameter values.

`setEstimatedValues` is used with the `getValuesToEstimate` method. You use `getValuesToEstimate` to obtain the parameters that you want to estimate from an experiment. When you estimate parameters for multiple experiments, `getValuesToEstimate` tags each parameter to track its corresponding experiment. You use `setEstimatedValues` to update the experiments with their corresponding estimated parameter values.

## Input Arguments

 `experiment0` Experiment, specified as an `sdo.Experiment` object. To specify multiple experiments, use a vector of `sdo.Experiment` objects. `parameters` Estimated model initial states and parameters for experiments, specified as a vector of `param.Continuous` objects. You obtain estimated parameters using `sdo.optimize`.

## Output Arguments

 `experiment` Updated experiment, returned as an `sdo.Experiment` object. If `experiment0` is a vector of experiments, then `experiment` is a corresponding vector of updated `sdo.Experiment` objects. `setEstimatedValues` updates the values of the parameters and initial states specified in each of the experiments in `experiment0` using the corresponding entry in `parameters`.

## Examples

expand all

Specify an experiment.

`experiment = sdo.Experiment('sdoRCCircuit');`

Typically, you also specify measured input/output data for the experiment.

Specify a model parameter for estimation.

```load_system('sdoRCCircuit'); C1_parameter = sdo.getParameterFromModel('sdoRCCircuit','C1'); C1_parameter.Value = 460e-6; experiment.Parameters = C1_parameter;```

`C1_parameter` is the capacitance parameter of the C1 block. The initial guess for its value is 460 $\mu$ F.

Estimate the parameter value.

Typically, you use `sdo.optimize` to get the estimated parameter values for an experiment. For this example, directly change the value of the capacitance parameter.

`C1_parameter.Value = 1e-6;`

Update the experiment with the estimated parameter.

`experiment = setEstimatedValues(experiment,C1_parameter);`

Use `experiment.Parameters.Value` to verify that the capacitance parameter's value is updated.