SysML v2
SysML v2 프로젝트의 시뮬레이션 메타데이터
HolarchSimulation 메타데이터 라이브러리: SysML v2 모델이 시뮬레이터를 위해 지속 시간, 분기 확률, 반복 횟수, 리소스, 비용, 상태 머신 설정을 담는 방법과 이를 작성하고 옮기는 방법입니다.
이 페이지의 내용
개요
SysML v2 프로젝트에서 시뮬레이터의 설정은 모델의 일부입니다. 이 설정은 모든 SysML v2 프로젝트가 로드하는 라이브러리 패키지 HolarchSimulation의 메타데이터 주석입니다. 이를 사용하는 모델은 유효한 SysML v2로 유지됩니다. 다른 도구는 주석을 일반 메타데이터로 읽으며, 시뮬레이터만 주석에 의미를 부여합니다.
주석은 주석 대상 요소 안에 있거나 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"; }
개념
공칭 값과 분포
단계의 소요 시간은 그 속성 duration(또는 DurationValue나 TimeValue 타입의 속성)입니다. 그 값은 다른 도구와 Holarch의 평가가 보는 공칭 소요 시간입니다. 그 속성에 분포 주석이 있으면 시뮬레이터는 대신 소요 시간을 무작위로 뽑습니다.
action cruise {
attribute duration : ISQ::DurationValue = 1 [min] {
@HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
}
}
어떤 설정이 우선하는가
- 분포 주석이 속성 자체의 값보다 우선합니다.
- 모델이 평가할 수 있는 가드,
if조건, 루프 조건은 스스로 결정합니다. Probability나 LoopCount는 평가할 수 없을 때만 사용됩니다(LoopCount는 항상 통과 횟수를 셉니다). - 시뮬레이션 설정이 모델로 옮겨지기 전에 만든 설정은 모델 옆에 Holarch 데이터로 보관됩니다. 옮기기 전까지는 이 설정이 계속 우선하므로 실행 결과가 같습니다(이전 설정을 모델로 옮기기 참조).
두 가지 시뮬레이터
시뮬레이터 페이지는 설정 오른쪽에 모델을 실행하는 시뮬레이터를 표시합니다: SysML 엔진(Holarch Language Engine의 시뮬레이터) 또는 JavaScript 시뮬레이터. 둘 다 같은 주석을 읽습니다. 상태 머신, 자극, Resource, 소비, Produces, 점유의 자원, 비용의 비용, 그리고 SysML 엔진이 필요한 주석에 있는 기타 주석은 SysML 엔진에서만 실행됩니다.
사용 방법
사용 시기와 이유
모델이 설계의 기록일 때 시뮬레이션 설정을 모델에 기록합니다. 숫자가 .sysml 파일과 함께 이동하고, 텍스트 검토에 나타나며, 모델의 나머지 부분과 함께 버전 관리됩니다. 운용 시나리오(타임라인, 분기 비율, 자원 사용)를 분석하는 동안과 Monte Carlo 스터디로 요구사항을 검사하기 전에 사용합니다.
소요 시간, 확률 또는 반복 횟수 설정하기
- 액션 흐름 뷰, 브라우저 또는 편집기에서 단계, 후속 관계, 결정, 루프 또는
if액션을 선택합니다. - 속성 패널의 시뮬레이션 섹션에서 기간(고정 값 또는 분포), 확률 (%), 반복 횟수 또는 then의 확률 (%)을 설정합니다.
- Holarch가 모델에 주석을 기록합니다. 기간은 속성 값을 평균으로 설정하고 분포 주석을 추가하며(단계에 속성이 없으면
attribute duration : ISQ::DurationValue를 작성), 확률 (%)은 Probability를, 반복 횟수는 LoopCount를 작성합니다. 각 변경은 실행 취소 한 번으로 되돌릴 수 있으며 텍스트에 즉시 나타납니다. - 주석을 제거하려면 필드를 비웁니다.
Holarch는 각 변경을 기록하기 전에 SysML 검사기로 검사합니다. 오류를 추가하는 변경은 기록되지 않으며, 메시지에 문제가 표시됩니다.
텍스트에 주석 작성하기
- 편집기를 엽니다.
- 요소 본문 안에
@HolarchSimulation::Kind { field = value; }로, 또는 요소 뒤에metadata HolarchSimulation::Kind about element { … }로 주석을 추가합니다. - 소비, Produces, 점유는 단계를 먼저, 자원을 두 번째로 지정합니다:
metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }.
이전 설정을 모델로 옮기기
시뮬레이션 설정이 모델로 옮겨지기 전에 설정을 만든 프로젝트에서는 시뮬레이터 설정 위에 이 프로젝트의 일부 시뮬레이션 설정은 모델의 일부가 아닌 Holarch 데이터입니다.가 표시됩니다.
- 시뮬레이션 설정을 모델로 이동…을 클릭합니다.
- 미리 보기에 각 설정과 그것을 대체할 주석이 나열됩니다.
- 모델로 이동을 클릭합니다. 모든 설정이 이동하며, 실행 취소 한 번으로 모두 되돌립니다. 실행 결과는 같습니다.
상태 머신 시뮬레이션
상태 머신은 SysML 엔진에서 실행됩니다.
- 동작 → 시뮬레이터를 열고 상태 정의, 또는 상태를 나타내는 파트를 루트로 선택합니다.
- 선택 사항: 함께 실행에서 데모의 TestDrive처럼 파트에 신호를 보내는 시나리오 액션을 선택합니다.
- 자극에서 + 자극 추가를 클릭하고 시점(시간과 단위), 신호, 대상(머신, 또는 이를 받는 모든 머신)을 설정합니다.
- ▶ 재생, ⏭ 단계 또는 ⏩ 끝까지 실행을 누릅니다. 실행 중인 상태 머신은 활성 상태를 밝게 표시하고 발생한 전이를 표시합니다. 상태 탭은 시간별 상태와 발생한 전이를 보여 줍니다.
- Monte Carlo에서 상태 탭은 상태 시간과 전이 횟수를 보여 줍니다. Requirement 대비 검사…는 각 상태의 상태 시간과 실행 중 비율을 출력으로 제공합니다.
상태 전이 뷰에서 ▶ 시뮬레이션은 ▶ 재생, ⏭ 단계, ⏩ 끝까지 실행, 재설정, 시뮬레이터에서 열기가 있는 막대를 엽니다. 실행에는 시뮬레이터에 그 상태 정의용으로 저장된 자극이 사용됩니다.
작업 예제: Hybrid Car 데모
Hybrid Car 데모(프로젝트 관리 → 프로젝트 파일 ▾ → 새 데모 프로젝트)는 이 라이브러리를 사용합니다.
- DriveCycle:
shift뒤의 후속 관계toCruise는 Probability 70이며,else분기가 나머지 30 %를 차지합니다.cruise는 공칭 1 min이며 Triangular 분포(45 s, 1 min, 2 min)에서 뽑습니다. - DrivenCar: 파워트레인의 배터리는 62 Wh의 Resource입니다.
drive는 그중 1.5 Wh를 소비하며, 사용당 0.4 USD의 비용이 있습니다. - PowertrainStates: 전이
startElectric은 가드에 Probability 80을 가집니다.accept when charge < 15는 충전량이 떨어지면 하이브리드로 전환하고,accept after 30 [min]은 충전을 끝냅니다. - TestDrive:
demoCar에StartRequest를 보내고, 1시간 기다린 다음,StopRequest와PlugIn을 보내는 시나리오입니다. 파워트레인의 상태 변화를 보려면 Demo Car를 Test Drive와 함께 실행합니다.
데모는 진단 0개로 검사를 통과합니다.
팁과 모범 사례
- 공칭 값이 의미를 갖도록 유지합니다. 속성 패널처럼 분포의 기댓값으로 설정합니다.
- 텍스트에서 주석을 쉽게 찾을 수 있도록, 주석을 다는 후속 관계에 이름을 붙입니다(
succession toCruise first …). - 확률보다 모델이 평가할 수 있는 조건을 우선 사용합니다. Probability는 모델이 설명하지 않는 부분에 사용합니다.
흔한 실수
- 확률이 효과가 없습니다: 가드를 평가할 수 있으므로 가드가 결정합니다. 속성 패널에 "true로 평가됨: 항상 선택됩니다." 또는 "false로 평가됨: 선택되지 않습니다."가 표시됩니다.
- 분기 확률의 합계가 100 %가 아닙니다: Probability가 없는 분기가 남은 몫을 나눕니다. 지정한 확률이 100 %를 넘으면 "분기 확률의 합이 N %입니다. 합계가 100 %가 되도록 변경하십시오."라는 경고가 표시됩니다.
- 단계 자체에 붙은 소요 시간 주석: 분포는 액션이 아니라 duration 속성에 붙입니다.
연결 방식
- SysML v2 프로젝트의 평가, 단위 및 분석: 시뮬레이터가 단계, 후속 관계, 소요 시간을 읽는 방식.
- 시뮬레이션: 시뮬레이터 페이지, 패널, Monte Carlo 통계.
- SysML v2 텍스트 표기법: 텍스트의 메타데이터와
about.
주석
분포
duration 속성에 분포를 붙입니다. 위치 및 척도 필드는 단위가 있는 양(45 [s], 2 [min])을 받고, 형상 필드는 숫자를 받습니다.
| 주석 | 필드 | 의미 |
|---|---|---|
| 정규 | mean, sd | 정규 분포. |
| 삼각 | low, mode, high | 삼각 분포이며, low ≤ mode ≤ high입니다. |
| 균등 | low, high | low와 high 사이의 균등 분포. |
| Exponential | mean | 주어진 평균의 지수 분포. |
| Gamma | shape, scale | 감마 분포이며, 평균은 shape × scale입니다. |
| LogNormal | median, sigma | 로그가 중앙값의 로그를 중심으로 정규 분포를 따릅니다. |
| Weibull | scale, shape | 와이블 분포. |
| Beta | alpha, beta, scale | 0..1 범위의 베타 분포에 scale을 곱한 값. |
| Poisson | mean, scale | 주어진 평균을 가진 개수에 scale을 곱한 값. |
| Binomial | trials, p, scale | 여러 시행 중 성공 횟수에 scale을 곱한 값. |
0보다 작게 뽑힌 소요 시간은 다시 뽑습니다.
상관된 입력
상관관계가 없으면 분포에서 뽑은 모든 값은 서로 독립입니다. Correlation은 그중 두 값이 함께 움직이게 합니다.
metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
| 주석 | 대상 | 의미 |
|---|---|---|
Correlation coefficient | about a, b: 각각 분포가 있는 두 속성 | 두 값의 순위(Spearman) 상관계수이며, -1에서 1까지입니다. 0은 독립, 1은 항상 같은 순위, -1은 반대 순위입니다. |
- 각 속성은 자신의 분포를 유지합니다. 시뮬레이터는 모든 쌍을 하나의 상관 행렬(가우스 코퓰라)로 결합합니다. 한 실행에서 어떤 속성에 대해 n번째로 뽑은 값은 그 속성과 상관된 모든 속성의 n번째 값과 짝을 이룹니다.
- 상관된 속성 그룹의 계수는 서로 들어맞아야 합니다. a가 b와 강하게, b가 c와 강하게 상관되면서 a가 c와 반대일 수는 없습니다. 검사는 그런 그룹을 보고합니다. 계수 중 하나를 약하게 합니다.
- 소요 시간과 양(소비, Produces, 점유)도 같은 방식으로 상관됩니다. 시드가 같은 실행은 같은 값을 냅니다.
- 시뮬레이터에서 SysML 엔진으로 Monte Carlo 모드일 때 상관된 입력이 루트의 쌍을 나열합니다. 두 속성과 계수를 선택하고 + 상관관계 추가를 클릭하거나, 계수를 변경하거나, ×를 클릭해 하나를 제거합니다. 실행 취소 한 번으로 각 변경을 되돌립니다. 스터디 후 달성은 실행에서 뽑힌 값의 순위 상관계수를 보여 줍니다.
- Hybrid Car 데모의
ChargeStop은 빈 충전기 대기 시간과 충전 시간을 상관시킵니다(0.6).
확률과 횟수
| 주석 | 대상 | 의미 |
|---|---|---|
Probability percent | 결정에서 나가는 후속 관계 | 분기의 가중치. 가중치가 없는 분기는 100에서 남은 몫을 나눕니다. |
if 액션 | 조건을 평가할 수 없을 때 then 분기의 확률. | |
| 루프 액션 | 매 통과 후 반복할 확률. | |
| 전이 | 가드를 평가할 수 없을 때 가드가 성립할 확률. | |
LoopCount count | 루프 액션 | 통과 횟수. 루프의 조건보다 우선합니다. |
| LoopExit | 루프 본문 안의 done으로 가는 후속 관계 | 그 통과만이 아니라 루프 전체를 끝냅니다. |
자원과 비용
| 주석 | 대상 | 의미 |
|---|---|---|
Resource initial, minimum, maximum, unit | 파트 또는 아이템 사용 | 일정 양의 풀입니다. 사용이 attribute level : Real을 선언하면 시뮬레이터가 이를 양과 같게 유지하므로 가드가 읽을 수 있습니다. |
소비 amount | about step, pool | 단계가 시작될 때 가져갑니다. |
Produces amount | about step, pool | 단계가 끝날 때 추가합니다. |
점유 amount | about step, pool | 단계가 시작될 때 가져가고 끝날 때 돌려줍니다. |
Utilization amount | perform 액션 사용 | 단계가 수행 파트를 얼마나 차지하는지. |
비용 amount, rate, unit, label | 단계 또는 수행 파트 | 사용당 비용(CostRate::perUse) 또는 시간당 비용(CostRate::perHour). |
SysML 엔진이 필요한 주석
| 주석 | 의미 |
|---|---|
이전 latency, capacity, per | 연결 또는 인터페이스에 붙이며, 그것을 통해 보내는 아이템과 신호를 지연시킵니다. |
크기 size | 아이템에 붙이며, 전송 지연에 쓰이는 크기입니다. |
Timeout limit | 조인에 붙이며, 한도가 지나면 끝나지 않은 분기를 중지합니다. |
NotBefore time | 단계에 붙이며, 이 실행 시간 전에는 단계가 시작되지 않습니다. |
| ForkTargets, JoinSources | 병렬 상태로 들어가거나 나오는 전이에 붙이며, 진입하는 하위 상태 또는 활성이어야 하는 하위 상태를 나타냅니다. |
History deep | 복합 상태에 붙이며, 다시 진입하면 떠날 때 활성이던 하위 상태에서 재개합니다. |
HostHook key, points | Holarch 전용: 나열된 지점에서 실행이 입력을 기다리며 일시 중지합니다. |
JavaScript 시뮬레이터는 Probability, LoopCount, 분포를 읽습니다.
메시지
| 메시지 | 의미 |
|---|---|
| 이 프로젝트의 일부 시뮬레이션 설정은 모델의 일부가 아닌 Holarch 데이터입니다. | 이전 설정이 아직 모델 옆에 저장되어 있습니다. 시뮬레이션 설정을 모델로 이동…을 클릭합니다. |
| 시뮬레이션 설정이 모델로 옮겨지기 전의 Holarch 데이터이며, 모델보다 우선합니다. | 속성 패널의 시뮬레이션 섹션에 표시됩니다. 필드를 변경해 모델에 기록하거나, 시뮬레이터에서 모든 설정을 옮깁니다. |
| 모델에 기간이 없습니다. 여기에서 설정하거나(attribute duration : ISQ::DurationValue를 기록함) 텍스트에 작성하십시오. | 단계에 duration 속성이 없습니다. |
| @Normal: sd must be greater than zero. Change sd.(@Normal: sd는 0보다 커야 합니다. sd를 변경하십시오.) (다른 분포와 매개변수도 비슷합니다) | 분포 매개변수가 없거나 범위를 벗어났습니다. SysML 엔진에서는 모델 검사가 편집기에 이를 보고하며, 수정될 때까지 시뮬레이터가 실행을 거부합니다. |
| @Normal: sd has another unit dimension than …(@Normal: sd의 단위 차원이 …와(과) 다릅니다) | 위치 또는 척도 매개변수의 단위가 속성과 다릅니다. 예를 들어 소요 시간에 미터를 쓴 경우입니다. |
| @LoopCount does not apply to a part …(@LoopCount는 파트에 적용되지 않습니다 …) | 주석이 적용되지 않는 종류의 요소에 붙어 있습니다. 옮기거나 삭제합니다. |
| metadata Consumes … about needs an action and a part or item annotated @Resource.(metadata Consumes … about에는 액션 하나와 @Resource 주석이 달린 파트 또는 아이템 하나가 필요합니다.) | about 뒤의 요소 수나 종류가 잘못되었습니다. |
| A probability of N % is outside 0 to 100.(확률 N %가 0에서 100 범위를 벗어났습니다.) | 0에서 100 사이의 백분율을 입력합니다. |
| The branch probabilities of this decision add up to N %; the simulator scales them to 100 %.(이 결정의 분기 확률 합계가 N %입니다. 시뮬레이터가 100 %로 조정합니다.) | 경고: 모든 분기에 가중치가 있지만 합계가 100이 아닙니다. |
| A correlation needs two different attributes …(상관관계에는 서로 다른 속성 두 개가 필요합니다 …), … is not an attribute …(…은(는) 속성이 아닙니다 …) 또는 … has no distribution, so nothing is drawn to correlate …(…에 분포가 없어 상관시킬 값이 뽑히지 않습니다 …) | Correlation이 한 속성을 두 번 지정했거나, 속성이 아닌 것을 지정했거나, 분포가 없는 속성을 지정했습니다. |
| The coefficient N is outside -1 to 1.(계수 N이 -1에서 1 범위를 벗어났습니다.) 또는 The correlation has no coefficient.(상관관계에 계수가 없습니다.) | -1에서 1 사이의 계수를 입력합니다. |
| “a” and “b” are already correlated; the first correlation is used. …(“a”와 “b”는 이미 상관되어 있습니다. 첫 번째 상관관계가 사용됩니다. …) | 경고: 같은 쌍에 대한 두 번째 Correlation은 무시됩니다. 둘 중 하나를 제거합니다. |
| The correlations of … contradict each other: no joint distribution has them …(…의 상관관계가 서로 모순됩니다: 이를 만족하는 결합 분포가 없습니다 …) | 그룹의 계수가 함께 성립할 수 없습니다(행렬이 양의 준정부호가 아님). 하나를 약하게 합니다. 수정될 때까지 시뮬레이터가 실행을 거부합니다. |
| <time>에 교착 상태: 단계 N개가 오지 않는 것을 기다리고 있습니다. | SysML 엔진에서 결과 위에 기다리는 각 단계와 함께 표시됩니다. 보내는 쪽이 없는 accept, 생산되지 않는 아이템, 해제되지 않는 자원은 실행을 멈춥니다. |
제한 사항
- 소요 시간은 초, 분, 시간 또는 일(
SI::s,SI::min,SI::h,SI::d)로 기록됩니다. 밀리초는 초로, 주, 월, 년은 일로 기록됩니다. - 상태 머신, 자극, 함께 실행에는 SysML 엔진이 필요합니다.
- 상관된 입력에는 SysML 엔진이 필요합니다. JavaScript 시뮬레이터는 모든 값을 독립적으로 뽑습니다. 한 그룹에서 최대 200개의 속성을 상관시킬 수 있습니다.
- 모순되는 계수 검사는 한 네임스페이스에 작성된 상관관계를 대상으로 합니다. 시뮬레이터는 실행의 모든 상관관계를 검사합니다.
관련 항목
SysML® 및 OMG®는 미국 및 기타 국가에서 Object Management Group, Inc.의 등록 상표입니다.