Holarch

SysML v2

Primeiros passos com projetos SysML v2

Escolha entre um projeto LML e um projeto SysML v2, crie um projeto SysML v2 ou uma demonstração, escreva um primeiro modelo e oriente-se.

Como usá-lo →

Nesta página
  1. Visão geral
  2. Conceitos
    1. Dois tipos de projeto
    2. O modelo e o texto são um só
    3. Dados do modelo e dados do Holarch
    4. Definições e usos
  3. Como usá-lo
    1. Escolher um tipo de projeto
    2. Criar um projeto SysML v2
    3. Abrir a demonstração Hybrid Car
    4. Abrir a demonstração Hybrid Car Battery Pack
    5. Abrir a demonstração Earth Observation Satellite
    6. Escrever seu primeiro modelo
    7. Orientar-se
  4. Exemplo prático: explorar o Hybrid Car
  5. Dicas e erros comuns
  6. A barra lateral em projetos SysML v2
  7. Modo simples
    1. Ativá-lo ou desativá-lo
    2. O que mostra
    3. Mostrar tudo
  8. Início
  9. Perguntar à IA
  10. Ainda não disponível
  11. Mensagens
  12. Limites
  13. Páginas relacionadas

Visão geral

O Holarch suporta projetos SysML v2. Um projeto SysML v2 contém um modelo, escrito na notação textual SysML v2 e baseado na especificação OMG SysML v2.

Você escreve o modelo como texto no Editor. O Holarch mantém o mesmo modelo como elementos: pacotes, definições, usos e relacionamentos. O Navegador, as vistas e as páginas do ciclo de vida (requisitos, verificação, interfaces, riscos, planejamento) mostram todos esses mesmos elementos.

Esta página explica os dois tipos de projeto, como iniciar um projeto SysML v2 e onde ficam as coisas. A linguagem em si está em Notação textual SysML v2. O Editor e o Navegador estão em O Editor de texto e o Navegador.

Conceitos

Dois tipos de projeto

Todo projeto do Holarch é um projeto LML ou um projeto SysML v2. Você escolhe o tipo ao criar o projeto. Ele permanece fixo: um projeto muda de tipo apenas por meio de uma cópia convertida (consulte Conversão entre LML e SysML v2).

LMLSysML v2
Para que serveModelar um sistema na Lifecycle Modeling Language: requisitos, funções, a arquitetura física, interfaces, testes, riscos e o cronograma. O Holarch confere seu trabalho a cada etapa.Construir um modelo na linguagem SysML v2, como texto, com os conceitos padrão do SysML v2: pacotes, definições e usos, portas, conexões, ações, estados e requisitos.
Como você constrói o modeloO Banco de dados, formulários e mais de 30 tipos de diagrama.Texto no Editor, além das vistas e das páginas do ciclo de vida, que escrevem no mesmo texto.
O que você pode trocarImportações de Word, Excel, CSV, ReqIF e XMI; exportações de Word, Excel e diagramas; arquivos de projeto.Texto SysML v2 (.sysml) e SysML v2 JSON (consulte Troca de modelos SysML v2); importações de SysML v1 a partir de XMI e de arquivos .mdzip do Cameo ou MagicDraw (consulte Importação de modelos SysML v1); arquivos de projeto.

Se estiver em dúvida, escolha LML. Ele tem todas as páginas e diagramas do Holarch e é adequado para quem está começando em MBSE. Escolha SysML v2 quando sua equipe já modela em SysML v2 ou troca modelos com ferramentas SysML v2.

O modelo e o texto são um só

Um projeto SysML v2 não tem arquivos dentro dele. O modelo é um conjunto de elementos, e o Editor mostra um documento de texto por pacote de nível superior. Quando o texto é analisado sem erros, o Holarch o aplica ao modelo. Quando você altera o modelo em outro lugar (uma vista, uma tabela, o inspetor), o texto muda junto. Consulte Texto e vistas ficam sincronizados.

Dados do modelo e dados do Holarch

