Installing the program

On  PC-Windows  platforms

 copy the EXPO2004.zip file in a new directory (i.e. c:\EXPO2004);

extract files from EXPO2004.zip in this directory;

install EXPO2004 on your DeskTop using the standard link mechanism of Windows;

run the the program by clicking on the EXPO2004 icon:

  The following directories are in the EXPO2004.zip file:

• expodir                          installing directory

• expodir/examples         test structures

• expodir/src                    source files

The following file will be created to customize the program:

• eXpo2004.cfg

The default location for this file is C:\. 

If you want to change this default, you must set the environment variable EXPOCFGDIR, i.e. to use the C:\JOHN directory to store this file:

SET EXPOCFGDIR=C:\JOHN

On Linux platforms

In order to allow the use of EXPO2004 from any user directory or by different users, it is convenient to install the program in a directory accessible through your PATH  (i.e./usr/local/bin or similar).

To do it you need super-user privileges.

Move in the installation directory  and extract files from expo2004.tar.gz

• gunzip expo2004.tar

• tar xvf expo2004.tar

             or

• tar -xzvf expo2004.tar.gz 

 The following directories will be created:

• expodir                       installing directory

• expodir/examples     test files

• expodir/src                source files + expo2004_linux_exe

copy expo2004_linux_exe in EXPO2004 installation directory changing the name of the file in expo2004 i.e.:

• cp expodir/src/expo2004_linux_exe expo2004

From now on super-user privileges are no more required.

 move in your working directory and run the program

• cd my_work_dir

• expo2004 

If the executable does not run (not compatible with your system), please refer to the Unix section of this document

The following file will be created to customize the program:

• eXpo2004.cfg@address:0.0 

where address is something like unix3.ic.cnr.it.

The default location for this file is $HOME.

If you want to change this default, you must set the environment variable EXPOCFGDIR, i.e.in order to use the /usr/users/john/custom directory to store these files you have to add to your .cshrc file (or equivalent depending on the shell you are using) the line:

 setenv  EXPOCFGDIR /usr/users/john/custom

On  Unix platforms

To create an executable file you need a Fortran 90 compiler and GTK libraries (www.gtk.org).

In order to allow the use of EXPO2004 from  any user directory or by different users, it is convenient to install the program in a directory accessible through your PATH  (i.e./usr/local/bin or similar).  

To do it you need super-user privileges.

 Move in the installation directory  and extract files from expo2004.tar.gz::

• gunzip expo2004.tar.gz

• tar xvf expo2004.tar

                        or

• tar -xzvf expo2004.tar.gz
  

 The following directories will be created:

• expodir                      installing directory

• expodir/examples    test files

• expodir/src                source files

 move in the expodir/src directory and compile the program

• cd expodir/src

• make –f make_yourcomputer

• where make_yourcomputer:

• make_alpha                Compaq Alpha

• make_linuxp                Linux & Portland Fortran 90 compiler

• make_linuxl                 Linux & Lahey Fortra 90 compiler

• make_sgi                    Silicon Graphic

  copy the executable program file in the EXPO2004 installation directory:

• cp expo2004 ../
  

From now on super-user privileges are no more required.

move in your working directory and run the program

• cd my_work_dir

• expo2004

The following file will be created to customize the program:

• eXpo2004.cfg@address:0.0

where address is something like unix3.ic.cnr.it.

The default location for these files is $HOME.

If you want to change this default, you must set the environment variable EXPOCFGDIR, i.e. in order to use the /usr/users/john/custom directory to store these files you have to add to your .cshrc file (or equivalent depending on the shell you are using) the line:

 setenv  EXPOCFGDIR /usr/users/john/custom

 If the GTK (www.gtk.org) libraries are not available, compile and link the program in the following way:

make -f make_no_gtk

after you have modified the make_no_gtk file in order to use the correct Fortran 90 compiler.

Running the program

 The first time the program is run, the following window will be displayed:

Set fonts (both Proportional and Non Proportional) and then select the test structure by means of the menu  (File->Load & Go) or clicking on the icon on the toolbar. Click on the GO button to start the run:

If the graphic interface is not available (i.e. the program has not been linked with the GTK libraries) or the user does not want to use it to select the input file, run the test in the following way:

                      expo2004 structure_name

Problems with eXpo2004.cfg file

The program creates the EXPO2004.cfg file. It should be similar to the following:

eXpo2004 2.1
C:\expo2004
netscape
C:\expo2004\expodir\examples
cf3br
cf3br.out
-unknown-Courier New-normal-r-normal-*-*-140-*-*-m-*-microsoft-vietnamese
-unknown-Courier New-normal-r-normal-*-*-140-*-*-m-*-microsoft-vietnamese
*
3 1055 797 1 1 1 0
2 0 3 0
C:\expo2004\expodir\examples\famo.bin
C:\expo2004\expodir\examples\and2.bin
C:\expo2004\expodir\examples\crox.bin
2 2
4 13 19 9 11 13 14 2 3 3 8 8 7 13 4 9 14 0 4 14 9 6 12 13 14
0 0 0
255 255 255
192 192 192
60 60 60
0 0 160
0 160 0
0 160 160
160 0 0
160 0 160
... ... ... ... ... ... ... ... ... ... ...
... ... ... ... ... ... ... ... ... ... ...

If the program crashes because of errors on this file, the best is to remove it. EXPO2004 will create it again in a correct format.