forked from lijiext/lammps
git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@15410 f3b2605a-c512-4ea7-a41b-209d697bcdaa
This commit is contained in:
parent
5b5f839265
commit
fd05571ee0
|
@ -14,6 +14,29 @@ Syntax
|
|||
* rigid/local = style name of this compute command
|
||||
* rigidID = ID of fix rigid/small command or one of its variants
|
||||
* input = one or more rigid body attributes
|
||||
.. parsed-literal::
|
||||
|
||||
possible attributes = id, mol, mass,
|
||||
x, y, z, xu, yu, zu, ix, iy, iz
|
||||
vx, vy, vz, fx, fy, fz,
|
||||
omegax, omegay, omegaz,
|
||||
angmomx, angmomy, angmomz,
|
||||
quatw, quati, quatj, quatk,
|
||||
tqx, tqy, tqz,
|
||||
inertiax, inertiay, inertiaz
|
||||
id = atom ID of atom within body which owns body properties
|
||||
mol = molecule ID used to define body in :doc:`fix rigid/small <fix_rigid>` command
|
||||
mass = total mass of body
|
||||
x,y,z = center of mass coords of body
|
||||
xu,yu,zu = unwrapped center of mass coords of body
|
||||
ix,iy,iz = box image that the center of mass is in
|
||||
vx,vy,vz = center of mass velocities
|
||||
fx,fy,fz = force of center of mass
|
||||
omegax,omegay,omegaz = angular velocity of body
|
||||
angmomx,angmomy,angmomz = angular momentum of body
|
||||
quatw,quati,quatj,quatk = quaternion components for body
|
||||
tqx,tqy,tqz = torque on body
|
||||
inertiax,inertiay,inertiaz = diagonalized moments of inertia of body
|
||||
|
||||
|
||||
|
||||
|
|
|
@ -1,8 +1,18 @@
|
|||
Description
|
||||
"""""""""""
|
||||
Manifolds (surfacse)
|
||||
====================
|
||||
|
||||
Below is a list of currently supported manifolds, their parameters and a short description of them.
|
||||
The parameters listed here are in the same order as they should be passed to the relevant fixes.
|
||||
**Overview:**
|
||||
|
||||
This doc page is not about a LAMMPS input script command, but about
|
||||
manifolds, which are generalized surfaces, as defined and used by the
|
||||
USER-MANIFOLD package, to track particle motion on the manifolds. See
|
||||
the src/USER-MANIFOLD/README file for more details about the package
|
||||
and its commands.
|
||||
|
||||
Below is a list of currently supported manifolds by the USER-MANIFOLD
|
||||
package, their parameters and a short description of them. The
|
||||
parameters listed here are in the same order as they should be passed
|
||||
to the relevant fixes.
|
||||
|
||||
+---------------+----------------+----------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+--+
|
||||
| *manifold* | *parameters* | *equation* | *description* | |
|
||||
|
|
|
@ -216,9 +216,6 @@ pair style be defined.
|
|||
----------
|
||||
|
||||
|
||||
Use of *special* keyword
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
The *special* keyword allows to override the 1-2, 1-3, and 1-4
|
||||
exclusion settings for individual sub-styles of a
|
||||
:doc:`hybrid pair style <pair_hybrid>`. It requires 4 arguments similar
|
||||
|
|
|
@ -1,23 +1,21 @@
|
|||
LAMMPS GitHub tutorial
|
||||
**********************
|
||||
======================
|
||||
|
||||
written by Stefan Paquay
|
||||
========================
|
||||
**written by Stefan Paquay**
|
||||
|
||||
|
||||
----------
|
||||
|
||||
|
||||
This document briefly describes how to use GitHub to merge changes
|
||||
into LAMMPS using GitHub. It assumes that you are familiar with
|
||||
This document briefly describes how to use GitHub to merge changes you
|
||||
make into LAMMPS, using GitHub. It assumes that you are familiar with
|
||||
git. You may want to have a look at the `Git book <http://git-scm.com/book/>`_ to reacquaint yourself.
|
||||
|
||||
|
||||
----------
|
||||
|
||||
|
||||
Making an account
|
||||
*****************
|
||||
**Making an account**
|
||||
|
||||
First of all, you need a GitHub account. This is fairly simple, just
|
||||
go to `GitHub <https://github.com>`_ and create an account by clicking
|
||||
|
@ -29,8 +27,7 @@ username or e-mail address and password.
|
|||
----------
|
||||
|
||||
|
||||
Forking the repository
|
||||
**********************
|
||||
**Forking the repository**
|
||||
|
||||
To get changes into LAMMPS, you need to first fork the repository. At
|
||||
the time of writing, LAMMPS-ICMS is the preferred fork. Go to `LAMMPS on GitHub <https://github.com/lammps/lammps>`_ and make sure branch is
|
||||
|
@ -54,14 +51,12 @@ can include changes from upstream into your repository.
|
|||
----------
|
||||
|
||||
|
||||
Adding changes to your own fork
|
||||
*******************************
|
||||
**Adding changes to your own fork**
|
||||
|
||||
Before adding changes, it is better to first create a new branch that
|
||||
will contain these changes, a so-called feature branch.
|
||||
|
||||
Feature branches
|
||||
================
|
||||
**Feature branches**
|
||||
|
||||
Since LAMMPS is such a big project and most user contributions come in
|
||||
small portions, the most ideal workflow for LAMMPS is the so-called
|
||||
|
@ -126,8 +121,7 @@ After the files are added, the change should be comitted:
|
|||
The "-m" switch is used to add a message to the commit. Use this to
|
||||
indicate what type of change was commited.
|
||||
|
||||
Wisdom by Axel:
|
||||
---------------
|
||||
**Wisdom by Axel**
|
||||
|
||||
*"Do not use "git commit -a". the -a flag will automatically include
|
||||
*all* modified or new files. mercurial does that and it find it
|
||||
|
@ -204,8 +198,7 @@ request.
|
|||
----------
|
||||
|
||||
|
||||
Additional changes
|
||||
******************
|
||||
**Additional changes**
|
||||
|
||||
Before the pull request is accepted, any additional changes you push
|
||||
into your repository will automatically become part of the pull
|
||||
|
@ -215,8 +208,7 @@ request.
|
|||
----------
|
||||
|
||||
|
||||
After a merge
|
||||
*************
|
||||
**After a merge**
|
||||
|
||||
When everything is fine the feature branch is merged into the LAMMPS
|
||||
repositories:
|
||||
|
|
|
@ -137,6 +137,29 @@
|
|||
<li>rigidID = ID of fix rigid/small command or one of its variants</li>
|
||||
<li>input = one or more rigid body attributes</li>
|
||||
</ul>
|
||||
<pre class="literal-block">
|
||||
possible attributes = id, mol, mass,
|
||||
x, y, z, xu, yu, zu, ix, iy, iz
|
||||
vx, vy, vz, fx, fy, fz,
|
||||
omegax, omegay, omegaz,
|
||||
angmomx, angmomy, angmomz,
|
||||
quatw, quati, quatj, quatk,
|
||||
tqx, tqy, tqz,
|
||||
inertiax, inertiay, inertiaz
|
||||
id = atom ID of atom within body which owns body properties
|
||||
mol = molecule ID used to define body in <a class="reference internal" href="fix_rigid.html"><span class="doc">fix rigid/small</span></a> command
|
||||
mass = total mass of body
|
||||
x,y,z = center of mass coords of body
|
||||
xu,yu,zu = unwrapped center of mass coords of body
|
||||
ix,iy,iz = box image that the center of mass is in
|
||||
vx,vy,vz = center of mass velocities
|
||||
fx,fy,fz = force of center of mass
|
||||
omegax,omegay,omegaz = angular velocity of body
|
||||
angmomx,angmomy,angmomz = angular momentum of body
|
||||
quatw,quati,quatj,quatk = quaternion components for body
|
||||
tqx,tqy,tqz = torque on body
|
||||
inertiax,inertiay,inertiaz = diagonalized moments of inertia of body
|
||||
</pre>
|
||||
</div>
|
||||
<div class="section" id="examples">
|
||||
<h2>Examples</h2>
|
||||
|
|
|
@ -8,7 +8,7 @@
|
|||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>Description — LAMMPS documentation</title>
|
||||
<title>Manifolds (surfacse) — LAMMPS documentation</title>
|
||||
|
||||
|
||||
|
||||
|
@ -109,7 +109,7 @@
|
|||
<ul class="wy-breadcrumbs">
|
||||
<li><a href="Manual.html">Docs</a> »</li>
|
||||
|
||||
<li>Description</li>
|
||||
<li>Manifolds (surfacse)</li>
|
||||
<li class="wy-breadcrumbs-aside">
|
||||
|
||||
|
||||
|
@ -124,10 +124,18 @@
|
|||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
||||
<div itemprop="articleBody">
|
||||
|
||||
<div class="section" id="description">
|
||||
<h1>Description</h1>
|
||||
<p>Below is a list of currently supported manifolds, their parameters and a short description of them.
|
||||
The parameters listed here are in the same order as they should be passed to the relevant fixes.</p>
|
||||
<div class="section" id="manifolds-surfacse">
|
||||
<h1>Manifolds (surfacse)</h1>
|
||||
<p><strong>Overview:</strong></p>
|
||||
<p>This doc page is not about a LAMMPS input script command, but about
|
||||
manifolds, which are generalized surfaces, as defined and used by the
|
||||
USER-MANIFOLD package, to track particle motion on the manifolds. See
|
||||
the src/USER-MANIFOLD/README file for more details about the package
|
||||
and its commands.</p>
|
||||
<p>Below is a list of currently supported manifolds by the USER-MANIFOLD
|
||||
package, their parameters and a short description of them. The
|
||||
parameters listed here are in the same order as they should be passed
|
||||
to the relevant fixes.</p>
|
||||
<table border="1" class="docutils">
|
||||
<colgroup>
|
||||
<col width="5%" />
|
||||
|
|
|
@ -228,7 +228,7 @@ see the doc page for individual styles to see which potentials support
|
|||
these options. If N is non-zero, a table of length 2^N is
|
||||
pre-computed for forces and energies, which can shrink their
|
||||
computational cost by up to a factor of 2. The table is indexed via a
|
||||
bit-mapping technique <a class="reference internal" href="pair_table_rx.html#wolff"><span class="std std-ref">(Wolff)</span></a> and a linear interpolation is
|
||||
bit-mapping technique <a class="reference internal" href="#wolff"><span class="std std-ref">(Wolff)</span></a> and a linear interpolation is
|
||||
performed between adjacent table values. In our experiments with
|
||||
different table styles (lookup, linear, spline), this method typically
|
||||
gave the best performance in terms of speed and accuracy.</p>
|
||||
|
@ -316,8 +316,6 @@ a pair style will not work, because the
|
|||
<a class="reference internal" href="kspace_style.html"><span class="doc">kspace_style</span></a> command requires a Kspace-compatible
|
||||
pair style be defined.</p>
|
||||
<hr class="docutils" />
|
||||
<div class="section" id="use-of-special-keyword">
|
||||
<h3>Use of <em>special</em> keyword</h3>
|
||||
<p>The <em>special</em> keyword allows to override the 1-2, 1-3, and 1-4
|
||||
exclusion settings for individual sub-styles of a
|
||||
<a class="reference internal" href="pair_hybrid.html"><span class="doc">hybrid pair style</span></a>. It requires 4 arguments similar
|
||||
|
@ -343,7 +341,6 @@ usually a sufficient workaround in this case without causing a
|
|||
significant error.</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<hr class="docutils" />
|
||||
<div class="section" id="restrictions">
|
||||
<h2>Restrictions</h2>
|
||||
|
|
File diff suppressed because one or more lines are too long
|
@ -126,26 +126,20 @@
|
|||
|
||||
<div class="section" id="lammps-github-tutorial">
|
||||
<h1>LAMMPS GitHub tutorial</h1>
|
||||
<div class="section" id="written-by-stefan-paquay">
|
||||
<h2>written by Stefan Paquay</h2>
|
||||
<p><strong>written by Stefan Paquay</strong></p>
|
||||
<hr class="docutils" />
|
||||
<p>This document briefly describes how to use GitHub to merge changes
|
||||
into LAMMPS using GitHub. It assumes that you are familiar with
|
||||
<p>This document briefly describes how to use GitHub to merge changes you
|
||||
make into LAMMPS, using GitHub. It assumes that you are familiar with
|
||||
git. You may want to have a look at the <a class="reference external" href="http://git-scm.com/book/">Git book</a> to reacquaint yourself.</p>
|
||||
</div>
|
||||
</div>
|
||||
<hr class="docutils" />
|
||||
<div class="section" id="making-an-account">
|
||||
<h1>Making an account</h1>
|
||||
<p><strong>Making an account</strong></p>
|
||||
<p>First of all, you need a GitHub account. This is fairly simple, just
|
||||
go to <a class="reference external" href="https://github.com">GitHub</a> and create an account by clicking
|
||||
the <a href="#id1"><span class="problematic" id="id2">``</span></a>Sign up for GitHub’’ button. Once your account is created, you
|
||||
can sign in by clicking the button in the top left and filling in your
|
||||
username or e-mail address and password.</p>
|
||||
</div>
|
||||
<hr class="docutils" />
|
||||
<div class="section" id="forking-the-repository">
|
||||
<h1>Forking the repository</h1>
|
||||
<p><strong>Forking the repository</strong></p>
|
||||
<p>To get changes into LAMMPS, you need to first fork the repository. At
|
||||
the time of writing, LAMMPS-ICMS is the preferred fork. Go to <a class="reference external" href="https://github.com/lammps/lammps">LAMMPS on GitHub</a> and make sure branch is
|
||||
set to <a href="#id3"><span class="problematic" id="id4">``</span></a>lammps-icms’‘, see the figure below.</p>
|
||||
|
@ -157,14 +151,11 @@ changes in this fork and later file <em>pull requests</em> to allow the
|
|||
upstream repository to merge changes from your own fork into the one
|
||||
we just forked from. At the same time, you can set things up, so you
|
||||
can include changes from upstream into your repository.</p>
|
||||
</div>
|
||||
<hr class="docutils" />
|
||||
<div class="section" id="adding-changes-to-your-own-fork">
|
||||
<h1>Adding changes to your own fork</h1>
|
||||
<p><strong>Adding changes to your own fork</strong></p>
|
||||
<p>Before adding changes, it is better to first create a new branch that
|
||||
will contain these changes, a so-called feature branch.</p>
|
||||
<div class="section" id="feature-branches">
|
||||
<h2>Feature branches</h2>
|
||||
<p><strong>Feature branches</strong></p>
|
||||
<p>Since LAMMPS is such a big project and most user contributions come in
|
||||
small portions, the most ideal workflow for LAMMPS is the so-called
|
||||
<a href="#id5"><span class="problematic" id="id6">``</span></a>Feature branch’’ workflow. It is explained in great detail here:
|
||||
|
@ -210,8 +201,7 @@ $ git add doc/fix_manifoldforce.txt doc/user_manifolds.txt
|
|||
</div>
|
||||
<p>The “-m” switch is used to add a message to the commit. Use this to
|
||||
indicate what type of change was commited.</p>
|
||||
<div class="section" id="wisdom-by-axel">
|
||||
<h3>Wisdom by Axel:</h3>
|
||||
<p><strong>Wisdom by Axel</strong></p>
|
||||
<p><em>“Do not use “git commit -a”. the -a flag will automatically include
|
||||
*all</em> modified or new files. mercurial does that and it find it
|
||||
hugely annoying and often leading to accidental commits of files you
|
||||
|
@ -262,19 +252,13 @@ is now up to the maintainer(s) of the upstream repository to
|
|||
incorporate the changes into the repository and to close the pull
|
||||
request.</p>
|
||||
<img alt="_images/tutorial_pull_request4.png" class="align-center" src="_images/tutorial_pull_request4.png" />
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<hr class="docutils" />
|
||||
<div class="section" id="additional-changes">
|
||||
<h1>Additional changes</h1>
|
||||
<p><strong>Additional changes</strong></p>
|
||||
<p>Before the pull request is accepted, any additional changes you push
|
||||
into your repository will automatically become part of the pull
|
||||
request.</p>
|
||||
</div>
|
||||
<hr class="docutils" />
|
||||
<div class="section" id="after-a-merge">
|
||||
<h1>After a merge</h1>
|
||||
<p><strong>After a merge</strong></p>
|
||||
<p>When everything is fine the feature branch is merged into the LAMMPS
|
||||
repositories:</p>
|
||||
<img alt="_images/tutorial_merged.png" class="align-center" src="_images/tutorial_merged.png" />
|
||||
|
|
|
@ -620,5 +620,3 @@ USER/atc/man_unfix_flux.html
|
|||
USER/atc/man_unfix_nodes.html
|
||||
USER/atc/man_write_atom_weights.html
|
||||
USER/atc/man_write_restart.html
|
||||
|
||||
|
||||
|
|
Loading…
Reference in New Issue