Algumas informações fazem parte do texto SysML; outras são mantidas pelo Holarch ao lado do modelo.

  • No texto: nomes de elementos, nomes curtos (números de requisitos), documentação, tipos, multiplicidades, valores e relacionamentos como satisfy, verify, perform e connect.
  • Ao lado do modelo (dados do Holarch): status e aprovações de requisitos, resultados de verificação, rótulos, responsáveis, prazos, comentários de discussão, layouts de vistas, ajustes do simulador, orçamentos, riscos, decisões e tarefas. Eles se vinculam aos elementos do modelo pela identidade, então os vínculos sobrevivem a renomeações e movimentos.

Os dados do Holarch não são escritos no texto SysML e não fazem parte de uma exportação .sysml.

Definições e usos

A maioria das palavras-chave do SysML v2 vem em duas formas. Uma definição (part def Wheel;) descreve um tipo de coisa. Um uso (part frontWheel : Wheel;) é um uso de uma definição dentro de outro elemento. O mesmo padrão vale para port def/port, action def/action e requirement def/requirement. Notação textual SysML v2 explica isso por completo.

Como usá-lo

Escolher um tipo de projeto

Decida o tipo antes de criar o projeto.

  1. Escolha LML para usar o método completo do Holarch: o Banco de dados, os diagramas LML e checagens guiadas a cada etapa.
  2. Escolha SysML v2 quando o modelo precisa ser texto SysML v2, por exemplo para trocá-lo com outra ferramenta SysML v2.
  3. Para experimentar o SysML v2 primeiro, abra a demonstração Hybrid Car (o fluxo de trabalho depois do próximo) em vez de um projeto em branco.

Criar um projeto SysML v2

  1. Abra Gerenciar projetos e clique em + Novo projeto.
  2. Em Como você vai modelar este sistema?, escolha SysML v2.
  3. Digite um nome e clique em Criar projeto.

O projeto abre em Início. O chip SysML v2 aparece ao lado do nome do projeto na barra superior e em Gerenciar projetos. Um modelo novo está vazio: Próximas ações em Início diz Escreva o primeiro pacote no Editor.

Abrir a demonstração Hybrid Car

A demonstração Hybrid Car é um modelo SysML v2 pronto para explorar e editar.

  1. Abra Gerenciar projetos.
  2. Clique em Arquivos de projeto ▾ → Novo projeto de demonstração → Hybrid Car (SysML v2).

O Holarch cria o projeto Hybrid Car (SysML v2 demo) e o abre em Início. Clique em Editor na barra lateral para ler o texto. O modelo tem seis pacotes de nível superior: Vehicles, VehicleRequirements, VehicleBehavior, VehicleViews, HolarchFrameworks e HybridCarArchitecture. Cada um é um documento na lista Pacotes do Editor.

A demonstração é sua própria cópia. Altere-a à vontade ou crie-a de novo para recomeçar.

Para abrir a demonstração a partir de um link, use https://app.holarch.app/#/?demo=hybrid. Ele constrói a demonstração e a abre; no aplicativo hospedado, ela abre depois que você entra.

Abrir a demonstração Hybrid Car Battery Pack

A demonstração Hybrid Car Battery Pack é a bateria de tração do carro como o fornecedor a modela, em um projeto próprio. Com a demonstração Hybrid Car também nos seus projetos, criada antes ou depois dela, três requisitos da bateria são vinculados aos requisitos de bateria do carro (BP-1 a VR-3, BP-2 a VR-6, BP-3 a VR-5), então Gerenciar projetos → Mapa do programa mostra como os dois projetos se conectam. Esses vínculos de demonstração funcionam em todos os planos.

  1. Abra Gerenciar projetos.
  2. Clique em Arquivos de projeto ▾ → Novo projeto de demonstração → Hybrid Car Battery Pack (SysML v2).

