<A HREF = "read_restart.html">read_restart</A> commands.  These files can contain

molecular topology information.  Or create atoms on a lattice (with no

molecular topology), using these commands: <A HREF = "lattice.html">lattice</A>,

<A HREF = "orient.html">orient</A>, <A HREF = "origin.html">origin</A>, <A HREF = "region.html">region</A>,

<A HREF = "create_box.html">create_box</A>, <A HREF = "create_atoms.html">create_atoms</A>.  The

entire set of atoms can be duplicated to make a larger simulation

using the <A HREF = "replicate.html">replicate</A> command.

<A HREF = "region.html">region</A>, <A HREF = "create_box.html">create_box</A>,

<A HREF = "create_atoms.html">create_atoms</A>.  The entire set of atoms can be

duplicated to make a larger simulation using the

<A HREF = "replicate.html">replicate</A> command.

</P>

<P>(3) Settings

</P>

<P>Atom definition:

</P>

<P><A HREF = "create_atoms.html">create_atoms</A>, <A HREF = "create_box.html">create_box</A>,

<A HREF = "lattice.html">lattice</A>, <A HREF = "orient.html">orient</A>, <A HREF = "origin.html">origin</A>,

<A HREF = "read_data.html">read_data</A>, <A HREF = "read_restart.html">read_restart</A>,

<A HREF = "region.html">region</A>, <A HREF = "replicate.html">replicate</A>

<A HREF = "lattice.html">lattice</A>, <A HREF = "read_data.html">read_data</A>,

<A HREF = "read_restart.html">read_restart</A>, <A HREF = "region.html">region</A>,

<A HREF = "replicate.html">replicate</A>

</P>

<P>Force fields:

</P>

<TR ALIGN="center"><TD ><A HREF = "dump.html">dump</A></TD><TD ><A HREF = "dump_modify.html">dump_modify</A></TD><TD ><A HREF = "echo.html">echo</A></TD><TD ><A HREF = "fix.html">fix</A></TD><TD ><A HREF = "fix_modify.html">fix_modify</A></TD><TD ><A HREF = "group.html">group</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "improper_coeff.html">improper_coeff</A></TD><TD ><A HREF = "improper_style.html">improper_style</A></TD><TD ><A HREF = "include.html">include</A></TD><TD ><A HREF = "jump.html">jump</A></TD><TD ><A HREF = "kspace_modify.html">kspace_modify</A></TD><TD ><A HREF = "kspace_style.html">kspace_style</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "label.html">label</A></TD><TD ><A HREF = "lattice.html">lattice</A></TD><TD ><A HREF = "log.html">log</A></TD><TD ><A HREF = "mass.html">mass</A></TD><TD ><A HREF = "minimize.html">minimize</A></TD><TD ><A HREF = "min_modify.html">min_modify</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "min_style.html">min_style</A></TD><TD ><A HREF = "neigh_modify.html">neigh_modify</A></TD><TD ><A HREF = "neighbor.html">neighbor</A></TD><TD ><A HREF = "newton.html">newton</A></TD><TD ><A HREF = "next.html">next</A></TD><TD ><A HREF = "orient.html">orient</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "origin.html">origin</A></TD><TD ><A HREF = "pair_coeff.html">pair_coeff</A></TD><TD ><A HREF = "pair_modify.html">pair_modify</A></TD><TD ><A HREF = "pair_style.html">pair_style</A></TD><TD ><A HREF = "pair_write.html">pair_write</A></TD><TD ><A HREF = "print.html">print</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "processors.html">processors</A></TD><TD ><A HREF = "read_data.html">read_data</A></TD><TD ><A HREF = "read_restart.html">read_restart</A></TD><TD ><A HREF = "region.html">region</A></TD><TD ><A HREF = "replicate.html">replicate</A></TD><TD ><A HREF = "reset_timestep.html">reset_timestep</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "restart.html">restart</A></TD><TD ><A HREF = "run.html">run</A></TD><TD ><A HREF = "run_style.html">run_style</A></TD><TD ><A HREF = "set.html">set</A></TD><TD ><A HREF = "shell.html">shell</A></TD><TD ><A HREF = "special_bonds.html">special_bonds</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "temp_modify.html">temp_modify</A></TD><TD ><A HREF = "temper.html">temper</A></TD><TD ><A HREF = "temperature.html">temperature</A></TD><TD ><A HREF = "thermo.html">thermo</A></TD><TD ><A HREF = "thermo_modify.html">thermo_modify</A></TD><TD ><A HREF = "thermo_style.html">thermo_style</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "timestep.html">timestep</A></TD><TD ><A HREF = "undump.html">undump</A></TD><TD ><A HREF = "unfix.html">unfix</A></TD><TD ><A HREF = "units.html">units</A></TD><TD ><A HREF = "variable.html">variable</A></TD><TD ><A HREF = "velocity.html">velocity</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "write_restart.html">write_restart</A> 

