title	Oscillator (overlapping domain decomposition)
permalink	tutorials-oscillator-overlap.html
keywords	Python, ODE
summary	We solve an oscillator with two masses in a partitioned fashion with overlapping domain decomposition. Each mass is solved by an independent ODE.

{% note %} Get the case files of this tutorial, as continuously rendered here, or see the latest released version (if there is already one). Read how in the tutorials introduction. {% endnote %}

Setup

This tutorial solves the same problem as the oscillator tutorial, but applies a different domain decomposition strategy. See the oscillator tutorial for details on the general setup. The partitioning of the mass-spring system is shown here:

Note that this case applies an overlapping Schwarz-type coupling method and not (like most other tutorials in this repository) a Dirichlet-Neumann coupling. This results in a symmetric setup of the solvers. We will refer to the solver computing the trajectory of $m_1$ as Mass-Left and to the solver computing the trajectory of $m_2$ as Mass-Right. For more information, please refer to [1].

Configuration

preCICE configuration (image generated using the precice-config-visualizer):

Available solvers

This tutorial is only available in Python. You need to have preCICE and the Python bindings installed on your system.

• Python: An example solver using the preCICE Python bindings. The run script installs the dependencies automatically via pip in a virtual environment.

Running the Simulation

Python

Open two separate terminals and start both participants by calling:

cd python
./run.sh -l

and

cd python
./run.sh -r