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.