<TR ALIGN="center"><TD ><A HREF = "min_style.html">min_style</A></TD><TD ><A HREF = "neigh_modify.html">neigh_modify</A></TD><TD ><A HREF = "neighbor.html">neighbor</A></TD><TD ><A HREF = "newton.html">newton</A></TD><TD ><A HREF = "next.html">next</A></TD><TD ><A HREF = "pair_coeff.html">pair_coeff</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "pair_modify.html">pair_modify</A></TD><TD ><A HREF = "pair_style.html">pair_style</A></TD><TD ><A HREF = "pair_write.html">pair_write</A></TD><TD ><A HREF = "print.html">print</A></TD><TD ><A HREF = "processors.html">processors</A></TD><TD ><A HREF = "read_data.html">read_data</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "read_restart.html">read_restart</A></TD><TD ><A HREF = "region.html">region</A></TD><TD ><A HREF = "replicate.html">replicate</A></TD><TD ><A HREF = "reset_timestep.html">reset_timestep</A></TD><TD ><A HREF = "restart.html">restart</A></TD><TD ><A HREF = "run.html">run</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "run_style.html">run_style</A></TD><TD ><A HREF = "set.html">set</A></TD><TD ><A HREF = "shell.html">shell</A></TD><TD ><A HREF = "special_bonds.html">special_bonds</A></TD><TD ><A HREF = "temp_modify.html">temp_modify</A></TD><TD ><A HREF = "temper.html">temper</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "temperature.html">temperature</A></TD><TD ><A HREF = "thermo.html">thermo</A></TD><TD ><A HREF = "thermo_modify.html">thermo_modify</A></TD><TD ><A HREF = "thermo_style.html">thermo_style</A></TD><TD ><A HREF = "timestep.html">timestep</A></TD><TD ><A HREF = "undump.html">undump</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "unfix.html">unfix</A></TD><TD ><A HREF = "units.html">units</A></TD><TD ><A HREF = "variable.html">variable</A></TD><TD ><A HREF = "velocity.html">velocity</A></TD><TD ><A HREF = "write_restart.html">write_restart</A> 

</TD></TR></TABLE></DIV>

<P>Fix styles.  See the <A HREF = "fix.html">fix</A> command for one-line descriptions

