instructions.txt

To run all of the GAP benchmarks on the Intel DevCloud:

Edit your .bash_profile, assuming you put GraphBLAS and LAGraph in $HOME:

    LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$HOME/bin:$HOME/GraphBLAS/build:$HOME/LAGraph/build
    export LD_LIBRARY_PATH

Download GraphBLAS and LAGraph to $HOME, side-by-side (not one inside the
other):

    git clone -b master https://github.com/DrTimothyAldenDavis/GraphBLAS
    git clone https://github.com/GraphBLAS/LAGraph

You should have two folders, ~/GraphBLAS and ~/LAGraph, side-by-side.

For GraphBLAS, sometimes the latest version on the non-default MASTER
branch is non-functional; you may want to use a tagged pre-release instead:
See https://github.com/DrTimothyAldenDavis/GraphBLAS/releases .
So please ask me first (email: davis@tamu.edu), just in case.

Next, submit this to compile GraphBLAS and LAGraph:

    qsub myjob_compile_gold_gcc

DO NOT USE icc; IT WILL GIVE POOR PERFORMANCE, because of how it does atomics.
I'm exploring workarounds.

You then need to convert the *mtx files to GraphBLAS binary *grb files for
faster I/O times.  My scripts assume the matrices are in ~/GAP/GAP-xxx/*.*
where xxx is kron, road, twitter, urand, or web.  Cut-and-paste the following,
just once:

    cd
    mkdir GAP

    mkdir GAP/GAP-kron
    mkdir GAP/GAP-urand
    mkdir GAP/GAP-twitter
    mkdir GAP/GAP-web
    mkdir GAP/GAP-road

    cp /data/sparse.tamu.edu/gap/GAP-kron/GAP-kron_sources.mtx ~/GAP/GAP-kron
    cp /data/sparse.tamu.edu/gap/GAP-road/GAP-road_sources.mtx ~/GAP/GAP-road
    cp /data/sparse.tamu.edu/gap/GAP-twitter/GAP-twitter_sources.mtx ~/GAP/GAP-twitter
    cp /data/sparse.tamu.edu/gap/GAP-urand/GAP-urand_sources.mtx ~/GAP/GAP-web
    cp /data/sparse.tamu.edu/gap/GAP-web/GAP-web_sources.mtx ~/GAP/GAP-road

    cd LAGraph/Test/BinRead
    qsub myjob_BinRead_gold

When that finishes, run the tests.  All the qsub scripts are already
in the LAGraph github.  You should be able to cut-and-paste these commands
to run all the scripts.  For the output, see the Test/*/myjob*.o* files
that the scripts generate.

    cd LAGraph/Test

    cd BetweennessCentrality
    qsub myjob_BC_gold

    cd ../BFS
    qsub myjob_BFS_gold

    cd ../CC
    qsub myjob_CC_gold

    cd ../PageRank3
    qsub myjob_PR_gold

    cd ../SSSP
    qsub myjob_SSSP_gold

    cd ../TriangleCount
    qsub myjob_TC_gold

In addition, each test result will be placed in a file in each
test folder, as it completes, with the name log_HOST.txt, where
HOST is the hostname of the system that was used.