boxchart

ボックスチャート (箱ひげ図)

ページ内をすべて折りたたむ

構文

boxchart(ydata)

boxchart(xgroupdata,ydata)

boxchart(___,'GroupByColor',cgroupdata)

boxchart(tbl,yvar)

boxchart(tbl,xvar,yvar)

boxchart(___,Name,Value)

boxchart(ax,___)

b = boxchart(___)

説明

ベクトルと行列のデータ

boxchart(ydata) は行列 ydata の各列に対してボックスチャート (箱ひげ図) を作成します。ydata がベクトルの場合、boxchart は単一のボックスチャートを作成します。

各ボックスチャートには、中央値、上位四分位数、下位四分位数、すべての外れ値 (四分位数間範囲を使用して計算)、外れ値でない最小値と最大値の各情報が表示されます。詳細については、ボックスチャート (箱ひげ図)を参照してください。

例

boxchart(xgroupdata,ydata) は xgroupdata の一意の値に従ってベクトル ydata のデータをグループ化し、データの各グループを個別のボックスチャートとしてプロットします。xgroupdata は各ボックスチャートの x 軸上の位置を決定します。ydata はベクトルでなければならず、xgroupdata の長さは ydata と同じでなければなりません。

例

boxchart(___,'GroupByColor',cgroupdata) は、色を使用してボックスチャートを区別します。ソフトウェアでは、xgroupdata (指定している場合) と cgroupdata の一意の値の組み合わせに従ってベクトル ydata のデータをグループ化し、データの各グループを個別のボックスチャートとしてプロットします。次にベクトル cgroupdata は、各ボックスチャートの色を決定します。ydata はベクトルでなければならず、cgroupdata は ydata と同じ長さでなければなりません。'GroupByColor' 名前と値のペアの引数は、前述した構文における任意の入力引数の組み合わせの後に指定します。

例

テーブルデータ

boxchart(tbl,yvar) は、table tbl から yvar の変数ごとにボックスチャートを作成します。 (R2025a 以降)

例

boxchart(tbl,xvar,yvar) は、xvar のデータによってグループ化された yvar のデータのボックスチャートを作成します。ここで、xvar と yvar は table tbl の変数です。1 つのデータセットをプロットするには、xvar と yvar にそれぞれ 1 つの変数を指定します。複数のデータセットをプロットするには、xvar、yvar、またはその両方に複数の変数を指定します。両方の引数に複数の変数を指定する場合は、同数の変数を指定しなければなりません。 (R2025a 以降)

例

追加オプション

boxchart(___,Name,Value) は、1 つ以上の名前と値のペアの引数を使用して追加のチャートオプションを指定します。たとえば、'Notch','on' を指定してノッチを使用することにより、サンプルの中央値を比較できます。名前と値のペアの引数は、その他すべての入力引数の後に指定します。プロパティの一覧については、BoxChart のプロパティを参照してください。

例

boxchart(ax,___) は、現在の座標軸 (gca) の代わりに ax によって指定される座標軸にプロットします。ax 引数は、前述の構文における任意の入力引数の組み合わせの前で指定できます。

例

b = boxchart(___) は BoxChart オブジェクトを返します。cgroupdata を指定しない場合、b には 1 つのオブジェクトが含まれます。指定した場合、b には、cgroupdata の各一意の値ごとに 1 つずつある、オブジェクトのベクトルが含まれます。b を使用してボックスチャートの作成後にプロパティを設定します。プロパティの一覧については、BoxChart のプロパティを参照してください。

例

すべて折りたたむ

ベクトルデータからのボックスチャートの作成

ライブスクリプトを開く

年齢のベクトルから単一のボックスチャートを作成します。ボックスチャートを使用して年齢の分布を可視化します。

patients データセットを読み込みます。変数 Age には患者 100 名の年齢が含まれています。ボックスチャートを作成して、年齢の分布を可視化します。

load patients
boxchart(Age)
ylabel('Age (years)')

Figure contains an axes object. The axes object with ylabel Age (years) contains an object of type boxchart.

患者の年齢の中央値である 39 歳は、ボックス内の線として示されます。上位四分位数と下位四分位数の 32 歳と 44 歳はそれぞれ、ボックスの上端と下端として示されます。ひげ (ボックスの下と上にはみ出している線) は、最も年齢の低い患者と、最も年齢の高い患者に対応する終点をもちます。最も年齢の低い患者は 25 歳で、最も年齢の高い患者は 50 歳です。このデータセットには小さい円で表される外れ値は含まれていません。

データヒントを使用してデータの統計量の概要を取得できます。ボックスチャートの上にカーソルを合わせてデータヒントを表示します。

行列データからのボックスチャートの作成

ライブスクリプトを開く

ボックスチャートを使用して魔方陣の列および行に沿った値の分布を比較します。

10 行 10 列の魔方陣を作成します。

Y = magic(10)

Y = 10×10

    92    99     1     8    15    67    74    51    58    40
    98    80     7    14    16    73    55    57    64    41
     4    81    88    20    22    54    56    63    70    47
    85    87    19    21     3    60    62    69    71    28
    86    93    25     2     9    61    68    75    52    34
    17    24    76    83    90    42    49    26    33    65
    23     5    82    89    91    48    30    32    39    66
    79     6    13    95    97    29    31    38    45    72
    10    12    94    96    78    35    37    44    46    53
    11    18   100    77    84    36    43    50    27    59

