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.
| System | Current scope |
|---|---|
| Standard soluble protein | Supported, including ordinary multiple protein chains with unambiguous chain identifiers. |
| Protein + one small molecule | Supported 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 states | CYS, CYX, and CYM are distinguished using hydrogens and SG–SG connectivity. Inspect the prepared bonds and protonation. |
| Free calcium | Handled as monatomic Ca²⁺. This does not model a coordinated metal center. |
| Specialized biological chemistry | Membranes, nucleic acids, cofactors, coordinated metals, covalent ligands, modified residues, and glycans are outside the current automated preparation scope. |
From structure to 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.
| Component | Current preparation model |
|---|---|
| Protein | Amber ff19SB: amber/protein.ff19SB.xml |
| Water and ions | TIP3P-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 molecule | OpenFF/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 electrostatics | Particle mesh Ewald (PME), with a 1.0 nm direct-space cutoff in the standard solvated path. |
| Constraints and masses | Hydrogen-bond constraints, rigid water, and optional hydrogen mass repartitioning (HMR), using hydrogen mass 4 amu when enabled. |
| Ensemble | NVT 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
| Parameter | Default / meaning | What it controls |
|---|---|---|
solv_pH | 7.0 | Automatic receptor protonation; not ligand protonation. |
solv_box_buffer | 1.2 nm | Solute padding in the periodic solvent box. |
solv_ionic_strength | 0.15 M | Added salt concentration. |
solv_positive_ionsolv_negative_ion | Na+ / Cl− | Solvent counter-ions. |
integrator_temperature | 300 K | Production thermostat target. |
integrator_timestep | 0.002 ps (2 fs) | Time per integration step. Verify the effective timestep when HMR is used. |
integrator_friction | 1 ps⁻¹ in the supplied configuration | Langevin thermostat coupling. |
md_steps | Number of production steps | Choose for the scientific question. The sample configuration’s 1,000 steps is a workflow test. |
md_save_interval | Steps between saved frames | Output frequency and trajectory size. |
md_nptmd_pressure | false / 1 bar in the supplied configuration | Enable pressure control and set its target. |
use_hmr | true | Redistribute hydrogen masses; record actual masses and timestep. |
emin_force_constant | 50 kJ mol⁻¹ nm⁻² | Harmonic restraints during minimization. |
emin_max_iterations | 50,000 | Maximum minimization iterations. |
platform_name | CPU / CUDA | Engine platform. The backend fallback is CPU; hosted GPU workers configure CUDA. |
dry_system | false | Optional 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
| Workflow | Configuration fields | Interpretation |
|---|---|---|
| Trajectory analysis | atom_selection, start_frame, tica_lag_time, tica_dimensions, min_cluster_size, min_samples | Choose 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 analysis | mmpbsa_startframe, mmpbsa_endframe, mmpbsa_stride, mmpbsa_interval, igb, use_decomp, ligand_chain_mask | Select 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.