Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions doc/arkode/examples/source/c_parallel.rst
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ ark_diurnal_kry_bbd_p
===================================================


This problem is an ARKode clone of the CVODE problem,
This problem is an ARKODE clone of the CVODE problem,
``cv_diurnal_kry_bbd_p``. As described in :cite:p:`cvode_ug`, this problem
models a two-species diurnal kinetics advection-diffusion PDE system
in two spatial dimensions,
Expand Down Expand Up @@ -79,7 +79,7 @@ We employ a method of lines approach, wherein we first
semi-discretize in space to convert the system of 2 PDEs into a larger
system of ODEs. To this end, the spatial derivatives are computed
using second-order centered differences, with the data distributed
over :math:`Mx*My` points on a uniform spatial grid. As a result, ARKode
over :math:`Mx*My` points on a uniform spatial grid. As a result, ARKODE
approaches the problem as one involving :math:`2*Mx*My` coupled ODEs.

The problem is decomposed in parallel into uniformly-sized subdomains,
Expand Down Expand Up @@ -112,7 +112,7 @@ on completion.
ark_diurnal_kry_p
===================================================

This problem is an ARKode clone of the CVODE problem,
This problem is an ARKODE clone of the CVODE problem,
``cv_diurnal_kry_p``. As described in :cite:p:`cvode_ug`, this test problem
models a two-species diurnal kinetics advection-diffusion PDE system
in two spatial dimensions,
Expand Down Expand Up @@ -160,7 +160,7 @@ We employ a method of lines approach, wherein we first semi-discretize
in space to convert the system of 2 PDEs into a larger system of ODEs.
To this end, the spatial derivatives are computed using second-order
centered differences, with the data distributed over :math:`Mx*My`
points on a uniform spatial grid. As a result, ARKode approaches the
points on a uniform spatial grid. As a result, ARKODE approaches the
problem as one involving :math:`2*Mx*My` coupled ODEs.

The problem is decomposed in parallel into uniformly-sized subdomains,
Expand Down
30 changes: 15 additions & 15 deletions doc/arkode/examples/source/c_serial.rst
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Serial C example problems
ark_analytic
====================================

This is a very simple C example showing how to use the ARKode solver
This is a very simple C example showing how to use the ARKODE solver
interface.

The problem is that of a scalar-valued initial value problem (IVP)
Expand Down Expand Up @@ -64,7 +64,7 @@ example file contains functions to evaluate both :math:`f(t,y)` and

We specify the relative and absolute tolerances, :math:`rtol=10^{-6}`
and :math:`atol=10^{-10}`, respectively. Aside from these choices,
this problem uses only the default ARKode solver parameters.
this problem uses only the default ARKODE solver parameters.



Expand Down Expand Up @@ -96,7 +96,7 @@ This example problem is only marginally more difficult than the
preceding problem, in that the ODE right-hand side function is
nonlinear in the solution :math:`y`. While the implicit solver from
the preceding problem would also work on this example, because it is
not stiff we use this to demonstrate how to use ARKode's explicit
not stiff we use this to demonstrate how to use ARKODE's explicit
solver interface. Although both the ARKStep and ERKStep time stepping
modules are appropriate in this scenario, we use the ERKStep module
here.
Expand Down Expand Up @@ -146,7 +146,7 @@ comparable with those specified by the requested error tolerances
ark_brusselator
================================================

We now wish to exercise the ARKode solvers on more challenging
We now wish to exercise the ARKODE solvers on more challenging
nonlinear ODE systems. The following test simulates a brusselator
problem from chemical kinetics, and is widely used as a standard
benchmark problem for new solvers. The ODE system has 3 components,
Expand Down Expand Up @@ -408,7 +408,7 @@ ark_robertson_root

We again test the Robertson problem, but in this example we will
utilize both a logarithmically-spaced set of output times (to properly
show the solution behavior), as well as ARKode's root-finding
show the solution behavior), as well as ARKODE's root-finding
capabilities. Again, the Robertson problem consists of an ODE system
with 3 components, :math:`Y = [u,\, v,\, w]^T`, satisfying the equations,

Expand Down Expand Up @@ -451,7 +451,7 @@ and set absolute tolerances on :math:`u`, :math:`v` and :math:`w` of
printed at the end.

However, unlike in the previous problem, while integrating the system,
we use the rootfinding feature of ARKode to find the times at which
we use the rootfinding feature of ARKODE to find the times at which
either :math:`u=10^{-4}` or :math:`w=10^{-2}`.


Expand All @@ -468,7 +468,7 @@ solution components for the Robertson ODE system.
:align: center

We note that when running this example, the root-finding capabilities
of ARKode report outside of the typical logarithmically-spaced output
of ARKODE report outside of the typical logarithmically-spaced output
times to declare that at time :math:`t=0.264019` the variable
:math:`w` attains the value :math:`10^{-2}`, and that at time
:math:`t=2.07951\cdot10^{7}` the variable :math:`u` attains the value
Expand Down Expand Up @@ -529,7 +529,7 @@ We employ a *method of lines* approach, wherein we first
semi-discretize in space to convert the system of 3 PDEs into a larger
system of ODEs. To this end, the spatial derivatives are computed
using second-order centered differences, with the data distributed
over :math:`N` points on a uniform spatial grid. As a result, ARKode
over :math:`N` points on a uniform spatial grid. As a result, ARKODE
approaches the problem as one involving :math:`3N` coupled ODEs.

