Skip to content

Commit

Permalink
Update versions and README (#484)
Browse files Browse the repository at this point in the history
  • Loading branch information
MakisH authored Apr 13, 2024
1 parent 340b447 commit bf312a9
Show file tree
Hide file tree
Showing 4 changed files with 23 additions and 17 deletions.
9 changes: 4 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,13 @@
# preCICE tutorials

> [!IMPORTANT]
> This repository is aimed for development purposes and the default branch is `develop`. If you want to use the tutorials, switch to the [`master` branch](https://github.com/precice/tutorials/tree/master) or download the latest [release](https://github.com/precice/tutorials/releases).
This repository contains ready-to-run tutorial cases for the coupling library [preCICE](https://precice.org/).
The purpose of these cases is not to teach you how to use preCICE from scratch, but to serve as starting points for setting up similar simulation cases, as well as test cases. Read more on our [preCICE tutorials](https://precice.org/tutorials.html) documentation section.

As a general rule, you can start each participant from inside their `<tutorial>/<participant>-<solver>` using `./run.sh`. Look into these short scripts and copy the parts you need for your new case. Before running again, execute the cleaning scripts you can find at each level, to clean from this point and deeper.

Contributions to this repository are very welcome. Please refer to the page [Contribute to preCICE](https://precice.org/community-contribute-to-precice.html) for a few guidelines and hints to help you in this direction.

## LFS usage

Since we rely on LFS to version systemtest artifacts like reference solutions, we host our own LFS server.
Please note, that during a small phase of initial setup, this server might not be reachable from your machine.
Therefore your git lfs fetch might fail.
Note that we use [Git LFS](https://git-lfs.com/) to version reference results. These will appear as seemingly empty files containing URLs if you don't have Git LFS installed (optional, mainly useful for our system tests).
19 changes: 13 additions & 6 deletions quickstart/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,21 +21,28 @@ To get a feeling what preCICE does, watch a [short presentation](https://www.you
1. Get and install preCICE. For Ubuntu 22.04 (Jammy Jellyfish), this is pretty easy: [download](https://github.com/precice/precice/releases/latest) and install our binary package by clicking on it or using the following commands:

```bash
wget https://github.com/precice/precice/releases/download/v2.5.0/libprecice2_2.5.0_jammy.deb
sudo apt install ./libprecice2_2.5.0_jammy.deb
wget https://github.com/precice/precice/releases/download/v3.1.1/libprecice3_3.1.1_jammy.deb
sudo apt install ./libprecice3_3.1.1_jammy.deb
```

- Are you using something else? Just pick what suits you best on [this overview page](https://precice.org/installation-overview.html).
| OS | Package |
| --- | --- |
| Ubuntu 20.04 Focal Fossa | [`libprecice3_3.1.1_focal.deb`](https://github.com/precice/precice/releases/download/v3.1.1/libprecice3_3.1.1_focal.deb) |
| Ubuntu 22.04 Jammy Jellyfish | [`libprecice3_3.1.1_jammy.deb`](https://github.com/precice/precice/releases/download/v3.1.1/libprecice3_3.1.1_jammy.deb) |
| Debian 11 "bullseye" | [`libprecice3_3.1.1_bullseye.deb`](https://github.com/precice/precice/releases/download/v3.1.1/libprecice3_3.1.1_bullseye.deb) |
| Debian 12 "bookworm" | [`libprecice3_3.1.1_bookworm.deb`](https://github.com/precice/precice/releases/download/v3.1.1/libprecice3_3.1.1_bookworm.deb) |
| Something else | See an [overview of options](https://precice.org/installation-overview.html) |

- Facing any problems? [Ask for help](https://precice.org/community-channels.html).
2. We will use OpenFOAM here and in many of our tutorial cases, so [install OpenFOAM](https://precice.org/adapter-openfoam-support.html):

```bash
# Add the signing key, add the repository, update (check this):
wget -q -O - https://dl.openfoam.com/add-debian-repo.sh | sudo bash
# Install OpenFOAM v2306:
sudo apt install openfoam2306-dev
# Install OpenFOAM v2312:
sudo apt install openfoam2312-dev
# Enable OpenFOAM by default in your system and apply now:
echo "source /usr/lib/openfoam/openfoam2306/etc/bashrc" >> ~/.bashrc
echo "source /usr/lib/openfoam/openfoam2312/etc/bashrc" >> ~/.bashrc
source ~/.bashrc
```

Expand Down
4 changes: 2 additions & 2 deletions tools/tests/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ gh workflow run run_testsuite_manual.yml -f suites=fenics_test --ref=develop
Another example, to use the latest releases and enable debug information of the tests:

```shell
gh workflow run run_testsuite_manual.yml -f suites=fenics_test -f build_args="PRECICE_REF:v2.5.0,OPENFOAM_ADAPTER_REF:v1.2.3,PYTHON_BINDINGS_REF:v2.5.0.4,FENICS_ADAPTER_REF:v1.4.0" -f loglevel=DEBUG --ref=develop
gh workflow run run_testsuite_manual.yml -f suites=fenics_test -f build_args="PRECICE_REF:v3.1.1,OPENFOAM_ADAPTER_REF:v1.3.0,PYTHON_BINDINGS_REF:v3.1.0,FENICS_ADAPTER_REF:v2.1.0" -f loglevel=DEBUG --ref=develop
```

where the `*_REF` should be a specific [commit-ish](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddefcommit-ishacommit-ishalsocommittish).
Expand All @@ -71,7 +71,7 @@ Example output:
```text
Run cd tools/tests
cd tools/tests
python systemtests.py --build_args=PRECICE_REF:v2.5.0,OPENFOAM_ADAPTER_REF:v1.2.3,PYTHON_BINDINGS_REF:v2.5.0.4,FENICS_ADAPTER_REF:v1.4.0 --suites=fenics_test --log-level=DEBUG
python systemtests.py --build_args=PRECICE_REF:v3.1.1,OPENFOAM_ADAPTER_REF:v1.3.0,PYTHON_BINDINGS_REF:v3.1.0,FENICS_ADAPTER_REF:v2.1.0 --suites=fenics_test --log-level=DEBUG
cd ../../
shell: /usr/bin/bash -e {0}
INFO: About to run the following systemtest in the directory /home/precice/runners_root/actions-runner-tutorial/_work/tutorials/tutorials/runs:
Expand Down
8 changes: 4 additions & 4 deletions tools/tests/reference_versions.yaml
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
PRECICE_REF: "v3.0.0"
OPENFOAM_EXECUTABLE: "openfoam2306"
PRECICE_REF: "v3.1.1"
OPENFOAM_EXECUTABLE: "openfoam2312"
OPENFOAM_ADAPTER_REF: "v1.3.0"
PYTHON_BINDINGS_REF: "v3.0.0.0"
PYTHON_BINDINGS_REF: "v3.1.0"
FENICS_ADAPTER_REF: "v2.1.0"
TUTORIALS_REF: "3f139d36f1708fb3ebfde2c48f14b1df94c9d70a"
TUTORIALS_REF: "340b447" # April 12, 2024, just before v202404.0
PLATFORM: "ubuntu_2204"
CALULIX_VERSION: "2.20"
CALULIX_ADAPTER_REF: "v2.20.1"

0 comments on commit bf312a9

Please sign in to comment.