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
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>BALLView Documentation: Tips and hints</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="mm.html"><img src="images/left.png" width="58" height="28" border=0 align="Middle"></a>
<a href="index.html">Index</a>
<a href="hotkeys.html"><img src="images/right.png" width="58" height="28" border=0 align="Middle"></a>
</h2><hr width=700>
<H2>General tips and hints for BALLView</H2>
This page gives hints for BALLView, which do not fit somewhere else...
<h2 align = center>How to cite?<a name="cite"></a></h2>
<div align="left">For all results that were obtained using BALL or BALLView please cite the following publications:<br>
<br>
For <b>BALL</b> cite:<br>
<i>
BALL - Biochemical Algorithms Library 1.3<br>
Andreas Hildebrandt, Anna Katharina Dehof, Alexander Rurainski, Andreas Bertsch, Marcel Schumann,
Nora C Toussaint, Andreas Moll, Daniel Stockel, Stefan Nickels, Sabine C Mueller, Hans-Peter Lenhof,
Oliver Kohlbacher<br>
BMC Bioinformatics, 2010, 11:531
</i><br>
<br>
For <b>BALLView</b> cite:<br>
<i>
BALLView: an object-oriented molecular visualization and modeling framework<br>
Moll A, Hildebrandt A, Lenhof HP, Kohlbacher O.<br>
J Comput Aided Mol Des. 2005 Nov;19(11):791-800.<br>
</i><br>
<a name="help"></a>
<h2 align = center>Obtain help</h2>
<div align="justify">
The documentation for BALLView was written in the HTML format, such that it either be
used online from the project's website or inside the program itself.
To obtain help for individual elements in the graphical user interface a special mode
was added. In the "Help" menu the entry "Whats this?" will switch into this mode and
transform the mouse cursor into a question mark. While the "Whats this?" mode is
active a left mouse click on any widget will open the corresponding help entry in the
documentation. (If no help entry for that widget exists nothing will happen.)
To leave the "Whats this?" mode just press the right mouse button or press the "Escape" key.
As an alternative for this approach the "F1" key will popup the documentation for
the current widget under the mouse cursor.
<p></p>
<a name="3D"></a>
<h2 align = center>View molecules in 3D stereo</h2>
<div align="justify">BALLView provides two different ways to view molecules in 3D: Stereo with shutter glasses and side-by-side stereo.
Both can be switched on in the menu entry "Display->Stereo".</div>
<p></p>
<div align="justify">When BALLView is running in a 3D Stereo mode, users can change the eye distance of the both viewpoints by
using the cursor keys left and right. Left decreases the eye distance and right increases it. The Shift-modifier
boosts the effect of the two keys. The optimal eye distance varies for every person and view, so it must be adjusted manually.
The amount of the eye distance can also be changed in the Preferences:<br>
<br>
</div>
<center>
<img src="images/stereo_settings.png" width="321" height="234"><br>
<div align="justify">
<br>
The focal distance seems to have no effect on most viewers, so its settings may be removed for future releases of BALLView.<br>
<br>
<b>Caveat:</b> Since for 3D viewing two separate images have to be created for every camera movement, the 3D performance
can drop to half, while rotating or zooming the view. Consider buying a fast graphics accelerator card if you want use this feature.
</div>
<H3 align="justify">Shutter glasses</H3>
<div align="justify">To use shutter glasses with BALLView, you have to use a quad buffered graphics accelerator card.
This has up to now only been tested with a NVIDIA Quadro cards,
but should also work well e.g. with ATI Fire cards. If you make any experiences in this field with
BALLView, please let us know...
</div>
<H3>Side by side</H3>
<div align="justify">
For side by side stereo viewing the following hardware is needed:
<ul>
<li>two projectors with the same brightness, which project to the exactly same spot</li>
<li>polarization filters to fit on them</li>
<li>special polarization glasses</li>
<li>a silver coated canvas</li>
</ul>
But this form of stereo projection does not require a specific type of graphics accelerator cards.
</div>
<h2 align = center>Visualize hydrogen bonds<a name="hydrogen_bonds"></a></h2>
<div align="justify">To visualize hydrogen bonds, BALLView first has to calculate their position. This can be done, by highlighting a
System and clicking on the menu entry "Tools->Calculate H-bonds" (ALT-N). Then a new Representation for them has
to be created, while using the model "H-Bonds". The result could look like:<br>
<center>
<img src="images/hbonds.png" width="350" height="354">
</div>
<h2 align = center>Usage of the POV-RAY export<a name="POVRay"></a></h2>
<div align="justify"><a href="http://www.povray.org/">POV-Ray</a> is an external rendering program which is freely available.
The POV-Ray files which were created by BALLView contain the command line, with which POV-Ray should be invoked to
render the image. This line could look like:
<pre>povray +Imy.pov +FN +Omy.pov.png +QR +W1037 +H922 -UV</pre>
To use antialiasing in POV-Ray, the flag "+A0.3" can be added.
</div>
<h2 align = center>Data provision for 3D printing<a name="3d_printing"></a></h2>
<div align="justify">Printing service provider as <a href="http://www.rapidobject.com/">Rapid Object</a> for example produce
syntheic or ceramic models out of proper data. The representation data has to be sent as a VRML<a href="tips.html#VRML"> (with textures and colours)
or a .stl<a href="tips.html#stl"> (just structure) file. Therefore BALLView can create VRML<a href="tips.html#VRML"> or .stl<a href="tips.html#stl"> exports. </br>
<b>Important note:</b> At the moment just representations consiting only of meshes (SES, SAS, Ribbon, Cartoon, Backbone) are printable.
Other representations can be exported but most enterprises will not be willing to print them as they contain cutting planes. Also all files with more than
one representation are not printable as the printer print one cohering block.
</br>For the export of several representations which have to have the same scale after printing the VRML export contains two rows with
usefull information, as maximum and minimum X, Y, and Z values, the boxsize of a box the representation fits into and the volume of this
box, as this is the worstcase volume one has to pay for if printing. These lines are at the very end of the file.
</br> <b>Warning:</b> All exports take very long (and in this time BALLView will not react or redraw its surface) so don't panic, just wait. (worstcase so far: 60 minutes)
</div>
<h2 align = center>VRML exports<a name="VRML"></a></h2>
<div align="justify">The printability and printing information is to be found in "Data provision for 3D printing"<a href="tips.html#3d_printing">.
VRML describes the representation by writing primitives as spheres, tubes and lines. As these are allways complete and without holes
the combination of several primitives (others than meshes which are just describing the surface) isn't printable anymore.
The VRML export warns the user as soon as a representation is used which is not printable. </br> As printability is also violated as soon as more
than one representation is put into a common file the VRML export produces a question window in this case. The user can decide if he wants
to export nethertheless into one file (is sensible if he wants just to view the data not to print it). If he decides to want them to be exported into
several files the representations will get a "_XX" appended where XX is the number of visible representation in chronological order of their creation.
</div>
<h2 align = center>stl exports<a name="stl"></a></h2>
<div align="justify"> Another type of printing data format is stl. It is not very interessting as a colourless model is not really cheaper
than a coloured one. stl contains no primitives just meshes but the representations which are not prinable are the same as for VRML as the export takes
a very long time and creates huge amounts of data and therefore an intelligent export of the "Ball and Stick" representation for example would be infeasible.
</div>
<h2 align = center>Create animations<a name="animations"></a></h2>
<div align="justify">
BALLView can create fly by animations from the Scene, either for creating on screen presentations or
for exporting images to create movies (see below).
This functionality is available through the menu entry "Display->Animations":<br>
</div>
<table width="650" border="0" cellpadding="15">
<tr>
<td><img src="images/animation_menu.png" width="117" height="176"></td>
<td>
<div align="justify">
When a user presses the "Record" entry, BALLView stores the subsequent sequence of viewpoints in
the Scene, i.e. if a user moves the mouse, such that the viewpoint changes, this is recorded
and can be reproduced.
To start a recorded animation, use the "Start" entry.
The animation can be stopped at any time, by clicking "Stop".
The "Clear" entry allows for deleting the recorded sequence such that a new one can be recorded.
Please remember that you have to click again on "Record" to switch off the recording.<br>
The last three entries allow to repeat the animation or export images either directly in the PNG format or through the POV-Ray renderer.
<br>
As an alternative, animations can also be created with Python scripts.
The examples folder contains several scripts which illustrate how this can be done.
</td></tr></table>
<h2 align = center>Create movies from pictures<a name="movies"></a></h2>
<div align="justify">
To combine a set of images to a movie on Linux or MacOS, we suggest the program
<a href="http://www.mplayerhq.hu/h">mencoder</a>.
To create an AVI video with 25 frames per second from all PNG images in the current directory
with the
<a href="http://www.xvid.org/">XviD codec</a> and a bitrate of 1600 kbit/s invoke<p>
<i>mencoder "mf://*.png" -mf fps=25 -o out.avi -ovc xvid -xvidencopts pass=1:bitrate=1600</i>
<p>
For Windows users, we recommend <a href="http://www.virtualdub.org/">VirtualDub</a>.
</div>
<h2 align = center>Usage of distance grids<a name="distance_grids"></a></h2>
<div align="justify">
You might wonder what a distance grid is good for (see menu entry "Tools->Distance Grid").
This entry creates a grid with the distance between every point in the grid to the center of
the molecule.
This grid can be used to color surfaces according to the distance of every triangle to the
center of the molecule, which can create nice coloring effects
(see also <a href="geometricControl.html#color_surfaces">here</a>).
</div>
<h2 align = center>Quick save and quick load<a name="quick_load"></a></h2>
<div align="justify">
BALLView offers quicksave and quickload functionality through entries in the main toolbar.
The state of the application and all loaded
molecular data and standard representations are stored in the project file ''quick.bvp'' in the users home directory. This can e.g. be used
for an undo operation.
</div>
<h2 align = center>Download PDB files<a name="download_pdb"></a></h2>
<div align="justify">
PDB files can be downloaded from the www.pdb.org servers using their PDB identifiers.
On some machines it might be necessary to enter the
data for the proxy configuration (see Preferences below).
It is also possible to use mirror sites.
<br><br>
<img src="images/network.png"><br><br>
</div>
<hr width=700>
<h2 align="center">
<a href="mm.html"><img src="images/left.png" width="58" height="28" border=0 align="Middle"></a>
<a href="index.html">Index</a>
<a href="hotkeys.html"><img src="images/right.png" width="58" height="28" border=0 align="Middle"></a>
</h2>
</td></tr></table>
</div>
</body>
</html>
|
