Simulation design: the values the names do not carry#
A parser in polyphys.manage.parser records what an artifact’s name
carries, plus a few values it fixes itself. The rest of a study’s design is
set in the LAMMPS input scripts that ran its simulations: the interaction
strengths, the cutoffs, the bonds and angles, the masses, and the
thermostat. This page lists those values for each study that has a parser.
The values come from the production inputs of the research code that ran the simulations, and from the generator scripts that wrote each run’s input. Where those inputs differ between sets of simulations, the page gives each value and the set that used it. The page describes the scripts; it has not been checked against the copy of the input kept in each run’s directory.
Notation and units#
Every input uses LAMMPS reduced units (units lj): lengths are in the
monomer diameter, energies in the Lennard-Jones (LJ) strength
\(\epsilon = 1\), masses in the monomer mass, and the thermostat temperature
is \(k_B T = \epsilon\).
- \(a_m = 1\), \(a_l\), \(a_c\)
The diameters of a monomer (the small monomer of a two-size chain), a large monomer (keyword
al), and a crowder (keywordac).- \(\epsilon_{ij}\), \(\sigma_{ij}\), \(r_{c,ij}\)
The strength, size, and cutoff of the LJ interaction between species \(i\) and \(j\).
- \(\epsilon_w\), \(\sigma_w\), \(r_{c,w}\)
The strength, size, and cutoff of the LJ interaction between the cylindrical wall and one species.
- \(K\), \(R_0\), \(r_0\), \(\theta_0\)
The constants of a bond or angle potential, in the LAMMPS form given with each potential below.
TransFociCyl#
TransFociCyl: a ring of \(n_s\) small and
\(n_l\) large monomers, with crowders, in a cylinder that is periodic along
its axis.
Value |
Setting |
|---|---|
Wall potential |
|
Wall–small monomer |
\(\epsilon_w\) = keyword |
Wall–large monomer |
\(\epsilon_w\) = keyword |
Wall–crowder |
\(\epsilon_w = 1\), \(\sigma_w = (1 + a_c)/2\), \(r_{c,w} = 2^{1/6}\sigma_w\) |
|
5 and 5 in every simulation |
Bonds |
small–small and small–large FENE bonds, each with its own \(\sigma_{ij}\) |
Masses |
small monomers 1, large monomers \(m_l\) (keyword |
TransFociCub#
TransFociCub: the TransFociCyl chain and
crowders in a periodic cube, so there is no wall. The other values are those
of TransFociCyl, with one exception: in the set of simulations with
\(a_l \in \{5, 6\}\) from May 2024, every pair is cut at
\(r_{c,ij} = \sigma_{ij}\), not at \(2^{1/6}\sigma_{ij}\), and its energy is
shifted to zero at the cutoff. Those pairs are still purely repulsive, but
only the part of the repulsion with \(r < \sigma_{ij}\) is kept.
HnsCub and HnsCyl#
HnsCub and
HnsCyl: a ring of \(N\) monomers, \(n_h\) H-NS
proteins, and crowders, in a periodic cube or in a cylinder that is periodic
along its axis. Each protein is a core of size 1 bonded to two poles. The
particle types are the monomer (1), the H-NS pole (2), the H-NS core (3),
and the crowder (4). Every pair energy is shifted to zero at its cutoff.
Pair |
Setting |
|---|---|
Monomer–pole |
\(\epsilon\) = 1 in equilibration and 29 in production, \(\sigma = 0.535\), \(r_c = 0.685 = 1.28\,\sigma\): the one attractive pair |
Pole–pole |
\(\epsilon = 1\), \(\sigma = 0.178\), \(r_c = 0.2\) |
Pole–core, pole–crowder |
no coefficients written, so LAMMPS mixes them by its default geometric rule (LAMMPS): \(\epsilon = 1\), \(\sigma = \sqrt{0.178\,a_j}\), \(r_c = \sqrt{0.2\,r_{c,jj}}\), purely repulsive. A comment in the input says these pairs do not interact. |
Core–crowder |
\(\epsilon = 1\), \(\sigma = (1 + a_c)/2\), \(r_c = 2^{1/6}\sigma\), whatever the name’s |
Other pairs |
the shared choices |
Value |
Setting |
|---|---|
Wall (HnsCyl) |
style |
Bonds |
monomer–monomer FENE; pole–core |
Angles |
|
Masses |
monomers, poles, and cores 1; crowders \(a_c^3\) |
Thermostat |
damping time 1, not 10; for crowders multiplied by \(m/a_c = a_c^2\), so their friction \(m/a_c^2 = a_c\) grows with their size |
Time steps |
equilibration 0.01; production 0.005 |
References#
The LAMMPS documentation, https://docs.lammps.org/, for the forms of the
potentials and the meaning of the commands:
pair_style lj/cut,
pair_modify (mixing rules and
the energy shift; the default mixing rule is geometric),
bond_style fene,
bond_style harmonic,
angle_style harmonic,
fix langevin,
fix wall/region, and
fix spring.