-
Notifications
You must be signed in to change notification settings - Fork 2
/
README.html
178 lines (132 loc) · 8.18 KB
/
README.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
<!DOCTYPE html>
<!-- saved from url=(0022)http://localhost:5000/ -->
<html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta charset="utf-8">
<title>Grip</title>
<link rel="stylesheet" href="https://a248.e.akamai.net/assets.github.com/assets/github-48bea3124ce323ebd49dba9db4f54434cfb49307.css">
<link rel="stylesheet" href="https://a248.e.akamai.net/assets.github.com/assets/github2-fc192c2a2984e35a3501881e687042978a243b20.css">
<style>
.previewPage {
margin: 64px auto;
width: 920px;
}
</style>
</head>
<body>
<div class="page">
<div class="previewPage">
<div id="readme" class="announce md">
<article class="markdown-body entry-content">
<h1>
<a name="liquify-plugin-for-vmd" class="anchor" href="http://localhost:5000/#liquify-plugin-for-vmd"><span class="octicon octicon-link"></span></a>Liquefy Plugin for VMD</h1>
<hr><h2>
<a name="installation-instructions" class="anchor" href="http://localhost:5000/#installation-instructions"><span class="octicon octicon-link"></span></a>Installation Instructions</h2>
<p><strong>Linux / Mac OS X</strong></p>
<p>To install:</p>
<ul>
<li>Create a plugin folder for added plugins ( <em>e.g.</em> <code>~/vmdplugins</code>)</li>
<li>Copy the folder <code>liquefy/</code> to plugin folder ( <em>e.g.</em> <code>~/vmdplugins/liquefy/</code>)</li>
<li>Add the following lines to <code>~/.vmdrc</code> or copy the provided <code>liquefy/vmdrc</code> file
to <code>~/.vmdrc</code>
</li>
</ul><div class="highlight"><pre><span class="c"># Turn on main menu</span>
<span class="nv">menu</span> main on
<span class="c"># Add new plugin directory to search path</span>
<span class="k">set</span> auto_path <span class="k">[</span><span class="nb">linsert</span> <span class="nv">$auto_path</span> <span class="mi">0</span> <span class="k">[</span><span class="nb">file</span> join <span class="nv">$env</span><span class="k">(</span><span class="nv">HOME</span><span class="k">)</span> vmdplugins<span class="k">]]</span>
<span class="c"># Add new plugins</span>
<span class="nv">vmd_install_extension</span> liquefy liquefy_gui <span class="k">{</span><span class="nv">Modeling</span><span class="o">/</span>Build Molecular Liquid<span class="k">}</span>
<span class="c"># Import liquefy_gui and liquefy_cli into global namespace</span>
<span class="k">namespace</span> import Liquefy::<span class="o">*</span>
</pre></div>
<p><strong>Windows</strong></p>
<p>To install:</p>
<ul>
<li>Create a plugin folder for added plugins ( <em>e.g.</em> <code>C:\Users\My Name\vmdplugins</code> )</li>
<li>Copy the folder <code>liquefy/</code> to plugin folder ( <em>e.g.</em> <code>vmdplugins\liquefy</code> )</li>
<li>Add the following lines to the file <code>vmd.rc</code> in your home directory,
or copy the provided <code>vmd.rc</code> file to your home directory.</li>
</ul><div class="highlight"><pre><span class="c"># Turn on main menu</span>
<span class="nv">menu</span> main on
<span class="c"># Add new plugin directory to search path</span>
<span class="k">set</span> auto_path <span class="k">[</span><span class="nb">linsert</span> <span class="nv">$auto_path</span> <span class="mi">0</span> <span class="k">[</span><span class="nb">file</span> join <span class="nv">$env</span><span class="k">(</span><span class="nv">USERPROFILE</span><span class="k">)</span> vmdplugins<span class="k">]]</span>
<span class="c"># Add new plugins</span>
<span class="nv">vmd_install_extension</span> liquefy liquefy_gui <span class="k">{</span><span class="nv">Modeling</span><span class="o">/</span>Build Molecular Liquid<span class="k">}</span>
<span class="c"># Import liquefy_gui and liquefy_cli into global namespace</span>
<span class="k">namespace</span> import Liquefy::<span class="o">*</span>
</pre></div>
<p>On Windows, you may also need to alter the "Start In" path in order for
VMD to read the local vmd.rc file. This can be found by right-clicking
a VMD icon, selecting "Properties" and changing the path to your home
directory ( <code>%USERPROFILE%</code> ).</p>
<p>After installing, the vmdplugins directory should look like this:</p>
<pre><code>vmdplugins/
+-- liquefy/
| +-- liquefy.tcl
| +-- pkgIndex.tcl
</code></pre>
<h2>
<a name="using-the-plugin" class="anchor" href="http://localhost:5000/#using-the-plugin"><span class="octicon octicon-link"></span></a>Using the Plugin</h2>
<p>To use the plugin, start VMD and select </p>
<p><em>Extensions</em> -> <em>Modeling</em> -> <em>Build Molecular Liquid</em> </p>
<p>from the main menu. After filling in the required information and parameters via the graphical user interface, click the <strong>Fill</strong> button to build the liquid. The total number of molecules added as well as the density will be given in the <strong>Results</strong> frame after it finishes.</p>
<p>A command line interface is also provided through the Tcl proc <code>liquefy_cli</code>. Usage information is provided by the <code>-help</code> argument, <em>i.e.</em> by typing the following into the VMD console (recommend to use VMDs Tk Console under <em>Extensions</em>):</p>
<div class="highlight"><pre><span class="nv">liquefy_cli</span> <span class="o">-</span>help
</pre></div>
<p>For example, for a single molecule of benzene,</p>
<div class="highlight"><pre><span class="nv">liquefy_cli</span> <span class="o">-</span>pdb benzene.pdb <span class="o">-</span>psf benzene.psf <span class="o">-</span>top benzene.rtf <span class="o">-</span>savefile benzene-liq
</pre></div>
<p>creates three new files containing a random liquid structure for benzene
(<code>benzene-liq.pdb</code>, <code>benzene-liq.psf</code>, <code>benzene-liq.xsc</code>).</p>
<h2>
<a name="description-of-parameters" class="anchor" href="http://localhost:5000/#description-of-parameters"><span class="octicon octicon-link"></span></a>Description of Parameters</h2>
<p>The GUI provides input for the following parameters:</p>
<ol>
<li>
<p>PDB, PSF, and TOP Files</p>
<p><em>Input files for the single molecule you wish to generate a liquid structure for.</em></p>
<ul>
<li>PDB: Protein Data Bank </li>
<li>PSF: Protein Structure File</li>
<li>TOP: Topology file</li>
</ul>
</li>
<li>
<p>Box Dimensions</p>
<p>Input the desired length along each axis of the periodic cell. Selecting the check box "Cubic Periodic Cell" will discard <em>y</em> and <em>z</em> input and use <em>x</em> for all dimensions.</p>
</li>
<li>
<p>Runtime Options</p>
<ul>
<li>Failed Iteration Cut-off: the max allowed times the builder will try to place a single molecule in the cell and fail. At the cut-off point, no more molecules will be added and the builder will finish. </li>
<li>Density estimate: estimated density of the liquid. This is used to predict how many molecules are needed to fill the cell.</li>
<li>Scaling factor for van der Waals radii: the van der Waals radii are used to evaluate whether two atoms overlap while they are being placed in the cell. If the final density is too low, reducing the scaling factor can help pack the molecules more tightly in the cell. If the final density is too high, increasing the scaling factor will reduce the final density.</li>
</ul>
</li>
<li>
<p>Saving Data</p>
<ul>
<li>Location: directory to save new files for the generated liquid.</li>
<li>Name: the prefix used for all new files (.pdb, .psf, and .xsc files are generated).</li>
</ul>
</li>
<li>
<p>Populate Box</p>
<ul>
<li>Fill: using the given parameters, clicking this button will generate the liquid and associated files. Note, this first calls a reset function and will delete any loaded molecules or psf contexts.</li>
<li>Reset: clear molecules from display and reset psf context.</li>
</ul>
</li>
<li>
<p>Results</p>
<ul>
<li>Randomly packed density: shows the density of the randomly generated structure. If changes are made, clicking "Recalculate" will calculate the new density provided the periodic boundaries are still set (see <code>pbctools</code> for more information).</li>
<li>Molecules added: total number of molecules added to the cell. In parenthesis, the number of estimated molecules from the given density is provided for reference.</li>
</ul>
</li>
</ol>
</article>
</div>
</div>
<div> </div>
</div>
</body></html>