Welcome to a leaner, meaner, faster version of ROSS. While the entire history of ROSS has been preserved in this repository, a major change in the directory structure has getting the full history of a file somewhat of a pain. You find the now-deprecated version in the carothersc/ROSS repository. Using this repository you can compare files from the new SR/core to ROSS/ross. For a detailed list of changes between old ROSS and SR please visit the wiki.

ROSS's histroy starts with a one-week re-implementation of Georgia Tech Time Warp (GTW) by Shawn Pierce and Dave Bauer in 1999. After 10 years of in-house development, version 5.0 of Rensselaer's Optimistic Simulation System went live at SourceForge.net. Thus the offical version history began!

Through the years ROSS has migrated from CVS, to SVN, to Git and GitHub.com. The code was maintained by Chris Carothers and his graduate students at RPI (publications). Over the years, sevearal features (including a shared-memory version) were implemented within ROSS. Some of these features have since been optimized out, leaving behind cruft.

In early 2015 a sleeker version of ROSS was released. Developed as Simplifed ROSS (gonsie/SR), this version removed many files, functions, and variables that had become deprecated over time.

1. Clone the repository to your local machine:

git clone git@github.com:carothersc/ROSS
cd ROSS

2. New Install the submodules:

git submodule init
git submodule update

3. Optional Symlink your model to ROSS. Please this wiki page for details about creating and integrating model with ROSS.

ln -s ~/path-to/your-existing-model models/your-model-name

3. Create a build directory. ROSS developers typically do out-of-tree builds.

cd ~/directory-of-builds/
mkdir ROSS-build
cd ROSS-build
ccmake ~/path-to/ROSS

4. Make your model(s) with one of the following commands

make -k         // ignore errors from other models
make -j 12      // parallel build
make model-name // build only one model

5. Run your model. See this wiki page for details about the ROSS command line options.

cd ~/directory-of-builds/ROSS-build/models/your-model
./your-model --synch=1               // sequential mode
mpirun -np 2 ./your-model --synch=2  // conservative mode
mpirun -np 2 ./your-model --synch=3  // optimistic mode
./your-model --synch=4               // optimistic debug mode (note: not a parallel execution!)