User Tools

Site Tools


“Frida-1” installation instruction.

This page contains for the moment installation instructions for FRIDA-1 on a Linux PC. The installation procedure depends on whether you need to compile the program or you have an already compiled version which you just want to port to another computer. If the latter is the case, skip the first section and start directly with the Installation.

In the following, it assumed that you have root access and want to install Frida-1 in the directory

/opt/ida/

If you do not have root access or do not want to use that directory for other reasons, you can easily replace the path with the one according to your preferences. The following has to hold:

  • In the file i00.f, there has to be a correct path to the file frida1.su or ida.su, depending on your version of Frida-1, before compilation. If you have only the compiled file, you have to stick to the directories listed there.
  • The file (frida1.su|ida.su) has to be in one of the directories named in i00.f and contain the correct paths to the executable and the ps-files.

Compilation

prerequisites

Attention: commercial (= pay a lot) libraries (NAG) and compiler (Absoft) are needed to compile (not to run the compiled) Frida-1. If an Absoft compiler is not available for you, you may ask for an executable by writing an email to floriank at chalmers.se.

  • Absoft compiler is necessary for proper compilation
  • unzip and untar the source code with
    tar -zxvf frida-1-0.tgz

    This will unpack the data in a new directory FRIDA1. Do it in a place where you want to compile the program (this does not need to be the place from where you want to run it later on). The subdirectory for/num/ contains numerical tables for fitting.

  • create subdirectories oba and exa
  • make sure that you have access to external libraries:
    • NAG: libnag.a (NAG FORTRAN 77 library)
    • G2C: libg2c.a
    • M: libm.a
configure
  • The respective paths for the external libraries has to be set accurately in the Makefile
  • NeXus support for FOCUS at the Paul Scherrer Institut, Switzerland, is now available! For using the FOCUS read-in routine, link also to the additional libraries (NeXus, hdf5, mfhdf, df, z, and jpeg); if the NeXus libraries for FOCUS support are not available, comment the FOCUS read in routine in i80.f
  • include or exclude optional modules (MCT, MSC etc.) in the Makefile.
    • Note: if MSCAT shall be executable, modify Makefile by including i94.f in compilation procedure. Change i00.f removing the comment signs at ‘_mss’.
    • If the full mode coupling model shall be used, remove comment signs at “_fmm” in i00.f.
  • caveat: for the moment libraries are statically linked
  • modify path for (frida1.su|ida.su) in i00.f to the directory you want to put the su-file. This file contains some basic information, for example the directory of the Frida-1 executable. As this will not change regularly, you do not need to keep it in a place easily accessible (like your home directory) but you can. In the following, it will be assumed that (frida1.su|ida.su) resides in the /opt/ida/ directory, as well. The i00.f should then contain a section similar to
          ! search for the setup file :
          CALL ExeML ('\i ida.su', aus)
          IF (aus(1:4).ne.'\i +') CALL ExeML ('\i ../ida.su', aus)
          IF (aus(1:4).ne.'\i +') CALL ExeML ('\i ../../ida.su', aus)
          IF (aus(1:4).ne.'\i +') CALL ExeML ('\i ~/ida.su', aus)
          IF (aus(1:4).ne.'\i +') CALL ExeML ('\i /opt/ida/ida.su',
         *                                    aus)

    When launched in some directory, Frida-1 will look in this very directory for an (frida1.su|ida.su), then in the parent directory, then in the grandparents' ;-) directory, then in your home, and finally in /opt/ida/ . The first one it finds will be used.

make
  • compile program by
     make -f Makefile 

    or simply

    make

    in the source directory

    • the object files are created in the oba subdirectory
    • if the compilation is successful, an executable frida1 is created in the exa subdirectory

Installation

prerequesites
  • A compiled version of Frida-1
  • If you want to use the graphics window of Frida-1, you need to have an xserver and for example the terminal xterm installed. Any other terminal providing Tektronix support performs equally well. You do not need Absoft, NAG, etc.
make install
  • You can use the directory as it is after the compilation for running Frida-1. However, only few files are actually needed for running so you can copy them to a place where you want to run it from (this is for example required if you compiled Frida-1 on another machine than you want to run it from). The following files are required:
    > ls /opt/ida/
    frida1  g2.ps  g3.ps  g4.ps  Ida.hlp  ida.su  wups05a.ps  wups97a.ps

    Except the file frida1 which is in the subdirectory exa, all files are directly in the directory you compiled Frida-1 in.

  • modify path variables in (frida1.su|ida.su) according to your needs. In the given example, it should then contain a section
    % ida default setup in ida.su
    \p dir-hlp        /opt/ida
    \p fil-gra-def.ps /opt/ida/g3.ps
    \p fil-gra-ful.ps /opt/ida/g2.ps
    \p fil-gra-app.ps /opt/ida/g4.ps
    \p dir-num        /opt/ida/for/num/

    In case you want to install Frida-1 in another directory or left it in the directory structure it compiled in, simply adjust the paths. You are somewhat limited in the choice of directory for the (frida1.su|ida.su) as it has to be in a place specified in the i00.f file (see above). However, the other files can be placed at discretion as long as the correct path is given in the (frida1.su|ida.su).

run
  • Frida-1 should be run in a xterm window to have the graphics available. You start xterm simply by calling
    xterm

    in a shell. The directory you launch it from will be the directory in which Frida-1 looks for the data and saves the files, images, etc.

  • To start Frida-1, you simply run the command
    /opt/ida/exa/ida

    in the xterm

  • If on startup the message
     Could not load setup file ida.su 

    appears, the (frida1.su|ida.su) is not in a directory specified in your i00.f. Please check the directories listed there and place the (frida1.su|ida.su) accordingly.

shortcut
  • To avoid having to start an xterm and enter all the path to the Frida-1 executable every time you want to start, it is convenient to define a shortcut
     frida-1 

    There are two ways of doing so which both require bash installed on your system: The first one requires write access to the directory /usr/local/bin/ , the second doesn't but can sometimes be a bit cumbersome (and has to be adjusted if your standard shell is not bash).

    1. Create the file /usr/local/bin/frida-1 containing
      #! /usr/bin/env bash
      
      xterm -title 'Frida-1 Linux Version' -sb -sl 5000 -bg white -fg black -cr chartreuse -fn 8x13 -g 80x58+0+0 -e /opt/ida/exa/ida &

      and make it executable

    2. Alternatively, assuming that your terminal is bash – you can check launching
       echo $SHELL 

      it is possible to define an alias in the .bashrc file in your home directory which will be read when a new terminal is started. To do so, open the .bashrc in a text editor and add the following line at the end (or create the file if it didn't exist before):

       alias frida-1="xterm -title 'Frida-1 Linux Version' -sb -sl 5000 -bg white -fg black -cr chartreuse -fn 8x13 -g 82x27+2+358 -e /opt/ida/exa/ida &" 

      Close the terminal and start a new one.