Skip to content
/ msr Public

Microstate Sparse Reconstruction (MSR): a backmapping method that recovers all-atom structures from reduced/coarse-grained variables

Notifications You must be signed in to change notification settings

anabiman/msr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

51 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Microstate Sparse Reconstruction

Microstate sparse reconstruction (MSR) is a backmapping algorithm that recovers all-atom structures from coarse-grained/reduced variables. MSR uses topological information (connectivity) of a given macromolecule and methods from optimization and inverse theory to rapidly achieve this recovery. The method has also been shown to scale well for much larger systems such as an assembly of proteins.

The schematic below shows how MSR can be used to reconstruct a physically meaningful structure of a strongly perturbed alanine dipeptide.

Authors

Andrew Abi-Mansour and Peter Ortoleva Department of Chemistry, Indiana University, Bloomington

Please consider citing the following paper if your find this code useful in your research:

DOI for Citing MSR

Prerequisites

The 2 core requirements are:

If you want to use the python API, you must install:

Python API

Run make python to compile MSR as a library with a python API. A sample script (swm_example.py) is provided in the examples directory on how to use the python API.

C++ CLI

If you prefer compiling MSR as an executable, simply run make to generate a static executable (MSR.a) with the following CLI:

  • --ref: path to input reference all-atom coordinates
  • --indices: path to input bond/angle indices
  • --lengths: path to input bond/angle lengths
  • --cg: path to input CG coordinates
  • --cgOP: path to the coarse-graining operator (matrix of size natoms x ncg) file
  • [--out]: output filename of recovered all-atom positions
  • [--tol]: tolerance set for the atomic displacement, below which convergence is assumed to be achieved, defaults to 0.1A
  • [--maxiter]: max number of iterations the solver performs before giving up, defaults to 100

Feedback

Email me: andrew [at] gmail [dot] com

About

Microstate Sparse Reconstruction (MSR): a backmapping method that recovers all-atom structures from reduced/coarse-grained variables

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published