update rsts

This commit is contained in:
Dario Coscia
2025-03-13 15:43:22 +01:00
committed by Nicola Demo
parent b15e4c47c3
commit d411543b76
39 changed files with 195 additions and 205 deletions

View File

@@ -12,22 +12,39 @@ The high-level structure of the package is depicted in our API.
The pipeline to solve differential equations with PINA follows just five steps: The pipeline to solve differential equations with PINA follows just five steps:
1. Define the `Problem`_ the user aim to solve 1. Define the `Problem`_ the user aim to solve
2. Generate data using built in `Geometries`_, or load high level simulation results as :doc:`LabelTensor <label_tensor>` 2. Generate data using built in `Domains`_, or load high level simulation results as :doc:`LabelTensor <label_tensor>`
3. Choose or build one or more `Models`_ to solve the problem 3. Choose or build one or more `Models`_ to solve the problem
4. Choose a solver across PINA available `Solvers`_, or build one using the :doc:`SolverInterface <solvers/solver_interface>` 4. Choose a solver across PINA available `Solvers`_, or build one using the :doc:`SolverInterface <solvers/solver_interface>`
5. Train the model with the PINA :doc:`Trainer <solvers/solver_interface>`, enhance the train with `Callbacks`_ 5. Train the model with the PINA :doc:`Trainer <solvers/solver_interface>`, enhance the train with `Callback`_
PINA Features
-------------- Training and Datamodules
-------------------------
.. toctree::
:titlesonly:
Trainer <trainer.rst>
Data Types
------------
.. toctree:: .. toctree::
:titlesonly: :titlesonly:
LabelTensor <label_tensor.rst> LabelTensor <label_tensor.rst>
Condition <condition.rst>
Trainer <trainer.rst>
Plotter <plotter.rst>
Conditions
-------------
.. toctree::
:titlesonly:
ConditionInterface <condition/condition_interface.rst>
Condition <condition/condition.rst>
DataCondition <condition/data_condition.rst>
DomainEquationCondition <condition/domain_equation_condition.rst>
InputEquationCondition <condition/input_equation_condition.rst>
InputTargetCondition <condition/input_target_condition.rst>
Solvers Solvers
-------------- --------------
@@ -91,19 +108,19 @@ Adaptive Activation Functions
.. toctree:: .. toctree::
:titlesonly: :titlesonly:
Adaptive Function Interface <adaptive_functions/AdaptiveFunctionInterface.rst> Adaptive Function Interface <adaptive_function/AdaptiveFunctionInterface.rst>
Adaptive ReLU <adaptive_functions/AdaptiveReLU.rst> Adaptive ReLU <adaptive_function/AdaptiveReLU.rst>
Adaptive Sigmoid <adaptive_functions/AdaptiveSigmoid.rst> Adaptive Sigmoid <adaptive_function/AdaptiveSigmoid.rst>
Adaptive Tanh <adaptive_functions/AdaptiveTanh.rst> Adaptive Tanh <adaptive_function/AdaptiveTanh.rst>
Adaptive SiLU <adaptive_functions/AdaptiveSiLU.rst> Adaptive SiLU <adaptive_function/AdaptiveSiLU.rst>
Adaptive Mish <adaptive_functions/AdaptiveMish.rst> Adaptive Mish <adaptive_function/AdaptiveMish.rst>
Adaptive ELU <adaptive_functions/AdaptiveELU.rst> Adaptive ELU <adaptive_function/AdaptiveELU.rst>
Adaptive CELU <adaptive_functions/AdaptiveCELU.rst> Adaptive CELU <adaptive_function/AdaptiveCELU.rst>
Adaptive GELU <adaptive_functions/AdaptiveGELU.rst> Adaptive GELU <adaptive_function/AdaptiveGELU.rst>
Adaptive Softmin <adaptive_functions/AdaptiveSoftmin.rst> Adaptive Softmin <adaptive_function/AdaptiveSoftmin.rst>
Adaptive Softmax <adaptive_functions/AdaptiveSoftmax.rst> Adaptive Softmax <adaptive_function/AdaptiveSoftmax.rst>
Adaptive SIREN <adaptive_functions/AdaptiveSIREN.rst> Adaptive SIREN <adaptive_function/AdaptiveSIREN.rst>
Adaptive Exp <adaptive_functions/AdaptiveExp.rst> Adaptive Exp <adaptive_function/AdaptiveExp.rst>
Equations and Operators Equations and Operators
@@ -127,38 +144,39 @@ Problem
TimeDependentProblem <problem/timedepproblem.rst> TimeDependentProblem <problem/timedepproblem.rst>
ParametricProblem <problem/parametricproblem.rst> ParametricProblem <problem/parametricproblem.rst>
Geometries Domains
----------------- -----------------
.. toctree:: .. toctree::
:titlesonly: :titlesonly:
Location <geometry/location.rst> Domain <domain/domain.rst>
CartesianDomain <geometry/cartesian.rst> CartesianDomain <domain/cartesian.rst>
EllipsoidDomain <geometry/ellipsoid.rst> EllipsoidDomain <domain/ellipsoid.rst>
SimplexDomain <geometry/simplex.rst> SimplexDomain <domain/simplex.rst>
Geometry set operations domain set operations
------------------------ ------------------------
.. toctree:: .. toctree::
:titlesonly: :titlesonly:
OperationInterface <geometry/operation_interface.rst> OperationInterface <domain/operation_interface.rst>
Union <geometry/union_domain.rst> Union <domain/union_domain.rst>
Intersection <geometry/intersection_domain.rst> Intersection <domain/intersection_domain.rst>
Difference <geometry/difference_domain.rst> Difference <domain/difference_domain.rst>
Exclusion <geometry/exclusion_domain.rst> Exclusion <domain/exclusion_domain.rst>
Callbacks Callback
-------------------- --------------------
.. toctree:: .. toctree::
:titlesonly: :titlesonly:
Processing Callbacks <callbacks/processing_callbacks.rst> Processing callback <callback/processing_callback.rst>
Optimizer Callbacks <callbacks/optimizer_callbacks.rst> Optimizer callback <callback/optimizer_callback.rst>
Adaptive Refinment Callback <callbacks/adaptive_refinment_callbacks.rst> Refinment callback <callback/adaptive_refinment_callback.rst>
Weighting callback <callback/linear_weight_update_callback.rst>
Metrics and Losses Metrics and Losses
-------------------- --------------------

