1. Accueil
  2. Docs
  3. Pour tout savoir sur Lodex !
  4. Les routines et graphes

Les routines et graphes

Définition d’une routine

Liste des routines disponibles dans Lodex

Nom de la routine

  • explication de la routine
  • avec quel(s) graphe(s) elle s’utilise (illustration avec graphique utilisé)
  • comment on la déclare dans “valeur” lors de la création d’un modèle (/api/run/nom de la routine/identifiant/)
  • limites de l’utilisation de la routine

Nom du graphe

  • quelle routine pour aboutir à ce graphique
  • choix du graphe, que veut-on visualiser, avantages à utiliser un graphe plutôt qu’un autre ?

Comment créer une routine non disponible dans Lodex (à faire ?)

Les routines

Les routines de Lodex sont des scripts, fournis par Lodex ou stockables n’importe où sur le web, qui peuvent effectuer des agrégations, des calculs, des reformatages et renvoyer des données sous une forme utilisable (souvent un format de type graphique).

Les routines sont appelées via l’API web de Lodex, et s’appliquent à un champ (ou plusieurs). Quand on connaît le nom de la routine à utiliser (disons routine exemple), il suffit de l’ajouter derrière /api/run/ pour obtenir la route à utiliser: /api/run/routine exemple

Faire copie d’écran ou lien vers un paramétrage d’un modèle ?

 

Déclaration des routines dans le fichier de configuration

Pour qu’une routine soit utilisable dans LODEX via son API, il faut qu’elle soit déclarée dans le champ routine du fichier de configuration.–>  faire lien vers  partie “Paramétrages d’une instance – Routines, loaders, exporters”
Le nom de la routine doit être exactement le même que celui du fichier en ligne (avec l’extension .ini).

Lors de la création et du paramétrage d’un modèle, la routine doit être déclarée dans la partie “Comment la valeur est créée” de la façon suivante :

/api/run/routine/identifiant

où :
  • routine est la routine utilisée
  • identifiant est le code attribué par LODEX au champ représenté (voir dans le modèle) Faire lien vers la page “le modèle”
 
Le résultat d’une routine peut être visualisé à partir d’une URL de la forme:
http://url-instance/api/run/routine/identifiant
où :
  • url-instance est l’URL de l’instance
  • routine est la routine utilisée
  • identifiant est le code attribué par LODEX au champ représenté (voir dans le modèle)

 

Le choix de la routine se fait en fonction du format d’affichage souhaité (type de graphique par exemple).

La description des routines et des graphiques déclinée dans les parties suivantes a pour but de préciser la routine utilisable pour afficher le type de graphique souhaité par exemple, ou d’autres formats.

Routines disponibles dans Lodex (de la routine aux graphes)

 

all-document

Donne, pour tout le corpus, le contenu de tous les documents en JSON.

classif-by

Elle est destinée à un type de graphique permettant de visualiser les évolutions diachroniques du poids de thématiques contenues dans les documents d’un corpus.

Cette routine doit alors être déclarée dans “Comment la valeur est créée” selon : /api/run/classif-by/identifiant/   où identifiant est le code attribué par LODEX au champ représenté.–> à expliquer, en faisant copie d’écran ?

Cette routine est destinée à être utilisée avec le format graphique :

  • Graphique de flux

 

close-by

Cette routine est utilisée pour créer le “graphique” aster plot

 

count-all

Cette routine compte le nombre de documents du corpus. Ce calcul est dynamique, le nombre de documents se met à jour automatiquement si on ajoute un ou plusieurs fichiers supplémentaires au corpus

Elle peut être utilisée, par exemple, avec le format Texte – Chiffre en gras (faire lien vers ce format) pour afficher le nombre de documents sur la page d’accueil de l’instance.

Elle doit alors être déclarée dans “Comment la valeur est créée” selon : /api/run/count-all/–> à expliquer, lien vers modèle ou copie d’écran

count-by-fields

Cette routine compte le nombre de documents du corpus pour chacun des champs déclarés dans le modèle.

exemple

cross-by

Croise les éléments pour un champ ou plusieurs champs et compte le nombre d’occurrences de chaque croisement.

Crée les paires (source et cible) entre les éléments de 2 champs (champs identiques ou différents) déclarés selon :

  • /api/run/cross-by/identifiant1/identifiant1/

  • /api/run/cross-by/identifiant1/identifiant2/

et compte, pour chaque paire, le nombre de co-occurrences.

Cette routine se comporte comme la routine pairing-with , le petit +: elle sait interpréter les paramètres associés aux graphiques:

  • Nombre max de champs (=maxSize)
  • Valeur maximum à afficher (=maxValue)
  • Valeur minimum à afficher (=minValue)
  • Trier par valeur/label (=sortBy)

