SysML v2
Metadatos de simulación en proyectos SysML v2
La biblioteca de metadatos HolarchSimulation: cómo un modelo SysML v2 contiene duraciones, probabilidades de rama, número de iteraciones de bucles, recursos, costes y ajustes de máquinas de estados para el Simulador, y cómo escribirlos y moverlos.
Resumen
En un proyecto SysML v2, los ajustes del Simulador forman parte del modelo. Son anotaciones de metadatos del paquete de biblioteca HolarchSimulation, que todo proyecto SysML v2 carga. Un modelo que las usa sigue siendo SysML v2 válido: otras herramientas leen las anotaciones como metadatos corrientes, y solo el Simulador les da significado.
Una anotación se sitúa dentro del elemento que anota o nombra ese elemento con about:
succession toCruise first shift if speed > 30 then cruise {
@HolarchSimulation::Probability { percent = 70; }
}
metadata HolarchSimulation::Cost about DriveCycle::drive { amount = 0.4; unit = "USD"; label = "Energy"; }
Conceptos
Valor nominal y distribución
La duración de un paso es su atributo duration (o un atributo tipado DurationValue o TimeValue). Su valor es la duración nominal que ven otras herramientas y la evaluación de Holarch. Una anotación de distribución en ese atributo hace que el Simulador extraiga la duración en su lugar:
action cruise {
attribute duration : ISQ::DurationValue = 1 [min] {
@HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
}
}
Qué ajustes prevalecen
- Una anotación de distribución prevalece sobre el propio valor del atributo.
- Una guarda, una condición
ifo una condición de bucle que el modelo puede evaluar decide por sí sola. Una Probability o un LoopCount solo se usa cuando no puede (un LoopCount siempre cuenta las pasadas). - Los ajustes hechos antes de que los ajustes de simulación pasaran al modelo se conservan como datos de Holarch junto al modelo. Siguen prevaleciendo, de modo que las ejecuciones dan los mismos resultados, hasta que los traslade (consulte Mover los ajustes antiguos al modelo).
Dos simuladores
La página Simulador muestra qué simulador ejecuta el modelo, a la derecha de los ajustes: Motor SysML (el simulador del Holarch Language Engine) o Simulador de JavaScript. Ambos leen las mismas anotaciones. Las máquinas de estados, los estímulos, los recursos de Resource, Consumes, Produces y Seizes, los costes de Cost y las demás anotaciones de Anotaciones que necesitan el motor SysML solo se ejecutan con el motor SysML.
Cómo usarlo
Cuándo y por qué
Escriba los ajustes de simulación en el modelo cuando el modelo sea el registro del diseño: los números viajan con los archivos .sysml, aparecen en las revisiones del texto y se versionan con el resto del modelo. Úselos mientras analiza un escenario operativo (líneas de tiempo, reparto de ramas, uso de recursos) y antes de comprobar un requisito frente a un estudio de Monte Carlo.
Establecer una duración, una probabilidad o un recuento de bucle
- Seleccione el paso, la sucesión, la decisión, el bucle o la acción
ifen una vista de flujo de acciones, en el Navegador o en el Editor. - En la sección Simulación del inspector, establezca Duración (un valor fijo o una distribución), Probabilidad (%), Iteraciones o Probabilidad de then (%).
- Holarch escribe la anotación en el modelo: Duración establece el valor del atributo en la media y añade la anotación de distribución (o escribe
attribute duration : ISQ::DurationValuecuando el paso no tiene ninguno); Probabilidad (%) escribe Probability; Iteraciones escribe LoopCount. Cada cambio se puede deshacer con un solo Deshacer y aparece en el texto de inmediato. - Vacíe un campo para quitar su anotación.
Holarch comprueba cada cambio con el comprobador de SysML antes de escribirlo. Un cambio que añadiría un error no se escribe, y un mensaje nombra el problema.
Escribir anotaciones en el texto
- Abra el Editor.
- Añada la anotación dentro del cuerpo del elemento, como
@HolarchSimulation::Kind { field = value; }, o detrás de él, comometadata HolarchSimulation::Kind about element { … }. - Para Consumes, Produces y Seizes, nombre primero el paso y después el recurso:
metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }.
Mover los ajustes antiguos al modelo
Los proyectos cuyos ajustes de simulación se hicieron antes de que pasaran al modelo muestran Algunos ajustes de simulación de este proyecto son datos de Holarch, no forman parte del modelo. encima de los ajustes del Simulador.
- Haga clic en Mover los ajustes de simulación al modelo….
- La vista previa enumera cada ajuste y la anotación que lo sustituye.
- Haga clic en Mover al modelo. Todos los ajustes se trasladan, y un solo Deshacer lo revierte todo; las ejecuciones dan los mismos resultados.
Simular una máquina de estados
Las máquinas de estados se ejecutan con el motor SysML.
- Abra Comportamiento → Simulador y elija como Raíz una definición de estado o una parte que exhibe estados.
- Opcional: en Ejecutar junto con, elija una acción de escenario que envíe señales a la parte, como TestDrive de la demostración.
- En Estímulos, haga clic en + Añadir estímulo y establezca En (tiempo y unidad), Señal y Hacia (una máquina, o Todas las máquinas que la aceptan).
- Pulse ▶ Reproducir, ⏭ Paso o ⏩ Ejecutar hasta el final. Máquina de estados durante la ejecución ilumina los estados activos y marca la transición que se disparó; la pestaña Estados muestra Estados a lo largo del tiempo y Transiciones disparadas.
- En Monte Carlo, la pestaña Estados muestra Tiempo en el estado y Recuento de transiciones. Comprobar frente a requisito… ofrece como salidas el tiempo en el estado de cada estado y su proporción de la ejecución.
En una vista de transición de estados, ▶ Simular abre una barra con ▶ Reproducir, ⏭ Paso, ⏩ Ejecutar hasta el final, Restablecer y Abrir en el Simulador. La ejecución usa los estímulos guardados en el Simulador para esa definición de estado.
Ejemplo práctico: la demostración Hybrid Car
La demostración Hybrid Car (Gestionar proyectos → Archivos de proyecto ▾ → Nuevo proyecto de demostración) usa la biblioteca:
- DriveCycle: la sucesión
toCruisetrasshifttiene Probability 70; la ramaelsetoma el 30 % restante.cruisedura 1 min nominal, extraído de una distribución Triangular (45 s, 1 min, 2 min). - DrivenCar: la batería del tren motriz es un Resource de 62 Wh;
driveConsumes 1,5 Wh de ella y tiene un Cost de 0,4 USD por uso. - PowertrainStates: la transición
startElectrictiene Probability 80 para su guarda;accept when charge < 15cambia a híbrido cuando baja la carga;accept after 30 [min]termina la carga. - TestDrive: un escenario que envía
StartRequest, espera una hora y después envíaStopRequestyPlugInademoCar. Ejecute Demo Car junto con Test Drive para ver cómo el tren motriz cambia de estado.
La demostración se comprueba con 0 diagnósticos.
Consejos y buenas prácticas
- Mantenga el valor nominal con sentido: establézcalo en el valor esperado de la distribución, como hace el inspector.
- Ponga nombre a las sucesiones que anota (
succession toCruise first …), para que la anotación sea fácil de encontrar en el texto. - Prefiera las condiciones que el modelo puede evaluar a las probabilidades; use Probability para lo que el modelo no describe.
Errores habituales
- Una probabilidad no tiene efecto: la guarda se puede evaluar, así que decide ella. El inspector indica «Se evalúa como true: siempre se toma.» o «Se evalúa como false: nunca se toma.»
- Las probabilidades de las ramas no suman 100 %: las ramas sin Probability se reparten lo que queda; cuando las indicadas superan el 100 %, la advertencia dice «Las probabilidades de las ramas suman N %. Cámbielas para que sumen 100 %.»
- Una anotación de duración en el propio paso: las distribuciones van en el atributo de duración, no en la acción.
Cómo se relaciona
- Evaluación, unidades y análisis en proyectos SysML v2: cómo lee el Simulador los pasos, las sucesiones y las duraciones.
- Simulación: la página Simulador, sus paneles y las estadísticas de Monte Carlo.
- Notación textual de SysML v2: los metadatos y
abouten el texto.
Anotaciones
Distribuciones
Ponga una distribución en un atributo de duración. Los campos de ubicación y de escala admiten una magnitud con unidad (45 [s], 2 [min]); los campos de forma admiten un número.
| Anotación | Campos | Significado |
|---|---|---|
| Normal | mean, sd | Distribución normal. |
| Triangular | low, mode, high | Triangular, con low ≤ mode ≤ high. |
| Uniforme | low, high | Uniforme entre low y high. |
| Exponential | mean | Exponencial con la media indicada. |
| Gamma | shape, scale | Gamma; la media es shape × scale. |
| LogNormal | median, sigma | El logaritmo sigue una normal en torno al logaritmo de la mediana. |
| Weibull | scale, shape | Weibull. |
| Beta | alpha, beta, scale | Beta en 0..1, multiplicada por scale. |
| Poisson | mean, scale | Un recuento con la media indicada, multiplicado por scale. |
| Binomial | trials, p, scale | Éxitos en un número de ensayos, multiplicados por scale. |
Las duraciones extraídas por debajo de cero se vuelven a extraer.
Entradas correlacionadas
Sin correlación, cada valor extraído de una distribución es independiente de los demás. Correlation hace que dos de ellos varíen juntos:
metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
| Anotación | Sobre | Significado |
|---|---|---|
Correlation coefficient | about a, b: dos atributos, cada uno con una distribución | La correlación de rangos (Spearman) de sus valores, de -1 a 1. 0 es independiente, 1 los ordena siempre igual y -1 al revés. |
- Cada atributo conserva su propia distribución. El simulador une todos los pares en una matriz de correlación (una cópula gaussiana): el n-ésimo valor extraído para un atributo en una ejecución va con el n-ésimo valor de cada atributo con el que está correlacionado.
- Los coeficientes de un grupo de atributos correlacionados deben ser compatibles: a fuertemente con b, b fuertemente con c, pero a opuesto a c es imposible. La comprobación informa de un grupo así; debilite uno de los coeficientes.
- Las duraciones y las cantidades (Consumes, Produces, Seizes) se correlacionan de la misma manera. Una ejecución con la misma semilla da los mismos valores.
- En el Simulador, en el modo Monte Carlo con el motor SysML, Entradas correlacionadas enumera los pares de la raíz. Elija dos atributos y un coeficiente y haga clic en + Añadir correlación, cambie un coeficiente o haga clic en × para quitar uno; un solo Deshacer revierte cada cambio. Tras un estudio, Alcanzado muestra la correlación de rangos de los valores que extrajeron las ejecuciones.
ChargeStopde la demostración Hybrid Car correlaciona la espera de un cargador libre con el tiempo de carga (0,6).
Probabilidades y recuentos
| Anotación | Sobre | Significado |
|---|---|---|
Probability percent | Una sucesión que sale de una decisión | El peso de la rama. Las ramas sin peso se reparten lo que queda de 100. |
Una acción if | La probabilidad de la rama then cuando la condición no se puede evaluar. | |
| Una acción de bucle | La probabilidad de repetir tras cada pasada. | |
| Una transición | La probabilidad de que su guarda se cumpla cuando la guarda no se puede evaluar. | |
LoopCount count | Una acción de bucle | El número de pasadas; tiene prioridad sobre las condiciones del bucle. |
| LoopExit | Una sucesión a done en el cuerpo de un bucle | Termina todo el bucle, no solo la pasada. |
Recursos y costes
| Anotación | Sobre | Significado |
|---|---|---|
Resource initial, minimum, maximum, unit | Un uso de parte o de ítem | Una reserva de una cantidad. Si el uso declara attribute level : Real, el simulador lo mantiene igual a la cantidad, para que las guardas puedan leerlo. |
Consumes amount | about step, pool | Se toma cuando empieza el paso. |
Produces amount | about step, pool | Se añade cuando termina el paso. |
Seizes amount | about step, pool | Se toma cuando empieza el paso y se devuelve cuando termina. |
Utilization amount | Un uso de acción perform | Cuánto de la parte que lo realiza ocupa el paso. |
Cost amount, rate, unit, label | Un paso o una parte que lo realiza | Un coste por uso (CostRate::perUse) o por hora (CostRate::perHour). |
Anotaciones que necesitan el motor SysML
| Anotación | Significado |
|---|---|
Transfer latency, capacity, per | En una conexión o una interfaz: retrasa los ítems y las señales que se envían por ella. |
Size size | En un ítem: su tamaño para los retrasos de transferencia. |
Timeout limit | En una unión: detiene las ramas sin terminar cuando vence el límite. |
NotBefore time | En un paso: no empieza antes de este tiempo de ejecución. |
| ForkTargets, JoinSources | En una transición que entra en un estado paralelo o sale de él: los subestados en los que se entra, o los subestados que deben estar activos. |
History deep | En un estado compuesto: al volver a entrar se reanuda el subestado que estaba activo al salir. |
HostHook key, points | Reservado para Holarch: la ejecución se pausa para recibir datos en los puntos indicados. |
El simulador de JavaScript lee Probability, LoopCount y las distribuciones.
Mensajes
| Mensaje | Significado |
|---|---|
| Algunos ajustes de simulación de este proyecto son datos de Holarch, no forman parte del modelo. | Todavía hay ajustes antiguos guardados junto al modelo. Haga clic en Mover los ajustes de simulación al modelo…. |
| Datos de Holarch de antes de que los ajustes de simulación pasaran al modelo; prevalecen sobre el modelo. | Se muestran en la sección Simulación del inspector. Cambie el campo para escribirlo en el modelo, o traslade todos los ajustes en el Simulador. |
| No hay duración en el modelo. Establezca una aquí (escribe attribute duration : ISQ::DurationValue) o escríbala en el texto. | El paso no tiene atributo de duración. |
| @Normal: sd debe ser mayor que cero. Cambie sd. (y mensajes similares para otras distribuciones y parámetros) | Falta un parámetro de distribución o está fuera de rango. Con el motor SysML, la comprobación del modelo lo indica en el Editor y el Simulador se niega a ejecutar hasta que se corrija. |
| @Normal: sd tiene otra dimensión de unidad que … | Un parámetro de ubicación o de escala tiene otras unidades que el atributo, por ejemplo metros en una duración. |
| @LoopCount no se aplica a una parte … | La anotación está en un tipo de elemento al que no se aplica. Muévala o elimínela. |
| metadata Consumes … about necesita una acción y una parte o un ítem anotados con @Resource. | Los elementos tras about no son correctos en número o en tipo. |
| Una probabilidad de N % está fuera del rango de 0 a 100. | Introduzca un porcentaje de 0 a 100. |
| Las probabilidades de las ramas de esta decisión suman N %; el simulador las escala a 100 %. | Una advertencia: cada rama tiene un peso y no suman 100. |
| A correlation needs two different attributes … (Una correlación necesita dos atributos distintos …), … no es un atributo … o … no tiene distribución, por lo que no se extrae nada que correlacionar … | Una Correlation nombra dos veces el mismo atributo, algo que no es un atributo o un atributo sin distribución. |
| El coeficiente N está fuera del rango de -1 a 1. o The correlation has no coefficient. (La correlación no tiene coeficiente) | Introduzca un coeficiente de -1 a 1. |
| “a” y “b” ya están correlacionados; se usa la primera correlación. … | Una advertencia: se ignora una segunda Correlation del mismo par. Quite una de las dos. |
| Las correlaciones de … se contradicen: ninguna distribución conjunta las tiene … | Los coeficientes de un grupo no pueden darse a la vez (la matriz no es semidefinida positiva). Debilite uno. El Simulador se niega a ejecutar hasta que se corrija. |
| Bloqueo en <time>: N pasos esperan algo que nunca llega. | Se muestra encima de los resultados con el motor SysML, con cada paso en espera. Un accept sin emisor, un ítem que nunca se produce o un recurso que nunca se libera detiene la ejecución. |
Límites
- Las duraciones se escriben en segundos, minutos, horas o días (
SI::s,SI::min,SI::h,SI::d). Los milisegundos se escriben como segundos; las semanas, los meses y los años, como días. - Las máquinas de estados, los estímulos y Ejecutar junto con necesitan el motor SysML.
- Las entradas correlacionadas necesitan el motor SysML; el simulador de JavaScript extrae cada valor de forma independiente. Se pueden correlacionar como máximo 200 atributos en un grupo.
- La comprobación de coeficientes contradictorios abarca las correlaciones escritas en un mismo espacio de nombres; el Simulador comprueba todas las correlaciones de la ejecución.
Relacionado
SysML® y OMG® son marcas registradas de Object Management Group, Inc. en los Estados Unidos y otros países.