stephenyan / strategyai

Robocup ULaval's artificial intelligence software (team ULtron)

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):

sudo apt-get install curl git
sh -c "$(curl -fsSL https://raw.githubusercontent.com/RoboCupULaval/StrategyAI/dev/scripts/install_from_scratch.sh)"

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

source ~/robocup/ultron/virtualenv/bin/activate
bash ./dual_launch_two_ui.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