View File

@@ -1,9 +0,0 @@
AdaptiveCELU
============
.. currentmodule:: pina.adaptive_functions.adaptive_func
.. autoclass:: AdaptiveCELU
:members:
:show-inheritance:
:inherited-members: AdaptiveActivationFunctionInterface

View File

@@ -1,9 +0,0 @@
AdaptiveELU
===========
.. currentmodule:: pina.adaptive_functions.adaptive_func
.. autoclass:: AdaptiveELU
:members:
:show-inheritance:
:inherited-members: AdaptiveActivationFunctionInterface

View File

@@ -1,9 +0,0 @@
AdaptiveExp
===========
.. currentmodule:: pina.adaptive_functions.adaptive_func
.. autoclass:: AdaptiveExp
:members:
:show-inheritance:
:inherited-members: AdaptiveActivationFunctionInterface

View File

@@ -1,8 +0,0 @@
AdaptiveActivationFunctionInterface
=======================================
.. currentmodule:: pina.adaptive_functions.adaptive_func_interface
.. automodule:: pina.adaptive_functions.adaptive_func_interface
:members:
:show-inheritance:

View File

@@ -1,9 +0,0 @@
AdaptiveGELU
============
.. currentmodule:: pina.adaptive_functions.adaptive_func
.. autoclass:: AdaptiveGELU
:members:
:show-inheritance:
:inherited-members: AdaptiveActivationFunctionInterface

View File

@@ -1,9 +0,0 @@
AdaptiveMish
============
.. currentmodule:: pina.adaptive_functions.adaptive_func
.. autoclass:: AdaptiveMish
:members:
:show-inheritance:
:inherited-members: AdaptiveActivationFunctionInterface

View File

@@ -1,9 +0,0 @@
AdaptiveReLU
============
.. currentmodule:: pina.adaptive_functions.adaptive_func
.. autoclass:: AdaptiveReLU
:members:
:show-inheritance:
:inherited-members: AdaptiveActivationFunctionInterface

View File

@@ -1,9 +0,0 @@
AdaptiveSIREN
=============
.. currentmodule:: pina.adaptive_functions.adaptive_func
.. autoclass:: AdaptiveSIREN
:members:
:show-inheritance:
:inherited-members: AdaptiveActivationFunctionInterface

View File

@@ -1,9 +0,0 @@
AdaptiveSiLU
============
.. currentmodule:: pina.adaptive_functions.adaptive_func
.. autoclass:: AdaptiveSiLU
:members:
:show-inheritance:
:inherited-members: AdaptiveActivationFunctionInterface

