Installing Split

Installing Split


  1. The program should run on any reasonably modern Unix machine. (However, spurious segmentation faults have been encountered under NeXTStep-Intel.) If you want to use CPLEX, purchase and install it. Install the following GNU (Free Software Foundation) products: g++ (version 2.7.2) or later), libg++ (2.7.1), gzip, sort, fold, m4, c++filt (part of binutils).
  2. Create and move to an empty directory where you will be doing everything. Create subdirectories cc, doc, inc, obj, and tex. Download disect.cc, CODE.gz, nauty.h, nauty.c, nautil.c, nug.alw.gz, quad.h, and quad.cc. (If you have previously installed an earlier version of Split, it is probably a good idea to start from scratch: download all these files.) Apply gunzip to those files which need it. If you are using NeXTStep, change nan.h to math.h in quad.cc.
  3. Modify CODE to suit your system, by changing a few #define lines, as follows:
    1. CPLEX should be set to the name of your CPLEX executable file (probably cplex or cplexmip);
    2. CPLEX_VERSION should be set to the version number of your copy of CPLEX;
    3. ABSOLUTE_PATH_FOR_CPLEX should be set if CPLEX refused to recognize relative path names.
  4. Type the following:
    1. g++ disect.cc -s -o disect
    2. disect CODE
    3. chmod 755 prep
    4. prep all
    On my machine it takes 9 seconds to do the disect, and slightly over 8 minutes to do the "prep all". If the disect is incredibly slow, it may be because files are being modified over a network. As for slowness of "prep all", try reading the file "prep". Now the source code is compiled. You can test the program file of the report with "Split < code.data". It takes about 33 hours on my machine to complete execution. This is assuming that you have CPLEX. Otherwise execution will be much slower. A log file may be found here.
  5. Backward compatibility has not been maintained in the versions of the program. See the file "doc/backward-compatibility" for a record of some changes.