SimAtomic

Scientific reference

What SimAtomic runs.
And what the results mean.

The current UnoMD quickrun workflow prepares a soluble protein, optionally with one prepared small molecule, and runs classical all-atom molecular dynamics in explicit water.

Start with a supported system

Upload the receptor as PDB or CIF, plus an optional separate SDF containing one chemically valid ligand already positioned relative to the receptor. Supply the biological assembly you intend to simulate. SimAtomic does not retrieve database structures, reconstruct assemblies from symmetry, or generate a docking pose.

SystemCurrent scope
Standard soluble proteinSupported, including ordinary multiple protein chains with unambiguous chain identifiers.
Protein + one small moleculeSupported for a posed 3D SDF with chemistry covered by OpenFF. Prepare ligand protonation, tautomer, formal charge, and bond orders before upload.
Disulfides and ordinary cysteine statesCYS, CYX, and CYM are distinguished using hydrogens and SG–SG connectivity. Inspect the prepared bonds and protonation.
Free calciumHandled as monatomic Ca²⁺. This does not model a coordinated metal center.
Specialized biological chemistryMembranes, nucleic acids, cofactors, coordinated metals, covalent ligands, modified residues, and glycans are outside the current automated preparation scope.

From structure to trajectory

1. Repair & protonate2. Solvate3. Parameterize4. Minimize & equilibrate5. Production MD6. Image trajectory

1. Receptor repair and protonation

CIF is converted to PDB with Open Babel; some mmCIF metadata and long chain identifiers can be lost. PDBFixer adds missing heavy atoms in standard residues. Missing terminal sequence gaps are dropped rather than rebuilt; only limited internal gaps can be modeled. Large missing loops or domains need external preparation.

Crystallographic waters are removed and fresh solvent is added later. Receptor protonation is assigned with pdb2pqr at the configured pH, followed by hydrogen handling during solvation. Existing curated hydrogen and protonation assignments are not guaranteed to survive. Catalytic and metal-binding residues require particular scrutiny.

2. Ligand merge, water, and ions

The ligand SDF is used as supplied; the receptor pH setting does not choose its protonation or tautomer. OpenFF may infer missing hydrogens from valence, which does not establish the intended chemical microstate. The combined solute is oriented and placed in a periodic hexagonal prism with 1.2 nm padding by default, neutralizing ions, and 0.15 M NaCl.

3. Force-field parameterization

The pipeline constructs the molecular topology and OpenMM system, including atom types, partial charges, bonded interactions, and nonbonded forces. Inspect the prepared coordinates and topology before interpreting a trajectory. Solvent clash cleanup does not repair an incorrect ligand pose or chemistry.

4–6. Relaxation, production, and imaging

Restrained energy minimization is followed by heating and equilibration. Production uses Langevin dynamics with NVT as the default and optional NPT pressure control. Periodic imaging wraps the trajectory for inspection and analysis. Backend restart and selected-residue harmonic restraint options are available when exposed by the chosen workflow.

Preparation determines the simulated chemistry. Minimization and production MD do not repair missing force-field templates, replace a missing cofactor, correct protonation, or fix an unsupported metal site.

The physical model

Classical MD propagates atomic coordinates using a parameterized potential energy function. The standard path uses fixed-charge, all-atom force fields and explicit solvent. It describes structural motion within that model; it does not model chemical reactions or electronic rearrangement.

ComponentCurrent preparation model
ProteinAmber ff19SB: amber/protein.ff19SB.xml
Water and ionsTIP3P-FB parameters: amber/tip3pfb_standard.xml. The solv_model: tip3p setting selects the solvation geometry; it should not be interpreted as a different final force-field assignment.
Small moleculeOpenFF/SMIRNOFF with AM1-BCC charges. The current preparation path uses OpenFF 2.2.0 during solvation and 2.0.0 during final parameterization for AMBER topology export compatibility. Record the effective version used by the job.
Long-range electrostaticsParticle mesh Ewald (PME), with a 1.0 nm direct-space cutoff in the standard solvated path.
Constraints and massesHydrogen-bond constraints, rigid water, and optional hydrogen mass repartitioning (HMR), using hydrogen mass 4 amu when enabled.
EnsembleNVT maintains particle number, volume, and temperature. Optional NPT adds pressure control so the box volume can fluctuate.

HMR can enable a 4 fs integration step with appropriate constraints and validation. The listed base timestep is 2 fs; enabling HMR alone is not evidence that a particular job used 4 fs. Read the effective run configuration and trajectory timing. For the underlying simulation concepts, see the OpenMM user guide and OpenFF force-field documentation.

Parameters and units

This is a reference for the backend configuration, not a promise that every field is accepted by every interface. The MCP server’s current tool schema determines which fields an assistant can submit. Use the API configuration supplied for your deployment and preserve the effective settings returned with your results.

Preparation and production

