Introduction to Namepending-ODE

Contents

Introduction to Namepending-ODE#

ASC-ODE is is a C++ library for solving ordinary differential equations (ODEs). The equation is defined by the right hand side function. ASC-ODE provides various time-steppers which may be used for odes with right hand sides given by a function object.

The theory can be found here: https://jschoeberl.github.io/IntroSC/ODEs/ODEs.html

Installation#

Install Namepending-ODE via git-clone:

git clone https://github.com/queendasher/NamePending-ODE.git

For the python applications, make sure you have the necessary dependencies installed, such as

  • Python 3.12 (or higher)

  • pybind11

  • pythreejs

  • …

They can be installed using apt on Linux:

sudo apt install python3.12
sudo apt install python3-pybind11

To build the library, navigate to the src folder and execute the following commands:

mkdir build
cd build
cmake .. 
make

After the build is complete, you can run the demonstration scripts. There should be an executable named test_odes in the build directory.

To run the demonstration scripts, execute the following command from the build directory:

./test_ode

This program will print the simulation results into a text file output_test_ode.txt depending on which folder the program has been called.

The results can be quite different depending on the used time-stepping method. Available time-stepping methods are:

  • ExplicitEuler

  • ImplicitEuler

  • ImprovedEuler

  • RungeKutta

  • ExplicitRungeKutta

  • ImplicitRungeKutta

  • CrankNicolson

To evaluate the contents of the text file, a python script called plotmassspring.py can be called. This script loads the contents and generates two plots containing the simulation data.

python3 ./plotmassspring.py
Contents