gridap · amboschman · Jul 28, 2025 · Jun 7, 2024 · Jun 7, 2024 · Jun 8, 2024
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
@@ -0,0 +1,7 @@
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "monthly"
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -8,31 +8,22 @@ jobs:
       fail-fast: false
       matrix:
         version:
-          - '1.8'
+          - '1.10'
         os:
           - ubuntu-latest
         arch:
           - x64
     steps:
-      - uses: actions/checkout@v2
-      - uses: julia-actions/setup-julia@v1
+      - uses: actions/checkout@v4
+      - uses: julia-actions/setup-julia@v2
         with:
           version: ${{ matrix.version }}
           arch: ${{ matrix.arch }}
-      - uses: actions/cache@v1
-        env:
-          cache-name: cache-artifacts
-        with:
-          path: ~/.julia/artifacts
-          key: ${{ runner.os }}-test-${{ env.cache-name }}-${{ hashFiles('**/Project.toml') }}
-          restore-keys: |
-            ${{ runner.os }}-test-${{ env.cache-name }}-
-            ${{ runner.os }}-test-
-            ${{ runner.os }}-
+      - uses: julia-actions/cache@v2
       - uses: julia-actions/julia-buildpkg@v1
       - uses: julia-actions/julia-runtest@v1
       - uses: julia-actions/julia-processcoverage@v1
-      - uses: codecov/codecov-action@v1
+      - uses: codecov/codecov-action@v5
         with:
           file: lcov.info
   drivers:
@@ -42,27 +33,18 @@ jobs:
       fail-fast: false
       matrix:
         version:
-          - '1.8'
+          - '1.10'
         os:
           - ubuntu-latest
         arch:
           - x64
     steps:
-      - uses: actions/checkout@v2
-      - uses: julia-actions/setup-julia@v1
+      - uses: actions/checkout@v4
+      - uses: julia-actions/setup-julia@v2
         with:
           version: ${{ matrix.version }}
           arch: ${{ matrix.arch }}
-      - uses: actions/cache@v1
-        env:
-          cache-name: cache-artifacts
-        with:
-          path: ~/.julia/artifacts
-          key: ${{ runner.os }}-test-${{ env.cache-name }}-${{ hashFiles('**/Project.toml') }}
-          restore-keys: |
-            ${{ runner.os }}-test-${{ env.cache-name }}-
-            ${{ runner.os }}-test-
-            ${{ runner.os }}-
+      - uses: julia-actions/cache@v2
       - uses: julia-actions/julia-buildpkg@v1
       - run: |
           julia --color=yes --project=. --check-bounds=yes --depwarn=error -e '
@@ -77,27 +59,18 @@ jobs:
       fail-fast: false
       matrix:
         version:
-          - '1.8'
+          - '1.10'
         os:
           - ubuntu-latest
         arch:
           - x64
     steps:
-      - uses: actions/checkout@v2
-      - uses: julia-actions/setup-julia@v1
+      - uses: actions/checkout@v4
+      - uses: julia-actions/setup-julia@v2
         with:
           version: ${{ matrix.version }}
           arch: ${{ matrix.arch }}
-      - uses: actions/cache@v1
-        env:
-          cache-name: cache-artifacts
-        with:
-          path: ~/.julia/artifacts
-          key: ${{ runner.os }}-test-${{ env.cache-name }}-${{ hashFiles('**/Project.toml') }}
-          restore-keys: |
-            ${{ runner.os }}-test-${{ env.cache-name }}-
-            ${{ runner.os }}-test-
-            ${{ runner.os }}-
+      - uses: julia-actions/cache@v2
       - uses: julia-actions/julia-buildpkg@v1
       - run: |
           julia --color=yes --project=. --check-bounds=yes --depwarn=error -e '
@@ -109,10 +82,10 @@ jobs:
     name: Documentation
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: julia-actions/setup-julia@v1
+      - uses: actions/checkout@v4
+      - uses: julia-actions/setup-julia@v2
         with:
-          version: '1.8'
+          version: '1.10'
       - run: |
           julia --project=docs -e '
             using Pkg