View File

@@ -1,9 +0,0 @@
AdaptiveSigmoid
===============
.. currentmodule:: pina.adaptive_functions.adaptive_func
.. autoclass:: AdaptiveSigmoid
:members:
:show-inheritance:
:inherited-members: AdaptiveActivationFunctionInterface

View File

@@ -1,9 +0,0 @@
AdaptiveSoftmax
===============
.. currentmodule:: pina.adaptive_functions.adaptive_func
.. autoclass:: AdaptiveSoftmax
:members:
:show-inheritance:
:inherited-members: AdaptiveActivationFunctionInterface

View File

@@ -1,9 +0,0 @@
AdaptiveSoftmin
===============
.. currentmodule:: pina.adaptive_functions.adaptive_func
.. autoclass:: AdaptiveSoftmin
:members:
:show-inheritance:
:inherited-members: AdaptiveActivationFunctionInterface

View File

@@ -1,9 +0,0 @@
AdaptiveTanh
============
.. currentmodule:: pina.adaptive_functions.adaptive_func
.. autoclass:: AdaptiveTanh
:members:
:show-inheritance:
:inherited-members: AdaptiveActivationFunctionInterface

View File

@@ -0,0 +1,7 @@
Refinments callbacks
=======================
.. currentmodule:: pina.callback.adaptive_refinement_callback
.. autoclass:: R3Refinement
:members:
:show-inheritance:

View File

@@ -0,0 +1,7 @@
Weighting callbacks
========================
.. currentmodule:: pina.callback.linear_weight_update_callback
.. autoclass:: LinearWeightUpdate
:members:
:show-inheritance:

View File

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

View File

@@ -1,7 +1,7 @@
Processing callbacks Processing callbacks
======================= =======================
.. currentmodule:: pina.callbacks.processing_callbacks .. currentmodule:: pina.callbacks.processing_callback
.. autoclass:: MetricTracker .. autoclass:: MetricTracker
:members: :members:
:show-inheritance: :show-inheritance:

View File

@@ -1,7 +0,0 @@
Adaptive Refinments callbacks
===============================
.. currentmodule:: pina.callbacks.adaptive_refinment_callbacks
.. autoclass:: R3Refinement
:members:
:show-inheritance:

View File

@@ -1,7 +0,0 @@
Condition
=========
.. currentmodule:: pina.condition
.. autoclass:: Condition
:members:
:show-inheritance:

View File

@@ -0,0 +1,7 @@
Conditions
=============
.. currentmodule:: pina.condition.condition
.. autoclass:: Condition
:members:
:show-inheritance:

View File

@@ -0,0 +1,7 @@
ConditionInterface
======================
.. currentmodule:: pina.condition.condition_interface
.. autoclass:: ConditionInterface
:members:
:show-inheritance:

View File

@@ -0,0 +1,15 @@
Data Conditions
==================
.. currentmodule:: pina.condition.data_condition
.. autoclass:: DataCondition
:members:
:show-inheritance:
.. autoclass:: GraphDataCondition
:members:
:show-inheritance:
.. autoclass:: TensorDataCondition
:members:
:show-inheritance:

View File

@@ -0,0 +1,7 @@
Domain Equation Condition
===========================
.. currentmodule:: pina.condition.domain_equation_condition
.. autoclass:: DomainEquationCondition
:members:
:show-inheritance:

View File

@@ -0,0 +1,15 @@
Input Equation Condition
===========================
.. currentmodule:: pina.condition.input_equation_condition
.. autoclass:: InputEquationCondition
:members:
:show-inheritance:
.. autoclass:: InputTensorEquationCondition
:members:
:show-inheritance:
.. autoclass:: InputGraphEquationCondition
:members:
:show-inheritance:

View File

@@ -0,0 +1,23 @@
Input Target Condition
===========================
.. currentmodule:: pina.condition.input_target_condition
.. autoclass:: InputTargetCondition
:members:
:show-inheritance:
.. autoclass:: TensorInputTensorTargetCondition
:members:
:show-inheritance:
.. autoclass:: TensorInputGraphTargetCondition
:members:
:show-inheritance:
.. autoclass:: GraphInputTensorTargetCondition
:members:
:show-inheritance:
.. autoclass:: GraphInputGraphTargetCondition
:members:
:show-inheritance:

View File

