kinsol.html 3.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273
  1. <html lang="en">
  2. <head>
  3. <title>kinsol - avram - a virtual machine code interpreter</title>
  4. <meta http-equiv="Content-Type" content="text/html">
  5. <meta name="description" content="avram - a virtual machine code interpreter">
  6. <meta name="generator" content="makeinfo 4.13">
  7. <link title="Top" rel="start" href="index.html#Top">
  8. <link rel="up" href="External-Libraries.html#External-Libraries" title="External Libraries">
  9. <link rel="prev" href="harminv.html#harminv" title="harminv">
  10. <link rel="next" href="lapack.html#lapack" title="lapack">
  11. <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
  12. <meta http-equiv="Content-Style-Type" content="text/css">
  13. <style type="text/css"><!--
  14. pre.display { font-family:inherit }
  15. pre.format { font-family:inherit }
  16. pre.smalldisplay { font-family:inherit; font-size:smaller }
  17. pre.smallformat { font-family:inherit; font-size:smaller }
  18. pre.smallexample { font-size:smaller }
  19. pre.smalllisp { font-size:smaller }
  20. span.sc { font-variant:small-caps }
  21. span.roman { font-family:serif; font-weight:normal; }
  22. span.sansserif { font-family:sans-serif; font-weight:normal; }
  23. --></style>
  24. </head>
  25. <body>
  26. <div class="node">
  27. <a name="kinsol"></a>
  28. <p>
  29. Next:&nbsp;<a rel="next" accesskey="n" href="lapack.html#lapack">lapack</a>,
  30. Previous:&nbsp;<a rel="previous" accesskey="p" href="harminv.html#harminv">harminv</a>,
  31. Up:&nbsp;<a rel="up" accesskey="u" href="External-Libraries.html#External-Libraries">External Libraries</a>
  32. <hr>
  33. </div>
  34. <h3 class="section">D.9 <code>kinsol</code></h3>
  35. <p>The <code>kinsol</code> library (<a href="http://www.llnl.gov/CASC/sundials/">http://www.llnl.gov/CASC/sundials/</a>)
  36. contains sophisticated routines for non-linear optimization and
  37. <a name="index-optimization-738"></a><a name="index-non_002dlinear-optimization-739"></a>constrained non-linear optimization, some of which are available to
  38. <a name="index-constrained-non_002dlinear-optimization-740"></a>virtual code applications by way of functions expressed as shown.
  39. <pre class="example"> library('kinsol',k)
  40. </pre>
  41. <p class="noindent">The function name <code>k</code> is a string of the form
  42. <code>'</code><var>xy</var><code>_</code><var>zzzzz</var><code>'</code>. The field <var>zzzzz</var> specifies
  43. the optimization algorithm, which can be one of <code>dense</code>,
  44. <code>gmres</code>, <code>bicgs</code>, or <code>tfqmr</code>, following the names used
  45. by the API for <code>kinsol</code> in C. The field <var>y</var> determines
  46. the way gradients are obtained, which is either <code>j</code> for a user
  47. supplied Jacobian, or <code>d</code> for finite differences computed by
  48. <code>kinsol</code>. The remaining field <var>x</var> is either <code>c</code> for
  49. constrained optimization, or <code>u</code> for unconstrained. Hence, the
  50. whole function name can be one of sixteen possible alternatives.
  51. <pre class="example"> cd_dense cd_gmres cd_bicgs cd_tfqmr
  52. ud_dense ud_gmres ud_bicgs ud_tfqmr
  53. cj_dense cj_gmres cj_bicgs cj_tfqmr
  54. uj_dense uj_gmres uj_bicgs uj_tfqmr
  55. </pre>
  56. <p>More specific information about the optimization algorithms can be
  57. found in the <code>kinsol</code> documentation at the above
  58. address. Different algorithms may perform better on different
  59. problems.
  60. <ul class="menu">
  61. <li><a accesskey="1" href="kinsol-input-parameters.html#kinsol-input-parameters">kinsol input parameters</a>
  62. <li><a accesskey="2" href="kinsol-output.html#kinsol-output">kinsol output</a>
  63. <li><a accesskey="3" href="kinsol-exceptions.html#kinsol-exceptions">kinsol exceptions</a>
  64. <li><a accesskey="4" href="Additional-kinsol-notes.html#Additional-kinsol-notes">Additional kinsol notes</a>
  65. </ul>
  66. </body></html>