Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ROSS-org/ROSS
Rensselaer's Optimistic Simulation System
https://github.com/ROSS-org/ROSS
c discrete-event-simulation parallel-distributed-computing pdes simulation simulation-framework
Last synced: 3 months ago
JSON representation
Rensselaer's Optimistic Simulation System
- Host: GitHub
- URL: https://github.com/ROSS-org/ROSS
- Owner: ROSS-org
- License: bsd-3-clause
- Created: 2013-08-09T19:36:22.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2024-07-13T17:55:08.000Z (4 months ago)
- Last Synced: 2024-07-13T18:51:01.906Z (4 months ago)
- Topics: c, discrete-event-simulation, parallel-distributed-computing, pdes, simulation, simulation-framework
- Language: C
- Homepage: http://ross-org.github.io
- Size: 73.6 MB
- Stars: 92
- Watchers: 14
- Forks: 46
- Open Issues: 43
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# 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](https://github.com/ROSS-org/ROSS/releases/tag/Legacy) in this repository.
Using this repository you can compare files from the new `ROSS/core` to `ROSS/ross`.
For a detailed list of changes between old ROSS and SR please visit [the wiki](https://github.com/ROSS-org/ROSS/wiki/Differences-between-Simplified-ROSS-and-ROSS-Legacy).
For the most recent docs and other important posts about ROSS, see the [ROSS webpage](http://ross-org.github.io).
[](https://travis-ci.com/ROSS-org/ROSS)
[](http://codecov.io/github/ROSS-org/ROSS?branch=master)
[](http://ross-org.github.io/ROSS-docs/docs/html)
## History
ROSS's history starts with a one-week re-implementation of [Georgia Tech Time Warp (GTW)](http://www.cc.gatech.edu/computing/pads/tech-parallel-gtw.html) by Shawn Pearce and Dave Bauer in 1999.
After 10 years of in-house development, version 5.0 of [Rensselaer's Optimistic Simulation System](http://sourceforge.net/projects/pdes/) 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](http://cs.rpi.edu//~chrisc/#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](http://github.com/gonsie/SR)), this version removed many files, functions, and variables that had become deprecated over time.
## Requirements
1. ROSS is written in C standard and thus requires a C compiler (C11 is prefered, but not required).
2. The build system is [CMake](http://cmake.org), and we require version 3.5 or higher.
3. ROSS relies on MPI.
We recommend the [MPICH](http://www.mpich.org) implementation.
## Startup Instructions
1. Clone the repository to your local machine:
```
git clone -b master --single-branch [email protected]:ROSS-org/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 `--depth=1` argument.
2. *Optional* Install the submodules:
```
git submodule init
git submodule update
```
Currently, ROSS includes one submodule:
- [RISA](https://github.com/ROSS-org/RISA) ROSS In Situ Analysis
3. *Optional* Symlink your model to ROSS.
Please [this blog post](https://ross-org.github.io/setup/build-model-with-ross.html) for details about creating and integrating a model with ROSS.
```
ln -s ~/path-to/your-existing-model models/your-model-name
```
4. Create a build directory.
ROSS developers typically do out-of-tree builds. See the [Installation page](https://ross-org.github.io/setup/installation.html) for more details.
```
cd ~/directory-of-builds/
mkdir ROSS-build
cd ROSS-build
ccmake ~/path-to/ROSS
```
5. 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
```
6. Run your model.
See [this blog post](https://ross-org.github.io/setup/running-sim.html) 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!)
```