Holarch

Para desenvolvedores

Holarch Language Engine

Um engine de linguagem para SysML v2 e KerML, disponível para licenciamento.

O engine por trás dos projetos SysML v2 do Holarch, para o seu próprio produto. Ele faz o parsing, resolve, checa e avalia texto SysML v2 e KerML, e roda no navegador como WebAssembly ou no seu servidor.

O Holarch Language Engine em ação: um erro de unidades aparece enquanto um valor é digitado e some quando é corrigido, ir para a definição salta para uma definição de parte em outro pacote, e um modelo de 250.000 linhas é checado pela linha de comando, com o código do diagnóstico e o tempo decorrido

Para quem é

Equipes que querem texto SysML v2 em seu próprio produto sem escrever e manter uma implementação da linguagem.

Fornecedores de ferramentas

Adicione edição, checagem e importação de SysML v2 a uma ferramenta de modelagem, diagramação ou arquitetura.

Produtos de PLM, requisitos e simulação

Leia modelos SysML v2, acompanhe requisitos e valores com unidades e troque modelos com outras ferramentas.

Equipes internas de ferramentas de engenharia

Cheque modelos em pipelines de revisão, gere relatórios e ofereça aos engenheiros um editor SysML v2 dentro das ferramentas da empresa.

O que ele faz

Um único engine para todo o caminho do texto a um modelo checado, com JSON na entrada e JSON na saída.

Parsing

Notação textual SysML v2 e KerML, com recuperação de erros: um erro não esconde o resto do arquivo. A biblioteca padrão é carregada com o engine.

Resolução

Nomes, imports, aliases, especialização, tipagem e redefinição entre pacotes e arquivos, com hover, ir para a definição, autocompletar e renomear.

Checagem

135 códigos de diagnóstico, cada um com uma gravidade, um intervalo exato, uma mensagem e uma correção sugerida que o seu editor pode oferecer como correção rápida.

Avaliação

Expressões com unidades e grandezas, como body + 4 * 12 [kg] para 348 [kg], e restrições de requisitos e casos de verificação. Os limiares dos requisitos e os objetivos que eles visam são lidos do modelo.

Reanálise enquanto você digita

As sessões de documento refazem o parsing só da parte alterada e enviam deltas de tokens, de modo que os editores continuam responsivos em modelos grandes.

Edite o texto sem perder a formatação

As mudanças vindas de um diagrama ou formulário são gravadas de volta no texto. O texto inalterado, os comentários e o layout ficam exatamente como o usuário os escreveu.

Diff, merge e rebase

Compare duas versões de um modelo como uma lista de mudanças, aplique-as e faça rebase de uma edição de texto sobre mudanças mais recentes no modelo.

Variantes

Pontos de variação, variantes e configurações são checados, e cada combinação de variantes pode ser listada e julgada em relação às restrições do modelo.

Simulação (complemento)

Execute fluxos de ações e máquinas de estados em tempo simulado, como execuções únicas, passo a passo com entradas do seu produto, ou como estudos de Monte Carlo. A mesma semente dá a mesma resposta no navegador e no servidor.

Intercâmbio JSON

Importe e exporte SysML v2 JSON e leia o modelo como registros simples com ids estáveis. O texto pode trazer o id de cada elemento, de modo que um texto editado e lido de volta mantém a identidade de cada elemento em renomeações e movimentações.

Comprovado no Holarch

O mesmo engine executa cada projeto SysML v2 no Holarch: o editor, as visões e as páginas do ciclo de vida.

Complementos

O engine checa, analisa e edita modelos por conta própria. Três complementos o estendem, cada um licenciado separadamente e ativado pelo seu token de licença, sem rebuild e sem mudança de código.

Simulação

Execute fluxos de ações e máquinas de estados em tempo simulado: execuções únicas, passo a passo com entradas do seu produto, ou estudos de Monte Carlo. A mesma semente dá a mesma resposta no navegador e no servidor. Modelos com anotações de simulação são checados sem ele.

Migração de SysML v1 para SysML v2

Converta um modelo SysML v1 em texto SysML v2 checado, com um relatório sobre cada elemento: convertido, aproximado ou descartado. Como funciona o complemento de migração.

Uso em servidor

Execute o engine fora de uma página do navegador: Node.js, Deno, funções serverless ou a extensão Python. Cheque modelos em pipelines de build, converta-os em lotes ou responda a requisições do seu próprio serviço.

Complemento: migração de SysML v1 para SysML v2

O complemento de migração converte um modelo SysML v1 em texto SysML v2, com base na transformação de SysML v1 para SysML v2 da especificação OMG SysML 2.0. Ele é o conversor por trás da importação de SysML v1 do Holarch, licenciado separadamente do engine.

  • Entrada: um modelo SysML v1 como JSON, em uma forma neutra que a referência da API documenta. O seu produto lê o arquivo XMI (do Cameo ou MagicDraw, Enterprise Architect, Rhapsody ou Papyrus) e envia o modelo; o engine não lê XML nem arquivos.
  • Saída: texto SysML v2, a checagem desse texto pelo engine e um relatório que lista cada elemento como convertido, aproximado ou descartado, com um código de motivo estável e o nome SysML v2 que ele recebeu.
  • Repetível: o mesmo modelo é convertido no mesmo texto todas as vezes.
  • Limitado: modelos de até 250.000 elementos e 8 MiB de texto; um modelo maior recebe uma resposta de erro, nunca um travamento.

A requisição é v1_convert na referência da API. Sem o complemento, o engine responde a ela com feature-not-licensed, e todas as outras requisições funcionam normalmente.

Uma requisição e sua resposta

// Request (the model shortened)
{ "op": "v1_convert",
  "model": { "format": "holarch-xmi-model", … } }

// Answer (shortened)
{ "text": "package 'Rover Model' { … }",
  "diagnostics": [],
  "report": {
    "summary": { "elements": 31, "converted": 27,
                 "approximated": 2, "dropped": 2 },
    "items": [ { "kind": "Association",
                 "status": "dropped",
                 "reason": "association" }, … ] } }

Um pequeno modelo de teste convertido pelo engine: 31 elementos, nenhum diagnóstico no texto convertido.

Como ele roda

No navegador, o engine é um módulo WebAssembly em um Web Worker, então a análise nunca bloqueia a página. Uma pequena camada de integração em JavaScript envia requisições e retorna as respostas como promises. Um build de servidor para Node.js ou Python está disponível sob solicitação.

How the engine fits into a browser applicationYour application calls the JavaScript integration layer with JSON requests. The layer passes them to a Web Worker that runs the WebAssembly engine with the standard library loaded, and returns JSON answers. The engine has no network or file access. Your application editor, views, pipeline JavaScript integration layer requests as promises WEB WORKER Holarch Language Engine WebAssembly, no network or file access Standard library JSON

Uma requisição e sua resposta

// Request
{ "op": "analyze",
  "text": "package P { part a : Engine; part b }" }

// Answer (tokens left out)
{ "diagnostics": [
    { "code": "syntax.expected-token",
      "args": { "expected": ";", "found": "}" },
      "range": { "from": 35, "to": 35 },
      "severity": "error" },
    { "code": "name.unresolved",
      "args": { "name": "Engine" },
      "field": "typedBy",
      "range": { "from": 21, "to": 27 },
      "severity": "error" } ] }

Uma requisição e uma resposta reais do guia de integração do engine: um erro de sintaxe e um nome que não resolve, cada um com um código estável e o intervalo exato no texto.

Desempenho

Medido em um modelo gerado de 10.000 linhas:

  • 150 ms para analisar o modelo inteiro de 10.000 linhas do zero (parsing, resolução e checagem); 215 ms como WebAssembly no Safari.
  • 1,3 a 6,8 ms para checar de novo o modelo de 10.000 linhas após uma edição (percentil 95); 3 a 4 ms como WebAssembly no Safari.
  • Base do engine, com a biblioteca padrão carregada: 17 MiB. Uma análise do modelo inteiro acrescenta cerca de 29 MiB por 10.000 linhas, e uma sessão de edição inteira cerca de 33 MiB por 10.000 linhas.
  • Cerca de 0,74 MB de WebAssembly, compactado.

Testado com modelos gerados de até 250.000 linhas: resultados em cada tamanho.

Os seus números dependem do modelo e do computador. A avaliação permite medir nos seus próprios modelos.

Segurança

  • Sem acesso à rede nem a arquivos. O módulo WebAssembly não importa nada da página: ele lê o texto e os registros que você passa e retorna JSON.
  • Limites de entrada. O tamanho da entrada, o comprimento das linhas, o aninhamento e a profundidade das expressões são limitados, para que um arquivo hostil não esgote a memória nem a pilha.
  • Testado com fuzzing. Os pontos de entrada de requisição, lexer e parser, o simulador e as operações da linguagem passam por testes de fuzzing.
  • Isolado. No navegador, ele roda em seu próprio worker. Uma falha interrompe apenas esse worker, e a sua página o reinicia.

O que você recebe

  • O engine: o build WebAssembly, com a biblioteca padrão.
  • A camada de integração em JavaScript: o worker e um cliente para a sua página.
  • Documentação para desenvolvedores: um guia de integração, a referência de cada requisição com requisições e respostas reais, a lista de códigos de diagnóstico e exemplos executáveis (uma página mínima, um editor, um navegador de modelos, Node.js e Python).
  • Atualizações durante a vigência da licença.
  • Suporte por e-mail da equipe que o constrói.

Licenciamento

  • Licença anual por um ano de cada vez, com preço baseado no número de usuários ativos mensais dos recursos que o engine sustenta no seu produto.
  • Avaliação gratuita de 60 dias no seu próprio computador, com a documentação e os exemplos.
  • Licenças acadêmicas e de pesquisa para universidades e grupos de pesquisa.
  • Uso empresarial sob solicitação: vários produtos ou grandes quantidades de usuários.
  • Complementos: simulação, migração de SysML v1 para SysML v2 e uso em servidor, cada um licenciado separadamente.

Conte-nos sobre o seu produto e os usuários esperados, e enviaremos uma cotação.

Suporte à linguagem

A versão atual é o Holarch Language Engine 2.1.2. Ele se baseia na especificação OMG SysML v2 e suporta um subconjunto de SysML v2 e KerML. Cobertura da linguagem SysML v2 lista as construções suportadas e as lacunas conhecidas, como funcionam no Holarch. A documentação da avaliação inclui a mesma lista para o engine.

Como o engine se compara com a implementação piloto do OMG nos modelos de exemplo oficiais e como ele se sai com texto danificado e modelos grandes, incluindo as falhas: resultados de testes do Language Engine.

Experimente o engine nos seus próprios modelos.

A avaliação é gratuita por 60 dias.