D.9.2 kinsol output

The kinsol functions attempt to search the domain of f for a vector v the length of i to satisfy f(v) = o as closely as possible. In the case of constrained optimization, (i.e., functions whose names begin with c), only non-negative numbers are acceptable in v. The search for v will start in the vicinity of i. The value of i will therefore determine a unique solution if multiple solutions exist, and will save time if it is near a solution.

In some cases when a solution can't be found due to non-convergence, an empty list is returned. Non-convergence is not considered an exceptional condition. In all other cases where no exception occurs, the output from a kinsol function will be the list v of real numbers satisfying f(v) = o to the best possible tolerance.