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.
Bu sayfada
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.
| Öğretici | Süre | Öğrendikleriniz |
|---|---|---|
| Başlarken | 15 dk | SysML 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 öznitelikler | 20 dk | numaralandı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üzler | 20 dk | portları 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ışlar | 20 dk | eylem 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şler | 20 dk | sinyaller ve tetikleyiciler, koşullar ve durum eylemleri olan bir durum makinesi yazın ve zamanlı bir geçiş çizin |
| Gereksinimler | 20 dk | sı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 izlenebilirlik | 15 dk | bir doğrulama durumu yazın, İzlenebilirlik Matrisi'nde bir adımı izleyin ve bir gereksinim türetin |
| Kısıtlar ve hesaplamalar | 20 dk | kı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ürasyonlar | 15 dk | varyasyonlar 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
- Rayda Yardım → Öğreticiler'i açın veya ⌘K / Ctrl+K'ya basıp
tutorialyazı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. - 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.
- 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.
- Bir numaralandırma yazın.
part def Car {satırının üstüneenum def DriveMode { enum economy; enum normal; enum sport; }ekleyin (satır başına bir değer). - Bir değer türü tanımlayın. Altına
attribute def TirePressure :> ScalarValue;ekleyin.:>özelleştirir anlamına gelir. - Soyut bir tanım yazın. Bir
docyorumu vemass : MassValue,partNumber : Stringvepower : PowerValueöznitelikleriyleabstract part def Componentekleyin.//yalnızca metinde kalan bir not başlatır. - Denetleyicinin bir hata bulmasına izin verin.
attribute redefines mass = 45 [kg];ve bilerekattribute redefines power = 60 [kg];ilepart def Battery :> Componentekleyin. Denetleyici birimin altını çizer: kilogram bir güç değildir. - Birimi düzeltin. Onu
60 [W]olarak değiştirin. - Bir adı tamamlayın. Bataryada
attribute capacity : Eneryazın, tamamlama listesindenEnergyValue'yu Enter ile kabul edin ve;ile bitirin. - Standart kitaplıkta arayın. Rayın altındaki Ayarlar → Standart kitaplık'a tıklayın ve bulma kutusuna
EnergyValueyazın. - 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'iattribute redefines mass = 110 [kg];veattribute cylinders : Integer;ile tamamlayın. - Tanımları kullanın.
Cariçineattribute mode : DriveMode;,part battery : Battery;vepart engine : Engine;ekleyin. - Her yerde yeniden adlandırın. İmleci
cylindersüzerine getirin, F2'ye basın ve adınıcylinderCountolarak 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.
- Bir port tanımlayın.
port def TorquePortsatırının üstüneout attribute flowRate : Real;veattribute kind : FuelKind;ileport def FuelPortekleyin.out, değerin portun sahibi olan parçadan çıktığı anlamına gelir. - Parçalara portlarını verin.
FuelTank'aport fuelOut : FuelPort;veEngine'eport fuelIn : ~FuelPort;ekleyin.~portu eşlenik yapar: giriş ve çıkış yer değiştirir. - Bir arayüz tanımlayın.
interface def FuelLine { end supply : FuelPort; end consumer : ~FuelPort; }ekleyin. - Aktarma organını oluşturun. Paketin sonuna
tank,engine,motor,batteryvetransmissionparçaları, biroutput : TorquePortportu vebind output = transmission.output;ilepart def Powertrainekleyin. - İki parçayı bağlayın. Aktarma organına
interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;ekleyin. - Milleri ekleyin.
interface engineShaft : Shaft connect engine.output to transmission.engineIn;veinterface motorShaft : Shaft connect motor.output to transmission.motorIn;ekleyin. - 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. - Bir arayüz çizin. Bataryanın
powerOutportunun tutamacından motorunpowerInportuna sürükleyin ve Interface : HighVoltageBus üzerine bırakın. - Arayüzü adlandırın. Yeni çizgiyi seçin ve özellik panelinde Ad olarak
hvBusgirin. - 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.
- Bir işlev tanımlayın.
in attribute fuelDemand : Real;veout item fuel : Fuel;ileaction def <'F.1'> SupplyFuelekleyin. Açılı parantez içindeki kısa ad işlev numarasıdır. - Sürüş döngüsünü yazın.
first start then split;,fork split;,then supply;,then produce;ve her biri birdurationiçerenaction supply : SupplyFuelveaction produce : ProduceTorqueadımlarıylaaction def <'F'> DriveCycleekleyin. - Bir akış ekleyin. Sürüş döngüsüne
flow of Fuel from supply.fuel to produce.fuel;ekleyin. - Dalları birleştirin.
first supply then ready;,first produce then ready;,join ready;,then action drive : DriveWheels { … },then done;veflow produce.torque to drive.torque;ekleyin. - 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. - Her adımı kimin gerçekleştirdiğini belirtin.
perform action trip : DriveCycle;ve her biriperform trip.supply;,perform trip.produce;veyaperform trip.drive;içerentank,enginevetransmissionparçalarıylapart def DrivenCarekleyin. Görünüm parça başına bir kulvar alır. - İşlevsel Analiz'i açın. Davranış → İşlevsel Analiz'e tıklayın, Seç…'e tıklayın ve
DriveCycle'ı seçin. - Başka bir eylem bildirin.
action def EmergencyShutdown;ekleyin. - FFBD'de adımlar oluşturun. Davranış → FFBD'ye, ardından + Yeni diyagram'a tıklayın ve
EmergencyShutdown'ı seçin. Ekle panelindeOpen Contactorsyazıp Enter'a basın, ardındanCut Fuelyazın. - 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.
- Sinyalleri tanımlayın.
attribute def StartRequest;ekleyin;StopRequest,PlugInveUnplug'ı da aynı şekilde ekleyin. - Bir durum tanımı yazın.
in attribute charge : Real;,entry; then off;veoff,electricvehybriddurumlarıylastate def PowertrainStatesekleyin. - Geçişler ekleyin.
state off;satırından sonraaccept StartRequest if charge > 20 then electric;veaccept StartRequest then hybrid;ekleyin. - Bir duruma eylemlerini verin.
state electric;satırınıentry action spinUpMotor;,do action driveElectric;veexit action holdMotor;içeren bir gövdeyle değiştirin. - Elektrik durumundan çıkın. Ondan sonra
if charge < 15 then hybrid;veaccept StopRequest then off;ekleyin;state hybrid;satırından sonra daaccept StopRequest then off;ekleyin. - Adlandırılmış geçişleri olan bir durum ekleyin.
state charging { do action chargeBattery; },transition plugIn first off accept PlugIn then charging;vetransition unplugged first charging accept Unplug then off;ekleyin. - 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. - Zamanlı bir geçiş çizin.
chargingtutamacındanoff'a sürükleyin ve Geçiş üzerine bırakın. Geçiş panelinde Ad olarakchargedve Tetikleyici olarakafter 30 [min]girin. - Metinde görün. Model → Düzenleyici'ye tıklayın: geçiş adlandırılmış bir geçiş olarak yazılmıştır.
- Arabanın durumları sergilemesini sağlayın.
Cariçineexhibit 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'ı.
- Sınırları adlandırın.
attribute maxCurbMass : MassValue = 1650 [kg];veattribute minBatteryCapacity : EnergyValue = 1.2 [kW*h];ekleyin. - Bir gereksinim tanımı yazın. Bir
docifadesi,subject car : Car;,attribute limit : MassValue;verequire constraint { car.curbMass <= limit }ilerequirement def <'VR-1'> CurbMassekleyin. - Bir gereksinim ekleyin. Boş bir satırda ⌃⇧Space / Ctrl+Shift+Space'e basın, Gereksinim tanımı'nı seçin ve
battery : Batterykonusu verequire constraint { battery.capacity >= minBatteryCapacity }ileVR-3 BatteryCapacityyazın. - Gereksinimleri bir spesifikasyonun içine yerleştirin.
subject car : Car;verequirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; }ilerequirement carSpecekleyin. - Onları neyin karşıladığını belirtin.
satisfy carSpec by fleet.sedan;vesatisfy requirement batterySpec : BatteryCapacity by fleet.sedan.battery;ekleyin. - 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. - Yeniden karşılayın. ⌘Z / Ctrl+Z'ye basın veya değeri
1580 [kg]olarak geri değiştirin. - Gereksinimler tablosunu görün. İhtiyaçlar ve gereksinimler → Gereksinimler'e tıklayın.
- 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. - İ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.
- Bir doğrulama durumu yazın.
subject car : Car;,objective massObjective { verify carSpec.sedanMass; }vereturn verdict : Boolean = car.curbMass <= maxCurbMass;ileverification def <'VC-1'> CurbMassTestekleyin. - Onu sedana uygulayın.
verification <'VC-1.1'> sedanWeighing : CurbMassTest { subject car = fleet.sedan; }ekleyin. - 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 caryazın ve Uygula'ya tıklayın. Ardından durum düğmelerinden Başarılı'ya tıklayın. - RVTM'yi okuyun. Doğrulama → RVTM'ye tıklayın.
- Bir adımı bir gereksinime izleyin. Doğrulama → İzlenebilirlik Matrisi'ne tıklayın, gereksinimleri satır, eylemleri sütun olarak gösterin,
stopFromCruiseilebrake'in hücresine tıklayın ve satisfied by'ı seçin. - Bir gereksinim türetin.
private import RequirementDerivation::*;veconnection batteryMassDerivation : Derivation connect carSpec.sedanMass to batteryMassLimit;ekleyin. - 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.
- Bir kısıt tanımı yazın.
in mass : MassValue;,in limit : MassValue;vemass <= limitifadesiyleconstraint def MassLimitekleyin. - Bir hesaplama yazın.
powervemassparametreleri vereturn ratio = power / mass;ilecalc def PowerToWeightekleyin. - Sedanın değerlerini bağlayın.
constraint sedanMassCheck : MassLimit { in mass = fleet.sedan.curbMass; in limit = maxCurbMass; }ekleyin. - 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. - 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. - 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. - Bir analiz durumu çalıştırın.
ratio >= minPowerToWeightgerektiren bir hedefleanalysis def PowerToWeightAnalysisveanalysis sedanPowerToWeight : PowerToWeightAnalysis { subject car = fleet.sedan; }ekleyin. - 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@TBDbulunan VR-5ChargeTimegereksinimini ekleyin.TBDveTBR, SysML v2 standart kitaplığından değil, Holarch'ınHolarchMetadatakitaplığından gelir; standartStatusInfoüst verisini özelleştirirler. - 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. - 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.
- Değişkenlik paketini içe aktarın.
private import HolarchVariability::*;ekleyin. - 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'yistandardPack(1,4 kWh) velargePack(12 kWh, 120 kg) varyantlarıyla tamamlayın. - Ürün hattını yazın.
part pack : BatteryPack;,noChargervewallboxvaryantlarını içeren birvariation part chargerveassert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack }ilepart def CarLine :> Carekleyin. - 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. - Varyantları seçin.
plugInHybridiçinde her nokta için Ekle ▾ → Varyant seçimi'ni seçin vepart :>> pack = BatteryPack::largePack;vepart :>> charger = charger::wallbox;yazın. - İkinci bir konfigürasyon ekleyin.
selfChargingHybrid'i aynı şekilde, standart paket ve şarj cihazı olmadan ekleyin. - Kendinize ait bir anahtar sözcük tanımlayın.
metadata def <safetyCritical> SafetyCriticalekleyin. - Anahtar sözcüğü kullanın.
Powertrainiçine#safetyCritical part controller : Controller;yazın. - Ürün hattını görün.
Vehiclesiç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.
İlgili
- Öğreticiler
- SysML v2 projelerine başlarken
- Metin düzenleyici ve Gezgin
- Metinsel gösterim
- Görünümler
- SysML v2 projelerinde gereksinimler
SysML® ve OMG®, Object Management Group, Inc.'in Amerika Birleşik Devletleri'nde ve diğer ülkelerde tescilli ticari markalarıdır.