Frequently Asked Questions

Table of Contents

1. What is the SCOP Framework?
2. How do I get started with MAGE?
3. How does testing work in MAGE?
4. Why are assertions scheduled for later execution in tests?
5. What roles are available in MAGE?
6. How do I report a bug or request a feature?

---

What is the SCOP Framework?

MAGE is an advanced simulation or agent-based framework designed to model, test, and simulate complex scenarios, allowing users to craft dynamic agent-based models with ease.

---

How do I get started with MAGE?

1. Installation: Download the latest version from our official website and follow the installation guidelines.
2. Documentation: Familiarize yourself with the official documentation, tutorials, and examples provided.
3. Community: Join our community forum or Discord channel to interact with other MAGE users, which is a great place to ask questions and share experiences.

---

How does testing work in MAGE?

Testing in MAGE integrates with JUnit 5, enabling users to specify, run, and validate tests for agents and simulations. Users can craft test cases, employ assertions, and schedule tests for execution, ensuring agents and simulations perform as intended.

---

Why are assertions scheduled for later execution in tests?

In the SCOP Framework, tests often run as part of simulations which unfold over a specific duration or set of events. Assertions are scheduled to be executed at precise moments during this simulation run. This design ensures that the simulation reaches the desired state or event before the assertions are checked.

---

What roles are available in MAGE?

MAGE has a variety of roles, including but not limited to:

• Experimenter: Oversees and manages experiments.
• Tester: Primarily used for testing purposes, running assertions and checks.
• Scheduler: Manages the timing and sequencing of events or actions.
• Interlocutor: Handles communication and interactions between agents.

---

How do I report a bug or request a feature?

If you encounter an issue or have suggestions for the SCOP Framework:

1. Visit our official GitLab repository.
2. Check if the issue or suggestion has already been reported.
3. If not, create a new issue, detailing the bug or feature request, and follow the template provided.
4. Our development team will review and respond to your submission promptly.

---

For more detailed information or specific queries, please refer to our official documentation or contact our support team.