A molecular scene can look complete while still being difficult to interpret. You may see atoms, surfaces, fields, and simulation controls in the same document—and wonder which parts describe the molecule, which parts only change its appearance, and which parts affect its motion. That confusion matters: choosing the wrong kind of model can send you looking in the wrong place when something is missing or behaving unexpectedly.
A useful first step is to ask what role an object plays. In SAMSON, nanosystems are described using five model categories. They are not five competing ways to show the same thing; each describes a different aspect of the system.
Start with the structure
Structural models describe geometry and topology. They typically contain atoms and bonds, and may organize them into higher-level nodes such as molecules, chains, and residues. If your question is “What is this molecule made of, and how are its parts connected?”, start here.
This distinction helps when a visual representation is present but the underlying molecular organization is not what you expected. A surface or ribbon can make a structure easier to see, but it is a separate model category from the structural nodes that describe atoms, bonds, and organization.
Separate appearance from molecular data
Visual models provide graphical representations. Examples include protein secondary-structure representations, Gaussian surfaces, electron-density isosurfaces, and volumetric electrostatic-field representations. They help you see information, but they are not interchangeable with the structural model itself.
SAMSON’s default visual models can be applied to selected nodes, or to the whole document when nothing is selected. You can add them from the selection’s context toolbar, through Visualization > Add > Visual model, or with Ctrl/Cmd + Shift + V. Some visual models expose parameters in the Inspector: select the visual model in the Document view, then choose Inspect from its context menu.

That separation is useful when troubleshooting a display. If the molecular organization is right but its appearance is not, investigate the visual model and its settings. If the atoms, bonds, or hierarchy are wrong, changing the visual model addresses the wrong layer.
Ask whether the system can move
Dynamical models indicate where the degrees of freedom are in structural nodes. For example, a particle-system dynamical model assigns three translational degrees of freedom to each atom. Dynamical models describe the dynamical state and store positions, momenta, and masses.
Interaction models describe energies and forces associated with a dynamical model. Examples include Lennard-Jones, spring, elastic-network, and universal force-field models. An interaction model provides forces corresponding to the dynamical model’s degrees of freedom; for a particle system, it can provide the total energy and the force on each particle.
These two categories answer different questions. A dynamical model says which motion variables are represented; an interaction model says what energies and forces act on them. When thinking about a simulation, keeping those roles distinct makes it easier to identify whether your question is about the system’s degrees of freedom or its physical interactions.
Keep other information in its own category
Property models represent properties that do not belong to the first four categories. Examples include a protein’s gyration radius, a scalar field such as electron density, a vector field such as an electrostatic field, or a function. A useful check is to ask whether the information describes structure, appearance, motion, or forces. If not, it may be a property.
State updaters are related to modeling and simulation, but they are not one of the five model categories. They implement methods for advancing states, including minimization algorithms, Monte Carlo methods, and molecular dynamics algorithms. In short: models describe aspects of a nanosystem; a state updater describes a method for changing its state.
When an object in the Document view is unclear, try this quick classification: Does it define atoms or organization? It is structural. Does it provide a graphical representation? It is visual. Does it describe degrees of freedom and state? It is dynamical. Does it provide energies and forces? It is an interaction model. Does it describe another property? It is a property model. Does it advance the state during a simulation? It is a state updater.
For the full reference and related workflows, see SAMSON model categories.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.
