add flow-over-heated-plate/fluid-openfoam-basicReactingMultiphaseClou…

[mike-tree-corvid]

add flow-over-heated-plate/fluid-openfoam-basicReactingMultiphaseCloud tutorial case to show verification of implicit coupling of Lagrangian particles

TODO: Summarize and motivate the changes, link to issues, remove the checklist entries that are not relevant.

Checklist

• I added a summary of any user-facing changes (compared to the last release) in the changelog-entries/<PRnumber>.md.

For new tutorials or tutorial cases:

• I followed the tutorial folder structure
• I added/updated the tutorial README.md
• I added/updated the tutorial metadata.yaml
• I added tests in tools/tests/tests.yaml
• I submitted a pull request to the website with:
  • An entry in _config.yaml
  • A sidebar entry
  • An entry in the tutorials overview

[mike-tree-corvid]

corresponds with precice/openfoam-adatper pull request here:

precice/openfoam-adapter#405

[precice-bot]

This pull request has been mentioned on preCICE Forum on Discourse. There might be relevant details there:

https://precice.discourse.group/t/does-openfoam-adapter-support-lagrangian-particle-checkpointing/2947/11

[MakisH]

Thanks for contributing the tutorial as well! I have not yet looked closer, but the problem setup is different than the current flow-over-heated-plate tutorial, right? In that case, the convention would be to make a separate tutorial directory (e.g., flow-over-heated-plate-particles or similar, whatever describes it best) and describe the case in the respective README.md.

[mike-tree-corvid]

Thanks for contributing the tutorial as well! I have not yet looked closer, but the problem setup is different than the current flow-over-heated-plate tutorial, right? In that case, the convention would be to make a separate tutorial directory (e.g., flow-over-heated-plate-particles or similar, whatever describes it best) and describe the case in the respective README.md.

The problem setup is the exact same as the flow-over-heated-plate tutorial with the exception that the necessary files / settings are such that 100 Lagrangian parcels / particles (1 particle per parcel) are injected at time = 0 and are left to propagate through the domain. The intent was to give the particles the same properties as the fluid so that they simply follow the flow rather than affect it, thus making any changes in the solution potential flags for something being wrong with the Lagrangian particle implicit coupling implementation.

I debated whether to slide this contribution under the flow-over-heated-plate tutorial, or make it a stand alone tutorial. I'm happy to do either. Do you want to wait to decide what should be done until you take a closer look, or are you pretty decided that it should be a separate tutorial and I should go ahead and make the change?

[MakisH]

I will take a closer look to this tutorial, the adapter PR, and the related discussion in ~a week.

For comparison, we have:

• channel transport
• channel transport with particles

as separate tutorials.

[mike-tree-corvid]

I will take a closer look to this tutorial, the adapter PR, and the related discussion in ~a week.

For comparison, we have:

* [channel transport](https://precice.org/tutorials-channel-transport.html)

* [channel transport with particles](https://precice.org/tutorials-channel-transport-particles.html)

as separate tutorials.

I reformatted this contribution as its own tutorial rather than being a subset of the flow-over-heated-plate tutorial.

Anything else you see that's needed before we can take this off draft status?

[MakisH]

@mike-tree-corvid with a quick look, it seems like the structure is fine and I have everything I need to do a review. I am in a different context than OpenFOAM these days, but I will eventually do a detailed review together with the changes in the adapter.

Regarding the CI failure:

flow-over-heated-plate-particles/images/temperature_with_particles.pvsm: 1308 kb exceeds the limit of 750 kb. 
flow-over-heated-plate-particles/images/temperature_with_particles.gif: 3716 kb exceeds the limit of 2200 kb.

if you could reduce a bit the size of the GIF file (e.g., lower frequency), it would be great, otherwise I will see how we can better handle that. The .pvsm file is not something we typically have, but it could be useful. If portable, I will add an exception.

[MakisH]

Note that we typically don't have these headers and comment separateor lines in our configuration files, unless they are really from OpenFOAM (and the version is important).