You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -18,6 +20,91 @@ Simply call the `Start Protein Viewer command`, enter a PDB accession code & awa
18
20
19
21
Right-click on the `.pdb` file in the file editor and select `Launch Protein Viewer from File`
20
22
23
+
**Supported Formats**
24
+
25
+
*`.pdb`
26
+
*`.pdbqt`
27
+
*`.mmcif`
28
+
*`.gro`
29
+
*`.xyz`
30
+
*`.cif`
31
+
*`.mol`
32
+
*`.mol2`
33
+
*`.sdf`
34
+
35
+
## Usage
36
+
*The below is taken from the [Mol\* viewer docs](https://molstar.org/viewer-docs/) which is based on the [RCSB PDB mol* documentation](https://www.rcsb.org/3d-view/molstar/help/getting-started) thanks to the generosity of RCSB PDB and Dr. Shuchismita Dutta.*
**3D Canvas**: This is the space where a PDB structure is displayed for manipulation in three dimensions (3D). It is located on the left side of the screen.
41
+
42
+
**Toggle Menu**: This menu provides users quick access to some commonly used operations for the 3D canvas. It is located towards the right side of the 3D canvas and has the following functions.
43
+
44
+
45
+
| Function | Description | Icon |
46
+
|---|---|---|
47
+
|Reset Camera | Centers and resets the view of the structure on the 3D canvas ||
48
+
|Screenshot/State Snapshot | Takes an image of the structure as shown and gives options for resolution and download ||
49
+
|Controls Panel | Hides/shows the Controls Panel to the right ||
50
+
|Expanded Viewport | Expands 3D canvas and Controls Panel to the full browser screen ||
51
+
|Settings/Control Info | Provides settings for viewing of 3D canvas, as well as information about moving in 3D and mouse controls||
52
+
|[Selection Mode](https://molstar.org/viewer-docs/making-selections/#selection-mode)|Switches from Default Mode to Selection Mode ||
53
+
54
+
**[Sequence Panel](https://molstar.org/viewer-docs/navigating-by-sequence/#sequence-panel)**: This menu displays the polymer sequences of macromolecules (proteins and nucleic acids) present in the uploaded PDB structures. In addition, it provides quick access to any small molecular ligands or entities present in the structure(s). It is located at the top of the screen above the 3D Canvas.
55
+
56
+
**[Controls Panel](https://molstar.org/viewer-docs/managing-the-display/#controls-panel)**: This menu has the following panels for structure manipulation. It is located at the right side of the screen.
**Log Panel**: This panel shows various logs containing information about actions taken while viewing the structure. This is located at the bottom of the screen below the 3D Canvas.
67
+
68
+
### Mouse Controls
69
+
All the interactions with the molecule(s) uploaded in Mol* require using mouse controls (in the 3D canvas). These controls allow the user to manipulate the view of structures via a variety of functions such as rotating, translating, zooming, and clipping the structures. When not specified, a “click” refers to pressing the left mouse button or tapping a single finger on a touchscreen. If an action is available for the right mouse button, it can also be completed by using the Control button + left mouse button. The general mouse controls are listed below:
70
+
71
+
***Rotate**: click the left mouse button and move. Alternatively, use the Shift button + left mouse button and drag to rotate the canvas.
72
+
***Translate**: click the right mouse button and move. Alternatively, use the Control button + the left mouse button and move. On a touchscreen device, use a two-finger drag.
73
+
***Zoom**: use the mouse wheel. On a touchpad, use a two-finger drag. On a touchscreen device, pinch two fingers.
74
+
***Center and zoom**: use the right mouse button to click onto the part of the structure you wish to focus on.
75
+
***Clip**: use the Shift button + the mouse wheel to change the clipping planes. On a touchpad, use the Shift button + a two-finger drag.
76
+
77
+
Moving the mouse over (or hovering over) any part of the 3D structure displayed in the 3D canvas, without clicking on it, will highlight it (by coloring it in magenta) according to the [Picking Level](https://molstar.org/viewer-docs/making-selections/#picking-level) currently selected. Additionally, in the lower right corner of the 3D canvas, information about the PDB ID, model number, instance, chain ID, residue number, and chain name is listed for the highlighted part of the structure.
78
+
79
+
As you interact with the structure using the mouse, Mol* contains two modes for which the behavior of a click is different. As a result, each mode enables unique operations to be performed. To switch between the two modes, use the Selection Mode icon (shaped like a cursor) that appears in the Toggle Menu. The list below summarizes Default Mode and Selection Mode.
80
+
81
+
***Default Mode**: A click on a residue (or any object in 3D) will focus on it. The focused residue and its surroundings (residues and ligands) will be displayed in a ball & stick representation. All local non-covalent interactions will be shown. To hide the surroundings, click on the target residue again.
82
+
***[Selection Mode](https://molstar.org/viewer-docs/making-selections/#selection-mode)**: A click on a residue (or any object in 3D) will select it. What exactly will be selected depends on the value of the [Picking Level](https://molstar.org/viewer-docs/making-selections/#picking-level). Selected parts of the structure will appear with a bright green tint in the 3D canvas and in the [Sequence Panel](https://molstar.org/viewer-docs/navigating-by-sequence/#sequence-panel). When selecting polymers with the Picking Level set to “residue,” holding the Shift key while clicking will extend the selection along the polymer from the last clicked residue on. Clicking on any point in the 3D canvas that has no atom will clear the selection.
83
+
84
+
## Community
85
+
### Support
86
+
Need help? Please [open an issue](https://github.com/a-r-j/vscoding-sequence/issues/new/choose) for support.
87
+
88
+
### Discussion
89
+
Find me on twitter: [@arian_jamasb](https://twitter.com/arian_jamasb) or drop me an email: [[email protected]](mailto:[email protected])
90
+
91
+
## Change log
92
+
### 1.0.2
93
+
* Update docs & package metadata
94
+
* Fixes issue that viewer would autorefresh and lose state when switching between views.
95
+
96
+
Adds support for additional filetypes:
97
+
*`.pdbqt`
98
+
*`.mmcif`
99
+
*`.gro`
100
+
*`.xyz`
101
+
*`.cif`
102
+
103
+
Adds support for molecules:
104
+
*`.mol`
105
+
*`.mol2`
106
+
*`.sdf`
107
+
21
108
### 1.0.1
22
109
23
110
* Adds Right-click open from context menu
@@ -27,3 +114,25 @@ Right-click on the `.pdb` file in the file editor and select `Launch Protein Vie
27
114
### 1.0.0
28
115
29
116
Initial release!
117
+
118
+
## Reference
119
+
120
+
If this extension proves useful, you should cite the developers of Mol*
121
+
122
+
```bibtex
123
+
@article{10.1093/nar/gkab314,
124
+
author = {Sehnal, David and Bittrich, Sebastian and Deshpande, Mandar and Svobodová, Radka and Berka, Karel and Bazgier, Václav and Velankar, Sameer and Burley, Stephen K and Koča, Jaroslav and Rose, Alexander S},
125
+
title = "{Mol* Viewer: modern web app for 3D visualization and analysis of large biomolecular structures}",
126
+
journal = {Nucleic Acids Research},
127
+
volume = {49},
128
+
number = {W1},
129
+
pages = {W431-W437},
130
+
year = {2021},
131
+
month = {05},
132
+
abstract = "{Large biomolecular structures are being determined experimentally on a daily basis using established techniques such as crystallography and electron microscopy. In addition, emerging integrative or hybrid methods (I/HM) are producing structural models of huge macromolecular machines and assemblies, sometimes containing 100s of millions of non-hydrogen atoms. The performance requirements for visualization and analysis tools delivering these data are increasing rapidly. Significant progress in developing online, web-native three-dimensional (3D) visualization tools was previously accomplished with the introduction of the LiteMol suite and NGL Viewers. Thereafter, Mol* development was jointly initiated by PDBe and RCSB PDB to combine and build on the strengths of LiteMol (developed by PDBe) and NGL (developed by RCSB PDB). The web-native Mol* Viewer enables 3D visualization and streaming of macromolecular coordinate and experimental data, together with capabilities for displaying structure quality, functional, or biological context annotations. High-performance graphics and data management allows users to simultaneously visualise up to hundreds of (superimposed) protein structures, stream molecular dynamics simulation trajectories, render cell-level models, or display huge I/HM structures. It is the primary 3D structure viewer used by PDBe and RCSB PDB. It can be easily integrated into third-party services. Mol* Viewer is open source and freely available at https://molstar.org/.}",
0 commit comments