Skip to content

Commit 58e2b57

Browse files
committed
kept improving the tutorials
1 parent 35ae6f2 commit 58e2b57

File tree

15 files changed

+1606
-1914
lines changed

15 files changed

+1606
-1914
lines changed

docs/sphinx/source/converter/main.rst

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2395,7 +2395,7 @@ kspace_modify slab 3.0
23952395
These lines are used to define the most basic parameters, including the
23962396
atom, bond, and angle styles, as well as interaction
23972397
potential. Here, *lj/cut/tip4p/long* imposes a Lennard-Jones potential with
2398-
a cut-off at :math:`12\,\text{`\text{\AA{}}:math:`}` and a long-range Coulomb potential.
2398+
a cut-off at :math:`12\,\text{\AA{}}` and a long-range Coulomb potential.
23992399
24002400
So far, the commands are relatively similar to those in the previous tutorial,
24012401
\hyperref[all-atom-label]{Polymer in water}, with two major differences: the use
@@ -2406,7 +2406,7 @@ except that they are specifically designed for the four-point water model. As a
24062406
LAMMPS automatically creates a four-point water molecule, assigning type O
24072407
atoms as oxygen and type H atoms as hydrogen. The fourth massless atom (M) of the
24082408
TIP4P water molecule does not have to be defined explicitly, and the value of
2409-
:math:`0.1546\,\text{`\text{\AA{}}:math:`}` corresponds to the O-M distance of the
2409+
:math:`0.1546\,\text{\AA{}}` corresponds to the O-M distance of the
24102410
TIP4P-2005 water model :cite:`abascal2005general`. All other atoms in the simulation
24112411
are treated as usual, with long-range Coulomb interactions. Another novelty, here, is
24122412
the use of *kspace\ modify slab 3.0* that is combined with the non-periodic
@@ -3622,7 +3622,7 @@ and angles of the water molecules are defined; however, these specifications are
36223622
not critical since TIP4P/2005 is a rigid water model.
36233623
36243624
The water molecule template called \href{\filepath tutorial6/H2O.mol}{\dwlcmd{H2O.mol}}
3625-
must be downloaded and located next to *gcmc.lmp*
3625+
must be downloaded and located next to *gcmc.lmp*.
36263626
36273627
Before going further, we need to make a few changes to our data file.
36283628
Currently, the *cracking.data* file includes only two atom types, but we require four.
@@ -3779,10 +3779,10 @@ freedom. Here, 100 insertion and deletion attemps are made every 100 steps.
37793779
37803780
.. admonition:: Note
37813781
:class: non-title-info
3782-
At a pressure of :math:`p = 100\ \text{bar}`, the chemical potential of water vapor at :math:`T = 300\ \text{K}`
3782+
At a pressure of :math:`p = 100\,\text{bar}`, the chemical potential of water vapor at :math:`T = 300\,\text{K}`
37833783
can be calculated using as :math:`\mu = \mu_0 + RT \ln (\frac{p}{p_0}),` where :math:`\mu_0` is the standard
3784-
chemical potential (typically taken at a pressure :math:`p_0 = 1 \, \text{bar}`), \(R = 8.314\ \text{J/mol·K}\)
3785-
is the gas constant, \(T = 300\ \text{K}\) is the temperature.
3784+
chemical potential (typically taken at a pressure :math:`p_0 = 1 \, \text{bar}`), :math:`R = 8.314\, \text{J/mol·K}`
3785+
is the gas constant, :math:`T = 300\,\text{K}` is the temperature.
37863786
37873787
37883788
@@ -4484,7 +4484,7 @@ read_data mixing.data &
44844484
extra/special/per/atom 25
44854485
44864486
4487-
Here, the *read:math:`\ `data* command is used to import the
4487+
Here, the *read\ data* command is used to import the
44884488
previously generated *mixing.data* file. All other commands
44894489
have been introduced in earlier parts of the tutorial.
44904490

docs/sphinx/source/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ lammpstutorials by Simon Gravelle : LAMMPS courses for beginners
2020
tutorial5/reactive-silicon-dioxide.rst
2121
tutorial6/water-adsorption-in-silica.rst
2222
tutorial7/free-energy-calculation.rst
23+
tutorial8/reactive-molecular-dynamics.rst
2324

2425
.. toctree::
2526
:maxdepth: 2

docs/sphinx/source/journal-article.bib

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,17 @@ @article{ewald1921berechnung
1616
publisher={Wiley Online Library}
1717
}
1818

19+
@article{mills1955remeasurement,
20+
title={A remeasurement of the self-diffusion coefficients of sodium ion in aqueous sodium chloride solutions},
21+
author={Mills, Reginald},
22+
journal={Journal of the American Chemical Society},
23+
volume={77},
24+
number={23},
25+
pages={6116--6119},
26+
year={1955},
27+
publisher={ACS Publications}
28+
}
29+
1930
@misc{lammps_docs,
2031
title = {{LAMMPS} Online Documentation for latest stable version},
2132
howpublished = {\url{https://docs.lammps.org/stable}},

docs/sphinx/source/tutorial3/tutorial.rst

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -438,7 +438,6 @@ printed in the *pull.dat* file, you can create a histogram
438438
of dihedral angles for a specific type. For example, the angle :math:`\phi` for dihedrals
439439
of type 1 (C-C-OE-C) is shown in Fig.~\ref{fig:PEG-distance}\,b.
440440

441-
442441
Tip: using external visualization tools
443442
---------------------------------------
444443

docs/sphinx/source/tutorial4/introduction.rst

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,18 @@
1010
:class: only-light
1111
:align: right
1212

13-
The objective of this tutorial is to simulate an electrolyte nanoconfined
14-
and sheared by two walls. The density and velocity profiles of the fluid in
15-
the direction normal to the walls are extracted to highlight the effect of
16-
confining a fluid on its local properties.
13+
The objective of this tutorial is to simulate an electrolyte
14+
nanoconfined and sheared between two walls. The density
15+
and velocity profiles of the fluid in the direction normal to the walls are
16+
extracted to highlight the effect of confining a fluid on its local properties.
17+
This tutorial demonstrates key concepts of combining a fluid and a solid in
18+
the same simulation. A major difference from the previous tutorial,
19+
:ref:`all-atom-label`, is that here a rigid four-point
20+
water model named TIP4P/2005 is used :cite:`abascal2005general`.
21+
22+
.. admonition:: Note
23+
:class: non-title-info
24+
25+
Four-point water models such as TIP4P/2005 are widely used as they offer a
26+
good compromise between accuracy and computational cost :cite:`kadaoluwa2021systematic`.
1727

18-
This tutorial illustrates some key aspects of
19-
combining a fluid and a solid in the same simulation.
20-
A major difference from :ref:`all-atoms-label` is that
21-
here a rigid four-points water model named TIP4P is used :cite:`abascal2005general`.
22-
TIP4P is one of the most common water models due to its high accuracy.

0 commit comments

Comments
 (0)