renamevars

Modificar el nombre de las variables de una tabla u horario

Desde R2020a

Sintaxis

T2 = renamevars(T1,vars,newNames)

Descripción

T2 = renamevars(T1,vars,newNames) modifica el nombre de las variables de la tabla u horario especificadas por vars utilizando los nombres especificados por newNames.

Ejemplos

Modificar el nombre de las variables de una tabla

Lea una tabla desde una hoja de cálculo. La hoja de cálculo proporciona un nombre para cada variable de la tabla. (Lea las columnas que contienen texto en las variables de la tabla que sean arreglos de cadenas).

T = readtable('outages.csv','TextType','string')

T=1468×6 table
      Region          OutageTime        Loss     Customers     RestorationTime           Cause      
    ___________    ________________    ______    __________    ________________    _________________

    "SouthWest"    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    "winter storm"   
    "SouthEast"    2003-01-23 00:49    530.14    2.1204e+05                 NaT    "winter storm"   
    "SouthEast"    2003-02-07 21:15     289.4    1.4294e+05    2003-02-17 08:14    "winter storm"   
    "West"         2004-04-06 05:44    434.81    3.4037e+05    2004-04-06 06:10    "equipment fault"
    "MidWest"      2002-03-16 06:18    186.44    2.1275e+05    2002-03-18 23:23    "severe storm"   
    "West"         2003-06-18 02:49         0             0    2003-06-18 10:54    "attack"         
    "West"         2004-06-20 14:39    231.29           NaN    2004-06-20 19:16    "equipment fault"
    "West"         2002-06-06 19:28    311.86           NaN    2002-06-07 00:51    "equipment fault"
    "NorthEast"    2003-07-16 16:23    239.93         49434    2003-07-17 01:12    "fire"           
    "MidWest"      2004-09-27 11:09    286.72         66104    2004-09-27 16:37    "equipment fault"
    "SouthEast"    2004-09-05 17:48    73.387         36073    2004-09-05 20:46    "equipment fault"
    "West"         2004-05-21 21:45    159.99           NaN    2004-05-22 04:23    "equipment fault"
    "SouthEast"    2002-09-01 18:22    95.917         36759    2002-09-01 19:12    "severe storm"   
    "SouthEast"    2003-09-27 07:32       NaN    3.5517e+05    2003-10-04 07:02    "severe storm"   
    "West"         2003-11-12 06:12    254.09    9.2429e+05    2003-11-17 02:04    "winter storm"   
    "NorthEast"    2004-09-18 05:54         0             0                 NaT    "equipment fault"
      ⋮

Cambie los nombres de las variables Loss, OutageTime y RestorationTime.

T = renamevars(T,["Loss","OutageTime","RestorationTime"], ...
                 ["Total Cost","Start of Outage","Restoration"])

T=1468×6 table
      Region       Start of Outage     Total Cost    Customers       Restoration             Cause      
    ___________    ________________    __________    __________    ________________    _________________

    "SouthWest"    2002-02-01 12:18      458.98      1.8202e+06    2002-02-07 16:50    "winter storm"   
    "SouthEast"    2003-01-23 00:49      530.14      2.1204e+05                 NaT    "winter storm"   
    "SouthEast"    2003-02-07 21:15       289.4      1.4294e+05    2003-02-17 08:14    "winter storm"   
    "West"         2004-04-06 05:44      434.81      3.4037e+05    2004-04-06 06:10    "equipment fault"
    "MidWest"      2002-03-16 06:18      186.44      2.1275e+05    2002-03-18 23:23    "severe storm"   
    "West"         2003-06-18 02:49           0               0    2003-06-18 10:54    "attack"         
    "West"         2004-06-20 14:39      231.29             NaN    2004-06-20 19:16    "equipment fault"
    "West"         2002-06-06 19:28      311.86             NaN    2002-06-07 00:51    "equipment fault"
    "NorthEast"    2003-07-16 16:23      239.93           49434    2003-07-17 01:12    "fire"           
    "MidWest"      2004-09-27 11:09      286.72           66104    2004-09-27 16:37    "equipment fault"
    "SouthEast"    2004-09-05 17:48      73.387           36073    2004-09-05 20:46    "equipment fault"
    "West"         2004-05-21 21:45      159.99             NaN    2004-05-22 04:23    "equipment fault"
    "SouthEast"    2002-09-01 18:22      95.917           36759    2002-09-01 19:12    "severe storm"   
    "SouthEast"    2003-09-27 07:32         NaN      3.5517e+05    2003-10-04 07:02    "severe storm"   
    "West"         2003-11-12 06:12      254.09      9.2429e+05    2003-11-17 02:04    "winter storm"   
    "NorthEast"    2004-09-18 05:54           0               0                 NaT    "equipment fault"
      ⋮