O que experimentar:

  • Valores calculados: no Editor, Pack::mass soma os módulos (12 células e um invólucro cada), o sistema de gerenciamento da bateria, a caixa de junção, o resfriamento e o gabinete: 43 kg para um limite de 48 kg, então massMargin é 5 kg. Pack::capacity soma as 120 células: 1,44 kWh para 1,4 kWh. Selecione um atributo para ver seu valor no inspetor.
  • Vista paramétrica: abra packParametrics. As checagens de capacidade, massa, tempo de carga e balanceamento de células estão cada uma ligada aos valores da bateria e passam.
  • RVTM: capacidade e massa estão Aprovados, a aceitação de carga está Reprovado (o teste de carga a quente levou 34 minutos para 30) e o balanceamento de células ainda não foi executado. Cada caso de verificação calcula seu veredito a partir do modelo.
  • Simulador: o Simulador abre em pack junto com Hot Day Charge. Clique em Executar até o fim e depois em Estados: a carga cai para meia potência quando as células superaquecem e é retomada quando elas esfriam. Escolha Cell Over Voltage Fault em Executar junto com para ver um desligamento de proteção e o reset de serviço.

Abrir a demonstração Earth Observation Satellite

A demonstração Earth Observation Satellite é um modelo maior: a missão EO-2, um satélite de imageamento 12U com seu segmento terrestre, em cerca de 3.000 linhas distribuídas em 14 pacotes. Os dados próprios do Holarch são preenchidos sobre o modelo, então toda página tem algo a mostrar.

  1. Abra Gerenciar projetos.
  2. Clique em Arquivos de projeto ▾ → Novo projeto de demonstração → Satélite de observação da Terra (SysML v2).

O Holarch cria o projeto Earth Observation Satellite (SysML v2 demo) e abre Início. A demonstração tem 1.549 itens, mais do que os 1.000 itens por projeto do plano Free: no plano Free, sua entrada de menu fica desativada e diz Requer o plano Individual (1.549 itens). O link https://app.holarch.app/#/?demo=eosat também a constrói. O que experimentar:

  • Documentos: abra EO-2 System Requirements Specification. Suas seções contêm os requisitos de EORequirements, valores vivos e uma matriz de verificação.
  • Orçamentos: a massa do imageador está acima da alocação de 4,0 kg; a TPM Imager Mass mostra a tendência.
  • Vínculos a revisar e TBD/TBR: requisitos alterados e valores em aberto a resolver.
  • Simulador: execute a passagem de imageamento a partir da vista imagingPassFlow.
  • Linhas de base: compare a linha de base PDR Data Freeze com o modelo atual.
  • Vistas: os modos da espaçonave, as vistas de interconexão e a sequência de comandos.

Escrever seu primeiro modelo

Este fluxo de trabalho constrói um pequeno modelo de drone com este texto:

package Drone {
    private import ISQ::*;
    private import SI::*;

    part def Battery {
        attribute mass : MassValue = 0.4 [kg];
    }
    part def Quadcopter {
        part battery : Battery;
    }
}
  1. Abra Modelo → Editor, clique em + Novo package, digite Drone e confirme. O Editor abre o texto do novo pacote.
  2. Digite os imports e os membros dentro das chaves do pacote, como acima.
  3. Pare de digitar. Após uma breve pausa, a linha de status abaixo do texto diz Aplicado. O modelo agora contém o pacote, as duas definições de part, o atributo e a part, e um único Desfazer reverte tudo.
  4. Abra Modelo → Navegador e expanda Drone para ver os mesmos elementos como uma árvore.

Se uma linha tiver um erro, a linha de status diz Não aplicado: corrija a linha N. O modelo mantém seu último estado válido até o texto ser analisado sem erros de novo. Consulte Erros e rascunhos.

Orientar-se

Os projetos SysML v2 mantêm a barra do ciclo de vida do Holarch. Cada grupo trabalha sobre o modelo SysML v2.

  1. Comece em Início para ver o que requer atenção, os grupos do ciclo de vida e as próximas ações.
  2. Use Modelo → Editor para escrever texto e Modelo → Navegador para ver a árvore.
  3. Use Necessidades e requisitos e Verificação para requisitos, casos de verificação e rastreabilidade.
  4. Use Comportamento, Arquitetura e Interfaces para as vistas e as páginas de análise.
  5. Abra a ferramenta Diagramas na parte inferior da barra lateral para ver todas as vistas.
  6. Pressione ⌘K / Ctrl+K para encontrar qualquer elemento por nome, nome curto, nome qualificado (Vehicles::Car) ou texto da documentação.
  7. Novo no SysML v2? Ative o modo simples para ver primeiro os elementos mais usados.

