Holarch

Comportamento

Simulação

Execute um fluxo de Action como uma simulação de eventos discretos ou um estudo de Monte Carlo, leia resultados de tempo, custo, recursos e utilização, programe decisões por script e registre um resultado de verificação para um requisito.

Como usá-lo →

Nesta página
  1. Visão geral
  2. Conceitos
    1. O que o Simulador lê
  3. Como usá-lo
    1. Quando e por quê
    2. Executar uma simulação de Eventos discretos
    3. Executar um estudo de Monte Carlo
    4. Verificar um requisito e registrar o resultado
    5. Execuções salvas
    6. Exemplo prático: a passagem de imageamento do CubeSat EO-1
    7. Dicas e boas práticas
    8. Erros comuns
    9. Como se conecta
  4. Regras da simulação
    1. Durações e distribuições
    2. Construções de controle
    3. Resources
    4. Assets e utilização
    5. Custos
    6. Números aleatórios e sementes
  5. A página do Simulador
    1. Cabeçalho da página e barra de execução
    2. Ajustes
    3. Controles de Eventos discretos
    4. Controles de Monte Carlo
    5. Notas acima dos painéis
  6. Painéis
    1. Menu do painel
    2. Abas de Eventos discretos
    3. Abas de Monte Carlo
  7. Scripts
    1. Ganchos
    2. Construtor de perguntas
    3. Disponível nos scripts
    4. Exemplo: decidir um ramo pela carga da bateria
    5. Sandbox e confiança
  8. Teclado e mouse
  9. Mensagens
  10. Limites
  11. Relacionado

Visão geral

O Simulador executa o fluxo de uma Action ao longo de um tempo simulado, exatamente como o Diagrama de Action dela o desenha. Ele tem dois modos:

  • Eventos discretos: uma execução temporizada que você pode acompanhar, percorrer passo a passo e na qual pode responder a decisões. Mostra quais ações rodam quando, pelo que esperam, como os recursos sobem e descem, quais ativos estão ocupados e quanto custa a execução.
  • Monte Carlo: muitas execuções independentes com durações e decisões amostradas. Mostra a dispersão do tempo e do custo totais, percentis, uma curva de probabilidade acumulada, os caminhos de decisão seguidos e a probabilidade de atender a um limiar.

O Simulador lê o modelo e nunca o altera durante a execução. Ele grava no projeto de três formas: os ajustes de uma Action raiz (salvos à medida que você os altera), um registro de execução para cada execução concluída e Registrar resultado….

Conceitos

O que o Simulador lê

O Simulador obtém do modelo tudo de que precisa. Configure estes elementos no Diagrama de Action e nos atributos das entidades antes de executar.

Elemento do modeloDe onde vemO que a simulação faz com ele
FluxoO Diagrama de Action da Action raiz: sequência, Paralelo, SYNC, OR, LOOP e EXITExecuta os elementos em ordem. Os ramos rodam em paralelo, ou um é escolhido.
DuraçãoO atributo Duração de cada Action (um número ou uma distribuição, com unidade)O tempo que a ação leva. Uma ação decomposta leva o tempo do seu fluxo filho.
DecomposiçãoActions filhas com fluxo próprioExecuta o fluxo filho no lugar da duração própria do pai
GatilhosOs Input/Outputs que uma ação receives (atributo de relacionamento Gatilho, ativado a menos que definido como false)A ação espera até que cada I/O de gatilho tenha sido gerado
Geração de I/OOs Input/Outputs que uma ação generatesFicam disponíveis quando a ação termina, depois de qualquer atraso do Conduit
Atraso do ConduitO Conduit que transfers o I/O: Latência mais Tamanho ÷ CapacidadeAtrasa a entrega do I/O
ResourcesRelacionamentos consumes, seizes e produces com Resources, com uma Quantidade (padrão 1)Consumido e retido no início. As quantidades retidas são liberadas no fim. Produzido no fim.
Capacidade do Assetperformed by com uma Quantidade, e a Multiplicidade do ativo sob o pai deleA ação espera até que o ativo tenha capacidade livre
Tempo ocupado do AssetTodo Asset que executa uma ação (performed by)Gráficos de Ocupado (%) e de utilização
CustosEntidades Cost incurred by uma Action ou por um Asset executorSomadas ao custo total acumulado
CalendarO atributo Início da raiz e de cada ActionUsado somente em Datas do calendário
ScriptsO script de simulação da ação ou da construçãoGanchos que definem durações, decidem ramos, fazem perguntas e acompanham valores

Os tempos são guardados em segundos e mostrados na unidade mais legível (ms, s, min, h, dias, meses ou anos).

As regras detalhadas para durações, decisões, recursos, ativos, custos e sementes estão em Regras da simulação abaixo.

Como usá-lo

Quando e por quê

Simule quando o fluxo funcional existir e as ações dele tiverem durações, executores e recursos. Isso costuma ser depois da análise funcional, durante a alocação e os trade-offs de arquitetura.

Uma simulação responde:

  • Quanto tempo leva a operação, e quanto esse tempo varia?
  • Quais ações estão no caminho crítico? Onde elas esperam, por dados, recursos ou capacidade de ativos?
  • Recursos como a carga da bateria ou o armazenamento de dados ficam dentro dos limites?
  • Quais ativos estão sobrecarregados?
  • Qual é a probabilidade de que um requisito de desempenho (tempo, custo, um nível de recurso) seja atendido? Isso vira um resultado de verificação por análise vinculado ao requisito.

