Skip to content

Commit

Permalink
update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
hsulab committed Oct 16, 2022
1 parent 30d2960 commit 626b6aa
Show file tree
Hide file tree
Showing 11 changed files with 12 additions and 30 deletions.
Binary file modified docs/build/doctrees/environment.pickle
Binary file not shown.
Binary file modified docs/build/doctrees/start.doctree
Binary file not shown.
10 changes: 2 additions & 8 deletions docs/build/html/_sources/start.rst.txt
Original file line number Diff line number Diff line change
@@ -1,20 +1,17 @@
Getting Started
===============

Here, we would introduce several basic components of GDPy, namely **potential**,
**driver**, **worker**. **Worker** is the basic unit that performs any
computation, which contains a ``AbstractPotentialManager`` and a ``Scheduler``.

Units
-----

We use the following units through all input files:

Time ``fs``, Length ``AA``, Energy ``eV``, Force ``eV/AA``.

Potential
---------

We have supported several MLIP formulations based on an ``AbstractPotentialManager``
class to access **driver**, **expedition**, and **training** through workflows.

Expand All @@ -35,7 +32,6 @@ See :ref:`Potential Examples` section for more details.

Driver
------

After potential is defined, we need to further specify what simulation would be
perfomed in the **driver** section. A driver (``AbstractDriver``) is the basic
unit with an attacthed **ase** ``calculators`` for basic dynamics tasks, namely,
Expand All @@ -61,10 +57,9 @@ See :ref:`Driver Examples` section for more details.

Scheduler
---------

