next up previous contents index
Next: Interface print_cfg Up: Module atoms_module Previous: Interface print   Contents   Index

Interface print_xyz


\begin{boxedminipage}{\textwidth}
\begin{verbatim}call print_xyz(this,xyzfil...
...
all_properties,human_readable,real_format])\end{verbatim}
\end{boxedminipage}

Print this Atoms object to an Inouput object or to a file in XYZ format. By default, only the atomic species and positions are written, but the properties argument allows you to specify additional properties to be printed, e.g. properties=(/"pos","velo","acc"/) would print the positions, velocities and accelerations (9 columns of real numbers). The all_properties option prints all properties associated with this Atoms object. The comment line (line 2) of the XYZ file contains the contents of the params dictionary which at a minimum includes the lattice and list of properties printed, but can be used to print other simulation parameters.

The lattice is printed in the form:


\begin{boxedminipage}{\textwidth}
\begin{verbatim}Lattice=''R11 R21 R31 R12 R22 R32 R13 R23 R33''\end{verbatim}
\end{boxedminipage}

and the list of properties in the file is added in the form:


\begin{boxedminipage}{\textwidth}
\begin{verbatim}Properties=''species:S:1:pos:R:3:velo:R:3:acc:R:3''\end{verbatim}
\end{boxedminipage}

with a triplet of colon-separated fields for each property, giving its name, type (R for real,I for integer, S for string and L for logical) and number of columns. Other parameters are output in key=value format -- all types of dictionary entries with the exception, for now, of complex numbers are supported.

this -- type(Atoms), intent(inout)

Atoms object to print

xyzfile -- type(Inoutput), intent(inout)

Inoutput object to write to

comment -- character(*), optional, intent(in)

Comment line (line #2 of xyz file)

properties -- character(*), optional, intent(in)

Colon separated list of properties from this%data to be printed. If not specified, we print only the atomic positions, unless all_properties is true.

all_properties -- logical, optional, intent(in)

Should we print all properties (default is false)

human_readable -- logical, optional, intent(in)

If set to true, pretty-print table of atomic properties.

real_format -- optional, intent(in),

character(len=*) or character(*)

mask -- logical, optional, intent(in), dimension(:)

xyzfilename -- character(*), intent(in)

print_cfg interface
next up previous contents index
Next: Interface print_cfg Up: Module atoms_module Previous: Interface print   Contents   Index
gabor 2009-06-30