grc ver.2.1: Feynman graph generator


    Program "grc" generates Feynman graphs for scattering and decay 
processes for any order of coupling constants.  This program is 
a part of GRACE system version 2.  The method used in this program 
is described in CPC 92 (1995) 127.  A brief manual of grc is included 
in this paper, which is referred as MANUAL in this document.

    The difference between ver.2.1 and ver.2.0 is

a) A bug is fixed when the model does not include 3-point tree vertices.
b) Some bugs are fixed in the graph drawer.
c) Subdirectory "doc" is replaced in accordance with the publication.

    For Feynman graph drawer, see also "gracefig" program, developed
by Dr. K. Kawabata and included in GRACE package.


                     INSTALLATION

1. Getting source code

   The source code is available through anonymous ftp as follows:

1.1  create new directory and change directory to the new one.
1.2  type "ftp ftp.kek.jp".
1.3  enter "anonymous" for the user-name prompt.
1.4  enter your e-mail address for the password prompt.
1.5  type "cd kek/minami/grc".
1.6  type "binary".
1.7  type "get grc.v2.1.tar.Z".
     

2. Uncompress and expand the file by the following commands:

        uncompress grc.v2.1.tar.Z
        tar xvf grc.v2.1.tar

   or

        zcat grc.v2.1.tar.Z | tar xvf -

   The following sub-directories should be created.

           src       : source code of the program.
           sample    : for testing program.
           elwk      : modes and processes in the standard model.
           phi4test  : for testing program in phi^3 + phi^4 model.
           qedtest   : for testing program in QED.
           doc       : documents.
           bin       : empty directory.


3. Edit Makefile:

   In the file "src/Makefile", one must edit some lines according
   to Appendix A of the MANUAL, before compiling source codes.
   Lines to be edited are:

         INSTALL=(directory to be installed)
         CC=(name of command of c-compiler)

   The drawing program requires X-Window system.  If Athena
   widget is installed in your system, you will be able to
   use buttons to control the program.  If not so, you will
   be able to use only commands in ASCII characters.

         XOPTI=(directory of header files of X-Lib)
         XOPTL=(directory of libraries of X-Lib)
         XCOPT=(options for Athena widgets)
         XCLIB=(library name of X)


4. Compilation:

   Type "make" in the "src" sub-directory 
   and then type "make install".


5. Testing compiled programs.

   A sample file and its outputs are found in directory "sample".
   Other examples of definition of models and processes are found 
   in the directories "elwk", "qedtest" and "phi4test".

   A input file of scattering processes for testing compilation
   is given in the file "sample/in.prc" for

        e+ e- ==> W+ W-        (1loop + tree)
              ==> W+ W- photon (tree)

5.1 Type "cd ../sample"

5.2 Feynman graph generator

    Type "../src/grc" or "(installed directory)/grc".
    If the program is compiled successfully, the program will display
    the same output as "eeww.log".  The program will create
    "out.grf" at the same time, which should be identical to "eeww.grf".
    Try also "../bin/grc -h".

6.2 Drawing generated graphs.

    Type "../src/grcdraw" or "(installed directory)/grcdraw".
    Generated graphs are drawn on the display of your X-Window
    terminal by this command.
    Type "n", "f", "g", "s", "n", "b", "w" and "q" in this order.
    They are commands in the drawing program.
    Try also "../bin/grcdraw -h".

6.3 Plotting generated graphs on PostScript files.

    Type "../src/grcplot" or "(installed directory)/grcplot".
    The program creates files f1.ps, f2.ps, ..., which are
    PostScript file able to be seen by ghostview (or pageview
    in Solaris).
    Try also "../bin/grcplot -h".


6. Version for MS-DOS + Turbo C++
   This version is not supported by the author.
   It should be considered as a collection of hints for installing
   this program on PC.

6.1  Files necessary for compilation are found in directories
     "src" and "src\msdos".

     Copy all files in this sub-directory "src\msdos" 
     to the directory "src".

            cd src
            copy msdos\*.* .

6.2  Edit *.mtc files:

        DRV=  (Turbo C directory)
        CC=   (compiler name) -f -ml

6.3  Commands of compiling source code are prepared in
     "mgrc.bat", "mdraw.bat" and "mplot.bat".
     Output files of compilation are "grc.exe", "grcdraw.exe"
     and "grcplot.exe".

6.4  One of executable files, "grcdraw.exe", uses BGI graphic
     library of Turbo C or Borland C.
     Before running this program, set environment variable "BGI"
     to the path-name of the directory of BGI-library.
     For example,

         set bgi=c:\borlandc\bgi


                     WARNING

This version is NOT same as one included in the package GRACE 2.
The latter includes some extensions in the format of files.


Good Luck!

                                              Feb. 19, 1996
                                              Aug.  9, 1994

                                             KANEKO Toshiaki
                                           kaneko@minami.kek.jp

                                            Meiji-Gakuin Univ.,
                                           1518 Kamikurata-cho,
                                         Totsuka-ku, Yokohama 244,
                                                  Japan