Holarch

SysML v2

Metadados de simulação em projetos SysML v2

A biblioteca de metadados HolarchSimulation: como um modelo SysML v2 carrega durações, probabilidades de ramificação, contagens de laço, recursos, custos e ajustes de máquinas de estados para o Simulador, e como escrevê-los e movê-los.

Como usá-lo →

Nesta página
  1. Visão geral
  2. Conceitos
    1. Valor nominal e distribuição
    2. Quais ajustes prevalecem
    3. Dois simuladores
  3. Como usá-lo
    1. Quando e por quê
    2. Definir uma duração, probabilidade ou contagem de laço
    3. Escrever anotações no texto
    4. Mover ajustes antigos para o modelo
    5. Simular uma máquina de estados
    6. Exemplo prático: a demonstração Hybrid Car
    7. Dicas e boas práticas
    8. Erros comuns
    9. Como se conecta
  4. Anotações
    1. Distribuições
    2. Entradas correlacionadas
    3. Chances e contagens
    4. Recursos e custos
    5. Anotações que precisam do motor SysML
  5. Mensagens
  6. Limites
  7. Relacionado

Visão geral

Em um projeto SysML v2, os ajustes do Simulador fazem parte do modelo. Eles são anotações de metadados do pacote de biblioteca HolarchSimulation, que todo projeto SysML v2 carrega. Um modelo que os usa continua sendo SysML v2 válido: outras ferramentas leem as anotações como metadados comuns, e apenas o Simulador lhes dá significado.

Uma anotação fica dentro do elemento que anota ou nomeia esse elemento com 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"; }

Conceitos

Valor nominal e distribuição

A duração de uma etapa é seu atributo duration (ou um atributo tipado DurationValue ou TimeValue). Seu valor é a duração nominal que outras ferramentas e a avaliação do Holarch veem. Uma anotação de distribuição nesse atributo faz o Simulador sortear a duração em vez disso:

action cruise {
  attribute duration : ISQ::DurationValue = 1 [min] {
    @HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
  }
}

Quais ajustes prevalecem

  • Uma anotação de distribuição prevalece sobre o valor próprio do atributo.
  • Uma guarda, condição if ou condição de laço que o modelo consegue avaliar decide sozinha. Uma Probability ou LoopCount só é usada quando ele não consegue (um LoopCount sempre conta as passagens).
  • Os ajustes feitos antes de os ajustes de simulação passarem para o modelo são mantidos como dados do Holarch ao lado do modelo. Eles continuam prevalecendo, para que as execuções deem os mesmos resultados, até que você os mova (consulte Mover ajustes antigos para o modelo).

Dois simuladores

A página Simulador mostra qual simulador executa o modelo, à direita dos ajustes: Motor SysML (o simulador do Holarch Language Engine) ou Simulador JavaScript. Ambos leem as mesmas anotações. Máquinas de estados, estímulos, recursos de Resource, Consumes, Produces e Seizes, custos de Cost e as outras anotações de Anotações que precisam do motor SysML são executados apenas com o motor SysML.

Como usá-lo

Quando e por quê

Escreva os ajustes de simulação no modelo quando o modelo for o registro do projeto: os números viajam com os arquivos .sysml, aparecem nas revisões do texto e são versionados com o restante do modelo. Use-os enquanto analisa um cenário operacional (linhas do tempo, participação dos ramos, uso de recursos) e antes de verificar um requisito em relação a um estudo de Monte Carlo.

Definir uma duração, probabilidade ou contagem de laço

  1. Selecione a etapa, sucessão, decisão, laço ou ação if em uma Visão de fluxo de ações, no Navegador ou no Editor.
  2. Na seção Simulação do inspetor, defina Duração (um valor fixo ou uma distribuição), Probabilidade (%), Iterações ou Probabilidade de then (%).
  3. O Holarch escreve a anotação no modelo: Duração define o valor do atributo como a média e adiciona a anotação de distribuição (ou escreve attribute duration : ISQ::DurationValue quando a etapa não tem um); Probabilidade (%) escreve Probability; Iterações escreve LoopCount. Cada alteração pode ser revertida com um único Desfazer e aparece no texto imediatamente.
  4. Limpe um campo para remover sua anotação.

