Commit e282794c authored by LE GAC Renaud's avatar LE GAC Renaud
Browse files

Update docs/user to add the citations chapter.

parent a6bfb770
.. include:: hyperlinks.txt
Les citations
-------------
Pour les articles dont les notices sont stockées dans *inspirehep.net*
le nombre de citations de chaque article est mise à jour régulièrement.
Limbra interoge *insirehep.net* afin de stocker l'évolution
du nombre de citations en fonction du temps pour chaque article.
Cette procédure est automatisée. Elle a lieu tous les deux à trois jours.
Plusieurs actions sont disponible pour manipuler cette information:
* ``Rapports > citations``
génére des graphes globaux pour le laboratoire, pour une equipe, *etc*
* ``Rapports > top citations``
génère une table avec les articles les plus citées.
Cette action permet aussi d'extraire des données au format CSV
pour des analyses détaillées.
* ``taches planifiées > citations``
permet de voir le compte rendu de la dernières mise
à jour du nombre de citations par article.
.. attention::
Les estimateurs liés au nombre de citations doivent être
interprétés avec beaucoup de précautions.
Les estimateurs globaux
^^^^^^^^^^^^^^^^^^^^^^^
Démarrer l'action :
.. index::
pair: Rapports; citations
.. line-block::
``Rapports > citations``
L'interface est similaire à celle de l'action ``Rapports > graphes``
par exemple.
Le *Selector*, à droite, permet de définir les paramètres spécifiques à
cette exécution. Il comprend six conditions :
* **Année**
le graphe est réduit aux enregistrements publiés dans l'année,
quand le premier champ est défini, ou pour chaque année d'une
période, quand les deux champs sont définis. Toutes les publications
sont utiliseé quand les deux champs sont vides.
* **Equipe**
le graphe est réduit aux enregistrements appartenant à l'équipe.
* **Projet**
le graphe est réduit aux enregistrements appartenant au projet.
* **Rôle**
le graphe est réduit aux enregistrement pour lequel le rôle des
auteurs corresponds à celui spécifié.
* **Graphe**
sélectionne le graphe que l'on veut construire.
Les valeurs possibles sont *Vue générale*, *Somme des citations*,
*Moyenne des citations par article* et *H-index*.
* **Format**
le graphe peut être exporté au format HTML, PDF ou PNG.
Pour lancer la fabrication du graphe, entrer une condition puis taper
sur la touche ``ENTER`` ou cliquer sur le bouton ``Go``.
Le résultat apparaît dans le panneau central.
La *Vue générale*, illustrée sur la :numref:`fig-citations-overview`,
compte le nombre d'articles en fonction du nombre de citations.
Son aussi calculer les estimateurs classiques :
* la somme total des citations
* le nombre moyen de citations par articles
* le facteur *h-index*
.. _fig-citations-overview:
.. figure:: images/citations_overview.png
:align: center
:width: 80%
Histogram qui montre le nombre d'artclies en fonction
du nombre de citations.
La *somme totale des citations* en fonction du temps est illusté sur la
:numref:`fig-citations-sum`.
Le deuxième graphe montre la différence du nombre de citations entre deux
*scans*. Attention, l'axe des *y* ne commence pas à zéro pour le premier plot.
.. _fig-citations-sum:
.. figure:: images/citations_sum.png
:align: center
:width: 80%
La somme totale des citations en fonctions du temps.
La *nombre moyen de citation par article* en fonction du temps est illusté
sur la :numref:`fig-citations-avg`.
Attention, l'axe des *y* ne commence pas à zéro.
.. _fig-citations-avg:
.. figure:: images/citations_avg.png
:align: center
:width: 80%
Le nombre moyen de citations par article en fonctions du temps.
L'évolation du *facteur h* en fonction du temps est illusté
sur la :numref:`fig-citations-h-index`.
Attention, l'axe des *y* ne commence pas à zéro.
.. _fig-citations-h-index:
.. figure:: images/citations_h_index.png
:align: center
:width: 80%
Le facteur *h* en fonctions du temps.
Les publications les plus citées
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Démarrer l'action :
.. index::
pair: Rapports; top citations
.. line-block::
``Rapports > top citations``
L'interface est similaire à celle de l'action ``Rapports > graphes``
par exemple.
Le *Selector*, à droite, permet de définir les paramètres spécifiques à
cette exécution. Il comprend cinq conditions :
* **Année**
la liste est réduite aux enregistrements publiés dans l'année,
quand le premier champ est défini, ou pour chaque année d'une
période, quand les deux champs sont définis. Toutes les publications
sont utiliseé quand les deux champs sont vides.
* **Equipe**
la liste est réduite aux enregistrements appartenant à l'équipe.
* **Projet**
la liste est réduite aux enregistrements appartenant au projet.
* **Rôle**
la liste est réduite aux enregistrement pour lequel le rôle des
auteurs corresponds à celui spécifié.
* **top**
définit le nombre de publications avec le plus grand nombre de
citations qui seront cités dans la liste.
Il permet de construire le *top 10* ou *top 50* par exemple.
Pour construire la liste, entrer une condition puis taper
sur la touche ``ENTER`` ou cliquer sur le bouton ``Go``.
Le résultat apparaît dans le panneau central.
La figure montre un example de *top 10*
.. _fig-citations-top-10:
.. figure:: images/citations_top_10.png
:align: center
:width: 80%
La liste des 10 publication avec le plus grand nombre de citations.
Extraction des données pour une analyse détaillée
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
L'action ``Rapports > top citations`` permet aussi d'extraire des données
au format CSV afin d'effectué des analyses détaillées.
La table contient les information suivante :
* domaine scientifique
* équipe
* projet
* référence de la publication
* nombre de citations
* année de la publication
Après avoir généré la liste, l'extraction s'effectue en deux temps:
1. selectioner les colonnes de la table que vous voulez extraire.
Pour cela il suffit de cliquer sur la fléche qui apparait quand le
curseur de la souris survole l'entête d'une colonne.
2. positioner le curseur sur la table, cliquer sur le bouton droit,
puis cliquer dans le menu sur la ligne ``Exporter en CSV...``.
\ No newline at end of file
......@@ -106,7 +106,7 @@ Le panneau de droite est maintenant divisé en deux parties comme le montre la
Construire un graphe.
La *Selector*, à droite, permet de définir les paramètres spécifiques à
Le *Selector*, à droite, permet de définir les paramètres spécifiques à
cette exécution. Il comprend huits conditions :
* **Année**
......@@ -132,7 +132,8 @@ cette exécution. Il comprend huits conditions :
* **Format**
le graphe peut être exporté au format HTML, PDF ou PNG.
Pour lancer la fabrication du graphe, cliquer sur le bouton ``Go``.
Pour lancer la fabrication du graphe, taper
sur la touche ``ENTER`` ou cliquer sur le bouton ``Go``.
Le résultat apparaît dans le panneau central.
Créer un nouveau graphe
......
......@@ -20,6 +20,7 @@ Guide utilisateur
lists
metrics
graphs
citations
roles
check_validate
workflow
......
......@@ -100,8 +100,10 @@ cette exécution. Il comprend sept conditions :
* **Format**
la liste peut être exportée au format BibTex, LaTeX, ODT ou PDF.
Pour lancer la fabrication de la liste cliquer sur le bouton ``Go``.
Le résultat apparaît dans le panneau central quand le format HTML est sélectionné.
Pour lancer la fabrication de la liste taper
sur la touche ``ENTER`` ou cliquer sur le bouton ``Go``.
Le résultat apparaît dans le panneau central quand le format HTML
est sélectionné.
.. note::
......
......@@ -95,7 +95,8 @@ cette exécution. Il comprend quatre conditions :
le choix de la *métrique* et de l'*année* sont les
conditions les plus importantes.
Pour lancer la fabrication de la métrique, cliquer sur le bouton ``Go``.
Pour lancer la fabrication de la métrique, taper
sur la touche ``ENTER`` ou cliquer sur le bouton ``Go``.
Le résultat apparaît dans le panneau central.
.. note::
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment