File: INSTALL

package info (click to toggle)
v-sim 3.6.0-2
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 15,860 kB
  • sloc: ansic: 75,222; sh: 10,239; makefile: 580; python: 572; cpp: 353; xml: 130
file content (80 lines) | stat: -rw-r--r-- 3,451 bytes parent folder | download
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
Necessary libraries to compile V_Sim on Unix platforms:
-------------------------------------------------------

The following libraries are required to compile V_Sim:
- GTK, development files (usually called libgtk2.0-dev in Debian-like distributions)
  The corresponding dependencies are also required (this includes pkg-config,
  GLIB development files) ;
- OpenGL, development files (manely gl.h, glu.h and glx.h, usually
  found in mesa-common-dev, libglu1-mesa-dev in Debian-like distributions).

The following packages are not mandatory:
- NetCDF, development files (for the ETSF support, namely libnetcdf.so) ;
- Openbabel, development files (from version 2.0.0, namely libopenbabel.so) ;
- ABINIT, with binding support for C (from version5.8.x) and
  Lapack development files.


Installing V_Sim on Unix like platforms:
----------------------------------------

I suppose that you have downloaded v_sim-3.0.tar.gz in some working-directory
and then ungzipped and untarred it:
> gzip -d -c v_sim-3.0.tar.bz2 | tar xvf -
or, if your tar command supports it:
> tar -jxvf v_sim-3.0.tar.bz2

Now, I suppose you are reading this INSTALL file in:
> working-directory/v_sim-3.0_package

Please cd working-directory/v_sim-3.0_package then type:
> ./configure
> make
> make install
> make clean

In the above ./configure has many options available. Type ./configure --help for
a short explanation. It understands all the GNU basic arguments plus some
specific ones for V_Sim :
- use --prefix=install_directory to specify your installation directory (/usr/local is
  default).
- use --enable-debug-messages to compile V_Sim with debug message (default is
  disable).
- use --enable-gtk-doc to build the documentation of the API (default is disable).
  There are some other less important option to customize V_Sim more precisely.

From version 3.3, plug-ins can be compiled with V_Sim. Several are shipped with the V_Sim package:
- use --with-etsf-file-format to build the support of ETSF files. It requires the
  NetCDF library (runtime and devel files).
- use --with-openbabel to add support of all file format available with OpenBabel
  library. It requires this last library (runtime and devel files).
- use --with-xsf to add support of XCrysDen Structure File format (from version 3.4).
- use --with-abinit to add support of ABINIT input files (from version 3.4).
  This doesn't create an external plug-in, but the support is compiled directly
  inside V_Sim. From version 3.5 it also import the symmetry analysis.
- use --with-cube to add support of Cube File format, structures and densities
  (from version 3.5).

When 'make install' is done, it will copy all the following files :
- to $(prefix)/bin, it will copy the binary v_sim.
- to $(prefix)/etc/v_sim, it will copy v_sim.par.
- to $(prefix)/share/v_sim, it will copy v_sim.res, v_sim.rc and the directory
  pixmaps.
- to $(prefix)/share/doc/v_sim, it will copy some legal informations and the directory
  APIreference (if --enable-gtk-doc has been given).
- to $(prefix)/lib/v_sim/plug-ins, it will copy the compiled plug-ins.


Compiling from SVN sources:
---------------------------

Before doing configure make make install, as stated before, it is necessary to
generate the build system with the autotools. It requires to have installed:
- autotools (automake and autoconf) ;
- gtk-doc ;
- intltool ;
- libtool.

Then after the svn co, issue:
./autogen.sh in V_Sim source directory.