誤差範囲

誤差範囲は、データポイントのばらつきを表示するために使用されるグラフィック要素です。ErrorBars クラスのプロパティと関連する列挙型を使用することで、特定の要件に応じて誤差範囲を追加およびカスタマイズし、グラフ内のデータの正確な表現を確保することができます。SPREADは、XML および Excel 形式からのグラフの誤差範囲のインポートおよびエクスポートもサポートしています。

軸に沿った誤差範囲の方向を設定するには、ErrorBarDirection 列挙型を使用します。これは2つの値を提供します。

X: X軸の値に対して、棒グラフがY軸に平行に走ることを示します。
Y: Y軸の値に対して、棒グラフがX軸に平行に走ることを示します。

ErrorBarType 列挙型を使用して、誤差範囲の種類を定義することができます。以下の3つの値があります。

Minus: 負の誤差範囲を持つ誤差範囲を表します。
Plus: 正の誤差範囲を持つ誤差範囲を表します。
Both: 正と負の両方の誤差範囲を持つエラーバーを表します。

エラー値の種類を定義するには、ErrorBarValueType 列挙型を使用します。この列挙型は、以下の4つの値で構成されています。

FixedValue: エラーを絶対値で表します。
Percentage: エラーをパーセンテージで表します。
StandardDeviation: エラーを標準偏差の数として表します。
StandardError: 標準誤差値を表します。

SPREADを使用すると、以下のようなさまざまなグラフシリーズで誤差範囲を使用できます。

BarSeries
LineSeries
AreaSeries
XYLineSeries
XYPointSeries
ClusteredBarSeries
HighLowCloseSeries
CandlestickSeries

コードの使用

以下のサンプルコードを使用して、SPREADのClusteredBarSeriesにErrorBarを実装する方法を示します。

C#	コードのコピー
fpSpread1.ActiveSheet.AddChart(new CellRange(0, 0, 3, 6), typeof(FarPoint.Win.Chart.ClusteredBarSeries), 600, 300, 50, 70); fpSpread1.ActiveSheet.SetClip(0, 1, 1, 5, "1.2\t0\t-12.5\t-5\t15"); fpSpread1.ActiveSheet.SetClip(1, 0, 1, 6, "1\t-15.43\t-11\t16\t0\t17.5"); fpSpread1.ActiveSheet.SetClip(2, 0, 1, 6, "2\t7\t12\t0\t-10\t10\t0"); if (fpSpread1.ActiveSheet.Charts[0].Model.PlotAreas[0].Series[0] is ClusteredBarSeries cluster) { foreach (BarSeries series in cluster.Series) { ErrorBars errorBar = series.SetErrorBarsVisible(true); errorBar.ValueType = ErrorBarValueType.StandardError; errorBar.Type = FarPoint.Win.Chart.ErrorBarType.Both; } }

コードのコピー

fpSpread1.ActiveSheet.AddChart(new CellRange(0, 0, 3, 6), typeof(FarPoint.Win.Chart.ClusteredBarSeries), 600, 300, 50, 70);
fpSpread1.ActiveSheet.SetClip(0, 1, 1, 5, "1.2\t0\t-12.5\t-5\t15");
fpSpread1.ActiveSheet.SetClip(1, 0, 1, 6, "1\t-15.43\t-11\t16\t0\t17.5");
fpSpread1.ActiveSheet.SetClip(2, 0, 1, 6, "2\t7\t12\t0\t-10\t10\t0");
if (fpSpread1.ActiveSheet.Charts[0].Model.PlotAreas[0].Series[0] is ClusteredBarSeries cluster)
{
    foreach (BarSeries series in cluster.Series)
    {
        ErrorBars errorBar = series.SetErrorBarsVisible(true);
        errorBar.ValueType = ErrorBarValueType.StandardError;
        errorBar.Type = FarPoint.Win.Chart.ErrorBarType.Both;
     }
}

VB	コードのコピー
FpSpread1.ActiveSheet.AddChart(New CellRange(0, 0, 3, 6), GetType(FarPoint.Win.Chart.ClusteredBarSeries), 600, 300, 50, 70) FpSpread1.ActiveSheet.SetClip(0, 1, 1, 5, "1.2" & vbTab & "0" & vbTab & "-12.5" & vbTab & "-5" & vbTab & "15") FpSpread1.ActiveSheet.SetClip(1, 0, 1, 6, "1" & vbTab & "-15.43" & vbTab & "-11" & vbTab & "16" & vbTab & "0" & vbTab & "17.5") FpSpread1.ActiveSheet.SetClip(2, 0, 1, 6, "2" & vbTab & "7" & vbTab & "12" & vbNullChar & vbTab & "-10" & vbTab & "10" & vbTab & "0") Dim cluster As ClusteredBarSeries = Nothing If CSharpImpl.__Assign(cluster, TryCast(FpSpread1.ActiveSheet.Charts(0).Model.PlotAreas(0).Series(0), ClusteredBarSeries)) IsNot Nothing Then For Each series As BarSeries In cluster.Series Dim errorBar As ErrorBars = series.SetErrorBarsVisible(True) errorBar.ValueType = ErrorBarValueType.StandardError errorBar.Type = FarPoint.Win.Chart.ErrorBarType.Both Next End If

コードのコピー

FpSpread1.ActiveSheet.AddChart(New CellRange(0, 0, 3, 6), GetType(FarPoint.Win.Chart.ClusteredBarSeries), 600, 300, 50, 70)
FpSpread1.ActiveSheet.SetClip(0, 1, 1, 5, "1.2" & vbTab & "0" & vbTab & "-12.5" & vbTab & "-5" & vbTab & "15")
FpSpread1.ActiveSheet.SetClip(1, 0, 1, 6, "1" & vbTab & "-15.43" & vbTab & "-11" & vbTab & "16" & vbTab & "0" & vbTab & "17.5")
FpSpread1.ActiveSheet.SetClip(2, 0, 1, 6, "2" & vbTab & "7" & vbTab & "12" & vbNullChar & vbTab & "-10" & vbTab & "10" & vbTab & "0")
Dim cluster As ClusteredBarSeries = Nothing
If CSharpImpl.__Assign(cluster, TryCast(FpSpread1.ActiveSheet.Charts(0).Model.PlotAreas(0).Series(0), ClusteredBarSeries)) IsNot Nothing Then
    For Each series As BarSeries In cluster.Series
        Dim errorBar As ErrorBars = series.SetErrorBarsVisible(True)
        errorBar.ValueType = ErrorBarValueType.StandardError
        errorBar.Type = FarPoint.Win.Chart.ErrorBarType.Both
    Next
End If

以下の画像は、上記のコードを使用した、出力結果を示しています。

制限事項

SPREADは、誤差範囲のインタラクティブなユーザーインターフェースのカスタマイズには対応していません。
現在、ErrorBarValueType.Custom 列挙型はカスタマイズには対応していません。

参照