O Holarch checa cada alteração com o checador SysML antes de escrevê-la. Uma alteração que adicionaria um erro não é escrita, e uma mensagem nomeia o problema.

Escrever anotações no texto

  1. Abra o Editor.
  2. Adicione a anotação dentro do corpo do elemento, como @HolarchSimulation::Kind { field = value; }, ou depois dele, como metadata HolarchSimulation::Kind about element { … }.
  3. Para Consumes, Produces e Seizes, nomeie primeiro a etapa e depois o recurso: metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }.

Mover ajustes antigos para o modelo

Projetos cujos ajustes de simulação foram feitos antes de passarem para o modelo mostram Alguns ajustes de simulação deste projeto são dados do Holarch, não parte do modelo. acima dos ajustes do Simulador.

  1. Clique em Mover ajustes de simulação para o modelo….
  2. A pré-visualização lista cada ajuste e a anotação que o substitui.
  3. Clique em Mover para o modelo. Todos os ajustes são movidos, e um único Desfazer reverte tudo; as execuções dão os mesmos resultados.

Simular uma máquina de estados

As máquinas de estados são executadas com o motor SysML.

  1. Abra Comportamento → Simulador e escolha uma definição de estado, ou uma part que exibe estados, como Raiz.
  2. Opcional: em Executar junto com, escolha uma ação de cenário que envia sinais para a part, como a TestDrive da demonstração.
  3. Em Estímulos, clique em + Adicionar estímulo e defina Em (horário e unidade), Sinal e Para (uma máquina, ou Todas as máquinas que o aceitam).
  4. Pressione ▶ Reproduzir, ⏭ Passo ou ⏩ Executar até o fim. Máquina de estados durante a execução acende os estados ativos e marca a transição disparada; a aba Estados mostra Estados ao longo do tempo e Transições disparadas.
  5. Em Monte Carlo, a aba Estados mostra Tempo no estado e Contagem de transições. Verificar em relação ao requisito… oferece como saídas o tempo no estado e a participação na execução de cada estado.

Em uma Visão de transição de estados, ▶ Simular abre uma barra com ▶ Reproduzir, ⏭ Passo, ⏩ Executar até o fim, Redefinir e Abrir no Simulador. A execução usa os estímulos salvos no Simulador para essa definição de estado.

Exemplo prático: a demonstração Hybrid Car

A demonstração Hybrid Car (Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração) usa a biblioteca:

  • DriveCycle: a sucessão toCruise depois de shift tem Probability 70; o ramo else fica com os 30 % restantes. cruise leva 1 min nominal, sorteado de uma distribuição Triangular (45 s, 1 min, 2 min).
  • DrivenCar: a bateria do trem de força é um Resource de 62 Wh; drive Consumes 1,5 Wh dela e tem um Cost de 0,4 USD por uso.
  • PowertrainStates: a transição startElectric tem Probability 80 para sua guarda; accept when charge < 15 muda para híbrido quando a carga cai; accept after 30 [min] encerra a recarga.
  • TestDrive: um cenário que envia StartRequest, espera uma hora e depois envia StopRequest e PlugIn para demoCar. Execute Demo Car junto com Test Drive para ver o trem de força mudar de estado.

A demonstração passa na checagem com 0 diagnósticos.

Dicas e boas práticas

  • Mantenha o valor nominal significativo: defina-o como o valor esperado da distribuição, como faz o inspetor.
  • Dê nomes às sucessões que você anota (succession toCruise first …), para que a anotação seja fácil de encontrar no texto.
  • Prefira condições que o modelo consegue avaliar a probabilidades; use Probability para o que o modelo não descreve.

Erros comuns

  • Uma probabilidade não tem efeito: a guarda pode ser avaliada, então ela decide. O inspetor diz "Avalia como true: sempre seguido." ou "Avalia como false: nunca seguido."
  • As probabilidades dos ramos não somam 100 %: os ramos sem Probability dividem o que sobra; quando as informadas passam de 100 %, o aviso diz "As probabilidades dos ramos somam N %. Altere-as para totalizar 100 %."
  • Uma anotação de duração na própria etapa: as distribuições pertencem ao atributo de duração, não à ação.

Como se conecta

Anotações

Distribuições

Coloque uma distribuição em um atributo de duração. Os campos de localização e de escala recebem uma grandeza com unidade (45 [s], 2 [min]); os campos de forma recebem um número.

AnotaçãoCamposSignificado
Normalmean, sdDistribuição normal.
Triangularlow, mode, highTriangular, com low ≤ mode ≤ high.
Uniformelow, highUniforme entre low e high.
ExponentialmeanExponencial com a média dada.
Gammashape, scaleGama; a média é shape × scale.
LogNormalmedian, sigmaO logaritmo é normal em torno do logaritmo da mediana.
Weibullscale, shapeWeibull.
Betaalpha, beta, scaleBeta em 0..1, multiplicada por scale.
Poissonmean, scaleUma contagem com a média dada, multiplicada por scale.
Binomialtrials, p, scaleSucessos em um número de tentativas, multiplicados por scale.

Durações sorteadas abaixo de zero são sorteadas de novo.

Entradas correlacionadas

Sem uma correlação, todo valor sorteado de uma distribuição é independente dos outros. Correlation faz dois deles variarem juntos:

metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
AnotaçãoEmSignificado
Correlation coefficientabout a, b: dois atributos, cada um com uma distribuiçãoA correlação de postos (Spearman) dos seus valores, de -1 a 1. 0 é independente, 1 os ordena sempre da mesma forma, -1 de forma oposta.
  • Cada atributo mantém sua própria distribuição. O simulador junta todos os pares em uma matriz de correlação (uma cópula gaussiana): o n-ésimo valor sorteado para um atributo em uma execução acompanha o n-ésimo valor de todo atributo com que ele está correlacionado.
  • Os coeficientes de um grupo de atributos correlacionados precisam ser compatíveis entre si: a fortemente com b, b fortemente com c, mas a oposto a c é impossível. A checagem aponta um grupo assim; enfraqueça um dos coeficientes.
  • Durações e quantidades (Consumes, Produces, Seizes) se correlacionam da mesma forma. Uma execução com a mesma semente dá os mesmos valores.
  • No Simulador, no modo Monte Carlo com o motor SysML, Entradas correlacionadas lista os pares da raiz. Escolha dois atributos e um coeficiente e clique em + Adicionar correlação, altere um coeficiente ou clique em × para remover um; um único Desfazer reverte cada alteração. Depois de um estudo, Alcançado mostra a correlação de postos dos valores que as execuções sortearam.
  • O ChargeStop da demonstração Hybrid Car correlaciona a espera por um carregador livre com o tempo de recarga (0.6).

Chances e contagens

AnotaçãoEmSignificado
Probability percentUma sucessão saindo de uma decisãoO peso do ramo. Os ramos sem peso dividem o que sobra de 100.
Uma ação ifA chance do ramo then quando a condição não pode ser avaliada.
Uma ação de laçoA chance de repetir depois de cada passagem.
Uma transiçãoA chance de sua guarda valer quando a guarda não pode ser avaliada.
LoopCount countUma ação de laçoO número de passagens; ele tem precedência sobre as condições do laço.
LoopExitUma sucessão para done no corpo de um laçoEncerra o laço inteiro, não apenas a passagem.

Recursos e custos

AnotaçãoEmSignificado
Resource initial, minimum, maximum, unitUm uso de part ou de itemUm estoque de uma quantidade. Se o uso declarar attribute level : Real, o simulador o mantém igual à quantidade, para que as guardas possam lê-lo.
Consumes amountabout step, poolRetirado quando a etapa começa.
Produces amountabout step, poolAdicionado quando a etapa termina.
Seizes amountabout step, poolRetirado quando a etapa começa e devolvido quando ela termina.
Utilization amountUm uso de ação performQuanto da part executora a etapa ocupa.
Cost amount, rate, unit, labelUma etapa ou uma part executoraUm custo por uso (CostRate::perUse) ou por hora (CostRate::perHour).

