HOW TO: Premier déploiement

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.

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é.

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
• Initialiser le submodule: git submodule init && git submodule update
• 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:

• Demo follow ball
• Get Ball
• Go To Position

Devraient fonctionner minimalement. (1er octobre 2016: seulement pour l'ID 4 bleu) Pour les deux dernières, le UI-Debug devrait afficher le chemin calculé.