Elle peut, en particulier, être utilisée avec les formats Réseau et Carte de chaleur.

Attention : dans le cas où cette routine s’applique à un seul champ (/api/run/cross-by/identifiant1/identifiant1/), elle conserve les auto-paires (source et cible identiques). Cela peut être intéressant avec le format Carte de chaleur pour visualiser la diagonale, mais peut être gênant avec d’autres formats.

exemple

decompose-by

Croise les éléments pour un champ ou plusieurs champs et compte le nombre d’occurrences de chaque croisement.

Crée les paires (source et cible) entre les valeurs de 1 champ ou plusieurs champs (champs identiques ou différents) selon :

/api/run/decompose-by/identifiant1/

/api/run/decompose-by/identifiant1/identifiant2/

et compte, pour chaque paire, le nombre de co-occurrences.

Cette routine se comporte comme la routine graph-by, le petit +: elle sait interpréter les paramètres associés aux graphiques:

  • Nombre max de champs (=maxSize)
  • Valeur maximum à afficher (=maxValue)
  • Valeur minimum à afficher (=minValue)
  • Trier par valeur/label (=sortBy)

Elle peut, en particulier, être utilisée avec les formats Réseau et Carte de chaleur

Attention : dans le cas où cette routine s’applique à plusieurs champs (/api/run/decompose-by/identifiant1/identifiant2/), elle crée les paires identifiant1/identifiant2 mais aussi identifiant1/identifiant1 et identifiant2/identifiant2, ce qui peut ne pas être adapté pour un réseau.

exemple

distance-with

 

distinct-alpha-2-alpha3-from

Transforme les codes ISO 2 du champ pays en leurs codes ISO 3 et compte le nombre de fois où ce pays apparaît (identifiant), selon son :

  • nombre d’occurrences si le champ n’est pas dédoublonné
  • nombre de documents si le champ est dédoublonné

Elle est, en particulier, utilisée avec le format Cartographie pour représenter les pays du corpus sur une carte du monde.

Attention : avant d’utiliser cette routine, il peut être utile de vérifier que les codes ISO 2 des pays du corpus correspondent bien aux codes ISO 2 dans la table de correspondance (faire une lien vers une table des correspondances des codes ISO 2 et ISO 3)

distinct-alpha-3-alpha2-from

Transforme les codes ISO 3 des pays du champ représenté en leurs codes ISO 2 et compte le nombre de fois où ce pays (identifiant) apparaît selon son :

  • nombre d’occurrences si le champ n’est pas dédoublonné
  • nombre de documents si le champ est dédoublonné

Elle est, en particulier, utilisée avec le format Cartographie pour représenter les pays d’un corpus sur une carte du monde.

Attention : avant d’utiliser cette routine, il peut être utile de vérifier que les codes ISO 3 des pays du corpus correspondent bien aux codes ISO 3 dans la table de correspondance.

distinct-alpha-3-ISO3166-1-from

Transforme les intitulés verbalisés (Anglais ou Français) des pays du champ représenté en leurs codes ISO 3 et compte le nombre de fois où ces pays apparaissent selon leur :

  • nombre d’occurrences si le champ n’est pas dédoublonné
  • nombre de documents si le champ est dédoublonné

Elle est, en particulier, utilisée avec le format Cartographie pour représenter les pays d’un corpus sur une carte du monde.

Attention : avant d’utiliser cette routine, il peut être utile de vérifier que les verbalisations des pays du corpus correspondent bien aux codes ISO 3 dans la table de correspondance.

distinct-by

Compte, pour chaque élément du champ représenté (identifiant), le nombre de fois où cet élément apparaît selon son :

  • nombre d’occurrences si le champ n’est pas dédoublonné
  • nombre de documents si le champ est dédoublonné

Cette routine se comporte comme la routine distinct-by-field. Contrairement à celle-ci, elle n’interprète pas les paramètres associés aux graphiques.

Cette routine peut être utilisée avec les formats graphiques :

  • Graphe à bulles
  • Diagramme en barres
  • Diagramme circulaire
  • Diagramme Radar
  • Cartographie (si code ISO 3 ou code ISO 2 des pays)

Elle doit alors être déclarée dans “Comment la valeur est créée” selon :

/api/run/distinct-by/identifiant/ où identifiant est le code attribué par LODEX au champ représenté.

exemple

distinct-by-field

Compte, pour chaque élément du champ représenté (identifiant), le nombre de fois où cet élément apparaît selon son :

  • nombre d’occurrences si le champ n’est pas dédoublonné
  • nombre de documents si le champ est dédoublonné

Cette routine se comporte comme la routine distinct-by, le petit +: elle sait interpréter les paramètres associés aux graphiques:

  • Nombre max de champs (=maxSize)
  • Valeur maximum à afficher (=maxValue)
  • Valeur minimum à afficher (=minValue)
  • Trier par valeur/label (=sortBy)

