Create MATRX tutorial(s) and fix existing tutorials

[thaije]

Is your feature request related to a problem? Please describe. I want tutorials and help on how MATRX works, for beginners and more advanced users.

Describe the solution you would like A basic tutorial based on the BW4T task (see #284) introducing:

• [ ] Basic concepts of MATRX (agents, case, builder, objects, gridworld, etc.)
• [ ] How agents work with the state and actions
• [ ] How action duration works
• [ ] How the state works
• [ ] How to send messages
• [ ] How traversability of objects works
• [ ] How objects and the update() function work
• [ ] How the context menu works
• [ ] Doing a task with multiple people

Include a FAQ with some specific questions:

• [ ] Where to find more documentation (the API docs, other tutorials, etc)
• [ ] Where to find example usecases (example of BW4T, Ruben experiment, Emma experiment, triage experiment)
• [ ] Can I use MATRX for 3d environments?
• [ ] How fast is MATRX?
• [ ] I get error X, how do I solve this?

More advanced tutorial(s):

• [ ] How to create custom messages
• [ ] How to create custom actions
• [ ] How to create custom (human) agents
• [ ] How to customize the context menu
• [ ] How to create a custom frontend

Using MATRX for experiments

• [ ] How logging works
• [ ] Deploying MATRX online (see #283)
• [ ] Running MATRX with Docker / VM (see #283 or https://github.com/matrx-software/MATRX_online)
• [ ] Running MATRX with multiple computers connected

Describe alternatives you have considered Videos that show how it works, but that requires us making these tutorials anyway and is more work because of recording and editing etc.

Additional context The most requested improvement on all of MATRX.

[thaije]

@jwaa did I miss anything?

[jwaa]

@jwaa did I miss anything?

I think you have the most important bits. Regarding the FAQ, we already have one. So either add to the questions there or add new ones.

You can also add the tutorials we already have to this list and check them already. So this issue can be used to track them all not only the new ones.

Finally, I still think that a tutorial where much of these separate things are combined might be useful. Especially since you cannot really do some of these things without already having a task inplace.

Ideas for such tasks we once had were;

• Tetris
• Overcooked
• Tag
• Maze navigation
• Red/Blue teaming
• BW4T
• ...

[thaije]

The default tutorial: https://matrx-software.com/docs/tutorials/basics/creating-your-first-world/ Does not work because an error is given when there is no (human) agent added.

Also some of the tutorials do not work because of refactoring, such as this one, that doesn't work as the agent parameter is renamed to agent_brain. So these tutorials should be checked as well.

[jwaa]

The default tutorial: https://matrx-software.com/docs/tutorials/basics/creating-your-first-world/ Does not work because an error is given when there is no (human) agent added.

Thanks for pointing that out! Does it fail right from the first code block or later?