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
[](https://marketplace.visualstudio.com/items?itemName=ArianJamasb.protein-viewer)
VSCoding Sequence allows for visualisation of protein structures and molecular data in the editor, courtesy of the fantastic [Mol*](https://molstar.org/)
### 📥 Loading a Protein Structure from the [PDB](https://www.rcsb.org/) or [AlphaFoldDB](https://alphafold.ebi.ac.uk/)
21
19
22
20

@@ -42,20 +40,23 @@ Right-click on the file or selection of files in the file editor and select `Lau
42
40
*`.sdf`
43
41
44
42
### 📂 Loading a Local Folder
43
+
45
44

46
45
47
46
Right-click on the folder in the file explorer and select `Launch Protein Viewer from Folder`
48
47
49
48
## ⚙️ Usage
49
+
50
50
*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](https://www.rcsb.org/) 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.
55
57
56
58
**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.
57
59
58
-
59
60
| Function | Description | Icon |
60
61
|---|---|---|
61
62
|Reset Camera | Centers and resets the view of the structure on the 3D canvas ||
@@ -68,6 +69,7 @@ Right-click on the folder in the file explorer and select `Launch Protein Viewer
68
69
**[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.
69
70
70
71
**[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.
@@ -80,6 +82,7 @@ Right-click on the folder in the file explorer and select `Launch Protein Viewer
80
82
**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.
81
83
82
84
### 🐭 Mouse Controls
85
+
83
86
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:
84
87
85
88
***Rotate**: click the left mouse button and move. Alternatively, use the Shift button + left mouse button and drag to rotate the canvas.
@@ -96,46 +99,63 @@ As you interact with the structure using the mouse, Mol* contains two modes for
96
99
***[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.
97
100
98
101
## 🧲 Installation
102
+
99
103
* The extension can be downloaded/installed from the [VSCode marketplace](https://marketplace.visualstudio.com/items?itemName=ArianJamasb.protein-viewer)
100
104
101
105
* Altenatively, enter `⌘ + ⇧ + x` in VSCode and search for `Protein Viewer`
102
106
103
-
104
107
## 📬 Community
108
+
105
109
### Support
110
+
106
111
Need help? Please [open an issue](https://github.com/a-r-j/vscoding-sequence/issues/new/choose) for support.
107
112
108
113
### Discussion
114
+
109
115
Find me on twitter: [@arian_jamasb](https://twitter.com/arian_jamasb) or drop me an email: [[email protected]](mailto:[email protected])
110
116
111
117
## 🌪️ Change log
112
118
119
+
### 0.1.0
120
+
121
+
Adds support for folding sequences via ESMFold
122
+
Bumps Mol* to 3.23.0
123
+
113
124
### 0.0.8
125
+
114
126
Adds support for Mol* 3.0.2 to enable viewing of AF2 structures.
115
127
116
128
### 0.0.7
129
+
117
130
README Fixes.
131
+
118
132
### 0.0.6
133
+
119
134
Fixes README emoji shortcodes
135
+
120
136
### 0.0.5
121
-
* Adds ability to launch a viewer from a selection of multiple supported files.
122
137
138
+
* Adds ability to launch a viewer from a selection of multiple supported files.
123
139
124
140
### 0.0.4
141
+
125
142
* Adds support to open folders from explorer
126
143
127
144
### 0.0.3
145
+
128
146
* Update docs & package metadata
129
147
* Fixes issue that viewer would autorefresh and lose state when switching between views.
0 commit comments