Cette routine peut être utilisée avec les formats graphiques :

  • Graphe à bulles
  • Diagramme en barres
  • Diagramme circulaire
  • Diagramme radar
  • Cartographie (si code ISO 3 ou code ISO 2 des pays)

Elle doit alors être déclarée dans “Comment la valeur est créée” selon :

/api/run/distinct-by-field/identifiant/ où identifiant est le code attribué par LODEX au champ représenté.

distinct-ISO3166-1-alpha2-from

Fournit le nombre de fois où un pays apparaît selon son :

  • nombre d’occurrences si le champ n’est pas dédoublonné
  • nombre de documents si le champ est dédoublonné

Elle est, en particulier, utilisée avec le format Cartographie pour représenter les pays d’un corpus sur une carte du monde.

Attention : avant d’utiliser cette routine, il peut être utile de vérifier que les formes d’écriture des pays verbalisés du corpus correspondent bien aux formes d’écriture des pays dans la table de correspondance.

exemple

distinct-ISO3166-1-alpha3-from

Transforme les valeurs verbalisées du champ pays en leurs codes ISO 3 et compte le nombre de fois où ce pays apparaît (code ISO 3), selon son :

  • nombre d’occurrences si le champ n’est pas dédoublonné
  • nombre de documents si le champ est dédoublonné

Elle est, en particulier, utilisée avec le format Cartographie pour représenter les pays du corpus sur une carte du monde.

Attention : avant d’utiliser cette routine, il peut être utile de vérifier que les formes d’écriture des pays verbalisés du corpus correspondent bien aux formes d’écriture des pays dans la table de correspondance.

distinct-with-quote-rate

 

distribute-by-date

Sert à créer des chronologies qui conservent les années sans document/de valeur nulle.

Cette routine est utilisée de manière optimale avec le format graphique :

  • Diagramme en barres

Elle doit alors être déclarée dans “Comment la valeur est créée” selon :

/api/run/distribute-by-date/identifiant/  où identifiant est le code attribué par LODEX au champ représenté.

exemple

distribute-by-decadal

Sert à créer des chronologies en regroupant les valeurs par décennie (utile pour des années dispersées sur plusieurs siècles).

Cette routine est utilisée de manière optimale avec le format graphique :

  • Diagramme en barres

Elle doit alors être déclarée dans “Comment la valeur est créée” selon :

/api/run/distribute-by-decadal/identifiant/  où identifiant est le code attribué par LODEX au champ représenté.

exemple

distribute-by-interval

Routine destinée à des graphiques pour lesquels on souhaite regrouper des valeurs (nombres entiers ou décimaux) dans des intervalles de pas “1”. ????

Cette routine peut être utilisée avec les formats graphiques :

  • Diagramme en barres
  • Diagramme circulaire
  • Diagramme radar

Elle doit alors être déclarée dans “Comment la valeur est créée” selon :

/api/run/distribute-by-interval/identifiant/  où identifiant est le code attribué par LODEX au champ représenté.

exemple

get-fields

pour utiliser des nombres affectés à des champs des ressources (pas de comptage, utilise la valeur numérique du champ), il faut pouvoir générer des paires _id /valeur contenant les valeurs de deux champs (en général, un libellé et un nombre, par exemple pour un camembert).

Pour sélectionner le libellé, on donne l’identifiant du champ contenant le libellé comme identifiant1 puis on ajoute l’identifiant du champ contenant la valeur numérique comme identifiant2.

/api/run/get-fields/identifiant1/identifiant2/

Exemples de ressources:

nom de fichier Unitex-anglais Unitex-français
wiley 4460007 12832
elsevier 5879095 82652
springer-journals 1424762 20131

résultat de la routine:

{
  "data": [
    {
      "_id": "wiley",
      "value": 4460007
    },
    {
      "_id": "elsevier",
      "value": 5879095
    },
    {
      "_id": "springer-journals",
      "value": 1424762
    }
  ]
}

graph-by

Croise les éléments pour un champ ou plusieurs champs et compte le nombre d’occurrences de chaque croisement.

Crée les paires (source et cible) entre les valeurs de 1 champ ou plusieurs champs (champs identiques ou différents) selon :

/api/run/graph-by/identifiant1/

/api/run/graph-by/identifiant1/identifiant2/

et compte, pour chaque paire, le nombre de co-occurrences.

Cette routine se comporte comme la routine decompose-by. Mais contrairement à celle-ci, elle n’interprète pas les paramètres associés aux graphiques.

Elle peut, en particulier, être utilisée avec les formats Réseau et Carte de chaleur