The problem is run using :math:`N=201` spatial points, with parameters
Expand Down Expand Up @@ -574,7 +574,7 @@ This problem is mathematically identical to the preceding problem,
:ref:`ark_brusselator1D`, but instead of using the SUNMATRIX_BAND
banded matrix module and SUNLINSOL_BAND linear solver module, it uses
the SUNMATRIX_SPARSE sparse matrix module with the SUNLINSOL_KLU
linear solver module. These are still provided to ARKode using the
linear solver module. These are still provided to ARKODE using the
ARKDLS direct linear solver interface, and again a routine is provided
to supply a compressed-sparse-column version of the Jacobian matrix.
Additionally, the solution is only output 10 times instead of 100.
Expand Down Expand Up @@ -615,7 +615,7 @@ therefore approximate these integrals using a three-node Gaussian
quadrature, exact for polynomials up to degree six.

After this spatial semi-discretization, the system of three PDEs is
passed to ARKode as a system of :math:`3N` coupled ODEs, as with the
passed to ARKODE as a system of :math:`3N` coupled ODEs, as with the
preceding problem.

As with the preceding problem :ref:`ark_brusselator1D_klu`, this
Expand Down Expand Up @@ -762,15 +762,15 @@ as the simulation proceeds the mesh is [crudely] adapted to add points
to the center of subintervals bordering any node where
:math:`\left|\frac{\partial^2 u}{\partial x^2}\right| > 0.003`.
We note that the spatial adaptivity approach employed in this example
is *ad-hoc*, designed only to exemplify ARKode usage on a problem with
is *ad-hoc*, designed only to exemplify ARKODE usage on a problem with
varying size (not to show optimally-adaptive spatial refinement
methods).

This program solves the problem with a DIRK method, utilizing a Newton
iteration and the SUNLINSOL_PCG iterative linear solver.
Additionally, the test problem utilizes ARKode's spatial adaptivity
Additionally, the test problem utilizes ARKODE's spatial adaptivity
support (via ``ARKodeResize``), allowing retention of the
major ARKode data structures across vector length changes.
major ARKODE data structures across vector length changes.



Expand All @@ -781,7 +781,7 @@ major ARKode data structures across vector length changes.
ark_KrylovDemo_prec
============================================

This problem is an ARKode clone of the CVODE problem,
This problem is an ARKODE clone of the CVODE problem,
``cv_KrylovDemo_prec``. This is a demonstration program using the
SUNLINSOL_SPGMR linear solver module. As explained more thoroughly in
:cite:p:`cvode_ug`, the problem is a stiff ODE system that arises from a
Expand Down Expand Up @@ -841,7 +841,7 @@ We employ a method of lines approach, wherein we first semi-discretize
in space to convert the system of 6 PDEs into a larger system of ODEs.
To this end, the spatial derivatives are computed using second-order
centered differences, with the data distributed over :math:`Mx*My`
points on a uniform spatial grid. As a result, ARKode approaches the
points on a uniform spatial grid. As a result, ARKODE approaches the
problem as one involving :math:`6*Mx*My` coupled ODEs.

This program solves the problem with a DIRK method, using a Newton
Expand Down
2 changes: 1 addition & 1 deletion doc/arkode/examples/source/cpp_parallel.rst
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Parallel C++ example problems
ark_heat2D
======================================================================

ARKode provides one parallel C++ example problem, that extends our
ARKODE provides one parallel C++ example problem, that extends our
previous :ref:`ark_heat1D` test to now simulate a two-dimensional heat
equation,

Expand Down
4 changes: 2 additions & 2 deletions doc/arkode/examples/source/cpp_serial.rst
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Serial C++ example problems
ark_analytic_sys
===============================================

This example demonstrates the use of ARKode's fully implicit solver on
This example demonstrates the use of ARKODE's fully implicit solver on
a stiff ODE system that has a simple analytical solution. The problem
is that of a linear ODE system,

Expand Down Expand Up @@ -86,7 +86,7 @@ Solutions
---------

This problem is included both as a simple example to test systems of
ODE within ARKode on a problem having an analytical solution,
ODE within ARKODE on a problem having an analytical solution,
:math:`Y(t) = V e^{Dt} V^{-1} Y(0)`. As seen in the plots below, the
computed solution tracks the analytical solution quite well (left),
and results in errors with exactly the magnitude as specified by the
Expand Down
4 changes: 2 additions & 2 deletions doc/arkode/examples/source/f77_parallel.rst
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Parallel Fortran 77 example problems
fark_diag_kry_bbd_p
===================================================

This problem is an ARKode clone of the CVODE problem,
This problem is an ARKODE clone of the CVODE problem,
``fcv_diag_kry_bbd_p``. As described in :cite:p:`cvode_ug`, this problem
models a stiff, linear, diagonal ODE system,

