HOWTO: Installer l'IA

Pour les nouveaux membres du projet, cet article explique les éléments à installer et déployer afin d'avoir en main un environnement de travail minimal.

La team-ia n'impose pas d'environnement de développement standardisé. Il est seulement recommandé d'avoir un éditeur de texte ou IDE qui fournit au minimum la mise en évidence syntaxique pour python (syntax highlight). Idéalement, une intégration avec git, une gestion de projet, un correcteur, un débogueur et de pouvoir exécuté un script python sont des éléments recommandés.

Le tutoriel va surtout montré la démarche d'installation pour un utilisateur de Windows ou de Linux qui souhaite utiliser Pycharm.

Dépendances du projet

Le projet actuellement est écrit en Python 3.5+. La distribution Anaconda est suggérée.

Comme éditeur de texte, PyCharm est un bon choix. Au minimum, notepad++ peut faire le travail. Si un IDE est souhaité, il existe des modules d'intégration pour Eclipse.

Git est utilisé pour le versionnement du code source. Les interfaces graphiques font un excellent travail, cependant la documentation réfère aux commandes directement.

GrSim est actuellement le simulateur du projet. En windows, une version précompilé est disponible. En Linux, il est recommandé de le compiler contre votre version distribution. La procédure est documenté.

Démarche d'installation

• Si vous êtes sous Windows, téléchargez et installez Git for Windows.
• Si vous êtes sous Linux, ouvrez un terminal et installé les paquets avec la commande suivante suivant(TODO RAJOUTER LES PACKETS QUI SONT MANDATOIRE):

sudo apt-get install git 

• Il y a deux versions de Pycharm: Community Edition et Professional Edition. Vous pouvez utilisé l'un ou l'autre pour travailler sur l'IA. Si vous êtes étudiant, vous avez accès à la version professionnelle des logiciels de JetBrain. Pour y avoir accès inscrivez-vous ici.
• Vous pouvez télécharger Pycharm ici. Procédez à l'installation du logiciel.
• Ouvrez Pycharm et cliquez sur Check out from Version Control -> GIT
• Entrez https://github.com/RoboCupULaval/StrategyIA dans le champs Git Repository URL. Notez bien le Parent Directory , vos projets Pycharm seront copier dans ce dossier. Sous Linux la location est /home/USERNAME/PycharmProjects, sous Windows C:\Users\USERNAME\Documents\PycharmProjects.
• File -> Close Project . Répétez les deux précédentes étapes, mais avec https://github.com/RoboCupULaval/UI-Debug comme Git Repository URL. Vous devriez avoir maintenant deux projets Pycharm: StrategyIA et UIDebug.
• Ouvrez un terminal sous

Organisation des dépôts

Le projet utilise ces dépôts:

• StrategyIA
• RULEngine
• UI-Debug
• grSim
• Admin

Étape pour lancer l'IA une première fois

Dépendances

• Installer GrSim
• Lancer GrSim
• Cloner le dépôt UI-Debug
• Lancer main.py dans le dépôt UI-Debug: ceci ouvrira l'interface de débogage graphique
• Cloner le dépôt StrategyIA
• Lancer main.py de StrategyIA

Vérification

Si tout a fonctionné, le simulateur devrait fonctionner, l'interface de débogage devrait afficher les robots et l'IA devrait envoyer des logs à l'interface de débogage. Pour valider:

• Vérifier si GrSim log des erreurs dans son interface (en bas, message en rouge)
• Vérifier si le UI-Debug reçoit bien les frames de vision de la part de GrSim: les robots devraient apparaitre et si un robot est déplacé dans GrSim (clic droit, locate current robot here) il devrait être déplacé dans le UI-Debug
• Vérifier si le UI-Debug reçoit des ticks de l'IA (outil -> loggeur)

Tests plus avancés

Si tout fonctionne, ouvrir l'interface pour manipuler les Tactique: outil -> Contrôleur de Stratégie Changer à l'onglet Tactique. Les tactiques:

• Get Ball
• Go To Position