From a9466c4ec1e728e0457a1dc109475bb853a9a683 Mon Sep 17 00:00:00 2001 From: Jonah Maxwell Miller Date: Tue, 6 Feb 2024 14:18:22 -0700 Subject: [PATCH] update vibe --- doc/sphinx/03_vibe/vibe.rst | 24 ++++++++++++++++++++++-- parthenon | 2 +- 2 files changed, 23 insertions(+), 3 deletions(-) diff --git a/doc/sphinx/03_vibe/vibe.rst b/doc/sphinx/03_vibe/vibe.rst index 6bfcd96b..7cff2d55 100644 --- a/doc/sphinx/03_vibe/vibe.rst +++ b/doc/sphinx/03_vibe/vibe.rst @@ -204,9 +204,29 @@ Throughput performance of Parthenon-VIBE on a 40GB A100 is provided within the f Validation ========== - +Parthenon-VIBE prints to a history file (default name ``burgers.hst``) a +time series of the sum of squares of evolved variables integrated over +volume for each octant of the domain, as well as the total number of +meshblocks in the simulation at that time. To compare these quantities +between runs, we provide the ``burgers_diff.py`` program in the +benchmark folder. This will diff two history files and report when the +relative difference is greater than some tolerance. + +.. note:: + + ``burgers.hst`` is **appended** to when the executable is re-run. So + if you want to compare two different history files, rename the + history file by changing either ``problem_id`` in the ``parthenon/job`` + block in the input deck (this can be done on the command line. When + you start the program, add ``parthenon/job/problem_id=mynewname`` to + the command line argument), or copy the old file to back it up. + +To check that a modified calculation is still correct, run +``burgers_diff.py`` to compare a new run to the fiducial one at the +default tolerance. If no diffs are reported, the modified calculation +is correct. References ========== -.. [Parthenon-VIBE] Jonah Miller, 'Parthenon', 2023. [Online]. Available: https://github.com/parthenon-hpc-lab/parthenon. [Accessed: 20- Mar- 2023] +.. [Parthenon-VIBE] Jonah Miller, 'Parthenon', 2024. [Online]. Available: https://github.com/parthenon-hpc-lab/parthenon. [Accessed: 06- Feb- 2024] diff --git a/parthenon b/parthenon index 11c53d1c..f7ea1d01 160000 --- a/parthenon +++ b/parthenon @@ -1 +1 @@ -Subproject commit 11c53d1cd4ada0629e06d069b70b410234ed0bde +Subproject commit f7ea1d01fe7282a1e08f3978a73c9acf6654209e