Exemplo prático: explorar o Hybrid Car

Este passo a passo usa a demonstração Hybrid Car.

  1. Crie a demonstração (consulte Abrir a demonstração Hybrid Car). Ela abre em Início. Abra Modelo → Editor e escolha Vehicles na lista Pacotes.
  2. Encontre part def Car. Ela tem as parts body, powertrain, frontAxle, rearAxle e spare : Wheel [0..1].
  3. Clique com ⌘ / Ctrl em Powertrain em part powertrain : Powertrain;. O cursor salta para part def Powertrain, com suas parts tank, engine, motor, battery, transmission e controller, e interfaces como interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;.
  4. Aponte para MassValue em attribute mass : MassValue;. Um cartão mostra seu tipo e seu nome qualificado na biblioteca padrão.
  5. Abra Modelo → Navegador. Digite sedan em Filtrar por nome. A árvore mostra sedan abaixo de fleet em Vehicles. Selecione-o: o inspetor mostra Kind part, Typed by Car e o nome qualificado Vehicles::fleet::sedan.
  6. Abra Início. O cartão de Ciclo de vida de Necessidades e requisitos conta os requisitos do modelo; Requer atenção mostra os vínculos a revisar, os TBDs atrasados e os riscos altos do modelo.
  7. Abra Necessidades e requisitos → Requisitos. As linhas incluem VR-1.1 sedanMass, um uso de requirement cujo número é seu nome curto <'VR-1.1'>.
  8. Abra a ferramenta Diagramas e abra driveCycleFlow, a vista de fluxo de ações de DriveCycle. Renomeie uma ação ali e volte ao Editor: VehicleBehavior mostra o novo nome.

Dicas e erros comuns

  • Comece pela demonstração. Copiar padrões do texto do Hybrid Car é a forma mais rápida de aprender a notação.
  • Importe as unidades. 5 [kg] precisa que SI (e MassValue precisa que ISQ) esteja visível. Adicione private import ISQ::*; e private import SI::*; ao pacote.
  • Mantenha um modelo por projeto. Divida um modelo grande em vários pacotes de nível superior; cada um é seu próprio documento no Editor.
  • Escolher o tipo errado. O tipo não pode ser trocado no próprio projeto. Faça uma cópia convertida em Gerenciar projetos (⋯ → Criar uma cópia LML… ou Criar uma cópia SysML v2…).
  • Esperar o status no texto. Status de requisitos, resultados de verificação e rótulos são dados do Holarch. Eles não aparecem no texto nem em uma exportação .sysml.

A barra lateral em projetos SysML v2

GrupoPáginas
InícioRequer atenção, Ciclo de vida, Próximas ações e os outros painéis de Início
Necessidades e requisitosDocumentos, Requisitos, Qualidade, TBD/TBR, Vínculos a revisar, Aprovações, Matriz de conformidade*
ModeloEditor, Navegador, Importar e exportar
ComportamentoAnálise funcional, Fluxos de ações, FFBD, Máquinas de estados, Sequências, Simulador
ArquiteturaParts, Visões gerais, Visões de interconexão, Hierarquia, Orçamentos e TPMs
InterfacesRegistro de interfaces, ICDs, Diagramas N², Itens e E/S
VerificaçãoRVTM, Casos de verificação, Desvios e dispensas*, Matriz de rastreabilidade, Cobertura do programa, Checagens do modelo
Segurança e confiabilidade†Registro de perigos, FMECA, Árvores de falhas, Diagramas de blocos de confiabilidade
Riscos, problemas e decisõesRegistro de riscos, Diagramas de Risk, Estudos de trade-off, Decisões, Problemas e ações
PlanoMeu trabalho, Processo de SE, Gerenciamento de projetos, Gráficos, Quadros brancos, Apresentações
Controle e revisõesSolicitações de mudança, Linhas de base e versões, Bibliotecas, Revisões, Atividade
FrameworksDoDAF, UAF

