Skip to content

v0.34.0

Latest

Choose a tag to compare

@gouarin gouarin released this 07 Nov 20:20
85c811e

0.34.0 (2026-11-07)

⚠ BREAKING CHANGES

  • io: name local_save files by rank on a single process too (#786)

Features

  • add static_dispatch (#469) (e94519b)
  • interval: write half-open intervals as [a, b) (#559) (703bd95)
  • lbm: Lattice Boltzmann schemes formalism (schemes/lbm) (#480) (d4fb02d)
  • lbm: remaining LBM cases (multi-block Euler, source term, wall/inflow BC) (#483) (2036662)
  • numeric: shared 1D prediction coefficients and the boundary shift (#490) (bf730e7)
  • restart: load a checkpoint on any number of processes (#724) (a516ab8)
  • subset: dynamic (runtime) set algebra (#485) (699c096)

Bug Fixes

  • address the C++ SonarQube Cloud findings on main (#758) (7e1ef84)
  • algorithm: give the right cell index in for_each_cell on a LevelCellArray (#744) (5e97bb0)
  • arguments: describe --dont-redirect-output as it behaves (#598) (f2ad811)
  • avoid GCC 15 -Warray-bounds false positives in restart, copy and the demos (#787) (9ef7127)
  • bc: delete Bc assignment and accept a predicate in Bc::on (#708) (62aea0c)
  • bc: extrapolate a far ghost only where its whole stencil exists (#790) (0828207)
  • bc: fill the outer ghosts beyond the third layer (#505) (01fff1e)
  • build MR and AMR meshes with cells at level 0 (#791) (299a068)
  • cmake: export the include directory of samurai::samurai on first configure (#715) (ba792b6)
  • cmake: find HDF5 in the installed config and make the package arch-independent (#780) (74ec2a0)
  • compile the PETSc assemblies and explicit flux-based schemes without warnings (#753) (fca0cd0)
  • compile the samurai headers without warnings (#745) (419b31f)
  • conda: declare metis in the MPI environment (#497) (17c52da)
  • demos: fix the time step, levels, subdomain check and outputs of burgers_os_2d_mpi (#509) (fa278a3)
  • demos: make --with-corner add the diagonal directions to the graduation (#702) (4277990)
  • demos: parse the advection_2d options once, in main (#782) (55f38b0)
  • demos: release the PETSc objects of manual_block_matrix_assembly before finalize (#717) (a03b59e)
  • demos: set every cell of the initial field in advection_1d (#774) (5820b6b)
  • demos: start the read_mesh.py hint of nagumo and heat at file 0 (#718) (80b6b70)
  • demos: stop the AMR Burgers mesh adaptation from flipping forever (#796) (8a55827)
  • demos: swap fields with samurai::swap so the scheme refreshes ghosts (#752) (ed707c1)
  • field: initialize a field with a Gauss-Legendre quadrature (#613) (6dbf63c)
  • fv: copy the constant velocity and update the Rusanov velocity ghosts (#711) (09dacb2)
  • fv: skip the level jump above the max level of the mesh in non-linear flux schemes (#709) (6a7e69b)
  • ghost: stop the level loop of update_outer_ghosts(field) at level 0 (#548) (23dc69a)
  • graduation (#473) (9b4d4fa)
  • interface: default include_periodic in the direction overload (#707) (8b793a3)
  • io: compute the --save-debug-fields values from the cells (#777) (1426066)
  • io: include the HighFive xtensor plug-in so restart.hpp compiles on its own (#726) (539ccde)
  • io: make braced options always build Hdf5Options in save (#783) (ec2c2c7)
  • io: make local_save(filename, mesh, fields...) write one file per process under MPI (#775) (daf5f33)
  • io: name local_save files by rank on a single process too (#786) (15c659e)
  • io: write each mesh vertex once when the cell length is not dyadic (#742) (4942abc)
  • lbm: apply the wall reflection on the domain corners (#487) (a25639c)
  • lbm: make the LBM time step non-const instead of mutating a mutable buffer (#760) (eab5842)
  • mesh: approximate boxes at their level when a scaling factor is set (#713) (0e47c98)
  • mesh: keep the configuration in the mesh built by make_empty_mesh (#508) (bf6135c)
  • mesh: start an AMR mesh at its max level by default and reject a start level outside the level range (#551) (c487099)
  • mr: avoid a size_t underflow in the harten tag-cells loop at level 0 (#498) (b94b83f)
  • mr: compile the multiresolution headers without warnings (#723) (9ae6ebd)
  • petsc: assemble ghosts and level jumps at subdomain boundaries with MPI (#545) (a18d277)
  • petsc: let nested block matrices and vectors own their blocks (#743) (63d5b82)
  • petsc: move everything in solver move assignment and forbid copies (#738) (e209cdc)
  • petsc: move the flux-based sparsity loops out of generic lambdas to avoid a GCC ICE (#776) (397783c)
  • petsc: number the columns of a non-square operator after its input field (#747) (6618af1)
  • petsc: solve non-linear cell-based schemes on scalar fields (#712) (16ed8c0)
  • petsc: use global indices in the fieldsplit index sets of a monolithic block matrix (#710) (1f59db3)
  • python: remove regex backtracking flagged by sonar (#733) (e195858)
  • read --min-corner and --max-corner with one value per coordinate and reject an empty box (#797) (1058ada)
  • reconstruction: make the prediction caches safe under OpenMP (#755) (5628fa5)
  • remove the compiler warnings from tests and demos (#746) (0937e9c)
  • remove the uncompilable MRMesh::exists and negate the boundary layer width as signed (#736) (d8ae40c)
  • restart: dump fields and check the process count for a UniformMesh (#716) (612cd79)
  • restart: keep the box flag of the domain across dump and load (#507) (1c0d6a2)
  • restart: write checkpoint intervals without their padding bytes (#779) (ab96c37)
  • schemes: compile NonLinear flux-based schemes with an odd stencil size (#705) (69c8c1c)
  • schemes: fill the ghosts of an AMR mesh with update_ghost in the finite volume operators (#552) (b1c8c90)
  • schemes: handle unaligned level-jump intervals in the explicit linear flux scheme (#542) (8e98b0a)
  • schemes: include update_ghost_mr.hpp where update_ghost_mr_if_needed is called (#547) (1012400)
  • schemes: move the boundary SIMD loop out of a generic lambda to avoid a GCC ICE (#754) (9ac83e0)
  • stats: repair the mesh statistics recorded with WITH_STATS (#756) (a0effd6)
  • stop printing to std::cout on normal library calls (#720) (422e47d)
  • tests: make test_samurai_lib run under mpi (#749) (d7fef09)
  • tests: pass --mr-eps to the demo in test_finite_volume_burgers_os (#719) (25f9e68)
  • tests: update the ghosts before applying the b.c. in bc_ghost_values (#750) (ed2afbe)
  • timers: share one timer registry across translation units (#714) (8481124)
  • transfer: resize the destination field to its mesh (#778) (c80a676)
  • yt: give series datasets the times found by discover_series (#741) (8d723ef)

Documentation

  • add CITATION.cff and fix the codemeta.json metadata (#602) (5981c41)
  • add generated plates and diagrams (#649) (450fe11)
  • add numbered definition and remark directives (#648) (70ecba8)
  • add the demos and samurai gallery pages (#612) (8529184)
  • align the graded-mesh check and the figure data location (#699) (a22e8d3)
  • api: add API pages for meshes, fields, adaptation, I/O, timers, schemes and PETSc (#600) (f87fc23)
  • api: add the load balancing, LBM and dynamic set algebra API pages (#622) (18183f9)
  • api: fix the Doxygen comments of the load balancing, LBM and dynamic set headers (#637) (ed57555)
  • api: make the Doxygen comments match the code, with 0 Doxygen warnings (#604) (0e5d110)
  • api: use doxygenstruct for NormalFluxDefinitionBase (#634) (3b7e681)
  • box: draw the domains of the snippets and the smallest hole (#688) (187fe8f)
  • contributing: document the figure modules and their rules (#692) (3218694)
  • contributing: rewrite the guide from a fresh clone to passing tests and a merged pull request (#621) (c9dc9f0)
  • css: keep command-line options on one line (#697) (2ec5043)
  • css: keep short hyphenated inline code on one line (#701) (c59a087)
  • design: record the serif heading scale and the rank tones (#661) (e833e1a)
  • field: draw how field values are stored (#696) (28827ce)
  • figures: add arrays, printed intervals and strided intervals (#658) (2cb0eb5)
  • figures: add cycles and chains of stations (#659) (f392150)
  • figures: add plots of 1D fields and details (#657) (3795c7e)
  • figures: add rank tones and space-filling curve orders (#660) (a21def1)
  • figures: document the constructor of static_svg.Node (#666) (7255e98)
  • figures: draw meshes from the cells a program exports (#656) (ac1c278)
  • figures: give each page its own figure module (#651) (50a3c91)
  • figures: let plates and diagrams take a hand-written svg (#662) (a5f3007)
  • figures: set flow statements glyph by glyph and inset the loop note panel (#695) (78da424)
  • github: guide pull request authors step by step and drop the code of conduct checkbox (#765) (1b65c93)
  • github: rewrite the pull request template as writing guidance (#549) (ed4a1cb)
  • howto: add a guide to build a domain with obstacles (#617) (f86d5b4)
  • howto: add a guide to run a samurai program with MPI (#596) (aa7c963)
  • howto: add a how-to for adapting a mesh with multiresolution (#554) (b2a0778)
  • howto: add a how-to for implicit solves with PETSc (#615) (94b7579)
  • howto: add a how-to for restarting a simulation from a checkpoint (#560) (fd4c04e)
  • howto: add a troubleshooting page for common error messages (#614) (0396732)
  • howto: add the boundary conditions and finite volume scheme how-tos (#644) (fcd61fb)
  • howto: compile every how-to code sample and show real output (#618) (7d5f851)
  • howto: cover field initialization and samurai CMake options in the how-tos (#525) (de48ace)
  • howto: draw the ghost ring of the uniform mesh (#690) (4a878da)
  • howto: draw the ghost values of the boundary conditions (#682) (f15d421)
  • howto: draw the obstacle mesh of the geometry guide from its program (#684) (8ceb414)
  • howto: draw the stencil indices of a wider flux (#683) (93471a8)
  • howto: fix --help in the options how-to and list the predefined options (#519) (d868570)
  • howto: fix the box how-to for union, holes and mra::make_mesh (#524) (eafecb9)
  • howto: fix the installation how-to for conda-forge, MPI builds and build options (#520) (2afd9e1)
  • howto: fix the loop how-to so the text matches its snippets (#521) (ee8b78b)
  • howto: fix the mesh how-to for the mesh configuration API (#517) (be16d61)
  • howto: fix the plot how-to and list every viewer (#523) (de8805c)
  • howto: fix the save how-to and make the dump snippet reload its file (#518) (fbe1811)
  • howto: illustrate the multiresolution adaptation (#673) (ff02d72)
  • howto: point the mesh and domain how-tos to the internal pages (#646) (9fd0b5c)
  • howto: rewrite the timers how-to for ScopedTimer, nesting, cell counts and MPI (#522) (c63a298)
  • howto: show the arguments of for_each_interval in the loop how-to (#689) (be46b25)
  • howto: show the MPI subdomains before and after load balancing (#685) (5e84393)
  • howto: use spaced separator rows in the option tables (#528) (b686dd7)
  • index: give the landing page its plate (#671) (53a1376)
  • introduce and group the section landing pages (#567) (a1bdf4e)
  • io: render the save overloads that take a communicator (#785) (55bdffd)
  • lbm: draw the lattice Boltzmann scheme figures from code (#678) (988d321)
  • lbm: draw the velocity sets and the setups of the test cases (#679) (32caea3)
  • lbm: port the LBM test cases page to MyST and fix its equations (#561) (995e9ee)
  • lbm: walk through a D2Q4 scheme written with the schemes/lbm formalism (#619) (a7d4010)
  • move the code of conduct to Contributor Covenant 2.1 (#603) (3dc8d9e)
  • name the order of a prediction as 2s + 1 everywhere (#704) (22a09a3)
  • petsc: draw the PETSc numbering of the 4 by 4 mesh on two ranks (#691) (39f3d58)
  • readme: port the code samples to the current API and fix stated facts (#516) (e7d01d9)
  • readme: turn the README into a front door (#623) (82b31b5)
  • readme: use make_convection_upwind in the advection example and demo (#539) (b5a03e1)
  • record the product and the visual system of the documentation (#652) (778388f)
  • reference: complete the local schemes reference and port it to MyST (#563) (f659cb0)
  • reference: draw the cells the boundary conditions read and write (#680) (0ba0308)
  • reference: draw the finite volume faces and stencils from code (#670) (fed72e5)
  • reference: draw the outward rounding of a set projection (#687) (8fd77c6)
  • reference: draw the stencil order of the cell-based schemes (#686) (b5d5352)
  • reference: illustrate the load balancing strategies (#681) (5f55e87)
  • reference: keep the origin labels of the finite volume stencils legible (#698) (c2a902a)
  • reference: port the boundary conditions reference to MyST and the current API (#556) (96ed6d5)
  • reference: port the finite volume schemes reference to MyST and fix its code (#557) (23ffd3d)
  • reference: port the load balancing reference to MyST and anchor it to the code (#565) (c3f3d6d)
  • reference: print the dynamic set algebra snippet intervals as [a, b) (#564) (95d78c3)
  • reference: recommend -snes_mf, not -snes_fd, for schemes without a Jacobian (#633) (608e0cd)
  • reference: remove figure files no page uses (#653) (a0e7fee)
  • reference: rewrite the set algebra reference for the current API and port it to MyST (#558) (8466406)
  • reference: say where --finer-level-flux applies in implicit solves (#706) (945202e)
  • rewrite the landing page and keep the header on one row (#566) (8034430)
  • schemes: fix the enlarged stencil example of FluxDefinition (#643) (5f1c951)
  • theme: even out spaced capitals and fit tables to the column (#654) (7367b84)
  • theme: make section headings stand out from the text (#655) (f7ac641)
  • theme: switch the documentation to Furo with a book-like stylesheet (#645) (73778be)
  • tutorial: adapt the mesh at each time step in the Burgers tutorial and compile its program (#540) (7172b7a)
  • tutorial: add a getting started tutorial (#536) (d53fa52)
  • tutorial: add a page presenting the Hands-on samurai course (#533) (cd005c4)
  • tutorial: build the interval tutorial snippets and regenerate their outputs (#620) (9ecbebe)
  • tutorial: draw the graduation case 1 meshes from the demo (#667) (e9e8462)
  • tutorial: draw the graduation case 3 meshes and the even/odd split (#672) (1afe7c3)
  • tutorial: draw the interval figures from code (#664) (59faf7d)
  • tutorial: draw the shifted interval of the upwind scheme (#677) (a3660c8)
  • tutorial: draw the stencils of the level set schemes (#675) (234a6b4)
  • tutorial: draw the subset figures of the operator on subset tutorial (#663) (ab456d5)
  • tutorial: illustrate the 1D Burgers AMR tutorial (#676) (89177df)
  • tutorial: include the demo listings by marker instead of line number (#647) (6cf579c)
  • tutorial: keep the disc outline inside the finest cells (#700) (668b094)
  • tutorial: port the Burgers tutorial to MyST and fix its math (#538) (e090767)
  • tutorial: port the field tutorial to MyST and the current API (#529) (9261830)
  • tutorial: port the graduation tutorials to MyST and the current demos (#532) (f3a8b75)
  • tutorial: port the interval tutorial to MyST and fix its 2D example (#537) (d42cab5)
  • tutorial: port the level-set tutorial to MyST and the current demo (#534) (d632331)
  • tutorial: port the loop tutorial to MyST and the current API (#530) (01ff659)
  • tutorial: port the reaction-diffusion tutorial to MyST and the current API (#535) (d139f88)
  • tutorial: port the set operator tutorial to MyST and the current set algebra (#531) (91d20c6)
  • tutorial: redraw the graduation case 2 meshes from the demo (#668) (40a38a8)
  • tutorial: show the detail in the getting started tutorial (#665) (e59d0df)
  • tutorial: show the front of the reaction-diffusion tutorial (#693) (6647aa6)
  • tutorial: show what a graded mesh allows (#674) (774acda)
  • write the philosophy page and port it to MyST (#562) (712aa46)

Code Refactoring

  • bc: share the boundary region of a direction between Everywhere and OnDirection (#771) (7d85a87)
  • bc: share the layer loop of the far ghost extrapolation (#772) (5bc87ee)
  • fv: share the boundary equations and the two-point flux of the diffusion schemes (#762) (9bd19fd)
  • fv: share the face fluxes of upwind_op and upwind_scalar_burgers_op (#768) (83d8b6b)
  • fv: share the state and the interior interface loop of the flux-based schemes (#764) (a0d55a3)
  • interface: share the iterator setup and the level-jump cell pairs of the interface traversals (#766) (bfaa6c8)
  • io: share the hdf5 writer code between mesh types and builds (#761) (359d258)
  • mr: remove dead code around detail computation and refine_ghost (#488) (5bbb995)
  • petsc: share the row and column numbering of FVSchemeAssembly and ManualAssembly (#769) (7b7ac7e)
  • remove legacy flux_correction from FV demos (#479) (09f17bb)
  • route the four prediction consumers through the shared coefficients (#491) (4cbe7c3)
  • schemes: give the schemes and assemblies real move operations (#739) (4fb4d1c)
  • share cells_changed_by_tag and ghosts_below_cells, fix interval header warnings (#727) (3256038)
  • storage: write the xtensor views once for const and non-const containers (#767) (46cd930)
  • timers: print the footer of the MPI and sequential timer tables with one lambda (#770) (548c29a)
  • tools: share file helpers between the paraview and yt readers (#740) (c68e9d0)

Performance

  • lbm: faster multi-level stream (slice reconstruction, hoisted scalar-loop stencils) (#484) (732a40c)
  • mesh: build the domain corners once per domain (#799) (c79a648)
  • mesh: detect the adaptation fixed point before constructing the new mesh (#476) (76832e2)
  • mr: faster multiresolution detail computation (#481) (3051810)
  • prediction: contract the prediction stencil one direction at a time (#798) (e0f5b04)
  • speed up the multiresolution mesh-update phase (#482) (2b8d4db)
  • subset traverser (#474) (599aa5d)

Tests

  • bc: assert boundary reproduction order in the cell-average convention (#489) (cb67b73)
  • benchmark: check every backend against reference checksums and plot the sweep (#730) (4050ed6)
  • benchmark: measure the set algebra on synthetic sets and on the call sites of the library (#721) (aef3c38)
  • benchmark: run the set algebra benchmarks over the level, on more geometries and on partitions (#729) (9fd14f7)
  • benchmark: time the call sites that build level cell arrays and the ways to consume a set (#728) (334ff56)
  • demos: sort the file lists before comparing them in the h5diff check (#553) (c8be8a3)
  • ghost update parallel tests (#475) (6177b86)
  • graduation: give the width tests' tag ownership of its mesh (#499) (7fa7237)
  • restart: edit the checkpoint on one process only in restart_file_without_is_box (#725) (493e392)

Chores

  • add a markdownlint configuration matching the docs conventions (#527) (fc04700)
  • demos: remove the legacy lattice boltzmann demos (#748) (7f86c06)
  • demos: remove the weno and bz demos that no target builds (#737) (6d26ca4)
  • github: ask for what a bug needs to be reproduced in the issue forms (#601) (9a39f95)
  • remove Codacy leftovers (#734) (d324bfe)

CI/CD

  • build the coverage job with two jobs to stay within the runner memory (#788) (9e77d1a)
  • deps: bump the github-actions group across 1 directory with 7 updates (#751) (7e404bc)
  • deps: bump the github-actions group with 3 updates (#789) (c34f92a)
  • docs: fail the docs build on warnings and check links weekly (#636) (af9eb12)
  • give Codacy a Prospector profile without the D213 docstring rule (#650) (c857042)
  • pin third-party actions to commit SHAs and let dependabot bump them (#731) (d510b65)
  • pre-commit: run markdownlint-cli2 on the Markdown files (#694) (8620ef4)
  • release: read release-please-config.json in the release workflow (#606) (4cc4d5b)
  • send the C++ and Python coverage to Codecov (#784) (8a508ba)
  • skip build and test jobs when a pull request only changes documentation (#526) (56ed802)
  • snippets: build the snippets with PETSc (#635) (5889202)

Build System

  • cmake: make ENABLE_COVERAGE add the coverage flags (#781) (baa63e3)
  • cmake: update project_options from v0.41.0 to v0.44.0 (#773) (6ace6b9)
  • docs: accept only MyST sources and let make html run without Doxygen (#595) (1894c71)
  • docs: configure Sphinx for MyST pages and local Doxygen runs (#515) (fc52506)
  • docs: generate the snippet outputs and check them in CI (#638) (2dd8e0e)