Dev Updates

.github/workflows/create-tag.yml

@@ -0,0 +1,44 @@
+name: Create Git Tag
+
+on:
+  workflow_dispatch:
+    inputs:
+      tag_name:
+        description: "Tag name (eg. v1.3.0)"
+        required: true
+        type: string
+
+permissions:
+  contents: write
+
+jobs:
+  create_tag:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Configure git with PAT
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git remote set-url origin "https://x-access-token:${{ secrets.PAT_PINA_PUSH }}@github.com/${{ github.repository }}.git"
+
+      - name: Check if the tag is already existing
+        run: |
+          TAG="${{ inputs.tag_name }}"
+          git fetch --tags
+          if git rev-parse -q --verify "refs/tags/$TAG" >/dev/null; then
+            echo "❌ Tag $TAG already exists"
+            exit 1
+          fi
+
+      - name: Create and push the tag
+        run: |
+          TAG="${{ inputs.tag_name }}"
+          git tag "$TAG"
+          git push origin "$TAG"

docs/source/_rst/_code.rst

@@ -215,6 +215,7 @@ Problems Zoo
 .. toctree::
     :titlesonly:
 
+    AcousticWaveProblem <problem/zoo/acoustic_wave.rst>
     AdvectionProblem <problem/zoo/advection.rst>
     AllenCahnProblem <problem/zoo/allen_cahn.rst>
     DiffusionReactionProblem <problem/zoo/diffusion_reaction.rst>
@@ -230,10 +231,11 @@ Geometrical Domains
 .. toctree::
     :titlesonly:
 
-    Domain <domain/domain.rst>
-    CartesianDomain <domain/cartesian.rst>
-    EllipsoidDomain <domain/ellipsoid.rst>
-    SimplexDomain <domain/simplex.rst>
+    DomainInterface <domain/domain_interface.rst>
+    BaseDomain <domain/base_domain.rst>
+    CartesianDomain <domain/cartesian_domain.rst>
+    EllipsoidDomain <domain/ellipsoid_domain.rst>
+    SimplexDomain <domain/simplex_domain.rst>
 
 Domain Operations
 ------------------
@@ -242,22 +244,25 @@ Domain Operations
     :titlesonly:
 
     OperationInterface <domain/operation_interface.rst>
-    Union <domain/union_domain.rst>
-    Intersection <domain/intersection_domain.rst>
-    Difference <domain/difference_domain.rst>
-    Exclusion <domain/exclusion_domain.rst>
+    BaseOperation <domain/base_operation.rst>
+    Union <domain/union.rst>
+    Intersection <domain/intersection.rst>
+    Difference <domain/difference.rst>
+    Exclusion <domain/exclusion.rst>
 
 Callbacks
 -----------
 
 .. toctree::
     :titlesonly:
 
-    Processing callback <callback/processing_callback.rst>
-    Optimizer callback <callback/optimizer_callback.rst>
-    R3 Refinment callback <callback/refinement/r3_refinement.rst>
-    Refinment Interface callback <callback/refinement/refinement_interface.rst>
-    Normalizer callback <callback/normalizer_data_callback.rst>
+    Switch Optimizer <callback/optim/switch_optimizer.rst>
+    Switch Scheduler <callback/optim/switch_scheduler.rst>
+    Normalizer Data <callback/processing/normalizer_data_callback.rst>
+    PINA Progress Bar <callback/processing/pina_progress_bar.rst>
+    Metric Tracker <callback/processing/metric_tracker.rst>
+    Refinement Interface <callback/refinement/refinement_interface.rst>
+    R3 Refinement <callback/refinement/r3_refinement.rst>
 
 Losses and Weightings
 ---------------------

docs/source/_rst/callback/optimizer_callback.rst → docs/source/_rst/callback/optim/switch_optimizer.rst

@@ -1,7 +1,7 @@
-Optimizer callbacks
+Switch Optimizer
 =====================
 
-.. currentmodule:: pina.callback.optimizer_callback
+.. currentmodule:: pina.callback.optim.switch_optimizer
 .. autoclass:: SwitchOptimizer
    :members:
    :show-inheritance:

docs/source/_rst/callback/optim/switch_scheduler.rst

@@ -0,0 +1,7 @@
+Switch Scheduler
+=====================
+
+.. currentmodule:: pina.callback.optim.switch_scheduler
+.. autoclass:: SwitchScheduler
+   :members:
+   :show-inheritance:

docs/source/_rst/callback/processing/metric_tracker.rst

@@ -0,0 +1,7 @@
+Metric Tracker
+==================
+.. currentmodule:: pina.callback.processing.metric_tracker
+
+.. autoclass:: MetricTracker
+   :members:
+   :show-inheritance:

docs/source/_rst/callback/normalizer_data_callback.rst → docs/source/_rst/callback/processing/normalizer_data_callback.rst

@@ -1,7 +1,7 @@
-Normalizer callbacks
+Normalizer Data
 =======================
 
-.. currentmodule:: pina.callback.normalizer_data_callback
+.. currentmodule:: pina.callback.processing.normalizer_data_callback
 .. autoclass:: NormalizerDataCallback
    :members:
    :show-inheritance:

docs/source/_rst/callback/processing/pina_progress_bar.rst

@@ -0,0 +1,7 @@
+PINA Progress Bar
+==================
+.. currentmodule:: pina.callback.processing.pina_progress_bar
+
+.. autoclass:: PINAProgressBar
+   :members:
+   :show-inheritance:

docs/source/_rst/domain/base_domain.rst

