tutorials icon indicating copy to clipboard operation
tutorials copied to clipboard

ASTE Turbine Tutorial

Open kursatyurt opened this issue 3 years ago • 7 comments

ASTE was lack of a tutorial in tutorials.

This PR suggests a tutorial that shows the usage of ASTE tools: mesh partitioner, mesh joiner, calculator, beside ASTE itself.

The tutorial uses the turbine meshes from the preCICE repository. This way it provides a variety of meshes for different trials.

kursatyurt avatar Nov 29 '21 12:11 kursatyurt

What is our strategy to explain users how to reproduce their setup with ASTE? Do we want to do this in this tutorial as well, in another tutorial, or simply "only" in the documentation of ASTE?

uekerman avatar Dec 04 '21 16:12 uekerman

What is our strategy to explain users how to reproduce their setup with ASTE? Do we want to do this in this tutorial as well, in another tutorial, or simply "only" in the documentation of ASTE?

Not completely sure at the moment, but I guess it fits best into the replay mode. We will have another tutorial for this anyway.

davidscn avatar Dec 06 '21 08:12 davidscn

What is our strategy to explain to users how to reproduce their setup with ASTE? Do we want to do this in this tutorial as well, in another tutorial, or simply "only" in the documentation of ASTE?

I think this tutorial just shows simply how users evaluate mapping of preCICE on their meshes, like the section on the reference paper. There would be another tutorial for reproducing their setup in ASTE (vector replay mode?).

kursatyurt avatar Dec 06 '21 09:12 kursatyurt

Just to avoid confusion, "replay mode" is yet another use case. I see the following three use case of ASTE:

  • To evaluate/study mapping methods on "artificial" geometries/meshes. This is what the tutorial here does.
  • Reproducing a specific mapping setup of a coupled case. For example: case crashes since mapping fails. User exports both meshes and values and imports in ASTE. Tries to reproduce in ASTE. Then, we could debug for them or they could test different basis functions etc.
  • Replay mode. Replace a participant in a coupled setup with ASTE. One then always gets a uni-directional coupling. This is useful for debugging, for developing new adapters, but also for efficiency reasons (explicit instead of implicit coupling etc).

uekerman avatar Dec 06 '21 11:12 uekerman

@uekerman considering the use-cases: would it make sense to create an aste directory on the top level and the three use-cases as subdirectories?

@kursatyurt You can ignore the check-scripts CI (please run shellcheck locally). However, the markdown file still has some issues.

davidscn avatar Jan 07 '22 08:01 davidscn

@uekerman considering the use-cases: would it make sense to create an aste directory on the top level and the three use-cases as subdirectories?

I am not yet sure about this, but I guess this is also a future problem. Let's first finish this one.

For the "test your mapping" use case, I am not sure whether we need a testcase (tutorial) at all. Maybe a step-by-step description in the docs would be better for this.

For the replay mode, I could imagine a:

- perpendicular-flap-one-way
  - fluid-aste
  - solid-dealii
  - solid ...

Or we just tell the user to copy the solid folders.

uekerman avatar Jan 29 '22 17:01 uekerman

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

https://precice.discourse.group/t/mapping-issue-forces-mapped-from-fluid-mesh-to-solid-mesh-look-weird-how-to-debug/1106/9

precice-bot avatar Jul 21 '22 08:07 precice-bot

I will tweak the documentation in a follow-up.

davidscn avatar Sep 19 '22 12:09 davidscn