Real time monitoring and visualization of Amber MD simulations
DashMD let's you track the status, temperature, pressure, volume, density, and energy of your currently running simulation in an interactive way. You can also plot the RMSD of your trajectories and visualize them directly with NGL.
DashMD runs on python and a bit of JavaScript, and depends on the following python packages: pandas, bokeh, pytraj
which are all automatically installed as requirements. To install, simply run the following command :
pip install git+https://github.com/cbouy/DashMD.git
Simply type dashmd
in a terminal and it should open a new tab in your web browser.
Start by navigating to the folder containing the mdinfo
file then press on the Load
button (which should turn green if the folder contains a mdinfo
file). The Temperature, Pressure...etc will automatically be read from the mdinfo file and plotted on the corresponding tabs, and the structure from the latest Amber Restart file will be plotted on the View
tab.
In order to plot the Temperature, Pressure...etc. for a specific simulation file, select the MDOUT file (bottom of the Dashboard tab, only files ending in .mdout
or .out
will be listed), then press Plot
. This might take a while depending on the size of the file.
To visualize a structure or plot the RMSD, click on the corresponding tab and select both Topology file and Trajectory file and click on the corresponding button. Only files ending with .top
, .prmtop
, .parm7
or .parm
will be listed for the topology. The RMSD calculation is performed by slicing your trajectory in around 200 frames if possible, for faster calculations.
For the View
tab, only files with the .rst
or .rst7
extension are listed.
For the RMSD
tab, only files ending with .nc
, .netcdf
, or .ncdf
will be listed.
You can select multiple trajectory files to plot by pressing on the Ctrl
key on your keyboard while selecting the trajectories.
You can restrict the atoms selected for RMSD calculation by specifying a mask as specified in the pytraj
documentation here. A protein
keyword has been added for easier selection of all protein residues (it's a substitute for :ALA,ARG
... and all of their protonated forms)
If necessary, more detailed options are available in the command line:
usage: dashmd [-h] [-v] [--port INT] [--update INT] [--default-dir STR]
[--log level]
Monitor and visualize MD simulations from Amber in real time
optional arguments:
-h, --help show this help message and exit
-v, --version Show version and exit
--port INT Port number used by the bokeh server (default: 5100)
--update INT Update rate to check and load new data, in seconds (default: 20)
--default-dir STR Default directory (default: .)
--log level Set level of the logger (default: INFO)