Skip to content

Livecoms reviewer comments #107

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

Merged
merged 18 commits into from
Aug 11, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion .dependencies/.github
2 changes: 1 addition & 1 deletion .dependencies/lammpstutorials-inputs
Submodule lammpstutorials-inputs updated 64 files
+1 −1 .dependencies/.github
+2 −0 README.md
+5 −4 tutorial1/improved.md.lmp
+5 −4 tutorial1/improved.min.lmp
+7 −7 tutorial1/initial.lmp
+4 −3 tutorial2/breakable-with-tip.lmp
+5 −0 tutorial2/breakable-yaml-reader.py
+4 −3 tutorial2/breakable.lmp
+4 −3 tutorial2/unbreakable-yaml-reader.py
+4 −3 tutorial2/unbreakable.inc
+4 −3 tutorial2/unbreakable.lmp
+4 −3 tutorial3/merge.lmp
+4 −3 tutorial3/parameters.inc
+4 −3 tutorial3/peg.mol
+4 −3 tutorial3/pull-with-tip.lmp
+72,920 −73,045 tutorial3/pull.dat
+6 −10 tutorial3/pull.lmp
+171 −178 tutorial3/pull.log
+5 −10 tutorial3/water.lmp
+64 −55 tutorial3/water.log
+4 −3 tutorial3/water.mol
+ tutorial3/water.restart
+4 −3 tutorial4/create.lmp
+4 −3 tutorial4/equilibrate.lmp
+4 −3 tutorial4/groups.inc
+4 −3 tutorial4/parameters.inc
+4 −3 tutorial4/shearing.lmp
+4 −3 tutorial4/water.mol
+4,004 −0 tutorial5/decorate-H.histo
+4,004 −0 tutorial5/decorate-O.histo
+4,004 −0 tutorial5/decorate-Si.histo
+6 −5 tutorial5/decorate.lmp
+1,070 −1,070 tutorial5/deform-O.histo
+1,670 −1,670 tutorial5/deform-Si.histo
+1,156 −1,156 tutorial5/deform.data
+6 −5 tutorial5/deform.lmp
+7,912 −0 tutorial5/deform.species
+250 −250 tutorial5/ffield.reax.CHOFe
+0 −1,001 tutorial5/relax-O.histo
+0 −1,001 tutorial5/relax-Si.histo
+1,156 −1,156 tutorial5/relax.data
+6 −5 tutorial5/relax.lmp
+2 −1,844 tutorial5/relax.species
+4 −3 tutorial6/H2O.mol
+1 −1 tutorial6/cracking-mod.data
+4 −3 tutorial6/cracking.lmp
+15 −16 tutorial6/gcmc.lmp
+143 −153 tutorial6/gcmc.log
+4 −3 tutorial6/generate.lmp
+50 −50 tutorial7/free-sampling.dat
+6 −5 tutorial7/free-sampling.lmp
+6 −5 tutorial7/umbrella-sampling.lmp
+4 −3 tutorial8/M-M.rxnmap
+4 −3 tutorial8/M-M_post.mol
+4 −3 tutorial8/M-M_pre.mol
+4 −3 tutorial8/M-P.rxnmap
+4 −3 tutorial8/M-P_post.mol
+4 −3 tutorial8/M-P_pre.mol
+4 −3 tutorial8/P-P.rxnmap
+4 −3 tutorial8/P-P_post.mol
+4 −3 tutorial8/P-P_pre.mol
+4 −3 tutorial8/mixing.lmp
+4 −3 tutorial8/polymerize.lmp
+4 −3 tutorial8/styrene.mol
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,8 @@ The other pages use the [Sphinx](https://www.sphinx-doc.org/) generator with the

- [Simon Gravelle](https://github.com/simongravelle) (corr. author),
Université Grenoble Alpes, CNRS, LIPhy, 38000 Grenoble, France.
- [Cecilia M. S. Alvares](https://github.com/cecimarques),
Department of Chemistry, University of Warwick, Coventry CV4 7AL, United Kingdom
- [Jacob R. Gissinger](https://www.stevens.edu/profile/jgissing),
Stevens Institute of Technology, Hoboken, NJ 07030, USA.
- [Axel Kohlmeyer](https://sites.google.com/site/akohlmey),
Expand Down
2 changes: 1 addition & 1 deletion docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@
<h1>LAMMPS tutorials</h1>
<h2>
by <a target="_blank" href="https://simongravelle.github.io/"">
Simon Gravelle</a>, Jacob R. Gissinger, and Axel Kohlmeyer
Simon Gravelle</a>, Cecilia M. S. Alvares, Jacob R. Gissinger, and Axel Kohlmeyer
</h2>
</center>
<br>
Expand Down
2 changes: 2 additions & 0 deletions docs/sphinx/requirements.txt
Original file line number Diff line number Diff line change
Expand Up @@ -4,3 +4,5 @@ sphinxcontrib.bibtex
sphinx-togglebutton
sphinx-favicon
pygments-lammps
furo

10 changes: 10 additions & 0 deletions docs/sphinx/source/journal-article.bib
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,16 @@ @article{schneider1978molecular
publisher={APS}
}

@article{grossfield2009quantifying,
title={Quantifying uncertainty and sampling quality in biomolecular simulations},
author={Grossfield, Alan and Zuckerman, Daniel M},
journal={Annual Reports in Computational Chemistry},
volume={5},
pages={23--48},
year={2009},
publisher={Elsevier}
}

@book{hestenes1952methods,
title={Methods of conjugate gradients for solving linear systems},
author={Hestenes, Magnus Rudolph and Stiefel, Eduard and others},
Expand Down
11 changes: 6 additions & 5 deletions docs/sphinx/source/non-tutorials/prerequisites.rst
Original file line number Diff line number Diff line change
Expand Up @@ -39,8 +39,8 @@ on statistical mechanics and molecular simulations.
Software/system requirements
============================

The LAMMPS stable release version 29Aug2024 (update2)
and the matching LAMMPS--GUI software version 1.6.12 are required to
The LAMMPS stable release version 22Jul2025
and the matching LAMMPS--GUI software version 1.7.0 are required to
follow the tutorials, as they include features that were first
introduced in these versions. For Linux (x86_64 CPU), macOS (BigSur or
later), and Windows (10 and 11) you can download a precompiled LAMMPS
Expand Down Expand Up @@ -87,18 +87,19 @@ About LAMMPS--GUI

LAMMPS--GUI is a graphical text editor, enhanced for editing LAMMPS
input files and linked to the LAMMPS library, allowing it to run LAMMPS
directly. The text editor functions similarly to other graphical
directly. The text editor is similar to other graphical
editors, such as Notepad or Gedit, but offers the following enhancements
specifically for LAMMPS:
specifically for running LAMMPS:

- Wizard dialogs to set up these tutorials
- Auto-completion of LAMMPS commands and options
- Context-sensitive online help
- Syntax highlighting for LAMMPS input files
- Syntax-aware line indentation
- Editor switches working directory to that of input file
- Visualization using LAMMPS' built-in renderer
- Start and stop simulations via mouse or keyboard
- Monitoring of simulation progress
- Monitoring of simulation progress and parallelization
- Dynamic capture of LAMMPS output in a text window
- Automatic plotting of thermodynamic data during runs
- Capture of ``dump image`` outputs for animations
Expand Down
9 changes: 7 additions & 2 deletions docs/sphinx/source/non-tutorials/scope.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,11 @@ Scope
*****

This set of tutorials consists of eight tutorials arranged in order of
increasing difficulty. The novelties associated with each tutorial are
increasing difficulty. Although each tutorial can be
read independently, information introduced in earlier tuto-
rials is generally not repeated in detail in later ones. For this
reason, we recommend that beginners follow the tutorials in
order. The novelties associated with each tutorial are
briefly described below.

In :ref:`lennard-jones-label`, the structure of LAMMPS
Expand Down Expand Up @@ -48,7 +52,8 @@ reactions by dynamically adjusting atomic interactions
method that allows the partial charges of atoms to adjust according to
their local environment.

In :ref:`gcmc-silica-label`, a Monte Carlo simulation in
In :ref:`gcmc-silica-label`, the adsorption of a fluid in silica pores is
modeled. To do so, a Monte Carlo simulation in
the grand canonical ensemble is implemented to demonstrate how LAMMPS
can be used to simulate an open system that exchanges particles with a
reservoir.
Expand Down
10 changes: 5 additions & 5 deletions docs/sphinx/source/non-tutorials/using-lammps-gui.rst
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ installer package.
Installing the Linux .tar.gz Package
------------------------------------

Download the archive (e.g., LAMMPS-Linux-x86_64-GUI-29Aug2024_update2.tar.gz)
Download the archive (e.g., LAMMPS-Linux-x86_64-GUI-22Jul2025.tar.gz)
and unpack it. This will create a folder named LAMMPS--GUI containing the
included commands, which can be launched directly using ``./lammps-gui`` or
``./lmp``, for example. Adding this folder to the PATH environment
Expand All @@ -41,12 +41,12 @@ Installing the Linux Flatpak Bundle

You have to have Flatpak support installed on Linux machine to be able
to use the Flatpak bundle. Download the bundle file
(e.g., LAMMPS-Linux-x86_64-GUI-29Aug2024_update2.flatpak) and then
(e.g., LAMMPS-Linux-x86_64-GUI-22Jul2025.flatpak) and then
install it using the following command:

.. code-block:: bash

flatpak install --user LAMMPS-Linux-x86_64-GUI-29Aug2024_update2.flatpak
flatpak install --user LAMMPS-Linux-x86_64-GUI-22Jul2025.flatpak

This will integrate LAMMPS--GUI into your desktop environment
(e.g., GNOME, KDE, XFCE) where it should appear in the ``Applications``
Expand All @@ -70,7 +70,7 @@ Installing the macOS Application Bundle
---------------------------------------

After downloading the macOS app bundle image file
(e.g., LAMMPS-macOS-multiarch-GUI-29Aug2024_update2.dmg), double-click
(e.g., LAMMPS-macOS-multiarch-GUI-22Jul2025.dmg), double-click
on it. In the dialog that opens drag the LAMMPS--GUI app bundle into
the Applications folder. To enable command-line access, follow the
instructions in the **README.txt** file. These macOS app-bundles contain
Expand All @@ -87,7 +87,7 @@ Installing the Windows package
------------------------------

Download the LAMMPS--GUI installer for Windows
(e.g., LAMMPS-Win10-64bit-GUI-29Aug2024_update2.exe). Windows may warn
(e.g., LAMMPS-Win10-64bit-GUI-22Jul2025.exe). Windows may warn
you that the file is from an unknown developer and was downloaded from
the internet. This happens because neither the installer nor the
LAMMPS--GUI application (or any other included applications) have been
Expand Down
2 changes: 1 addition & 1 deletion docs/sphinx/source/shared/versionLAMMPS.rst
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
.. container:: version

This tutorial is compatible with the 29Aug2024 (update 2) LAMMPS version.
This tutorial is compatible with the 22Jul2025 LAMMPS version.
Loading
Loading