MetricUtility

public class MetricUtility
extends Object

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

---

Contient des méthodes utilitaires courantes pour stocker les métriques de test, les agréger dans des tests similaires et les écrire dans un fichier.

Résumé

Classes imbriquées
class	MetricUtility.DimensionalIterationData Classe d'assistance permettant de contenir le fichier de métriques dimensionnelles et l'état d'une seule itération de test.

Constructeurs publics
MetricUtility()

Méthodes publiques
File	aggregateDimensionalMetricsAndWriteToFile(List<MetricUtility.DimensionalIterationData> iterationDataList, Set<Integer> percentiles, String testIterationSeparator) Lit tous les fichiers de rapports sur les métriques dimensionnelles stockés, agrège les valeurs brutes, calcule les statistiques et écrit un nouveau fichier de rapport agrégé.
Map<String, MetricMeasurement.Metric>	aggregateMetrics(Map<String, MetricMeasurement.Metric> rawMetrics) Métriques agrégées séparées par une virgule.
File	aggregateStoredTestMetricsAndWriteToFile(String fileName) Agrège les métriques collectées à partir de plusieurs itérations du test et écrit les métriques agrégées dans un fichier de résultats de test.
void	buildMetricFilterPatterns(Set<String> strictIncludeRegEx) Créez des modèles d'expression régulière pour filtrer les métriques.
Map<String, MetricMeasurement.Metric>	filterMetrics(Map<String, MetricMeasurement.Metric> parsedMetrics) Filtrez les métriques qui correspondent au modèle.
static Map<String, Double>	getStats(List<Double> values, Set<Integer> percentiles, int testIterations) Calculez les statistiques à partir de la liste de valeurs fournie.
Map<String, List<MetricUtility.IterationData>>	getTestIterations()
static boolean	isAllDoubleValues(List<String> rawValues) Vérifie si toutes les valeurs de la liste sont des valeurs doubles.
void	setIterationSeparator(String separator)
void	setMetricsUseForTestIterations(Set<String> metricsUseForTestIterations) Définit les expressions régulières pour les métriques qui doivent utiliser les itérations de test réussies pour le calcul de la moyenne lors de l'agrégation.
void	setPercentiles(Set<Integer> percentiles)
void	storeTestMetrics(TestDescription testDescription, Map<String, MetricMeasurement.Metric> testMetrics, boolean testFailed) Utilisé pour stocker les métriques de test individuelles et les agréger.
void	storeTestMetrics(TestDescription testDescription, Map<String, MetricMeasurement.Metric> testMetrics) Version surchargée de storeTestMetrics pour la rétrocompatibilité.
File	writeResultsToFile(String testFileSuffix, String testHeaderName, Map<String, String> metrics, File resultsFile) Écrire des métriques dans un fichier

Constructeurs publics

MetricUtility

public MetricUtility ()

Méthodes publiques

aggregateDimensionalMetricsAndWriteToFile

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

Lit tous les fichiers de rapports sur les métriques dimensionnelles stockés, agrège les valeurs brutes, calcule les statistiques et écrit un nouveau fichier de rapport agrégé.

Paramètres
iterationDataList	List
percentiles	Set : centiles à calculer.
testIterationSeparator	String : séparateur pour les itérations de test.

Renvoie
File	Un File contenant le rapport agrégé ou la valeur null si aucune agrégation n'a été effectuée.

aggregateMetrics

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

Métriques agrégées séparées par une virgule.

Paramètres
rawMetrics	Map : métriques collectées lors de l'exécution du test.

Renvoie
Map<String, MetricMeasurement.Metric>	métriques agrégées.

aggregateStoredTestMetricsAndWriteToFile

public File aggregateStoredTestMetricsAndWriteToFile (String fileName)

Agrège les métriques collectées à partir de plusieurs itérations du test et écrit les métriques agrégées dans un fichier de résultats de test.

Paramètres
fileName	String : nom de fichier à utiliser lors de l'écriture des métriques.

Renvoie
File

buildMetricFilterPatterns

public void buildMetricFilterPatterns (Set<String> strictIncludeRegEx)

Créez des modèles d'expression régulière pour filtrer les métriques.

Paramètres
strictIncludeRegEx	Set

filterMetrics

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

Filtrez les métriques qui correspondent au modèle.

Paramètres
parsedMetrics	Map

Renvoie
Map<String, MetricMeasurement.Metric>

getStats

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

Calculez les statistiques à partir de la liste de valeurs fournie.

Paramètres
values	List : valeurs brutes pour calculer l'agrégation.
percentiles	Set : statistiques à inclure dans les métriques finales.
testIterations	int : nombre d'itérations à utiliser comme diviseur pour la moyenne. Si la valeur est 0, la moyenne est calculée à l'aide de la taille de la liste "values".

Renvoie
Map<String, Double>	des valeurs agrégées.

getTestIterations

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

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

isAllDoubleValues

public static boolean isAllDoubleValues (List<String> rawValues)

Vérifie si toutes les valeurs de la liste sont des valeurs doubles.

Paramètres
rawValues	List : liste des valeurs à vérifier.

Renvoie
boolean	"true" si toutes les valeurs sont des valeurs doubles, "false" dans le cas contraire.

setIterationSeparator

public void setIterationSeparator (String separator)

Paramètres
separator	String

setMetricsUseForTestIterations

public void setMetricsUseForTestIterations (Set<String> metricsUseForTestIterations)

Définit les expressions régulières pour les métriques qui doivent utiliser les itérations de test réussies pour le calcul de la moyenne lors de l'agrégation.

Paramètres
metricsUseForTestIterations	Set : ensemble de chaînes d'expressions régulières.

setPercentiles

public void setPercentiles (Set<Integer> percentiles)

Paramètres
percentiles	Set

storeTestMetrics

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

Utilisé pour stocker les métriques de test individuelles et les agréger.

Paramètres
testDescription	TestDescription : contient les détails du test, comme le nom de la classe et le nom du test.
testMetrics	Map : métriques collectées pour le test.
testFailed	boolean : indique si le test a échoué.

storeTestMetrics

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

Version surchargée de storeTestMetrics pour la rétrocompatibilité. La valeur par défaut de testFailed est "false".

Paramètres
testDescription	TestDescription
testMetrics	Map

writeResultsToFile

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

Écrire des métriques dans un fichier

Paramètres
testFileSuffix	String : utilisé comme suffixe dans le nom du fichier de métriques de test.
testHeaderName	String : les métriques seront écrites sous le nom de l'en-tête de test.
metrics	Map : à écrire dans le fichier.
resultsFile	File : si la valeur est nulle, créez un fichier et écrivez les métriques. Sinon, ajoutez le nom de l'en-tête de test et la métrique au fichier.

Renvoie
File	avec la métrique.