Welcome to Simplified ROSS!
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 made getting the full history of a file somewhat of a pain.
You may find the now-deprecated version at the ROSS-Legacy tag in this repository.
Using this repository you can compare files from the new
For a detailed list of changes between old ROSS and SR please visit the wiki.
ROSS's history starts with a one-week re-implementation of Georgia Tech Time Warp (GTW) by Shawn Pearce 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 official 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, several 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 Simplified ROSS (gonsie/SR), this version removed many files, functions, and variables that had become deprecated over time.
- ROSS is written in C standard and thus requires a C compiler (C11 is prefered, but not required).
- The build system is CMake, and we require version 2.8 or higher.
- ROSS relies on MPI. We recommend the MPICH implementation.
- Clone the repository to your local machine:
git clone -b master --single-branch email@example.com:carothersc/ROSS.git cd ROSS
Since the ROSS repostiory is quite large, it is recommended that you only clone the master branch.
To speed up the clone command even more, use the
- Optional Install the submodules:
git submodule init git submodule update
Currently, ROSS includes three submodules:
- ROSS-Models is a set of existing models
- template-model is a starting place for new models
- RIO is a work-in-progress checkpointing framework
- Optional Symlink your model to ROSS. Please this wiki page for details about creating and integrating a model with ROSS.
ln -s ~/path-to/your-existing-model models/your-model-name
- Create a build directory. ROSS developers typically do out-of-tree builds. See the Installation page for more details.
cd ~/directory-of-builds/ mkdir ROSS-build cd ROSS-build export ARCH=x86_64 export CC=mpicc ccmake ~/path-to/ROSS
- 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
- 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!)