Project

General

Profile

Wiki » History » Version 25

Tony Ciavarella, 12/27/2017 03:37 AM

1 1 Tony Ciavarella
h1. Disorder
2
3 18 Tony Ciavarella
Disorder is a practical and modern C++ "Distributed Interactive Simulation":http://en.wikipedia.org/wiki/Distributed_interactive_simulation (DIS) library that implements the "IEEE":http://www.ieee.org 1278 standard.
4 1 Tony Ciavarella
5 12 Tony Ciavarella
Disorder is "free":http://www.gnu.org/philosophy/free-sw.html, "open source":http://www.opensource.org/docs/definition.php, and released under the comprehensible and liberal terms of the "MIT License":http://www.opensource.org/licenses/mit-license.php.
6 1 Tony Ciavarella
7
h2. Features
8
9
Some of the main features of Disorder are:
10
* full support for 1278.1-1995 PDUs
11
* built-in simulation entity management
12
* geospatial coordinate conversion
13
* extensible framework for logging, PDU manipulation and transmission, defining and handling custom PDUs, etc.
14
* optionally uses multiple threads to take advantage of modern multi-core CPUs
15
* included SISO compliant enumerations and bitfields headers
16 25 Tony Ciavarella
* leverages the goodness provided by other open source projects including "ASIO":http://think-async.com, "Eigen":http://eigen.tuxfamily.org, "SEDRIS":http://www.sedris.org, "GeographicLib":https://geographiclib.sourceforge.io, and "Google Test":https://github.com/google/googletest
17 8 Tony Ciavarella
* extensive test suite to prove correctness and robustness across versions and platforms
18 4 Tony Ciavarella
* good documentation
19 5 Tony Ciavarella
20
h2. Documentation
21
22 6 Tony Ciavarella
* [[Installation]]
23 19 Tony Ciavarella
* "User Manual":http://disorder.squalllinesoftware.com/docs/manual/disorder_user_manual.html
24 20 Tony Ciavarella
* "API Reference Manual":http://disorder.squalllinesoftware.com/docs/api
25 21 Tony Ciavarella
* Examples are included in the source tree
26 6 Tony Ciavarella
27 5 Tony Ciavarella
h2. Contributing
28 13 Tony Ciavarella
29 15 Tony Ciavarella
h3. Bug Reports and Feature Requests
30
31
These things are handled through this redmine instance.  Just make yourself a new account and submit your complaints and problems as new issues.
32
33
h3. Patches
34
35 22 Tony Ciavarella
Patches should be submitted to our "Review Board":https://rb.squalllinesoftware.com/oss thingy.  That way we can review them and provide you with feedback for each submission allowing you to track the progress of the patch.  You'll need to make an account on our review board site and then you'll be able to submit things in any of the following ways:
36 15 Tony Ciavarella
* using the web interface
37 17 Tony Ciavarella
* using @rbt post@ from RBTools for which you can find "installation instructions":http://www.reviewboard.org/docs/rbtools/dev/ on the Review Board website
38 15 Tony Ciavarella
* using the mercurial "ReviewBoard extension":http://mercurial.selenic.com/wiki/ReviewboardExtension directly in your repository clone
39
40 17 Tony Ciavarella
If you use rbt or the mercurial extension, inform it that the Review Board server you want to talk to is at
41 22 Tony Ciavarella
@https://rb.squalllinesoftware.com/oss@.
42 15 Tony Ciavarella
43
h3. Monetary Contributions
44
45
We accept donations in the form of old school check in USD only via snail mail.  Why do we only use arcane technology for this?  Simple.  We don't want your donations to be fleeced by 3rd party clowns.
46
47
Make your check payable to Squall Line Software, LLC and send to:
48
Squall Line Software, LLC
49
P.O. Box 561512
50
Rockledge, FL 32956-1512
51
52
Please indicate that your donation should go toward Disorder development and provide some information about yourself and some way for us to contact you to properly thank you for your contribution.
53
54 13 Tony Ciavarella
h2. I Hate This Stupid Thing!
55
56 14 Tony Ciavarella
Perhaps you may enjoy these other open source DIS implementations:
57 13 Tony Ciavarella
* "OpenDIS":http://open-dis.sourceforge.net/
58
* "KDIS":http://kdis.sourceforge.net/