Holarch

SysML v2

SysML v2 öğreticileri

SysML v2 projeleri için dokuz rehberli öğretici: ilk paketten portlara, eylemlere, durumlara, gereksinimlere, doğrulamaya, kısıtlara ve varyantlara kadar; çalışmanızı denetleyen bir adım paneliyle.

Nasıl kullanılır →

Bu sayfada
  1. Nasıl kullanılır
    1. Bir SysML v2 öğreticisi başlatın
    2. Bir adımın metnini yazın
    3. İpuçları
  2. Başlarken
  3. Tanımlar ve öznitelikler
  4. Portlar ve arayüzler
  5. Eylemler ve akışlar
  6. Durumlar ve geçişler
  7. Gereksinimler
  8. Doğrulama ve izlenebilirlik
  9. Kısıtlar ve hesaplamalar
  10. Varyantlar ve konfigürasyonlar
  11. Öğretici projeleri
  12. İlgili

Holarch'ta SysML v2 projeleri için bir dizi rehberli öğretici vardır. Her biri küçük bir SysML v2 başlangıç projesi oluşturur ve sayfanın yanında bir adım paneli açar. Panel siz çalışırken modeli denetler: model adımın istediğini içerdiğinde adım yeşile döner. Bu sayfa her adımı metin olarak listeler; böylece buradan da takip edebilirsiniz.

İlk öğretici, LML öğreticilerinde olduğu gibi WS-1 Weather Station'ı kullanır. Diğerleri Hybrid Car demosunun modeli olan bir hibrit arabanın parçalarını oluşturur: değer türleri ve bileşenler, aktarma organının portları ve arayüzleri, bir sürüş döngüsü, aktarma organının durumları, arabanın gereksinimleri, bunların doğrulanması, sedanın değerleri üzerindeki denetimler ve ürün hattı. Her öğreticinin kendi başlangıç projesi vardır; böylece onları istediğiniz sırayla alabilirsiniz. Her başlangıç projesi ve tamamlanmış her öğretici 0 sorunla denetlenir.

ÖğreticiSüreÖğrendikleriniz
Başlarken15 dkSysML v2 metni yazın, onu bir ağaç ve bir görünüm olarak görün, görünümde çizin ve bir gereksinim ekleyin
Tanımlar ve öznitelikler20 dknumaralandırmalar, değer türleri ve soyut tanımlar yazın, değerler ve birimlerle özelleştirin; tamamlama, Ekle ve yeniden adlandırmayı kullanın
Portlar ve arayüzler20 dkportları ve arayüzleri tanımlayın, portları eşlenik yapın, parçaları bağlayın ve bir Interconnection View'da bir arayüz çizin
Eylemler ve akışlar20 dkeylem tanımları ve çatallanma, akışlar ve birleşim içeren bir sürüş döngüsü yazın, kulvarlar ekleyin ve FFBD'de adımlar oluşturun
Durumlar ve geçişler20 dksinyaller ve tetikleyiciler, koşullar ve durum eylemleri olan bir durum makinesi yazın ve zamanlı bir geçiş çizin
Gereksinimler20 dksınırlar, gereksinim tanımları ve kullanımları yazın, bunları karşılayın ve karşılanmayan bir gereksinimi görün
Doğrulama ve izlenebilirlik15 dkbir doğrulama durumu yazın, İzlenebilirlik Matrisi'nde bir adımı izleyin ve bir gereksinim türetin
Kısıtlar ve hesaplamalar20 dkkısıtlar ve hesaplamalar yazın, bir Parametrik görünümde değerleri bağlayın, bir analiz durumu çalıştırın ve TBD ve TBR değerlerini işaretleyin
Varyantlar ve konfigürasyonlar15 dkvaryasyonlar ve varyantlar, kurallı bir ürün hattı, konfigürasyonlar ve kendinize ait bir anahtar sözcük yazın

Nasıl kullanılır

