Esta página se ha traducido mediante traducción automática. Haga clic aquí para ver la última versión en inglés.

metric.Engine

Recopilar resultados de métricass

Descripción

Un objeto metric.Engine representa el motor de métricas que se puede ejecutar con la función de objeto execute para recopilar resultados de métricas. Utilice getMetrics para acceder a los resultados de la métrica y devolver un arreglo de objetos metric.Result. Utilice los resultados de métricass para evaluar el estado y la calidad de su diseño. Utilice las métricas de mantenibilidad del modelo para analizar la mantenibilidad y la complejidad del diseño. Utilice las métricas de pruebas de modelo y código para analizar artefactos como requisitos, resultados de pruebas y resultados de cobertura. Para métricas adicionales, consulte Design Cost Model Metrics (Fixed-Point Designer).

Creación

Sintaxis

metric_engine = metric.Engine()

metric_engine = metric.Engine(projectPath)

Descripción

metric_engine = metric.Engine() crea un objeto de motor de métricas que recopila resultados de métricas en el proyecto actual.

metric_engine = metric.Engine(projectPath) abre el proyecto projectPath y crea un objeto de motor de métricas que recopila resultados de métricas en el proyecto.

Argumentos de entrada

projectPath — Ruta del proyecto

vector de caracteres | escalar de cadena

Ruta del proyecto para el que desea recopilar resultados de métricass, especificados como un vector de caracteres o un escalar de cadena.

Propiedades

ProjectPath — Proyecto de recolección de métricas

Solo lectura: escalar de cadena

Esta propiedad o parámetro es de solo lectura.

Proyecto para el cual el motor recopila resultados de métricass, devueltos como una cadena.

Funciones del objeto

execute	Collect metric results
generateReport	Generate report file containing metric results
getArtifactErrors	Return errors that occurred during artifact tracing
getArtifactIssues	Return issues that occur during artifact analysis
getAvailableMetricIds	Return metric identifiers for available metrics
getMetrics	Access metric results
openArtifact	Open traced artifact from metric result
updateArtifacts	Update trace information for pending artifact changes in the project

Ejemplos

Recopilar resultados de métricass sobre artefactos de diseño en un proyecto

Utilice un objeto metric.Engine para recopilar resultados de métricass sobre los artefactos de diseño en un proyecto.

Abra un proyecto que contenga modelos que desee analizar. Para este ejemplo, en la ventana de comandos de MATLAB^®, ingrese:

openExample("slcheck/ExploreTestingMetricDataInModelTestingDashboardExample");
openProject("cc_CruiseControl");

Crea un objeto metric.Engine. Puede utilizar el objeto metric.Engine para recopilar los resultados de las métricas del proyecto actual.

metric_engine = metric.Engine();

Recopile resultados para la métrica slcomp.OverallCyclomaticComplexity ejecutando el motor de métricas. Para obtener más información sobre la métrica, consulte Model Maintainability Metrics.

execute(metric_engine,'slcomp.OverallCyclomaticComplexity');

Utilice la función getMetrics para acceder a los resultados. Asigna el arreglo de objetos de resultado a la variable results.

results = getMetrics(metric_engine,'slcomp.OverallCyclomaticComplexity');

Acceda a los datos de resultados de métricass utilizando las propiedades de los objetos metric.Result en el arreglo results.

for n = 1:length(results)
    disp(['Model: ',results(n).Scope.Name])
    disp(['  Overall Design Cyclomatic Complexity: ',num2str(results(n).Value)])
end

Model: cc_DriverSwRequest
  Overall Design Cyclomatic Complexity: 9
Model: cc_ThrottleController
  Overall Design Cyclomatic Complexity: 4
Model: cc_ControlMode
  Overall Design Cyclomatic Complexity: 22
Model: cc_CruiseControl
  Overall Design Cyclomatic Complexity: 1
Model: cc_LightControl
  Overall Design Cyclomatic Complexity: 4

Para obtener más información sobre cómo recopilar métricas para artefactos de diseño, consulte Collect Model Maintainability Metrics Programmatically.

Recopilar resultados de métricas sobre artefactos de prueba en un proyecto

Utilice un objeto metric.Engine para recopilar resultados de métricas sobre los artefactos de pruebas basadas en requisitos en un proyecto.

Abra un proyecto que contenga modelos y artefactos de prueba. Para este ejemplo, en la ventana de comandos de MATLAB, ingrese:

openExample("slcheck/ExploreTestingMetricDataInModelTestingDashboardExample");
openProject("cc_CruiseControl");

Crea un objeto metric.Engine. Puede utilizar el objeto metric.Engine para recopilar resultados de métricass para el proyecto actual.

metric_engine = metric.Engine();

Actualice la información de seguimiento de metric_engine para garantizar que la información del artefacto esté actualizada.

updateArtifacts(metric_engine)

Recopile resultados para la métrica 'RequirementsPerTestCase' utilizando la función execute en el objeto metric.Engine.

execute(metric_engine,'RequirementsPerTestCase');

Utilice la función getMetrics para acceder a los resultados. Asigna el arreglo de objetos de resultado a la variable results.

results = getMetrics(metric_engine,'RequirementsPerTestCase');

Acceda a los datos de resultados de métricass utilizando las propiedades de los objetos metric.Result en el arreglo.

for n = 1:length(results)
    disp(['Test Case: ',results(n).Artifacts(1).Name])
    disp(['  Number of Requirements: ',num2str(results(n).Value)])
end

Historial de versiones

Introducido en R2020b

Consulte también

metric.Result

Temas

• Collect Model Maintainability Metrics Programmatically
• Collect Metrics on Model Testing Artifacts Programmatically
• Collect Code Testing Metrics Programmatically