Skip to content

Commit 972c788

Browse files
Alan KaptanogluAlan Kaptanoglu
authored andcommitted
First attempt at fixing the example notebook documentation on the readthedocs page.
1 parent d57737f commit 972c788

File tree

1 file changed

+12
-12
lines changed

1 file changed

+12
-12
lines changed

examples/README.rst

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,15 @@ PySINDy Examples
33

44
This directory showcases the following examples of PySINDy in action.
55

6-
`Feature overview <https://pysindy.readthedocs.io/en/latest/examples/1_feature_overview.html>`_
6+
`Feature overview <./1_feature_overview.ipynb>`_
77
-----------------------------------------------------------------------------------------------------------
88
This notebook gives an almost exhaustive overview of the different features available in PySINDy. It's a good reference for how to set various options and work with different types of datasets.
99

1010
`Introduction to SINDy <./2_introduction_to_sindy/example.ipynb>`_
1111
---------------------------------------------------------------------------------------------------------------------
1212
We recommend that people new to SINDy start here. We give a gentle introduction to the SINDy method and how different steps in the algorithm are represented in PySINDy. We also show how to use PySINDy to learn a model for a simple linear differential equation.
1313

14-
`Original paper <https://pysindy.readthedocs.io/en/latest/examples/3_original_paper.html>`_
14+
`Original paper <./3_original_paper.ipynb>`_
1515
-------------------------------------------------------------------------------------------------------
1616
This notebook uses PySINDy to reproduce the examples in the `original SINDy paper <https://www.pnas.org/content/pnas/113/15/3932.full.pdf>`_. Namely, it applies PySINDy to the following problems:
1717

@@ -23,7 +23,7 @@ This notebook uses PySINDy to reproduce the examples in the `original SINDy pape
2323
* Logistic map
2424
* Hopf system
2525

26-
`Scikit-learn compatibility <https://pysindy.readthedocs.io/en/latest/examples/4_scikit_learn_compatibility.html>`_
26+
`Scikit-learn compatibility <./4_scikit_learn_compatibility.ipynb>`_
2727
-------------------------------------------------------------------------------------------------------------------------------
2828
Shows how PySINDy interfaces with various Scikit-learn objects.
2929

@@ -34,40 +34,40 @@ Shows how PySINDy interfaces with various Scikit-learn objects.
3434
---------------------------------------------------------------------------------------------------------
3535
Explore the differentiation methods available in PySINDy on pure differentiation problems and as components in the SINDy algorithm.
3636

37-
`Deeptime compatibility <https://pysindy.readthedocs.io/en/latest/examples/6_deeptime_compatibility.html>`_
37+
`Deeptime compatibility <./6_deeptime_compatibility.ipynb>`_
3838
------------------------------------------------------------------------------------------------------------------------
3939
See a demonstration of PySINDy objects designed to conform to the `Deeptime <https://deeptime-ml.github.io/latest/index.html>`_ API.
4040

41-
`Plasma physics <https://pysindy.readthedocs.io/en/latest/examples/7_plasma_example.html>`_
41+
`Plasma physics <./7_plasma_example.ipynb>`_
4242
----------------------------------------------------------------------------------------------
4343
Use the ``ConstrainedSR3`` optimizer to build a constrained model for the temporal POD modes of a plasma simulation.
4444

4545

46-
`Trapping SINDy <https://pysindy.readthedocs.io/en/latest/examples/8_trapping_sindy_paper_examples.html>`_
46+
`Trapping SINDy <./8_trapping_sindy_paper_examples.ipynb>`_
4747
-----------------------------------------------------------------------------------------------------------
4848
This notebook applies the ``TrappingSR3`` optimizer to various canonical fluid systems., proposed in this paper: Kaptanoglu, Alan A., et al. "Promoting global stability in data-driven models of quadratic nonlinear dynamics." Physical Review Fluids 6.9 (2021): 094401. A preprint is found here `<https://arxiv.org/abs/2105.01843>`_.
4949

50-
`SINDyPI <https://pysindy.readthedocs.io/en/latest/examples/9_sindypi_with_sympy.html>`_
50+
`SINDyPI <./9_sindypi_with_sympy.ipynb>`_
5151
----------------------------------------------------------------------------------------------
5252
This notebook applies the ``SINDyPI`` optimizer to a simple implicit ODE and was originally proposed in this paper: Kaheman, Kadierdan, J. Nathan Kutz, and Steven L. Brunton. "SINDy-PI: a robust algorithm for parallel implicit sparse identification of nonlinear dynamics." Proceedings of the Royal Society A 476.2242 (2020): 20200279.
5353

54-
`PDEFIND <https://pysindy.readthedocs.io/en/latest/examples/10_PDEFIND_examples.html>`_
54+
`PDEFIND <./10_PDEFIND_examples.ipynb>`_
5555
----------------------------------------------------------------------------------------------
5656
This notebook applies the PDEFIND algorithm (SINDy for PDE identification) to a number of PDEs, and was originally proposed in this paper: Rudy, Samuel H., et al. "Data-driven discovery of partial differential equations." Science Advances 3.4 (2017): e1602614.
5757

58-
`Greedy Algorithms <https://pysindy.readthedocs.io/en/latest/examples/11_SSR_FROLS_examples.html>`_
58+
`Greedy Algorithms <./11_SSR_FROLS_examples.ipynb>`_
5959
-----------------------------------------------------------------------------------------------------
6060
This notebook uses the step-wise sparse regression (SSR) and forward-regression orthogonal least-squares (FROLS) algorithms, which are greedy algorithms that iteratively truncate (or add) one nonzero coefficient at each algorithm iteration.
6161

62-
`Weak formulation SINDy <https://pysindy.readthedocs.io/en/latest/examples/12_weakform_SINDy_examples.html>`_
62+
`Weak formulation SINDy <./12_weakform_SINDy_examples.ipynb>`_
6363
--------------------------------------------------------------------------------------------------------------
6464
This notebook uses SINDy to identify the weak-formulation of a system of ODEs or PDEs, adding significant robustness against noise in the data.
6565

66-
`Model ensembles <https://pysindy.readthedocs.io/en/latest/examples/13_ensembling.html>`_
66+
`Model ensembles <./13_ensembling.ipynb>`_
6767
----------------------------------------------------------------------------------------------
6868
This notebook uses sub-sampling of the data and sub-sampling of the SINDy library to generate many models, and the user can choose how to average or otherwise combine these models together. This tends to make SINDy more robust against noisy data.
6969

70-
`Cavity flow <https://pysindy.readthedocs.io/en/latest/examples/14_cavity_flow.html>`_
70+
`Cavity flow <./14_cavity_flow.ipynb>`_
7171
----------------------------------------------------------------------------------------------
7272
Demonstrates the use of SINDy to learn a model for the quasiperiodic dynamics in a shear-driven cavity at Re=7500, following Callaham, Brunton, and Loiseau (2021), preprint available here `<https://arxiv.org/pdf/2106.02409>`_.
7373

0 commit comments

Comments
 (0)