-
Notifications
You must be signed in to change notification settings - Fork 3
/
readme_old.txt
136 lines (95 loc) · 4.73 KB
/
readme_old.txt
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
VaspView 1.04
Copyright (C) 1999 Timothy B. Terriberry
Author
======
Timothy B. Terriberry
Virginia Tech
(snail-mail address subject to change)
Introduction
============
This software was designed to aid David F. Cox, a chemical engineering
professor at Virginia Tech, in his research. It is a scientific visualization
package for examining output files generated by the Vienna Ab-initio
Simulation Package, a package for performing ab-initio quantum-mechanical
molecular dynamics using pseudopotentials and a plane wave basis set. It
displays iso-surfaces and slices of a three-dimensional data set, along with
the atoms that make up the molecule the calculations were performed for, and
allows symbolic bonds to be inserted between them.
This program requires OpenGL and GLUT, both freely available on many
platforms. Binaries are available for Win32 systems. All other systems require
manual compilation (a sample Makefile is provided; it may require some
editing).
Related web pages:
Vienna Ab-initio Simulation Package: http://tph.tuwien.ac.at/~vasp/
OpenGL: http://www.opengl.org
GLUT: http://reality.sgi.com/mjk/glut3/glut3.html
Mesa (a free, portable, OpenGL-like library): http://www.mesa3d.org/
Getting the software
====================
The current primary distribution site is
http://vaspview.sourceforge.net
Win32 binaries are available as
http://vaspview.sourceforget.net/vaspview-1.05-win32-bin.zip
Source code (for all systems) are available as
http://vaspview.sourceforget.net/vaspview-1.05-source.zip
Links to the most recent version of these files will be located at the bottom
of the above web page.
You can unpack these archives on UNIX systems using the command:
unzip -a vaspview-1.05-source.zip
or:
gzip -cd vaspview-1.05-source.tar.gz | tar xvf -
depending on which type of file you downloaded.
After unpacking the source files, you should have the following files in the
new "vaspview" directory:
readme.txt - This file
vaspview.html - The homepage and user manual
license.txt - The GNU public license
src/ - Source code
win32/ - MS Visual C++ 5.0 project files and nmake file
win32/Release - Win32 binaries
Note that "win32/Release/glut32.dll" is the DLL required by GLUT, and is
included for convenience. The source code for GLUT is not provided, so do not
delete this file, or you will not be able to run the Win32 executable (unless
you have GLUT installed somewhere else on your system). GLUT is freely
available from SGI.
Compiling and Installation
==========================
Neither OpenGL or GLUT are included with this distribution. You will have to
obtain a version of both for your system in order to re-compile the software.
UNIX systems:
An example Makefile is provided. This may require some editing to reflect the
locations of header files and library files on your system.
Once the Makefile has been updated to reflect your system, run
make all
This will create an executable "vaspview" in the "bin" directory located in
your "vaspview" directory. You may then place this executable anywhere you
like (i.e.: a directory in your PATH).
Win32 systems:
An MS Visual C++ 5.0 project file and workspace is included in the "win32"
directory. You may have to edit the include directories to reflect the
location of glut.h on your system.
Once you have updated the search path for include directories, you can load
the project and compile the software. Note that the "glut32.dll" included
in the "win32/Release" directory is not compiled by this project, but is
required to run the program. If you delete this file, you will need to have
another copy available somewhere else in your search path.
Both the executable file "vaspview.exe" and "glut32.dll" can be moved anywhere
you want. Alternatively, you can place "glut32.dll" in your Windows system
directory, otherwise it should be in the same directory as "vaspview.exe"
This program has only been tested in Intel x86 systems. It may work on
versions of UNIX or Windows for other processors, however.
Reporting Bugs
==============
If you think you've found a bug in VaspView, first check if a newer version of
the viewer is available. If no new version exists, or the problem persists,
then report the bug.
When you report a bug, please give as much information as possible, including
your hardware, operating system, OpenGL implementation, GLUT version, which
version of VaspView you're using, and how to reproduce the problem, if possible.
Send bug reports to: [email protected]
Future Plans
============
Currently the viewer only supports data files generated by the VASP package.
It would be nice to support additional file formats, but I do not know which
are in common use.