diff --git a/.github/workflows/ci_x86.yml b/.github/workflows/ci_x86.yml
@@ -14,26 +14,17 @@ jobs:
       fail-fast: false
       matrix:
         version:
-          - '1.8'
+          - '1.10'
         os:
           - ubuntu-latest
         arch:
           - x86 
     steps:
-      - uses: actions/checkout@v2
-      - uses: julia-actions/setup-julia@v1
+      - uses: actions/checkout@v4
+      - uses: julia-actions/setup-julia@v2
         with:
           version: ${{ matrix.version }}
           arch: ${{ matrix.arch }}
-      - uses: actions/cache@v1
-        env:
-          cache-name: cache-artifacts
-        with:
-          path: ~/.julia/artifacts
-          key: ${{ runner.os }}-test-${{ env.cache-name }}-${{ hashFiles('**/Project.toml') }}
-          restore-keys: |
-            ${{ runner.os }}-test-${{ env.cache-name }}-
-            ${{ runner.os }}-test-
-            ${{ runner.os }}-
+      - uses: julia-actions/cache@v2
       - uses: julia-actions/julia-buildpkg@v1
       - uses: julia-actions/julia-runtest@v1
diff --git a/.gitignore b/.gitignore
@@ -6,5 +6,6 @@
 /docs/build/
 /docs/site/
 Manifest.toml
+LocalPreferences.toml
 .vscode/
 *.swp
