MetricUtility

public class MetricUtility
extends Object

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

Contiene metodi di utilità comuni per archiviare le metriche di test, aggregare le metriche in test simili e scriverle in un file.

Riepilogo

Classi nidificate

class MetricUtility.DimensionalIterationData

Classe helper per contenere il file e lo stato della metrica dimensionale per una singola iterazione del test. 

Costruttori pubblici

MetricUtility()

Metodi pubblici

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

Legge tutti i file dei report sulle metriche dimensionali archiviati, aggrega i valori non elaborati, calcola le statistiche e scrive un nuovo file di report aggregato.

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

Metriche aggregate separate da virgole.

File aggregateStoredTestMetricsAndWriteToFile(String fileName)

Aggrega le metriche raccolte da più iterazioni del test e scrivile in un file di risultati del test.

void buildMetricFilterPatterns(Set<String> strictIncludeRegEx)

Crea pattern di espressioni regolari per filtrare le metriche.

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

Filtra le metriche che corrispondono al pattern.

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

Calcola le statistiche dall'elenco di valori fornito.

Map<String, List<MetricUtility.IterationData>> getTestIterations()
static boolean isAllDoubleValues(List<String> rawValues)

Controlla se tutti i valori nell'elenco sono valori doppi.

void setIterationSeparator(String separator)
void setMetricsUseForTestIterations(Set<String> metricsUseForTestIterations)

Imposta le espressioni regolari per le metriche che devono utilizzare le iterazioni di test superate per il calcolo della media durante l'aggregazione.

void setPercentiles(Set<Integer> percentiles)
void storeTestMetrics(TestDescription testDescription, Map<String, MetricMeasurement.Metric> testMetrics, boolean testFailed)

Utilizzata per memorizzare le singole metriche di test e per l'aggregazione.

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

Versione sovraccarica di storeTestMetrics per la compatibilità con le versioni precedenti.

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

Scrivere le metriche in un file.

Costruttori pubblici

MetricUtility

public MetricUtility ()

Metodi pubblici

aggregateDimensionalMetricsAndWriteToFile

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

Legge tutti i file dei report sulle metriche dimensionali archiviati, aggrega i valori non elaborati, calcola le statistiche e scrive un nuovo file di report aggregato.

Parametri
iterationDataList List

percentiles Set: i percentili da calcolare.
testIterationSeparator String: il separatore per le iterazioni di test.
Resi
File Un File contenente il report aggregato o null se non è stata eseguita alcuna aggregazione.

aggregateMetrics

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

Metriche aggregate separate da virgole.

Parametri
rawMetrics Map: metriche raccolte durante l'esecuzione del test.
Resi
Map<String, MetricMeasurement.Metric> metriche aggregate.

aggregateStoredTestMetricsAndWriteToFile

public File aggregateStoredTestMetricsAndWriteToFile (String fileName)

Aggrega le metriche raccolte da più iterazioni del test e scrivile in un file di risultati del test.

Parametri
fileName String: il nome del file da utilizzare durante la scrittura delle metriche.
Resi
File

buildMetricFilterPatterns

public void buildMetricFilterPatterns (Set<String> strictIncludeRegEx)

Crea pattern di espressioni regolari per filtrare le metriche.

Parametri
strictIncludeRegEx Set

filterMetrics

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

Filtra le metriche che corrispondono al pattern.

Parametri
parsedMetrics Map

Resi
Map<String, MetricMeasurement.Metric>

getStats

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

Calcola le statistiche dall'elenco di valori fornito.

Parametri
values List: valori non elaborati per calcolare l'aggregazione.
percentiles Set: le statistiche da includere nelle metriche finali.
testIterations int: il numero di iterazioni da utilizzare come divisore per la media. Se è 0, la media viene calcolata utilizzando la dimensione dell'elenco "values".
Resi
Map<String, Double> valori aggregati.

getTestIterations

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

Resi
Map<String, List<MetricUtility.IterationData>>

isAllDoubleValues

public static boolean isAllDoubleValues (List<String> rawValues)

Controlla se tutti i valori nell'elenco sono valori doppi.

Parametri
rawValues List: elenco di valori da controllare.
Resi
boolean true se tutti i valori sono valori doppi, false in caso contrario.

setIterationSeparator

public void setIterationSeparator (String separator)

Parametri
separator String

setMetricsUseForTestIterations

public void setMetricsUseForTestIterations (Set<String> metricsUseForTestIterations)

Imposta le espressioni regolari per le metriche che devono utilizzare le iterazioni di test superate per il calcolo della media durante l'aggregazione.

Parametri
metricsUseForTestIterations Set: un insieme di stringhe di espressioni regolari.

setPercentiles

public void setPercentiles (Set<Integer> percentiles)

Parametri
percentiles Set

storeTestMetrics

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

Utilizzata per memorizzare le singole metriche di test e per l'aggregazione.

Parametri
testDescription TestDescription: contiene i dettagli del test, come il nome della classe e il nome del test.
testMetrics Map: le metriche raccolte per il test.
testFailed boolean: indica se il test non è riuscito.

storeTestMetrics

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

Versione sovraccarica di storeTestMetrics per la compatibilità con le versioni precedenti. Il valore predefinito di testFailed è false.

Parametri
testDescription TestDescription

testMetrics Map

writeResultsToFile

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

Scrivere le metriche in un file.

Parametri
testFileSuffix String: viene utilizzato come suffisso nel nome del file della metrica di test.
testHeaderName String: le metriche verranno scritte sotto il nome dell'intestazione del test.
metrics Map: per scrivere nel file.
resultsFile File: se è nullo, crea un nuovo file e scrivi le metriche, altrimenti aggiungi il nome dell'intestazione del test e la metrica al file.
Resi
File con la metrica.