Holarch

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.

Cómo usarlo →

En esta página
  1. Resumen
  2. Conceptos
    1. Valor nominal y distribución
    2. Qué ajustes prevalecen
    3. Dos simuladores
  3. Cómo usarlo
    1. Cuándo y por qué
    2. Establecer una duración, una probabilidad o un recuento de bucle
    3. Escribir anotaciones en el texto
    4. Mover los ajustes antiguos al modelo
    5. Simular una máquina de estados
    6. Ejemplo práctico: la demostración Hybrid Car
    7. Consejos y buenas prácticas
    8. Errores habituales
    9. Cómo se relaciona
  4. Anotaciones
    1. Distribuciones
    2. Entradas correlacionadas
    3. Probabilidades y recuentos
    4. Recursos y costes
    5. Anotaciones que necesitan el motor SysML
  5. Mensajes
  6. Límites
  7. Relacionado

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 if o 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

  1. Seleccione el paso, la sucesión, la decisión, el bucle o la acción if en una vista de flujo de acciones, en el Navegador o en el Editor.
  2. En la sección Simulación del inspector, establezca Duración (un valor fijo o una distribución), Probabilidad (%), Iteraciones o Probabilidad de then (%).
  3. 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::DurationValue cuando 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.
  4. 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

  1. Abra el Editor.
  2. Añada la anotación dentro del cuerpo del elemento, como @HolarchSimulation::Kind { field = value; }, o detrás de él, como metadata HolarchSimulation::Kind about element { … }.
  3. 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.

  1. Haga clic en Mover los ajustes de simulación al modelo….
  2. La vista previa enumera cada ajuste y la anotación que lo sustituye.
  3. 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.

  1. Abra Comportamiento → Simulador y elija como Raíz una definición de estado o una parte que exhibe estados.
  2. 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.
  3. 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).
  4. 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.
  5. 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 toCruise tras shift tiene Probability 70; la rama else toma el 30 % restante. cruise dura 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; drive Consumes 1,5 Wh de ella y tiene un Cost de 0,4 USD por uso.
  • PowertrainStates: la transición startElectric tiene Probability 80 para su guarda; accept when charge < 15 cambia 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ía StopRequest y PlugIn a demoCar. 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

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ónCamposSignificado
Normalmean, sdDistribución normal.
Triangularlow, mode, highTriangular, con low ≤ mode ≤ high.
Uniformelow, highUniforme entre low y high.
ExponentialmeanExponencial con la media indicada.
Gammashape, scaleGamma; la media es shape × scale.
LogNormalmedian, sigmaEl logaritmo sigue una normal en torno al logaritmo de la mediana.
Weibullscale, shapeWeibull.
Betaalpha, beta, scaleBeta en 0..1, multiplicada por scale.
Poissonmean, scaleUn recuento con la media indicada, multiplicado por scale.
Binomialtrials, 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ónSobreSignificado
Correlation coefficientabout a, b: dos atributos, cada uno con una distribuciónLa 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.
  • ChargeStop de la demostración Hybrid Car correlaciona la espera de un cargador libre con el tiempo de carga (0,6).

Probabilidades y recuentos

AnotaciónSobreSignificado
Probability percentUna sucesión que sale de una decisiónEl peso de la rama. Las ramas sin peso se reparten lo que queda de 100.
Una acción ifLa probabilidad de la rama then cuando la condición no se puede evaluar.
Una acción de bucleLa probabilidad de repetir tras cada pasada.
Una transiciónLa probabilidad de que su guarda se cumpla cuando la guarda no se puede evaluar.
LoopCount countUna acción de bucleEl número de pasadas; tiene prioridad sobre las condiciones del bucle.
LoopExitUna sucesión a done en el cuerpo de un bucleTermina todo el bucle, no solo la pasada.

Recursos y costes

AnotaciónSobreSignificado
Resource initial, minimum, maximum, unitUn uso de parte o de ítemUna 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 amountabout step, poolSe toma cuando empieza el paso.
Produces amountabout step, poolSe añade cuando termina el paso.
Seizes amountabout step, poolSe toma cuando empieza el paso y se devuelve cuando termina.
Utilization amountUn uso de acción performCuánto de la parte que lo realiza ocupa el paso.
Cost amount, rate, unit, labelUn paso o una parte que lo realizaUn coste por uso (CostRate::perUse) o por hora (CostRate::perHour).

Anotaciones que necesitan el motor SysML

AnotaciónSignificado
Transfer latency, capacity, perEn una conexión o una interfaz: retrasa los ítems y las señales que se envían por ella.
Size sizeEn un ítem: su tamaño para los retrasos de transferencia.
Timeout limitEn una unión: detiene las ramas sin terminar cuando vence el límite.
NotBefore timeEn un paso: no empieza antes de este tiempo de ejecución.
ForkTargets, JoinSourcesEn 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 deepEn un estado compuesto: al volver a entrar se reanuda el subestado que estaba activo al salir.
HostHook key, pointsReservado 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

MensajeSignificado
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.

SysML® y OMG® son marcas registradas de Object Management Group, Inc. en los Estados Unidos y otros países.