Añadir un sufijo a los nombres de las variables de tabla

Cree una tabla con muchas variables con la función array2table. Añada nombres a las variables.

T = array2table(rand(5,5))

T=5×5 table
     Var1       Var2       Var3       Var4        Var5  
    _______    _______    _______    _______    ________

    0.81472    0.09754    0.15761    0.14189     0.65574
    0.90579     0.2785    0.97059    0.42176    0.035712
    0.12699    0.54688    0.95717    0.91574     0.84913
    0.91338    0.95751    0.48538    0.79221     0.93399
    0.63236    0.96489    0.80028    0.95949     0.67874

Cambie los nombres de las variables de forma que cada uno comience con "Reading" y finalice con un sufijo. Determine cuántas variables tiene T con la función width. Especifique las variables de la tabla como un arreglo numérico.

Convierta el arreglo numérico allVars a un arreglo de cadenas. Cree un arreglo de cadenas de 1 por 5 añadiendo cada elemento a "Reading".

Modifique el nombre de todas las variables con la función renamevars.

allVars = 1:width(T);
newNames = append("Reading",string(allVars));
T = renamevars(T,allVars,newNames)

T=5×5 table
    Reading1    Reading2    Reading3    Reading4    Reading5
    ________    ________    ________    ________    ________

    0.81472     0.09754     0.15761     0.14189      0.65574
    0.90579      0.2785     0.97059     0.42176     0.035712
    0.12699     0.54688     0.95717     0.91574      0.84913
    0.91338     0.95751     0.48538     0.79221      0.93399
    0.63236     0.96489     0.80028     0.95949      0.67874

Argumentos de entrada

T1 — Tabla de entrada

tabla | horario

Tabla de entrada, especificada como tabla u horario.

vars — Variables de la tabla u horario de entrada

vector de caracteres | arreglo de cadenas | arreglo de celdas de vectores de caracteres | arreglo numérico | arreglo lógico | objeto de subíndices

Variables de la tabla u horario de entrada, especificadas como vector de caracteres, arreglo de cadenas, arreglo de celdas de vectores de caracteres, arreglo numérico, arreglo lógico u objeto de subíndices.

Puede especificar vars como un objeto de subíndices que detecta variables de un tipo de datos especificado utilizando la función vartype.

Ejemplo: T = renamevars(T,'Var1','Location') cambia el nombre de la variable de la tabla 'Var1' por 'Location'.

Ejemplo: T = renamevars(T,["Var1","Var2"],["Latitude","Longitude"]) cambia los nombres de dos variables de la tabla.

Ejemplo: T = renamevars(T,1:width(T),newNames) modifica el nombre todas las variables de la tabla. La anchura de una tabla, devuelta por la función width, es igual al número de variables.

Ejemplo: vars = vartype('numeric'); T = renamevars(T,vars,newNames) modifica el nombre de todas las variables numéricas de T.

newNames — Nombres nuevos para variables

vector de caracteres | arreglo de cadenas | arreglo de celdas de vectores de caracteres

Nombres nuevos para variables, especificados como vector de caracteres, arreglo de cadenas o arreglo de celdas de vectores de caracteres.

El número de nombres especificados por newNames debe coincidir con el número de variables especificado por vars.

Sugerencias

• También puede modificar el nombre de todas las variables de la tabla estableciendo la propiedad VariableNames como en T.Properties.VariableNames = newNames. En ese caso, newNames debe ser un arreglo de cadenas o un arreglo de celdas de vectores de caracteres.

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

Esta función es totalmente compatible con los arreglos altos. Para obtener más información, consulte Arreglos altos.

Generación de código C/C++
Genere código C y C++ mediante MATLAB® Coder™.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en un entorno basado en subprocesos.

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido en R2020a

Consulte también

removevars | addvars | mergevars | movevars | splitvars | convertvars | vartype | append | width

Temas

• Añadir, eliminar y reorganizar variables de tabla
• Agregar y eliminar filas de una tabla
• Acceder a datos en tablas
• Rename and Describe Table Variables
• Limpiar datos confusos y datos ausentes en MATLAB