@@ -0,0 +1,7 @@
PinaDataModule
======================
.. currentmodule:: pina.data.data_module
.. autoclass:: PinaDataModule
:members:
:show-inheritance:

View File

@@ -0,0 +1,7 @@
PinaDataset
======================
.. currentmodule:: pina.data.dataset
.. autoclass:: PinaDataset
:members:
:show-inheritance:

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

@@ -1,8 +1,8 @@
OperationInterface OperationInterface
====================== ======================
.. currentmodule:: pina.geometry.operation_interface .. currentmodule:: pina.domain.operation_interface
.. automodule:: pina.geometry.operation_interface .. automodule:: pina.domain.operation_interface
.. autoclass:: OperationInterface .. autoclass:: OperationInterface
:members: :members:

View File

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

View File

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

View File

@@ -1,9 +0,0 @@
Location
====================
.. currentmodule:: pina.geometry.location
.. automodule:: pina.geometry.location
.. autoclass:: Location
:members:
:show-inheritance:

View File

@@ -9,10 +9,10 @@ Getting started with PINA
:maxdepth: 3 :maxdepth: 3
:titlesonly: :titlesonly:
Introduction to PINA for Physics Informed Neural Networks training <tutorials/tutorial1/tutorial.rst> `Introduction to PINA for Physics Informed Neural Networks training <tutorials/tutorial1/tutorial.html>`_
Introduction to PINA Equation class <tutorials/tutorial12/tutorial.rst> `Introduction to PINA Equation class <tutorials/tutorial12/tutorial.html>`_
PINA and PyTorch Lightning, training tips and visualizations <tutorials/tutorial11/tutorial.rst> `PINA and PyTorch Lightning, training tips and visualizations <tutorials/tutorial11/tutorial.html>`_
Building custom geometries with PINA Location class <tutorials/tutorial6/tutorial.rst> `Building custom geometries with PINA Location class <tutorials/tutorial6/tutorial.html>`_
Physics Informed Neural Networks Physics Informed Neural Networks
@@ -21,11 +21,11 @@ Physics Informed Neural Networks
:maxdepth: 3 :maxdepth: 3
:titlesonly: :titlesonly:
Two dimensional Poisson problem using Extra Features Learning<tutorials/tutorial2/tutorial.rst> `Two dimensional Poisson problem using Extra Features Learning <tutorials/tutorial2/tutorial.html>`_
Two dimensional Wave problem with hard constraint<tutorials/tutorial3/tutorial.rst> `Two dimensional Wave problem with hard constraint <tutorials/tutorial3/tutorial.html>`_
Resolution of a 2D Poisson inverse problem<tutorials/tutorial7/tutorial.rst> `Resolution of a 2D Poisson inverse problem <tutorials/tutorial7/tutorial.html>`_
Periodic Boundary Conditions for Helmotz Equation<tutorials/tutorial9/tutorial.rst> `Periodic Boundary Conditions for Helmotz Equation <tutorials/tutorial9/tutorial.html>`_
Multiscale PDE learning with Fourier Feature Network<tutorials/tutorial13/tutorial.rst> `Multiscale PDE learning with Fourier Feature Network <tutorials/tutorial13/tutorial.html>`_
Neural Operator Learning Neural Operator Learning
------------------------ ------------------------
@@ -33,8 +33,8 @@ Neural Operator Learning
:maxdepth: 3 :maxdepth: 3
:titlesonly: :titlesonly:
Two dimensional Darcy flow using the Fourier Neural Operator<tutorials/tutorial5/tutorial.rst> `Two dimensional Darcy flow using the Fourier Neural Operator <tutorials/tutorial5/tutorial.html>`_
Time dependent Kuramoto Sivashinsky equation using the Averaging Neural Operator<tutorials/tutorial10/tutorial.rst> `Time dependent Kuramoto Sivashinsky equation using the Averaging Neural Operator <tutorials/tutorial10/tutorial.html>`_
Supervised Learning Supervised Learning
------------------- -------------------
@@ -42,5 +42,5 @@ Supervised Learning
:maxdepth: 3 :maxdepth: 3
:titlesonly: :titlesonly:
Unstructured convolutional autoencoder via continuous convolution<tutorials/tutorial4/tutorial.rst> `Unstructured convolutional autoencoder via continuous convolution <tutorials/tutorial4/tutorial.html>`_
POD-RBF and POD-NN for reduced order modeling<tutorials/tutorial8/tutorial.rst> `POD-RBF and POD-NN for reduced order modeling <tutorials/tutorial8/tutorial.html>`_