Attention : dans le cas où cette routine s’applique à plusieurs champs (/api/run/graph-by/identifiant1/identifiant2/), elle crée les paires identifiant1/identifiant2 mais aussi identifiant1/identifiant1 et identifiant2/identifiant2, ce qui peut ne pas être adapté pour un graphique réseau.

exemple

labeled-resources

Récupère les ressources, mais en enlevant les champs _id, publicationDate, uri, et total. Tous les autres champs sont fournis.

De plus, les chaînes numériques (comme “123”) sont converties en nombres (comme 123).

C’est utile pour des formats comme Vega Lite.

Comme elle retourne tous les champs, aucun champ n’est fourni en paramètre.

Attention: ce sont les identifiants des champs qui sont fournis, pas leurs libellés.

Exemple de résultat:

[
  {
    "z5Yi": "May 14, 2019",
    "uNp0": "multicat",
    "cniQ": 11350203
  },
  {
    "z5Yi": "May 14, 2019",
    "uNp0": "unitex",
    "cniQ": 2743607
  },
  {
    "z5Yi": "May 14, 2019",
    "uNp0": "teeft",
    "cniQ": 2148348
  },
  {
    "z5Yi": "May 14, 2019",
    "uNp0": "nb",
    "cniQ": 3180498
  },
  {
    "z5Yi": "May 14, 2019",
    "uNp0": "refbibs",
    "cniQ": 5655020
  }
]

pairing-with

Croise les éléments pour un champ ou plusieurs champs et compte le nombre d’occurrences de chaque croisement.

Crée les paires (source et cible) entre les éléments de 2 champs (champs identiques ou différents) déclarés selon :

  • /api/run/pairing-with/identifiant1/identifiant1/

  • /api/run/pairing-with/identifiant1/identifiant2/

et compte, pour chaque paire, le nombre de co-occurrences.

Cette routine se comporte comme la routine cross-by. Contrairement à celle-ci elle n’interprète pas les paramètres associés aux graphiques.

Elle peut, en particulier, être utilisée avec les formats Réseau et Carte de chaleur.

Attention : dans le cas où cette routine s’applique à un seul champ (/api/run/pairing-with/identifiant1/identifiant1/), elle conserve les auto-paires (source et cible identiques). Cela peut être intéressant avec le format Carte de chaleur pour visualiser la diagonale, mais peut être gênant avec d’autres formats.

exemple

sparql-query

Elle sert à faire des graphiques de distribution en prenant ses données dans un tripleStore et non dans Lodex.

Elle est adaptée pour réaliser les graphiques pouvant utiliser distinct-by.ini:

  • Graphe à bulles
  • Diagramme en barres
  • Diagramme circulaire
  • Diagramme radar

 

Ses résultats doivent ressembler à ceux de distinct-by.ini.

Version minimale de lodex : 9.8.1

Ce type de graphique nécessite la structure suivante : un champ total correspondant au nombre d’éléments un champ data qui est la liste des éléments à afficher dans le graphique. Chaque élément possède 2 champs également. Un champ _id qui correspond au nom de l’élément et un champ value qui correspond à la valeur numérique qui lui est associée.

Attention : créer directement sa requête dans le tripleStore de data.istex.fr via YASGUI

Copier le lien de partage –> ce lien sera la valeur à reporter dans un champ LODEX préalablement configuré.

Insérer ce lien dans un nouveau champ DATASET lodex et récupérer son identifiant (ici Kl67 )

Créer un autre champ type graphique au niveau du DATASET pour récupérer les informations de ce champ.

Cette routine doit être déclarée dans Value (Valeur) selon : /api/run/sparql-query/identifiant/ où identifiant représente le champ contenant la requête copier depuis le yasgui de data.istex.fr

syndication-from

Fait référence à une autre ressource du même jeu de données en liant les valeurs entre elles et non leurs arks. Il affiche ainsi les informations que l’on souhaite via les identifiants de la ressource.

Cette routine est, en particulier, utilisée avec le format Resources Grid pour représenter sur la page d’accueil les champs paramétrés dans syndication-from.

Elle doit alors être déclarée dans Value (Valeur) selon : /api/run/syndication-from/Identifiant/…

exemple l’instance revue de sommaire

Cette ressource récupère les informations d’une autre ressource via son identifiant ISSN déclaré dans une colonne bien spécifique portant l’identifiant nC6e. On reporte donc la valeur à la fin :

/api/run/syndication-from/**nC6e**/0300-4910

syndication

Récupère les champs paramétrés dans la zone Syndication de la configuration de l’affichage, à l’étape 5 “Comment elle (la valeur) est affichée”.

Affichage 1

Elle est, en particulier, utilisée avec le format Resources Grid pour représenter sur la page d’accueil les champs paramétrés dans Syndication.

Elle doit alors être déclarée dans Value (Valeur) selon :

