.. highlightlang:: us

.. index:: solve

.. _solve:

solve
=====

.. us.tag  solve ENGLISH math-misc

:ref:`solve` calculates the solution of a non linear system.

.. function::  rvX = solve(func, rvXStart)

.. us.return

**Return Value**

*rvX* is the solution vector. If an error occurred, *rvX* has the value
``ERROR_VALUE``.

.. us.params

**Parameters**

.. uparam:: func

   *func* is a function provided by the user and has the following form (see
   also the example)::

      def func(rvX)
      {
          ...
          return rvY;
      }

.. uparam:: rvXStart

   *rvXStart* is an estimated solution vector.

.. us.example

**Example**

::

   def f(x)
   {
       return x*x - sin(x);
   }
   solve(f, 1.0);

.. seealso::
   :ref:`nonlin`

:sub:`id-1348686`