fix portability.
[gss-tcad.git] / Install
blob5e50f7d9cdb2eeecdf2399cf5f0491c90f01ab41
1 How to compile GSS
3 You should install some important libraries first. 
4         1 libtiff, most linux distributions have this library already been installed.       
5         2 petsc-2.3.3, since petsc often changes its function names, you must have this version. 
6         3 cgnslib-2.5-1, earlier version has memory leak problem.  
7         4 (optional) When mixed-type simulation is required, you should get lateset NGSPICE (from CVS, not rework-17)
8           and configure it with --enable-experimental --enable-ndev arguments.  
9 Note 1: 
10 petsc must be configured with --with-clanguage=cxx to support c++ call 
11 and --with-mpi=0 to disable parallel mechanism. I highly recommend to 
12 compile a BLAS/LAPACK, since the system's rounting may cause convergence 
13 problem.
15 Note 2:
16 GSS can be compiled with long double float number (default is double) 
17 to achieve better convergence rate and more accurate result. 
18 To support long double, configure PETSC with additional arguments:
19 --with-precision=longdouble --download-c-blas-lapack=1
20 PETSC will compile a special version of Blas/Lapack for long double. 
23 Make sure your compiler works, flex (version 2.5.4, no 2.5.3x) and bison are also needed.
25 Note:
26   Although gcc 3.3/3.4/4.1 works, but vendor compiler (such as Intel icc on PC) 
27 works much faster (50% faster than gcc). That mainly because the math library 
28 used by gcc compute pow(x,y) in an inefficient way but icc seems using a hardware
29 float point arithmatic accelerator.     
31 You need to set environment GSS_DIR point to the directory of gss.
32 for example, under bash, 
33         export  GSS_DIR=/home/gdiso/gss-0.46
34 In the directory of gss, type
35         configure       
36         make
37         make install
39 Note 1:
40 The default installation dir of cgnslib is /usr/local/lib, if you change
41 that, use "configure --with-cgns=CGNSdir". More help can be got by "configure --help".
42 If some library or head file can't be find, you can modify make.def file by yourself.
44 Note 2:
45 "Make install" will copy binary file to GSS_DIR/bin and material data file to GSS_DIR/lib       
47 If everything is ok, add GSS_DIR/bin to your path.
48 You can goto example directory to check gss.
49         gss xxxx.inp
51 Since gss-0.42.19, A simple text editor is added. Try it with
52         gssui