* Com o programa formal ativado. † Com o programa de segurança e confiabilidade ativado. Ambos são ligados em Preferências do projeto → Recursos do programa.

As ferramentas na parte inferior da barra lateral são as mesmas dos projetos LML: Banco de dados, Diagramas, Lixeira, Ajustes e Ajuda. Em projetos SysML v2, Ajustes também lista a Biblioteca padrão. As páginas que não se aplicam a projetos SysML v2 não são mostradas.

As páginas são descritas em Vistas SysML v2, Requisitos e verificação em projetos SysML v2, Avaliação, unidades e análise em projetos SysML v2 e Recursos do Holarch em projetos SysML v2.

Modo simples

O modo simples é para quem está começando com SysML v2. Ele mostra os elementos com que a maioria dos modelos começa, explica cada um em uma frase e oculta o restante até que você peça. Ele muda apenas o que você vê: o modelo, seu texto e todas as exportações continuam iguais.

Ativá-lo ou desativá-lo

  • Preferências → SysML v2 → Modo simples.
  • Modo simples no cabeçalho da página de Modelo → Navegador (pressionado enquanto ativo).
  • ⌘K / Ctrl+K → Ativar modo simples ou Desativar modo simples.

Ele vem desativado por padrão. O ajuste pertence à sua conta: acompanha você em qualquer computador em que você entrar, e o ajuste da conta vale quando você entra. Redefinir preferências não o altera.

Na primeira vez que você abre um projeto SysML v2, uma nota abaixo da barra superior diz Novo no SysML v2? Ative o modo simples para ver primeiro os elementos mais usados. Clique em Ativar para ligar o modo simples ou em × para dispensar a nota. Qualquer das respostas fica guardada na sua conta, e a nota não aparece de novo. Enquanto você não responder, ela aparece toda vez que você abre um projeto SysML v2. Ela não aparece quando o modo simples já está ativado.

O que mostra

Doze conceitos, os mais usados pela demonstração Hybrid Car e pelos tutoriais: package, part, attribute, port, connection e interface, action, flow e succession, state, transition, requirement, satisfy e verification.

OndeNo modo simplesOculto até Mostrar tudo
Visão geral, painel AdicionarPacote, Definição de part, Part, Definição de port, Port, Atributo, Definição de interface, Definição de ação, Ação, Definição de requisito, Requisito, Caso de verificaçãoDefinição de atributo, Definição de item, Definição de enumeração
Diagrama Spider, painel AdicionarPacote, Definição de part, Part, Definição de port, Port, Atributo, Definição de ação, Ação, Estado, Definição de requisito, Requisito, Caso de verificaçãoDefinição de item, Item, Definição de atributo, Caso de uso
Visão de interconexão, painel AdicionarPart, PortItem
Visão de transição de estados, painel AdicionarEstado inicial, Estado final, Estado, Ação de entrada, Ação do, Ação de saídaEstado paralelo, Região
Visão de fluxo de ações, painel Adicionar e + Action ▾Ação, Bifurcação, Junção, Decisão, Mesclagem, RaiaAceitar, Enviar, Laço, Encerrar
Editor, Inserir ▾Pacote, Definição de part, Part, Atributo, Definição de port, Port, Interface, Conexão, Definição de ação, Ação, Sucessão, Fluxo, Definição de estado, Estado, Estado inicial, Transição, Definição de requisito, Requisito, Satisfazer, Definição de verificação, VerificarTodos os outros trechos que cabem na posição do cursor
Modelo → NavegadorPacotes, definições, usos, conexões, fluxos, transições, requisitos, satisfy e verifyImports, aliases, exposes, comentários, documentação, metadados, pacotes de biblioteca, binding connectors, elementos do nível KerML, e as linhas de gatilho e efeito de uma transição