@@ -0,0 +1,9 @@
+BaseDomain
+===========
+.. currentmodule:: pina.domain.base_domain
+
+.. automodule:: pina.domain.base_domain
+
+.. autoclass:: BaseDomain
+    :members:
+    :show-inheritance:

docs/source/_rst/domain/base_operation.rst

@@ -0,0 +1,9 @@
+BaseOperation
+==============
+.. currentmodule:: pina.domain.base_operation
+
+.. automodule:: pina.domain.base_operation
+
+.. autoclass:: BaseOperation
+    :members:
+    :show-inheritance:

docs/source/_rst/domain/cartesian.rst → docs/source/_rst/domain/cartesian_domain.rst

@@ -1,8 +1,8 @@
 CartesianDomain
 ======================
-.. currentmodule:: pina.domain.cartesian
+.. currentmodule:: pina.domain.cartesian_domain
 
-.. automodule:: pina.domain.cartesian
+.. automodule:: pina.domain.cartesian_domain
 
 .. autoclass:: CartesianDomain
     :members:

docs/source/_rst/domain/difference_domain.rst → docs/source/_rst/domain/difference.rst

@@ -1,8 +1,8 @@
 Difference
 ======================
-.. currentmodule:: pina.domain.difference_domain
+.. currentmodule:: pina.domain.difference
 
-.. automodule:: pina.domain.difference_domain
+.. automodule:: pina.domain.difference
 
 .. autoclass:: Difference
     :members:

docs/source/_rst/domain/domain.rst → docs/source/_rst/domain/domain_interface.rst

@@ -1,5 +1,5 @@
-Domain
-===========
+DomainInterface
+================
 .. currentmodule:: pina.domain.domain_interface
 
 .. automodule:: pina.domain.domain_interface

docs/source/_rst/domain/ellipsoid.rst → docs/source/_rst/domain/ellipsoid_domain.rst

@@ -1,8 +1,8 @@
 EllipsoidDomain
 ======================
-.. currentmodule:: pina.domain.ellipsoid
+.. currentmodule:: pina.domain.ellipsoid_domain
 
-.. automodule:: pina.domain.ellipsoid
+.. automodule:: pina.domain.ellipsoid_domain
 
 .. autoclass:: EllipsoidDomain
     :members:

docs/source/_rst/domain/exclusion_domain.rst → docs/source/_rst/domain/exclusion.rst

@@ -1,8 +1,8 @@
 Exclusion
 ======================
-.. currentmodule:: pina.domain.exclusion_domain
+.. currentmodule:: pina.domain.exclusion
 
-.. automodule:: pina.domain.exclusion_domain
+.. automodule:: pina.domain.exclusion
 
 .. autoclass:: Exclusion
     :members:

docs/source/_rst/domain/intersection_domain.rst → docs/source/_rst/domain/intersection.rst

@@ -1,8 +1,8 @@
 Intersection
 ======================
-.. currentmodule:: pina.domain.intersection_domain
+.. currentmodule:: pina.domain.intersection
 
-.. automodule:: pina.domain.intersection_domain
+.. automodule:: pina.domain.intersection
 
 .. autoclass:: Intersection
     :members:

docs/source/_rst/domain/simplex.rst → docs/source/_rst/domain/simplex_domain.rst

@@ -1,8 +1,8 @@
 SimplexDomain
 ======================
-.. currentmodule:: pina.domain.simplex
+.. currentmodule:: pina.domain.simplex_domain
 
-.. automodule:: pina.domain.simplex
+.. automodule:: pina.domain.simplex_domain
 
 .. autoclass:: SimplexDomain
     :members:

docs/source/_rst/domain/union_domain.rst → docs/source/_rst/domain/union.rst

@@ -1,8 +1,8 @@
 Union
 ======================
-.. currentmodule:: pina.domain.union_domain
+.. currentmodule:: pina.domain.union
 
-.. automodule:: pina.domain.union_domain
+.. automodule:: pina.domain.union
 
 .. autoclass:: Union
     :members:

docs/source/_rst/problem/zoo/acoustic_wave.rst

@@ -0,0 +1,9 @@
+AcousticWaveProblem
+=====================
+.. currentmodule:: pina.problem.zoo.acoustic_wave
+
+.. automodule:: pina.problem.zoo.acoustic_wave
+
+.. autoclass:: AcousticWaveProblem
+    :members:
+    :show-inheritance:

docs/source/_tutorial.rst

@@ -33,6 +33,7 @@ Neural Operator Learning
 - `Introductory Tutorial: Neural Operator Learning with PINA <tutorial21/tutorial.html>`_
 - `Modeling 2D Darcy Flow with the Fourier Neural Operator <tutorial5/tutorial.html>`_
 - `Solving the Kuramoto-Sivashinsky Equation with Averaging Neural Operator <tutorial10/tutorial.html>`_
+- `Advection Equation with data driven DeepONet <tutorial24/tutorial.html>`_
 
 Supervised Learning
 -------------------
@@ -42,4 +43,4 @@ Supervised Learning
 - `Reduced Order Model with Graph Neural Networks for Unstructured Domains <tutorial22/tutorial.html>`_
 - `Data-driven System Identification with SINDy <tutorial23/tutorial.html>`_
 - `Unstructured Convolutional Autoencoders with Continuous Convolution <tutorial4/tutorial.html>`_
-- `Reduced Order Modeling with POD-RBF and POD-NN Approaches for Fluid Dynamics <tutorial8/tutorial.html>`_
+- `Reduced Order Modeling with POD-RBF and POD-NN Approaches for Fluid Dynamics <tutorial8/tutorial.html>`_