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
179
180
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>BALLView Documentation: DatasetControl</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<body>
<div align=center>
<table width="700" border="0" cellpadding="0">
<tr>
<td align="center">
<h2 align="center">
<a href="logView.html"><img src="images/left.png" width="58" height="28" border=0 align="MIDDLE"></a>
<a href="index.html">Index</a>
<a href="pythonInterpreter.html"><img src="images/right.png" width="58" height="28" border=0 align="MIDDLE"></a>
</h2>
<hr width=700>
<h2>DatasetControl</h2>
<br>
<img src="images/datasetControl.png" width=291 height=194 border=0><br>
<div align="justify">
<br>
The DatasetControl enables the user to manage scalar and vector grids (e.g. for potential fields),
docking results, and trajectories.
All these items can be loaded and saved as files.
To switch the visibility of the DatasetControl, the menu entry Windows-DatasetControl can be used.
To operate on one of its items, the item must be highlighted.
Then a context menu can be opened with the right mouse button.
<br>
The functionality to open the above data types are available through the menu entry File-Open.
To read a trajectory, the system to which it is bound, has to be highlighted.
Then the menu entry "File-Open-Trajectory" can be used. </div>
<p></p>
<a name="calculate_potential_fields"></a><H3>Calculate a potential field</H3>
<div align="justify">
BALLView supports the calculation of molecular potential fields through its integrated
Finite Difference Boisson Bolzmann Solver (FDPB).
Before a structure is ready for this feature, any missing (hydrogen) atoms must be added and
the molecule's charges must be assigned. The later can be done through a single point
energy calculation (Molecular Mechanics-Single Point Energy).
Then highlight the System in the MolecularControl and open the FDPB dialog with the menu
entry <b>"Tools->FDPB Electrostatics"</b>. The resulting dialog allow all kind of settings.
Maybe the most important is the "spacing", since it determines the resolution of the resulting
grid. Be careful about to small values, since your computer may then run out of memory.
When a user starts the calculation with the "OK" button, the
potenial field is stored as a threedimenisonal grid in the DatasetControl.
</div>
<a name="visualise_datasets"></a><H3>Visualize datasets</H3>
<div align="justify">
BALLView offers a variety of different methods to visualize three-dimensional data grids, e.g.
from potential fields.
To visualize a 3D grid, it must be loaded into the DatasetControl and the corresponding entry
must be highlighted.
Then a context menu can be opened with the right mouse button.
<br><br>
</div>
<div align=center> <img src="images/dsc_menu.png" border=0></div>
<br><br>
<div align="left">
Currently, we support the following visualization methods for scalar data grids:
<ol>
<li><a href=geometricControl.html#color_surfaces>Coloring of surfaces</a>
<li><a href=#isocontour_surface>Contour surfaces</a>
<li><a href=#volume>Volume Rendering</a>
<li><a href=#volume>Coloring of user-defined planes</a>
<li><a href=#fieldlines>Visualization of field lines</a> (after creating a vector field)
<li>Coloring of spheres
</ol>
</div>
<h3>Create isocontour surfaces<a name="isocontour_surface"></a></h3>
<div align="justify">
The dialog for creating the isocontour surface is opened by clicking on the menu entry "Tools-Contour Surface" or through the corresponding context menu entry. </div>
<br>
<center>
<img src="images/contour_surface_dialog.png" border=0><br> <br>
<div align="justify">
On the upper half, the user can select the grid. In the lower half the threshold for the isocontour surface can be set.
The color can be freely selected by clicking on the button "Edit" and using the color selection dialog.
A possible result can be seen below.
<br><br>
<center>
<img src="images/contour_surface.png" width="552" height="451" border=0>
</div>
<p></p>
<div align="justify">
Remember that you can also create multiple isosurfaces with differing values and colors and slice
them open with a clipping plane. <br><br>
</div>
<img src="images/cs.png" border=0><br> <br>
<br>
<h3>Volume rendering and coloring of user-defined planes<a name="volume"></a></h3>
<div align="justify">
The dialog for this functionality is opened by using the context-menu of the DatasetControl
(see above). <br> <br>
<center>
<img src="images/volume-dialog.png" border=0><br> <br>
<div align="justify">
Due to some OpenGL internals, the used data grids must have size of 2^X for all
three dimensions. If a grid does not fullfil this constraint, it is automatically resized to
the next fitting size. An other constraint of the current implementation is that for
every grid only one OpenGL texture can be created. Please keep this in mind when you create
multiple volume visualizations for one grid. The following two images show an example for
the volume and plane visualizations. Remember that the planes can be freely replace by
using the move mode. To do so, the plane's representation must be highlighted in the GeomtricControl.
<br><br>
</div>
<center>
<img src="images/volume.png" border=0><br> <br>
<img src="images/plane.png" border=0><br> <br>
<br>
<a name="fieldlines"></a><H3>Visualize field lines</H3>
<div align="justify">
BALLView sipports the rendering of field lines for vector grids. To create a vector grid
from a scalar grid, use the context menu of the DatasetControl.
Then, highlight the entry for new vector grid. Now the context menu provides an entry
"Visualize VectorGrid". This opens the following dialog:<br><br>
</div>
<div align=center> <img src="images/fl-dialog.png" border=0></div>
<br><br>
<div align="justify">
While the path of a field line is determined by the vector field, there are many different ways
for controlling the distribution of field lines in
three-dimensional space.
Therefore, we implemented two distinct ways for calculating the starting positions of the individual
field lines.
The first approach generates a number of equidistant points for every individual atom.
Each point becomes the start position for one field line.<br>
Next, we implemented an approach that was described by
Stalling et al.,
in which the line placement is based on the electrostatic field strength.
The data grid is divided into equally sized cubes and the probability for one field line
to start in any given cube is proportional to the strength of the field in that cube.
The exact three-dimensional position in the cube is then randomly chosen.
This approach provides a good overview of a field's strength, since it directly corresponds to the spatial field
line density.
</div>
<br>
<div align=center> <img src="images/fl.jpeg" border=0></div>
<div align="justify">
<br>
To obtain further informations on the potential field's characteristics, BALLView supports
the coloring of individual field lines with respect to the electrostatic potential.
To achieve best results, users can freely choose the colors and interpolation values or
use transparency.
<br>
</div>
<br>
<a name="visualise_trajectories"></a><H3>Visualize Trajectories</H3>
<p align="justify">To visualize a trajectory, it has to be loaded into the DatasetControl. When it is highlighted, the context menu entry "Visualize/Export" opens the following dialog:<br>
<br>
</p>
<div align=center> <img src="images/visualise_trajectories.png" border=0></div>
<br>
<p align="justify">The arrow buttons on the top are for navigation between the snapshots. The user can also drag the slider.
The checkboxes in the lower right corner enable the user to export images, either directly in the PNG format,
or write <a href="http://www.povray.org/">POV-Ray</a> files for <a href="tips.html#povray">usage with the external renderer.</a>
The resulting images can be used to create <a href="tips.html#movies">movies</a>. </p><br>
<b>Caveat:</b> The visualization of a trajectory, which is not loaded into memory can become quiet slow, to enhance performance it is advisable to use the context menu entry "Load into RAM".
<hr width=700>
<h2 align="center">
<a href="logView.html"><img src="images/left.png" width="58" height="28" border=0 align="MIDDLE"></a>
<a href="index.html">Index</a>
<a href="pythonInterpreter.html"><img src="images/right.png" width="58" height="28" border=0 align="MIDDLE"></a>
</h2>
</td></tr></table>
</div>
</body>
</html>
|