<TR ALIGN="center"><TD ><A HREF = "fix_nve.html">fix nve</A></TD><TD ><A HREF = "fix_nve_gran.html">fix nve/gran</A></TD><TD ><A HREF = "fix_nvt.html">fix nvt</A></TD><TD ><A HREF = "fix_orient_fcc.html">fix orient/fcc</A></TD><TD ><A HREF = "fix_planeforce.html">fix planeforce</A></TD><TD ><A HREF = "fix_poems.html">fix poems</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "fix_print.html">fix print</A></TD><TD ><A HREF = "fix_rdf.html">fix rdf</A></TD><TD ><A HREF = "fix_recenter.html">fix recenter</A></TD><TD ><A HREF = "fix_rigid.html">fix rigid</A></TD><TD ><A HREF = "fix_setforce.html">fix setforce</A></TD><TD ><A HREF = "fix_shake.html">fix shake</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "fix_spring.html">fix spring</A></TD><TD ><A HREF = "fix_spring_rg.html">fix spring/rg</A></TD><TD ><A HREF = "fix_spring_self.html">fix spring/self</A></TD><TD ><A HREF = "fix_temp_rescale.html">fix temp/rescale</A></TD><TD ><A HREF = "fix_tmd.html">fix tmd</A></TD><TD ><A HREF = "fix_uniaxial.html">fix uniaxial</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "fix_vcm.html">fix vcm</A></TD><TD ><A HREF = "fix_viscous.html">fix viscous</A></TD><TD ><A HREF = "fix_volume_rescale.html">fix volume/rescale</A></TD><TD ><A HREF = "fix_wall_gran.html">fix wall/gran</A></TD><TD ><A HREF = "fix_wall_lj93.html">fix wall/lj93</A></TD><TD ><A HREF = "fix_wall_reflect.html">fix wall/reflect</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "fix_wiggle.html">fix wiggle</A> 

<TR ALIGN="center"><TD ><A HREF = "fix_vcm.html">fix vcm</A></TD><TD ><A HREF = "fix_viscous.html">fix viscous</A></TD><TD ><A HREF = "fix_volume_rescale.html">fix volume/rescale</A></TD><TD ><A HREF = "fix_wall_gran.html">fix wall/gran</A></TD><TD ><A HREF = "fix_wall_lj93.html">fix wall/lj93</A></TD><TD ><A HREF = "fix_wall_lj126.html">fix wall/lj126</A></TD></TR>

<TR ALIGN="center"><TD ><A HREF = "fix_wall_reflect.html">fix wall/reflect</A></TD><TD ><A HREF = "fix_wiggle.html">fix wiggle</A> 

</TD></TR></TABLE></DIV>

<P>Pair styles.  See the <A HREF = "pair_style.html">pair_style</A> command for an

"read_restart"_read_restart.html commands.  These files can contain

molecular topology information.  Or create atoms on a lattice (with no

molecular topology), using these commands: "lattice"_lattice.html,

"orient"_orient.html, "origin"_origin.html, "region"_region.html,

"create_box"_create_box.html, "create_atoms"_create_atoms.html.  The

entire set of atoms can be duplicated to make a larger simulation

using the "replicate"_replicate.html command.

"region"_region.html, "create_box"_create_box.html,

"create_atoms"_create_atoms.html.  The entire set of atoms can be

duplicated to make a larger simulation using the

"replicate"_replicate.html command.

(3) Settings

Atom definition:

"create_atoms"_create_atoms.html, "create_box"_create_box.html,

"lattice"_lattice.html, "orient"_orient.html, "origin"_origin.html,

"read_data"_read_data.html, "read_restart"_read_restart.html,

"region"_region.html, "replicate"_replicate.html

"lattice"_lattice.html, "read_data"_read_data.html,

"read_restart"_read_restart.html, "region"_region.html,

"replicate"_replicate.html

Force fields:

"neighbor"_neighbor.html,

"newton"_newton.html,

"next"_next.html,

"orient"_orient.html,

"origin"_origin.html,

"pair_coeff"_pair_coeff.html,

"pair_modify"_pair_modify.html,

"pair_style"_pair_style.html,

"fix volume/rescale"_fix_volume_rescale.html,

"fix wall/gran"_fix_wall_gran.html,

"fix wall/lj93"_fix_wall_lj93.html,

"fix wall/lj126"_fix_wall_lj126.html,

"fix wall/reflect"_fix_wall_reflect.html,

"fix wiggle"_fix_wiggle.html :tb(c=6,ea=c)

</H3>

<P><B>Syntax:</B>

</P>

<PRE>create_atoms type region-ID 

<PRE>create_atoms type keyword values ... 

</PRE>

