 |
Welcome to GAMA Platform on GitHub |
|---|
Developed since 2006, GAMA is an easy-to-use open source modeling and simulation environment for creating spatially explicit agent-based simulations. The generic nature of the approach advocated by GAMA allows its thousands of users to use it in a number of application domains and for a wide variety of purposes: scientific simulation, scenario exploration and visualization, negotiation support, serious games, mediation or communication tools, the possibilities are endless!
This organization brings together the main repositories used to develop, build, test and use GAMA:
- gama: contains the Eclipse projects for the development of the platform. A documentation on how to build these versions from source is available here. Serves as a hub for raising issues about GAMA.
- gama plugins: contains additionnal extensions to GAMA built by the community. Plugins present in this repository are automically built against the latest version of GAMA.
- gama.copilot: dedicated to the thin layer of compatibility that allows GAMA users to install copilot in their favorite platform. Manages its own update life-cycle through a dedicated update site (https://gama-platform.org/gama.copilot/).
- gama.devtools: dedicated to the Eclipse plugin that supports the development of GAMA and GAMA plugins. Manages its own update life-cycle through a dedicated update site (https://gama-platform.org/gama.devtools/).
- gama.clients: dedicated to the development of libraries (in, python, typescript, etc.) to easily communicate with the GAMA Server API
- gama-platform.github.io: contains the sources of GAMA's website and serves as a hub for raising issues about GAMA's website and documentation.
- gama.resources: contains various resources and archived resources used in GAMA (icons, logos, splash screens...) or around it (conferences material, documentation...)
- gama old repository: contains the Eclipse projects used to maintain the platform in its 1.9.x version. A documentation on how to build these versions from source is available here. Serves as a hub for raising issues about using GAMA 1.x. No features will be added in the future to this branch, which will primarily serve for making sure GAMA 1.9.x remains usable
- Open a new GitHub pull request with the patch if you think your addition is worth being included in the relevant repository: for the maintainance of 1.9.x or for adding new features. If this contribution concerns the documentation, the GAMA Server clients, or experimental features, head to their respective repositories.
- Ensure the PR description clearly describes the problem and solution or the new addition. Include the relevant issue number if applicable.
- Suggest your change in the gama-dev mailing list or in the discussion section of GAMA.
- Do not open an issue until you have collected positive feedback about the change. GitHub issues are primarily intended for support.
- Ensure the bug was not already reported by searching on GitHub in GAMA 1.x issues or GAMA issues.
- If you're unable to find an open issue addressing the problem, open a new one in the corresponding repository. Be sure to include a title and clear description, as much relevant information as possible, and a code sample or a test case demonstrating the expected behavior that is not occurring. Templates are provided to help you contribute.
- Ask any question about how to use GAMA in the gama-platform mailing list.
- Discuss potential evolutions, enhancements, changes in the discussion section of GAMA
- Consult the documentation on the website.