diff --git a/NEWS.md b/NEWS.md
@@ -4,12 +4,44 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.9.8] - 2025-7-10
+
+### Added
+
+- Added missing update_trian! method for MultiField. Since PR[#112](https://github.com/gridap/GridapEmbedded.jl/pull/112).
+
+### Fixed
+
+- Fixed failed precompilation due to Gridap v0.19.2. Since PR[#112](https://github.com/gridap/GridapEmbedded.jl/pull/112).
+
+## [0.9.7] - 2025-6-11
+
+### Added
+
+- Added support for Gridap v0.19. Since PR[#110](https://github.com/gridap/GridapEmbedded.jl/pull/110).
+
+## [0.9.6] - 2025-04-19
+
+### Added
+
+- Added support for distributed level-set geometries. Since PR[#99](https://github.com/gridap/GridapEmbedded.jl/pull/99).
+- Refactored the distributed code to allow for ghosted/unghosted geometries and triangulations. Since PR[#100](https://github.com/gridap/GridapEmbedded.jl/pull/100).
+- Implemented geometrical derivatives. Since PR[#109](https://github.com/gridap/GridapEmbedded.jl/pull/109).
+- Added a proper documentation. Since PR[#109](https://github.com/gridap/GridapEmbedded.jl/pull/109).
+
+### Changed
+
+- Swapped `LightGraphs.jl` dependency to `Graphs.jl`, due to the former being deprecated. Since PR[#108](https://github.com/gridap/GridapEmbedded.jl/pull/108).
+
+## [0.9.5] - 2024-10-18
 
 ### Added
 
 - Adding `compute_redistribute_weights` and `compute_adaptive_flags` functions for load balancing and adaptive mesh refinement, respectively. Since PR [#95](https://github.com/gridap/GridapEmbedded.jl/pull/95).
 
+### Changed
+
+- Updated to Algoim v0.2.2, which runs on Julia 1.11. Since PR [#97](https://github.com/gridap/GridapEmbedded.jl/pull/97).
 
 ## [0.9.4] - 2024-07-09
 

diff --git a/Project.toml b/Project.toml
@@ -1,17 +1,18 @@
 name = "GridapEmbedded"
 uuid = "8838a6a3-0006-4405-b874-385995508d5d"
 authors = ["Francesc Verdugo <f.verdugo.rojano@vu.nl>", "Eric Neiva <eric.neiva@college-de-france.fr>", "Pere Antoni Martorell <pere.antoni.martorell@upc.edu>", "Santiago Badia <santiago.badia@monash.edu>"]
-version = "0.9.4"
+version = "0.9.8"
 
 [deps]
 AbstractTrees = "1520ce14-60c1-5f80-bbc7-55ef81b5835c"
 Algoim = "0eb9048c-21de-4c7a-bfac-056de1940b74"
 Combinatorics = "861a8166-3701-5b0c-9a16-15d98fcdc6aa"
 CxxWrap = "1f15a43c-97ca-5a2a-ae31-89f07a497df4"
 FillArrays = "1a297f60-69ca-5386-bcde-b61e274b549b"
+ForwardDiff = "f6369f11-7733-5829-9624-2563aa707210"
+Graphs = "86223c79-3864-5bf0-83f7-82e725a168b6"
 Gridap = "56d4f2e9-7ea1-5844-9cf6-b9c51ca7ce8e"
 GridapDistributed = "f9701e48-63b3-45aa-9a63-9bc6c271f355"
-LightGraphs = "093fc24a-ae57-5d10-9952-331d41423f4d"
 LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
 MPI = "da04e1cc-30fd-572f-bb4f-1f8673147195"
 MiniQhull = "978d7f02-9e05-4691-894f-ae31a51d76ca"
@@ -22,20 +23,24 @@ algoimWrapper_jll = "3c43aa7b-5398-51f3-8d75-8f051e6faa4d"
 
 [compat]
 AbstractTrees = "0.3.3, 0.4"
-Algoim = "0.2"
+Algoim = "0.2.2"
 Combinatorics = "1"
-CxxWrap = "0.14"
+CxxWrap = "0.16"
 FillArrays = "0.10, 0.11, 0.12, 0.13, 1"
-Gridap = "0.17, 0.18"
+FiniteDiff = "2.27.0"
+ForwardDiff = "0.10.38, 1"
+Graphs = "1.12.0"
+Gridap = "0.18.12, 0.19"
 GridapDistributed = "0.3, 0.4"
-LightGraphs = "1.3.3"
 MPI = "0.20"
 MiniQhull = "0.1.0, 0.2, 0.3, 0.4"
 PartitionedArrays = "0.3.4"
 julia = "1.3"
 
 [extras]
+FiniteDiff = "6a86dc24-6348-571c-b903-95158fe2bd41"
+MPIPreferences = "3da0fdf6-3ccc-4f1b-acd9-58baa6c99267"
 Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
 
 [targets]
-test = ["Test"]
+test = ["Test", "FiniteDiff"]
diff --git a/README.md b/README.md
@@ -2,6 +2,7 @@
 
 Embedded finite element methods, level set surface descriptions and constructive solid geometry.
 
+[![Stable](https://img.shields.io/badge/docs-stable-blue.svg)](https://gridap.github.io/GridapEmbedded.jl/stable)
 [![Build Status](https://github.com/gridap/GridapEmbedded.jl/workflows/CI/badge.svg?branch=master)](https://github.com/gridap/GridapEmbedded.jl/actions?query=workflow%3ACI)
 [![Codecov](https://codecov.io/gh/gridap/GridapEmbedded.jl/branch/master/graph/badge.svg)](https://codecov.io/gh/gridap/GridapEmbedded.jl)
 
@@ -40,4 +41,3 @@ julia> BimaterialLinElastCutFEM.main(n=4,outputfile="results3")
 ```
 
 <img src="https://raw.githubusercontent.com/gridap/GridapEmbedded.jl/master/examples/BimaterialLinElastCutFEM/BimaterialLinElastCutFEM_solution.png" width="400">
-
diff --git a/docs/Project.toml b/docs/Project.toml
@@ -1,2 +1,3 @@
 [deps]
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+GridapEmbedded = "8838a6a3-0006-4405-b874-385995508d5d"
diff --git a/docs/make.jl b/docs/make.jl
@@ -1,14 +1,25 @@
 using Documenter, GridapEmbedded
 
+pages = [
+    "Home" => "index.md",
+    "Constructive Solid Geometry (CSG)" => "CSG.md",
+    "Embedded Interfaces" => "Interfaces.md",
+    "Level Set Cutters" => "LevelSetCutters.md",
+    "Aggregated FEM" => "AggregatedFEM.md",
+    "Moment-Fitted Quadratures" => "MomentFittedQuadratures.md",
+    "Geometrical Derivatives" => "GeometricalDerivatives.md",
+    "Distributed computing" => "Distributed.md",
+]
+
 makedocs(;
-    modules=[GridapEmbedded],
-    format=Documenter.HTML(),
-    pages=[
-        "Home" => "index.md",
-    ],
-    repo="https://github.com/gridap/GridapEmbedded.jl/blob/{commit}{path}#L{line}",
-    sitename="GridapEmbedded.jl",
-    authors="Francesc Verdugo <f.verdugo.rojano@vu.nl>, Eric Neiva <eric.neiva@college-de-france.fr> and Santiago Badia <santiago.badia@monash.edu>",
+    modules = [GridapEmbedded],
+    format = Documenter.HTML(
+        size_threshold=nothing
+    ),
+    sitename = "GridapEmbedded.jl",
+    authors = "Francesc Verdugo <f.verdugo.rojano@vu.nl>, Eric Neiva <eric.neiva@college-de-france.fr> and Santiago Badia <santiago.badia@monash.edu>",
+    pages = pages,
+    warnonly = false,
 )
 
 deploydocs(;

diff --git a/docs/src/AggregatedFEM.md b/docs/src/AggregatedFEM.md
@@ -0,0 +1,16 @@
+
+# Aggregated FEM
+
+```@meta
+CurrentModule = GridapEmbedded.AgFEM
+```
+
+```@autodocs
+Modules = [AgFEM,]
+Order   = [:type, :constant, :macro, :function]
+Pages   = [
+  "/AgFEM.jl", 
+  "/AgFEMSpaces.jl",
+  "CellAggregation.jl" 
+]
+```
diff --git a/docs/src/CSG.md b/docs/src/CSG.md
@@ -0,0 +1,15 @@
+
+# Constructive Solid Geometry (CSG)
+
+```@meta
+CurrentModule = GridapEmbedded.CSG
+```
+
+```@autodocs
+Modules = [CSG,]
+Order   = [:type, :constant, :macro, :function]
+Pages   = [
+  "/Nodes.jl", 
+  "/Geometries.jl", 
+]
+```
diff --git a/docs/src/Distributed.md b/docs/src/Distributed.md
@@ -0,0 +1,23 @@
+
+# Distributed computing
+
+```@meta
+CurrentModule = GridapEmbedded.Distributed
+```
+
+We support distributed computing through [GridapDistributed.jl](https://github.com/gridap/GridapDistributed.jl). As per usual, we design our libraries so that the high-level API is unchanged when using distributed computing. This means that for most users, the changes to your driver will be minimal.
+
+The following features are currently supported:
+
+- Level-Set Cutters
+- STL Cutters
+
+The folowing features are not yet supported:
+
+- Aggregated FEM
+- Moment-Fitted Quadratures
+
+```@autodocs
+Modules = [Distributed,]
+Order   = [:type, :constant, :macro, :function]
+```
diff --git a/docs/src/GeometricalDerivatives.md b/docs/src/GeometricalDerivatives.md
@@ -0,0 +1,33 @@
+# Geometrical Derivatives
+
+```@meta
+CurrentModule = GridapEmbedded
+```
+
+The geometrical differentiation capabilities are based on the following work:
+
+!!! note "Reference"
+    "Level-set topology optimisation with unfitted finite elements and automatic shape differentiation",
+    by Z. J. Wegert, J. Manyer, C. Mallon, S. Badia, V. J. Challis (2025)
+
+To see examples of usage, please refer to the tests in `test/LevelSetCuttersTests/GeometricalDifferentiationTests.jl`.
+
+## Discretize then differentiate
+
+```@autodocs
+Modules = [GridapEmbedded.Interfaces]
+Order   = [:type, :constant, :macro, :function]
+Pages   = [
+  "/CutFaceBoundaryTriangulations.jl", 
+]
+```
+
+## Autodiff
+
+```@autodocs
+Modules = [GridapEmbedded.LevelSetCutters]
+Order   = [:type, :constant, :macro, :function]
+Pages   = [
+  "/DifferentiableTriangulations.jl", 
+]
+```