/api/run/syndication

exemple

tree-by

Permet de créer des graphiques en forme d’arbres représentant des données hiérarchisées (classification, taxonomies …) et d’afficher le nombre de documents concernés.

Format d’entrée obligatoire : JSON

Les valeurs du champ représenté sont listées dans un ordre précis : du plus générique au plus spécifique :

"categories": {
  "wos": [
    "1 - science",
    "2 - marine & freshwater biology"
  ],
  "scienceMetrix": [
    "1 - natural sciences",
    "2 - biology",
    "3 - marine biology & hydrobiology"
  ],
  "scopus": [
    "1 - Life Sciences",
    "2 - Agricultural and Biological Sciences",
    "3 - Aquatic Science"
  ],
  "inist": [
    "1 - sciences appliquees, technologies et medecines",
    "2 - sciences biologiques et medicales",
    "3 - sciences biologiques fondamentales et appliquees. psychologie"
  ]
},

Crée des paires 2 à 2 entre les concepts spécifiques et plus génériques, et comptabilise le nombre de documents concernés par les concepts plus spécifiques de chaque segment.

Cette routine doit être déclarée dans Valeur selon : /api/run/tree-by/identifiant/ où identifiant représente les noms des espèces ou les catégories scientifiques (termes les plus spécifiques d’une classification hiérarchique)

Cette routine est destinée à être utilisée avec le format graphique :

  • Graphique hiérarchique

exemple

Les graphiques

Les graphiques font partie des formats d’affichage, et se construisent à l’aide des routines.

Le choix du graphique et son paramétrage s’effectuent pendant la création du modèle (faire renvoi vers la partie modèle)

En fonction du graphique choisi, la routine utilisée n’est pas la même, et le paramétrage peut également varier.

Le paramétrage d’un graphique reste toutefois modifiable après la création du modèle.

Dans la partie suivante, nous avons répertorié les graphiques disponibles dans Lodex, et les routines utilisables pour chaque graphique : des exemples de graphiques, ainsi que leur paramétrage possible, sont présentés avec la routine la plus couramment utilisée.

 

Graphiques disponibles dans Lodex

La liste des différents graphiques disponibles dans Lodex se trouve dans le menu déroulant “Appliquer un format” de la partie 5 “Comment elle (la valeur) est affichée” du paramétrage d’un modèle.

Menu déroulant des formats

Menu déroulant des formats

Aster plot

C’est un “graphique” qui ne s’adapte pas à l’ensemble d’un jeu de données, mais permet de comparer des ressources au sein d’un jeu de données

Routines utilisables
  • close-by
  • sub-resources-asterplot

 

Carte de chaleur

Routines utilisables
  • pairing-with
  • graph-by
  • cross-by
  • decompose-by
Paramétrages disponibles
  • Nombre max de champs
    • Nombre de champs maximum retourné par la routine :   Le nombre maximum de champs indiqué par défaut est 200. Pour la carte de chaleur, il est souhaitable d’indiquer un nombre élevé de champs (20000000 par exemple), sinon toutes les données ne seront pas visibles sur le graphique.
  • Valeur minimum à afficher & Valeur maximum à afficher
    • Encadrement des valeurs retournées par la routine, vide et équivalent à l’infini [-∞, +∞] (si la routine le permet)
  • Trier par
    • Trie les données retournées par la routine sur leur intitulé ou leur valeur (si la routine le permet)
    • Note : le tri par valeur peut ne pas fonctionner car il s’agit d’association de valeurs
  • Afficher l’info-bulle
    • permet de mettre une info-bulle sur les données du graphique avec un titre sur les intitulés et valeurs des données.
  • Jeu de couleurs
    • Sélection d’une palette de couleur en dégradé
  • Inverser les axes
    • Inverser les deux axes la source devient la destination et la destination devient la source : les éléments préalablement affichés à l’horizontale sont affichés à la verticale, et inversement.
Exemple de carte de chaleur où les valeurs des deux axes (source et cible) sont identiques (identifiant 1) –> écriture de “Comment la valeur est créée” sous la forme de /api/run/pairing-with/identifiant1/identifiant1

Cartographie

Le format Graphique – Cartographie projette des données numériques sur une carte géographique du Monde, de l’Europe ou de la France

 

Routines utilisables
  • distinct-by
  • distinct-ISO3166-1-alpha3-from
  • distinct-alpha-2-alpha3-from
Paramétrages disponibles

Les paramètres Nombre max de champs, Valeur minimum à afficher et Valeur maximum à afficher permettent de définir, pour le champ représenté, les éléments à afficher.

Seuls sont affichés les éléments dont le nombre d’apparitions est :

    • supérieur à la valeur définie dans le paramètre Valeur minimum à afficher
    • inférieur à la valeur définie dans le paramètre Valeur maximum à afficher
  • Nombre max de champs
    • Détermine le nombre maximum d’éléments à afficher
  • Valeur minimum à afficher & Valeur maximum à afficher
    • Définit le nombre minimum ou maximum d’apparitions d’un élément dans le corpus pour qu’il soit affiché
  • Projection du Monde
    • Ce paramètre correspond au zoom effectué sur la carte, 3 zooms sont disponibles
      • Projection mondiale : Affiche le Monde
      • Projection européenne : Affiche l’Europe géographique
      • Projection française : Afficher la France avec ses départements
  • Trier par :
    • Valeur ascendante (dans ce cas, plus l’entité géographique aura un poids important, plus le dégradé de couleur foncera) ou valeur descendante (dégradé de couleur du plus foncé au moins foncé)
  • Dégradé de couleur qui est appliqué au poids d’un pays (projection européenne ou mondiale) ou d’un département (dans le cas de la projection française)
  • Afficher l’info-bulle
    • permet de mettre une info-bulle sur les données du graphique lorsqu’on passe le curseur sur le graphique,  avec un titre sur les intitulés et valeurs des données.

Si le corpus de données comporte un champ avec les codes ISO 3 des pays, ce format nécessite l’utilisation de la routine distinct-by, appliquée à l’identifiant du champ représenté, qui doit être déclarée dans valeur selon :

/api/run/distinct-by/identifiant/

identifiant est le code attribué par LODEX au champ contenant les codes ISO 3 des pays.

Si le corpus de données ne comporte pas les codes ISO 3 des pays, ce format nécessite l’utilisation de la routine distinct-ISO3166-1-alpha3-from, appliquée à l’identifiant du champ contenant les pays verbalisés, (ou la routine distinct-alpha-2-alpha3-from, appliquée à l’identifiant du champ contenant les codes ISO 2 des pays) qui doit être déclarée dans valeur selon :

/api/run/distinct-ISO3166-1-alpha3-from/identifiant/ (ou /api/run/distinct-alpha-2-alpha3-from/identifiant/)

identifiant est le code attribué par LODEX au champ contenant les pays verbalisés.

 

Exemple de paramétrage d’une carte mondiale (nombre de publications par pays – hors France)

 

Carte

paramétrage carte

paramétrage carte

paramétrage carte

 

paramétrage carte

Cartographie de flux

Le graphique Cartographie de flux permet la géo-visualisation de données sur une carte. C’est une cartographie web dynamique : le passage de la souris sur les pays met en évidence les liens entre les pays (flèches simples incurvées, dont la largeur est proportionnelle à l’importance des collaborations entre pays) et affiche également le “poids” de chaque pays par un point dont le dégradé de couleur est plus ou moins prononcé.

 

 

 

Routines utilisables
  • pairing-with
  • graph-by
  • cross-by
  • decompose-by
Paramétrages disponibles

Les paramètres Nombre max de champs, Valeur minimum à afficher et Valeur maximum à afficher permettent de définir, pour le champ représenté, les éléments à afficher.