With **potential** and **driver** defined, we can run simulations on local
machines (directly in the command line). However, simulations, under most
circumstances, would be really heavy even by MLIPs (image a 10 ns molecular
circumstances, would be really heavy even by MLIPs (imagine a 10 ns molecular
dynamics). The simulations would ideally be dispatched to high performace clusters
(HPCs).

Expand All @@ -86,7 +81,6 @@ The example below shows how to define a **scheduler** in a **yaml** file:
Worker
------

**Worker** that combines the above components is what we use throughout various
workflows to deal with computations.

Expand Down Expand Up @@ -115,7 +109,7 @@ The example below shows how to define a **worker** in a **yaml** file:
time: "0:10:00"
environs: "source ~/envs/source_eann.sh\nconda activate catorch2\n"
to run a **nvt** simulation with given structures by **nequip** on a **slurm**
to run a **nvt** simulation with given structures by **deepmd** on a **slurm**
machine

.. code-block:: shell
Expand Down
2 changes: 1 addition & 1 deletion docs/build/html/searchindex.js

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/build/html/start.html
Original file line number Diff line number Diff line change
Expand Up @@ -224,7 +224,7 @@ <h2>Driver<a class="headerlink" href="#driver" title="Permalink to this heading"
<h2>Scheduler<a class="headerlink" href="#scheduler" title="Permalink to this heading"></a></h2>
<p>With <strong>potential</strong> and <strong>driver</strong> defined, we can run simulations on local
machines (directly in the command line). However, simulations, under most
circumstances, would be really heavy even by MLIPs (image a 10 ns molecular
circumstances, would be really heavy even by MLIPs (imagine a 10 ns molecular
dynamics). The simulations would ideally be dispatched to high performace clusters
(HPCs).</p>
<p>The example below shows how to define a <strong>scheduler</strong> in a <strong>yaml</strong> file:</p>
Expand Down Expand Up @@ -269,7 +269,7 @@ <h2>Worker<a class="headerlink" href="#worker" title="Permalink to this heading"
<span class="nt">environs</span><span class="p">:</span> <span class="s">&quot;source</span><span class="nv"> </span><span class="s">~/envs/source_eann.sh\nconda</span><span class="nv"> </span><span class="s">activate</span><span class="nv"> </span><span class="s">catorch2\n&quot;</span>
</pre></div>
</div>
<p>to run a <strong>nvt</strong> simulation with given structures by <strong>nequip</strong> on a <strong>slurm</strong>
<p>to run a <strong>nvt</strong> simulation with given structures by <strong>deepmd</strong> on a <strong>slurm</strong>
machine</p>
<div class="highlight-shell notranslate"><div class="highlight"><pre><span></span><span class="c1"># -- submit jobs...</span>
<span class="c1"># one structure for one job</span>
Expand Down
Binary file modified docs/source/_build/doctrees/environment.pickle
Binary file not shown.
Binary file modified docs/source/_build/doctrees/start.doctree
Binary file not shown.
10 changes: 2 additions & 8 deletions docs/source/_build/html/_sources/start.rst.txt
Original file line number Diff line number Diff line change
@@ -1,20 +1,17 @@
Getting Started
===============

Here, we would introduce several basic components of GDPy, namely **potential**,
**driver**, **worker**. **Worker** is the basic unit that performs any
computation, which contains a ``AbstractPotentialManager`` and a ``Scheduler``.

Units
-----

We use the following units through all input files:

Time ``fs``, Length ``AA``, Energy ``eV``, Force ``eV/AA``.

Potential
---------

We have supported several MLIP formulations based on an ``AbstractPotentialManager``
class to access **driver**, **expedition**, and **training** through workflows.

Expand All @@ -35,7 +32,6 @@ See :ref:`Potential Examples` section for more details.

Driver
------

After potential is defined, we need to further specify what simulation would be
perfomed in the **driver** section. A driver (``AbstractDriver``) is the basic
unit with an attacthed **ase** ``calculators`` for basic dynamics tasks, namely,
Expand All @@ -61,10 +57,9 @@ See :ref:`Driver Examples` section for more details.

Scheduler
---------

With **potential** and **driver** defined, we can run simulations on local
machines (directly in the command line). However, simulations, under most
circumstances, would be really heavy even by MLIPs (image a 10 ns molecular
circumstances, would be really heavy even by MLIPs (imagine a 10 ns molecular
dynamics). The simulations would ideally be dispatched to high performace clusters
(HPCs).

Expand All @@ -86,7 +81,6 @@ The example below shows how to define a **scheduler** in a **yaml** file:
Worker
------

**Worker** that combines the above components is what we use throughout various
workflows to deal with computations.

Expand Down Expand Up @@ -115,7 +109,7 @@ The example below shows how to define a **worker** in a **yaml** file:
time: "0:10:00"
environs: "source ~/envs/source_eann.sh\nconda activate catorch2\n"
to run a **nvt** simulation with given structures by **nequip** on a **slurm**
to run a **nvt** simulation with given structures by **deepmd** on a **slurm**
machine

.. code-block:: shell
Expand Down
2 changes: 1 addition & 1 deletion docs/source/_build/html/searchindex.js

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions docs/source/_build/html/start.html
Original file line number Diff line number Diff line change
Expand Up @@ -224,7 +224,7 @@ <h2>Driver<a class="headerlink" href="#driver" title="Permalink to this heading"
<h2>Scheduler<a class="headerlink" href="#scheduler" title="Permalink to this heading"></a></h2>
<p>With <strong>potential</strong> and <strong>driver</strong> defined, we can run simulations on local
machines (directly in the command line). However, simulations, under most
circumstances, would be really heavy even by MLIPs (image a 10 ns molecular
circumstances, would be really heavy even by MLIPs (imagine a 10 ns molecular
dynamics). The simulations would ideally be dispatched to high performace clusters
(HPCs).</p>
<p>The example below shows how to define a <strong>scheduler</strong> in a <strong>yaml</strong> file:</p>
Expand Down Expand Up @@ -269,7 +269,7 @@ <h2>Worker<a class="headerlink" href="#worker" title="Permalink to this heading"
<span class="nt">environs</span><span class="p">:</span> <span class="s">&quot;source</span><span class="nv"> </span><span class="s">~/envs/source_eann.sh\nconda</span><span class="nv"> </span><span class="s">activate</span><span class="nv"> </span><span class="s">catorch2\n&quot;</span>
</pre></div>
</div>
<p>to run a <strong>nvt</strong> simulation with given structures by <strong>nequip</strong> on a <strong>slurm</strong>
<p>to run a <strong>nvt</strong> simulation with given structures by <strong>deepmd</strong> on a <strong>slurm</strong>
machine</p>
<div class="highlight-shell notranslate"><div class="highlight"><pre><span></span><span class="c1"># -- submit jobs...</span>
<span class="c1"># one structure for one job</span>
Expand Down
10 changes: 2 additions & 8 deletions docs/source/start.rst
Original file line number Diff line number Diff line change
@@ -1,20 +1,17 @@
Getting Started
===============

Here, we would introduce several basic components of GDPy, namely **potential**,
**driver**, **worker**. **Worker** is the basic unit that performs any
computation, which contains a ``AbstractPotentialManager`` and a ``Scheduler``.

Units
-----

We use the following units through all input files:

Time ``fs``, Length ``AA``, Energy ``eV``, Force ``eV/AA``.

Potential
---------

We have supported several MLIP formulations based on an ``AbstractPotentialManager``
class to access **driver**, **expedition**, and **training** through workflows.

Expand All @@ -35,7 +32,6 @@ See :ref:`Potential Examples` section for more details.

Driver
------

After potential is defined, we need to further specify what simulation would be
perfomed in the **driver** section. A driver (``AbstractDriver``) is the basic
unit with an attacthed **ase** ``calculators`` for basic dynamics tasks, namely,
Expand All @@ -61,10 +57,9 @@ See :ref:`Driver Examples` section for more details.

Scheduler
---------

With **potential** and **driver** defined, we can run simulations on local
machines (directly in the command line). However, simulations, under most
circumstances, would be really heavy even by MLIPs (image a 10 ns molecular
circumstances, would be really heavy even by MLIPs (imagine a 10 ns molecular
dynamics). The simulations would ideally be dispatched to high performace clusters
(HPCs).

Expand All @@ -86,7 +81,6 @@ The example below shows how to define a **scheduler** in a **yaml** file:
Worker
------

**Worker** that combines the above components is what we use throughout various
workflows to deal with computations.

Expand Down Expand Up @@ -115,7 +109,7 @@ The example below shows how to define a **worker** in a **yaml** file:
time: "0:10:00"
environs: "source ~/envs/source_eann.sh\nconda activate catorch2\n"
to run a **nvt** simulation with given structures by **nequip** on a **slurm**
to run a **nvt** simulation with given structures by **deepmd** on a **slurm**
machine

.. code-block:: shell
Expand Down

0 comments on commit 626b6aa

Please sign in to comment.