lammps/doc/print.txt

78 lines
2.6 KiB
Plaintext

"LAMMPS WWW Site"_lws - "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c
:link(lws,http://lammps.sandia.gov)
:link(ld,Manual.html)
:link(lc,Section_commands.html#comm)
:line
print command :h3
[Syntax:]
print string keyword value :pre
string = text string to print, which may contain variables :ulb,l
zero or more keyword/value pairs may be appended :l
keyword = {file} or {append} or {screen} :l
{file} value = filename
{append} value = filename
{screen} value = {yes} or {no} :pre
:ule
[Examples:]
print "Done with equilibration" file info.dat
print Vol=$v append info.dat screen no
print "The system volume is now $v"
print 'The system volume is now $v'
print """
System volume = $v
System temperature = $t
""" :pre
[Description:]
Print a text string to the screen and logfile. The text string must
be a single argument, so if it is one line but more than one word, it
should be enclosed in single or double quotes. To generate multiple
lines of output, the string can be enclosed in triple quotes, as in
the last example above. If the text string contains variables, they
will be evaluated and their current values printed.
If the {file} or {append} keyword is used, a filename is specified to
which the output will be written. If {file} is used, then the
filename is overwritten if it already exists. If {append} is used,
then the filename is appended to if it already exists, or created if
it does not exist.
If the {screen} keyword is used, output to the screen and logfile can
be turned on or off as desired.
If you want the print command to be executed multiple times (with
changing variable values), there are 3 options. First, consider using
the "fix print"_fix_print.html command, which will print a string
periodically during a simulation. Second, the print command can be
used as an argument to the {every} option of the "run"_run.html
command. Third, the print command could appear in a section of the
input script that is looped over (see the "jump"_jump.html and
"next"_next.html commands).
See the "variable"_variable.html command for a description of {equal}
style variables which are typically the most useful ones to use with
the print command. Equal-style variables can calculate formulas
involving mathematical operations, atom properties, group properties,
thermodynamic properties, global values calculated by a
"compute"_compute.html or "fix"_fix.html, or references to other
"variables"_variable.html.
[Restrictions:] none
[Related commands:]
"fix print"_fix_print.html, "variable"_variable.html
[Default:]
The option defaults are no file output and screen = yes.