jgcarrera / massis Goto Github PK

MASSIS is a simulation framework for scenarios in indoor environments, allowing to design spaces, and specifying the behavior of the elements and people in them. These behaviors specifications may vary substantially: From a simple presence detector to human behavior. It is capable of supporting thousands of agents, each one with an specific behavior. The behavior specification is done outside the simulation platform, and multiple behavior models can be integrated.

The simulation progress can be visualized in 3D, from different perspectives, or in 2D. The 2D visualization library is based on layers (the elements of each layer are drawn on top of the previous layer), making easier the development of a new type of visualization for specific purposes. Also, it allows to save the simulation changes, recording each agent state in every step of the simulation. These changes are saved in an open and independent format (JSON), allowing the analysis of the results from any other platform and language.

Both MASSIS and its components are open source, allowing the extension of its functionality by third parties.

The following requirements are needed for running MASSIS:

• Java 1.7 or later (Can be downloaded from the oracle web page)

Note: Remember to add the JAVA_HOME environment variable in your OS.

• Maven 3.1.1+ (Can be downloaded from the Maven download site)

Note: Remember to add the M2_HOME environment variable in your OS.

• Ant: (Can be downloaded from the Apache Ant download page)

Note: Remember to add the ANT_HOME environment variable in your OS.

Although MASSIS can be used without any kind of IDE, it is recommended to do so. Two good IDE's are Eclipse and Netbeans.

There are two ways for using MASSIS. Downloading the source code from Github, or developing custom applications, and referencing MASSIS' maven artifacts.

This is the recommended option for changing core features of MASSIS. The necessary MASSIS' modules are hosted at Github, in the following repositories:

• Main MASSIS Repository : Contains the basic MASSIS' features.
• StraightEdge Repository: Contains the same source code of the original StraightEdge's Google Code page, but it has been mavenized.
• SweetHome3D repository: Contains the source code of the original SweetHome3D page, but its external libraries are referenced as maven dependencies.
• SweetHome3D plugins repository. Contains extensions for the environment design with SweetHome3D for MASSIS.

This is the preferred option if the objective of your project is developing an application using MASSIS' features, without changing MASSIS' source code.

The tutorials section contains examples about creating an application based on MASSIS' framework.

View official GNU site http://www.gnu.org/licenses/gpl.html.

• Wikipedia - GNU General Public License - (fr) (de) (es) (it) - from Wikipedia
• Frequently Asked Questions about the GNU Licenses - (fr) (es) (it) - from GNU official web site
• A Practical Guide to GPL Compliance - from Software Freedom Law Center