.. _responses-objective_functions-nonlinear_equality_constraints:

""""""""""""""""""""""""""""""
nonlinear_equality_constraints
""""""""""""""""""""""""""""""


Group to specify nonlinear equality constraints



**Topics**


nonlinear_constraints


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

   responses-objective_functions-nonlinear_equality_constraints-targets
   responses-objective_functions-nonlinear_equality_constraints-scale_types
   responses-objective_functions-nonlinear_equality_constraints-scales


**Specification**

- *Alias:* num_nonlinear_equality_constraints 

- *Arguments:* INTEGER

- *Default:* 0


**Child Keywords:**

+-------------------------+--------------------+--------------------+-----------------------------------------------+
| Required/Optional       | Description of     | Dakota Keyword     | Dakota Keyword Description                    |
|                         | Group              |                    |                                               |
+=========================+====================+====================+===============================================+
| Optional                                     | `targets`__        | Target values for the nonlinear equality      |
|                                              |                    | constraint                                    |
+----------------------------------------------+--------------------+-----------------------------------------------+
| Optional                                     | `scale_types`__    | How to scale each nonlinear constraint        |
+----------------------------------------------+--------------------+-----------------------------------------------+
| Optional                                     | `scales`__         | Characteristic values to scale each nonlinear |
|                                              |                    | constraint                                    |
+----------------------------------------------+--------------------+-----------------------------------------------+

.. __: responses-objective_functions-nonlinear_equality_constraints-targets.html
__ responses-objective_functions-nonlinear_equality_constraints-scale_types.html
__ responses-objective_functions-nonlinear_equality_constraints-scales.html



**Description**


Specifies the number of nonlinear equality constraint functions
returned by the interface.

The ``targets`` specification provides the targets for nonlinear
equalities of the form

.. math:: h(x) = h_t

and the defaults for the equality targets enforce a value of ``0``.
for each constraint

.. math:: h(x) = 0.0

The ``scale_types`` and ``scales`` keywords are related to scaling of
:math:`h \left( x \right)` . See the scaling information under specific
methods, e.g., method-\*-scaling for details on how to use this
keyword.