detectImportOptions

Créer des options d'importation basées sur le contenu du fichier.

📝Syntaxe

options = detectImportOptions(filename)
options = detectImportOptions(filename, Name, Value)

📥Arguments d'entrée

Paramètre	Description
filename	une chaîne : nom de fichier source.
Name, Value	fichiers JSON seulement : FileType, TableSelector, TableNodeName, VariableSelectors, RowNamesSelector, VariableUnitsSelector, VariableDescriptionsSelector, RepeatedNodeRule, ParsingMode, AllowComments, AllowInfAndNaN, AllowTrailingCommas, MissingRule, ImportErrorRule et TextType (voir readtable).

📤Arguments de sortie

Paramètre	Description
options	Objet nelson.io.text.DelimitedTextImportOptions.

📄Description

options = detectImportOptions(filename) identifie une table dans un fichier texte delimite et renvoie un objet nelson.io.text.DelimitedTextImportOptions.

Vous pouvez personnaliser cet objet et l'utiliser avecreadtable, readcell oureadmatrix pour contrôler la façon dont Nelson importe les données en tant que table, cellule ou matrice.

Propriétés :

Delimiter : caractères délimiteurs de champ. exemple : {','}

LineEnding : caractères de fin de ligne. exemple : {'\r\n'}

CommentStyle : style des commentaires. exemple : {'#'}

EmptyLineRule : procédure de gestion des lignes vides. exemple : 'skip'

VariableNamesLine : emplacement des noms de variables. exemple : 1

VariableNames : noms des variables. exemple : {'Names' 'Age' 'Height' 'Weight'}

RowNamesColumn : emplacement des noms de ligne. exemple : 0

DataLines : emplacement des données,[l1 l2] indique la plage de lignes contenant les données.l1 fait référence à la première ligne avec données, tandis que l2 fait référence à la dernière ligne. exemple : [2 Inf]

Pour un fichier JSON (extension .json ou 'FileType', 'json'), detectImportOptions renvoie un objet nelson.io.json.JSONImportOptions utilisable avec readtable et readtimetable. Ses propriétés TableSelector et VariableSelectors contiennent les pointeurs JSON détectés, VariableNames et VariableTypes les noms et types détectés.

💡Exemples

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,'readcell_1.csv']) options = detectImportOptions([tempdir,'readcell_1.csv']) C1 = readcell([tempdir,'readcell_1.csv'], options) options.DataLines = [1 Inf] C2 = readcell([tempdir,'readcell_1.csv'], options)

Détecter les options d'un fichier JSON :

T = table([1; 2], ["a"; "b"], 'VariableNames', {'x', 'name'}); f = [tempdir, 'detect_json.json']; writetable(T, f); opts = detectImportOptions(f) opts.SelectedVariableNames = {'name'}; T2 = readtable(f, opts)

🕔Historique des versions

Version	Description
1.10.0	version initiale
2.0.0	Fichiers JSON : renvoie un objet JSONImportOptions.