Helix Orientation and Displacement Analysis - k-ngo/CATMD GitHub Wiki
Helix Orientation and Displacement Analysis
Overview and Methodology
What It Does
This script tracks how a helical segment changes orientation and position over time in a molecular dynamics simulation. It quantifies bending, twisting, and translational movements relative to a reference frame.
How It Works
- Objective: Detect and characterize conformational changes of a helix over time.
- Process:
- Tilt: Measures the angle between the helix axis and its orientation in a reference frame — useful for detecting bending or rocking motions.
- Rotation: Tracks angular displacement of a side chain atom around the helix axis — ideal for detecting twisting.
- Displacement: Measures spatial deviation of the helix from its reference position using either:
- Centroid: Compares center-of-mass positions.
- Closest Atom: Uses maximum per-atom displacement, sensitive to local deviations.
Configuration and Inputs
Prerequisites
- Requires a loaded trajectory.
Key Configuration Options
-
Selections:
helix_sel
: Atom group defining the helix (e.g.,segid VSD and resid 200-240
).rotation_ref_sel
: Atom(s) in a specific residue to track rotational motion (e.g.,name CB and resid 205
).helix_name
: Label for plot output.
-
Analysis Parameters:
ref_frame
: Frame used as the reference state (default =begin_frame
).distance_method
: Either'Centroid'
or'Closest Atom'
to define helix displacement.plot_rolling_average
: Whether to overlay a smoothed version of the data.
-
Visualization Settings:
- Titles, axis labels, dimensions, and rolling window size are customizable for all subplots.
Outputs
-
Combined Plot:
*_Analysis.png
— Three-panel figure showing:- Tilt Angle (°) over time.
- Rotation Angle (°) relative to the helix axis (if a reference is provided).
- Max Displacement (Å) of the helix from its reference state.
-
Console Output:
- Frame processing progress, selection details, and file save confirmation.
Interpreting the Results
Tilt Angle
- Stable Tilt: Indicates consistent orientation.
- Fluctuating Tilt: Suggests bending or rocking motion of the helix axis.
Rotation Angle
- Monotonic Drift: Continuous rotation around the axis (e.g., twisting).
- Oscillating Rotation: Back-and-forth torsional movement.
Displacement
- Low Values: Minimal deviation from the initial structure.
- Sharp Spikes: Sudden structural shifts or kinks.
Example Scenarios
Voltage-Sensing Domain Rotation
- Scenario: VSD rotates during membrane depolarization.
- Observation: Progressive increase in rotation angle, stable tilt.
- Interpretation: Consistent axial twist without reorienting the helix.
Helix Bending or Kinking
- Scenario: Local bending due to residue mutation or force application.
- Observation: Increasing tilt and displacement, with minimal rotation.
- Interpretation: Helix is bending rather than twisting.
Ligand-Induced Shift
- Scenario: Ligand binding displaces the helix.
- Observation: Step-like change in displacement plot at a specific time.
- Interpretation: Ligand causes repositioning of the helix.
Usage Tips
- Rotation Reference: Use a stable side chain (e.g.,
CB
) near the middle of the helix for best rotational tracking. - Displacement Method:
- Use
'Closest Atom'
to detect localized changes like kinks. - Use
'Centroid'
for smoother, overall drift tracking.
- Use
- Smoothing: Enable
plot_rolling_average=True
with a smallrolling_window
for noisy trajectories. - Frame Selection: Ensure
ref_frame
is representative of the expected "rest" state.