MetricUtility

public class MetricUtility
extends Object

java.lang.Object
   ↳ com.android.tradefed.util.MetricUtility

テスト指標の保存、類似テストでの指標の集計、指標のファイルへの書き込みを行うための一般的なユーティリティ メソッドが含まれています。

概要

ネストされたクラス

class MetricUtility.DimensionalIterationData

単一のテスト イテレーションのディメンション指標ファイルとステータスを保持するヘルパークラス。 

パブリック コンストラクタ

MetricUtility()

パブリック メソッド

File aggregateDimensionalMetricsAndWriteToFile(List<MetricUtility.DimensionalIterationData> iterationDataList, Set<Integer> percentiles, String testIterationSeparator)

保存されているすべてのディメンション指標レポート ファイルを読み取り、未加工の値を集計して統計情報を計算し、新しい集計レポート ファイルを書き込みます。
Map<String, MetricMeasurement.Metric> aggregateMetrics(Map<String, MetricMeasurement.Metric> rawMetrics)

カンマ区切りの指標を集計します。
File aggregateStoredTestMetricsAndWriteToFile(String fileName)

テストの複数のイテレーションから収集された指標を集計し、集計された指標をテスト結果ファイルに書き込みます。
void buildMetricFilterPatterns(Set<String> strictIncludeRegEx)

正規表現パターンを作成して指標をフィルタします。
Map<String, MetricMeasurement.Metric> filterMetrics(Map<String, MetricMeasurement.Metric> parsedMetrics)

パターンに一致する指標をフィルタします。
static Map<String, Double> getStats(List<Double> values, Set<Integer> percentiles, int testIterations)

指定された値のリストから統計情報を計算します。
Map<String, List<MetricUtility.IterationData>> getTestIterations()
static boolean isAllDoubleValues(List<String> rawValues)

リスト内のすべての値が倍精度浮動小数点値かどうかを確認します。
void setIterationSeparator(String separator)
void setMetricsUseForTestIterations(Set<String> metricsUseForTestIterations)

集計中に合格したテスト イテレーションを平均計算に使用する指標の正規表現を設定します。
void setPercentiles(Set<Integer> percentiles)
void storeTestMetrics(TestDescription testDescription, Map<String, MetricMeasurement.Metric> testMetrics, boolean testFailed)

個々のテスト指標を保存し、集計に使用するために使用されます。
void storeTestMetrics(TestDescription testDescription, Map<String, MetricMeasurement.Metric> testMetrics)

下位互換性のための storeTestMetrics のオーバーロード バージョン。
File writeResultsToFile(String testFileSuffix, String testHeaderName, Map<String, String> metrics, File resultsFile)

指標をファイルに書き込みます。

パブリック コンストラクタ

MetricUtility

public MetricUtility ()

パブリック メソッド

aggregateDimensionalMetricsAndWriteToFile

public File aggregateDimensionalMetricsAndWriteToFile (List<MetricUtility.DimensionalIterationData> iterationDataList, 
                Set<Integer> percentiles, 
                String testIterationSeparator)

保存されているすべてのディメンション指標レポート ファイルを読み取り、未加工の値を集計して統計情報を計算し、新しい集計レポート ファイルを書き込みます。

パラメータ
iterationDataList List

percentiles Set: 計算するパーセンタイル。
testIterationSeparator String: テスト イテレーションの区切り文字。
戻り値
File 集計レポートを含む File。集計が実行されなかった場合は null。

aggregateMetrics

public Map<String, MetricMeasurement.Metric> aggregateMetrics (Map<String, MetricMeasurement.Metric> rawMetrics)

カンマ区切りの指標を集計します。

パラメータ
rawMetrics Map: テスト実行中に収集された指標。
戻り値
Map<String, MetricMeasurement.Metric> 集計された指標。

aggregateStoredTestMetricsAndWriteToFile

public File aggregateStoredTestMetricsAndWriteToFile (String fileName)

テストの複数のイテレーションから収集された指標を集計し、集計された指標をテスト結果ファイルに書き込みます。

パラメータ
fileName String: 指標の書き込み時に使用するファイル名。
戻り値
File

buildMetricFilterPatterns

public void buildMetricFilterPatterns (Set<String> strictIncludeRegEx)

正規表現パターンを作成して指標をフィルタします。

パラメータ
strictIncludeRegEx Set

filterMetrics

public Map<String, MetricMeasurement.Metric> filterMetrics (Map<String, MetricMeasurement.Metric> parsedMetrics)

パターンに一致する指標をフィルタします。

パラメータ
parsedMetrics Map

戻り値
Map<String, MetricMeasurement.Metric>

getStats

public static Map<String, Double> getStats (List<Double> values, 
                Set<Integer> percentiles, 
                int testIterations)

指定された値のリストから統計情報を計算します。

パラメータ
values List: 集計を計算する未加工の値。
percentiles Set: 最終的な指標に含める統計情報。
testIterations int: 平均の除数として使用する反復回数。0 の場合、平均は「値」リストのサイズを使用して計算されます。
戻り値
Map<String, Double> 集計値。

getTestIterations

public Map<String, List<MetricUtility.IterationData>> getTestIterations ()

戻り値
Map<String, List<MetricUtility.IterationData>>

isAllDoubleValues

public static boolean isAllDoubleValues (List<String> rawValues)

リスト内のすべての値が倍精度浮動小数点値かどうかを確認します。

パラメータ
rawValues List: チェックする値のリスト。
戻り値
boolean すべての値が double 値の場合は true、それ以外の場合は false。

setIterationSeparator

public void setIterationSeparator (String separator)

パラメータ
separator String

setMetricsUseForTestIterations

public void setMetricsUseForTestIterations (Set<String> metricsUseForTestIterations)

集計時に合格したテスト イテレーションを平均計算に使用する指標の正規表現を設定します。

パラメータ
metricsUseForTestIterations Set: 正規表現文字列のセット。

setPercentiles

public void setPercentiles (Set<Integer> percentiles)

パラメータ
percentiles Set

storeTestMetrics

public void storeTestMetrics (TestDescription testDescription, 
                Map<String, MetricMeasurement.Metric> testMetrics, 
                boolean testFailed)

個々のテスト指標を保存し、集計に使用します。

パラメータ
testDescription TestDescription: クラス名やテスト名などのテストの詳細が含まれます。
testMetrics Map: テスト用に収集された指標。
testFailed boolean: テストが失敗したかどうか。

storeTestMetrics

public void storeTestMetrics (TestDescription testDescription, 
                Map<String, MetricMeasurement.Metric> testMetrics)

下位互換性のための storeTestMetrics のオーバーロード バージョン。デフォルトでは testFailed は false に設定されます。

パラメータ
testDescription TestDescription

testMetrics Map

writeResultsToFile

public File writeResultsToFile (String testFileSuffix, 
                String testHeaderName, 
                Map<String, String> metrics, 
                File resultsFile)

指標をファイルに書き込みます。

パラメータ
testFileSuffix String: テスト指標ファイル名の接尾辞として使用されます。
testHeaderName String: 指標はテスト ヘッダー名の下に書き込まれます。
metrics Map: ファイルに書き込みます。
resultsFile File: null の場合は新しいファイルを作成して指標を書き込み、それ以外の場合はテスト ヘッダー名と指標をファイルに追加します。
戻り値
File ファイルに保存します。