Executar uma simulação de Eventos discretos

  1. Abra o Diagrama de Action da operação.
  2. Escolha ▶ Simular ▾ → Eventos discretos.

    O Simulador abre com essa Action como Action raiz.

    Outras formas de entrar: Comportamento → Simulador na barra de navegação (abre em uma Action cujos ajustes do Simulador estão salvos, senão na primeira Action com fluxo; escolha outra Action raiz se necessário), ou Abrir em ▾ → Simulador de uma Action. Escolher outra Action raiz com o mouse a abre na hora; pelo teclado, escolha-a e pressione Enter (ou clique em Abrir).

  3. Confira os ajustes: clique em Ajustes na barra superior (a dica dele lista os atuais). Os principais ajustes são Decisões, Velocidade, Variar durações fixas com ± %, Semente aleatória e Datas do calendário (veja Ajustes).
  4. Pressione ▶ Reproduzir.

    O relógio corre e Ações ao longo do tempo (aba Linha do tempo) cresce. Diagrama de Action durante a execução colore cada ação de verde enquanto roda, de laranja enquanto espera e de cinza quando termina.

  5. Pressione ⏸ Pausar para parar e inspecionar.
  6. Pressione ⏭ Passo para avançar até o próximo evento, ou ⏩ Executar até o fim para terminar sem animação.
  7. Quando aparecer uma caixa de diálogo com o título Entrada para …, escolha o caminho ou digite o valor.
  8. Clique em OK.

    A execução continua como antes: reproduzindo, passo a passo ou até o fim.

  9. Leia os resultados quando a execução terminar:
    • Status: 100% concluído, Deadlock ou Interrompido. Depois de um deadlock, diz quando a execução parou e pelo que cada ação em espera aguarda, por exemplo Interrompido em 0 ms: F1 Separate and Detumble aguarda ADCS Sensor Data, que nenhuma ação anterior produz. Clique no nome de uma ação para inspecioná-la;
    • Tempo total e Custo total;
    • os painéis de recursos e de utilização;
    • o Console, para avisos.
  10. Clique em qualquer barra ou elemento de gráfico para ver detalhes.

    A entidade abre no inspetor, com a frequência e a duração com que rodou nesta execução. Abrir em ▾ → Visão do item abre a página dela.

  11. Pressione ⟲ Redefinir para limpar a execução e começar de novo.

Executar um estudo de Monte Carlo

  1. Alterne o cabeçalho para Monte Carlo. A partir do Diagrama de Action, escolha ▶ Simular ▾ → Monte Carlo.
  2. Defina Execuções (1 a 20.000; padrão 100).
  3. Defina Variar durações fixas se quiser dispersão nas durações fixas.
  4. Digite uma Semente aleatória se o estudo precisar ser repetível.
  5. Pressione ▶ Executar Monte Carlo.

    Se alguns ORs ou LOOPs não tiverem probabilidade ou contagem, a caixa de diálogo Decisões não especificadas os lista.

  6. Nessa caixa de diálogo, clique em Usar probabilidades iguais para continuar. Ou clique em Cancelar e defina-as no Diagrama de Action.

    Você vê uma barra de progresso e o texto corrente k / n · mean … · mean cost …. Clique em Cancelar para parar; o aviso diz "Execução de Monte Carlo interrompida".

    Quando o estudo termina, o texto mostra o número de simulações e o tempo decorrido.

  7. Leia Execuções concluídas, depois a aba Distribuição (Estatísticas, Distribuição de duração, Probabilidade acumulada (curva S)) e Combinações de ramos na aba Fatores.

    Se alguma execução entrou em deadlock ou falhou, uma caixa vermelha dá a contagem e P(falha) com o intervalo de confiança de 95%.

  8. Para ver por que uma execução falhou, abra Execuções com falha e clique em Ver execução.

    A execução é reproduzida no modo Eventos discretos com a sua própria semente.

  9. Clique em Voltar aos resultados de Monte Carlo para retornar.

Verificar um requisito e registrar o resultado

Use isto depois de um estudo de Monte Carlo para transformar os resultados em um resultado de verificação.

  1. Clique em Verificar em relação ao requisito….
  2. Escolha a Saída: Tempo total, Custo total, a quantidade mínima ou final de cada Resource, ou uma variável global numérica de script (Global: …).
  3. Defina o limiar de uma das duas formas:
    • A partir de um Measure: escolha um Measure e um Usar (Limiar ou Objetivo). Os campos são preenchidos a partir do Measure (veja abaixo).
    • Manualmente: defina Critério (≤ no máximo ou ≥ pelo menos), Valor e Unidades, e escolha o Requirement.
  4. Defina Probabilidade exigida (%) (padrão 90).

    Você vê a tabela de resultados:

    • Critério e Execuções;
    • Média (IC de 95%) e P5 / P50 / P95;
    • P(atender), com o intervalo de confiança de 95%;
    • Margem (média vs. limiar);
    • Resultado: Aprovado ou Reprovado.
  5. Clique em Registrar resultado….

    A pré-visualização Registrar resultado lista as alterações que vai fazer:

    • O Valor projetado (ou Valor) do Measure é definido como a média.
    • Um Test Case verifica o requisito. É um novo, chamado "Simulation check: <output> <criterion>", ou um existente que você escolhe. O Status dele passa a ser Aprovado ou Reprovado, e o Resultado real dele recebe o texto do resultado.
  6. Desmarque as linhas que quiser pular.
  7. Clique em Aplicar.

    Um único Desfazer reverte tudo.

Quando você escolhe um Measure na etapa 3, ele preenche os campos assim:

  • O valor dele preenche Valor e Unidades.
  • A Direção de melhoria dele escolhe o critério: Negativa dá ≤, Positiva dá ≥.
  • O Requirement que ele specifies preenche Requirement.

Execuções salvas

Cada execução concluída é salva para você; não há etapa de salvar.

  • Uma execução de Eventos discretos é salva quando termina (concluída, em deadlock ou interrompida). Um estudo de Monte Carlo é salvo quando todas as execuções dele terminam; um estudo cancelado não é salvo.
  • O registro é um Artifact com o rótulo Simulation Run, com um arquivo .sim. O nome dele é "<root> run <date> seed <n>", por exemplo "Perform Delivery Mission run 2026-10-14 09.30 seed 48213", ou "<root> Monte Carlo <date> seed <n>" para um estudo. A descrição dele resume o resultado.
  • Uma execução sem Semente aleatória recebe uma, então o nome diz como repeti-la: digite essa semente e execute de novo.
  • O aviso "Salvo como <nome>." leva ao registro.
  • As reproduções de uma execução de Monte Carlo e os registros abertos não são salvos de novo. Os leitores não podem salvar registros.
  • Exclua os registros de que não precisa no Banco de dados (filtre pelo rótulo Simulation Run).

Os projetos mais antigos usam o nome de rótulo Simulation Output; ele passa a ser Simulation Run quando o projeto abre, e as importações aceitam qualquer um dos nomes.

Para reabrir resultados salvos:

  1. Abra Resultados salvos ▾ no cabeçalho da página.
  2. Escolha o resultado.

    Um banner diz "Visualizando resultados salvos: …". O link Executar novamente no modelo atual dele executa o modelo atual no mesmo modo.

Exemplo prático: a passagem de imageamento do CubeSat EO-1

O projeto de demonstração contém a operação OPS Run Nominal Imaging Pass. Também contém o requisito 6.5 Planning Cycle Time: "The mission shall complete each planning cycle, from target list uplink to product delivery, within 100 minutes." Crie a demonstração com Gerenciar projetos → Arquivos do projeto ▾ → Novo projeto de demonstração.

O fluxo de OPS:

  1. Três etapas em sequência:
    • OPS.1 Transmit Imaging Plan (triangular de 4 a 9 minutos, pico 6; Ground Station);
    • OPS.2 Receive Imaging Plan (1 minuto);
    • OPS.3 Load Command Schedule (2 minutos).
  2. Um Paralelo: OPS.4 Rotate to Target (normal, 3 ± 0,5 minutos) e OPS.5 Prepare Camera (5 minutos). Ambas são disparadas pelo I/O Command Schedule que OPS.3 gera.
  3. Um LOOP Each target, 4 iterações: OPS.6 Capture Image Strip (normal, 40 ± 6 segundos), depois OPS.7 Encode and Store Image (uniforme de 20 a 40 segundos).
  4. Um OR Contact in view?:
    • Yes (75%) executa OPS.8 Transmit Image Data (normal, 8 ± 1,5 minutos);
    • No (25%) executa OPS.9 Hold Data Onboard.
  5. Um Paralelo: OPS.10 Recharge Battery in Sunlight (35 minutos) em um ramo. No outro, OPS.11 Receive Downlink (9 minutos) seguida de OPS.12 Process Image Products (normal, 45 ± 10 minutos).

Os recursos:

  • Battery Charge (62 Wh inicial, 23 mínimo, 77 máximo). OPS.4 a OPS.8 o consomem. OPS.10 o produz (+30 Wh).
  • Data Storage (1,5 GB inicial). Ganha 2,5 GB a cada OPS.7 e perde 8 GB em OPS.8.

A demonstração tem ajustes salvos para OPS: semente 42, e 200 iterações de Monte Carlo com variação uniforme de ±10% nas durações fixas.

