SysML v2
SysML v2 튜토리얼
SysML v2 프로젝트를 위한 9개의 안내형 튜토리얼입니다. 첫 패키지부터 포트, 액션, 상태, 요구사항, 검증, 제약 조건, 변형까지 다루며, 단계 패널이 작업을 검사합니다.
이 페이지의 내용
Holarch에는 SysML v2 프로젝트를 위한 안내형 튜토리얼 과정이 있습니다. 각 튜토리얼은 작은 SysML v2 시작 프로젝트를 만들고 페이지 옆에 단계 패널을 엽니다. 패널은 작업하는 동안 모델을 검사하며, 모델에 단계가 요구하는 내용이 들어가면 해당 단계가 초록색으로 바뀝니다. 이 페이지는 모든 단계를 텍스트로 나열하므로 여기서도 따라 할 수 있습니다.
첫 번째 튜토리얼은 LML 튜토리얼과 마찬가지로 WS-1 Weather Station을 사용합니다. 나머지는 Hybrid Car 데모의 모델인 하이브리드 자동차의 일부를 만듭니다: 값 타입과 구성 요소, 파워트레인의 포트와 인터페이스, 주행 사이클, 파워트레인의 상태, 자동차의 요구사항, 그 검증, 세단의 값에 대한 검사, 제품 라인. 튜토리얼마다 자체 시작 프로젝트가 있으므로 어떤 순서로든 진행할 수 있습니다. 모든 시작 프로젝트와 완료된 모든 튜토리얼은 문제 0개로 검사를 통과합니다.
| 튜토리얼 | 시간 | 배우는 내용 |
|---|---|---|
| 시작하기 | 15분 | SysML v2 텍스트를 작성하고, 트리와 뷰로 보고, 뷰에서 그리고, 요구사항을 추가합니다 |
| 정의와 속성 | 20분 | 열거형, 값 타입, 추상 정의를 작성하고, 값과 단위로 특수화하고, 자동 완성, 삽입, 이름 바꾸기를 사용합니다 |
| 포트와 인터페이스 | 20분 | 포트와 인터페이스를 정의하고, 포트를 켤레로 만들고, 파트를 연결하고, 상호 연결 뷰에서 인터페이스를 그립니다 |
| 액션과 흐름 | 20분 | 액션 정의와 포크, 흐름, 조인이 있는 주행 사이클을 작성하고, 스윔레인을 추가하고, FFBD에서 단계를 만듭니다 |
| 상태와 전이 | 20분 | 신호와 트리거, 가드, 상태 액션이 있는 상태 머신을 작성하고, 시간 지정 전이를 그립니다 |
| 요구사항 | 20분 | 한계값, 요구사항 정의와 사용을 작성하고, 이를 충족시키고, 충족되지 않은 요구사항을 확인합니다 |
| 검증과 추적성 | 15분 | 검증 케이스를 작성하고, 추적성 매트릭스에서 단계를 추적하고, 요구사항을 파생합니다 |
| 제약 조건과 계산 | 20분 | 제약 조건과 계산을 작성하고, 파라메트릭 뷰에서 값을 바인딩하고, 분석 케이스를 실행하고, TBD 및 TBR 값을 표시합니다 |
| 변형과 구성 | 15분 | 가변 요소와 변형, 규칙이 있는 제품 라인, 구성, 직접 만든 키워드를 작성합니다 |
사용 방법
SysML v2 튜토리얼 시작하기
- 레일에서 도움말 → 튜토리얼을 열거나, ⌘K / Ctrl+K를 누르고
tutorial을 입력합니다. 프로젝트 밖에서는 튜토리얼 페이지에 LML 튜토리얼이 먼저 나오고 그다음 SysML v2 프로젝트용 튜토리얼이 나옵니다. SysML v2 프로젝트 안에서는 SysML v2 튜토리얼만 나열됩니다. - 카드에서 시작을 클릭합니다. Holarch가 프로젝트(예: Tutorial: SysML v2 Ports and Interfaces (Hybrid Car))를 만들고 오른쪽에 단계 패널을 띄운 채로 엽니다.
단계 패널은 LML 튜토리얼과 같은 방식으로 작동합니다. 보여 주기는 단계에 필요한 컨트롤에 윤곽선을 표시하고, 이동은 해당 페이지를 열고, 자세히 보기는 도움말 항목을 엽니다. 다시 시작…, 완료로 표시, ×도 같은 방식으로 작동합니다. 튜토리얼을 참조하십시오.
단계의 텍스트 입력하기
대부분의 단계는 모델 → 편집기에 입력할 SysML 텍스트를 제공합니다. 단계에는 줄을 넣을 위치가 나와 있습니다(예: “패키지의 마지막 닫는 중괄호 앞”). 입력을 멈추면 텍스트가 모델에 적용되며, 편집기 아래의 상태 표시가 이를 알리고 단계가 초록색으로 바뀝니다.
- 표시된 대로 줄을 입력합니다. 들여쓰기는 모델에 영향을 주지 않으며, 편집기는 입력한 들여쓰기를 그대로 유지합니다.
- 빨간 밑줄은 오류를 나타냅니다. 밑줄을 가리키면 메시지가 표시됩니다. 구문 오류가 있는 텍스트는 초안으로 남고, 고칠 때까지 적용되지 않습니다.
- ⌘Z / Ctrl+Z는 마지막으로 적용된 변경을 실행 취소합니다.
팁
- 처음에는 튜토리얼을 순서대로 진행하십시오. 각 튜토리얼은 사용하는 텍스트를 설명하며, 뒤의 튜토리얼은 앞에서 다룬 개념(정의와 사용,
:>와:>>)을 안다고 가정합니다. - 단계가 계속 열려 있다면 대개 이름에 오타가 있습니다. 입력한 텍스트를 단계의 줄과 비교하십시오. SysML v2에서 이름은 대소문자를 구분합니다.
- 튜토리얼은 SysML v2 기초와 같은 언어를 가르치며, 자세한 내용은 텍스트 표기법 페이지에 있습니다.
시작하기
Weather Station의 첫 모델을 작성합니다. 텍스트를 열고, 값과 단위가 있는 파트 정의를 추가하고, 이를 다른 정의에서 사용하고, 브라우저와 일반 뷰에서 모델을 확인하고, 뷰에서 파트를 그려 텍스트에 나타나는 것을 보고, satisfy로 요구사항을 추가하고, 모델을 .sysml 파일로 내보냅니다. 단계는 SysML v2 프로젝트 시작하기에 설명되어 있습니다.
정의와 속성
시작 프로젝트에는 파트 정의 Car 하나가 있는 패키지 Vehicles가 있습니다.
- 패키지를 엽니다. 모델 → 편집기를 클릭합니다. 모든 선언은 키워드와 이름, 그리고 중괄호로 묶인 본문 또는 세미콜론으로 이루어집니다.
- 열거형을 작성합니다.
part def Car {위에enum def DriveMode { enum economy; enum normal; enum sport; }를 추가합니다(한 줄에 값 하나). - 값 타입을 정의합니다. 그 아래에
attribute def TirePressure :> ScalarValue;를 추가합니다.:>는 특수화를 뜻합니다. - 추상 정의를 작성합니다.
doc주석과 속성mass : MassValue,partNumber : String,power : PowerValue가 있는abstract part def Component를 추가합니다.//는 텍스트에만 남는 메모를 시작합니다. - 검사기가 실수를 찾게 합니다.
attribute redefines mass = 45 [kg];와 일부러 넣은attribute redefines power = 60 [kg];가 있는part def Battery :> Component를 추가합니다. 검사기가 단위에 밑줄을 긋습니다. 킬로그램은 전력 단위가 아닙니다. - 단위를 고칩니다.
60 [W]로 바꿉니다. - 이름을 자동 완성합니다. 배터리 안에
attribute capacity : Ener를 입력하고, 자동 완성 목록에서 Enter로EnergyValue를 선택한 다음;로 끝냅니다. - 표준 라이브러리에서 찾아봅니다. 레일 아래쪽의 설정 → 표준 라이브러리를 클릭하고 찾기 상자에
EnergyValue를 입력합니다. - 정의를 삽입합니다. 편집기의 빈 줄에서 ⌃⇧Space / Ctrl+Shift+Space를 누르고(또는 삽입 ▾을 클릭하고) 파트 정의를 선택한 다음,
attribute redefines mass = 110 [kg];와attribute cylinders : Integer;로part def Engine :> Component를 완성합니다. - 정의를 사용합니다.
Car에attribute mode : DriveMode;,part battery : Battery;,part engine : Engine;을 추가합니다. - 모든 곳에서 이름을 바꿉니다. 커서를
cylinders에 두고 F2를 누른 다음 이름을cylinderCount로 바꿉니다.
포트와 인터페이스
시작 프로젝트에는 토크 포트와 전력 포트가 있는 파워트레인 구성 요소, 포트 정의 TorquePort와 PowerPort, 인터페이스 정의 Shaft와 HighVoltageBus가 있습니다.
- 포트를 정의합니다.
port def TorquePort위에out attribute flowRate : Real;와attribute kind : FuelKind;가 있는port def FuelPort를 추가합니다.out은 값이 포트를 소유한 파트에서 나간다는 뜻입니다. - 파트에 포트를 줍니다.
FuelTank에port fuelOut : FuelPort;를,Engine에port fuelIn : ~FuelPort;를 추가합니다.~는 포트를 켤레로 만듭니다. 즉 in과 out이 뒤바뀝니다. - 인터페이스를 정의합니다.
interface def FuelLine { end supply : FuelPort; end consumer : ~FuelPort; }를 추가합니다. - 파워트레인을 만듭니다. 패키지 끝에 파트
tank,engine,motor,battery,transmission, 포트output : TorquePort, 그리고bind output = transmission.output;이 있는part def Powertrain을 추가합니다. - 두 파트를 연결합니다. 파워트레인에
interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;을 추가합니다. - 샤프트를 추가합니다.
interface engineShaft : Shaft connect engine.output to transmission.engineIn;과interface motorShaft : Shaft connect motor.output to transmission.motorIn;을 추가합니다. - 상호 연결 뷰를 만듭니다. 아키텍처 → 상호 연결 뷰를 클릭한 다음 + 새 다이어그램을 클릭합니다. 표시 대상에서
Powertrain을 선택하고 만들기를 클릭합니다. - 인터페이스를 그립니다. 배터리 포트
powerOut의 핸들에서 모터의 포트powerIn으로 끌어 Interface : HighVoltageBus에 놓습니다. - 인터페이스에 이름을 붙입니다. 새 선을 선택하고 속성 패널의 이름에
hvBus를 입력합니다. - 텍스트에서 확인합니다. 모델 → 편집기를 클릭합니다. 인터페이스가 이름, 타입, 끝과 함께 파워트레인 안에 있습니다.
액션과 흐름
시작 프로젝트에는 아이템 Fuel과 Torque, 기능 ProduceTorque(F.2)와 DriveWheels(F.3), 파트 정의 세 개가 있는 패키지 VehicleBehavior가 있습니다.
- 기능을 정의합니다.
in attribute fuelDemand : Real;과out item fuel : Fuel;이 있는action def <'F.1'> SupplyFuel을 추가합니다. 꺾쇠괄호 안의 짧은 이름이 기능 번호입니다. - 주행 사이클을 작성합니다.
first start then split;,fork split;,then supply;,then produce;, 그리고 각각duration이 있는 단계action supply : SupplyFuel과action produce : ProduceTorque로 구성된action def <'F'> DriveCycle을 추가합니다. - 흐름을 추가합니다. 주행 사이클에
flow of Fuel from supply.fuel to produce.fuel;을 추가합니다. - 분기를 합칩니다.
first supply then ready;,first produce then ready;,join ready;,then action drive : DriveWheels { … },then done;,flow produce.torque to drive.torque;를 추가합니다. - 액션 흐름 뷰를 만듭니다. 동작 → 액션 흐름을 클릭한 다음 + 새 다이어그램을 클릭하고, 표시 대상에서
DriveCycle을 선택합니다. - 각 단계를 누가 수행하는지 지정합니다.
perform action trip : DriveCycle;과 파트tank,engine,transmission이 있는part def DrivenCar를 추가하고, 각 파트에perform trip.supply;,perform trip.produce;또는perform trip.drive;를 넣습니다. 뷰에 파트마다 스윔레인이 생깁니다. - 기능 분석을 엽니다. 동작 → 기능 분석을 클릭하고 선택…을 클릭한 다음
DriveCycle을 고릅니다. - 다른 액션을 선언합니다.
action def EmergencyShutdown;을 추가합니다. - FFBD에서 단계를 만듭니다. 동작 → FFBD를 클릭한 다음 + 새 다이어그램을 클릭하고
EmergencyShutdown을 선택합니다. 추가 패널에Open Contactors를 입력하고 Enter를 누른 다음Cut Fuel을 입력합니다. - 텍스트에서 단계를 확인합니다. 모델 → 편집기를 클릭합니다. FFBD가 단계와 그 후속 관계를 작성해 두었습니다.
상태와 전이
시작 프로젝트에는 빈 part def Car가 있는 패키지 PowertrainBehavior가 있습니다.
- 신호를 정의합니다.
attribute def StartRequest;를 추가하고,StopRequest,PlugIn,Unplug도 같은 방식으로 추가합니다. - 상태 정의를 작성합니다.
in attribute charge : Real;,entry; then off;, 그리고 상태off,electric,hybrid가 있는state def PowertrainStates를 추가합니다. - 전이를 추가합니다.
state off;뒤에accept StartRequest if charge > 20 then electric;과accept StartRequest then hybrid;를 추가합니다. - 상태에 액션을 줍니다.
state electric;을entry action spinUpMotor;,do action driveElectric;,exit action holdMotor;를 담은 본문으로 바꿉니다. - electric 상태에서 나가게 합니다. 그 뒤에
if charge < 15 then hybrid;와accept StopRequest then off;를 추가하고,state hybrid;뒤에도accept StopRequest then off;를 추가합니다. - 이름 있는 전이가 있는 상태를 추가합니다.
state charging { do action chargeBattery; },transition plugIn first off accept PlugIn then charging;,transition unplugged first charging accept Unplug then off;를 추가합니다. - 상태 전이 뷰를 만듭니다. 동작 → 상태 머신을 클릭한 다음 + 새 다이어그램을 클릭하고, 표시 대상에서
PowertrainStates를 선택합니다. - 시간 지정 전이를 그립니다.
charging의 핸들에서off로 끌어 Transition에 놓습니다. 전이 패널에서 이름에charged를, 트리거에after 30 [min]을 입력합니다. - 텍스트에서 확인합니다. 모델 → 편집기를 클릭합니다. 전이가 이름 있는 전이로 작성되어 있습니다.
- 자동차가 상태를 나타내게 합니다.
Car에exhibit state powertrainStates : PowertrainStates;를 추가합니다.
요구사항
시작 프로젝트에는 설계의 작은 사본인 Battery, Car, 그리고 공차 질량이 1580 kg인 차량군의 sedan이 있는 패키지 VehicleRequirements가 있습니다.
- 한계값에 이름을 붙입니다.
attribute maxCurbMass : MassValue = 1650 [kg];과attribute minBatteryCapacity : EnergyValue = 1.2 [kW*h];를 추가합니다. - 요구사항 정의를 작성합니다.
doc문장,subject car : Car;,attribute limit : MassValue;,require constraint { car.curbMass <= limit }가 있는requirement def <'VR-1'> CurbMass를 추가합니다. - 요구사항을 삽입합니다. 빈 줄에서 ⌃⇧Space / Ctrl+Shift+Space를 누르고 요구사항 정의를 선택한 다음, 주제
battery : Battery와require constraint { battery.capacity >= minBatteryCapacity }로VR-3 BatteryCapacity를 작성합니다. - 사양 안에 요구사항을 중첩합니다.
subject car : Car;와requirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; }가 있는requirement carSpec을 추가합니다. - 무엇이 요구사항을 충족하는지 지정합니다.
satisfy carSpec by fleet.sedan;과satisfy requirement batterySpec : BatteryCapacity by fleet.sedan.battery;를 추가합니다. - 요구사항을 위반하게 합니다. 세단의 공차 질량을
1700 [kg]으로 바꿉니다. 편집기가 satisfy를 표시합니다. 세단이 더 이상 VR-1.1을 충족하지 않습니다. - 다시 충족하게 합니다. ⌘Z / Ctrl+Z를 누르거나 다시
1580 [kg]으로 바꿉니다. - 요구사항 표를 확인합니다. 니즈 및 요구사항 → 요구사항을 클릭합니다.
- 요구사항 뷰를 만듭니다. 다이어그램 페이지에서 + 새 다이어그램을 클릭하고, 요구사항 뷰를 선택한 다음 표시 대상에서
carSpec을 선택합니다. - 문장을 검사합니다. 니즈 및 요구사항 → 품질을 클릭하고 품질 검사를 클릭합니다.
검증과 추적성
시작 프로젝트에는 공차 질량 요구사항과 자동차 사양, 단계 cruise와 brake가 있는 주행 사이클, VR-6 batteryMassLimit, VR-7 stopFromCruise가 있습니다.
- 검증 케이스를 작성합니다.
subject car : Car;,objective massObjective { verify carSpec.sedanMass; },return verdict : Boolean = car.curbMass <= maxCurbMass;가 있는verification def <'VC-1'> CurbMassTest를 추가합니다. - 세단에 적용합니다.
verification <'VC-1.1'> sedanWeighing : CurbMassTest { subject car = fleet.sedan; }를 추가합니다. - 검증 케이스를 엽니다. 검증 → 검증 케이스를 클릭합니다. 단계, 결과, 상태는 모델 옆에 있는 Holarch 데이터입니다. Sedan Weighing 행에서 + 단계를 클릭한 다음 + 단계 추가를 클릭하고, Action 아래에
Weigh the car를 입력한 다음 적용을 클릭합니다. 그런 다음 상태 버튼에서 통과를 클릭합니다. - RVTM을 읽습니다. 검증 → RVTM을 클릭합니다.
- 단계를 요구사항으로 추적합니다. 검증 → 추적성 매트릭스를 클릭하고, 요구사항을 행으로, 액션을 열로 표시한 다음,
stopFromCruise와brake의 셀을 클릭하고 satisfied by를 선택합니다. - 요구사항을 파생합니다.
private import RequirementDerivation::*;와connection batteryMassDerivation : Derivation connect carSpec.sedanMass to batteryMassLimit;을 추가합니다. - 모델 검사를 실행합니다. 검증 → 모델 검사를 클릭합니다.
제약 조건과 계산
시작 프로젝트에는 엔진, 배터리, 자동차, 세단의 값이 있는 패키지 VehicleAnalysis와 목표값 maxCurbMass, minPowerToWeight가 있습니다.
- 제약 조건 정의를 작성합니다.
in mass : MassValue;,in limit : MassValue;, 그리고 식mass <= limit이 있는constraint def MassLimit을 추가합니다. - 계산을 작성합니다. 매개변수
power와mass, 그리고return ratio = power / mass;가 있는calc def PowerToWeight를 추가합니다. - 세단의 값을 바인딩합니다.
constraint sedanMassCheck : MassLimit { in mass = fleet.sedan.curbMass; in limit = maxCurbMass; }를 추가합니다. - 파라메트릭 뷰를 만듭니다. 다이어그램 페이지에서 + 새 다이어그램을 클릭하고, 파라메트릭 뷰를 선택한 다음 표시 대상에서
VehicleAnalysis를 선택합니다. 검사가 통과합니다. 1580 kg은 1650 kg 이내입니다. - 검사가 실패하게 합니다. 세단의 공차 질량을
1700 [kg]으로 바꿉니다. 뷰에 검사 실패가 표시됩니다. - 다시 통과하게 합니다. 실행 취소하거나 다시
1580 [kg]으로 바꿉니다. 모두 풀기는 모든 제약 조건을 다시 검사합니다. - 분석 케이스를 실행합니다.
ratio >= minPowerToWeight를 요구하는 목표가 있는analysis def PowerToWeightAnalysis와analysis sedanPowerToWeight : PowerToWeightAnalysis { subject car = fleet.sedan; }를 추가합니다. - 미결 값을 표시합니다.
private import HolarchMetadata::*;를 추가하고, 시간 한계값에#TBR을, 충전기 전력에 담당자, 마감일, 근거가 있는@TBD를 단 요구사항 VR-5ChargeTime을 추가합니다.TBD와TBR은 SysML v2 표준 라이브러리가 아니라 Holarch의HolarchMetadata라이브러리에서 오며, 표준StatusInfo메타데이터를 특수화합니다. - TBD/TBR 등록부를 엽니다. 니즈 및 요구사항 → TBD/TBR을 클릭합니다. 충전 시간이
@TBD메타데이터의 담당자 및 마감일과 함께 나열됩니다. 등록부는 읽기 전용입니다. 담당자나 날짜는 편집기에서 메타데이터를 고쳐 바꿉니다. - 질량을 합산합니다. 아키텍처 → 예산 및 TPM을 클릭하고 루트 파트
sedan을 선택합니다.
변형과 구성
시작 프로젝트에는 Component, Battery, Controller, Car, Powertrain이 있습니다.
- 가변성 패키지를 임포트합니다.
private import HolarchVariability::*;를 추가합니다. - 가변 요소를 작성합니다. 빈 줄에서 ⌃⇧Space / Ctrl+Shift+Space를 누르고(또는 삽입 ▾을 클릭하고) 가변 요소를 선택한 다음, 변형
standardPack(1.4 kWh)과largePack(12 kWh, 120 kg)으로variation part def BatteryPack :> Battery를 완성합니다. - 제품 라인을 작성합니다.
part pack : BatteryPack;, 변형noCharger와wallbox가 있는variation part charger, 그리고assert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack }가 있는part def CarLine :> Car를 추가합니다. - 구성을 시작합니다. 삽입 ▾ → Configuration을 선택하고
part plugInHybrid : CarLine { @HolarchConfiguration; }를 채웁니다. 편집기가 아직 열려 있는 가변 지점을 알려 줍니다. - 변형을 선택합니다.
plugInHybrid안에서 각 지점마다 삽입 ▾ → 변형 선택을 선택하고part :>> pack = BatteryPack::largePack;과part :>> charger = charger::wallbox;를 채웁니다. - 두 번째 구성을 추가합니다. 표준 팩을 쓰고 충전기가 없는
selfChargingHybrid를 같은 방식으로 추가합니다. - 직접 키워드를 정의합니다.
metadata def <safetyCritical> SafetyCritical을 추가합니다. - 키워드를 사용합니다.
Powertrain안에#safetyCritical part controller : Controller;를 작성합니다. - 제품 라인을 확인합니다.
Vehicles의 일반 뷰를 만듭니다. 배터리 팩이 가변 요소로 표시됩니다.
튜토리얼 프로젝트
SysML v2 튜토리얼 프로젝트는 다른 튜토리얼 프로젝트와 같은 규칙을 따릅니다. 요금제의 활성 프로젝트 수에 포함되지 않고, 항목을 최대 300개까지 담을 수 있으며, 튜토리얼마다 하나씩 만들 수 있습니다. 튜토리얼을 참조하십시오.
관련 항목
SysML® 및 OMG®는 미국 및 기타 국가에서 Object Management Group, Inc.의 등록 상표입니다.