Gaussian, wave, and exponential surfaces
above gaussian ux uy uz ax ay az d0 amplitude center sigma
below gaussian ux uy uz ax ay az d0 amplitude center sigma
above sin ux uy uz ax ay az d0 amplitude wavelength phase
below sin ux uy uz ax ay az d0 amplitude wavelength phase
above cos ux uy uz ax ay az d0 amplitude wavelength phase
below cos ux uy uz ax ay az d0 amplitude wavelength phase
above exponential ux uy uz ax ay az d0 amplitude center rate
below exponential ux uy uz ax ay az d0 amplitude center rateThese generalize plane into a curved half-space up·x = h(along·x): a Gaussian bump, sine/cosine wave, or exponential ramp, extruded along the direction perpendicular to along (within the plane orthogonal to up). (ux,uy,uz) (up) plays the same role as plane's normal and is used un-normalized, exactly as there; (ax,ay,az) (along) picks the direction the profile varies along and is normalized internally, so it need not be given as a unit vector. d0 is the base offset (as plane's d); with amplitude = 0 each of these degenerates exactly to plane. cos is sin with its phase shifted by pi/2 internally — there is no separate underlying shape.
- gaussian:
h(s) = d0 + amplitude * exp(-(s - center)^2 / (2*sigma^2)) - sin / cos:
h(s) = d0 + amplitude * sin(2*pi/wavelength * s + phase)(cosaddspi/2tophase) - exponential:
h(s) = d0 + amplitude * exp(rate * (s - center))
where s = along·x (using the normalized along).
Example
390 water molecules (about 1 g/mL) in a box, above a Gaussian bump of height 6 Å and width 4 Å along x:
structure water.pdb
number 390
inside box -15. -15. 0. 15. 15. 15.
above gaussian 0. 0. 1. 1. 0. 0. 0. 6. 0. 4.
end structureThe same system, packed with the Julia API and shown with the visualize function of PDBTools.jl:
using Packmol, PDBToolswater = structure_type("water.pdb"; number = 390, constraints = [ InsideBox([-15., -15., 0.], [15., 15., 15.]), AboveGaussian([0., 0., 1.], [1., 0., 0.], 0., 6., 0., 4.), ],)system = PackmolSystem([water]; tolerance = 2.0, output = "gaussian.pdb")packmol(system)visualize(get_atoms(system); unitcell = UnitCell([30., 30., 15.]), unitcell_origin = [-15., -15., 0.], rotate = [(:z, 30), (:x, -70)],)Example: a periodic wavy monolayer
A monolayer of POPC following one period of a sine wave of amplitude 6 Å along x, in an orthorhombic periodic cell whose side in x is the wavelength (60 Å), so that the surface is continuous across the periodic boundaries. The nitrogen atoms of the heads (atom 1) are within 2 Å of the surface, and the ends of the two chains (atoms 88 and 131) at least 22 Å above it. Water fills the cell below the heads and above the chains: across the periodic boundary in z, the two water structure blocks form a single layer, 30 Å thick. The surfaces are vertical translations of each other, so each water region has the volume of a flat slab (60 × 40 Å, 16 and 14 Å thick), filled at 1 g/mL. The area of the wavy surface is about 2780 Ų, about 66 Ų for each of the 42 lipids.
tolerance 2.0
output wavy_monolayer.pdb
pbc 0. 0. -20. 60. 40. 44.
structure popc.pdb
number 42
atoms 1
above sin 0. 0. 1. 1. 0. 0. -2. 6. 60. 0.
below sin 0. 0. 1. 1. 0. 0. 2. 6. 60. 0.
end atoms
atoms 88 131
above sin 0. 0. 1. 1. 0. 0. 22. 6. 60. 0.
end atoms
end structure
structure water.pdb
number 1280
below sin 0. 0. 1. 1. 0. 0. -4. 6. 60. 0.
end structure
structure water.pdb
number 1120
above sin 0. 0. 1. 1. 0. 0. 30. 6. 60. 0.
end structureThe same system with the Julia API (it packs in a few seconds):
using Packmol, PDBTools# The surface z = 6 sin(2π x / 60)up = [0., 0., 1.]along = [1., 0., 0.]amplitude = 6.wavelength = 60.phase = 0.popc = structure_type("popc.pdb"; number = 42, atom_constraints = [ [1] => AboveSin(up, along, -2., amplitude, wavelength, phase), [1] => BelowSin(up, along, 2., amplitude, wavelength, phase), [88, 131] => AboveSin(up, along, 22., amplitude, wavelength, phase), ],)water_below = structure_type("water.pdb"; number = 1280, constraints = [BelowSin(up, along, -4., amplitude, wavelength, phase)])water_above = structure_type("water.pdb"; number = 1120, constraints = [AboveSin(up, along, 30., amplitude, wavelength, phase)])system = PackmolSystem([popc, water_below, water_above]; tolerance = 2.0, output = "wavy_monolayer.pdb", unitcell = [60. 0. 0.; 0. 40. 0.; 0. 0. 64.], # the cell from (0, 0, -20) to (60, 40, 44) unitcell_center = [30., 20., 12.],)packmol(system)visualize(get_atoms(system); unitcell = UnitCell([60., 40., 64.]), unitcell_origin = [0., 0., -20.], rotate = [(:z, 30), (:x, -70)],)Radial variants
above radial_gaussian ux uy uz cx cy cz d0 amplitude sigma
below radial_gaussian ux uy uz cx cy cz d0 amplitude sigma
above radial_sin ux uy uz cx cy cz d0 amplitude wavelength phase
below radial_sin ux uy uz cx cy cz d0 amplitude wavelength phase
above radial_cos ux uy uz cx cy cz d0 amplitude wavelength phase
below radial_cos ux uy uz cx cy cz d0 amplitude wavelength phase
above radial_exponential ux uy uz cx cy cz d0 amplitude rate
below radial_exponential ux uy uz cx cy cz d0 amplitude rateRadially symmetric counterparts of the three shapes above: the surface is up·x = h(r), where r is the radial distance from the axis line through center ((cx,cy,cz)) parallel to up, measured perpendicular to up (exactly as cylinder's radial distance from its axis). up is normalized internally here, since it doubles as that axis. radial_gaussian gives a smooth dome; radial_sin/radial_cos give concentric ripples; and radial_exponential gives a cone-like spike — these last two have a genuine kink at r = 0 (their gradient's radial component is taken to be zero exactly on the axis).
- radial_gaussian:
h(r) = d0 + amplitude * exp(-r^2 / (2*sigma^2)) - radial_sin / radial_cos:
h(r) = d0 + amplitude * sin(2*pi/wavelength * r + phase)(radial_cosaddspi/2tophase) - radial_exponential:
h(r) = d0 + amplitude * exp(rate * r)
Example
430 water molecules (about 1 g/mL) in a box, above a dome of height 6 Å and width 4 Å centered at the origin:
structure water.pdb
number 430
inside box -15. -15. 0. 15. 15. 15.
above radial_gaussian 0. 0. 1. 0. 0. 0. 0. 6. 4.
end structureThe same system, packed with the Julia API:
water = structure_type("water.pdb"; number = 430, constraints = [ InsideBox([-15., -15., 0.], [15., 15., 15.]), AboveRadialGaussian([0., 0., 1.], [0., 0., 0.], 0., 6., 4.), ],)system = PackmolSystem([water]; tolerance = 2.0, output = "radial_gaussian.pdb",)packmol(system)visualize(get_atoms(system); unitcell = UnitCell([30., 30., 15.]), unitcell_origin = [-15., -15., 0.], rotate = [(:z, 30), (:x, -70)],)The other radial shapes take the same arguments as in the input file, in the same order: AboveRadialSin(up, center, d0, amplitude, wavelength, phase), AboveRadialExponential(up, center, d0, amplitude, rate), and their Below counterparts.