Execute-a:

  1. Abra Comportamento → Simulador.
  2. Escolha OPS Run Nominal Imaging Pass como Action raiz e mantenha Eventos discretos.
  3. Pressione ⏩ Executar até o fim.

    Você vê:

    • Ações ao longo do tempo mostra OPS.4 e OPS.5 lado a lado, e quatro iterações numeradas de OPS.6 e OPS.7 (#2, #3, #4).
    • O ramo longo OPS.11 → OPS.12 define o horário de término.
    • Na aba Resources, Níveis de Resources ao longo do tempo mostra Battery Charge descendo em degraus durante o imageamento e se recuperando durante OPS.10.
    • Custo total diz "Sem custos", porque a demonstração não tem entidades Cost.
  4. Mude para Monte Carlo.
  5. Pressione ▶ Executar Monte Carlo (200 execuções).

    Combinações de ramos (aba Fatores) mostra cerca de três quartos das execuções em Yes.

  6. Clique em Verificar em relação ao requisito… e mantenha Tempo total.
  7. Escolha o Measure MOE-7 Planning Cycle Time e Usar Limiar.

    O Valor passa a 100, Unidades a Minutos, Critério a ≤, e Requirement a 6.5 Planning Cycle Time.

  8. Mantenha 90% e leia P(atender) e o veredito.
  9. Clique em Registrar resultado… e depois em Aplicar.

    O Valor projetado de MOE-7 recebe a média. Um Test Case que verifica 6.5 recebe o Status Aprovado ou Reprovado. A RVTM agora lista esse Test Case em relação a 6.5.

Dicas e boas práticas

  • Dê uma Duração a toda ação folha. Uma ação sem Duração não leva tempo e some no eixo do tempo.
  • Use distribuições para as durações sobre as quais você tem dúvida. Use Variar durações fixas apenas como checagem rápida de sensibilidade.
  • Antes do Monte Carlo, defina probabilidades em todos os ORs e iterações em todos os LOOPs. Caso contrário, cada execução escolhe ao acaso, e os resultados avisam isso.
  • Defina uma Semente aleatória antes de registrar um resultado de verificação, para que o resultado possa ser reproduzido. A semente é incluída no texto registrado.
  • Execute iterações suficientes. Quando a probabilidade exigida fica dentro do intervalo de confiança, a checagem diz "Execute mais iterações para um veredito mais firme."
  • Os ajustes são salvos com a Action raiz à medida que você os altera, então acompanham o projeto.

Erros comuns

SintomaCausaCorreção
Status mostra Deadlock; o Console diz "aguardando o I/O … (nunca gerado)"Uma ação recebe como gatilho um I/O que nada gera no caminho seguido (por exemplo depois de um OR)Gere o I/O em todos os caminhos, ou defina Gatilho como false no relacionamento receives
Deadlock "aguardando … (nunca disponível)"Um Resource nunca volta a ficar acima da quantidade de que uma ação precisa, ou a capacidade de um ativo é menor que a Quantidade de uma açãoAumente a Quantidade inicial, adicione uma ação produtora, ou confira as Quantidades e a Multiplicidade
Todas as execuções têm o mesmo tempo totalTodas as durações são fixas e a variação é NenhumaUse distribuições, ou defina Variar durações fixas
"Simulação abortada: passos demais (verifique as contagens de LOOP ou uma decomposição recursiva)."Um LOOP roda vezes demais, ou uma ação está dentro da própria decomposiçãoReduza a contagem do LOOP ou corrija a decomposição
O Console mostra "Erro de script em …"Um script lançou uma exceçãoAbra o script da ação (Editar script… no inspetor do Diagrama de Action) e corrija a linha indicada
A utilização de Assets está vaziaNenhuma ação é performed by um AssetRelacione as ações aos Assets que as executam

Como se conecta

  • Recebe dados de: o fluxo do Diagrama de Action, e os atributos e relacionamentos das ações, I/Os, recursos, conduits, ativos e custos dele. O fluxo montado na Análise funcional é o mesmo fluxo.
  • Alimenta:
    • Measures (Valor projetado ou Valor);
    • Test Cases que verificam requisitos, e portanto a RVTM e a Central de testes;
    • Artifacts com resultados salvos;
    • Cronogramas MS Project XML e relatórios CSV.

Regras da simulação

Esta seção explica exatamente como o Simulador trata durações, decisões, recursos, ativos, custos e números aleatórios.

Durações e distribuições

  • Uma Duração é um valor e uma unidade: Milissegundos, Segundos, Minutos, Horas, Dias, Semanas, Meses ou Anos. Um valor sem unidade é lido como horas.
  • O valor é um número fixo ou uma distribuição, como =norm.dist(40, 6) ou =triang.dist(4, 9, 6).
  • As distribuições são amostradas a cada execução.
  • As durações negativas amostradas são sorteadas de novo. Por isso, uma distribuição normal se comporta como se fosse truncada em 0.
  • Há dez distribuições disponíveis: beta, binomial, exponencial, gama, log-normal, normal, Poisson, triangular, uniforme e Weibull. Veja Tipos de atributo e distribuições.
  • Uma Duração =script() chama o gancho duration() da ação a cada execução. Digite =script() no valor da Duração; o gancho retorna a duração na unidade da Duração (sem número, conta como 0).

Variar durações fixas é um ajuste que acrescenta dispersão apenas aos números fixos. As distribuições nunca recebem variação adicional.

  • Uniforme ±% amostra uniformemente dentro de ± a porcentagem.
  • Triangular ±% amostra um triângulo com pico no valor fixo.

Construções de controle

ConstruçãoComportamento na simulação
Paralelo (sem entidade)Inicia todos os ramos de uma vez. Continua quando todos os ramos terminam.
SYNCO mesmo que Paralelo. A Duração dele é um tempo limite. Quando expira, os ramos não concluídos são interrompidos (as barras de Gantt deles ficam vermelhas, "interrompido porque o SYNC expirou") e o fluxo continua.
ORSegue exatamente um ramo, escolhido pelo Tipo de decisão (abaixo)
LOOPCheca o Repetir enquanto antes de cada passada, e executa o corpo de novo enquanto a condição for verdadeira
EXITEncerra o LOOP que o contém. No nível superior, encerra o fluxo.

Tipos de decisão do OR:

  • Probabilidade: cada ramo tem uma probabilidade (%). Os ramos deixados em branco dividem igualmente o que resta de 100%. Se todas as probabilidades forem 0, cada ramo tem a mesma chance.
  • Quantidade do recurso: cada ramo compara a quantidade atual do Resource escolhido (==, !=, >, <, >=, <=). É seguido o primeiro ramo cuja condição for verdadeira, senão o ramo marcado else.
  • Script: o onEnd() da construção retorna o nome do ramo a seguir (ou o índice dele). Um nome desconhecido registra um aviso, e um ramo aleatório é seguido.
  • Nenhum (perguntar durante a execução, ou aleatório): com Decisões definido como Perguntar (quando não há script), uma caixa de diálogo pergunta qual caminho seguir. Caso contrário, um ramo é escolhido ao acaso.

Condições de continuação do LOOP:

  • Iterações: um número fixo de passadas (pelo menos 1).
  • Probabilidade: antes de cada passada, continuar com esta probabilidade (%).
  • Quantidade do recurso: continuar enquanto a quantidade do Resource atender à comparação.
  • Script: onEnd() é chamado antes de cada passada. true executa o corpo de novo, false para, e um número define quantas passadas a mais executar.
  • Nenhum (perguntar durante a execução, ou aleatório): no modo de pergunta, uma caixa de diálogo pede Quantas iterações? (padrão 3). Caso contrário, executa 0, 1 ou 2 passadas ao acaso.

Resources

Um Resource tem Quantidade inicial, Quantidade mínima, Quantidade máxima e Unidades. A quantidade inicial é limitada ao mínimo e ao máximo.

  • consumes: a quantidade é tirada quando a ação começa e não é devolvida.
  • seizes: a quantidade é tirada quando a ação começa e liberada quando ela termina.
  • produces: a quantidade é somada quando a ação termina. As quantidades acima do máximo são limitadas.

Uma ação espera quando precisa de mais do que está disponível. "Não disponível" significa que a quantidade cairia abaixo da Quantidade mínima, ou abaixo de 0 quando não há mínimo definido. A ação espera até que outras ações liberem ou produzam o suficiente. A barra de Gantt dela mostra uma espera hachurada em roxo.

Assets e utilização

  • Todo Asset que executa uma ação (performed by) fica ocupado enquanto a ação roda.
  • Ocupado (%) é a fração do tempo simulado em que pelo menos uma das ações dele rodou.

Para modelar a capacidade, defina uma Quantidade no relacionamento performed by.

  • A capacidade do ativo é o limite superior da Multiplicidade no relacionamento decomposed by do pai dele. Por exemplo, 0..2 dá 2.
  • Uma ação espera enquanto o ativo não tem capacidade livre (espera hachurada em laranja).
  • Sem Multiplicidade, a capacidade é ilimitada.

Custos

  • Uma entidade Cost tem Montante, Taxa e Unidades.
  • Com a Taxa Por hora, o montante é multiplicado pela duração da ação em horas. Caso contrário, é cobrado uma vez, quando a ação termina.
  • Um Cost incurred by um Asset executor é cobrado a cada ação que o Asset executa. É multiplicado pela Quantidade do performed by (1 quando não definida).
  • As unidades do primeiro Cost encontrado rotulam todos os valores de custo.

Números aleatórios e sementes

  • Semente aleatória torna uma execução repetível. Deixe em branco para uma nova sequência aleatória a cada vez.
  • No Monte Carlo, cada execução tira a sua própria semente da semente do estudo. Por isso, você pode reproduzir qualquer execução individual no modo Eventos discretos com Reproduzir novamente na aba Execuções (ou Ver execução para uma execução com falha).
  • Math.random() nos scripts usa o mesmo gerador com semente.

A página do Simulador

Cabeçalho da página e barra de execução

A barra sob o cabeçalho da página contém, da esquerda para a direita, a Action raiz, os controles de execução do modo (abaixo), Ajustes e a alternância de modo. Antes da primeira execução, a página mostra uma linha de explicação e o Diagrama de Action; os cartões de resumo (Status, Tempo total, Custo total, ou os do Monte Carlo) aparecem com a primeira execução.

  • Action raiz: a ação cujo fluxo é executado. A lista mostra todas as Actions com fluxo de ações. Uma ação sem fluxo aparece como "(sem fluxo)". Escolher outra raiz reabre a página para ela.
  • Eventos discretos / Monte Carlo: o modo. Alternar mantém os ajustes de cada modo.
  • Cabeçalho da página: Resultados salvos ▾ (as execuções salvas, ou "Ainda não há execuções salvas. Cada execução concluída é salva aqui.") e Abrir Diagrama de Action.

Ajustes

Ajustes mostra ou oculta os ajustes de execução sob a barra (ocultos de início; a escolha é lembrada neste navegador). A dica dele lista os ajustes atuais, por exemplo "decisões automáticas, velocidade 100×, durações fixas, semente 42".

AjusteModoValoresPadrão
ExecuçõesMonte Carlo1 a 20.000100
DecisõesEventos discretosAutomático (quando não há script), Perguntar (quando não há script)Automático (quando não há script)
VelocidadeEventos discretos1×, 10×, 100×, 1.000×, 10.000×, 100.000× (segundos simulados por segundo real)100×
Variar durações fixasAmbos (guardados separadamente por modo)Nenhuma, Uniforme ±%, Triangular ±%Nenhum
± %Ambos0 a 10010
Semente aleatóriaAmbosUm número, ou em branco para aleatórioem branco
Datas do calendárioEventos discretosIniciar o relógio na data de Início da Action raiz; Actions com Início esperam por eladesativadas
Iniciar pausado (passo a passo)Eventos discretosCria a execução quando a página abre, pronta para ⏭ Passodesativadas
  • Os ajustes são salvos com a ação raiz no projeto à medida que você os altera e valem para todos que a abrirem. Cada alteração pode ser revertida com um único Desfazer. Eles também ficam lembrados neste navegador para outras ações raiz.
  • Restaurar padrões (depois de "Os ajustes são salvos com esta Action.") restaura os padrões e limpa as escolhas de entidades dos gráficos.
  • Leitores podem alterar os ajustes das próprias execuções; eles não são salvos no projeto.

Controles de Eventos discretos

  • ▶ Reproduzir / ⏸ Pausar: animam a execução na velocidade escolhida. Trechos longos sem eventos são pulados de uma vez.
  • ⏭ Passo: avança até o próximo evento.
  • ⏩ Executar até o fim: executa até o fim sem animação. Ainda para nas perguntas.
  • ⟲ Redefinir: descarta a execução.
  • Relógio: o tempo simulado atual (uma data e hora em Datas do calendário).

Controles de Monte Carlo

  • ▶ Executar Monte Carlo, Cancelar, a barra de progresso e o texto de progresso.
  • Verificar em relação ao requisito… (habilitado depois de um estudo com execuções concluídas).
  • Qualquer execução pode ser reproduzida novamente ou baixada como cronograma do MS Project pela aba Execuções.

Notas acima dos painéis

Avisos que requerem atenção, como a visualização de resultados salvos, continuam visíveis com os ajustes ocultos.

  • "Variação uniforme de ±n% adicionada às durações fixas." (ou triangular) quando a variação está ativada.
  • "Probabilidades iguais usadas para n construções não especificadas: …" depois de Usar probabilidades iguais.
  • A caixa de execuções com falha (Monte Carlo) e o banner de reprodução "Reproduzindo a execução n do Monte Carlo (deadlock ou erro) com a semente s e os ajustes do estudo."

Painéis

Os resultados ficam em um layout fixo: uma faixa de resumo no topo e abas abaixo dela. Cada aba tem duas colunas de painéis; os painéis largos (o diagrama, o Gantt, o registro de eventos, Estatísticas e Execuções) ocupam as duas. Antes de uma execução, cada painel mostra a sua descrição. A aba aberta fica lembrada neste navegador.

Menu do painel

Cada painel tem um título e um único menu ⋯:

  • Baixar dados… abre a caixa de diálogo Exportar com os dados do painel: arquivos CSV com todas as colunas e, para Ações ao longo do tempo, também Cronograma (MS Project XML). O nome do arquivo é "<raiz> <título do painel>".
  • Baixar imagem… abre a caixa de diálogo Exportar com <título do painel> (PNG) (com Fundo transparente e Escala) e <título do painel> (SVG). As imagens usam as cores do tema claro.
  • Escolher entidades… (gráficos de custo, de recursos e de assets) abre Escolher entidades: filtre a lista por nome ou número, marque entidades (Todas, Nenhuma) e clique em Aplicar. Sem nenhuma marcada, o gráfico mostra todas as entidades. Os gráficos de custo acrescentam Mostrar o total. As cores seguem a paleta do gráfico na ordem da lista. A escolha é salva com a ação raiz.

Clique em uma entidade em um gráfico, na lista de Status ou no Registro de eventos para abri-la no inspetor, com quantas vezes ela rodou e por quanto tempo.

Abas de Eventos discretos

Faixa de resumo: Status, Tempo total e Custo total.

AbaPainelMostraDados
—StatusAs ações em execução agora, com o progresso. Amarelo: esperando um Input/Output; roxo: um Resource; laranja: capacidade de Asset. No fim: 100% concluído, Deadlock ou Interrompido, com o número de execuções de ações e o tempo total—
—Tempo totalO relógio da simulação (uma data em Datas do calendário, com o tempo decorrido)—
—Custo totalO custo total acumulado e o número de entidades com custo—
Linha do tempoDiagrama de Action durante a execuçãoO Diagrama de Action raiz, somente leitura, com as ações coloridas conforme rodam (verde), esperam (laranja) e terminam (cinza)—
Linha do tempoAções ao longo do tempoUm Gantt das ações executadas; as partes hachuradas são esperas; as ações decompostas são colchetes que você clica para recolher (▸/▾); execuções repetidas são numeradas #2, #3; barras vermelhas foram interrompidas por um tempo esgotado de SYNC; uma linha tracejada vermelha marca o relógio. Ferramentas: +, − (zoom), Redefinir, Ocultar setas das linhas / Mostrar setas das linhas, Ocultar cores das linhas / Mostrar cores das linhasLinha do tempo (CSV), Cronograma (MS Project XML)
CustoCusto ao longo do tempoCusto acumulado por entidade escolhida, mais o totalCusto ao longo do tempo (CSV)
CustoCusto por entidadeCusto total por entidade escolhida (gráfico de barras)Custo por item (CSV)
ResourcesNíveis de recursos ao longo do tempoQuantidades dos Resources escolhidos ao longo do tempoNíveis de recursos ao longo do tempo (CSV)
ResourcesQuantidades de recursosInicial, Mínimo, Máximo, Final, Consumido e Produzido por ResourceAlterações de recursos (CSV)
ResourcesTempo ocupado do AssetOcupado (%) por Asset executor, e unidades em uso (ou ações em execução) ao longo do tempoUso de assets (CSV)
RegistroConsoleSaída de print(), erros de script (com números de linha), avisos e deadlocksConsole (CSV)
RegistroRegistro de eventosTodos os eventos do motor: start, end, wait, resume, io, transfer, resource, decision, loop, exit, sync, killed, cost, deadlock, errorRegistro de eventos (CSV)
RegistroVariáveis de scriptGlobais de script (globals.put) com o valor atual; expanda um valor para ver o histórico deleValores globais (CSV)

Enquanto uma execução é reproduzida, só a faixa de resumo e a aba aberta são redesenhadas; as outras abas se atualizam quando você as abre ou quando a execução termina.

Abas de Monte Carlo

Faixa de resumo: Execuções concluídas.

AbaPainelMostraDados
—Execuções concluídasSimulações concluídas; média e desvio padrão da duração e do custo. As execuções com deadlock ou erro são contadas à parte e excluídasResumo do Monte Carlo (CSV)
DistribuiçãoEstatísticasMédia, IC de 95% da média, desvio padrão, mínimo, P5, mediana (P50), P95 e máximo da duração, do custo e de cada global numérica de script (somente execuções concluídas)—
DistribuiçãoDistribuição da duraçãoHistograma da duração total por execuçãoDurações das execuções (CSV)
DistribuiçãoDistribuição do custoHistograma do custo total por execução ("Nenhuma execução teve custos." sem custos)Custos das execuções (CSV)
DistribuiçãoProbabilidade acumulada (curva S)A distribuição acumulada de uma saída escolhida, com um campo x e a leitura P(X ≤ x)—
FatoresTempo por ActionDurações combinadas das ações em todas as execuçõesDurações das ações (CSV)
FatoresCusto por ActionCusto combinado por ação ou asset em todas as execuçõesCustos das ações (CSV)
FatoresCombinações de ramosCada combinação de ramos de OR, com Execuções e ParticipaçãoCombinações de ramos (CSV)
ResourcesNíveis de recursosQuantidade mínima, máxima e final média por ResourceRecursos entre execuções (CSV)
ResourcesTempo ocupado do AssetOcupado (%) médio por Asset executor (um gráfico de barras com menos de três assets)Uso de assets entre execuções (CSV)
ExecuçõesExecuçõesTodas as execuções com Execução, Semente, Resultado (Concluída, Deadlock, Erro), Duração e Custo. Clique no cabeçalho de uma coluna para ordenar (de novo para inverter). P10, P50 e P90 escolhem a execução nesse ponto da distribuição da duração e a destacam. Reproduzir novamente executa uma delas de novo no modo Eventos discretos com a semente dela; MS Project a baixa como cronograma MS Project XML, "<raiz> execução <n>.xml". As primeiras 500 execuções são listadasExecuções (CSV) (todas as execuções: semente, resultado, duração, custo, caminho, globais)

As mensagens de console de cada execução não são guardadas em um estudo; use Reproduzir novamente em uma execução para vê-las.

Scripts

Scripts são ganchos em JavaScript em Actions, ORs, SYNCs e LOOPs. Use-os quando o diagrama sozinho não consegue expressar um comportamento, como uma decisão baseada no nível de um recurso.

Para escrever um script:

  1. No Diagrama de Action, selecione o elemento.
  2. No inspetor, clique em Editar script… (para uma ação), ou em Editar script… / Adicionar script… nos painéis OR, SYNC e LOOP.

    A caixa de diálogo do editor abre, por exemplo Script: Capture Image Strip ou Script de OR: ….

  3. Clique em Adicionar onStart(), Adicionar prompt(), Adicionar onEnd() ou Adicionar duration() para inserir um gancho vazio.
  4. Escreva o código. Tab insere dois espaços.
  5. Clique em Salvar (ou Cancelar).

Ganchos

GanchoChamadoValor de retorno
onStart()Quando a ação ou a construção começa—
prompt(p)Depois de onStart, para montar uma caixa de diálogo de entrada— (preencha p)
onEnd(response)Quando uma ação termina; para um OR, quando ele decide; para um LOOP, antes de cada passagemOR: o nome ou o índice do ramo. LOOP: true para continuar, false para parar, ou um número de passagens adicionais
duration()Quando a Duração da ação é =script()A duração na unidade da Duração

response contém as respostas da caixa de diálogo de perguntas, indexadas pelo nome da entrada.

Com Automático (quando não há script), e no Monte Carlo, a pergunta não é mostrada. Os valores padrão são usados no lugar: o valor de um número ou 0, o valor de uma caixa de seleção ou a primeira opção.

Construtor de perguntas

  • p.setTitle(text): o título da caixa de diálogo (padrão "Entrada para <nome>").
  • p.addEnumInput(title, name, choices, default): uma lista de opções.
  • p.addTextInput(title, name, default), p.addBigtitleTextInput(title, name, default) (várias linhas), p.addNumberInput(title, name, default), p.addBooleanInput(title, name, default) (caixa de seleção).

A caixa de diálogo diz "Simulação pausada em <tempo>." e fecha com OK.

Disponível nos scripts

  • print(x, …): escreve no Console. Objetos são impressos como JSON.
  • globals.put(key, value), globals.get(key): valores acompanhados ao longo do tempo em Variáveis de script. As globais numéricas viram saídas do Monte Carlo (Global: key) em Estatísticas, na curva S e em Verificar em relação ao requisito….
  • Sim.getEntityById(id), Sim.getEntityByGlobalId(id), Sim.getEntityByName(name), Sim.getEntityByNumber(number), Sim.getEntitiesByName(name), Sim.getEntitiesByNumber(number): retornam invólucros de entidade.
    • Propriedades: id, name, number, description, className.
    • Métodos: getId(), getGlobalId(), getName(), getNumber(), getDescription(), getAttribute(name) (pelo nome do atributo, sem distinção de maiúsculas) e attributes().get(name).
  • Sim.getIOValueById(id), Sim.getIOValueByGlobalId(id), Sim.getIOValueByName(name), Sim.getIOValueByNumber(number): o atributo Valor de um Input/Output.
  • Sim.getAmount(name), Sim.getAmountById(id), Sim.getAmountByGlobalId(id): a quantidade atual de um Resource. Sim.getResourceByName(name) retorna {id, name, amount, units}.
  • Sim.setResourceById(id, value), Sim.setResourceByGlobalId(id, value), Sim.setResourceByName(name, value): definem a quantidade de um Resource (registrado como alteração por Script).
  • Sim.getCurrentTime() (milissegundos desde o início) e Sim.getCurrentCost().

Cada script é compilado uma vez por execução, então as variáveis de nível superior mantêm os valores entre as passagens de um loop. O modelo é somente leitura para os scripts, exceto as quantidades de recursos.

Exemplo: decidir um ramo pela carga da bateria

function onEnd() {
  const wh = Sim.getAmount('Battery Charge');
  globals.put('Battery at decision', wh);
  return wh > 40 ? 'Yes' : 'No';
}

Coloque isto no OR Contact in view? com Tipo de decisão Script. Os nomes dos ramos devem ser Yes e No.

Sandbox e confiança

  • Cada execução roda em uma sandbox separada com uma cópia somente leitura do modelo. Os scripts não têm acesso à página, a outros projetos, a arquivos, ao armazenamento do navegador nem à rede.
  • Uma chamada de script que roda por mais de 8 segundos interrompe a execução: "O script de <nome> rodou por mais de 8 s e foi interrompido. Verifique se há um loop infinito."
  • Os scripts que você escreve ou aprova neste navegador são confiáveis.

Uma execução pode incluir scripts de outra origem, como um arquivo importado ou as edições de outro membro. Antes de uma execução assim, o Holarch pede que você os aprove. A pergunta aparece antes de ▶ Reproduzir, ⏭ Passo, ⏩ Executar até o fim e ▶ Executar Monte Carlo.

  1. Inicie a execução.

    A caixa de diálogo Executar scripts de outro autor? informa quantos scripts existem. Ela diz que os scripts rodam em uma sandbox sem acesso aos seus projetos, arquivos ou à rede.

  2. Abra Mostrar os scripts para revisá-los.
  3. Clique em Executar scripts para executá-los, ou em Cancelar.

Depois que você clica em Executar scripts, esses scripts passam a ser confiáveis neste navegador.

Teclado e mouse

AçãoEfeito
Clicar em uma barra do Gantt, em um ponto de gráfico, em uma célula do mapa de árvore ou em uma linha de statusAbre a entidade no inspetor
Clicar no rótulo de uma linha decomposta do GanttRecolhe ou expande os filhos dela
Tab no editor de scriptsInsere dois espaços

Mensagens

MensagemSignificado e correção
"Nenhuma Action para simular" / "Dê a uma Action Actions filhas e desenhe o fluxo delas no Diagrama de Action dela."O projeto não tem nenhuma Action com fluxo
"Erro de simulação" com detalhesA execução não pôde começar ou a sandbox falhou; leia os detalhes
"A Action raiz não existe mais. Escolha outra Action raiz."A raiz foi excluída
"Erro de script em <nome> (<gancho>): <mensagem>"Um script lançou um erro; a execução para. O Console mostra o número da linha
"<nome>: o script retornou "x", que não corresponde a nenhum ramo; escolhido ao acaso."Um script de OR retornou um nome de ramo desconhecido
"<nome>: mais de 10000 iterações — verifique a condição do LOOP."Um LOOP nunca para
Loops que nunca terminam (antes de uma execução)Nenhum EXIT consegue terminar um loop que se repete a 100 % (Action.19). Corrija-o, ou use Executar mesmo assim.
"Existe uma hierarquia infinita (A → B → A). Remova um destes vínculos de decomposição no diagrama."Uma ação está decomposta em si mesma
"Simulação abortada: passos demais (verifique as contagens de LOOP ou uma decomposição recursiva)."Mais de 20.000 execuções de ações em uma execução
"Simulação abortada: limite de eventos atingido."Mais de 500.000 eventos em uma execução
"Deadlock: <ação> esperando o I/O <nome> (nunca gerado)"Um I/O de gatilho nunca foi gerado
"Deadlock: <ação> esperando <quantidade> <recurso> (nunca disponível)" / "esperando capacidade de Asset: …"Um recurso ou uma capacidade nunca ficou disponível
"O Asset <nome> tem mais de um pai; usando o primeiro para a capacidade dele."A capacidade do asset vem da Multiplicidade do primeiro pai
"<I/O> é transportado por vários Conduits; o simulador usou <conduit>."Só o atraso do primeiro Conduit se aplica
"Os scripts de simulação não têm acesso à rede (Sim.httpGet, httpPost e httpPut não estão disponíveis)."Os scripts não podem acessar a rede
"Nenhuma entidade encontrada com o nome: <nome>" / "Nenhum recurso encontrado com o id: <id>"Uma busca de Sim não encontrou nada
"Os scripts de simulação não podem compilar código em tempo de execução." / "Os scripts de simulação não podem usar import()."Um script tentou criar ou carregar código
"O script de <nome> rodou por mais de 8 s e foi interrompido. Verifique se há um loop infinito."Watchdog de scripts
"A simulação parou de responder e foi interrompida."A sandbox parou de responder fora de um script
"Execução do Monte Carlo interrompida"Você clicou em Cancelar
"n de N execuções falharam (d em deadlock, e com erro). P(falha) = …"As execuções com falha são excluídas das estatísticas; use Ver execução
"Nenhuma execução concluída. Execute o Monte Carlo primeiro."Verificar em relação ao requisito… precisa de execuções concluídas
"Digite um valor de limite ou escolha uma Measure." / "Digite primeiro um valor de limite."A checagem não tem valor
"<Measure> não tem um Threshold Value numérico. Digite o limite."O limite ou o objetivo da Measure não é um número
"Escolha uma Measure ou um Requirement para registrar o resultado."Registrar resultado… precisa de um alvo
"Selecione pelo menos uma alteração."Todas as linhas de Registrar resultado estão desmarcadas
"Resultado registrado"A Measure e o Test Case foram atualizados
"A probabilidade exigida está dentro do intervalo de confiança. Execute mais iterações para um veredito mais firme."O veredito pode mudar com mais execuções
"Não foi possível ler os resultados salvos: <motivo>. Execute a simulação novamente."O arquivo .sim salvo está ausente ou é inválido; clique em Executar novamente
"Este painel é do outro modo de simulação."Um painel do outro modo
"Somente visualização: peça acesso de edição a um proprietário."Leitores podem executar simulações, mas não podem salvar ajustes, resultados nem checagens registradas

Limites

  • Monte Carlo: de 1 a 20.000 iterações por estudo.
  • Uma execução: no máximo 20.000 execuções de ações, 500.000 eventos e 10.000 passagens de um LOOP.
  • Chamadas de script: 8 segundos cada.
  • Tabela de execuções com falha: as primeiras 50 execuções com falha são listadas. Execuções ⋯ → Baixar dados… → Execuções (CSV) lista todas as execuções.
  • Aba Execuções: as primeiras 500 execuções são listadas; Execuções (CSV) tem todas.
  • As estatísticas do Monte Carlo usam somente execuções concluídas.
  • Só o primeiro Conduit que transfere um I/O define o atraso dele; só o primeiro pai define a capacidade de um asset.