Expand Down Expand Up @@ -78,7 +78,7 @@ errors and final performance counters are printed on completion.
fark_diag_non_p
===================================================

This problem is an ARKode clone of the CVODE problem,
This problem is an ARKODE clone of the CVODE problem,
``fcv_diag_non_p``. As described in :cite:p:`cvode_ug`, this problem models a
nonstiff, linear, diagonal ODE system,

Expand Down
11 changes: 4 additions & 7 deletions doc/arkode/examples/source/f77_serial.rst
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Serial Fortran 77 example problems
fark_diurnal_kry_bp
===================================================

This problem is an ARKode clone of the CVODE problem,
This problem is an ARKODE clone of the CVODE problem,
``fcv_diurnal_kry_bp``. As described in :cite:p:`cvode_ug`, this problem
models a two-species diurnal kinetics advection-diffusion PDE system
in two spatial dimensions,
Expand Down Expand Up @@ -79,7 +79,7 @@ We employ a method of lines approach, wherein we first semi-discretize
in space to convert the system of 2 PDEs into a larger system of ODEs.
To this end, the spatial derivatives are computed using second-order
centered differences, with the data distributed over :math:`Mx*My`
points on a uniform spatial grid. As a result, ARKode approaches the
points on a uniform spatial grid. As a result, ARKODE approaches the
problem as one involving :math:`2*Mx*My` coupled ODEs. In this
problem, we use a relatively coarse uniform mesh with
:math:`Mx=My=10`.
Expand All @@ -106,7 +106,7 @@ on completion.
fark_roberts_dnsL
===================================================

This problem is an ARKode clone of the CVODE problem,
This problem is an ARKODE clone of the CVODE problem,
``fcv_roberts_dnsL``. As described in :cite:p:`cvode_ug`, this problem models
the kinetics of a three-species autocatalytic reaction. This is an
ODE system with 3 components, :math:`Y = [y_1,\, y_2,\, y_3]^T`,
Expand Down Expand Up @@ -140,13 +140,10 @@ This program solves the problem with a DIRK method, using a Newton
iteration with the SUNLINSOL_LAPACKDENSE linear solver module and
ARKDLS interface.

As with the :ref:`ark_robertson_root` problem, we enable ARKode's
As with the :ref:`ark_robertson_root` problem, we enable ARKODE's
rootfinding module to find the times at which either :math:`u=10^{-4}`
or :math:`w=10^{-2}`.

Performance data and solution values are printed at
selected output times, along with additional output at rootfinding
events. All performance counters are printed on completion.



4 changes: 1 addition & 3 deletions doc/arkode/examples/source/f90_serial.rst
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ Numerical method

Since this driver and utility functions are written in Fortran-90,
this example demonstrates the use of the FARKODE interface for the
ARKode solver. For time integration, this example uses the
ARKODE solver. For time integration, this example uses the
fourth-order additive Runge-Kutta IMEX method, where the right-hand
sides are broken up as

Expand Down Expand Up @@ -108,5 +108,3 @@ This problem is mathematically identical to the C example problem
:ref:`ark_brusselator1D_FEM_slu`, but is written in Fortran 90, stores
the sparse Jacobian and mass matrices in compressed-sparse-row format,
and uses the KLU sparse-direct linear solver.


4 changes: 2 additions & 2 deletions doc/superbuild/source/developers/History.rst
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ released under that name in 2002.

Extensions to the time integrators to handle forward and adjoint sensitivity
problems, called CVODES and IDAS, were added later. In 2015 a new ODE
integration package, ARKode, was added to SUNDIALS. ARKode includes multistage
integration package, ARKODE, was added to SUNDIALS. ARKODE includes multistage
methods which are better suited to time evolution systems posed within spatially
adaptive codes than the multistep methods in CVODE. The six packages in SUNDIALS
all share a collection of vector operation modules, which originally included
Expand All @@ -80,6 +80,6 @@ A timeline of SUNDIALS development:
* 2002 - First release of SUNDIALS under a BSD license
* 2004 - CVODES first released
* 2009 - IDAS first released
* 2015 - ARKode first released as part of SUNDIALS
* 2015 - ARKODE first released as part of SUNDIALS
* 2016 - Changed procedures to allow for unregistered downloads
* 2017 - Created GitHub mirror of released software for download
Original file line number Diff line number Diff line change
Expand Up @@ -139,7 +139,7 @@ the :ref:`Workflow` section.

The desired format for a commit message is a short descriptive title
followed by a blank line, and then a detailed commit message. For
example, a commit making several changes to the ARKode initialization
example, a commit making several changes to the ARKODE initialization
function might have the following message:

.. code-block:: none
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -208,7 +208,7 @@ Commit Messages

The desired format for longer commit messages (more than a single line) is a
short descriptive title followed by a blank line, and then a detailed commit
message. For example, a commit making several changes to the ARKode
message. For example, a commit making several changes to the ARKODE
initialization function might have the following message:

.. code-block:: none
Expand Down