Anotações que precisam do motor SysML

AnotaçãoSignificado
Transfer latency, capacity, perEm uma conexão ou interface: atrasa os itens e sinais enviados por ela.
Size sizeEm um item: seu tamanho para os atrasos de transferência.
Timeout limitEm uma junção: para os ramos não concluídos quando o limite expira.
NotBefore timeEm uma etapa: ela não começa antes deste tempo de execução.
ForkTargets, JoinSourcesEm uma transição que entra em um estado paralelo ou sai dele: os subestados em que se entra, ou os subestados que precisam estar ativos.
History deepEm um estado composto: reentrar retoma o subestado que estava ativo quando ele foi deixado.
HostHook key, pointsReservado para o Holarch: a execução pausa para receber entrada nos pontos listados.

O simulador JavaScript lê Probability, LoopCount e as distribuições.

Mensagens

MensagemSignificado
Alguns ajustes de simulação deste projeto são dados do Holarch, não parte do modelo.Ajustes mais antigos ainda estão guardados ao lado do modelo. Clique em Mover ajustes de simulação para o modelo….
Dados do Holarch de antes de os ajustes de simulação passarem para o modelo; eles prevalecem sobre o modelo.Mostrado na seção Simulação do inspetor. Altere o campo para escrevê-lo no modelo, ou mova todos os ajustes no Simulador.
Nenhuma duração no modelo. Defina uma aqui (isso escreve attribute duration : ISQ::DurationValue) ou escreva-a no texto.A etapa não tem atributo de duração.
@Normal: sd must be greater than zero. Change sd. (e mensagens semelhantes para outras distribuições e parâmetros)Um parâmetro de distribuição está ausente ou fora do intervalo. Com o motor SysML, a checagem do modelo o aponta no Editor e o Simulador se recusa a executar até que seja corrigido.
@Normal: sd has another unit dimension than …Um parâmetro de localização ou de escala tem unidades diferentes das do atributo, por exemplo metros em uma duração.
@LoopCount does not apply to a part …A anotação está em um tipo de elemento ao qual não se aplica. Mova-a ou exclua-a.
metadata Consumes … about needs an action and a part or item annotated @Resource.Os elementos depois de about estão errados em número ou em tipo.
A probability of N % is outside 0 to 100.Digite uma porcentagem de 0 a 100.
The branch probabilities of this decision add up to N %; the simulator scales them to 100 %.Um aviso: todos os ramos têm peso e eles não somam 100.
A correlation needs two different attributes …, … is not an attribute … ou … has no distribution, so nothing is drawn to correlate …Uma Correlation nomeia um atributo duas vezes, algo que não é um atributo ou um atributo sem distribuição.
The coefficient N is outside -1 to 1. ou The correlation has no coefficient.Digite um coeficiente de -1 a 1.
“a” and “b” are already correlated; the first correlation is used. …Um aviso: uma segunda Correlation do mesmo par é ignorada. Remova uma das duas.
The correlations of … contradict each other: no joint distribution has them …Os coeficientes de um grupo não são compatíveis entre si (a matriz não é positiva semidefinida). Enfraqueça um deles. O Simulador se recusa a executar até que seja corrigido.
Impasse em <time>: N etapas esperam por algo que nunca chega.Mostrado acima dos resultados com o motor SysML, com cada etapa que está esperando. Um accept sem remetente, um item nunca produzido ou um recurso nunca liberado interrompe a execução.

Limites

  • As durações são escritas em segundos, minutos, horas ou dias (SI::s, SI::min, SI::h, SI::d). Milissegundos são escritos como segundos; semanas, meses e anos, como dias.
  • Máquinas de estados, estímulos e Executar junto com precisam do motor SysML.
  • As entradas correlacionadas precisam do motor SysML; o simulador JavaScript sorteia cada valor de forma independente. No máximo 200 atributos podem ser correlacionados em um grupo.
  • A checagem de coeficientes contraditórios abrange as correlações escritas em um namespace; o Simulador checa todas as correlações da execução.

SysML® e OMG® são marcas registradas da Object Management Group, Inc. nos Estados Unidos e em outros países.