MolViewSpec extension
MolViewSpec (MVS) is a tool for standardized description of reproducible molecular visualizations shareable across software applications.
MolViewSpec provides a generic description of typical visual scenes that may occur as part of molecular visualizations. A tree format allows the composition of complex scene descriptors by combining reoccurring nodes that serve as building blocks.
More sources:
- Developer documentation for Mol* MolViewSpec extension
- MolViewSpec home page
- Python library
molviewspecfor building MolViewSpec views - Python library
molviewspecin action
MolViewSpec data structure
MolViewSpec is based on a tree format, i.e. a molecular view is described as a tree where individual node types represent common data operations needed to create the view (e.g. download, parse, color). A MolViewSpec tree can be stored in .mvsj file format. Refer to the developer documentation for more details or see a few examples here.
MolViewSpec extension in Mol* Viewer
There are multiple ways to load MolViewSpec views (.mvsj files) into Mol* Viewer:
-
Drag&drop support: The easiest way to load a MVS view is to drag a
.mvsjfile and drop it in a browser window with Mol* Viewer.Test with this file: 1cbs.mvsj (make sure to save it with
.mvsjextension, not.txt)
-
Load via menu: Another way to load a MVS view is to use "Download File" or "Open Files" action, available in the "Home" tab in the left panel. For these actions, the "Format" parameter must be set to "MVSJ" (in the "Miscellaneous" category) or "Auto".
Test with this URL: https://raw.githubusercontent.com/molstar/molstar/master/examples/mvs/1cbs.mvsj
-
URL parameters: Mol* Viewer supports
mvs-url,mvs-data, andmvs-formatURL parameters to specify a MVS view to be loaded when the viewer is initialized.mvs-urlspecifies the address from which the MVS view should be retrieved.mvs-dataspecifies the MVS view data directly. Keep in mind that some characters must be escaped to be used in the URL. Also beware that URLs longer than 2000 character may not work in all browsers.mvs-formatspecifies the format of the MVS view data (frommvs-urlormvs-data). The only allowed (and default) value ismvsj, as this is currently the only supported format.
Examples of URL parameter usage:
-
mvs-url: -
mvs-data: