.. _responses-calibration_terms-weights:

"""""""
weights
"""""""


Specify weights for each objective function


.. toctree::
   :hidden:
   :maxdepth: 1



**Specification**

- *Alias:* calibration_weights least_squares_weights 

- *Arguments:* REALLIST

- *Default:* equal weights


**Description**


Specifies relative emphasis through weights (multipliers) w on
residual elements: 

.. math::  f = \sum_{i=1}^{n} w_i R_i^2 = \sum_{i=1}^{n} w_i (y^{Model}_i - y^{Data}_i)^2 

Length: The ``weights`` must have length equal to
:dakkw:`responses-calibration_terms`. Thus, when scalar and/or field responses
are specified, the number of ``weights`` must equal the number of
scalars plus the number of fields, *not* the total elements in the
fields.

*Default Behavior* If weights are not specified, then each
residual is given equal weighting.

*Usage Tips:*

Weights are applied as multipliers, scales as charateristic values /
divisors.

When scaling is active, it is applied to calibration terms after any
residual formation (accounting for experimental data and optionally
measurement error covariance), and before any weights. See the
equations in :dakkw:`responses-calibration_terms`.