<UL><LI>type = atom type (1-N) of atoms to create on a lattice 

<LI>region-ID = ID of region each atom will belong to (optional) 

<LI>zero or more keyword/value pairs may be appended 

<LI>keyword = <I>region</I> or <I>basis</I> 

<PRE>  <I>region</I> value = region-ID

    region-ID = atoms will only be created if contained in the region

  <I>basis</I> values = M itype

    M = which basis atom

    itype = atom type (1-N) to assign to the basis atom 

</PRE>

</UL>

<P><B>Examples:</B>

</P>

<PRE>create_atoms 1 regsphere

create_atoms 3 

<PRE>create_atoms 1

create_atoms 3 region regsphere

create_atoms 1 basis 2 5 

</PRE>

<P><B>Description:</B>

</P>

<P>This command creates atoms on a lattice as an alternative to reading

in their coordinates via a <A HREF = "read_data.html">read_data</A> or

<A HREF = "read_restart.html">read_restart</A> command.  A simulation box must

already exist, which is created with the <A HREF = "create_box.html">create_box</A>

command.

already exist, which is typically created via the

<A HREF = "create_box.html">create_box</A> command.

</P>

<P>Before using this command, a lattice must be defined using the

<A HREF = "lattice.html">lattice</A> command.  If a region is not specified, the

create_atoms command fills the entire simulation box with atoms on the

lattice.  If a region is specified, then the geometric volume is

filled that is inside the simulation box and is also consistent with

the region volume.

lattice.  If a region is specified (see the <A HREF = "region.html">region</A>

command), then the geometric volume is filled that is inside the

simulation box and is also consistent with the region volume.  Note

that a region can be specified so that its "volume" is either inside

or outside a geometric boundary.

</P>

<P>The <A HREF = "lattice.html">lattice</A> command specifies one or more basis atoms

in each unit cell.  By default, when created, all basis atoms are

assigned the argument <I>type</I> as their atom type.  The keyword <I>basis</I>

can be used to override the default for one or more basis atoms and

assign them a different atom type.

</P>

<P>The <I>create_atoms</I> command can be used multiple times with different

lattice orientations to create grain boundaries.  Used in conjunction

with the <A HREF = "delete_atoms.html">delete_atoms</A> command, reasonably complex

geometries can be created.  The <I>create_atoms</I> command can also be

used to add atoms to a system previously read in from a data or

restart file.  In all these cases, care should be taken to insure that

new atoms do not overlap existing atoms inappropriately.

<P>By using the create_atoms command multiple times (interleaved with

<A HREF = "lattice.html">lattice</A> commands specifying different orientations),

grain boundaries can be created.  Using the create_atoms command in

conjunction with the <A HREF = "delete_atoms.html">delete_atoms</A> command,

reasonably complex geometries can be created.  The create_atoms

command can also be used to add atoms to a system previously read in

from a data or restart file.  In all these cases, care should be taken

to insure that new atoms do not overlap existing atoms

inappropriately.

</P>

<P>Created atoms are assigned the specified atom type and a velocity of

0.0.

<P>Created atoms are assigned a velocity of 0.0.

</P>

<P><B>Restrictions:</B>

</P>

</P>

<P><B>Related commands:</B>

</P>

<P><A HREF = "lattice.html">lattice</A>, <A HREF = "orient.html">orient</A>, <A HREF = "origin.html">origin</A>,

<A HREF = "region.html">region</A>, <A HREF = "create_box.html">create_box</A>,

<P><A HREF = "lattice.html">lattice</A>, <A HREF = "region.html">region</A>, <A HREF = "create_box.html">create_box</A>,

<A HREF = "read_data.html">read_data</A>, <A HREF = "read_restart.html">read_restart</A>

</P>

<P><B>Default:</B> none

[Syntax:]

create_atoms type region-ID :pre

type = atom type (1-N) of atoms to create on a lattice

region-ID = ID of region each atom will belong to (optional) :ul

