C = categorical(A)
C = categorical(A, valueset)
C = categorical(A, valueset, categoryNames)
C = categorical(..., 'Ordinal', tf)
C = categorical(..., 'Protected', tf)
| Paramètre | Description |
|---|---|
| A | Valeurs d'entrée : texte, string, numérique, logique ou catégoriel. |
| valueset | Ensemble explicite de valeurs qui définissent les catégories. |
| categoryNames | Noms associés aux catégories définies par valueset. |
| tf | Scalaire logique qui active l'ordre ordinal ou la protection des catégories. |
| Paramètre | Description |
|---|---|
| C | Tableau catégoriel de même taille que A. |
categorical stocke les valeurs répétées sous forme de codes entiers et d'une liste de noms de catégories.
Les valeurs texte vides, les strings manquants ou les valeurs absentes d'un valueset explicite deviennent des éléments catégoriels non définis.
Les tableaux ordinaux utilisent l'ordre des catégories pour les comparaisons relationnelles et sont automatiquement protégés.
contains, startsWith, endsWith et matches acceptent un tableau catégoriel en entrée : ils testent le nom de catégorie de chaque élément avec le motif (texte, cellule de textes, tableau de chaînes ou objet pattern, avec l'option facultative 'IgnoreCase') et renvoient un tableau logique de même taille. Les éléments non définis renvoient false. Chaque nom de catégorie n'est testé qu'une seule fois.
Concaténer un tableau catégoriel avec du texte (["z" C], ['z' C], [{'z'} C]) ou missing convertit les autres opérandes : le résultat garde les catégories du premier opérande catégoriel et ajoute les nouvelles valeurs dans l'ordre des opérandes ; le texte vide et missing sont non définis. Les tableaux ordinaux et protégés refusent les valeurs qui ne sont pas déjà des catégories, et les autres classes (numériques, logiques, tableaux de chaînes à plusieurs éléments) sont refusées.
C = categorical({'red','blue','red'}); categories(C)C = categorical({'low','high','mid'}, {'low','mid','high'}, 'Ordinal', true); C > 'mid'C = categorical({'winter storm','fire','Thunder Storm',''}); contains(C, "storm", 'IgnoreCase', true)| Version | Description |
|---|---|
| 2.0.0 | version initiale |