Документ взят из кэша поисковой машины. Адрес оригинального документа : http://xmm.vilspa.esa.es/scisim/release/latest/help/install.html
Дата изменения: Wed Jan 12 14:03:23 2005
Дата индексирования: Sat Dec 22 13:51:05 2007
Кодировка:
Поисковые слова: р п р п р п р п р п р п р п р п р п п р п п р п п п р п р п п р п р п п р п р п п р п р п п р п р п п р п п р п р п п р п
SciSim 4.0 Installation

SciSim 4.0 Installation


Contents

These instructions cover the installation of SciSim. For latest information about installation, you may also visit the on-line documentation.

Binary installation

Requirements

Binary distributions of SciSim are available on-line for download, and created on the following platforms:

Installation

We assume that you want to install SciSim in /usr/local/scisim-x.y.z. After downloading, you should unpack the compressed distribution with the command: 
    $ cd /usr/local
    $ gunzip -c scisim-x.y.z.tgz | tar xf -

Environment

In order to run SciSim you need to define the following environment variables: Assuming we have installed SciSim in /usr/local/scisim-x.y.z, you should specify:

tcsh / csh: 
    > setenv SCISIM_DIR /usr/local/scisim-x.y.z
    > source $SCISIM_DIR/setup
ksh / bash / sh: 
    $ SCISIM_DIR=/usr/local/scisim-x.y.z
    $ export SCISIM_DIR
    $ . $SCISIM_DIR/setup.sh
You may also add these commands to your .login (for csh or tcsh) or .profile (for sh, bash or ksh).

Installation test

After you have gone through the steps above, you should be able to start-up SciSim in a directory with write-access: 
    $ mkdir $HOME/tmp
    $ cd $HOME/tmp
    $ scisim
A Graphical User Interface (Window) of SciSim will appear.

Trouble shooting

If the above does not work, your system may not have the appropriate shared libraries (e.g. Qt). For this reason, you can download extra packages of the form: scisim-x.y.z-libextern.tgz.
You should download and unpack these packages as described for the SciSim's core binary distribution: 
    $ cd /usr/local
    $ gunzip -c scisim-x.y.z-libextern.tgz | tar xf -

<< Go to top of the page

Source installation

Requirements

We build SciSim across several platforms on a daily basis.

Platforms and Operating systems

The following platforms are involved:

Software

Next to basic UNIX facilities (bash,sh,csh,cp,mkdir,grep,sed etc...), you will need: Except for the commercial f95 compiler, ready made binary distributions are available for most systems:

Environment

The following environment variables are used when running SciSim: For example, a PC running RedHat 9.0 is using the following environment: 
  PATH=/usr/local/f95/bin:/usr/lib/qt-3.1/bin:/usr/local/bin:/bin:\
       /usr/bin:/usr/X11R6/bin:/sbin:/usr/sbin
  LD_LIBRARY_PATH=/usr/lib/qt-3.1.2/lib
  LIBRARY_PATH=/usr/local/f95/lib:/usr/local/cfitsio-2.430/lib:/usr/lib/qt-3.1.2/lib
  CPLUS_INCLUDE_PATH=/usr/lib/qt-3.1.2/include:/usr/local/cfitsio-2.430/include
  C_INCLUDE_PATH=/usr/local/cfitsio-1.42

Configuration

You will need to build SciSim in a separate build directory. For example, if the unpacked source directory is $HOME/tmp/scisim-src, create a directory $HOME/tmp/scisim-obj to put the object files in. This allows you to remove the whole build directory in case an error occurs.

From your object directory, run the shell script configure found in the platform directory of the source tree. In the example above, you'd type: 
     $ ../scisim-src/platform/configure
configure can take quite a few options, but most important is --prefix.
The --prefix option tells configure where you want SciSim installed. By default this is $HOME/tmp/scisim, but it can be anything:
     $ ../scisim-src/platform/configure --prefix=/usr/local/scisim-x.y.z
If configure does not end properly, you're are missing one or more of the prerequisites.

