RoboCupULaval•Jul 30, 2024
StrategyAI
StrategyAI
Toute contribution au code est sous la licence libre MIT.
Information générale
Ce dépôt regroupe les différents outils utilisés pour élaborer
l'intelligence artificielle de Robocup ULaval.
L'implémentation de l'intelligence artificielle est basée sur
la STA, dont le papier de recherche se retrouve
dans le dépôt Admin de l'équipe IA.
Installation
Pour install ultron et tous les outils (referee, simulator, ui and autoref):
Workflow Git
Le dépôt StrategyAI fonctionne avec les pull requests:
Chaque nouvelle feature/issue doit être sur sa propre branche (git checkout -b branch_name).
Une fois qu'une feature/issue est résolue, faire un pull-request.
Standard de code
Pour que le code soit considéré comme valide, celui-ci doit respecter le standard de code PEP-8.
De plus, le code doit avoir les tests unitaires associés.
Emplacements des logiciels
~/robocup/tools
grSim/: Simulateur, peut-être lancer via la commande grsim
ssl-refbox/: Logiciel de Referee, pour le lancer cd ~/robocup/tools/ssl-refbox && ./sslrefbox
~/robocup/ultron
StrategyAI/: Back-end, pour lancer voir plus bas
UI-Debug/: Front-end, pour lancer voir plus bas
Exemple pour lancer deux équipes:
À modifier selon vos chemins, à lancer à partir de la racine du dépôt de StrategyAI. Ce fichier est disponible à la racine du dépôt sous le nom de dual_launch.sh
Setup dans pycharm
Ajout de l'environnement virtuelle
Pour rajouter l'environnement virtuel dans Pycharm aller dans File->Settings->Project StrategyAI->Project Interpreter.
Appuyez sur l'icone d'un engrenage ->Add.
Dans la fenêtre qui apparaît selectionner Existing Intepreter. Le chemin pour la location entrée: /home/votre_nom/robocup/ultron/virtualenv/bin/python.
Ajout des runners
Pour facilement tester l'ia dans Pycharm, il est utile de pouvoir lancer la lancer en utilisant un Run Configuration.
Créer une configuration ayant ses paramètres, elle va lancer l'intelligence artificiel en simulation:
name -> ia sim blue
Script Path -> /home/votre_user/robocup/ultron/StrategyAI/main.py
Parameter -> config/sim.cfg blue positive
Working Directory -> /home/votre_user/robocup/ultron/StrategyAI
Créer une configuration ayant ses paramètres, elle va lancer l'interface graphique de débugage:
name -> UI Debug sim blue
Script Path -> /home/votre_user/robocup/ultron/UI-Debug/main.py
Parameter -> ../StrategyAI/config/field/sim.cfg blue
Working Directory -> /home/votre_user/robocup/ultron/UI-Debug