forked from lijiext/lammps
613 lines
42 KiB
HTML
613 lines
42 KiB
HTML
|
|
|
|
<!DOCTYPE html>
|
|
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
|
|
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
|
|
<head>
|
|
<meta charset="utf-8">
|
|
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
|
|
<title>fix atom/swap command — LAMMPS documentation</title>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="_static/sphinxcontrib-images/LightBox2/lightbox2/css/lightbox.css" type="text/css" />
|
|
|
|
|
|
|
|
<link rel="top" title="LAMMPS documentation" href="index.html"/>
|
|
<link rel="up" title="Fixes" href="fixes.html"/>
|
|
<link rel="next" title="fix ave/atom command" href="fix_ave_atom.html"/>
|
|
<link rel="prev" title="fix atc command" href="fix_atc.html"/>
|
|
|
|
|
|
<script src="_static/js/modernizr.min.js"></script>
|
|
|
|
</head>
|
|
|
|
<body class="wy-body-for-nav" role="document">
|
|
|
|
<div class="wy-grid-for-nav">
|
|
|
|
|
|
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
|
<div class="wy-side-nav-search">
|
|
|
|
|
|
|
|
<a href="Manual.html" class="icon icon-home"> LAMMPS
|
|
|
|
|
|
|
|
</a>
|
|
|
|
|
|
<div role="search">
|
|
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
|
|
<input type="text" name="q" placeholder="Search docs" />
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|
<input type="hidden" name="area" value="default" />
|
|
</form>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
|
|
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
|
|
|
|
|
|
|
|
<p class="caption"><span class="caption-text">User Documentation</span></p>
|
|
<ul>
|
|
<li class="toctree-l1"><a class="reference internal" href="Section_intro.html">1. Introduction</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="Section_start.html">2. Getting Started</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="Section_commands.html">3. Commands</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="Section_packages.html">4. Packages</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="Section_accelerate.html">5. Accelerating LAMMPS performance</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="Section_howto.html">6. How-to discussions</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="Section_example.html">7. Example problems</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="Section_perf.html">8. Performance & scalability</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="Section_tools.html">9. Additional tools</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="Section_modify.html">10. Modifying & extending LAMMPS</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="Section_python.html">11. Python interface to LAMMPS</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="Section_errors.html">12. Errors</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="Section_history.html">13. Future and history</a></li>
|
|
</ul>
|
|
<p class="caption"><span class="caption-text">Index</span></p>
|
|
<ul class="current">
|
|
<li class="toctree-l1"><a class="reference internal" href="tutorials.html">Tutorials</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="commands.html">Commands</a></li>
|
|
<li class="toctree-l1 current"><a class="reference internal" href="fixes.html">Fixes</a><ul class="current">
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_adapt.html">fix adapt command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_adapt_fep.html">fix adapt/fep command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_addforce.html">fix addforce command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_addtorque.html">fix addtorque command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_append_atoms.html">fix append/atoms command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_atc.html">fix atc command</a></li>
|
|
<li class="toctree-l2 current"><a class="current reference internal" href="#">fix atom/swap command</a><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="#syntax">Syntax</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="#examples">Examples</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="#description">Description</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="#restrictions">Restrictions</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="#related-commands">Related commands</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="#default">Default</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_ave_atom.html">fix ave/atom command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_ave_chunk.html">fix ave/chunk command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_ave_correlate.html">fix ave/correlate command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_ave_correlate_long.html">fix ave/correlate/long command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_ave_histo.html">fix ave/histo command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_ave_histo.html#fix-ave-histo-weight-command">fix ave/histo/weight command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_ave_time.html">fix ave/time command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_aveforce.html">fix aveforce command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_balance.html">fix balance command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_bond_break.html">fix bond/break command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_bond_create.html">fix bond/create command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_bond_swap.html">fix bond/swap command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_box_relax.html">fix box/relax command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_colvars.html">fix colvars command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_controller.html">fix controller command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_deform.html">fix deform command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_deform.html#fix-deform-kk-command">fix deform/kk command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_deposit.html">fix deposit command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_drag.html">fix drag command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_drude.html">fix drude command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_drude_transform.html">fix drude/transform/direct command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_drude_transform.html#fix-drude-transform-inverse-command">fix drude/transform/inverse command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_dt_reset.html">fix dt/reset command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_efield.html">fix efield command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_ehex.html">fix ehex command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_enforce2d.html">fix enforce2d command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_eos_cv.html">fix eos/cv command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_eos_table.html">fix eos/table command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_eos_table_rx.html">fix eos/table/rx command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_evaporate.html">fix evaporate command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_external.html">fix external command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_flow_gauss.html">fix flow/gauss command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_freeze.html">fix freeze command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_gcmc.html">fix gcmc command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_gld.html">fix gld command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_gle.html">fix gle command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_gravity.html">fix gravity command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_gravity.html#fix-gravity-omp-command">fix gravity/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_heat.html">fix heat command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_imd.html">fix imd command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_indent.html">fix indent command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_ipi.html">fix ipi command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_langevin.html">fix langevin command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_langevin.html#fix-langevin-kk-command">fix langevin/kk command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_langevin_drude.html">fix langevin/drude command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_langevin_eff.html">fix langevin/eff command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_lb_fluid.html">fix lb/fluid command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_lb_momentum.html">fix lb/momentum command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_lb_pc.html">fix lb/pc command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_lb_rigid_pc_sphere.html">fix lb/rigid/pc/sphere command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_lb_viscous.html">fix lb/viscous command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_lineforce.html">fix lineforce command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_manifoldforce.html">fix manifoldforce command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_meso.html">fix meso command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_meso_stationary.html">fix meso/stationary command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_momentum.html">fix momentum command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_move.html">fix move command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_msst.html">fix msst command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_neb.html">fix neb command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh.html">fix nvt command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh.html#fix-nvt-intel-command">fix nvt/intel command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh.html#fix-nvt-kk-command">fix nvt/kk command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh.html#fix-nvt-omp-command">fix nvt/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh.html#fix-npt-command">fix npt command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh.html#fix-npt-intel-command">fix npt/intel command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh.html#fix-npt-kk-command">fix npt/kk command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh.html#fix-npt-omp-command">fix npt/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh.html#fix-nph-command">fix nph command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh.html#fix-nph-kk-command">fix nph/kk command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh.html#fix-nph-omp-command">fix nph/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh_eff.html">fix nvt/eff command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh_eff.html#fix-npt-eff-command">fix npt/eff command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nh_eff.html#fix-nph-eff-command">fix nph/eff command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nph_asphere.html">fix nph/asphere command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nph_asphere.html#fix-nph-asphere-omp-command">fix nph/asphere/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nph_body.html">fix nph/body command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nph_sphere.html">fix nph/sphere command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nph_sphere.html#fix-nph-sphere-omp-command">fix nph/sphere/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nphug.html">fix nphug command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nphug.html#fix-nphug-omp-command">fix nphug/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_npt_asphere.html">fix npt/asphere command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_npt_asphere.html#fix-npt-asphere-omp-command">fix npt/asphere/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_npt_body.html">fix npt/body command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_npt_sphere.html">fix npt/sphere command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_npt_sphere.html#fix-npt-sphere-omp-command">fix npt/sphere/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve.html">fix nve command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve.html#fix-nve-intel-command">fix nve/intel command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve.html#fix-nve-kk-command">fix nve/kk command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve.html#fix-nve-omp-command">fix nve/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve_asphere.html">fix nve/asphere command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve_asphere.html#fix-nve-asphere-intel-command">fix nve/asphere/intel command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve_asphere_noforce.html">fix nve/asphere/noforce command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve_body.html">fix nve/body command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve_eff.html">fix nve/eff command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve_limit.html">fix nve/limit command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve_line.html">fix nve/line command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve_manifold_rattle.html">fix nve/manifold/rattle command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve_noforce.html">fix nve/noforce command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve_sphere.html">fix nve/sphere command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve_sphere.html#fix-nve-sphere-omp-command">fix nve/sphere/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nve_tri.html">fix nve/tri command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nvt_asphere.html">fix nvt/asphere command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nvt_asphere.html#fix-nvt-asphere-omp-command">fix nvt/asphere/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nvt_body.html">fix nvt/body command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nvt_manifold_rattle.html">fix nvt/manifold/rattle command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nvt_sllod.html">fix nvt/sllod command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nvt_sllod.html#fix-nvt-sllod-intel-command">fix nvt/sllod/intel command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nvt_sllod.html#fix-nvt-sllod-omp-command">fix nvt/sllod/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nvt_sllod_eff.html">fix nvt/sllod/eff command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nvt_sphere.html">fix nvt/sphere command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_nvt_sphere.html#fix-nvt-sphere-omp-command">fix nvt/sphere/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_oneway.html">fix oneway command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_orient.html">fix orient/fcc command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_orient.html#fix-orient-bcc-command">fix orient/bcc command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_phonon.html">fix phonon command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_pimd.html">fix pimd command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_planeforce.html">fix planeforce command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_poems.html">fix poems</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_pour.html">fix pour command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_press_berendsen.html">fix press/berendsen command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_print.html">fix print command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_property_atom.html">fix property/atom command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_qbmsst.html">fix qbmsst command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_qeq.html">fix qeq/point command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_qeq.html#fix-qeq-shielded-command">fix qeq/shielded command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_qeq.html#fix-qeq-slater-command">fix qeq/slater command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_qeq.html#fix-qeq-dynamic-command">fix qeq/dynamic command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_qeq.html#fix-qeq-fire-command">fix qeq/fire command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_qeq_comb.html">fix qeq/comb command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_qeq_comb.html#fix-qeq-comb-omp-command">fix qeq/comb/omp command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_qeq_reax.html">fix qeq/reax command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_qeq_reax.html#fix-qeq-reax-kk-command">fix qeq/reax/kk command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_qmmm.html">fix qmmm command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_qtb.html">fix qtb command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_reax_bonds.html">fix reax/bonds command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_reax_bonds.html#fix-reax-c-bonds-command">fix reax/c/bonds command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_reaxc_species.html">fix reax/c/species command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_recenter.html">fix recenter command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_restrain.html">fix restrain command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_rigid.html">fix rigid command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_rigid.html#fix-rigid-nve-command">fix rigid/nve command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_rigid.html#fix-rigid-nvt-command">fix rigid/nvt command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_rigid.html#fix-rigid-npt-command">fix rigid/npt command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_rigid.html#fix-rigid-nph-command">fix rigid/nph command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_rigid.html#fix-rigid-small-command">fix rigid/small command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_rigid.html#fix-rigid-nve-small-command">fix rigid/nve/small command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_rigid.html#fix-rigid-nvt-small-command">fix rigid/nvt/small command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_rigid.html#fix-rigid-npt-small-command">fix rigid/npt/small command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_rigid.html#fix-rigid-nph-small-command">fix rigid/nph/small command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_rx.html">fix rx command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_saed_vtk.html">fix saed/vtk command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_setforce.html">fix setforce command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_setforce.html#fix-setforce-kk-command">fix setforce/kk command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_shake.html">fix shake command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_shake.html#fix-rattle-command">fix rattle command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_shardlow.html">fix shardlow command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_smd.html">fix smd command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_smd_adjust_dt.html">fix smd/adjust_dt command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_smd_integrate_tlsph.html">fix smd/integrate_tlsph command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_smd_integrate_ulsph.html">fix smd/integrate_ulsph command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_smd_move_triangulated_surface.html">fix smd/move_tri_surf command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_smd_setvel.html">fix smd/setvel command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_smd_wall_surface.html">fix smd/wall_surface command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_spring.html">fix spring command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_spring_chunk.html">fix spring/chunk command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_spring_rg.html">fix spring/rg command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_spring_self.html">fix spring/self command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_srd.html">fix srd command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_store_force.html">fix store/force command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_store_state.html">fix store/state command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_temp_berendsen.html">fix temp/berendsen command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_temp_csvr.html">fix temp/csvr command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_temp_csvr.html#fix-temp-csld-command">fix temp/csld command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_temp_rescale.html">fix temp/rescale command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_temp_rescale_eff.html">fix temp/rescale/eff command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_tfmc.html">fix tfmc command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_thermal_conductivity.html">fix thermal/conductivity command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_ti_rs.html">fix ti/rs command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_ti_spring.html">fix ti/spring command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_tmd.html">fix tmd command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_ttm.html">fix ttm command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_ttm.html#fix-ttm-mod-command">fix ttm/mod command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_tune_kspace.html">fix tune/kspace command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_vector.html">fix vector command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_viscosity.html">fix viscosity command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_viscous.html">fix viscous command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_wall.html">fix wall/lj93 command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_wall.html#fix-wall-lj126-command">fix wall/lj126 command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_wall.html#fix-wall-lj1043-command">fix wall/lj1043 command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_wall.html#fix-wall-colloid-command">fix wall/colloid command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_wall.html#fix-wall-harmonic-command">fix wall/harmonic command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_wall_gran.html">fix wall/gran command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_wall_piston.html">fix wall/piston command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_wall_reflect.html">fix wall/reflect command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_wall_reflect.html#fix-wall-reflect-kk-command">fix wall/reflect/kk command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_wall_region.html">fix wall/region command</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="fix_wall_srd.html">fix wall/srd command</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="computes.html">Computes</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="pairs.html">Pair Styles</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="bonds.html">Bonds</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="angles.html">Angle Styles</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="dihedrals.html">Dihedral Styles</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="impropers.html">Improper Styles</a></li>
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
</nav>
|
|
|
|
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
|
|
|
|
|
|
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
|
|
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
|
<a href="Manual.html">LAMMPS</a>
|
|
</nav>
|
|
|
|
|
|
|
|
<div class="wy-nav-content">
|
|
<div class="rst-content">
|
|
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
<ul class="wy-breadcrumbs">
|
|
<li><a href="Manual.html">Docs</a> »</li>
|
|
|
|
<li><a href="fixes.html">Fixes</a> »</li>
|
|
|
|
<li>fix atom/swap command</li>
|
|
<li class="wy-breadcrumbs-aside">
|
|
|
|
|
|
<a href="http://lammps.sandia.gov">Website</a>
|
|
<a href="Section_commands.html#comm">Commands</a>
|
|
|
|
</li>
|
|
</ul>
|
|
<hr/>
|
|
|
|
<div class="rst-footer-buttons" style="margin-bottom: 1em" role="navigation" aria-label="footer navigation">
|
|
|
|
<a href="fix_ave_atom.html" class="btn btn-neutral float-right" title="fix ave/atom command" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
|
|
|
|
|
|
<a href="fix_atc.html" class="btn btn-neutral" title="fix atc command" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
<div itemprop="articleBody">
|
|
|
|
<div class="section" id="fix-atom-swap-command">
|
|
<span id="index-0"></span><h1>fix atom/swap command</h1>
|
|
<div class="section" id="syntax">
|
|
<h2>Syntax</h2>
|
|
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">fix</span> <span class="n">ID</span> <span class="n">group</span><span class="o">-</span><span class="n">ID</span> <span class="n">atom</span><span class="o">/</span><span class="n">swap</span> <span class="n">N</span> <span class="n">X</span> <span class="n">seed</span> <span class="n">T</span> <span class="n">keyword</span> <span class="n">values</span> <span class="o">...</span>
|
|
</pre></div>
|
|
</div>
|
|
<ul>
|
|
<li><p class="first">ID, group-ID are documented in <a class="reference internal" href="fix.html"><span class="doc">fix</span></a> command</p>
|
|
</li>
|
|
<li><p class="first">atom/swap = style name of this fix command</p>
|
|
</li>
|
|
<li><p class="first">N = invoke this fix every N steps</p>
|
|
</li>
|
|
<li><p class="first">X = number of swaps to attempt every N steps</p>
|
|
</li>
|
|
<li><p class="first">seed = random # seed (positive integer)</p>
|
|
</li>
|
|
<li><p class="first">T = scaling temperature of the MC swaps (temperature units)</p>
|
|
</li>
|
|
<li><p class="first">one or more keyword/value pairs may be appended to args</p>
|
|
</li>
|
|
<li><p class="first">keyword = <em>types</em> or <em>mu</em> or <em>ke</em> or <em>semi-grand</em> or <em>region</em></p>
|
|
<pre class="literal-block">
|
|
<em>types</em> values = two or more atom types
|
|
<em>mu</em> values = chemical potential of swap types (energy units)
|
|
<em>ke</em> value = <em>no</em> or <em>yes</em>
|
|
<em>no</em> = no conservation of kinetic energy after atom swaps
|
|
<em>yes</em> = kinetic energy is conserved after atom swaps
|
|
<em>semi-grand</em> value = <em>no</em> or <em>yes</em>
|
|
<em>no</em> = particle type counts and fractions conserved
|
|
<em>yes</em> = semi-grand canonical ensemble, particle fractions not conserved
|
|
<em>region</em> value = region-ID
|
|
region-ID = ID of region to use as an exchange/move volume
|
|
</pre>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="section" id="examples">
|
|
<h2>Examples</h2>
|
|
<pre class="literal-block">
|
|
fix 2 all atom/swap 1 1 29494 300.0 ke no types 1 2
|
|
fix myFix all atom/swap 100 1 12345 298.0 region my_swap_region types 5 6
|
|
fix SGMC all atom/swap 1 100 345 1.0 semi-grand yes types 1 2 3 mu 0.0 4.3 -5.0
|
|
</pre>
|
|
</div>
|
|
<div class="section" id="description">
|
|
<h2>Description</h2>
|
|
<p>This fix performs Monte Carlo swaps of atoms of one given atom type
|
|
with atoms of the other given atom types. The specified T is used in
|
|
the Metropolis criterion dictating swap probabilities.</p>
|
|
<p>Perform X swaps of atoms of one type with atoms of another type
|
|
according to a Monte Carlo probability. Swap candidates must be in the
|
|
fix group, must be in the region (if specified), and must be of one of
|
|
the listed types. Swaps are attempted between candidates that are
|
|
chosen randomly with equal probability among the candidate
|
|
atoms. Swaps are not attempted between atoms of the same type since
|
|
nothing would happen.</p>
|
|
<p>All atoms in the simulation domain can be moved using regular time
|
|
integration displacements, e.g. via <a class="reference internal" href="fix_nh.html"><span class="doc">fix nvt</span></a>, resulting
|
|
in a hybrid MC+MD simulation. A smaller-than-usual timestep size may
|
|
be needed when running such a hybrid simulation, especially if the
|
|
swapped atoms are not well equilibrated.</p>
|
|
<p>The <em>types</em> keyword is required. At least two atom types must be
|
|
specified.</p>
|
|
<p>The <em>ke</em> keyword can be set to <em>no</em> to turn off kinetic energy
|
|
conservation for swaps. The default is <em>yes</em>, which means that swapped
|
|
atoms have their velocities scaled by the ratio of the masses of the
|
|
swapped atom types. This ensures that the kinetic energy of each atom
|
|
is the same after the swap as it was before the swap, even though the
|
|
atom masses have changed.</p>
|
|
<p>The <em>semi-grand</em> keyword can be set to <em>yes</em> to switch to the
|
|
semi-grand canonical ensemble as discussed in <a class="reference internal" href="#sadigh"><span class="std std-ref">(Sadigh)</span></a>. This
|
|
means that the total number of each particle type does not need to be
|
|
conserved. The default is <em>no</em>, which means that the only kind of swap
|
|
allowed exchanges an atom of one type with an atom of a different
|
|
given type. In other words, the relative mole fractions of the swapped
|
|
atoms remains constant. Whereas in the semi-grand canonical ensemble,
|
|
the composition of the system can change. Note that when using
|
|
<em>semi-grand</em>, atoms in the fix group whose type is not listed
|
|
in the <em>types</em> keyword are ineligible for attempted
|
|
conversion. An attempt is made to switch
|
|
the selected atom (if eligible) to one of the other listed types
|
|
with equal probability. Acceptance of each attempt depends upon the Metropolis criterion.</p>
|
|
<p>The <em>mu</em> keyword allows users to specify chemical
|
|
potentials. This is required and allowed only when using <em>semi-grand</em>.
|
|
All chemical potentials are absolute, so there is one for
|
|
each swap type listed following the <em>types</em> keyword.
|
|
In semi-grand canonical ensemble simulations the chemical composition
|
|
of the system is controlled by the difference in these values. So
|
|
shifting all values by a constant amount will have no effect
|
|
on the simulation.</p>
|
|
<p>This command may optionally use the <em>region</em> keyword to define swap
|
|
volume. The specified region must have been previously defined with a
|
|
<a class="reference internal" href="region.html"><span class="doc">region</span></a> command. It must be defined with side = <em>in</em>.
|
|
Swap attempts occur only between atoms that are both within the
|
|
specified region. Swaps are not otherwise attempted.</p>
|
|
<p>You should ensure you do not swap atoms belonging to a molecule, or
|
|
LAMMPS will soon generate an error when it tries to find those atoms.
|
|
LAMMPS will warn you if any of the atoms eligible for swapping have a
|
|
non-zero molecule ID, but does not check for this at the time of
|
|
swapping.</p>
|
|
<p>If not using <em>semi-grand</em> this fix checks to ensure all atoms of the
|
|
given types have the same atomic charge. LAMMPS doesn’t enforce this
|
|
in general, but it is needed for this fix to simplify the
|
|
swapping procedure. Successful swaps will swap the atom type and charge
|
|
of the swapped atoms. Conversely, when using <em>semi-grand</em>, it is assumed that all the atom
|
|
types involved in switches have the same charge. Otherwise, charge
|
|
would not be conserved. As a consequence, no checks on atomic charges are
|
|
performed, and successful switches update the atom type but not the
|
|
atom charge. While it is possible to use <em>semi-grand</em> with groups of
|
|
atoms that have different charges, these charges will not be changed when the
|
|
atom types change.</p>
|
|
<p>Since this fix computes total potential energies before and after
|
|
proposed swaps, so even complicated potential energy calculations are
|
|
OK, including the following:</p>
|
|
<ul class="simple">
|
|
<li>long-range electrostatics (kspace)</li>
|
|
<li>many body pair styles</li>
|
|
<li>hybrid pair styles</li>
|
|
<li>eam pair styles</li>
|
|
<li>triclinic systems</li>
|
|
<li>need to include potential energy contributions from other fixes</li>
|
|
</ul>
|
|
<p>Some fixes have an associated potential energy. Examples of such fixes
|
|
include: <a class="reference internal" href="fix_efield.html"><span class="doc">efield</span></a>, <a class="reference internal" href="fix_gravity.html"><span class="doc">gravity</span></a>,
|
|
<a class="reference internal" href="fix_addforce.html"><span class="doc">addforce</span></a>, <a class="reference internal" href="fix_langevin.html"><span class="doc">langevin</span></a>,
|
|
<a class="reference internal" href="fix_restrain.html"><span class="doc">restrain</span></a>, <a class="reference internal" href="fix_temp_berendsen.html"><span class="doc">temp/berendsen</span></a>,
|
|
<a class="reference internal" href="fix_temp_rescale.html"><span class="doc">temp/rescale</span></a>, and <a class="reference internal" href="fix_wall.html"><span class="doc">wall fixes</span></a>.
|
|
For that energy to be included in the total potential energy of the
|
|
system (the quantity used when performing GCMC moves),
|
|
you MUST enable the <a class="reference internal" href="fix_modify.html"><span class="doc">fix_modify</span></a> <em>energy</em> option for
|
|
that fix. The doc pages for individual <a class="reference internal" href="fix.html"><span class="doc">fix</span></a> commands
|
|
specify if this should be done.</p>
|
|
<p><strong>Restart, fix_modify, output, run start/stop, minimize info:</strong></p>
|
|
<p>This fix writes the state of the fix to <a class="reference internal" href="restart.html"><span class="doc">binary restart files</span></a>. This includes information about the random
|
|
number generator seed, the next timestep for MC exchanges, etc. See
|
|
the <a class="reference internal" href="read_restart.html"><span class="doc">read_restart</span></a> command for info on how to
|
|
re-specify a fix in an input script that reads a restart file, so that
|
|
the operation of the fix continues in an uninterrupted fashion.</p>
|
|
<p>None of the <a class="reference internal" href="fix_modify.html"><span class="doc">fix_modify</span></a> options are relevant to this
|
|
fix.</p>
|
|
<p>This fix computes a global vector of length 2, which can be accessed
|
|
by various <a class="reference internal" href="Section_howto.html#howto-15"><span class="std std-ref">output commands</span></a>. The vector
|
|
values are the following global cumulative quantities:</p>
|
|
<ul class="simple">
|
|
<li>1 = swap attempts</li>
|
|
<li>2 = swap successes</li>
|
|
</ul>
|
|
<p>The vector values calculated by this fix are “extensive”.</p>
|
|
<p>No parameter of this fix can be used with the <em>start/stop</em> keywords of
|
|
the <a class="reference internal" href="run.html"><span class="doc">run</span></a> command. This fix is not invoked during <a class="reference internal" href="minimize.html"><span class="doc">energy minimization</span></a>.</p>
|
|
</div>
|
|
<div class="section" id="restrictions">
|
|
<h2>Restrictions</h2>
|
|
<p>This fix is part of the MC package. It is only enabled if LAMMPS was
|
|
built with that package. See the <a class="reference internal" href="Section_start.html#start-3"><span class="std std-ref">Making LAMMPS</span></a> section for more info.</p>
|
|
</div>
|
|
<div class="section" id="related-commands">
|
|
<h2>Related commands</h2>
|
|
<p><a class="reference internal" href="fix_nh.html"><span class="doc">fix nvt</span></a>, <a class="reference internal" href="neighbor.html"><span class="doc">neighbor</span></a>,
|
|
<a class="reference internal" href="fix_deposit.html"><span class="doc">fix deposit</span></a>, <a class="reference internal" href="fix_evaporate.html"><span class="doc">fix evaporate</span></a>,
|
|
<a class="reference internal" href="delete_atoms.html"><span class="doc">delete_atoms</span></a>, <a class="reference internal" href="fix_gcmc.html"><span class="doc">fix gcmc</span></a></p>
|
|
</div>
|
|
<div class="section" id="default">
|
|
<h2>Default</h2>
|
|
<p>The option defaults are ke = yes, semi-grand = no, mu = 0.0 for
|
|
all atom types.</p>
|
|
<hr class="docutils" />
|
|
<p id="sadigh"><strong>(Sadigh)</strong> B Sadigh, P Erhart, A Stukowski, A Caro, E Martinez, and
|
|
L Zepeda-Ruiz, Phys. Rev. B, 85, 184203 (2012).</p>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
</div>
|
|
<footer>
|
|
|
|
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
|
|
|
<a href="fix_ave_atom.html" class="btn btn-neutral float-right" title="fix ave/atom command" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
|
|
|
|
|
|
<a href="fix_atc.html" class="btn btn-neutral" title="fix atc command" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
|
|
|
|
</div>
|
|
|
|
|
|
<hr/>
|
|
|
|
<div role="contentinfo">
|
|
<p>
|
|
© Copyright 2013 Sandia Corporation.
|
|
</p>
|
|
</div>
|
|
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
|
|
|
</footer>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</section>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<script type="text/javascript">
|
|
var DOCUMENTATION_OPTIONS = {
|
|
URL_ROOT:'./',
|
|
VERSION:'',
|
|
COLLAPSE_INDEX:false,
|
|
FILE_SUFFIX:'.html',
|
|
HAS_SOURCE: true
|
|
};
|
|
</script>
|
|
<script type="text/javascript" src="_static/jquery.js"></script>
|
|
<script type="text/javascript" src="_static/underscore.js"></script>
|
|
<script type="text/javascript" src="_static/doctools.js"></script>
|
|
<script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
|
|
<script type="text/javascript" src="_static/sphinxcontrib-images/LightBox2/lightbox2/js/jquery-1.11.0.min.js"></script>
|
|
<script type="text/javascript" src="_static/sphinxcontrib-images/LightBox2/lightbox2/js/lightbox.min.js"></script>
|
|
<script type="text/javascript" src="_static/sphinxcontrib-images/LightBox2/lightbox2-customize/jquery-noconflict.js"></script>
|
|
|
|
|
|
|
|
|
|
|
|
<script type="text/javascript" src="_static/js/theme.js"></script>
|
|
|
|
|
|
|
|
|
|
<script type="text/javascript">
|
|
jQuery(function () {
|
|
SphinxRtdTheme.StickyNav.enable();
|
|
});
|
|
</script>
|
|
|
|
|
|
</body>
|
|
</html> |