How to use version ARTE-02:

User routines in your working directory

    For a new directory: 
    copy the whole directory $HB/ARTE-02-xx/user/*
    to your working directory.

    For an existing directory:
    Some Fortran routines have been replaced by corresponding
    C++ functions:
      rm usautt.F
      cp $HB/ARTE-02-xx/usautt.C .
      Do not modify usautt.C! It consists essentially of an #include
      statement only.

      usinit.F usevnt.F usstop.F
        have to be replaced by the C++ functions
      usinit.C usevnt.C usstop.C.
      Templates for these functions can be found in $HB/ARTE-02-04.
      Ask N.R. or H.A. in case you really insist on using Fortran.

    Overwrite usrerr.F and usauth.cdf by
    $HB/ARTE-02-x/user/usrerr.F and $HB/ARTE-02-xx/user/usauth.cdf
    (no modifications necessary).

    Check your Makefile! Or, better, copy it from
    $HB/ARTE-02-xx-ry/user/Makefile
    in order to be sure you got the latest version.

Input / Output

  The standard I/O package is Gpack. Specify the option -G. Example:
  IOFILE EVIN1 my.dst.g -IG
  For old Zebra files use the option -L instead of -G. The formats
  -A -N -X are still supported. One of these options has to be
  specified: there is no default option!
  For the time being Gpack digests only events. For other I/O (geometry
  etc.) use option -L.

  New I/O stream names:
    EV_IN        general event input: DST or MINI
    EVIN1        event input 1 for event mixing (MC only)
    EVIN2        event input 2 for event mixing
    EVIN3        event input 3 for event mixing
    EVIN4        event input 4 for event mixing
    DST_OUT      event output - DST
    MINI_OUT     event output - MINI
    
    I/O with Event Directories / Notebooks
    Note: The standard procedure for getting fast access to selected
          events is based on Event Directories. Notebooks are kind
          of private Event Directories.
    DST_IN_NOTE  DST input with Notebook
    MINI_IN_NOTE MINI input with Notebook
    DST_IN_EDIR  DST input with Event Directory
    MINI_IN_EDIR MINI input with Event Directory
    NOTE_IN      Notebook input
    EDIR_IN      Event Directory input
    NOTE_OUT     output - Notebook
    
    Will be replaced by the data base pretty soon (see below):
    GEOMIN       geometry constants input
    GEOMOUT      geometry constants output

    Generic stream names (FORBIDDEN in the command IOFILE):
    DST    all DST input/output
    MINI   all MINI input/output
    GEOM   all geometry input/output

  Data Base
    DbArteBridge (interface between Arte and Mizzi) is adapted to
    Arte-02 and tested. RPM will be implemented in one of the next
    versions. In order not to make too many changes at one time
    we still use GEOMIN/GEOMOUT for the constants.

Parallel tables are not used any more

Their names must be replaced by the names of the corresponding
superior table. Replace
  GCAX with GCAL
  GEPC with GCAL
  GEPT with GEDE
  GMAX with GMAT
  GSLX with GESL
  MCAX with MCAL
  MIMX with MIMP
  MTRX with MTRA
  MVEX with MVER
  NCAX with NCAL
  NSLX with NESL
  NMAX with NMAT
  RCLX with RCCL
  RTRX with RTRA
  RVEX with RVER
  TDEX with TDEC
  TOPX with TOPP
  wherever these names appear in your code. Note that sometimes these
  names are written in lower case characters.

Data Definition Language

  Parallel tables are not recommended but still supported.

  The command DEND_OUT divides a table into an I/O part
    (the attributes and relations given before DEND_OUT)
    and a local part (after DEND_OUT). Feel free to append
    attributes according to your private Data Definition
    at the end of the the local part (see below).

  Use generic stream names (e.g. DST) in DFILE commands.

  Only one DFILE command per table. DFILE is now forbidden
    after DRELONE, DRELMANY.

  Quotation marks " in the text are deadly. You may use
    double apostrophes '' which result in a single one.

Private Data Definition

  For many purposes (testing etc.) it is useful to maintain private
  Data Definitions on a working directory. You may invent new tables
  or modify existing ones. BASIC RULE: you may deliberately append
  new attributes at the end of existing tables. To redefine
  existing attributes, however, means to rush into disaster.

  A description of the Data Definition Language can be obtained
  in interactive Arte: type
  HELP DDL

  For the time being only a primitive script exists: hbdd.
  In future it should be implemented into the standard Arte Makefile.
  Cooking recipe for the present version of hbdd:

  The private DD has to be stored in a subdirectory dd:
  mkdir dd

    Path for private DD (auto.inc is the directory which will contain
    your new header files; it will be created automatically by hbdd):
  ln -s auto.inc auto

    Copy templates from the standard dd and edit them:
  cp $HB/dd/dd/RTRA.dd dd

    Create new header files: type
  hbdd ARTE-02-04

    The version (02-04 or any later version) is a mandatory argument.
    In most applications you maintain only small parts of the whole DD
    on private working directories. The remaining DD will be taken from
    $HB/ARTE-02-04/dd/dd.

    hbdd starts an Arte job which reads all DD files from the
    subdirectory dd. Type the Arte command
  run
    which causes a syntax check of the DD and then the creation of the
    new header files on a directory
  new.inc
    (automatically created). Thus, an existing directory
  auto.inc
    remains unchanged (safety!). In order to make use of the new
    header files, type
  mv auto.inc backup.inc
  mv new.inc auto.inc
  gmake -s run