README - Outil d'analyse Twitter

Description :

Cet Outil permet d'analyser et d'exploiter des données issue de Twitter afin de produire des rapports et des graphiques. L’exploitation de ces données doit par exemple pouvoir fournir des ensembles de tweets, définis par un critère, ainsi que la préparation de graphiques en format format SVG et/ou PNG.

Auteurs :

Projet effectué par 4 étudiants de l'UTT dans le cadre de l'unité d'enseignement GL02.
Equipe “Rocko”.

• Chabrit Quentin
• Nosal Loïck
• François Vincent
• Raymond Thomad

Installation :

Pour faire fonctionner le programme il vous faudra télécharger le projet.

svn checkouk <URI du projet>

Il faut ensuite vous placer dans le dossier /trunk du projet et effectuer la commande :

 npm install

Cette commande permet d'installer toutes les dépendances nécessaire au fonctionnement du projet. Pour pouvoir utiliser npm il faut que Node.js soit installé sur votre machine.

Il faut également se placer dans le dossier /trunk et effectuer la commande :

 npm install canvas

cette ligne permet d'installer le module Canvas pour pouvoir générer un graphique en png grâce à la fonction dédiée.

Commandes :

L'outil propose plusieurs commandes qui sont associées aux actions détaillées ci-dessous.
Pour effectuer ces commandes, il faut vous placer dans le dossier /trunk
Pour effectuer les commandes, il faut avoir Node.js installé sur votre machine.
Si des valeurs sont indiquées comme celle-ci <valeur> c'est qu'il faut remplacer tout ce bloc par une ou des variables que vous choisissez.

Obtenir un menu interactif permettant de lancer toutes les commandes :

node . start

Obtenir la liste détaillée des commandes disponible :

node .

Obtenir les information détaillées et les options sur une commande spécifique :

node . <nom de la commande> --help

Obtenir le top 10 des tweets les plus retweetés avec un hashtag spécifique :

node . top10tweetMoreRetweet <hashtag>

Obtenir tous les tweets correspondant à un hashtag sur une période donnée :

node . tweetsSurUnHashtag <hashtag> <dateDébut> <dateFin>

dateDébut et dateFin doivent suivre le format de l'exemple suivant :
"Tue Mar 20 11:33:25 +0000 2018"

Par exemple :

node . tweetsSurUnHashtag EAW18 "Tue Mar 20 11:33:25 +0000 2018" "Sat Mar 24 01:04:22 +0000 2018"

Cette commande retournera le nombre de tweet par jour possédant le hashtag "EAW18" entre le 20/03/2018 et le 24/03/2018

Obtenir le Top 10 des auteurs de tweets avec le plus d'informations à leur sujet :

node . top10tweetWithInfo

Obtenir la proportion en pourcentage de tweets par pays :

node . proportionTweetPerCountry

Extraire la liste des hashtags associés à un hashtag de référence :

node . hashtagAssociated <hashtag>

Extraire la liste des tweets qui correspondent à des criteres définies

Voici les différents critères optionnels que vous pouvez utiliser pour filtrer les tweets :

• --hashtag : filtre tous les tweets qui comportent ce hashtag.
• --keyword : filtre tous les tweets qui comportent ce mot-clé.
• --author : filtre tous les tweets écrit par l'auteur.
• --retweetCount : filtre tous les tweets en fonction d'un nombre de retweet minimal.
• --country : filtre tous les tweets en fonction du pays spécifié.
• --minDate : filtre tous les tweets écrits après ou à cette date (format MM/DD/YYYY ou MM-DD-YYYY).
• --maxDate : filtre tous les tweets écrits avant ou à cette date (format MM/DD/YYYY ou MM-DD-YYYY).

Voici la commande à utiliser :

node . searchBy <liste des options ... >

Par exemple :

node . searchBy --hashtag eaw18 --retweetCount 20 --minDate 03/22/2018

Cette commande permet d'obtenir les tweets comportant le hashtag "eaw18", retweetés au moins 20 fois et écrits après le 22 mars 2018.

Extraire la liste des hashtags associés à un hashtag de référence :

node . hashtagAssociated <hashtag>

Obtenir le top 10 de personnes avec le plus de followers :

node . top10Person

Remarques

Ce logiciel a été développé pour correspondre à un cahier des charges. Les commandes correspondent à des spécifications de ce dit cahier des charges.