Skip to content

Conversation

@davidscn
Copy link
Member

@davidscn davidscn commented Jan 22, 2026

The open question is a bit how to handle the MercuryDPM participant, as the coupled code is entirely compiled with MerucryDPM

https://bitbucket.org/mercurydpm/mercurydpm/pull-requests/266

In principle, using

make ChannelTransport

and copying the executable compiled in ./build/./Drivers/PreCICE/ChannelTransport is sufficient. Afterwards simply execute the case.

image

Checklist:

  • I added a summary of any user-facing changes (compared to the last release) in the changelog-entries/<PRnumber>.md.
  • I will remember to squash-and-merge, providing a useful summary of the changes of this PR.

@MakisH MakisH self-requested a review January 26, 2026 17:05
@MakisH
Copy link
Member

MakisH commented Jan 26, 2026

The README.md file is currently missing.

We need to rethink how we are distributing solver codes that are built directly in the build tree of the respective solver. A good place to document this then would be the adapter software engineering page.


Particle participant:

* MercuryDPM
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

More information needed here (I know you know, just for the overview).

Comment on lines +20 to +21
![preCICE configuration visualization](images/tutorials-channel-transport-precice-config.png
)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
![preCICE configuration visualization](images/tutorials-channel-transport-precice-config.png
)
![preCICE configuration visualization](images/tutorials-channel-transport-precice-config.png)

and image missing

Comment on lines +12 to +15
## Setup

We model a two-dimensional incompressible fluid flowing through a channel with an obstacle. The fluid problem is coupled to a particle participant for particle tracing. Similar to the transport problem (see the [channel-transport tutorial](tutorials-channel-transport.html)), particles are arranged in a circular blob close to the inflow.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You could add here the very nice picture from the PR description.

@uekerman
Copy link
Member

uekerman commented Feb 2, 2026

The open question is a bit how to handle the MercuryDPM participant, as the coupled code is entirely compiled with MerucryDPM

We could add a run.sh that (also) does the copying (and maybe also the building?)
What would be the standard to find out where MercuryDPM is? Define MERCURYDPM_PATH?

Do we also need a cleaning script there?

---

{% note %}
Get the [case files of this tutorial](https://github.com/precice/tutorials/tree/master/channel-transport-particles). Read how in the [tutorials introduction](https://precice.org/tutorials.html).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated format: #704

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How does this fit to the information here https://precice.org/tutorials.html ?
at the very top?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are you asking if the following statement needs to be revised?

You can find all tutorial case files in the tutorials repository. Get the latest release, or clone the Git repository to easily update them in the future:

Since the default branch is develop, this is fine as-is. I can make this more explicit next time I edit that page.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you include one further line further, it becomes

You can find all tutorial case files in the [tutorials repository](https://github.com/precice/tutorials). Get the [latest release](https://github.com/precice/tutorials/releases/latest), or clone the Git repository to easily update them in the future:

git clone --branch=master --depth 1 https://github.com/precice/tutorials.git

Since the default branch is develop, this is fine as-is.

So, the default branch is explicitly overridden!?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is the usual question of whether we want the users to see and use the released or the development version.

The default branch is develop, since we want all PRs to target that.

The branch we want users to use has so far been master. In this statement yes, it could be better to skip the --branch=master, since we want people to contribute.

Feel free to submit a PR. In this comment, I just wanted to add a reminder that this has now changed.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants