Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updates to the IPSuite Docs #272

Draft
wants to merge 42 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
42 commits
Select commit Hold shift + click to select a range
76a44c5
documentation outline
M-R-Schaefer May 22, 2023
5223e1c
updated poetry.lock
M-R-Schaefer May 22, 2023
9004ff6
added sphinx autodoc
M-R-Schaefer May 22, 2023
4d659f4
added redthedocs config
M-R-Schaefer May 22, 2023
4953f31
Added descriptions to models and bootstrap indices
M-R-Schaefer May 22, 2023
55353fe
added remaining module descriptions to docs
May 23, 2023
38a610d
Added furo theme and nbsphinx
May 23, 2023
38fdca4
added show inheritacne to autodoc
May 23, 2023
71402ea
added installation instructions
May 23, 2023
17ffc6a
moved module docstrings to __init__ files
May 23, 2023
ea600db
finished indes.rst example
May 23, 2023
63a03fe
example Notebook outlines
May 23, 2023
ba81173
data loading example outline
M-R-Schaefer May 25, 2023
96c4028
notebook cleanup
May 26, 2023
94fd15d
notebook cleanup 2
M-R-Schaefer May 29, 2023
df8d71c
example index fix
M-R-Schaefer May 29, 2023
46634b4
added bootstrapping example notebook
M-R-Schaefer May 30, 2023
8622edc
bootstrap example cleanup
M-R-Schaefer May 31, 2023
a0c5667
added data loading example notebook
M-R-Schaefer May 31, 2023
78a6e57
analyse ds sketch
M-R-Schaefer Jun 12, 2023
b5d62c3
Merge branch 'main' into docs
M-R-Schaefer Jul 27, 2023
ef45192
add basic nodes List to docs
MrJulEnergy Apr 18, 2024
7acaf02
fix some things with the nodes list
MrJulEnergy Apr 18, 2024
2811b4f
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Apr 18, 2024
3c437d8
idk
MrJulEnergy Apr 18, 2024
7aa3336
Add LAMMPS file docstring
MrJulEnergy Apr 18, 2024
5090e00
add Packmol docstring
MrJulEnergy Apr 18, 2024
4dbc490
Merge remote-tracking branch 'origin' into docs
MrJulEnergy Apr 18, 2024
845813f
add basic (actualy primitive) packmol docstring
MrJulEnergy Apr 18, 2024
4183163
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Apr 18, 2024
a542ca9
make water image in docs transparent (and fix minor error from previ…
MrJulEnergy Apr 18, 2024
c22b3e2
Merge branch 'docs' of https://github.com/zincware/IPSuite into docs
MrJulEnergy Apr 18, 2024
0bfc22e
fix packmol docstring
MrJulEnergy Apr 18, 2024
2443472
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Apr 18, 2024
1027867
Merge branch 'main' into docs
PythonFZ Jul 25, 2024
4c4ddf8
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Jul 25, 2024
9aa4369
Merge branch 'main' into docs
PythonFZ Aug 7, 2024
02bab3d
Merge branch 'docs' of https://github.com/zincware/IPSuite into docs
M-R-Schaefer Sep 5, 2024
a4e281c
fixed pyproject
M-R-Schaefer Sep 5, 2024
64755f8
Merge branch 'main' into docs
M-R-Schaefer Sep 5, 2024
789d7fd
rebuild poetry lock
M-R-Schaefer Sep 5, 2024
04cbc7c
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Sep 5, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions docs/source/_examples/01_Data_Loading_and_Selection.nblink
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
"path": "../../../examples/01_Data_Loading_and_Selection.ipynb"
}
3 changes: 3 additions & 0 deletions docs/source/_examples/02_Training_Models.nblink
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
"path": "../../../examples/02_Training_Models.ipynb"
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
"path": "../../../examples/03_Analysing_Datasets_and_Model_Predictions.ipynb"
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
"path": "../../../examples/04_Molecular_Dynamics_Structure_Generation_and_Simulation.ipynb"
}
3 changes: 3 additions & 0 deletions docs/source/_examples/05_Labeling_with_Calculators.nblink
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
"path": "../../../examples/05_Labeling_with_Calculators.ipynb"
}
3 changes: 3 additions & 0 deletions docs/source/_examples/06_Bootstrapping_Datasets.nblink
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
"path": "../../../examples/06_Bootstrapping_Datasets.ipynb"
}
30 changes: 30 additions & 0 deletions docs/source/_examples/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@


.. _userdoc-examples:

IPS is based on `ZnTrack <https://github.com/zincware/ZnTrack/>`_, and we suggest working through the examples on the ZnTrack docs to understand how to construct version controlled workflows.
The notebooks contained in this section cover the functionality of IPS and assume familiarity with the basics of running workflows and experiments.

The utility of IPS is best demonstrated by some worked examples.
This section starts out with some introductory notebooks demonstrating the capabilities of the Nodes from each submodule.
Later notebooks feature some more complex workflows which are closer to real world use case.
All notebooks can be found in `/examples/docs`.


.. image:: https://mybinder.org/badge_logo.svg
:alt: Binder
:target: https://mybinder.org/v2/gh/zincware/IPSuite/HEAD


Examples
========

.. toctree::
:maxdepth: 0

01_Data_Loading_and_Selection
02_Training_Models
03_Analysing_Datasets_and_Model_Predictions
04_Molecular_Dynamics_Structure_Generation_and_Simulation
05_Labeling_with_Calculators
06_Bootstrapping_Datasets
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
ipsuite.analysis.bin\_property
==============================

.. automodule:: ipsuite.analysis.bin_property











.. rubric:: Classes

.. autosummary::

DipoleHistogram
EnergyHistogram
EnergyUncertaintyHistogram
ForcesHistogram
ForcesUncertaintyHistogram
LabelHistogram
StressHistogram
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
ipsuite.analysis.bond\_stretch
==============================

.. automodule:: ipsuite.analysis.bond_stretch











.. rubric:: Classes

.. autosummary::

BondStretchAnalyses
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
ipsuite.analysis.ensemble
=========================

.. automodule:: ipsuite.analysis.ensemble







.. rubric:: Functions

.. autosummary::

plot_with_uncertainty





.. rubric:: Classes

.. autosummary::

ModelEnsembleAnalysis
20 changes: 20 additions & 0 deletions docs/source/_get_started/_autosummary/ipsuite.analysis.md.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
ipsuite.analysis.md
===================

.. automodule:: ipsuite.analysis.md











.. rubric:: Classes

.. autosummary::

AnalyseDensity
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
ipsuite.analysis.model.dynamics
===============================

.. automodule:: ipsuite.analysis.model.dynamics







.. rubric:: Functions

.. autosummary::

run_stability_nve





.. rubric:: Classes

.. autosummary::

BoxHeatUp
BoxScale
MDStability
RattleAnalysis
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
ipsuite.analysis.model.dynamics\_checks
=======================================

.. automodule:: ipsuite.analysis.model.dynamics_checks











.. rubric:: Classes

.. autosummary::

ConnectivityCheck
EnergySpikeCheck
NaNCheck
TemperatureCheck
ThresholdCheck
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
ipsuite.analysis.model.math
===========================

.. automodule:: ipsuite.analysis.model.math







.. rubric:: Functions

.. autosummary::

compute_intertia_tensor
compute_rot_forces
compute_trans_forces
decompose_stress_tensor
force_decomposition
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
ipsuite.analysis.model.plots
============================

.. automodule:: ipsuite.analysis.model.plots







.. rubric:: Functions

.. autosummary::

density_scatter
get_figure
get_hist
get_histogram_figure
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
ipsuite.analysis.model.predict
==============================

.. automodule:: ipsuite.analysis.model.predict











.. rubric:: Classes

.. autosummary::

ForceAngles
ForceDecomposition
Prediction
PredictionMetrics
34 changes: 34 additions & 0 deletions docs/source/_get_started/_autosummary/ipsuite.analysis.model.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
ipsuite.analysis.model
======================

.. automodule:: ipsuite.analysis.model



















.. rubric:: Modules

.. autosummary::
:toctree:
:recursive:

ipsuite.analysis.model.dynamics
ipsuite.analysis.model.dynamics_checks
ipsuite.analysis.model.math
ipsuite.analysis.model.plots
ipsuite.analysis.model.predict
35 changes: 35 additions & 0 deletions docs/source/_get_started/_autosummary/ipsuite.analysis.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
ipsuite.analysis
================

.. automodule:: ipsuite.analysis



















.. rubric:: Modules

.. autosummary::
:toctree:
:recursive:

ipsuite.analysis.bin_property
ipsuite.analysis.bond_stretch
ipsuite.analysis.ensemble
ipsuite.analysis.md
ipsuite.analysis.model
ipsuite.analysis.sensitivity
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
ipsuite.analysis.sensitivity
============================

.. automodule:: ipsuite.analysis.sensitivity







.. rubric:: Functions

.. autosummary::

nonuniform_imshow





.. rubric:: Classes

.. autosummary::

AnalyseGlobalForceSensitivity
AnalyseSingleForceSensitivity
IsConstraintMD
MoveSingleParticle
26 changes: 26 additions & 0 deletions docs/source/_get_started/_autosummary/ipsuite.base.base.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
ipsuite.base.base
=================

.. automodule:: ipsuite.base.base











.. rubric:: Classes

.. autosummary::

AnalyseAtoms
AnalyseProcessAtoms
CheckBase
IPSNode
Mapping
ProcessAtoms
ProcessSingleAtom
Loading
Loading