morph_states
Validate topology and generate morphs only between states with shared atom correspondence. Use to animate deformation ensembles while refusing ill-posed morphs for independently modelled structures.
Instructions
Interpolate between states, refusing when interpolation is ill-posed.
The value here is the refusal, not the interpolation — PyMOL morphs natively. A morph is only meaningful when every state shares a topology, so that atom i in state 1 is the same atom as atom i in state 2. That holds for a deformation-model ensemble (3DFlex, DynaMight). It does not hold for volumes reconstructed and modelled independently, and a morph across those animates a correspondence nobody established.
Note that cmd.morph is Incentive-only. On open-source PyMOL the topology check still runs and reports; only the interpolation is unavailable.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name for the morph object (defaults to "<obj_name>_morph") | |
| steps | No | Number of interpolated frames to generate (default 30) | |
| obj_name | Yes | Multi-state PyMOL object name to interpolate | |
| validate_only | No | Run the topology check and report, without creating a morph |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |