livres de code / Dictionnaires de données
Aussi appelés dictionnaires de données, les livres de code sont essentiels pour décrire le contenu, la structure et l’organisation d’un ensemble de données. Ils garantissent une documentation adéquate et facilitent la compréhension et la réutilisation des données par d’autres chercheurs, en servant de référence pour l’analyse et l’interprétation.
Principaux éléments d’un livre de codes
En tant qu’artéfact documentaire (au niveau des tableaux), un livre de code définit les variables d’un ensemble de données aussi clairement que possible. Veuillez prendre en compte les attributs suivants :
Nom de la variable : Un identifiant unique correspondant au nom de la variable dans le tableau de données (ex. EMPLOY1 ou VAR001).
Libellé de la variable : Une brève description disciplinaire de la variable (ex. “Statut d’emploi”).
Type de variable : Indique le type de variable (ex. numérique, entier, caractère, booléen).
Plages ou niveaux : Indique l’étendue ou les niveaux de la variable selon son type (ex. “0-100”, “Niveaux = A1, A2, A3”).
Valeurs manquantes : Indique le nombre (le cas échéant) de valeurs manquantes pour chaque colonne.
Unités : Unités de mesure associées à la variable (ex. “centimètres”, “mètres carrés”).
En fonction de la discipline, d’autres attributs peuvent être décrits pour rendre l’ensemble de données compréhensible. Crystal Lewis propose des exemples de livres de codes.
Exemple de livre de code
| Variable | Libellé | Type | Plage-Niveaux | Valeurs manquantes | Unités |
|---|---|---|---|---|---|
| Stage | Stade expérimental | Facteur | 1, 2, 3, 4 | NA | NA |
| Intervention | Groupe d’intervention | Facteur | G1, G2, G3 | NA | NA |
| Âge | Âge du participant | Numérique | 18-26 | 1 | Années |
| Sexe | Sexe biologique | Facteur | Homme, Femme | NA | NA |
| Score | Score cognitif | Numérique | 1-20 | NA | AU |
Les livres de code sont essentiels pour la transparence de la recherche, la reproductibilité et la préservation à long terme des données.
Comment créer un codebook
Créer des livres de code est une bonne pratique de recherche qui devrait être mise en place dès le début du processus de recherche. Il est recommandé d’utiliser un format simple et clair. Le générateur de livre de codes basé sur le web permet à l’utilisateur de télécharger un livre de codes au format CSV dérivé d’un tableau de données donné.