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(___,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.

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

発生した月に基づいて地震のマグニチュードをプロットします。地震マグニチュードのベクトルと、地震ごとの月を示すグループ化変数を使用します。データのグループごとに、ボックスチャートを作成して、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 = 8x1 cell
    {0x0 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,earthquakes.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"];
namedMonths = categorical(earthquakes.Month,1:12,monthOrder);

前と同じボックスチャートを作成しますが、数値の月ではなく categorical 変数 namedMonths を使用します。x 軸ルーラーが categorical になったため、namedMonths のカテゴリの順序により、ボックスチャートの順序が決まります。

boxchart(namedMonths,earthquakes.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 = 
  4x1 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'}    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'}

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 値をもつグループに同じ色が割り当てられます。

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

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

名前と値の引数

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

R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name を引用符で囲みます。

例: 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"`	該当なし	該当なし	該当なし	色なし

MATLAB^® の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラーコードを次に示します。

RGB 3 成分	16 進数カラーコード	外観
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`

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

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

例: b.BoxFaceColor = '#EDB120';

`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 のプロパティを参照してください。

詳細