Building

To build the library and related programs, type: 
     $ make
You can build the documentation with: 
     $ make doc
The source distribution is accompanied with test programs. You can run them with the command: 
     $ make test
If make bails out with an error, something is wrong. Otherwise your build is successful.

<< Go to top of the page

Catalogues


SciSim is able to work with some Start Catalogues. It is able to extract sources from these catalogues, and use them as input to the Simulators.
If you wish to use the catalogues extraction feature, it is necessary to install and preprocess the catalogues.

The catalogues are not distributed with SciSim as they are very large. The preprocessing is needed to create fast look-up tables.
 

  1. Obtain the following star catalogues:
  2. Install these in a suitable directory. In this example we will use /usr/local/data/catalogue for the location of all original catalogues, and /usr/local/scisim-x.y.z for the installation directory of SciSim.
  3. Copy the init file /usr/local/scisim-x.y.z/bin/catalogue/process.ini to your working directory, and adapt it to your local settings. In our example we specify: 
      OutputDir=/usr/local/scisim-x.y.z/data/catalogue
  RawWgaFile=/usr/local/data/catalogue/wga/heasarc_wgacat.tdat
  RawTicDir=/usr/local/data/catalogue/tic
  RawGscDir=/usr/local/data/catalogue/gsc/vol1
    If you do not have a catalogue installed, you simply uncomment that line: 
      OutputDir=/usr/local/scisim-x.y.z/data/catalogue
  RawWgaFile=/usr/local/data/catalogue/wga/heasarc_wgacat.tdat
  RawTicDir=/usr/local/data/catalogue/tic
  #RawGscDir=/usr/local/data/catalogue/gsc/vol1
  4. Preprocess the catalogues: 
      /usr/local/scisim-x.y.z/bin/catalogue/process
  5. The last step requires that SciSim can find the created lookup tables of WGA, TIC and GSC catalogues. The installer has to specify their full path in the csim_config section of /usr/local/scisim-x.y.z/config/scisim.cfg: 
        gsc_regions /usr/local/scisim-x.y.z/data/catalogue/gsc.regions
    tic_data    /usr/local/scisim-x.y.z/data/catalogue/TICcat.dat
    wga_data    /usr/local/scisim-x.y.z/data/catalogue/WGAcat.dat
    Alternatively, users may create a file .scisimrc-3 in their $HOME directory, containing: 
        begin
      csim_config begin
        gsc_regions /usr/local/scisim-x.y.z/data/catalogue/gsc.regions
        tic_data    /usr/local/scisim-x.y.z/data/catalogue/TICcat.dat
        wga_data    /usr/local/scisim-x.y.z/data/catalogue/WGAcat.dat
      end
    end

<< Go to top of the page

Documentation

SciSim comes with documentation that is accessible with an HTML-3.2 compliant browser, such as Netscape.

The SciSim 'Help' menu provides access to the on-line documentation from the Graphical User Interface. This type of excess only works with Netscape.
Note: If SciSim and Netscape are running on different machines, SciSim should be installed on a file system which is visible (i.e. mounted) on both machines.

If you use a different web browser, simply invoke the browser on file:///usr/local/scisim-x.y.z/help/help.html (depending on where you have installed SciSim). Create a hot-link so that you find it again easily.

<< Go to top of the page

Uninstall

All the SciSim files are installed in a single directory (e.g. /usr/local/scisim-x.y.z).
To uninstall it, simply delete the directory.

Don't forget to remove the environment variables!

<< Go to top of the page

Upgrade

When upgrading to a new version of SciSim, all users should delete the .scisimrc-3 file from their home directory, since there could be minor changes in format between releases.

If you want to keep multiple version of SciSim (or multiple platforms), you may want to rename the $SCISIM_DIR to indicate that  (e.g. scisim-${VERSION}-${OSTYPE}). A symbolic link "scisim" can be used to refer to the latest version.

<< Go to top of the page

Questions should be sent to: simlib@xmm.vilspa.esa.es