Aponte para um item de um painel Adicionar, ou para o tipo de uma linha no Navegador, para ler uma explicação de uma frase sobre esse elemento.

As Visões de requisitos, de casos de uso, paramétrica, de sequência, de packages e de geometria e os painéis Hierarquia, Árvore, IDEF0 e FFBD mantêm todos os seus itens: cada um deles trata do tipo que adiciona. + Novo diagrama, as tabelas, a pesquisa, o inspetor e a digitação no Editor (com o preenchimento automático) não são filtrados.

Mostrar tudo

  • Painéis Adicionar: Mostrar tudo (n a mais) abaixo dos itens; Mostrar menos volta a ocultá-los.
  • + Action ▾: Mostrar tudo… no fim reabre o menu com todos os tipos.
  • Inserir ▾: marque Mostrar tudo no cabeçalho.
  • Navegador: marque Mostrar tudo na barra de filtros.

Mostrar tudo dura até você recarregar a página ou mudar o modo simples, e o modo simples continua ativo nesse meio-tempo. No Navegador, um elemento que você abre a partir de outro lugar (por exemplo, Mostrar no Navegador no inspetor) é sempre mostrado, junto com seus proprietários, mesmo quando seu tipo está oculto.

Início

Início é a mesma página dos projetos LML (consulte Início): Requer atenção (vínculos a revisar, TBDs atrasados, testes com falha, violações de TPM, riscos altos, checagens do modelo, status do salvamento), um cartão Ciclo de vida por grupo da barra lateral e os painéis como Próximas ações, Gate do Processo de SE e Marcos. As contagens vêm do modelo SysML v2 e dos dados do Holarch ao lado dele. ✦ Escrever resumo do projeto não é oferecido em projetos SysML v2.

  • Os grupos da barra lateral mostram os mesmos selos de problemas, e a página de visão geral de cada grupo lista o que requer atenção e seus números.
  • + Adicionar painel → Conteúdo do modelo mostra Packages (com o número de pacotes de nível superior), Definições, Usos, Relacionamentos e Requisitos (n não satisfeitos · n não verificados), elementos fora do lugar quando elementos perderam seu proprietário, e Alterações recentes: as últimas alterações do modelo (criados, alterados, movidos, excluídos ou restaurados) com o tipo do elemento e o horário.

Perguntar à IA

Perguntar à IA responde a perguntas sobre a linguagem SysML v2 e sobre o uso do Holarch, a partir da Ajuda e das Docs. Nos planos Individual e Team, e com sua própria chave de IA ou a da sua organização, ela também responde a perguntas sobre o modelo aberto e propõe alterações, que abrem para revisão antes de serem aplicadas. Consulte Perguntar à IA.

Ainda não disponível

  • Commits em main, tags e merges pela Systems Modeling API: outras ferramentas fazem commit em branches de solicitações de mudança, que um aprovador aplica no Holarch (consulte A API e o MCP em projetos SysML v2).
  • Editar a linguagem: a biblioteca padrão é somente leitura.

Notação textual SysML v2 lista em detalhes a linguagem suportada.

Mensagens

MensagemSignificado
O modelo está vazioO projeto não tem elementos. Clique em + Novo package e escreva seus membros no Editor.
Não aplicado: corrija a linha N.O texto tem um erro na linha N. O modelo mantém seu último estado válido até que o texto seja analisado sem erros.
Somente visualização: peça acesso de edição a um proprietário.Você tem acesso de visualização ao projeto. O texto e as páginas são somente leitura.
Este projeto precisa de um Holarch mais novo.Uma versão mais nova do Holarch salvou o projeto, e esta página é mais antiga. O projeto abre somente para visualização, e o banner no topo explica o motivo. Clique em Recarregar no banner para obter a nova versão.

Limites

  • O tipo de projeto é fixado na criação.
  • Um modelo por projeto.
  • Um documento de texto maior que 8 MB não é checado; divida-o em vários pacotes.

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