create_atoms type keyword values ... :pre

type = atom type (1-N) of atoms to create on a lattice :ulb,l

zero or more keyword/value pairs may be appended :l

keyword = {region} or {basis} :l

  {region} value = region-ID

    region-ID = atoms will only be created if contained in the region

  {basis} values = M itype

    M = which basis atom

    itype = atom type (1-N) to assign to the basis atom :pre

:ule

[Examples:]

create_atoms 1 regsphere

create_atoms 3 :pre

create_atoms 1

create_atoms 3 region regsphere

create_atoms 1 basis 2 5 :pre

[Description:]

This command creates atoms on a lattice as an alternative to reading

in their coordinates via a "read_data"_read_data.html or

"read_restart"_read_restart.html command.  A simulation box must

already exist, which is created with the "create_box"_create_box.html

command.

already exist, which is typically created via the

"create_box"_create_box.html command.

Before using this command, a lattice must be defined using the

"lattice"_lattice.html command.  If a region is not specified, the

create_atoms command fills the entire simulation box with atoms on the

lattice.  If a region is specified, then the geometric volume is

filled that is inside the simulation box and is also consistent with

the region volume.

The {create_atoms} command can be used multiple times with different

lattice orientations to create grain boundaries.  Used in conjunction

with the "delete_atoms"_delete_atoms.html command, reasonably complex

geometries can be created.  The {create_atoms} command can also be

used to add atoms to a system previously read in from a data or

restart file.  In all these cases, care should be taken to insure that

new atoms do not overlap existing atoms inappropriately.

Created atoms are assigned the specified atom type and a velocity of

0.0.

lattice.  If a region is specified (see the "region"_region.html

command), then the geometric volume is filled that is inside the

simulation box and is also consistent with the region volume.  Note

that a region can be specified so that its "volume" is either inside

or outside a geometric boundary.

The "lattice"_lattice.html command specifies one or more basis atoms

in each unit cell.  By default, when created, all basis atoms are

assigned the argument {type} as their atom type.  The keyword {basis}

can be used to override the default for one or more basis atoms and

assign them a different atom type.

By using the create_atoms command multiple times (interleaved with

"lattice"_lattice.html commands specifying different orientations),

grain boundaries can be created.  Using the create_atoms command in

conjunction with the "delete_atoms"_delete_atoms.html command,

reasonably complex geometries can be created.  The create_atoms

command can also be used to add atoms to a system previously read in

from a data or restart file.  In all these cases, care should be taken

to insure that new atoms do not overlap existing atoms

inappropriately.

Created atoms are assigned a velocity of 0.0.

[Restrictions:]

[Related commands:]

"lattice"_lattice.html, "orient"_orient.html, "origin"_origin.html,

"region"_region.html, "create_box"_create_box.html,

"lattice"_lattice.html, "region"_region.html, "create_box"_create_box.html,

"read_data"_read_data.html, "read_restart"_read_restart.html

[Default:] none

<P>Distance units for the displacement are determined by the setting of

<I>box</I> or <I>lattice</I> for the <I>units</I> keyword.  <I>Box</I> means distance

units as defined by the <A HREF = "units.html">units</A> command - e.g. Angstroms

for <I>real</I> units.  <I>Lattice</I> means to use lattice spacings as defined

by the <A HREF = "lattice.html">lattice</A> command.  The default is to use lattice

units.

for <I>real</I> units.  <I>Lattice</I> means distance units are in lattice

spacings.  The <A HREF = "lattice.html">lattice</A> command must have been

previously used to define the lattice spacing.

</P>

<P>Care should be taken not to move atoms on top of other atoms.  After

the move, atoms are remapped to the periodic simulation box.  In

ready to perform a simulation before using this command (force fields

setup, atom masses set, etc).

</P>

<P><B>Related commands:</B> none

<P><B>Related commands:</B>

</P>

<P><A HREF = "lattice.html">lattice</A>

</P>

<P><B>Default:</B>

</P>