@@ -359,23 +359,23 @@ \subsection{Software/system requirements}
359359tutorials are provided in
360360\hyperref [using-lammps-gui-label]{Appendix~\ref {using-lammps-gui-label }}.
361361
362- LAMMPS versions are generally backward compatible, meaning that old
363- input files typically work with newer versions of LAMMPS. However,
364- forward compatibility is not as strong, so input files written for a
365- newer version may not always work with an older versions. As a result,
366- it is usually possible to follow this tutorial with more recent releases
367- of \lammpsgui {} and LAMMPS; older versions may require some (minor)
368- adjustments. These tutorials will be periodically updated to ensure
369- compatibility and take advantage of new features in the latest stable
362+ LAMMPS versions are generally backward compatible, meaning that older
363+ input files typically work the same with newer versions of LAMMPS.
364+ However, forward compatibility is not as strong, so input files written
365+ for a newer version may not always work with older versions. As a
366+ result, it is usually possible to follow this tutorial with more recent
367+ releases of \lammpsgui {} and LAMMPS; older versions may require some
368+ (minor) adjustments. These tutorials will be periodically updated to
369+ ensure compatibility and benefit from new features in the latest stable
370370version of LAMMPS.
371371
372372For some tutorials, external tools are required for plotting and
373373visualization, as the corresponding functionality in \lammpsgui {} is
374- limited. Suitable external tools for plotting include Python with
374+ limited. Suitable tools for plotting include Python with
375375Pandas/Matplotlib~\cite {van1995python ,hunter2007Matplotlib }, XmGrace,
376- Gnuplot, Microsoft Excel, and LibreOffice Calc. For visualization,
377- suitable external tools include VMD~\cite {vmd_home ,humphrey1996vmd }
378- and OVITO~\cite {ovito_home ,ovito_paper }.
376+ Gnuplot, Microsoft Excel, or LibreOffice Calc. For visualization,
377+ suitable tools include VMD~\cite {vmd_home ,humphrey1996vmd } and
378+ OVITO~\cite {ovito_home ,ovito_paper }.
379379
380380\subsection {About \lammpsgui {} }
381381
@@ -385,15 +385,15 @@ \subsection{About \lammpsgui{}}
385385editors, such as Notepad or Gedit, but offers the following enhancements
386386specifically for LAMMPS:
387387\begin {itemize }
388- \item Use of wizard dialogs to set up the tutorials
388+ \item Wizard dialogs to set up these tutorials
389389 \item Auto-completion of LAMMPS commands and options
390390 \item Context-sensitive online help
391391 \item Syntax highlighting for LAMMPS input files
392392 \item Syntax-aware line indentation
393393 \item Visualization using LAMMPS' built-in renderer
394394 \item Start and stop simulations via mouse or keyboard
395395 \item Monitoring of simulation progress
396- \item Dynamic capture of output in a text window
396+ \item Dynamic capture of LAMMPS output in a text window
397397 \item Automatic plotting of thermodynamic data during runs
398398 \item Capture of `` dump image'' outputs for animations
399399 \item Export of thermodynamic data for external plotting
@@ -425,34 +425,27 @@ \section{Content and links}
425425\subsection {Tutorial 1: Lennard-Jones fluid }
426426\label {lennard-jones-label }
427427
428- The objective of this tutorial is to perform a simple MD simulation
429- using LAMMPS. The system consists of a Lennard-Jones fluid composed of neutral
430- particles with two different effective diameters, contained within a
431- cubic box with periodic boundary conditions (Fig.~\ref {fig:LJ-avatar }). In
432- this tutorial, simple MD simulations in the microcanonical
433- (NVE) and canonical (NVT) ensembles are performed, and basic quantities are calculated,
434- including the potential and kinetic energies.
435-
436- \begin {figure }
437- \centering
438- \includegraphics [width=0.55\linewidth ]{LJ-avatar}
439- \caption {The binary mixture simulated in \hyperref [lennard-jones-label]{Tutorial 1},
440- with the atoms of type 1 represented as small green spheres and lge atoms of type 2
441- as large blue spheres.}
442- \label {fig:LJ-avatar }
443- \end {figure }
428+ The objective of this tutorial is to perform simple MD simulations
429+ using LAMMPS. The system consists of a Lennard-Jones fluid composed of
430+ neutral particles with two different effective diameters, contained
431+ within a cubic box with periodic boundary conditions
432+ (Fig.~\ref {fig:LJ-avatar }). In this tutorial, basic MD simulations in
433+ the microcanonical (NVE) and canonical (NVT) ensembles are performed,
434+ and basic quantities are calculated, including the potential and kinetic
435+ energies.
444436
445437\subsubsection {My first input }
446438
447- To run a simulation using LAMMPS, you need to write an input script containing
448- a series of commands for LAMMPS to execute. For clarity, the
449- input scripts for this tutorial will be divided into five categories,
450- which will be filled out step by step. To set up this tutorial, select
451- \guicmd {Start LAMMPS Tutorial 1} from the \guicmd {Tutorials} menu of \lammpsgui {}, and
452- follow the instructions. This will select (or create, if needed) a folder,
453- place the initial input file \flecmd {initial.lmp} in it, and
454- open the file in the \lammpsgui {} editor. The editor should display the
455- following content:
439+ To run a simulation using LAMMPS, you need to write an input script
440+ containing a series of commands for LAMMPS to execute, similar to Python
441+ or Bash scripts. For clarity, the input scripts for this tutorial will
442+ be divided into five categories, which will be filled out step by step.
443+ To set up this tutorial, select \guicmd {Start LAMMPS Tutorial 1} from
444+ the \guicmd {Tutorials} menu of \lammpsgui {}, and follow the
445+ instructions. This will select (or create, if needed) a folder, place
446+ the initial input file \flecmd {initial.lmp} in it, and open the file in
447+ the \lammpsgui {} \guicmd {Editor} window. It should display the following
448+ content:
456449\ begin{lstlisting}
457450# PART A - ENERGY MINIMIZATION
458451# 1) Initialization
@@ -492,53 +485,67 @@ \subsubsection{My first input}
492485atom_style atomic
493486boundary p p p
494487\end {lstlisting }
495- The first line, \lmpcmd {units lj}, specifies the use of
496- \emph {reduced } units, where all quantities are dimensionless. This unit system is
497- a popular choice for simulations that explore general statistical mechanical
498- principles, as it emphasizes relative differences between parameters rather than
499- representing any specific material. The second line, \lmpcmd {dimension 3}, specifies that the simulation is conducted
500- in 3D space, as opposed to 2D, where atoms are confined to move only in the
501- xy-plane. The third line, \lmpcmd {atom\_ style atomic}, designates
502- the atomic style for representing simple, individual particles.
503- In this style, each particle is treated as a point with a mass, making it the
504- most basic atom style. Other atom styles can incorporate additional attributes for atoms,
505- such as charges, bonds, or molecule IDs, depending on the requirements of the simulated model.
506- The last line, \lmpcmd {boundary p p p}, indicates that periodic boundary
507- conditions are applied along all three directions of space, where the three
508- p stand for $ x$ , $ y$ , and $ z$ , respectively. Alternatives are fixed non-periodic
509- (f), shrink-wrapped non-periodic (s), and shrink-wrapped non-periodic
510- with minimum (m). For non-periodic boundaries, different options
511- can be assigned to each dimension, making configurations like \lmpcmd {boundary p p fm}
512- valid for systems such as slab geometries.
513-
514- \begin {note }
515- Strictly speaking, none of the four commands specified in the
516- Initialization section are mandatory, as
517- they correspond to the default settings for their respective global properties.
518- However, explicitly specifying these defaults is considered good practice
519- to avoid confusion when sharing input files with other LAMMPS users.
520- \end {note }
521488
522489\begin {figure }
523490\centering
524491\includegraphics [width=\linewidth ]{GUI-1.png}
525492\caption {A screenshot of the \lammpsgui {} \guicmd {Editor} window during
526- \hyperref [lennard-jones-label]{Tutorial 1}. The coloring of the text
527- is based on the syntax for LAMMPS input files. The pop-up menu is the
493+ \hyperref [lennard-jones-label]{Tutorial 1}. The pop-up menu is the
528494 context menu for right-clicking on the \lmpcmd {units lj} command.}
529495\label {fig:GUI-1 }
530496\end {figure }
531497
498+ The first line, \lmpcmd {units lj}, specifies the use of \emph {reduced }
499+ units, where all quantities are dimensionless. This unit system is a
500+ popular choice for simulations that explore general statistical
501+ mechanical principles, as it emphasizes relative differences between
502+ parameters rather than representing any specific material. The second
503+ line, \lmpcmd {dimension 3}, specifies that the simulation is conducted
504+ in 3D space, as opposed to 2D, where atoms are confined to move only in
505+ the xy-plane. The third line, \lmpcmd {atom\_ style atomic}, designates
506+ the atomic style for representing simple, individual point particles.
507+ In this style, each particle is treated as a point with a mass, making
508+ it the most basic atom style. Other atom styles can incorporate
509+ additional attributes for atoms, such as charges, bonds, or molecule
510+ IDs, depending on the requirements of the simulated model. The last
511+ line, \lmpcmd {boundary p p p}, indicates that periodic boundary
512+ conditions are applied along all three directions of space, where the
513+ three p stand for $ x$ , $ y$ , and $ z$ , respectively. Alternatives are
514+ fixed non-periodic (f), shrink-wrapped non-periodic (s), and
515+ shrink-wrapped non-periodic with minimum (m). For non-periodic
516+ boundaries, different options can be assigned to each dimension, making
517+ configurations like \lmpcmd {boundary p p fm} valid for systems such as
518+ slab geometries.
519+
520+ \begin {note }
521+ Strictly speaking, none of the four commands specified in the
522+ Initialization section are mandatory, as they correspond to the
523+ default settings for their respective global properties. However,
524+ explicitly specifying these defaults is considered good practice to
525+ avoid confusion when sharing input files with other LAMMPS users.
526+ \end {note }
527+
532528Each LAMMPS command is accompanied by extensive online documentation
533- that details the different options for that command. From the \lammpsgui {}
534- editor buffer, you can access the documentation by
535- right-clicking on a line containing a command (e.g.,~\lmpcmd {units lj}) and
536- selecting \guicmd {View Documentation for `units'}. This action will
537- prompt your web browser to open the corresponding URL for the online manual.
538- A screenshot of this context menu is shown in Fig.~\ref {fig:GUI-1 }.
529+ that details the different options for that command. From the
530+ \lammpsgui {} editor buffer, you can access the documentation by
531+ right-clicking on a line containing a command (e.g.,~\lmpcmd {units lj})
532+ and selecting \guicmd {View Documentation for `units'}. This action
533+ should prompt your web browser to open the corresponding URL for the
534+ online manual. A screenshot of this context menu is shown in
535+ Fig.~\ref {fig:GUI-1 }.
539536
540537\paragraph {System definition }
541538
539+ \begin {figure }
540+ \centering
541+ \includegraphics [width=0.55\linewidth ]{LJ-avatar}
542+ \caption {The binary mixture simulated in
543+ \hyperref [lennard-jones-label]{Tutorial 1}, with the atoms of type 1
544+ represented as small green spheres and lge atoms of type 2 as large
545+ blue spheres.}
546+ \label {fig:LJ-avatar }
547+ \end {figure }
548+
542549The next step is to create the simulation box and populate it with atoms.
543550Modify the \lmpcmd {System definition} category of \flecmd {initial.lmp} as shown below:
544551\ begin{lstlisting}
@@ -548,11 +555,11 @@ \subsubsection{My first input}
548555create_atoms 1 random 1500 34134 simbox overlap 0.3
549556create_atoms 2 random 100 12756 simbox overlap 0.3
550557\end {lstlisting }
551- The first line, \lmpcmd {region simbox (...)}, defines a region
552- named \lmpcmd {simbox} that is a block (i.e.,~a rectangular
553- cuboid) extending from -20 to 20 units along all three spatial dimensions.
554- The second line, \lmpcmd {create\_ box 2 simbox}, initializes a simulation box
555- based on the region \lmpcmd {simbox} and reserves space for two types of atoms.
558+ The first line, \lmpcmd {region simbox (...)}, defines a region named
559+ \lmpcmd {simbox} that is a block (i.e.,~a rectangular cuboid) extending
560+ from -20 to 20 units along all three spatial dimensions. The second
561+ line, \lmpcmd {create\_ box 2 simbox}, initializes a simulation box based
562+ on the region \lmpcmd {simbox} and reserves space for two types of atoms.
556563
557564\begin {note }
558565From this point on, any command referencing an atom type larger than 2
0 commit comments