robocupulaval / admin Goto Github PK

Donner les explications pour qu'un nouveau puisse le plus rapidement possible faire fonctionner le moteur, le simulateur et une stratégie.

Une page qui explique comment compiler dans un environnement connu le simulateur grSim et le faire fonctionner correctement avec le reste de l'environnement.

Vient complimenter #1

Concevoir une série de benchmark automatisé pour que l'équipe d'embarqué puisse valider leurs travaux.

La calibration de la caméra doit être documentée adéquatement.
Les détails doivent être suffisant pour qu'un membre de la team-ia puisse la calibrer sans connaissance préalable.
Idéalement, un membre d'un autre département doit aussi pouvoir effectuer la calibration.

Rédiger une série d'articles qui explique comment bâtir une stratégie simpliste à l'aide des différentes primitives disponibles.

Les articles peuvent passer d'un sujet comme "effectuer une passe", à comment afficher graphiquement une information de debug.

Décrire le processus recommandé pour utiliser git dans le cadre du projet.

Les procès-verbaux sont actuellement écrit en format latex. Une documentation rapide doit être écrite pour expliquer comment installer un environnement latex en windows et en linux et compiler les fichiers en pdf.

Idéalement un service d'intégration continu devrait permettre de bâtir l'ensemble des fichiers et de rendre leur téléchargement disponible.

Actuellement, l'équipe ne possède que quelques patterns et certains d'entre eux sont mal identifiés.
Des discussions ont été entâmés pour renouveller les patterns et potentiellement corrigé des bogues comme le duplicat d'un pattern pour 2 ids. Avoir une copie de chaque pattern serait utile pour tester tous les ids et différents combinaisons d'ids actifs.

• Évaluer si des modifications aux patterns de références est utile
• Produire les patterns pour tous les ids d'une couleur
• Produire quelques (3) patterns de l'autre couleur

La séance d'intégration du 4 mai a soulevée deux questions importantes:

• Quelles sont les contraintes de la compétition Robocup SSL en lien avec la caméra?
  L'utilisation d'une caméra FireWire est-elle strictement nécessaire et le système lors d'une compétition enverra quelles informations exactement?
• Quelles sont les contraintes physiques de la caméra?
  Distance du terrain et autres éléments pertinent.

NB: Le terrain devrait être schématisé pour que la géométrie soit connue.

La procédure pour démarrer l'IA sur l'ordinateur d'intégration du PLT-0108 doit être documenté dans une page wiki.

Rédiger une page qui explique STA, comment les aspects stratégiques (stratégie, décisif et réactif) s'y intègrent, expliquer ces éléments et rediriger vers les pages qui explique les features plus précise du cadre.

Optionnellement fournir un lien vers le white paper de STP.

Retirer les dépôts qui ne servent plus.

Nous avons besoins de gens pour communiquer clairement avec le département d'embarqué.
Les problèmes commun de l'équipe ia de l'équipe embarqué doivent être cernés.
Un API clair doit être défini pour permettre d'intégrer pleinement les travaux des deux équipes: lire ça doit être fonctionnel!

Ajouter de la documentation de base concernant les unit tests, nosetests (installation en linux) et quelques exemples de unit tests (diriger vers le code source approprié).

Le PEP-8 fournit une partie importante d'un standard de code, mais certains aspects peuvent être mieux définis.

Des recherhces, des lectures et des expérimentations sont nécessaires pour raffiner le standard de code.

L'ordinateur d'intégration dans le PLT-0108 doit être nettoyé concernant le code et les logiciels de la team-ia.

• Seul le dépôt StrategyIA devrait être cloné par défaut
• La branche master du dépôt devrait être utilisable pour les présentations
• La branche dev peut-être utilisé lors des séances d'intégration
• L'ordinateur n'est pas un poste de développement

L'objectif est que l'IA soit fonctionnelle après simplement un git clone.

Ajouter aux dépôts de StrategyIA et de RULEngine un service d'intégration continue.

Les fonctionnalités recherchées:

• S'exécuter sur push dans dev/master
• S'exécuter automatiquement chaque nuit
• S'exécuter au besoin sur demande/pull request
• Publier des résultats en format html
• Rouler les tests unitaire
• Analyser le pourcentage de couverture
• Générer automatiquement la documentation du code (e.g: sphinx)
• Passer le code contre PEP8 ou autre standard

(@felixpelletier: vois-tu autre chose de pertinent?)

Ajouter une page qui survol les principales features du moteur et du cadre de stratégies.
Indiquer la ou les personnes ressources avec optionnellement une photo.

Pour les nouveaux venu, se familiariser avec le code source existant.

Avec de nouveaux membres qui souhaitent participer, la documentation minimale pour savoir quoi installer et comment devraient être mise à jour. C'est aussi le moment de lever des irritants et les complexités non essentiel à l'environnement.

Ajouter la documentation pour le behavior tree qui va être intégré dans STA.

@felixpelletier J'ai décidé de laisser fermer les issues sur le dépôt de grSim, si plusieurs bogues et tâches s'y rapporte, on ouvrira, entre temps on va gérer les issues sur ce dépôt.

Puisque notre fork grSim a été modifié, nous devons être en mesure de le faire compiler en windows.
Cette procédure doit être aussi simple que possible, documenter et idéalement exécutable par un service d'intégration continu.

Les premiers travaux sont assignés à @felixpelletier.

...

Une documentation a déjà été écrite pour configurer la vision.
Cependant cette documentation assume grandement que le logiciel de vision a déjà été utilisé par le passé et que certains paramètres sont déjà configurés.

• Option d'affichage
• Paramètre de capture et lien avec flycap
• Calibration de la caméra et détection des points de contrôle
• Paramètre de détection d'un marqueur de pattern
• Paramètre d'erreur de détection d'un marqueur
• Cible pour l'image des patterns de références
• Messages de debogue ajouté par l'équipe

Optionnellement et en cas de disponibilité, le code du logiciel de vision devrait être révisé pour amélioration l'acquisition. Par exemple, ajouter des tests unitaires (qui sont certainement absent) pour les algorithmes de détections serait une façon de comprendre dans le détail l'outil. Il est à long terme innacceptable que cet outil reste une boîte noire.

Compléter la documentation d'introduction de chaque dépôt.

Elle devrait décrire à quoi sert le dépôt, ce qu'on peut-y trouver.
Déterminer les autres informations pertinente à y inscrire.