renamevars

table または timetable 内の変数の名前の変更

R2020a 以降

構文

T2 = renamevars(T1,vars,newNames)

説明

T2 = renamevars(T1,vars,newNames) は、newNames で指定された名前を使用して vars で指定された table 変数または timetable 変数の名前を変更します。

例

table 内の変数の名前の変更

スプレッドシートから table を読み取ります。スプレッドシートには、各 table 変数の名前が含まれています (テキストを含む列を読み取り、string 配列である table 変数に設定します)。

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

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

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

変数 Loss、OutageTime および 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"    01-Feb-2002 12:18:00      458.98      1.8202e+06    07-Feb-2002 16:50:00    "winter storm"   
    "SouthEast"    23-Jan-2003 00:49:00      530.14      2.1204e+05                     NaT    "winter storm"   
    "SouthEast"    07-Feb-2003 21:15:00       289.4      1.4294e+05    17-Feb-2003 08:14:00    "winter storm"   
    "West"         06-Apr-2004 05:44:00      434.81      3.4037e+05    06-Apr-2004 06:10:00    "equipment fault"
    "MidWest"      16-Mar-2002 06:18:00      186.44      2.1275e+05    18-Mar-2002 23:23:00    "severe storm"   
    "West"         18-Jun-2003 02:49:00           0               0    18-Jun-2003 10:54:00    "attack"         
    "West"         20-Jun-2004 14:39:00      231.29             NaN    20-Jun-2004 19:16:00    "equipment fault"
    "West"         06-Jun-2002 19:28:00      311.86             NaN    07-Jun-2002 00:51:00    "equipment fault"
    "NorthEast"    16-Jul-2003 16:23:00      239.93           49434    17-Jul-2003 01:12:00    "fire"           
    "MidWest"      27-Sep-2004 11:09:00      286.72           66104    27-Sep-2004 16:37:00    "equipment fault"
    "SouthEast"    05-Sep-2004 17:48:00      73.387           36073    05-Sep-2004 20:46:00    "equipment fault"
    "West"         21-May-2004 21:45:00      159.99             NaN    22-May-2004 04:23:00    "equipment fault"
    "SouthEast"    01-Sep-2002 18:22:00      95.917           36759    01-Sep-2002 19:12:00    "severe storm"   
    "SouthEast"    27-Sep-2003 07:32:00         NaN      3.5517e+05    04-Oct-2003 07:02:00    "severe storm"   
    "West"         12-Nov-2003 06:12:00      254.09      9.2429e+05    17-Nov-2003 02:04:00    "winter storm"   
    "NorthEast"    18-Sep-2004 05:54:00           0               0                     NaT    "equipment fault"
      ⋮

table 変数の名前に接尾辞を追加

関数 array2table を使用して多くの変数を含む table を作成します。変数の名前を追加します。

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

各変数名が "Reading" で始まり、接尾辞で終わるように変数名を変更します。関数 width を使用して T に変数がいくつ含まれるかを決定します。table 変数を数値配列として指定します。

数値配列 allVars を string 配列に変換します。各要素を "Reading" に追加して、1 行 5 列の string 配列を作成します。

関数 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

入力引数

T1 — 入力テーブル

table | timetable

入力テーブル。table または timetable として指定します。

vars — 入力 table または入力 timetable の変数

文字ベクトル | string 配列 | 文字ベクトルの cell 配列 | 数値配列 | logical 配列 | 添字オブジェクト

入力 table または入力 timetable の変数。文字ベクトル、string 配列、文字ベクトルの cell 配列、数値配列、logical 配列または添字オブジェクトとして指定します。

関数 vartype を使用して、指定されたデータ型の変数を検出する添字オブジェクトとして vars を指定できます。

例: T = renamevars(T,'Var1','Location') は table 変数 'Var1' の名前を 'Location' に変更します。

例: T = renamevars(T,["Var1","Var2"],["Latitude","Longitude"]) は、2 つの table 変数の名前を変更します。

例: T = renamevars(T,1:width(T),newNames) は、すべての table 変数の名前を変更します。関数 width によって返される table の幅は、その変数の数と等しくなります。

例: vars = vartype('numeric'); T = renamevars(T,vars,newNames) は、T のすべての数値変数の名前を変更します。

newNames — 変数の新しい名前

文字ベクトル | string 配列 | 文字ベクトルの cell 配列

変数の新しい名前。文字ベクトル、string 配列または文字ベクトルの cell 配列として指定します。

newNames で指定される名前の数は、vars で指定される変数の数と一致していなければなりません。

ヒント

• table の VariableNames プロパティを T.Properties.VariableNames = newNames のように設定することで、table 内のすべての変数の名前を変更することもできます。この場合、newNames は string 配列または文字ベクトルの cell 配列でなければなりません。

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

この関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2020a で導入

参考

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

トピック

• table 変数の追加、削除、再配列
• テーブル行の追加と削除
• table 内のデータへのアクセス
• table 変数の名前変更と説明
• table 内の乱雑な欠損データの整理