ParameterDefault / meaningWhat it controls
solv_pH7.0Automatic receptor protonation; not ligand protonation.
solv_box_buffer1.2 nmSolute padding in the periodic solvent box.
solv_ionic_strength0.15 MAdded salt concentration.
solv_positive_ion
solv_negative_ion
Na+ / Cl−Solvent counter-ions.
integrator_temperature300 KProduction thermostat target.
integrator_timestep0.002 ps (2 fs)Time per integration step. Verify the effective timestep when HMR is used.
integrator_friction1 ps⁻¹ in the supplied configurationLangevin thermostat coupling.
md_stepsNumber of production stepsChoose for the scientific question. The sample configuration’s 1,000 steps is a workflow test.
md_save_intervalSteps between saved framesOutput frequency and trajectory size.
md_npt
md_pressure
false / 1 bar in the supplied configurationEnable pressure control and set its target.
use_hmrtrueRedistribute hydrogen masses; record actual masses and timestep.
emin_force_constant50 kJ mol⁻¹ nm⁻²Harmonic restraints during minimization.
emin_max_iterations50,000Maximum minimization iterations.
platform_nameCPU / CUDAEngine platform. The backend fallback is CPU; hosted GPU workers configure CUDA.
dry_systemfalseOptional dry/vacuum path; outside the standard explicit-water workflow, with no meaningful periodic imaging.

Production duration: steps × timestep in ps ÷ 1,000 = ns. At 0.002 ps per step, 500,000 steps is 1 ns. Saving every 5,000 steps gives a 10 ps interval. These are simulation times, not GPU wall-clock time or a credit estimate.

The MCP submission tool also describes duration inputs simulation_time_ps and simulation_time_ns. Use one duration representation accepted by the current schema; do not send contradictory duration fields.

Analysis settings

WorkflowConfiguration fieldsInterpretation
Trajectory analysisatom_selection, start_frame, tica_lag_time, tica_dimensions, min_cluster_size, min_samplesChoose analyzed atoms, initial frame exclusion, time-lagged projection, and clustering controls. Lag and frame settings depend on saved-frame spacing; confirm the current schema’s units.
End-point binding analysismmpbsa_startframe, mmpbsa_endframe, mmpbsa_stride, mmpbsa_interval, igb, use_decomp, ligand_chain_maskSelect sampled frames, solvent approximation, optional decomposition, and ligand identity. Check masks against the prepared topology.

Advanced backend options include heating and equilibration schedules, barostat frequency, harmonic restraints, state loading, trajectory output, and optional AMBER .prmtop export. Their availability and names depend on the exposed API or MCP schema.

Workflows and scientific interpretation

Protein or protein–ligand MD

Inspect structural stability, fluctuations, contacts, and changes in a supplied pose. Start with a short preparation and stability test, then choose production length and independent replicates for the question. A pose that remains stable briefly is not proof of binding affinity.

Trajectory analysis

Analyze downloaded coordinates with local scripts or submit a follow-up analysis job. Time-lagged independent component analysis (TICA) and clustering can summarize sampled conformations. The result depends on atom selection, frame spacing, sampling length, and model settings; clusters do not establish complete conformational sampling.

Optional MM/PBSA and MM/GBSA

The optional end-point workflow and AMBER topology export currently target protein–ligand systems. These calculations estimate contributions from molecular mechanics and continuum solvation over selected snapshots. An igb setting selects a Generalized Born model, so that calculation is MM/GBSA rather than a Poisson–Boltzmann calculation. Treat the output as an approximate, model-dependent comparison, not a rigorous binding free energy or guaranteed ranking.

Reproducibility

Keep the original and prepared structures, topology, effective force-field versions, protonation choices, configuration, job metadata, logs, trajectory, and analysis scripts. Inspect temperature and energy behavior and assess sampling across time windows and independent runs. Automated job completion confirms execution, not scientific validity.

Input limitations to check explicitly

Ligands, poses, and cofactors

Use one separate posed SDF. Embedded receptor HETATM ligands are not automatically extracted and parameterized; supplying the same ligand in both files is not deduplicated. Multiple ligands, disconnected salts, multi-record or multi-conformer SDFs, 2D coordinates, invalid valence, wrong bond orders, and receptor–ligand clashes require external preparation.

Covalent ligands, organometallics, radicals, heme, FAD, NAD, PLP, Fe–S clusters, and crystallization additives are outside the automated path.

Protein completeness, identifiers, and conformers

Long missing loops, missing domains, CA-only models, inconsistent sequence records, ambiguous residue numbering, duplicate symmetry mates, and long mmCIF chain IDs are not reliably repaired. Alternate locations use the first conformer rather than an occupancy-aware or chemistry-aware choice. Multi-model ensembles are not treated as separate runs. Supply and inspect a single intended assembly.

Metals, water, and protonation

Free Ca²⁺ handling does not preserve bound-metal coordination. Zn, Mg, Mn, Fe, Cu, Ni, Co, and other metal centers are unsupported. Selected catalytic or bridging crystallographic waters cannot be retained through standard preparation. Connectivity records needed for unusual chemistry are not preserved. Exact curated protonation and hydrogens are not guaranteed to survive the automatic receptor preparation.

Nonstandard residues and biological environments

MSE is not automatically converted to methionine. Phosphorylation, glycans, noncanonical amino acids, non-disulfide crosslinks, DNA, RNA, protein–nucleic acid complexes, membranes, lipids, nanodiscs, and micelles are outside the current preparation scope.

Methods outside the current workflow

The standard path does not provide alchemical FEP, enhanced sampling, replica exchange, steered MD, constant-pH MD, polarizable or coarse-grained force fields, chemical bond formation, or membrane-specific ensembles. The optional dry path is not a first-class implicit-solvent workflow.

Discuss a system outside this scope before submitting it. Unsupported components can be dropped during preparation or produce an inappropriate model even when a job completes.