Seuls sont affichés les éléments dont le nombre d’apparitions est :

    • supérieur à la valeur définie dans le paramètre Valeur minimum à afficher
    • inférieur à la valeur définie dans le paramètre Valeur maximum à afficher
  • Nombre max de champs
    • Détermine le nombre maximum d’éléments à afficher
  • Valeur minimum à afficher & Valeur maximum à afficher
    • Définit le nombre minimum ou maximum d’apparitions d’un élément dans le corpus pour qu’il soit affiché
  • Trier par
    • Trie les données retournées par la routine sur leur intitulé ou leur valeur (si la routine le permet)
    • Note : le tri par valeur peut ne pas fonctionner car il s’agit d’association de valeur
  • Afficher l’info-bulle
    • permet de mettre une info-bulle sur les données du graphique avec un titre sur les intitulés et valeurs des données
    • Jeu de couleurs
      • Dégradé de couleur sur les points (les points sont plus ou moins foncés, en fonction de la valeur)
    • Couleur
      • Couleur des liens entre les lieux géographiques (flèches simples incurvées), donnée en code hexadécimal

     

    Exemple de paramétrage d’une cartographie de flux (géo-visualisation des relations entre pays co-publiants)

     

     

    La couleur des flèches simples de relations entre les pays est par défaut le noir. Pour modifier cette couleur, il suffit de cliquer sur la partie appropriée (voir ci-dessous)

     

     

    Coordonnées parallèles

     

     

    Diagramme à bulles (bubble plot)

    Routines utilisables
    • pairing-with
    • graph-by
    • cross-by
    • decompose-by
    Paramétrages disponibles
    • Nombre max de champs
      • Nombre de champs maximum retournés par la routine, vide et équivalent à l’infini (si la routine le permet)
    • Valeur minimum à afficher & Valeur maximum à afficher
      • Encadrement des valeurs retournées par la routine, vide et équivalent à l’infini [-∞, +∞] (si la routine le permet)
    • Trier par
      • Trie les données retournées par la routine sur leur intitulé ou leur valeur (si la routine le permet)
      • Note : le tri par valeur peut ne pas fonctionner car il s’agit d’association de valeurs
      • Afficher l’info-bulle
        • permet de mettre une info-bulle sur les données du graphique avec un titre sur les intitulés et valeurs des données.
      • Jeu de couleurs
        • Couleur du graphique donnée en code hexadécimal
      • Inverser les axes
        • Inverser les deux axes la source devient la destination et la destination devient la source

      Diagramme circulaire

       

      Routines utilisables
      • distinct-by
      • distinct-by-field
      • distribute-by-interval
      Paramétrages disponibles

      Les paramètres Nombre max de champs, Valeur minimum à afficher et Valeur maximum à afficher permettent de définir, pour le champ représenté, les éléments à afficher.

      Seuls sont affichés les éléments dont le nombre d’apparitions est :

        • supérieur à la valeur définie dans le paramètre Valeur minimum à afficher
        • inférieur à la valeur définie dans le paramètre Valeur maximum à affiche
      • Nombre max de champs
        • Détermine le nombre maximum d’éléments à afficher
      • Valeur minimum à afficher & Valeur maximum à afficher
        • Définit le nombre minimum ou maximum d’apparitions d’un élément dans le corpus pour qu’il soit affiché
        • Trier par :
          • Trie les données retournées  par la routine sur leur intitulé ou leurs valeurs (si la routine le permet)Afficher les valeurs
        • Afficher les valeurs
          • Affiche les valeurs des données sur le graphique
        • Afficher l’info-bulle
          • Permet de mettre une info-bulle sur les données du graphique, avec un titre pour les catégories du diagramme et un titre des valeurs des données.
        • Jeu de couleurs
          • Couleur du graphique donnée en code hexadécimal
        • Largeur
          •  La largeur est exprimée en pourcentage et correspond à la largeur du graphique par rapport à la largeur de la page entière. Par défaut la largeur est de 100 %. Si on souhaite que le graphique n’occupe que la moitié de la largeur de la page par exemple, on réduit la largeur à 50 %.

        Diagramme en barres

        Routines utilisables
        • distinct-by
        • distinct-by-field
        • distribute-by-date
        • distribute-by-decadal
        • distribute-by-interval
        Paramétrages disponibles

        Les paramètres Nombre max de champs, Valeur minimum à afficher et Valeur maximum à afficher permettent de définir, pour le champ représenté, les éléments à afficher.

        Seuls sont affichés les éléments dont le nombre d’apparitions est :

          • supérieur à la valeur définie dans le paramètre Valeur minimum à afficher
          • inférieur à la valeur définie dans le paramètre Valeur maximum à afficher
        • Nombre max de champs
          • Détermine le nombre maximum d’éléments à afficher
        • Valeur minimum à afficher & Valeur maximum à afficher
          • Définit le nombre minimum ou maximum d’apparitions d’un élément dans le corpus pour qu’il soit affiché
            • Trier par
              • Trie les données retournées par la routine sur leur intitulé ou leur valeur (si la routine le permet)
            • Afficher l’info-bulle
              • Permet de mettre une info-bulle sur les données du graphique avec un titre sur les intitulés et valeurs des données. L’affichage de l’info-bulle sera visible en passant la souris sur le graphique
            • Jeu de couleurs
              • Couleur du graphique donnée en code hexadécimal
            • Direction
              • Direction des barres du graphique (barres horizontales ou verticales)
            • Afficher l’axe des catégories en diagonale / afficher l’axe des valeurs en diagonale
              • Passe l’angle des intitulés des axes de 0° à 45°
            • Arrondir les valeurs sur l’axe
              • Arrondit les valeurs de l’axe (sans virgule)
            • Afficher les valeurs
              • Supprime l’axe des valeurs pour le remplacer par un affichage des valeurs sur les barres
            • Éviter le chevauchement des étiquettes
            • Échelle
              • Type de représentation du graphique (linéaire ou logarithmique)
            • Largeur des barres
              • Taille maximum des barres
            • Largeur
              •  La largeur est exprimée en pourcentage et correspond à la largeur du graphique par rapport à la largeur de la page entière. Par défaut la largeur est de 100 %. Si on souhaite que le graphique n’occupe que la moitié de la largeur de la page par exemple, on réduit la largeur à 50 %.
            Exemple de paramétrage d’un graphique pour les années de publication d’un corpus de données (utilisation de la routine distinct-by)

            Paramétrage histogramme

            Paramétrage histogramme

            Paramétrage histogramme

            Paramétrage histogramme

            Le tri s’effectue par Label ascendant : dans cet exemple, le label correspond aux années de publication qui s’afficheront de façon chronologique ascendante dans le graphique

             

             

            Paramétrage histogramme

             

               

              Diagramme radar

               

              Routines utilisables
              • distinct-by
              • distinct-by-field
              Paramétrages disponibles
              • Nombre max de champs
                • Nombre de champs maximum retourné par la routine, vide et équivalent à l’infini (si la routine le permet)
              • Valeur minimum à afficher & Valeur maximum à afficher
                • Encadrement des valeurs retournées par la routine, vide et équivalent à l’infini [-∞, +∞] (si la routine le permet)
              • Trier par
                • Trie les données retournées par la routine sur leur intitulé ou leur valeur (si la routine le permet)
              • Afficher l’info-bulle
                • Permet de mettre une info-bulle sur les données du graphique avec un titre sur les intitulés et valeurs des données.
              • Couleur
                • Couleur du graphique donnée en code hexadécimal
              • Arrondir les valeurs sur l’axe
                • Arrondit les valeurs de l’axe
              • Échelle
                • Type de représentation du graphique (linéaire ou logarithmique)

                    Graphe à bulles

                    Le format Graphique – Graphe à bulles (Graph – Bubble) montre les corrélations (regroupement de bulles) et les poids (taille des bulles) des différents éléments du champ représenté, montrant ainsi les proportions des différentes valeurs.

                     

                     

                     

                     

                     

                     

                     

                     

                     

                     

                    Routines utilisables
                    • distinct-by
                    • distinct-by-field
                    • sparql-query
                    Paramétrages disponibles

                    Les paramètres Nombre max de champs, Valeur minimum à afficher et Valeur maximum à afficher permettent de définir, pour le champ représenté, les éléments à afficher.

                    Seuls sont affichés les éléments dont le nombre d’apparitions est :

                      • supérieur à la valeur définie dans le paramètre Valeur minimum à afficher
                      • inférieur à la valeur définie dans le paramètre Valeur maximum à afficher
                    • Nombre max de champs
                      • Détermine le nombre maximum d’éléments à afficher
                    • Valeur minimum à afficher & Valeur maximum à afficher
                      • Définit le nombre minimum ou maximum d’apparitions d’un élément dans le corpus pour qu’il soit affiché
                    • Trier par
                      • Trie les données retournées par la routine sur leur intitulé ou leur valeur (si la routine le permet)
                    • Couleur
                      • Couleur du graphique donnée en code hexadécimal
                    • Diamètre des bulles : nombre en pixels
                    Exemple d’un paramétrage d’un graphe à bulles

                     

                     

                     

                    Graphique de flux

                    Routines utilisables
                    • classif-by
                    Paramétrages disponibles

                     

                    Graphique hiérarchique

                    Routines utilisables
                    • tree-by
                    Paramétrages disponibles

                     

                    Réseaux

                     

                    Routines utilisables
                    • cross-by
                    • decompose-by
                    • graph-by
                    • pairing-with
                    Paramétrages disponibles

                     

                    Syntaxe Vega-Lite

                    Routine utilisable

                     

                    • Cela dépend de votre graphique

                    Paramétrage disponible

                     

                    • Nombre max de champs
                      • Nombre de champs maximum retourné par la routine, vide et équivalent à l’infini (si la routine le permet)
                    • Valeur minimum à afficher & Valeur maximum à afficher
                      • Encadrement des valeurs retournées par la routine, vide et équivalent à l’infini [-∞, +∞] (si la routine le permet)
                    • Trier par
                      • Trie les données retournées par la routine sur leur intitulé ou leurs valeurs (si la routine le permet)
                      • Note : le tri par valeur peut ne pas fonctionner car il s’agit d’association de valeurs
                    • Spécification Vega-Lite
                      • spécification qui peut être créé via le validateur vega
                    • Largeur responsive (optionnelle) [10~200]
                      • Largeur du graphique correspondant à un pourcentage de la largeur de la fenêtre allant de 10 à 200 %
                      • Si laissé vide alors les paramètres utilisés seront ceux donnés dans la spécification Vega-Lite
                    • Hauteur responsive (optionnelle) [10~800]
                      • Hauteur du graphique correspondent à un pourcentage de 300px allant de 10 à 800%
                      • Si laissé vide alors les paramètre utilisés seront ceux donnés dans la spécification Vega-Lite

                    routine select-by (voir doc d’Enza) –>”Graphique – Syntaxe Vega-Lite”

                     

                    Cet article vous a-t-il été utile ? Oui Non

                    Comment pouvons-nous aider ?