Bir SysML v2 öğreticisi başlatın

  1. Rayda Yardım → Öğreticiler'i açın veya ⌘K / Ctrl+K'ya basıp tutorial yazın. Proje dışında Öğreticiler sayfası önce LML öğreticilerini, ardından SysML v2 projeleri için eğitimler'i listeler. Bir SysML v2 projesinin içinde yalnızca SysML v2 öğreticilerini listeler.
  2. Bir kartta Başlat'a tıklayın. Holarch projeyi (örneğin Tutorial: SysML v2 Ports and Interfaces (Hybrid Car)) oluşturur ve sağda adım paneliyle açar.

Adım paneli LML öğreticilerindeki gibi çalışır: Bana göster bir adımın gerektirdiği denetimi çerçeveler, Oraya git sayfayı açar, Devamını oku Yardım konusunu açar; Yeniden başlat…, Tamamlandı olarak işaretle ve × aynı şekilde çalışır. Bkz. Öğreticiler.

Bir adımın metnini yazın

Çoğu adım Model → Düzenleyici'de yazılacak SysML metni verir. Adım, satırların nereye gideceğini söyler; örneğin “paketin son kapanış süslü parantezinden önce”. Metin, yazmaya ara verdiğinizde modele uygulanır; düzenleyicinin altındaki durum bunu belirtir ve adım yeşile döner.

  • Satırları gösterildiği gibi yazın. Girinti model için önemli değildir; Düzenleyici sizinkini korur.
  • Kırmızı bir alt çizgi bir hatayı işaretler: iletiyi okumak için üzerine gelin. Sözdizimi hatası olan metin taslak olarak kalır ve siz düzeltene kadar uygulanmaz.
  • ⌘Z / Ctrl+Z son uygulanan değişikliği geri alır.

İpuçları

  • Öğreticileri ilk seferde sırayla alın: her biri kullandığı metni açıklar ve sonrakiler önceki fikirleri (tanımlar ve kullanımlar, :> ve :>>) bildiğinizi varsayar.
  • Açık kalan bir adımda genellikle bir adda yazım hatası vardır. Metninizi adımın satırlarıyla karşılaştırın; SysML v2'de adlar büyük/küçük harfe duyarlıdır.
  • Öğreticiler SysML v2 temelleri ile aynı dili öğretir; ayrıntılar Metinsel gösterim sayfasındadır.

Başlarken

Weather Station'ın ilk modelini yazın: metni açın, değeri ve birimi olan bir parça tanımı ekleyin, onu başka bir tanımda kullanın, modeli Gezgin'de ve bir General View'da görün, görünümde bir parça çizin ve metinde belirdiğini izleyin, satisfy ile bir gereksinim ekleyin ve modeli .sysml dosyası olarak dışa aktarın. Adımlar SysML v2 projelerine başlarken sayfasında anlatılır.

Tanımlar ve öznitelikler

