MetricUtility

public class MetricUtility
extends Object

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

Contiene métodos de utilidad comunes para almacenar las métricas de prueba, agregar las métricas en pruebas similares y escribir las métricas en un archivo.

Resumen

Clases anidadas

class MetricUtility.DimensionalIterationData

Clase auxiliar para contener el archivo de métricas dimensionales y el estado de una sola iteración de prueba. 

Constructores públicos

MetricUtility()

Métodos públicos

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

Lee todos los archivos de informes de métricas dimensionales almacenados, agrega los valores sin procesar, calcula las estadísticas y escribe un nuevo archivo de informe agregado.

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

Agrega métricas separadas por comas.

File aggregateStoredTestMetricsAndWriteToFile(String fileName)

Agrega las métricas recopiladas de varias iteraciones de la prueba y escribe las métricas agregadas en un archivo de resultados de la prueba.

void buildMetricFilterPatterns(Set<String> strictIncludeRegEx)

Crea patrones de expresiones regulares para filtrar las métricas.

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

Filtra las métricas que coinciden con el patrón.

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

Calcula las estadísticas a partir de la lista de valores proporcionada.

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

Comprueba si todos los valores de la lista son valores dobles.

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

Establece las expresiones regulares para las métricas que deben usar las iteraciones de prueba aprobadas para el cálculo de la media durante la agregación.

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

Se usa para almacenar las métricas de prueba individuales y agregarlas.

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

Es una versión sobrecargada de storeTestMetrics para la retrocompatibilidad.

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

Escribe métricas en un archivo.

Constructores públicos

MetricUtility

public MetricUtility ()

Métodos públicos

aggregateDimensionalMetricsAndWriteToFile

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

Lee todos los archivos de informes de métricas dimensionales almacenados, agrega los valores sin procesar, calcula las estadísticas y escribe un nuevo archivo de informe agregado.

Parámetros
iterationDataList List

percentiles Set: Son los percentiles que se calcularán.
testIterationSeparator String: Es el separador de las iteraciones de prueba.
Muestra
File Un objeto File que contiene el informe agregado o un valor nulo si no se realizó ninguna agregación.

aggregateMetrics

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

Agrega métricas separadas por comas.

Parámetros
rawMetrics Map: Son las métricas recopiladas durante la ejecución de la prueba.
Muestra
Map<String, MetricMeasurement.Metric> métricas agregadas.

aggregateStoredTestMetricsAndWriteToFile

public File aggregateStoredTestMetricsAndWriteToFile (String fileName)

Agrega las métricas recopiladas de varias iteraciones de la prueba y escribe las métricas agregadas en un archivo de resultados de la prueba.

Parámetros
fileName String: Es el nombre de archivo que se usará al escribir las métricas.
Muestra
File

buildMetricFilterPatterns

public void buildMetricFilterPatterns (Set<String> strictIncludeRegEx)

Crea patrones de expresiones regulares para filtrar las métricas.

Parámetros
strictIncludeRegEx Set

filterMetrics

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

Filtra las métricas que coinciden con el patrón.

Parámetros
parsedMetrics Map

Muestra
Map<String, MetricMeasurement.Metric>

getStats

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

Calcula las estadísticas a partir de la lista de valores proporcionada.

Parámetros
values List: Son los valores sin procesar para calcular la agregación.
percentiles Set: Son las estadísticas que se incluirán en las métricas finales.
testIterations int: Es la cantidad de iteraciones que se usarán como divisor para la media. Si es 0, la media se calcula con el tamaño de la lista "values".
Muestra
Map<String, Double> valores agregados.

getTestIterations

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

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

isAllDoubleValues

public static boolean isAllDoubleValues (List<String> rawValues)

Comprueba si todos los valores de la lista son valores dobles.

Parámetros
rawValues List: Es una lista de valores para verificar.
Muestra
boolean Es verdadero si todos los valores son valores dobles; de lo contrario, es falso.

setIterationSeparator

public void setIterationSeparator (String separator)

Parámetros
separator String

setMetricsUseForTestIterations

public void setMetricsUseForTestIterations (Set<String> metricsUseForTestIterations)

Establece las expresiones regulares para las métricas que deben usar las iteraciones de prueba aprobadas para el cálculo de la media durante la agregación.

Parámetros
metricsUseForTestIterations Set: Es un conjunto de cadenas de expresión regular.

setPercentiles

public void setPercentiles (Set<Integer> percentiles)

Parámetros
percentiles Set

storeTestMetrics

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

Se usa para almacenar las métricas de prueba individuales y agregarlas.

Parámetros
testDescription TestDescription: Contiene los detalles de la prueba, como el nombre de la clase y el nombre de la prueba.
testMetrics Map: Son las métricas recopiladas para la prueba.
testFailed boolean: Indica si la prueba falló.

storeTestMetrics

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

Es una versión sobrecargada de storeTestMetrics para la retrocompatibilidad. El valor predeterminado de testFailed es falso.

Parámetros
testDescription TestDescription

testMetrics Map

writeResultsToFile

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

Escribe métricas en un archivo.

Parámetros
testFileSuffix String: Se usa como sufijo en el nombre del archivo de la métrica de prueba.
testHeaderName String: Las métricas se escribirán bajo el nombre del encabezado de la prueba.
metrics Map: Para escribir en el archivo.
resultsFile File: Si es nulo, crea un archivo nuevo y escribe las métricas. De lo contrario, agrega el nombre del encabezado de la prueba y la métrica al archivo.
Muestra
File archivo con la métrica.