With a watch point, you can track the coupling data values at a certain position over time. This is very handy for applications such as the Turek and Hron FSI3 benchmark where you want to analyze the movement of the tip of a flexible plate.
Updated 11 Dec 23
<participant name="MySolver1">
<provide-mesh name="MyMesh1"/>
...
<watch-point mesh="MyMesh1" name="MyWatchPoint" coordinate="0.6; 0.2"/>
...
</participant>
This will create a logging file precice-MySolver1-watchpoint-MyWatchPoint.log
with one row per time step.
- Only a participant that provides the respective mesh can set a watchpoint on that mesh.
- You can freely choose the name
MyWatchPoint
. - Please note the format of
coordinate
. Here, values at (x,y)=(0.6,0.2) are tracked. The dimensions need to match the overall preCICEdimensions
in themesh
tag of your preCICE configuration. - If (0.6, 0.2) is not explicitly a vertex of
MyMesh1
, the nearest neighbor is chosen (resp. nearest projection if mesh connectivity is defined, cf. the mapping configuration). - The dimensions of the watchpoint need to match the dimensions of the interface (2D vs. 3D).
You can plot watchpoints using gnuplot. See an example from our tutorials.