readtable

Créer une table à partir d'un fichier.

📝Syntaxe

T = readtable(filename)
T = readtable(filename, opts)
T = readtable(filename, 'TextType', type)
T = readtable(filename, Name, Value)

📥Arguments d'entrée

Paramètre	Description
filename	une chaîne : nom de fichier source.
opts	Objet nelson.io.text.DelimitedTextImportOptions
type	une chaîne : 'char' (défaut, colonnes de texte en tableau de cellules de vecteurs de caractères) ou 'string' (colonnes de texte en tableau string).
Name, Value	arguments nom-valeur optionnels. Pour un fichier JSON : FileType, TableSelector, TableNodeName, VariableSelectors, RowNamesSelector, VariableUnitsSelector, VariableDescriptionsSelector, RepeatedNodeRule, ParsingMode, AllowComments, AllowInfAndNaN, AllowTrailingCommas, MissingRule, ImportErrorRule et TextType.

📤Arguments de sortie

Paramètre	Description
T	une table.

📄Description

T = readtable(filename) crée une table en important des données orientées colonne depuis un fichier texte ou tableur.

T = readtable(filename, opts) crée une table en utilisant les paramètres définis dans l'objet d'options d'importationopts. L'objet d'options d'importation permet de personnaliser la façon dont readtable interprète le fichier, offrant un meilleur contrôle, de meilleures performances et la possibilité de réutiliser la configuration comparé à la syntaxe par défaut.

T = readtable(filename, 'Range', range) lit uniquement le bloc rectangulaire du fichier sélectionné par range. Pour un fichier texte délimité, range peut être donné sous forme de cellules de coin ('A1:B5' ou un coin unique 'A2'), d'une plage de colonnes ('A:B'), d'une plage de lignes ('2:4') ou d'un vecteur numérique [premiereLigne premiereColonne derniereLigne derniereColonne]. Lorsque la première ligne de la plage est composée uniquement de texte non numérique, elle est utilisée pour les noms de variables, sinon les colonnes sont nommées Var1, Var2, etc.

L'option nom-valeur 'Sheet' s'applique uniquement aux fichiers tableur et n'est pas prise en charge pour un fichier texte délimité.

Fichiers JSON : un fichier d'extension .json, ou tout fichier lu avec 'FileType', 'json', est décodé avec jsondecode puis converti en table.

Un tableau d'objets donne une ligne par objet et les clés des objets deviennent les variables. Les objets imbriqués sont aplatis : chaque valeur feuille devient une variable nommée d'après sa clé.
Un objet dont toutes les valeurs sont des objets donne une ligne par clé. Utilisez "Keys" dans VariableSelectors pour lire les clés.
Lorsque la racine du fichier est un objet, le premier tableau d'objets trouvé est lu.
Les nombres donnent des double, true et false des logical, le texte des string (char avec 'TextType', 'char'), le texte de date et d'heure des datetime ou duration.
Les valeurs null et les clés absentes sont des valeurs manquantes : NaN, <missing> ou false pour une variable logique.
Une valeur tableau JSON (noeud répété) donne une variable matrice avec une colonne par élément.

Arguments nom-valeur JSON :

TableSelector : pointeur JSON RFC 6901 de la table. "" désigne le fichier entier.
TableNodeName : nom de la clé des données de la table.
VariableSelectors : pointeurs JSON des variables, relatifs à un objet ligne. "Keys" lit les clés des objets.
RowNamesSelector : pointeur JSON des noms de lignes.
VariableUnitsSelector, VariableDescriptionsSelector : pointeurs JSON, depuis la racine du fichier, d'un objet associant les noms de variables à leurs unités ou descriptions.
RepeatedNodeRule : 'addcol' (défaut), 'ignore' (premier élément seulement) ou 'error'.
ParsingMode : 'lenient' (défaut) ou 'strict'. Il fixe AllowComments (commentaires // et /* */), AllowInfAndNaN (Inf, -Inf, Infinity, NaN) et AllowTrailingCommas, qui peuvent aussi être donnés un par un.
MissingRule, ImportErrorRule : 'fill' (défaut), 'error', 'omitrow' ou 'omitvar'.

Avec un fichier JSON, opts est un objet nelson.io.json.JSONImportOptions (voir jsonImportOptions).

💡Exemples

  Names = {'John'; 'Alice'; 'Bob'; 'Diana'};  Age = [28; 34; 22; 30];  Height = [175; 160; 180; 165];  Weight = [70; 55; 80; 60];  T1 = table(Names, Age, Height, Weight);  writetable(T1, [tempdir,'readtable_1.csv'])  T2 = readtable([tempdir,'readtable_1.csv'])

  Names = {'John'; 'Alice'; 'Bob'; 'Diana'};  Age = [28; 34; 22; 30];  Height = [175; 160; 180; 165];  Weight = [70; 55; 80; 60];  T = table(Names, Age, Height, Weight);  writetable(T, [tempdir,'readtable_1.csv'])  options = detectImportOptions([tempdir,'readtable_1.csv']);  T1 = readtable([tempdir,'readtable_1.csv'], options)  options.DataLines = [1 Inf]  T2 = readtable([tempdir,'readtable_1.csv'], options)

Lire un fichier JSON :

T = table([1; 2; NaN], ["a"; "b"; missing], 'VariableNames', {'x', 'name'}); f = [tempdir, 'readtable_json.json']; writetable(T, f); T2 = readtable(f) opts = detectImportOptions(f, 'VariableSelectors', '/name'); T3 = readtable(f, opts)

🔗Voir aussi

delimitedTextImportOptions writetable detectImportOptions readcell fileread jsonImportOptions

🕔Historique des versions

Version	Description
1.10.0	version initiale
2.0.0	Fichiers JSON : lecture de données JSON sous forme de table.

Modifier cette page sur GitHub