Başlangıç projesinde tek bir parça tanımı (Car) içeren Vehicles paketi vardır.

  1. Paketi açın. Model → Düzenleyici'ye tıklayın. Her bildirim bir anahtar sözcük ve bir addır; ardından süslü parantez içinde bir gövde veya bir noktalı virgül gelir.
  2. Bir numaralandırma yazın. part def Car { satırının üstüne enum def DriveMode { enum economy; enum normal; enum sport; } ekleyin (satır başına bir değer).
  3. Bir değer türü tanımlayın. Altına attribute def TirePressure :> ScalarValue; ekleyin. :> özelleştirir anlamına gelir.
  4. Soyut bir tanım yazın. Bir doc yorumu ve mass : MassValue, partNumber : String ve power : PowerValue öznitelikleriyle abstract part def Component ekleyin. // yalnızca metinde kalan bir not başlatır.
  5. Denetleyicinin bir hata bulmasına izin verin. attribute redefines mass = 45 [kg]; ve bilerek attribute redefines power = 60 [kg]; ile part def Battery :> Component ekleyin. Denetleyici birimin altını çizer: kilogram bir güç değildir.
  6. Birimi düzeltin. Onu 60 [W] olarak değiştirin.
  7. Bir adı tamamlayın. Bataryada attribute capacity : Ener yazın, tamamlama listesinden EnergyValue'yu Enter ile kabul edin ve ; ile bitirin.
  8. Standart kitaplıkta arayın. Rayın altındaki Ayarlar → Standart kitaplık'a tıklayın ve bulma kutusuna EnergyValue yazın.
  9. Bir tanım ekleyin. Düzenleyici'de boş bir satırda ⌃⇧Space / Ctrl+Shift+Space'e basın (veya Ekle ▾'ye tıklayın), Parça tanımı'nı seçin ve part def Engine :> Component'i attribute redefines mass = 110 [kg]; ve attribute cylinders : Integer; ile tamamlayın.
  10. Tanımları kullanın. Car içine attribute mode : DriveMode;, part battery : Battery; ve part engine : Engine; ekleyin.
  11. Her yerde yeniden adlandırın. İmleci cylinders üzerine getirin, F2'ye basın ve adını cylinderCount olarak değiştirin.

Portlar ve arayüzler

Başlangıç projesinde tork ve güç portlarıyla aktarma organının bileşenleri, TorquePort ve PowerPort port tanımları ve Shaft ve HighVoltageBus arayüz tanımları vardır.

  1. Bir port tanımlayın. port def TorquePort satırının üstüne out attribute flowRate : Real; ve attribute kind : FuelKind; ile port def FuelPort ekleyin. out, değerin portun sahibi olan parçadan çıktığı anlamına gelir.
  2. Parçalara portlarını verin. FuelTank'a port fuelOut : FuelPort; ve Engine'e port fuelIn : ~FuelPort; ekleyin. ~ portu eşlenik yapar: giriş ve çıkış yer değiştirir.
  3. Bir arayüz tanımlayın. interface def FuelLine { end supply : FuelPort; end consumer : ~FuelPort; } ekleyin.
  4. Aktarma organını oluşturun. Paketin sonuna tank, engine, motor, battery ve transmission parçaları, bir output : TorquePort portu ve bind output = transmission.output; ile part def Powertrain ekleyin.
  5. İki parçayı bağlayın. Aktarma organına interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn; ekleyin.
  6. Milleri ekleyin. interface engineShaft : Shaft connect engine.output to transmission.engineIn; ve interface motorShaft : Shaft connect motor.output to transmission.motorIn; ekleyin.
  7. Bir Interconnection View oluşturun. Mimari → Interconnection View'lar'a, ardından + Yeni diyagram'a tıklayın. Gösterir altında Powertrain'i seçin ve Oluştur'a tıklayın.
  8. Bir arayüz çizin. Bataryanın powerOut portunun tutamacından motorun powerIn portuna sürükleyin ve Interface : HighVoltageBus üzerine bırakın.
  9. Arayüzü adlandırın. Yeni çizgiyi seçin ve özellik panelinde Ad olarak hvBus girin.
  10. Metinde görün. Model → Düzenleyici'ye tıklayın: arayüz, adı, türü ve uçlarıyla aktarma organının içindedir.

Eylemler ve akışlar

Başlangıç projesinde Fuel ve Torque item'ları, ProduceTorque (F.2) ve DriveWheels (F.3) işlevleri ve üç parça tanımı içeren VehicleBehavior paketi vardır.

  1. Bir işlev tanımlayın. in attribute fuelDemand : Real; ve out item fuel : Fuel; ile action def <'F.1'> SupplyFuel ekleyin. Açılı parantez içindeki kısa ad işlev numarasıdır.
  2. Sürüş döngüsünü yazın. first start then split;, fork split;, then supply;, then produce; ve her biri bir duration içeren action supply : SupplyFuel ve action produce : ProduceTorque adımlarıyla action def <'F'> DriveCycle ekleyin.
  3. Bir akış ekleyin. Sürüş döngüsüne flow of Fuel from supply.fuel to produce.fuel; ekleyin.
  4. Dalları birleştirin. first supply then ready;, first produce then ready;, join ready;, then action drive : DriveWheels { … }, then done; ve flow produce.torque to drive.torque; ekleyin.
  5. Bir Action Flow View oluşturun. Davranış → Action akışları'na, ardından + Yeni diyagram'a tıklayın ve Gösterir altında DriveCycle'ı seçin.
  6. Her adımı kimin gerçekleştirdiğini belirtin. perform action trip : DriveCycle; ve her biri perform trip.supply;, perform trip.produce; veya perform trip.drive; içeren tank, engine ve transmission parçalarıyla part def DrivenCar ekleyin. Görünüm parça başına bir kulvar alır.
  7. İşlevsel Analiz'i açın. Davranış → İşlevsel Analiz'e tıklayın, Seç…'e tıklayın ve DriveCycle'ı seçin.
  8. Başka bir eylem bildirin. action def EmergencyShutdown; ekleyin.
  9. FFBD'de adımlar oluşturun. Davranış → FFBD'ye, ardından + Yeni diyagram'a tıklayın ve EmergencyShutdown'ı seçin. Ekle panelinde Open Contactors yazıp Enter'a basın, ardından Cut Fuel yazın.
  10. Adımları metinde görün. Model → Düzenleyici'ye tıklayın: FFBD adımları ve ardışıklıklarını yazmıştır.

Durumlar ve geçişler

Başlangıç projesinde boş bir part def Car içeren PowertrainBehavior paketi vardır.

  1. Sinyalleri tanımlayın. attribute def StartRequest; ekleyin; StopRequest, PlugIn ve Unplug'ı da aynı şekilde ekleyin.
  2. Bir durum tanımı yazın. in attribute charge : Real;, entry; then off; ve off, electric ve hybrid durumlarıyla state def PowertrainStates ekleyin.
  3. Geçişler ekleyin. state off; satırından sonra accept StartRequest if charge > 20 then electric; ve accept StartRequest then hybrid; ekleyin.
  4. Bir duruma eylemlerini verin. state electric; satırını entry action spinUpMotor;, do action driveElectric; ve exit action holdMotor; içeren bir gövdeyle değiştirin.
  5. Elektrik durumundan çıkın. Ondan sonra if charge < 15 then hybrid; ve accept StopRequest then off; ekleyin; state hybrid; satırından sonra da accept StopRequest then off; ekleyin.
  6. Adlandırılmış geçişleri olan bir durum ekleyin. state charging { do action chargeBattery; }, transition plugIn first off accept PlugIn then charging; ve transition unplugged first charging accept Unplug then off; ekleyin.
  7. Bir Durum geçişi görünümü oluşturun. Davranış → Durum makineleri'ne, ardından + Yeni diyagram'a tıklayın ve Gösterir altında PowertrainStates'i seçin.
  8. Zamanlı bir geçiş çizin. charging tutamacından off'a sürükleyin ve Geçiş üzerine bırakın. Geçiş panelinde Ad olarak charged ve Tetikleyici olarak after 30 [min] girin.
  9. Metinde görün. Model → Düzenleyici'ye tıklayın: geçiş adlandırılmış bir geçiş olarak yazılmıştır.
  10. Arabanın durumları sergilemesini sağlayın. Car içine exhibit state powertrainStates : PowertrainStates; ekleyin.

Gereksinimler

Başlangıç projesinde tasarımın küçük bir kopyasını içeren VehicleRequirements paketi vardır: Battery, Car ve filonun 1580 kg boş ağırlıklı sedan'ı.

  1. Sınırları adlandırın. attribute maxCurbMass : MassValue = 1650 [kg]; ve attribute minBatteryCapacity : EnergyValue = 1.2 [kW*h]; ekleyin.
  2. Bir gereksinim tanımı yazın. Bir doc ifadesi, subject car : Car;, attribute limit : MassValue; ve require constraint { car.curbMass <= limit } ile requirement def <'VR-1'> CurbMass ekleyin.
  3. Bir gereksinim ekleyin. Boş bir satırda ⌃⇧Space / Ctrl+Shift+Space'e basın, Gereksinim tanımı'nı seçin ve battery : Battery konusu ve require constraint { battery.capacity >= minBatteryCapacity } ile VR-3 BatteryCapacity yazın.
  4. Gereksinimleri bir spesifikasyonun içine yerleştirin. subject car : Car; ve requirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; } ile requirement carSpec ekleyin.
  5. Onları neyin karşıladığını belirtin. satisfy carSpec by fleet.sedan; ve satisfy requirement batterySpec : BatteryCapacity by fleet.sedan.battery; ekleyin.
  6. Bir gereksinimi bozun. Sedanın boş ağırlığını 1700 [kg] olarak değiştirin. Düzenleyici satisfy satırını işaretler: sedan artık VR-1.1'i karşılamaz.
  7. Yeniden karşılayın. ⌘Z / Ctrl+Z'ye basın veya değeri 1580 [kg] olarak geri değiştirin.
  8. Gereksinimler tablosunu görün. İhtiyaçlar ve gereksinimler → Gereksinimler'e tıklayın.
  9. Bir Gereksinim görünümü oluşturun. Diyagramlar sayfasında + Yeni diyagram'a tıklayın, Gereksinim görünümü'nü ve Gösterir altında carSpec'i seçin.
  10. İfadeleri denetleyin. İhtiyaçlar ve gereksinimler → Kalite'ye ve ardından Kaliteyi denetle'ye tıklayın.

Doğrulama ve izlenebilirlik

Başlangıç projesinde boş ağırlık gereksinimi ve araba spesifikasyonu, cruise ve brake adımlarını içeren bir sürüş döngüsü, VR-6 batteryMassLimit ve VR-7 stopFromCruise vardır.

  1. Bir doğrulama durumu yazın. subject car : Car;, objective massObjective { verify carSpec.sedanMass; } ve return verdict : Boolean = car.curbMass <= maxCurbMass; ile verification def <'VC-1'> CurbMassTest ekleyin.
  2. Onu sedana uygulayın. verification <'VC-1.1'> sedanWeighing : CurbMassTest { subject car = fleet.sedan; } ekleyin.
  3. Doğrulama durumlarını açın. Doğrulama → Doğrulama durumları'na tıklayın. Adımlar, sonuçlar ve durum, modelin yanındaki Holarch verileridir. Sedan Weighing satırında + Adımlar'a, ardından + Adım ekle'ye tıklayın, Eylem altına Weigh the car yazın ve Uygula'ya tıklayın. Ardından durum düğmelerinden Başarılı'ya tıklayın.
  4. RVTM'yi okuyun. Doğrulama → RVTM'ye tıklayın.
  5. Bir adımı bir gereksinime izleyin. Doğrulama → İzlenebilirlik Matrisi'ne tıklayın, gereksinimleri satır, eylemleri sütun olarak gösterin, stopFromCruise ile brake'in hücresine tıklayın ve satisfied by'ı seçin.
  6. Bir gereksinim türetin. private import RequirementDerivation::*; ve connection batteryMassDerivation : Derivation connect carSpec.sedanMass to batteryMassLimit; ekleyin.
  7. Model denetimlerini çalıştırın. Doğrulama → Model denetimleri'ne tıklayın.

Kısıtlar ve hesaplamalar

Başlangıç projesinde motor, batarya, araba ve sedanın değerleri ile maxCurbMass ve minPowerToWeight hedeflerini içeren VehicleAnalysis paketi vardır.

  1. Bir kısıt tanımı yazın. in mass : MassValue;, in limit : MassValue; ve mass <= limit ifadesiyle constraint def MassLimit ekleyin.
  2. Bir hesaplama yazın. power ve mass parametreleri ve return ratio = power / mass; ile calc def PowerToWeight ekleyin.
  3. Sedanın değerlerini bağlayın. constraint sedanMassCheck : MassLimit { in mass = fleet.sedan.curbMass; in limit = maxCurbMass; } ekleyin.
  4. Bir Parametrik görünüm oluşturun. Diyagramlar sayfasında + Yeni diyagram'a tıklayın, Parametrik görünüm'ü ve Gösterir altında VehicleAnalysis'i seçin. Denetim başarılı olur: 1580 kg, 1650 kg sınırının içindedir.
  5. Denetimin başarısız olmasını sağlayın. Sedanın boş ağırlığını 1700 [kg] olarak değiştirin; görünüm denetimin başarısız olduğunu gösterir.
  6. Yeniden başarılı olmasını sağlayın. Geri alın veya değeri 1580 [kg] olarak geri değiştirin. Tümünü çöz her kısıtı yeniden denetler.
  7. Bir analiz durumu çalıştırın. ratio >= minPowerToWeight gerektiren bir hedefle analysis def PowerToWeightAnalysis ve analysis sedanPowerToWeight : PowerToWeightAnalysis { subject car = fleet.sedan; } ekleyin.
  8. Açık değerleri işaretleyin. private import HolarchMetadata::*; ve süre sınırında #TBR, şarj cihazı gücünde ise sahibi, son tarihi ve gerekçesiyle @TBD bulunan VR-5 ChargeTime gereksinimini ekleyin. TBD ve TBR, SysML v2 standart kitaplığından değil, Holarch'ın HolarchMetadata kitaplığından gelir; standart StatusInfo üst verisini özelleştirirler.
  9. TBD/TBR kaydını açın. İhtiyaçlar ve gereksinimler → TBD/TBR'ye tıklayın. Şarj süresi, @TBD üst verisindeki sahip ve son tarihle listelenir. Kayıt salt okunurdur: sahibi veya tarihi Düzenleyici'deki üst veride değiştirin.
  10. Kütleyi toplayın. Mimari → Bütçeler ve TPM'ler'e tıklayın ve kök parça sedan'ı seçin.

Varyantlar ve konfigürasyonlar

Başlangıç projesinde Component, Battery, Controller, Car ve Powertrain vardır.

  1. Değişkenlik paketini içe aktarın. private import HolarchVariability::*; ekleyin.
  2. Bir varyasyon yazın. Boş bir satırda ⌃⇧Space / Ctrl+Shift+Space'e basın (veya Ekle ▾'ye tıklayın), Varyasyon'u seçin ve variation part def BatteryPack :> Battery'yi standardPack (1,4 kWh) ve largePack (12 kWh, 120 kg) varyantlarıyla tamamlayın.
  3. Ürün hattını yazın. part pack : BatteryPack;, noCharger ve wallbox varyantlarını içeren bir variation part charger ve assert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack } ile part def CarLine :> Car ekleyin.
  4. Bir konfigürasyon başlatın. Ekle ▾ → Konfigürasyon'u seçin ve part plugInHybrid : CarLine { @HolarchConfiguration; } yazın. Düzenleyici hâlâ açık olan varyasyon noktalarını belirtir.
  5. Varyantları seçin. plugInHybrid içinde her nokta için Ekle ▾ → Varyant seçimi'ni seçin ve part :>> pack = BatteryPack::largePack; ve part :>> charger = charger::wallbox; yazın.
  6. İkinci bir konfigürasyon ekleyin. selfChargingHybrid'i aynı şekilde, standart paket ve şarj cihazı olmadan ekleyin.
  7. Kendinize ait bir anahtar sözcük tanımlayın. metadata def <safetyCritical> SafetyCritical ekleyin.
  8. Anahtar sözcüğü kullanın. Powertrain içine #safetyCritical part controller : Controller; yazın.
  9. Ürün hattını görün. Vehicles için bir General View oluşturun: batarya paketi varyasyon olarak işaretlenmiştir.

Öğretici projeleri

SysML v2 öğretici projeleri diğer öğretici projeleriyle aynı kurallara uyar: planınızın etkin projelerine sayılmazlar, en fazla 300 öğe tutarlar ve her öğretici için bir tane olabilir. Bkz. Öğreticiler.

SysML® ve OMG®, Object Management Group, Inc.'in Amerika Birleşik Devletleri'nde ve diğer ülkelerde tescilli ticari markalarıdır.