diff --git a/doc/src/Build_development.rst b/doc/src/Build_development.rst index 191adea3af..832d750d13 100644 --- a/doc/src/Build_development.rst +++ b/doc/src/Build_development.rst @@ -515,7 +515,7 @@ The images below illustrate how the data is presented. .. only:: not latex .. list-table:: - + * - .. figure:: JPG/coverage-overview-top.png :scale: 25% diff --git a/doc/src/Howto_elastic.rst b/doc/src/Howto_elastic.rst index 9a10e2e7d1..4335309a31 100644 --- a/doc/src/Howto_elastic.rst +++ b/doc/src/Howto_elastic.rst @@ -4,7 +4,7 @@ Calculate elastic constants Elastic constants characterize the stiffness of a material. The formal definition is provided by the linear relation that holds between the stress and strain tensors in the limit of infinitesimal deformation. -In tensor notation, this is expressed as +In tensor notation, this is expressed as .. math:: diff --git a/doc/src/Intro_nonfeatures.rst b/doc/src/Intro_nonfeatures.rst index ea12e8c0b5..27888fe2c8 100644 --- a/doc/src/Intro_nonfeatures.rst +++ b/doc/src/Intro_nonfeatures.rst @@ -25,9 +25,13 @@ Here are suggestions on how to perform these tasks: wraps the library interface is provided. Thus, GUI interfaces can be written in Python or C/C++ that run LAMMPS and visualize or plot its output. Examples of this are provided in the python directory and - described on the :doc:`Python ` doc page. As of version - 2 August 2023 :ref:`a GUI tool ` is included in LAMMPS. - Also, there are several external wrappers or GUI front ends. + described on the :doc:`Python ` doc page. + + Since version 2 August 2023 :ref:`a LAMMPS-GUI tool ` is + included in LAMMPS. Also, there are several external wrappers or GUI + front ends that are mentioned on the `Pre-/post-processing tools page + `_ of the LAMMPS homepage. + * **Builder:** Several pre-processing tools are packaged with LAMMPS. Some of them convert input files in formats produced by other MD codes such as CHARMM, AMBER, or Insight into LAMMPS input formats. Some of @@ -35,12 +39,13 @@ Here are suggestions on how to perform these tasks: such as linear bead-spring polymer chains. The moltemplate program is a true molecular builder that will generate complex molecular models. See the :doc:`Tools ` page for details on tools packaged with - LAMMPS. The `Pre-/post-processing page + LAMMPS. The `Pre-/post-processing tools page `_ of the LAMMPS homepage describes a variety of third party tools for this task. Furthermore, some internal LAMMPS commands allow reconstructing, or selectively adding topology information, as well as provide the option to insert molecule templates instead of atoms for building bulk molecular systems. + * **Force-field assignment:** The conversion tools described in the previous bullet for CHARMM, AMBER, and Insight will also assign force field coefficients in the LAMMPS format, assuming you provide CHARMM, AMBER, @@ -49,6 +54,7 @@ Here are suggestions on how to perform these tasks: `InterMol `_ are particularly powerful and flexible in converting force field and topology data between various MD simulation programs. + * **Simulation analysis:** If you want to perform analysis on-the-fly as your simulation runs, see the :doc:`compute ` and :doc:`fix ` doc pages, which list commands that can be used in a LAMMPS @@ -66,19 +72,38 @@ Here are suggestions on how to perform these tasks: extract and massage data in dump files to make it easier to import into other programs. See the :doc:`Tools ` page for details on these various options. + + The `Pre-/post-processing page `_ + on the LAMMPS homepage lists some external packages for analysis of MD + simulation data, including data produced by LAMMPS. + * **Visualization:** LAMMPS can produce NETPBM, JPG, or PNG format snapshot images on-the-fly via its :doc:`dump image ` - command and pass them to an external program, `FFmpeg `_, - to generate movies from them. For high-quality, interactive visualization, - there are many excellent and free tools available. See the `Visualization Tools + command and pass them to an external program, `FFmpeg + `_, to generate movies from them. The + :ref:`LAMMPS-GUI tool ` has an *Snapshot Image Viewer* + which uses :doc:`dump image ` and alows to modify the + visualization settings interactively. It also has a *Slide Show* + feature where images created by :doc:`dump image ` are + collected during a simulation and can be animated interactively or + exported to a movie with FFmpeg. + + For high-quality, interactive visualization, there are many excellent + and free tools available. See the `Visualization Tools `_ page of the LAMMPS website for visualization packages that can process LAMMPS output data. + * **Plotting:** See the next bullet about Pizza.py as well as the :doc:`Python ` page for examples of plotting LAMMPS output. Scripts provided with the *python* tool in the ``tools`` directory will extract and process data in log and dump files to make it easier to analyze and plot. See the :doc:`Tools ` doc page for more discussion of the various tools. + + The :ref:`LAMMPS-GUI tool ` has an *Chart Viewer* where + :doc:`thermodynamic data ` computed by LAMMPS is + collected during the simulation and plotted immediately. + * **Pizza.py:** Our group has also written a separate toolkit called `Pizza.py `_ which can do certain kinds of setup, analysis, plotting, and visualization (via OpenGL) for LAMMPS