魔方陣の列ごとにボックスチャートを作成します。各列の中央値は類似しています (50 前後)。しかし、Y の最初の 5 列は Y の最後の 5 列よりも四分位数間範囲が大きくなっています。四分位数間範囲は上位四分位数 (ボックスの上端) と下位四分位数 (ボックスの下端) との間の距離です。

boxchart(Y)
xlabel('Column')
ylabel('Value')

Figure contains an axes object. The axes object with xlabel Column, ylabel Value contains an object of type boxchart.

魔方陣の行ごとにボックスチャートを作成します。各行の四分位数間範囲は類似していますが、中央値は行間で異なります。

boxchart(Y')
xlabel('Row')
ylabel('Value')

Figure contains an axes object. The axes object with xlabel Row, ylabel Value contains an object of type boxchart.

テーブルからのボックスチャートの作成

R2025a 以降

ライブスクリプトを開く

tsunami データセットをテーブルに読み込みます。Longitude と Latitude の変数のボックスチャートを作成し、変数名でグループにラベルを付けます。

tbl = readtable("tsunamis.xlsx");
boxchart(tbl,["Longitude","Latitude"])
xticklabels(["Longitude","Latitude"])

Figure contains an axes object. The axes object contains 2 objects of type boxchart.

位置のグループ化変数を使用した複数のボックスチャートの作成

R2025a 以降

ライブスクリプトを開く

発生した月に基づいて地震のマグニチュードをプロットします。地震マグニチュードのベクトルと、地震ごとの月を示すグループ化変数を使用します。データのグループごとに、ボックスチャートを作成して、x 軸上の指定した位置に配置します。

津波データのセットをワークスペースに table として読み取ります。このデータセットには地震だけでなく、津波のその他の原因に関する情報も含まれています。table の月、原因、地震マグニチュードの列を示す、最初の 8 行を表示します。

tsunamis = readtable('tsunamis.xlsx');
tsunamis(1:8,["Month","Cause","EarthquakeMagnitude"])

ans=8×3 table
    Month          Cause           EarthquakeMagnitude
    _____    __________________    ___________________

     10      {'Earthquake'    }            7.6        
      8      {'Earthquake'    }            6.9        
     12      {'Volcano'       }            NaN        
      3      {'Earthquake'    }            8.1        
      3      {'Earthquake'    }            4.5        
      5      {'Meteorological'}            NaN        
     11      {'Earthquake'    }              9        
      3      {'Earthquake'    }            5.8

table earthquakes を作成します。これには地震によって発生した津波のデータが含まれます。

unique(tsunamis.Cause)

ans = 8×1 cell
    {0×0 char                  }
    {'Earthquake'              }
    {'Earthquake and Landslide'}
    {'Landslide'               }
    {'Meteorological'          }
    {'Unknown Cause'           }
    {'Volcano'                 }
    {'Volcano and Landslide'   }

idx = contains(tsunamis.Cause,'Earthquake');
earthquakes = tsunamis(idx,:);

対応する津波が発生した月に基づいて、地震マグニチュードをグループ化します。月ごとに、個別のボックスチャートを表示します。たとえば、boxchart では 4 番目、5 番目、8 番目の地震マグニチュードなどを使用し、3 番目の月に対応する 3 番目のボックスチャートを作成します。

boxchart(earthquakes,"Month","EarthquakeMagnitude")
xlabel('Month')
ylabel('Earthquake Magnitude')

Figure contains an axes object. The axes object with xlabel Month, ylabel Earthquake Magnitude contains an object of type boxchart.

月の値は数値であるため、x 軸ルーラーも数値であることに注意してください。

月の名前を説明的にする場合は、earthquakes.Month 変数を categorical 変数に変換します。

monthOrder = ["Jan","Feb","Mar","Apr","May","Jun","Jul", ...
    "Aug","Sep","Oct","Nov","Dec"];
earthquakes.Months = categorical(earthquakes.Month,1:12,monthOrder);

前と同じボックスチャートを作成します。x 軸ルーラーが categorical になったため、Months のカテゴリの順序により、ボックスチャートの順序が決まります。

boxchart(earthquakes,"Months","EarthquakeMagnitude")
xlabel('Month')
ylabel('Earthquake Magnitude')

Figure contains an axes object. The axes object with xlabel Month, ylabel Earthquake Magnitude contains an object of type boxchart.

グループ化変数を作成するデータのビン化

ライブスクリプトを開く

医療患者を年齢に基づいてグループ化し、年齢グループごとに拡張期血圧値のボックスチャートを作成します。

patients データセットを読み込みます。変数 Age および変数 Diastolic には患者 100 名の年齢と拡張期血圧レベルが含まれます。

load patients

これらの患者を 5 つの年齢のビンにグループ化します。最低年齢と最高年齢を求めてから、その間の範囲を 5 つの年齢のビンに分割します。関数 discretize を使用し、変数 Age で値をビン化します。bins でビンの名前を使用します。結果の変数 groupAge は変数 categorical になります。

min(Age)

ans = 
25

max(Age)

ans = 
50

binEdges = 25:5:50;
bins = {'late 20s','early 30s','late 30s','early 40s','late 40s+'};
groupAge = discretize(Age,binEdges,'categorical',bins);

年齢グループごとにボックスチャートを作成します。各ボックスチャートには、そのグループの患者の拡張期血圧値が示されます。

boxchart(groupAge,Diastolic)
xlabel('Age Group')
ylabel('Diastolic Blood Pressure')

Figure contains an axes object. The axes object with xlabel Age Group, ylabel Diastolic Blood Pressure contains an object of type boxchart.

位置および色のグループ化変数の使用

ライブスクリプトを開く

2 つのグループ化変数を使用して、データをグループ化し、結果のボックスチャートの位置と色を設定します。

2015 年 1 月から 2016 年 7 月までの毎日の平均気温を含んだサンプルファイル TemperatureData.csv を読み込みます。ファイルを table に読み取ります。

tbl = readtable('TemperatureData.csv');

変数 tbl.Month を変数 categorical に変換します。カテゴリの順序を指定します。

monthOrder = {'January','February','March','April','May','June','July', ...
    'August','September','October','November','December'};
tbl.Month = categorical(tbl.Month,monthOrder);

月と年を組み合わせた期間中の気温の分布を示すボックスチャートを作成します。tbl.Month を位置のグループ化変数として指定します。'GroupByColor' 名前と値のペア引数を使用して、tbl.Year を色のグループ化変数として指定します。tbl には、2016 年のいくつかの月のデータが含まれていません。

boxchart(tbl.Month,tbl.TemperatureF,'GroupByColor',tbl.Year)
ylabel('Temperature (F)')
legend

Figure contains an axes object. The axes object with ylabel Temperature (F) contains 2 objects of type boxchart. These objects represent 2015, 2016.

この図では、複数の年にわたり特定の月の気温の分布を簡単に比較できます。たとえば、2 月の気温は 2015 年よりも 2016 年の変動が大きいことがわかります。

ボックスチャート上への平均のプロット

ライブスクリプトを開く

ボックスチャートを作成し、hold on を使用してそのボックスチャート上に平均値をプロットします。

patients データセットを読み込みます。Poor、Fair、Good、Excellent の各カテゴリは自然順をもつため、SelfAssessedHealthStatus を順序変数 categorical に変換します。

load patients
healthOrder = {'Poor','Fair','Good','Excellent'};
SelfAssessedHealthStatus = categorical(SelfAssessedHealthStatus, ...
    healthOrder,'Ordinal',true);

自己申告の健康状態に従って患者をグループ化し、各グループの患者の平均体重を求めます。

meanWeight = groupsummary(Weight,SelfAssessedHealthStatus,'mean');

ボックスチャートを使用して患者の各グループの体重を比較します。平均体重をボックスチャート上にプロットします。

boxchart(SelfAssessedHealthStatus,Weight)
hold on
plot(meanWeight,'-o')
hold off
legend(["Weight Data","Weight Mean"])

Figure contains an axes object. The axes object contains 2 objects of type boxchart, line. These objects represent Weight Data, Weight Mean.

ノッチを使用した中央値の比較

ライブスクリプトを開く

ノッチを使用して、中央値が相互に大きく異なるかどうかを判断します。

patients データセットを読み込みます。場所に基づいて患者を分割します。患者のグループごとに、体重のボックスチャートを作成します。'Notch','on' を指定して、各ボックスにノッチと呼ばれる、先細の影付き領域が含まれるようにします。ノッチがオーバーラップしないボックスチャートには、5% の有意水準で異なる中央値があります。

load patients
boxchart(categorical(Location),Weight,'Notch','on')
ylabel('Weight (lbs)')

Figure contains an axes object. The axes object with ylabel Weight (lbs) contains an object of type boxchart.

この例では、3 つのノッチがオーバーラップしており、3 つの体重の中央値は大きく異ならないことを示しています。

ボックスチャートの座標軸の指定

ライブスクリプトを開く

関数 tiledlayout と関数 nexttile を使用して、ボックスチャートのペアを並べて表示します。

patients データセットを読み込みます。Smoker を、説明的なカテゴリ名 (1 や 0 ではなく、Smoker や Nonsmoker) をもつ変数 categorical に変換します。

load patients
Smoker = categorical(Smoker,logical([1 0]),{'Smoker','Nonsmoker'});

関数 tiledlayout を使用して、1 行 2 列のタイル表示チャートレイアウトを作成します。関数 nexttile を呼び出して、最初の座標軸 ax1 のセットをその内部で作成します。1 番目の座標軸のセットには、喫煙者と非喫煙者に対する収縮期血圧値の 2 つのボックスチャートが表示されます。関数 nexttile を呼び出して、タイル表示チャートレイアウト内で座標軸 ax2 の 2 番目のセットを作成します。座標軸の 2 番目のセットで、拡張期血圧値について同じ操作を実行します。

tiledlayout(1,2)

% Left axes
ax1 = nexttile;
boxchart(ax1,Systolic,'GroupByColor',Smoker)
ylabel(ax1,'Systolic Blood Pressure')
legend

% Right axes
ax2 = nexttile;
boxchart(ax2,Diastolic,'GroupByColor',Smoker)
ylabel(ax2,'Diastolic Blood Pressure')
legend

Figure contains 2 axes objects. Axes object 1 with ylabel Systolic Blood Pressure contains 2 objects of type boxchart. These objects represent Smoker, Nonsmoker. Axes object 2 with ylabel Diastolic Blood Pressure contains 2 objects of type boxchart. These objects represent Smoker, Nonsmoker.

`BoxChart` オブジェクトの色の更新

ライブスクリプトを開く

BoxChart オブジェクトのベクトルとして返される、色分けされたボックスチャートのセットを作成します。ベクトルを使用して、1 つのボックスチャートの色を変更します。

patients データセットを読み込みます。Gender および Smoker を変数 categorical に変換します。1 および 0 ではなく、説明的なカテゴリ名 Smoker および Nonsmoker を指定します。

load patients
Gender = categorical(Gender);
Smoker = categorical(Smoker,logical([1 0]),{'Smoker','Nonsmoker'});

変数 Gender と変数 Smoker を 1 つのグループ化変数 cgroupdata に連結します。性別および喫煙状態の各組み合わせの拡張期血圧レベルの分布を示すボックスチャートを作成します。b は、データのグループごとに 1 つずつある、BoxChart オブジェクトのベクトルです。

cgroupdata = Gender.*Smoker;
b = boxchart(Diastolic,'GroupByColor',cgroupdata)

b = 
  4×1 BoxChart array:

  BoxChart
  BoxChart
  BoxChart
  BoxChart

legend('Location','southeast')

Figure contains an axes object. The axes object contains 4 objects of type boxchart. These objects represent Female Smoker, Female Nonsmoker, Male Smoker, Male Nonsmoker.

SeriesIndex プロパティを使用して 3 つ目のボックスチャートの色を更新します。SeriesIndex プロパティを更新すると、ボックス面の色と外れ値マーカーの色の両方が変更されます。

b(3).SeriesIndex = 6;

Figure contains an axes object. The axes object contains 4 objects of type boxchart. These objects represent Female Smoker, Female Nonsmoker, Male Smoker, Male Nonsmoker.

外れ値の可視化と検出

ライブスクリプトを開く

多数の外れ値をもつ停電データからボックスチャートを作成し、BoxChart オブジェクトのプロパティを変更することにより、それらを視覚的に簡単に区別できるようにします。外れ値エントリのインデックスを求めます。

停電データをワークスペースに table として読み取ります。table の最初の数行を表示します。

outages = readtable('outages.csv');
head(outages)

       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'}

BoxChart オブジェクト b を outages.Customers 値から作成し、停電ごとに影響を受けた顧客の数を示します。boxchart は NaN 値をもつエントリを破棄します。

b = boxchart(outages.Customers);
ylabel('Number of Customers')

Figure contains an axes object. The axes object with ylabel Number of Customers contains an object of type boxchart.

このプロットには多くの外れ値が含まれます。これらを見やすくするために、外れ値に微変動を起こし、外れ値のマーカースタイルを変更します。BoxChart オブジェクトの JitterOutliers プロパティを 'on' に設定すると、外れ値のマーカーは水平方向にランダムに変位するため、完全にオーバーラップする可能性は非常に低くなります。外れ値の値と縦方向の位置は変更されません。

b.JitterOutliers = 'on';
b.MarkerStyle = '.';

Figure contains an axes object. The axes object with ylabel Number of Customers contains an object of type boxchart.

これで、外れ値の分布を簡単に確認できます。

外れ値のインデックスを求めるには、関数 isoutlier を使用します。boxchart の外れ値の定義と一致するように外れ値を計算する 'quartiles' メソッドを指定します。インデックスを使用して outages データのサブセットが含まれる outliers table を作成します。isoutlier で 96 個の外れ値が特定されたことがわかります。

idx = isoutlier(outages.Customers,'quartiles');
outliers = outages(idx,:);
size(outliers,1)

ans = 
96

これらすべての外れ値により、ボックスチャートの四分位数が見づらくなっています。これらを挿入するには、y 軸の範囲を変更します。

ylim([0 4e5])

Figure contains an axes object. The axes object with ylabel Number of Customers contains an object of type boxchart.

入力引数

すべて折りたたむ

`ydata` — サンプルデータ
数値ベクトル | 数値行列

サンプルデータ。数値ベクトルまたは行列として指定します。

ydata が行列の場合、boxchart は ydata の列ごとにボックスチャートを作成します。
ydata がベクトルで、xgroupdata または cgroupdata を指定しない場合、boxchart は単一のボックスチャートを作成します。
ydata がベクトルで、xgroupdata または xgroupdata を指定する場合、boxchart は cgroupdata と cgroupdata の一意の値の組み合わせごとにボックスチャートを作成します。

`xgroupdata` — 位置のグループ化変数
数値ベクトル | categorical ベクトル

位置のグループ化変数。数値ベクトルまたは categorical ベクトルとして指定します。xgroupdata はベクトル ydata と同じ長さでなければなりません。ydata が行列の場合に xgroupdata を指定することはできません。

boxchart は xgroupdata および cgroupdata の一意の値の組み合わせに従って ydata のデータをグループ化します。この関数はデータのグループごとにボックスチャートを作成し、各ボックスチャートを対応する xgroupdata 値に配置します。通常の設定では、boxchart は垂直方向にボックスチャートを配置し、x 軸上に xgroupdata 値を表示します。ボックスチャートの方向は、Orientation プロパティを使用して変更できます。

`cgroupdata` — 色のグループ化変数
数値ベクトル | categorical ベクトル | logical ベクトル | string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

色のグループ化変数。数値ベクトル、categorical ベクトル、logical ベクトル、string 配列、文字ベクトル、または文字ベクトルの cell 配列として指定します。cgroupdata は、ベクトル ydata と同じ長さでなければなりません。ydata が行列の場合、cgroupdata は指定できません。

boxchart は xgroupdata および cgroupdata の一意の値の組み合わせに従って ydata のデータをグループ化します。データのグループごとにボックスチャートが作成され、同じ cgroupdata 値をもつグループに同じ色が割り当てられます。

`tbl` — ソース table
table | timetable

プロットするデータが含まれるソース table。table または timetable として指定します。

`xvar` — 位置のグループ化データを含む table 変数
1 つ以上の table 変数インデックス

位置のグループ化データを含む table 変数。1 つ以上の table 変数インデックスとして指定します。指定する table 変数には、数値、categorical 値、datetime 値、または duration 値を含める必要があります。

table インデックスの指定

以下のいずれかのインデックス方式を使用して、目的の変数を 1 つ以上指定します。

インデックス方式例

インデックス方式	例
変数名: string、文字ベクトル、または cell 配列。 `pattern` オブジェクト。	`"A"` または `'A'` — `A` という名前の変数 `["A","B"]` または `{'A','B'}` — `A` および `B` という名前の 2 つの変数 `"Var"+digitsPattern(1)` — `"Var"` の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。数値のベクトル。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の `0` 値や `false` 値は省略できます。	`3` — table の 3 番目の変数 `[2 3]` — table の 2 番目と 3 番目の変数 `[false false true]` — 3 番目の変数
変数の型: 指定した型の変数を選択する `vartype` 添字。	`vartype("categorical")` — categorical 値を含んでいるすべての変数

変数名:

string、文字ベクトル、または cell 配列。
pattern オブジェクト。

"A" または 'A' — A という名前の変数
["A","B"] または {'A','B'} — A および B という名前の 2 つの変数
"Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数

変数インデックス:

table 内の変数の位置を参照するインデックス番号。
数値のベクトル。
logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。

3 — table の 3 番目の変数
[2 3] — table の 2 番目と 3 番目の変数
[false false true] — 3 番目の変数

変数の型:

指定した型の変数を選択する vartype 添字。

vartype("categorical") — categorical 値を含んでいるすべての変数

データのプロット

1 つのボックスチャートセットをプロットするには、xvar と yvar にそれぞれ 1 つの変数を指定します。たとえば、1 つの categorical グループ化変数と、正規分布の乱数値を含む 2 つの変数をもつ table を作成します。X のデータによってグループ化された Y1 のデータをプロットします。

X = categorical(repelem(["a1";"b1"],50));
Y1 = randn(100,1);
Y2 = 5*randn(100,1)+10;
tbl = table(X,Y1,Y2);

boxchart(tbl,"X","Y1")

複数のデータセットをまとめてプロットするには、xvar、yvar、またはその両方に複数の変数を指定します。両方の引数に複数の変数を指定する場合、各引数に対する変数の数は同じでなければなりません。

たとえば、グループ化変数として X を使用して Y1 のデータからボックスチャートのセットを作成し、データとして Y2 を使用してボックスチャートのセットを作成します。

boxchart(tbl,"X",["Y1","Y2"])

xvar および yvar に対して異なるインデックス方式も使用できます。たとえば、xvar を変数名として、yvar をインデックス番号として指定します。

boxchart(tbl,"X",3)

`yvar` — サンプルデータを含む table 変数
1 つ以上の table 変数インデックス

サンプルデータを含む table 変数。1 つ以上の table 変数インデックスとして指定します。指定する table 変数には、数値、categorical 値、datetime 値、または duration 値を含める必要があります。

table インデックスの指定

以下のいずれかのインデックス方式を使用して、目的の変数を 1 つ以上指定します。

インデックス方式例

インデックス方式	例
変数名: string、文字ベクトル、または cell 配列。 `pattern` オブジェクト。	`"A"` または `'A'` — `A` という名前の変数 `["A","B"]` または `{'A','B'}` — `A` および `B` という名前の 2 つの変数 `"Var"+digitsPattern(1)` — `"Var"` の後に数字 1 桁が続く名前の変数
変数インデックス: table 内の変数の位置を参照するインデックス番号。数値のベクトル。 logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の `0` 値や `false` 値は省略できます。	`3` — table の 3 番目の変数 `[2 3]` — table の 2 番目と 3 番目の変数 `[false false true]` — 3 番目の変数
変数の型: 指定した型の変数を選択する `vartype` 添字。	`vartype("categorical")` — categorical 値を含んでいるすべての変数

変数名:

string、文字ベクトル、または cell 配列。
pattern オブジェクト。

"A" または 'A' — A という名前の変数
["A","B"] または {'A','B'} — A および B という名前の 2 つの変数
"Var"+digitsPattern(1) — "Var" の後に数字 1 桁が続く名前の変数

変数インデックス:

table 内の変数の位置を参照するインデックス番号。
数値のベクトル。
logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。

3 — table の 3 番目の変数
[2 3] — table の 2 番目と 3 番目の変数
[false false true] — 3 番目の変数

変数の型:

指定した型の変数を選択する vartype 添字。

vartype("categorical") — categorical 値を含んでいるすべての変数

データのプロット

1 つのボックスチャートセットをプロットするには、xvar と yvar にそれぞれ 1 つの変数を指定します。たとえば、2 つの categorical グループ化変数と、正規分布の乱数値を含む 1 つの変数をもつ table を作成します。X1 のデータによってグループ化された Y のデータをプロットします。

X1 = categorical(repelem(["a1";"b1"],50));
X2 = categorical(repelem(["a2";"b2";"c2"],[33,33,34]));
Y = randn(100,1);
tbl = table(X1,X2,Y);

boxchart(tbl,"X1","Y")

たとえば、グループ化変数として X1 を使用して Y のデータからボックスチャートのセットを作成し、グループ化変数として X2 を使用してボックスチャートのセットを作成します。

boxchart(tbl,["X1","X2"],"Y")

xvar および yvar に対して異なるインデックス方式も使用できます。たとえば、xvar を変数名として、yvar をインデックス番号として指定します。

boxchart(tbl,"X1",3)

`ax` — ターゲット座標軸
`Axes` オブジェクト

ターゲット座標軸。Axes オブジェクトとして指定します。座標軸を指定しない場合、boxchart は現在の座標軸 (gca) を使用します。

名前と値の引数

すべて折りたたむ

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: boxchart([rand(10,4); 4*rand(1,4)],'BoxFaceColor',[0 0.5 0],'MarkerColor',[0 0.5 0]) は、適用される場合、緑のボックスと緑の外れ値を使用してボックスチャートを作成します。

メモ

ここでは、BoxChart プロパティの一部だけを紹介しています。完全な一覧については、BoxChart のプロパティを参照してください。

`BoxFaceColor` — ボックスの色
RGB 3 成分 | 16 進数カラーコード | 色名 | 省略名

ボックスの色。RGB 3 成分、16 進数カラーコード、色名、または省略名として指定します。ボックスには、ボックスのエッジと中央値の線が含まれます。ボックスのエッジと中央値の線の色を個別に指定するには、BoxEdgeColor プロパティを使用できます。中央値の線の色のみを指定するには、BoxMedianLineColor プロパティを使用します。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラーコードを指定します。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。
16 進数カラーコードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く string スカラーまたは文字ベクトルです。この値は大文字と小文字を区別しません。したがって、カラーコード "#FF8800"、"#ff8800"、"#F80"、および "#f80" は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラーコードを示します。

色名	省略名	RGB 3 成分	16 進数カラーコード	外観
`"red"`	`"r"`	`[1 0 0]`	`"#FF0000"`
`"green"`	`"g"`	`[0 1 0]`	`"#00FF00"`
`"blue"`	`"b"`	`[0 0 1]`	`"#0000FF"`
`"cyan"`	`"c"`	`[0 1 1]`	`"#00FFFF"`
`"magenta"`	`"m"`	`[1 0 1]`	`"#FF00FF"`
`"yellow"`	`"y"`	`[1 1 0]`	`"#FFFF00"`
`"black"`	`"k"`	`[0 0 0]`	`"#000000"`
`"white"`	`"w"`	`[1 1 1]`	`"#FFFFFF"`
`"none"`	該当なし	該当なし	該当なし	色なし

次の表に、ライトテーマとダークテーマでのプロットの既定のカラーパレットを示します。

パレットパレットの色

パレット	パレットの色
`"gem"` — ライトテーマの既定値 R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。
`"glow"` — ダークテーマの既定値

"gem" — ライトテーマの既定値

R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。

Sample of the "gem" color palette

"glow" — ダークテーマの既定値

Sample of the "glow" color palette

orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラーコードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラーコードに変換します。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。

R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラーコードを取得します。

例: b = boxchart(rand(10,1),'BoxFaceColor','red')

例: b.BoxFaceColor = [0 0.5 0.5];

例: b.BoxFaceColor = '#EDB120';

`ColorGroupLayout` — 色グループのレイアウト
`"grouped"` (既定値) | `"overlaid"`

R2025a 以降

色グループのレイアウト。"grouped" または "overlaid" として指定します。既定では、各色のグループ化のボックスチャートは互いに並べてプロットされます。各ボックスチャートの幅は、cgroupdata に指定された色の数 (つまり、カラーデータの一意の値) の逆数に応じて決まります。

ColorGroupLayout="overlaid" を指定すると、次のようになります。

各色のグループ化のボックスチャートは、互いに重ねてプロットされます。
ColorGroupWidth の値は無視されます。
BoxWidth を指定することで、重ね合わされた色のグループ化間の間隔を調整できます。

データ型: string | char

`MarkerStyle` — 外れ値スタイル
`'o'` (既定値) | `'+'` | `'*'` | `'.'` | `'x'` | ...

外れ値スタイル。次の表にリストされたオプションのいずれかとして指定します。

マーカー	説明	結果のマーカー
`"o"`	円
`"+"`	プラス記号
`"*"`	アスタリスク
`"."`	点
`"x"`	十字
`"_"`	水平線
`"\|"`	垂直線
`"square"`	正方形
`"diamond"`	菱形
`"^"`	上向き三角形
`"v"`	下向き三角形
`">"`	右向き三角形
`"<"`	左向き三角形
`"pentagram"`	星形五角形
`"hexagram"`	星形六角形
`"none"`	マーカーなし	該当なし

例: b = boxchart([rand(10,1);2],'MarkerStyle','x')

例: b.MarkerStyle = 'x';

`JitterOutliers` — 外れ値マーカー変位
`'off'` (既定値) | on/off logical 値

外れ値マーカー変位。'on' または 'off' もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' の値は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

JitterOutliers プロパティを 'on' に設定すると、boxchart は外れ値のマーカーを XData 方向にランダムに変位するため、類似する ydata 値をもつ外れ値が区別しやすくなります。例については、外れ値の可視化と検出を参照してください。

例: b = boxchart([rand(20,1);2;2;2],'JitterOutliers','on')

例: b.JitterOutliers = 'on';

`Notch` — 中央値比較表示
`'off'` (既定値) | on/off logical 値

中央値比較表示。'on' または 'off' もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' の値は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

Notch プロパティを 'on' に設定すると、boxchart により、各中央値の周りに先細の影付き領域が作成されます。ノッチがオーバーラップしないボックスチャートには、5% の有意水準で異なる中央値があります。詳細については、ボックスチャート (箱ひげ図)を参照してください。

ノッチは下位四分位数と上位四分位数を超えて拡張できます。

例: b = boxchart(rand(10,2),'Notch','on')

例: b.Notch = 'on';

`Orientation` — ボックスチャートの方向
`'vertical'` (既定値) | `'horizontal'`

ボックスチャートの方向。'vertical' または 'horizontal' として指定します。通常の設定では、ボックスチャートの方向は垂直であるため、ydata 統計は y 軸に揃えられます。方向に関係なく、boxchart は ydata 値を BoxChart オブジェクトの YData プロパティに格納します。

例: b = boxchart(rand(10,1),'Orientation','horizontal')

例: b.Orientation = 'horizontal';

出力引数

すべて折りたたむ

`b` — ボックスチャート
`BoxChart` オブジェクトのベクトル

ボックスチャート。BoxChart オブジェクトのベクトルとして返されます。b には、cgroupdata の一意の値ごとに BoxChart オブジェクトが 1 つ含まれます。詳細については、BoxChart のプロパティを参照してください。

詳細

すべて折りたたむ

ボックスチャート (箱ひげ図)

ボックスチャート (箱ひげ図) により、データサンプルの要約統計量の視覚的表現が提供されます。数値データを指定すると、対応するボックスチャートには、中央値、上位四分位数、下位四分位数、すべての外れ値 (四分位数間範囲を使用して計算)、外れ値でない最小値と最大値の各情報が表示されます。

各ボックス内の線はサンプルの中央値です。関数 median を使用して中央値の値を計算できます。
各ボックスの上端と下端はそれぞれ、上位四分位数と下位四分位数です。上端と下端の間の距離は四分位数間範囲 (IQR) です。
四分位数を計算する方法の詳細については、quantile を参照してください。ここで、上位四分位数は 0.75 四分位数に対応し、下位四分位数は 0.25 四分位数に対応します。
外れ値は、ボックスの上端と下端から 1.5 · IQR を超えて離れている値です。通常の設定では、boxchart には 'o' 記号を使用した外れ値がそれぞれ表示されます。外れ値の計算は 'quartiles' メソッドを使用した関数 isoutlier と同じです。
ひげは、各ボックスの上下を超えている線です。一方のひげは上位四分位数を "最大非外れ値" (外れ値でない最大データ値) につなげ、もう一方は下位四分位数を "最小非外れ値" (外れ値でない最小データ値) につなげます。
ノッチは、複数のボックスチャートに対するサンプルの中央値を比較する場合に役立ちます。'Notch','on' を指定すると、関数 boxchart により、各中央値の周りに先細の影付き領域が作成されます。ノッチがオーバーラップしないボックスチャートには、5% の有意水準で異なる中央値があります。有意水準は標準の分布仮定に基づいていますが、中央値の比較はその他の分布に対して十分にロバストです。
ノッチ領域の上端と下端は $m + (1.57 \cdot I Q R) / \sqrt{n}$ と $m - (1.57 \cdot I Q R) / \sqrt{n}$ にそれぞれ対応しています。ここで、m は中央値、IQR は四分位数間範囲、n は NaN 値を除いたデータ点数です。

Example box charts, with labels for the summary statistics

ヒント

BoxChart オブジェクトのデータを調べるには、データヒントを使用します。一部のオプションはライブエディターでは使用できません。
- 2 種類のデータヒントを BoxChart オブジェクトに追加できます。1 つは各ボックスチャート、もう 1 つは各外れ値に使用します。一般的なデータヒントは、ボックスチャートでクリックする位置に関係なく、非外れ最大値で表示されます。
  
  メモ
  表示された Num Points 値には対応する ydata の NaN 値が含まれますが、ボックスチャートの統計を計算する前にboxchart は NaN 値を破棄します。
- 関数 datatip を使用してデータヒントを BoxChart オブジェクトに追加できますが、データヒントのインデックス付けが他のチャートと異なります。boxchart は最初にインデックスをボックスチャートに割り当ててから、インデックスを外れ値に割り当てます。たとえば、BoxChart オブジェクト b に 2 つのボックスチャートと 1 つの外れ値が表示される場合、datatip(b,'DataIndex',3) は外れ値点でデータヒントを作成します。

バージョン履歴

R2020a で導入

すべて展開する

R2025a: table のデータを使用したボックスチャートの作成

table および timetable のデータからボックスチャートを作成できます。新しい構文 boxchart(tbl,yvar) を使用して、table tbl の yvar 変数からボックスチャートを作成します。table からグループ化されたボックスチャートを作成するには、boxchart(tbl,xvar,yvar) を使用します。yvar のデータが xvar のデータでグループ化されます。

R2025a: ひげおよび色グループの外観のカスタマイズ

以下の名前と値の引数を使用して、ボックスチャートのひげの外観や色グループをさらにカスタマイズできます。

CapWidth — ひげのエンドキャップの幅を設定します。
ColorGroupWidth — ボックスチャートの色のグループ化間の間隔を調整します。
ColorGroupLayout — それぞれの色のグループ化でボックスチャートをグループ化するか重ね合わせるかを指定します。
BoxWidth — 重ね合わせた色のグループ化間の間隔を調整します。

boxchart

構文

説明

ベクトルと行列のデータ

テーブル データ

追加オプション

例

ベクトル データからのボックス チャートの作成

行列データからのボックス チャートの作成

テーブルからのボックス チャートの作成

位置のグループ化変数を使用した複数のボックス チャートの作成

グループ化変数を作成するデータのビン化

位置および色のグループ化変数の使用

ボックス チャート上への平均のプロット

ノッチを使用した中央値の比較

ボックス チャートの座標軸の指定

BoxChart オブジェクトの色の更新

外れ値の可視化と検出

入力引数

ydata — サンプル データ 数値ベクトル | 数値行列

xgroupdata — 位置のグループ化変数 数値ベクトル | categorical ベクトル

cgroupdata — 色のグループ化変数 数値ベクトル | categorical ベクトル | logical ベクトル | string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

tbl — ソース table table | timetable

xvar — 位置のグループ化データを含む table 変数 1 つ以上の table 変数インデックス

table インデックスの指定

データのプロット

yvar — サンプル データを含む table 変数 1 つ以上の table 変数インデックス

table インデックスの指定

データのプロット

ax — ターゲット座標軸 Axes オブジェクト

名前と値の引数

BoxFaceColor — ボックスの色 RGB 3 成分 | 16 進数カラー コード | 色名 | 省略名

ColorGroupLayout — 色グループのレイアウト "grouped" (既定値) | "overlaid"

MarkerStyle — 外れ値スタイル 'o' (既定値) | '+' | '*' | '.' | 'x' | ...

JitterOutliers — 外れ値マーカー変位 'off' (既定値) | on/off logical 値

Notch — 中央値比較表示 'off' (既定値) | on/off logical 値

Orientation — ボックス チャートの方向 'vertical' (既定値) | 'horizontal'

出力引数

b — ボックス チャート BoxChart オブジェクトのベクトル

詳細

ボックス チャート (箱ひげ図)

ヒント

バージョン履歴

R2025a: table のデータを使用したボックス チャートの作成

R2025a: ひげおよび色グループの外観のカスタマイズ

参考

関数

プロパティ

テーブルデータ

ベクトルデータからのボックスチャートの作成

行列データからのボックスチャートの作成

テーブルからのボックスチャートの作成

位置のグループ化変数を使用した複数のボックスチャートの作成

ボックスチャート上への平均のプロット

ボックスチャートの座標軸の指定

`BoxChart` オブジェクトの色の更新

`ydata` — サンプルデータ
数値ベクトル | 数値行列

`xgroupdata` — 位置のグループ化変数
数値ベクトル | categorical ベクトル

`cgroupdata` — 色のグループ化変数
数値ベクトル | categorical ベクトル | logical ベクトル | string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

`tbl` — ソース table
table | timetable

`xvar` — 位置のグループ化データを含む table 変数
1 つ以上の table 変数インデックス

`yvar` — サンプルデータを含む table 変数
1 つ以上の table 変数インデックス

`ax` — ターゲット座標軸
`Axes` オブジェクト

`BoxFaceColor` — ボックスの色
RGB 3 成分 | 16 進数カラーコード | 色名 | 省略名

`ColorGroupLayout` — 色グループのレイアウト
`"grouped"` (既定値) | `"overlaid"`

`MarkerStyle` — 外れ値スタイル
`'o'` (既定値) | `'+'` | `'*'` | `'.'` | `'x'` | ...

`JitterOutliers` — 外れ値マーカー変位
`'off'` (既定値) | on/off logical 値

`Notch` — 中央値比較表示
`'off'` (既定値) | on/off logical 値

`Orientation` — ボックスチャートの方向
`'vertical'` (既定値) | `'horizontal'`

`b` — ボックスチャート
`BoxChart` オブジェクトのベクトル

ボックスチャート (箱ひげ図)

R2025a: table のデータを使用したボックスチャートの作成