Holarch

개발자용

Holarch Language Engine

라이선스로 제공되는 SysML v2 및 KerML 언어 엔진.

Holarch의 SysML v2 프로젝트의 기반 엔진을 자사 제품에 사용할 수 있습니다. SysML v2 및 KerML 텍스트를 구문 분석하고, 이름을 확인하고, 검사하고, 평가하며, 브라우저에서 WebAssembly로 또는 서버에서 실행됩니다.

작동 중인 Holarch Language Engine: 값을 입력하면 단위 오류가 나타나고 고치면 사라지며, 정의로 이동은 다른 패키지의 파트 정의로 이동하고, 250,000줄 모델을 명령줄에서 검사하여 진단 코드와 소요 시간을 보여 줍니다

대상

언어 구현을 직접 작성하고 유지 관리하지 않고 자사 제품에 SysML v2 텍스트를 넣고 싶은 팀.

도구 공급업체

모델링, 다이어그램 작성, 아키텍처 도구에 SysML v2 편집, 검사, 가져오기를 추가합니다.

PLM, 요구사항, 시뮬레이션 제품

SysML v2 모델을 읽고, 요구사항과 단위가 있는 값을 따라가며, 다른 도구와 모델을 교환합니다.

사내 엔지니어링 도구 팀

검토 파이프라인에서 모델을 검사하고, 보고서를 생성하며, 사내 도구 안에서 엔지니어에게 SysML v2 편집기를 제공합니다.

기능

텍스트에서 검사된 모델까지 전체 과정을 위한 하나의 엔진으로, JSON으로 입력하고 JSON으로 출력합니다.

구문 분석

오류 복구 기능이 있는 SysML v2 및 KerML 텍스트 표기법: 실수 하나가 파일의 나머지를 가리지 않습니다. 표준 라이브러리는 엔진과 함께 로드됩니다.

이름 확인

패키지와 파일 전반의 이름, 임포트, 별칭, 특수화, 타입 지정, 재정의를 확인하며, 호버, 정의로 이동, 자동 완성, 이름 바꾸기를 지원합니다.

검사

135개 진단 코드. 각각 심각도, 정확한 범위, 메시지, 그리고 편집기가 빠른 수정으로 제공할 수 있는 수정 제안이 있습니다.

평가

body + 4 * 12 [kg]에서 348 [kg]처럼 단위와 수량이 있는 식, 그리고 요구사항 제약 조건과 검증 케이스. 요구사항 임계값과 목표로 하는 목표값은 모델에서 읽힙니다.

입력하는 동안 재분석

문서 세션은 변경된 부분만 다시 구문 분석하고 토큰 델타를 보내므로 큰 모델에서도 편집기가 빠르게 반응합니다.

서식을 잃지 않고 텍스트 편집

다이어그램이나 양식에서의 변경이 텍스트에 다시 기록됩니다. 변경되지 않은 텍스트, 주석, 레이아웃은 사용자가 작성한 그대로 유지됩니다.

차이, 병합, 리베이스

모델의 두 버전을 변경 목록으로 비교하고, 적용하며, 텍스트 편집을 더 새로운 모델 변경 위로 리베이스합니다.

변형

가변점, 변형, 구성이 검사되며, 모든 변형 조합을 나열하고 모델의 제약 조건에 대해 판정할 수 있습니다.

시뮬레이션(애드온)

액션 흐름과 상태 머신을 시뮬레이션 시간에 걸쳐 실행합니다: 단일 실행, 자사 제품의 입력을 받는 단계별 실행, 또는 Monte Carlo 연구. 같은 시드는 브라우저와 서버에서 같은 답을 냅니다.

JSON 교환

SysML v2 JSON을 가져오고 내보내며, 모델을 고정 ID가 있는 일반 레코드로 읽습니다. 텍스트에 각 요소의 ID를 담을 수 있으므로, 편집한 텍스트를 다시 읽어도 이름 바꾸기와 이동을 거치면서 모든 요소의 동일성이 유지됩니다.

Holarch에서 검증됨

같은 엔진이 Holarch의 모든 SysML v2 프로젝트를 실행합니다: 편집기, 뷰, 수명 주기 페이지.

애드온

엔진은 자체적으로 모델을 검사하고, 분석하고, 편집합니다. 세 가지 애드온이 엔진을 확장하며, 각각 별도로 라이선스되고, 다시 빌드하거나 코드를 바꿀 필요 없이 라이선스 토큰으로 켜집니다.

시뮬레이션

액션 흐름과 상태 머신을 시뮬레이션 시간에 걸쳐 실행합니다: 단일 실행, 자사 제품의 입력을 받는 단계별 실행, 또는 Monte Carlo 연구. 같은 시드는 브라우저와 서버에서 같은 답을 냅니다. 시뮬레이션 주석이 있는 모델은 이 애드온 없이도 검사됩니다.

SysML v1에서 SysML v2로 마이그레이션

SysML v1 모델을 검사된 SysML v2 텍스트로 변환하며, 모든 요소에 대해 변환됨, 근사 처리됨, 제외됨을 보고합니다. 마이그레이션 애드온의 작동 방식.

서버 사용

브라우저 페이지 밖에서 엔진을 실행합니다: Node.js, Deno, 서버리스 함수 또는 Python 확장. 빌드 파이프라인에서 모델을 검사하고, 일괄 변환하거나, 자체 서비스의 요청에 응답합니다.

애드온: SysML v1에서 SysML v2로 마이그레이션

마이그레이션 애드온은 OMG SysML 2.0 사양의 SysML v1→SysML v2 변환을 바탕으로 SysML v1 모델을 SysML v2 텍스트로 변환합니다. Holarch의 SysML v1 가져오기의 기반 변환기이며, 엔진과 별도로 라이선스됩니다.

  • 입력: API 참조 문서에 설명된 중립 형식의 JSON으로 된 SysML v1 모델. 제품이 XMI 파일(Cameo 또는 MagicDraw, Enterprise Architect, Rhapsody, Papyrus)을 읽어 모델을 보내며, 엔진은 XML이나 파일을 읽지 않습니다.
  • 출력: SysML v2 텍스트, 그 텍스트에 대한 엔진의 검사 결과, 그리고 모든 요소를 고정된 이유 코드와 변환된 SysML v2 이름과 함께 변환됨, 근사 처리됨, 제외됨으로 나열하는 보고서.
  • 반복 가능: 같은 모델은 매번 같은 텍스트로 변환됩니다.
  • 제한됨: 최대 250,000개 요소와 8 MiB 텍스트의 모델. 더 큰 모델은 멈추지 않고 오류 응답을 받습니다.

요청은 API 참조 문서의 v1_convert입니다. 애드온이 없으면 엔진은 feature-not-licensed로 응답하며, 다른 모든 요청은 평소처럼 작동합니다.

요청과 응답

// 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" }, … ] } }

엔진으로 변환한 작은 테스트 모델: 요소 31개, 변환된 텍스트에 진단 없음.

실행 방식

브라우저에서 엔진은 Web Worker 안의 WebAssembly 모듈이므로 분석이 페이지를 막지 않습니다. 작은 JavaScript 통합 계층이 요청을 보내고 응답을 프로미스로 반환합니다. Node.js나 Python용 서버 빌드는 요청 시 제공됩니다.

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

요청과 응답

// 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" } ] }

엔진 통합 가이드에 있는 실제 요청과 응답: 구문 오류 하나와 확인되지 않는 이름 하나로, 각각 고정된 코드와 텍스트 내 정확한 범위가 있습니다.

성능

생성된 10,000줄 모델에서 측정:

  • 10,000줄 모델 전체를 처음부터 분석(구문 분석, 이름 확인, 검사)하는 데 150 ms, Safari의 WebAssembly에서는 215 ms.
  • 편집 후 10,000줄 모델을 다시 검사하는 데 1.3~6.8 ms(95번째 백분위수), Safari의 WebAssembly에서는 3~4 ms.
  • 표준 라이브러리를 로드한 엔진 기본 메모리: 17 MiB. 모델 전체 분석은 10,000줄당 약 29 MiB, 편집 세션 전체는 10,000줄당 약 33 MiB를 추가합니다.
  • 압축된 WebAssembly 약 0.74 MB.

최대 250,000줄의 생성된 모델로 테스트했습니다: 크기별 결과.

실제 수치는 모델과 컴퓨터에 따라 다릅니다. 평가판으로 자체 모델에서 측정할 수 있습니다.

보안

  • 네트워크나 파일에 접근하지 않습니다. WebAssembly 모듈은 페이지에서 아무것도 임포트하지 않습니다: 전달한 텍스트와 레코드를 읽고 JSON을 반환합니다.
  • 입력 제한. 입력 크기, 줄 길이, 중첩, 식 깊이에 상한이 있으므로 악의적인 파일이 메모리나 스택을 고갈시킬 수 없습니다.
  • 퍼징 테스트. 요청, 렉서, 파서 진입점, 시뮬레이터, 언어 연산에 퍼징 테스트를 수행합니다.
  • 격리. 브라우저에서 자체 워커로 실행됩니다. 오류는 그 워커만 멈추며, 페이지가 워커를 다시 시작합니다.

제공 내용

  • 엔진: 표준 라이브러리가 포함된 WebAssembly 빌드.
  • JavaScript 통합 계층: 워커와 페이지용 클라이언트.
  • 개발자 문서: 통합 가이드, 실제 요청과 응답이 있는 모든 요청의 참조 문서, 진단 코드 목록, 실행 가능한 예제(최소 페이지, 편집기, 모델 브라우저, Node.js, Python).
  • 라이선스 기간 동안의 업데이트.
  • 엔진을 만드는 팀의 이메일 지원.

라이선스

  • 제품에서 엔진이 구동하는 기능의 월간 활성 사용자 수에 따라 가격이 정해지는 1년 단위의 연간 라이선스.
  • 문서와 예제가 포함된, 자체 컴퓨터에서 사용하는 60일 무료 평가판.
  • 대학과 연구 그룹을 위한 학술 및 연구 라이선스.
  • 요청 시 엔터프라이즈 사용: 여러 제품 또는 대규모 사용자 수.
  • 애드온: 시뮬레이션, SysML v1에서 SysML v2로 마이그레이션, 서버 사용, 각각 별도 라이선스.

제품과 예상 사용자에 대해 알려 주시면 견적을 보내 드립니다.

언어 지원

현재 버전은 Holarch Language Engine 2.1.2입니다. OMG SysML v2 사양을 바탕으로 하며 SysML v2와 KerML의 하위 집합을 지원합니다. SysML v2 언어 지원 범위에 Holarch에서 작동하는 지원 구문과 알려진 빈틈이 나와 있습니다. 평가판 문서에도 엔진에 대한 같은 목록이 포함되어 있습니다.

공식 예제 모델에서 엔진이 OMG의 파일럿 구현과 어떻게 비교되는지, 손상된 텍스트와 큰 모델에서 실패를 포함하여 어떻게 동작하는지: Language Engine 테스트 결과.

자체 모델로 엔진을 사용해 보십시오.

평가판은 60일 동안 무료입니다.