Skip to content

MagnusBertelsen/gmx_wheel_plus

Repository files navigation

gmx_wheel_plus

gmx_wheel+ is a tool for analysing and visualizing the orientation of helical antimicrobial peptides based on molecular dynamics simulations trajectories generated using the Gromacs simulation suite.

Purpose of the tool:

The general purpose of the tool is to generate more accurate helical wheel "like" projections of antimicrobial peptide based on more advanced in silico data rather than just the primary sequence.

The amphiphilic structure of the helical region of antimicrobial peptides is key to their activity, which has led helical wheel projection to be one of the most simple but effective tools for researches to use in their design process. The simple and clear projection of the structure of the peptide allows one to easily analyse the residue composition and select residues for modification when designing new analogs.

With the lowering of the barrier of entry to more advanced techniques such as molecular dynamic simulations, much more advanced in silico data can be generated for an antimicrobial peptide before synthesis and in vitro evaluation. However, the data still needs to be analysed and visualized in ways to best facilitate the design process.

How it works:

The gmx_wheel+ tool can be used to analyse the orientation of helical peptides after they have been inserted into a phospholipid bilayer in their surface parallel configuration. The angles between the normal of the bilayer (Z-axis) and the planes created based on the centre of geometry of start of the helix, end of the helix and each amino acid side chain are estimated for each frame using the gmx gangle function. The angle distributions are evaluated using gaussian fits, calculating the mean value and the spread and transformed from 180° to 360° by correcting against three sideways measurements of the angles. In addition, the average maximum distance between the alpha-carbons and the sidechains are calculated for each residue using the gmx pairdist function. The results are graphed using a polar axis bar plot using mathplotlib, with the position of each bar being based on the mean angle for each residue, the width of each bar being based on 2x the standard deviation of the gaussian distrubution and the hight is based on the average max protrusion of the sidechain.

How to use:

Copy the gmx_wheel+.py script into a folder containing the following files:

  1. The trajectory file of the peptide-bilayer simulation.

  2. The tpr file for the peptide-bilayer simulation.

  3. A plain text file named sequence.dat, containing only the peptide sequence in single letter code.

The script can be run through the terminal using different arguments to customise the inputs, functions and outputs.

Information related to each argument can be seen using the –h flag.

The scripts have several modes that can be selected using –m, either running the full script or individual parts such as the trajectory processing, analysis or graphing only.

Names of the input files are specified using the –s and –f flags. Start and end times of the period of the trajectory that should be analysed are specified using –b and –e. Make sure that the peptide has reached an equilibrium position within the bilayer leaflet before starting the analysis. The start and end point of the helical part of the peptide can be specified using the –hs and –he flags. Make sure that these points and the 3 residues after (-hs) and before (-he) are fully helical such that the centre of geometry lines up with the helical axis. Non-ideal helical residues outside of the range are still analysed and shown in the figure if they are within the projection range set by –ps and –pe.

An example of the command line input could look like this:

python3 gmx_wheel+_v1.0.py -m full -s md_1_500.tpr -f md_1_500.xtc -b 200000 -e 500000 -hs 2 -he 12 -ps 1 –pe 14

Example output:

Below is an example of the output for the 14-residue antimicrobial peptide Smp14a, inserted into a 1:1 DOPC:DOPG bilayer.

v3

Blue resiudes are cationic, green residues are polar and grey resiudes are hydrophobic.

Version 1.1:

New in version 1.1 is the ability to generate the wheel projections based on data from three repeat simulations. This is done using the –m triplicate flag. Each trajectory must be analysed individually first, to generate the individual results files containing the angles. Thereafter the results can be combined using the –m triplicate flag and the–r, -r2, -r3 flags to specify each of the results files (also need the sequence.dat file). A new wheel projection is generated based on the following:

Bar hight = Average maximum sidechain protrusion from the alpha-carbon 

Bar orientation = Centre point between max and min angle from the three simulations 

Bar spread = Difference between max and min angle + 1x the average standard deviation of the three angle distributions  

An example of the command line input could look like this:

python3 gmx_wheel+_v1.1.py -m triplicate -ps 1 –pe 14 –r results1.txt -r2 results2.txt -r3 results3.txt

Example output:

combined

Left = Projections for each of the three repeat simulations. Right = Combined projection using the triplicate mode.

Version 1.2:

New in version 1.2 is the ability to investigate shifts in the sidechain orientations between two data sets. This can both be between two identical peptide or a parent peptide and an analog, using either single or triplicate trajectory data sets. The two data sets are compared and the differences in the sidechain protrusion lengths and orientations are calculated. This is done using the –m difference flag, with the –r and –r2 flags used to specify the data sets. A new wheel projection is generated based on the following:

Bar hight = Average maximum sidechain protrusion from the alpha-carbon of data set 2 (-r2) 

Bar pattern = Indication of if the protrusion length has changed compared to the original data set (-r). Dots = greater than 5% increase. Crosses = greater than 5% decrease. The cutoff (default = 5%) can be changed using the –cutoff flag. 

Bar orientation = Centre point between the angles from the two data sets. 

Bar spread = Difference between the angles from the two data sets (each edge of the bar corresponds to the centre point of each angle distribution).  

Bar colour = Indication of the directions of the angle shift. Red = clockwise shift, Blue = counterclockwise shift. 

Bar labelling = Scripts checks the residues from the data sets/results files. If a residue is changed the label will be updated to include both residues (<position number><original residue>/<new residue>).  

An example of the command line input could look like this:

python3 gmx_wheel+_v1.2.py -m difference -r results1.txt -r2 results2.txt -ps 1 -pe 14

Example output:

combined

Left = projection of data set 1, right = projection of data set 2, centre = projection of difference. On average the helix has shifted 10.13 degrees clockwise in data set 2 relative to data set 1. The results for the position 4 residue were manually edited to show how the protrusion length decrease and labeling of modified residues would look.