home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PROG_C / C_LSODE.ZIP / README.DOC < prev    next >
Text File  |  1994-01-15  |  5KB  |  164 lines
  1.  
  2.  
  3.  
  4.   ┌─────────────────────────────────────────────────────────┐
  5.   │    LSODE LIBRARY for GNU GCC/2 & IBM C Set++ for OS/2   │
  6.   └─────────────────────────────────────────────────────────┘
  7.  
  8.  
  9.    Introduction
  10.    ============
  11.  
  12.    LSODE-G.LIB and LSODE-I.LIB are LSODE libraries for GNU GCC/2 and IBM
  13.    C Set++, respectively. Their source codes are in C, not C++.
  14.  
  15.  
  16.    LSODE (Livermore Solver for Ordinary Differential Equations) is the basic 
  17.    solver of the ODEPACK.  It solves stiff and nonstiff systems of the form 
  18.    dy/dt = f.  In the stiff case, it treats the Jacobian matrix df/dy as 
  19.    either a full or a banded matrix, and as either user-supplied or 
  20.    internally approximated by difference quotients.  It uses Adams methods
  21.    (predictor-corrector) in the nonstiff case, and Backward Differentiation
  22.    Formula (BDF) methods in the stiff case.  The linear systems that arise
  23.    are solved by direct methods (LU factor/solve). LSODE supersedes the older
  24.    GEAR and GEARB packages, and reflects a complete redesign of the user
  25.    interface and internal organization, with some algorithmic improvements.
  26.  
  27.  
  28.    GEAR and LSODE were developed by Alan C. Hindmarsh at Lawrence Livermore
  29.    National Laboratory. They are the most widely used stiff ODE solvers today.
  30.    IMSL and NAG also chose GEAR package for stiff ODE solver.
  31.  
  32.  
  33.  
  34.    Compiler used
  35.    =============
  36.  
  37.    LSODE-I.LIB was compiled with IBM C Set++ 2.0.
  38.    LSODE-G.LIB was compiled with GNU GCC/2 2.3.3.
  39.  
  40.  
  41.  
  42.    File List
  43.    =========
  44.  
  45.    DEMOE.C      - demo 1
  46.    EXAMPLE.C    - demo 2
  47.    IMSL.C       - demo 3
  48.    LSODE-G.LIB  - library for gnu gcc/2 2.3.3
  49.    LSODE-I.LIB  - library for ibm c set++ 2.0
  50.    LSODE.H      - header
  51.    LSODE.MAN    - manual
  52.    README.DOC   - file you are reading now
  53.    TESTE.DOC    - test results
  54.  
  55.  
  56.  
  57.    DISCLAIMER
  58.    ==========
  59.  
  60.    Copyright (C) 1992-1993  Woon-Chul Choi
  61.  
  62.    Permission is granted to any individual to use, copy, or redistribute 
  63.    those libraries so long as they are not modified and that they are not
  64.    sold for profit.
  65.  
  66.    LIKE ANYTHING ELSE THAT'S FREE, LIBRARIES AND THEIR ASSOCIATED EXAMPLES ARE
  67.    PROVIDED AS IS AND COME WITH NO WARRANTY OF ANY KIND, EITHER EXPRESSED OR
  68.    IMPLIED. IN NO EVENT WILL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY DAMAGES
  69.    RESULTING FROM THE USE OF ABOVE-MENTIONED SOFTWARE.
  70.  
  71.  
  72.  
  73.    AUTHOR for C version
  74.    ====================
  75.  
  76.    Woon-Chul Choi.
  77.    choi2@chd1s0.engr.ccny.cuny.edu
  78.  
  79.  
  80.  
  81.    Also available
  82.    ==============
  83.  
  84.    name      RKF45
  85.    language  C++
  86.    for       non-stiff ODEs initial-value problem solver
  87.    algorithm Runge-Kutta Fehlberg fourth-fifth order
  88.    comment   best overall explicit Runge-Kutta routine
  89.  
  90.  
  91.    name      DVERK
  92.    language  C
  93.    for       ODEs IVP solver with global error control
  94.    algorithm Verner's fifth and sixth order Runge-Kutta pair
  95.    comment   name in IMSL is DVERK or IVPRK
  96.  
  97.  
  98.    name      ODE  
  99.    language  C++
  100.    for       non-stiff, mild-stiff ODEs IVP solver
  101.    algorithm Adams methods
  102.    comment   excellent routine
  103.  
  104.  
  105.    name      LSODE
  106.    language  C
  107.    for       non-stiff and stiff ODEs solver
  108.    algorithm Adams for non-stiff, BDF for stiff
  109.    comments  LSODE is the update of GEAR/GEARB. choice for stiff ODE system
  110.  
  111.  
  112.    name      LSODA
  113.    language  C
  114.    for       non-stiff and stiff ODEs solver
  115.    algorithm Adams for non-stiff, BDF for stiff
  116.    comment   automatically selects between non-stiff and stiff methods
  117.  
  118.  
  119.    name      LSODAR
  120.    language  C
  121.    for       non-stiff and stiff ODEs solver
  122.    algorithm Adams for non-stiff, BDF for stiff
  123.    comment   a variant of LSODA with a rootfinding capability
  124.  
  125.  
  126.    name      LSODI
  127.    language  C
  128.    for       solves linearly implicit systems of ODEs
  129.    algorithm Adams for non-stiff, BDF for stiff
  130.    comment   LSODI supersedes the older GEARIB solver and improves upon
  131.              it in numerous ways
  132.  
  133.  
  134.    name      COLNEW
  135.    language  C++
  136.    for       ODEs boundary-value problem solver
  137.    algorithm truncated powers collocation
  138.    comment   modification of COLSYS
  139.  
  140.  
  141.    name      DDASSL
  142.    language  C/C++
  143.    for       stiff differential-algebraic system solver
  144.    algorithm backward differentiation formulae
  145.    comment   most widely used DAE solver
  146.  
  147.  
  148.    name      DDASRT
  149.    language  C++
  150.    for       stiff DAE solver with root stopping
  151.    algorithm backward differentiation formulae
  152.    comment
  153.  
  154.  
  155.    name      DEPAC
  156.    language  C++
  157.    for       stiff (DDEBDF), or non-stiff (DDEABM, DDERKF) ODEs
  158.    algorithm DDEABM Adams method
  159.              DDEBDF backward differentiation formulae
  160.              DDERKF Runge-Kutta Fehlberg fourth-fifth order
  161.    comment   modifications of ODE, LSODE, and RKF45
  162.  
  163.  
  164.