SysML v2
SysML v2 metinsel gösterimi
Holarch'ın desteklediği biçimiyle SysML v2 dili; Hybrid Car demosundan örnekler, çalıştırdığı denetimler ve salt okunur Standart kitaplık.
Bu sayfada
- Genel bakış
- Kavramlar
- Öğeler, sahipler ve nitelikli adlar
- Paketler
- İçe aktarmalar ve görünürlük
- Tanımlar ve kullanımlar
- Türlendirme, özelleştirme ve yeniden tanımlama
- Çokluklar
- Değerler ve birimler
- Yapı: portlar, bağlantılar, arayüzler, bağlamalar ve akışlar
- Davranış: eylemler
- Davranış: durumlar
- Gereksinimler, kısıtlar ve doğrulama
- Kullanım senaryoları
- Görünümler
- Yorumlar, belgeler ve üst veriler
- Bireyler, anlık görüntüler ve zaman dilimleri
- Varyasyonlar, varyantlar ve konfigürasyonlar
- Metinsel gösterimler
- Nasıl kullanılır
- Çalışılmış örnek: sedanın gereksinimini okuyun
- İpuçları ve yaygın hatalar
- Holarch neleri destekler
- Denetimler
- Standart kitaplık
- Sınırlar
- İlgili sayfalar
Genel bakış
SysML v2 bir sistemi metin olarak yazılmış adlandırılmış öğelerden oluşan bir ağaç olarak tanımlar. Holarch, OMG SysML v2 spesifikasyonuna dayanan SysML v2 metinsel gösterimini destekler. Metni Düzenleyici'de yazarsınız; Holarch aynı öğeleri Gezgin'de, görünümlerde, tablolarda ve yaşam döngüsü sayfalarında gösterir.
Bu sayfa gösterimi Hybrid Car (SysML v2) demosundan örneklerle öğretir. Ardından Holarch'ın neleri desteklediğini, metninizde çalıştırdığı denetimleri ve Standart kitaplık'ı listeler.
Kavramlar
Öğeler, sahipler ve nitelikli adlar
Üst düzey paketler dışında her öğenin bir sahibi vardır. Bir öğenin nitelikli adı, sahiplerinin adlarının :: ile birleştirilmiş zinciridir. Demoda aktarma organı tanımının bataryası Vehicles::Powertrain::battery'dir.
Boşluk veya başka özel karakterler içeren bir ad tek tırnak içine yazılır: 'Fuel Tank'. Açılı parantez içindeki bir kısa ad öğeye ikinci, kısa bir tanımlayıcı verir: requirement def <'VR-1'> CurbMass. Holarch bir gereksinimin kısa adını onun numarası olarak kullanır.
Paketler
Bir paket, öğeleri bir klasör gibi gruplar. Paketler iç içe olabilir. Her üst düzey paket Düzenleyici'de bir belgedir.
package Vehicles {
doc /* A hybrid passenger car: structure, interfaces and variants. */
private import ScalarValues::*;
private import ISQ::*;
private import SI::*;
}
İçe aktarmalar ve görünürlük
Bir içe aktarma, başka bir paketin üyelerini kısa adlarıyla görünür kılar.
import ISQ::*;,ISQ'nun üyelerini içe aktarır.import VehicleRequirements::**;iç içe öğelerin üyelerini de içe aktarır (özyinelemeli).import Vehicles::Car;tek bir öğeyi içe aktarır.import Vehicles::*[@SysML::PartDefinition];yalnızca tek bir türün üyelerini içe aktarır (filtrelenmiş içe aktarma).
private, protected ve public, bir üyeyi veya içe aktarmayı başka kimin göreceğini belirler. Demo, içe aktarmaların onu sırayla içe aktaran paketlere geçmemesi için private import yazar.
İçe aktarma olmadan nitelikli adı yazın: ISQ::MassValue her yerde çözümlenir, MassValue yalnızca ISQ'nun içe aktarıldığı yerde.
Bir alias bir öğeye ikinci bir ad verir: alias Hybrid for Car;.
Tanımlar ve kullanımlar
Bir tanım bir şey türünü tanımlar. Bir kullanım, bir tanımın başka bir öğenin içindeki bir kullanımıdır. Çoğu anahtar sözcük iki biçimde de gelir:
| Tanım | Kullanım | Anlamı |
|---|---|---|
part def Battery; | part battery : Battery; | Bir sistem, alt sistem veya bileşen |
attribute def TirePressure; | attribute mass : MassValue = 45 [kg]; | Bir değer, çoğunlukla birimli |
item def Fuel; | item fuel : Fuel; | Akan veya işlenen bir şey |
port def FuelPort { … } | port fuelOut : FuelPort; | Bir parça üzerindeki bağlantı noktası |
connection def … / interface def FuelLine { … } | interface fuel : FuelLine connect …; | Parçalar veya portlar arasında bir bağlantı |
action def ProduceTorque { … } | action produce : ProduceTorque; | Davranış: girdi alan ve çıktı veren bir adım |
state def PowertrainStates { … } | state off; | Davranış: bir durum ve geçişleri |
constraint def MassLimit { … } | constraint …; | Değerler üzerinde bir Boolean koşul |
calc def PowerToWeight { … } | calc …; | return değeri olan bir hesaplama |
requirement def <'VR-1'> CurbMass { … } | requirement <'VR-1.1'> sedanMass : CurbMass; | Bir gereksinim |
use case def DriveToWork { … } | use case commute : DriveToWork; | Bir kullanım senaryosu |
analysis def PowerToWeightAnalysis { … } | analysis sedanPowerToWeight : …; | Bir analiz durumu |
verification def CurbMassTest { … } | verification sedanWeighing : CurbMassTest; | Bir doğrulama durumu |
view def RequirementsView { … } | view driveCycleFlow : ActionFlowView { … } | Modelin bir görünümü |
enum def DriveMode { … } | attribute mode : DriveMode; | Sabit bir değerler kümesi |
Bir tanımın içine yerleştirilmiş üyeler, onun her kullanımına aittir. part frontAxle : Axle;, Axle'ın differential, leftWheel ve rightWheel öğelerini yinelemeden içerir.
Türlendirme, özelleştirme ve yeniden tanımlama
Dört işleç tanımları ve kullanımları ilişkilendirir. Her birinin bir anahtar sözcük biçimi de vardır.
| İşleç | Anahtar sözcük | Anlamı | Örnek |
|---|---|---|---|
: | defined by | Bir kullanımı bir tanımla türlendirir | part engine : Engine; |
Bir tanım üzerinde :> | specializes | Tanım diğerinin bir türüdür ve onun üyelerini devralır | part def FuelTank :> Component |
Bir kullanım üzerinde :> | subsets | Kullanım başka bir kullanımın alt kümesidir | part spareWheel :> wheels; |
:>> | redefines | Devralınan bir kullanımın yerine geçer; örneğin ona bir değer vermek için | attribute redefines mass = 18 [kg]; |
~ | Bir portu eşlenik yapar: in ve out özellikleri yer değiştirir | port fuelIn : ~FuelPort; |
Yeniden tanımlama, bir varyantın veya konfigüre edilmiş bir parçanın devraldığını değiştirme yoludur. Demoda SportCar yedek tekerleği yeniden tanımlayarak kaldırır:
part def SportCar :> Car {
attribute topSpeed : SpeedValue = 210 [km/h];
part redefines spare [0];
}
abstract, doğrudan örneği olmayan bir tanımı işaretler (abstract part def Component). ref, sahip olunmayan bir referansı işaretler. in, out ve inout bir özelliğin veya parametrenin yönünü belirler. end, bir bağlantı veya arayüz tanımının uçlarını işaretler.
Çokluklar
Köşeli parantez içindeki bir çokluk kaç tane olduğunu söyler.
[2]: tam olarak iki.part runabout : CityCar [2];[0..1]: isteğe bağlı.part spare : Wheel [0..1];[1..*]ve[*]: bir veya daha fazla, herhangi bir sayıda.[0]: hiç; devralınan bir parçayı kaldırmak için kullanılır.- Sınırlar ifade olabilir.
orderedvenonuniqueköşeli parantezlerden sonra gelir.
Değerler ve birimler
= bir değeri bağlar. := değişebilen bir başlangıç değeri verir. default, bir yeniden tanımlamanın değiştirebileceği bir varsayılan verir.
attribute maxCurbMass : MassValue = 1650 [kg];
attribute minBatteryCapacity : EnergyValue = 1.2 [kW*h];
attribute minPowerToWeight = 40 [W/kg];
attribute topSpeed : SpeedValue = 210 [km/h];
Bir nicelik, köşeli parantez içinde birimi olan bir sayıdır. Birimler *, / ve ^ ile birleşir ([m/s^2]). MassValue gibi nicelik türleri ISQ'dan, kg gibi birimler SI'dan (veya USCustomaryUnits'ten) gelir. Holarch boyutları denetler: bir MassValue'ya 5 [s] atamak bir hatadır.
İfadeler aritmetik, karşılaştırma (<=, ==), mantıksal işleçler (and, or, not, implies), koşullu if c ? a else b, özellik zincirleri (car.powertrain.battery.capacity), hesaplama çağrıları (PowerToWeight(power, mass)) ve ->sum, ->size, ->select ve ->collect gibi dizi işlemleri kullanır. Holarch bunları değerler, kısıtlar, görünümler ve analiz sayfaları için birimleriyle değerlendirir.
Yapı: portlar, bağlantılar, arayüzler, bağlamalar ve akışlar
Parçalar portları üzerinden bağlanır.
part def Powertrain {
part tank : FuelTank;
part engine : Engine;
interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;
connect controller.engineCtl to engine.ecu;
port output : TorquePort;
bind output = transmission.output;
}
connect a to b;iki parçayı veya portu birleştirir.- Bir arayüz, portlar arasında türlendirilmiş bir bağlantıdır. Tanımı uçlarını adlandırır:
interface def FuelLine { end supply : FuelPort; end consumer : ~FuelPort; }. - Bir bağlantının veya arayüzün her ucunun bir adı ve bir çokluğu olabilir:
interface motorShaft : Shaft connect [1] driver ::> motor.output to [1] driven ::> transmission.motorIn;. Adlandırılmış bir uç bağlantının bir özelliğidir; bu nedenlemotorShaft.driverona başvurur. bind a = b;iki özelliğin aynı olduğunu söyler (bir bağlama bağlayıcısı).flow of Fuel from supply.fuel to produce.fuel;bir item'ı bir özellikten diğerine taşır.message, parçalar arasında bir item'ı olay olarak gönderir.
Davranış: eylemler
Bir eylem tanımı adımlarını (eylem kullanımları), parametrelerini ve adımların sırasını tutar.
action def DriveCycle {
in attribute targetSpeed : Real;
first start then switchOn;
action switchOn { attribute duration : DurationValue = 2 [s]; }
then fork split;
then supply;
then produce;
action supply : SupplyFuel;
action produce : ProduceTorque;
flow of Fuel from supply.fuel to produce.fuel;
first supply then ready;
first produce then ready;
join ready;
}
- Ardışıklıklar adımları sıralar:
first a then b;veyaa'dan hemen sonrathen b;.startvedonebaşlangıç ve bitiştir. - Denetim düğümleri: paralel yollar için
forkvejoin; alternatifler içindecidevemerge. Bir karardan sonra koşullu bir ardışıklıkif speed > 30 then cruise;biçimindedir veelse brake;varsayılan daldır. - Sonlandırma:
terminate;çevreleyen eylemi, hâlâ çalışan adımlarıyla birlikte hemen bitirir;then terminate;onu önceki adımdan sonra yerleştirir.terminate x;,xoluşumunu bitirir. - Diğer eylemler:
acceptbir sinyal bekler,sendbir sinyal gönderir,assign x := expr;bir değeri değiştirir,ifbir bloğu çalıştırır veya atlar,while … { … } until …;vefor v in seq { … }bir bloğu yineler. - Davranış tahsisi: bir parça bir eylemi gerçekleştirir (
perform:perform action trip : DriveCycle;,perform trip.supply;) veallocate a to b;bir öğeyi diğerine tahsis eder.
Davranış: durumlar
Bir durum tanımı durumları ve aralarındaki geçişleri tutar.
state def PowertrainStates {
entry; then off;
state off;
accept StartRequest then hybrid;
state hybrid {
entry action startEngine;
do action driveHybrid;
exit action stopEngine;
}
transition recharged first hybrid if charge > 60 then electric;
}
entry; then off;başlangıç durumunu belirler.- Geçişlerin bir tetikleyicisi (
accept StartRequest), isteğe bağlı bir koşulu (if charge > 20) ve isteğe bağlı bir etkisi (do …) vardır. Kısa biçim kaynak durumdan sonra gelir; uzun biçimtransition name first a … then b;şeklindedir. - Modelde bir geçişin tetikleyicisi ve etkisi kendi başına öğelerdir: bir kabul eylemi ve bir eylem (
send,assign,perform,terminateveya adlandırılmış bir eylem). Gezgin bunları geçişin altında tetikleyici ve etki olarak gösterir. Bunlar geçişin kendiaccepterveeffectöğeleridir; bu nedenle modelin diğer bölümleri onları adlandırabilir:chargerStates.plugIn.effect.sentMessage, bir dizi modelinin bağladığı şekliyle etkinin gönderdiği iletidir. - Bir port üzerinden gelen tetikleyici, portun taşıdığı bir şeyi kabul etmelidir: demonun
ChargeManageröğesindeaccept connectCharger : ChargerConnected via chargePort, portunin connected : ChargerConnectedözelliğiyle eşleşir.send new ChargeRequest() to controlleretkisi bir parçaya gönderir; öznitelik gibi bir değer ileti alamaz. entry,doveexiteylemleri duruma girerken, durumdayken ve durumdan çıkarken çalışır.paralleldurumların hepsi aynı anda etkin olan bölgeleri vardır.- Bir parça bir durumu sergiler (
exhibit):exhibit state powertrainStates : PowertrainStates;.
Gereksinimler, kısıtlar ve doğrulama
Bir gereksinim, ifadesini doc içinde, uygulandığı öğeyi subject olarak ve denetlenebilir bir koşulu require constraint olarak tutar.
requirement def <'VR-1'> CurbMass {
doc /* The car's curb mass shall not exceed the mass limit. */
subject car : Car;
attribute limit : MassValue;
require constraint { car.curbMass <= limit }
}
satisfy carSpec by fleet.sedan;
assume constraint, gereksinimin varsaydığı bir koşulu belirtir. Koşul sağlanmadığında o gereksinim ve içindeki gereksinimler karşılanmış sayılır; onu çevreleyen gereksinim ve diğer iç gereksinimler yine denetlenir.actor,stakeholderveframe concerngereksinimin kimin ve ne için olduğunu adlandırır.satisfy R by part;bir parçanın bir gereksinimi karşıladığını söyler.- Bir doğrulama durumu gereksinimleri hedefinde doğrular:
objective { verify carSpec.sedanMass; }.return verdict : Boolean = …;döndürebilir. - Bir analiz durumunun bir konusu, bir hedefi ve her girdinin bir değeri olduğunda Holarch'ın değerlendirdiği bir
returnsonucu vardır. Durumun değeri olmayan öznitelikleri, hedefinin==denklemlerinden çözülür (Bilinmeyenli analiz durumları). connection : Derivation connect original to derived;türetilmiş bir gereksinimi kaydeder.#refinement dependency x to R;bir iyileştirmeyi kaydeder.dependency from a to b;genel bir izi kaydeder.
Kullanım senaryoları
use case def DriveToWork { subject car : Car; actor driver : Driver; objective { … } include use case startCar : StartCar; }. Bir kullanım senaryosu kullanımı, tanımının konusunu ve aktörlerini alır.
Görünümler
Bir görünüm modelin bir bölümünü gösterir. Standart bir görünüm tanımıyla türlendirilir ve gösterdiğini expose eder:
view driveCycleFlow : StandardViewDefinitions::ActionFlowView {
expose DriveCycle;
}
filter öğeleri daraltır (filter @SysML::RequirementUsage;). render bir oluşturma biçimi seçer. Bir viewpoint, bir görünümün ele alması gereken kaygıları çerçeveler. SysML v2 görünümleri her görünüm türünü açıklar.
Yorumlar, belgeler ve üst veriler
doc /* text */sahibini belgeler. Modelin bir parçasıdır; bir gereksinim için gereksinim metnidir.comment about x /* text */, modelde başka bir öğe hakkında bir nottur.// textve//* text */yalnızca metindeki notlardır. Holarch onları metinde tutar ama model öğesi değildirler.- Üst veri bir öğeye açıklama ekler: bir gövdede
@TBD { owner = "Powertrain lead"; }, önek olarak#TBR attribute limit …veya dışarıdanmetadata Capability about Vehicles::Car;. - Kullanıcı tanımlı anahtar sözcükler: her üst veri tanımı bir anahtar sözcük olarak çalışır:
#safetyCritical part controller : Controller;, denetleyiciyiSafetyCriticalüst verisiyle (kısa ad<safetyCritical>) işaretler. Bir üst veri tanımı neyi işaretleyeceğini sınırlayabilir::>> annotatedElement : SysML::PartDefinition;yalnızca parça tanımlarına izin verir. - Anlamsal üst veri:
SemanticMetadata'yı özelleştiren bir üst veri tanımı bir temel tür belirler::>> baseType = faults meta SysML::Usage;. İşaretlediği her öğe bu temeli özelleştirir: bir kullanım bir temel kullanımın alt kümesi olur, bir tanım bir temel tanımı veya bir temel kullanımın tanımlarını özelleştirir. Böylece#fault def BatteryOverheat;ve#fault overheat : BatteryOverheat;arızadır veFault'un özelliklerine sahiptir. Anlamsal üst veriyle dil anahtar sözcüğü, bu iki satırda olduğu gibi yazılmayabilir; Gezgin onları anahtar sözcükleriyle gösterir (#fault def). Dışarıdan yazılanmetadata Fault about x;,x'i arıza yapmaz: denetim uyarır vex'in kendisini#faultile işaretlemeyi önerir. - Kendi anlamı olan üst veri: bir üst veri tanımının özellikleri, onun her kullanımının belirtmesi gerekenlerdir ve kısıtları bunlar için sağlanmalıdır.
metadata def SafetyRating { attribute level : Natural; assert constraint { level >= 1 and level <= 4 } }ile denetim@SafetyRating;(düzey yok) ve@SafetyRating { level = 7; }(aralık dışında) bildirir;@SafetyRating { level = 4; }sorunsuzdur. Tanımda bir değeri veyadefault'u olan ya da[0..1]olarak bildirilen bir özellik yazılmayabilir. Her değer özelliğinin türüne uymalıdır: Boolean içintrueveyafalse, String için tırnak içinde metin, Integer için bir tam sayı (Natural için 0 veya daha fazla, Positive için 0'dan büyük) ve bir numaralandırma içinHazardAnalysis::fmeagibi değerlerinden biri; denetim başka her değeri ve tanımdaki uymayan bir varsayılanı bildirir. Bir üst veri gövdesi yalnızca tanımın özelliklerine değer verir (level = 4;) ve birabstract metadata defuygulanamaz. Hybrid Car demosu denetleyicisini@SafetyRating { level = 4; }olarak derecelendirir ve bataryanın incelemesini@SafetyReview { method = HazardAnalysis::fmea; closed = true; }olarak kaydeder. Düzenleyici'de Ekle ▾ → Üst veri tanımı bir özellik ve bir kuralla bir tanım başlatır, Üst veri uygula ise bir gövdenin içinde bir tane uygular. Metin yazmadan: bir tanım veya kullanım seçin ve özellik panelinin Metadata bölümünü kullanın. Meta veri ekle projenin üst veri tanımlarından birini uygular; ardından her özelliğin bir alanı olur (numaralandırma veya Boolean için değerler listesi, String için düz metin; Holarch bunu tırnak içinde yazar; tanımın varsayılanı ipucu olarak görünür ve varsayılanı olmayan bir özellik Zorunlu olarak işaretlenir); denetimin o üst veri için bulguları altında görünür; Kaldır onu kaldırır. Her değişiklik tek bir Geri al ile geri alınabilir. Standart kitaplıktan gelen ve Holarch'ın kendi üst verileri (simülasyon, hedefler, değişkenlik) kendi denetimlerini korur ve orada listelenmez.
Bireyler, anlık görüntüler ve zaman dilimleri
Bir bireysel öğe (individual), bir şey türü değil, tüm yaşamı boyunca belirli tek bir şeydir; örneğin seri numarasıyla tek bir araba. Bir anlık görüntü o şeyin tek bir andaki hâlidir; bir zaman dilimi yaşamının bir dönemidir. İkisi de onları sahiplenen oluşuma aittir ve onun özelliklerine sahiptir; böylece bu özelliklere kendi değerlerini verebilirler.
individual part def Car_VIN1234 :> Car {
snapshot atDelivery { attribute :>> mileage = 0 [km]; }
timeslice firstOwner { attribute ownerName : String = "Dana Reyes"; }
snapshot atService { attribute :>> mileage = 15000 [km]; }
first atDelivery then atService;
assert constraint mileageGrows { atDelivery.mileage <= atService.mileage }
}
individual, tür anahtar sözcüğünden önce gelir (individual part def,individual item def) veya tek başına durur (individual def Plate_77;).individualolarak yazılan bir kullanım tam olarak bir bireysel tanımla türlendirilir:individual car1 : Car_VIN1234;.snapshotvetimeslicebir parça, item, eylem veya başka bir oluşumun içinde bir tür anahtar sözcüğünden önce gelir ya da tek başına durur.then timeslice secondOwner;bir zaman dilimini kendinden önceki üyeden sonraya sıralar.- Bir anlık görüntü veya zaman dilimi içindeki bir değer önce orada, sonra bireysel öğeden, sonra onun tanımından okunur. Örnekte
atService.mileage15.000 km'dir ve kısıt sağlanır. - Yalnızca oluşumlar bireysel öğe, anlık görüntü veya zaman dilimi olabilir: öznitelikler ve numaralandırmalar değerdir.
- Mimari → Parçalar'da, Veritabanı ve Izgara görünümlerinde Örnekler sütunu her parçanın tanımının bireysel öğelerini listeler (
part sedan : Cariçin:Car_VIN1234): onu özelleştiren bireysel tanımlar ve onun türlendirdiği bireysel kullanımlar. Individual (Evet) ve Kısım (portion) (Anlık görüntü veya Zaman dilimi) de sütundur (Sütunlar ▾ → SysML v2). Modelde bir bireysel öğe olduğunda Parçalar varsayılan olarak Örnekler'i gösterir ve Tablo (CSV) dışa aktarması bu üç sütunu içerir; Tanımlar dışa aktarması bunları, onlara sahip her öğe için listeler. - Özellik panelinde, Özellikler altındaki Oluşum, Individual ayarını ve kullanımlar için Tüm yaşam, Zaman dilimi veya Anlık görüntü seçimini belirler. Gezgin'in tür filtresinde Individuals vardır ve bir satırın ⋯ menüsünde Yeni anlık görüntü… ve Yeni zaman dilimi… bulunur. General View kutu başlıklarında «individual part def», «snapshot» ve «timeslice» gösterir, bir kutunun anlık görüntülerini ve zaman dilimlerini kendi bölmelerinde listeler ve kutular arasındaki ardışıklıkları kesik çizgili oklar olarak çizer; Düzenle ▾ → Zaman çizelgesi olarak düzenle onları soldan sağa dizer. Hybrid Car demosunda
carLifelineGeneral View'uCar_VIN1234'ün anlık görüntülerini ve zaman dilimini gösterir.
Varyasyonlar, varyantlar ve konfigürasyonlar
Bir varyasyon, bir tasarımın bir noktasında izin verilen seçenekleri listeler; her seçenek bir varyant'tır. Bir varyasyon tanımı (variation part def) yeniden kullanılabilir bir seçenekler kümesidir; bir varyasyon kullanımı (variation part charger) tek bir tasarımın içindeki bir noktadır. Bir konfigürasyon her nokta için bir varyant seçer.
variation part def BatteryPack :> Battery {
variant part standardPack { attribute :>> capacity = 1.4 [kW*h]; }
variant part largePack { attribute :>> capacity = 12 [kW*h]; }
}
part def CarLine :> Car {
part pack : BatteryPack;
variation part charger : Component {
variant part noCharger;
variant part wallbox;
}
assert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack }
}
part plugInHybrid : CarLine {
@HolarchConfiguration;
part :>> pack = BatteryPack::largePack;
part :>> charger = charger::wallbox;
}
- Bir varyant varyasyonunun özelliklerine sahiptir ve onları yeniden tanımlayabilir:
BatteryPackbirBatteryolduğu içinlargePack'in bircapacity'si vardır. - Tür anahtar sözcüğü olmadan
variant x;, mevcutxkullanımını seçeneklerden biri yapar; seçenekx'in adını alır. - Bir varyasyon yalnızca varyantlara (ve tanımlara, yorumlara, üst verilere ve içe aktarmalara) sahiptir. Bir varyasyon zaten soyuttur; bu nedenle üzerindeki
abstractgereksiz olarak belirtilir. - Bir varyantı bir değerle seçin:
part :>> pack = BatteryPack::largePack;. O noktanın varyantı olmayan bir seçim hatadır. - Bir noktanın seçimi yokken değeri bilinmez; bu nedenle onun üzerindeki bir doğrulama ne karşılanır ne de ihlal edilir. Bir konfigürasyonda seçilen varyantların değerleri kullanılır.
- Bir konfigürasyonu
@HolarchConfigurationile işaretleyin (HolarchVariabilitypaketi, Standart kitaplıkta Holarch altında): Düzenleyici bundan sonra henüz seçilmemiş her noktayı belirtir. - Düzenleyici'de Ekle ▾ bunların her birini yazar: Varyasyon (paket düzeyinde bir tanım, bir parçanın içinde bir nokta), Varyant (bir varyasyonun içinde), Konfigürasyon ve Varyant seçimi (bir konfigürasyonun içinde).
- Hybrid Car demosunda
CarLine'ın iki noktası (packvecharger) vardır;selfChargingHybridveplugInHybridonun konfigürasyonlarıdır; doğrulama, standart paketle bir wallbox'ı dışlar.
Metinsel gösterimler
Bir metinsel temsil, bir öğeyi başka bir dilde yazar: öğenin gövdesinde rep language "Python" /* … */. Gövde metin olarak saklanır. Model, onu çevreleyen SysML'in bildirdiğidir; Holarch bir gövdeyi asla çalıştırmaz.
- Hybrid Car demosunda
DriveWheelshesaplamasını Python'da taşır:rep language "Python" /* wheel_speed = torque.value * GEAR_RATIOS[gear] / WHEEL_RADIUS */. "sysml"veya"kerml"içindeki bir gövde denetlenir.SpeedLimit,rep language "sysml" /* speed <= limit */olarak yazılmıştır ve Holarch onu doğrudan yazılmış bir kısıt gibi değerlendirir.- Düzenleyici SysML ve KerML gövdelerini renkli bir zemin üzerinde kod olarak vurgular. Diğer diller yorum metni olarak görünür.
- Özellik panelinin Gösterim bölümü her temsili Dil'i ve gövdesiyle listeler. Bir tanım veya kullanıma temsil eklemek için Temsil ekle'ye, birini silmek için Kaldır'a tıklayın.
- Action Flow görünümü, tanımının bir temsili olan bir eylemi dilini süslü parantez içinde göstererek işaretler; örneğin {Python}.
- Bilinen diller: SysML, KerML, OCL, Alf, Python, JavaScript, MATLAB, Modelica, C, doğal dil (
naturalLanguage,English,text). Addan sonraki bir sürüm yok sayılır (OCL2.0,Python 3). - Bir gövde, yorumu bitireceği için
*/içeremez.
Holarch'ın kendi tartışma yorumları, etiketleri, atananları ve son tarihleri modelin yanında saklanır. Metne yazılmazlar.
Nasıl kullanılır
Bir yapıyı modelleyin
- Düzenleyici'de bir paket açın (veya + Yeni paket'e tıklayın).
- Her bağlantı noktası türü için yönlü özelliklerle (
out attribute torque : TorqueValue;) birport defyazın. - Her bileşen türü için öznitelikleri ve portlarıyla bir
part defyazın. - Montaj için her bileşene bir
partiçeren birpart defyazın. - Parçaları bağlayın:
connect a.p to b.q;veyainterface name : Def connect a.p to b.q;. - Ara verin. Durum satırı Uygulandı der ve Gezgin yeni öğeleri gösterir.
Ekle ▾ (veya ⌃⇧Space / Ctrl+Shift+Space) bu yapıların her birini doldurulacak alanlarla sizin için yazar. Bkz. Bir yapı ekleyin.
Birimli değerler verin
- Nicelik türlerini ve birimleri paketin başında içe aktarın:
private import ISQ::*;veprivate import SI::*;. - Özniteliği bir nicelik türüyle türlendirin ve bir değer verin:
attribute mass : MassValue = 45 [kg];. - Özniteliği devralan bir tanımda onu kendi değeriyle yeniden tanımlayın:
attribute redefines mass = 18 [kg];. - Değerin üzerine gelin. Birim nicelik türüne uymuyorsa bir hata kartı görünür.
Davranışı tanımlayın
inveoutparametreleriyle biraction defyazın.- Her
actionkullanımı için bir adım ekleyin ve onlarıfirst … then …;veyathenile sıralayın. - Paralel adımlar için
forkvejoin, alternatifler içindecidevemergekullanın. - Item aktaran adımlar arasına
flow of Item from a.out to b.in;ekleyin. - Davranışı yürüten parçada
perform action name : Def;, onun parçalarında iseperform name.step;yazın. - Çizilmiş hâlini görmek için eylemi bir Action Flow View'da açın (bkz. SysML v2 görünümleri).
Bir gereksinim yazın ve izleyin
requirement <'ID'> name { doc /* The system shall … */ subject s : Def; }yazın.- Gereksinim değerlere karşı denetlenebiliyorsa
require constraint { … }ekleyin. - Tasarımın onu karşıladığı yere
satisfy name by somePart;yazın. - Hedefi onu doğrulayan (
verify) birverificationyazın. - İhtiyaçlar ve gereksinimler → Gereksinimler'i açın: gereksinim numarasıyla listelenir ve Doğrulama → RVTM nasıl doğrulandığını gösterir. Bkz. SysML v2 projelerinde gereksinimler ve doğrulama.
Bir değeri TBD veya TBR olarak işaretleyin
Bir değerin yerine TBD yazmak geçerli SysML değildir. Bunun yerine Holarch'ın üst verisini kullanın.
- İçe aktarın:
private import HolarchMetadata::*;. - Özniteliğe önek ekleyin:
#TBD attribute chargerPower : PowerValue;(henüz değer yok) veya#TBR attribute limit : TimeValue = 0.5 [h];(incelenecek bir değer). - Bir sahip ve neden kaydetmek için uzun biçimi özniteliğin gövdesine yazın:
@TBD { owner = "Powertrain lead"; rationale = "The charging standard is not chosen yet."; due = "2026-12-01"; }.
TBD/TBR kaydı bu değerleri listeler. TBD ve TBR, ModelingMetadata::StatusInfo'yu özelleştirir; bu nedenle diğer SysML v2 araçları onları durum açıklamaları olarak okur. Ekle ▾ → TBD değeri ve TBR değeri bunları sizin için yazar.
Bir kitaplık adı bulun
- Ray araçlarından Standart kitaplık'ı açın.
- Bir paket veya tanım bul… alanına adın bir kısmını yazın; örneğin
MassValue. - Satırdaki Adı kopyala'ya tıklayın. Nitelikli ad, burada
ISQBase::MassValue, kopyalanır. - Onu Düzenleyici'ye yapıştırın veya paketini içe aktarıp kısa adı kullanın.
Çalışılmış örnek: sedanın gereksinimini okuyun
Bu örnek tek bir gereksinimi Hybrid Car demosunun metni boyunca izler.
- Demoyu açın ve Düzenleyici'nin Paketler listesinde VehicleRequirements'ı seçin.
requirement def <'VR-1'> CurbMass'ı bulun. Onunrequire constraint { car.curbMass <= limit }ifadesi konunun boş ağırlığınılimitile karşılaştırır.requirement carSpec'i bulun.requirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; }içerir. Kullanımlimit'i paket düzeyindeki hedefmaxCurbMass = 1650 [kg]ile yeniden tanımlar.satisfy carSpec by fleet.sedan;'ı bulun.sedan'a ⌘ / Ctrl ile tıklayın: Düzenleyici Vehicles'ıpart sedan : Carkonumunda açar; oradaattribute redefines curbMass = 1580 [kg];değeri verir.- VehicleRequirements'a dönüp
verification def CurbMassTest'i bulun. Hedefiverify carSpec.sedanMass;onu VR-1.1'in bir doğrulama durumu yapar veverification sedanWeighing : CurbMassTest { subject car = fleet.sedan; }onu sedana uygular. - Vehicles'ta
1580 [kg]'ı1700 [kg]olarak değiştirin ve ara verin. Sedan artık 1650 kg sınırını aşar ve Düzenleyici VehicleRequirements'ta gereksiniminsedantarafından karşılanmadığına dair bir uyarıyı, yanlış kısıt ve değerleriyle gösterir. ⌘Z / Ctrl+Z ile geri alın.
İpuçları ve yaygın hatalar
- “…” is not defined here. (“…” burada tanımlı değil.) Ad yanlış yazılmıştır veya paketi içe aktarılmamıştır.
private import Package::*;ekleyin veya nitelikli adı yazın. - Eksik bir
;. Her bildirim;veya bir{ … }gövdesiyle biter. The declaration does not end. Add ; or a { … } body. (Bildirim bitmiyor. ; veya bir { … } gövdesi ekleyin.) :>ile:>>karşılaştırması. Özelleştirmek veya alt küme yapmak için:>, devralınan bir özelliğin yerine geçmek için:>>kullanın. Devralınmayan bir özelliği yeniden tanımlamak şu iletiyi verir: “x” is not inherited by “y”. (“x”, “y” tarafından devralınmıyor.)- Birimler içe aktarma gerektirir.
5 [kg]yalnızcaSI'ın görünür olduğu yerde çözümlenir. - Aynı adlı iki üye. “x” is already used in this namespace. (“x” bu ad alanında zaten kullanılıyor.) Birini yeniden adlandırın; bir varyant ise bunun yerine yeniden tanımlar.
- Bir hedefin dışında
verify. Onu bir doğrulama durumununobjective { verify R; }bölümüne koyun. - Ad olarak anahtar sözcükler.
part,stateveyaactiongibi sözcükler ayrılmıştır. Onları tırnak içine alın ('state') veya başka bir ad seçin.
Holarch neleri destekler
Holarch, SysML v2 metinsel gösteriminin aşağıdaki bölümlerini destekler. Düzenleyici hepsini denetler ve model hepsini saklar.
| Alan | Destekleniyor |
|---|---|
| Paketler ve ad alanları | package, iç içe paketler, library package (salt okunur), doc, comment … about, notlar // ve //* */, alias … for …, public/private/protected, kısa adlar <'1.2'>, tırnaklı adlar |
| İçe aktarmalar | üyelik ve ad alanı içe aktarmaları, ::*, özyinelemeli ::**, filtrelenmiş içe aktarmalar [@Kind] |
| Tanımlar ve kullanımlar | part, attribute, item, port, connection, interface, flow, action, state, requirement, constraint, calc, use case, analysis, verification, view, viewpoint, concern, enum, occurrence, allocation, metadata; ref, abstract, in/out/inout, end |
| Özelleştirme | :>/specializes, :/defined by, :>/subsets, :>>/redefines, eşlenik ~, disjoint, özellik zincirleri a.b.c |
| Çokluklar | [n], [n..m], [*], [0..*], ordered, nonunique, sınır olarak ifadeler |
| Değerler ve birimler | =, :=, default, nicelikler 5 [kg], birim ifadeleri [m/s^2], standart kitaplığın ISQ nicelik türleri ile SI ve ABD geleneksel birimleri, boyut denetimleri |
| Yapı | portlar ve eşlenik portlar, connect, uçlu arayüzler, çoklukları olan adlandırılmış bağlayıcı uçları, bind, flow of T from … to …, message |
| Eylemler | parametreler, perform, ardışıklıklar (first … then …, then), fork, join, decide, merge, koşullar, accept, send, assign, if, while, for, loop, start, done, terminate |
| Durumlar | entry/do/exit, tetikleyici, koşul ve etki içeren geçişler, parallel durumlar, iç içe durumlar, exhibit |
| Gereksinimler | subject, actor, stakeholder, require constraint, assume constraint, frame concern, satisfy … by …, verify, kimlik olarak kısa adlar, gereksinim metni olarak doc |
| Kısıtlar ve hesaplamalar | kısıt ve hesaplama tanımları ve kullanımları, return, assert constraint, çağrılar, aritmetik, karşılaştırma, mantık, if ? else ve dizi işlemleri içeren KerML ifadeleri, birimlerle değerlendirme |
| Kullanım senaryoları, analiz ve doğrulama | subject, actor, objective, include use case, return sonucu olan analiz durumları, verify ve bir hükmü olan doğrulama durumları |
| Görünümler | view, view def, expose (::*, ::** ve filtrelerle), filter, viewpoint, frame, render, standart görünüm tanımları |
| Tahsis ve izler | allocate a to b, tahsis tanımları, dependency from … to … |
| Bireysel öğeler | individual tanımları ve kullanımları, snapshot ve timeslice (then sonrasında da), değerleri ve ardışıklıkları |
| Değişkenlik | variation tanımları ve kullanımları, variant üyeleri ve varyant başvuruları (variant x;), değere göre seçimler, @HolarchConfiguration ile işaretlenmiş konfigürasyonlar (HolarchVariability) |
| Metadata | @Name { … }, #Name öneki, metadata Name about …, Holarch'ın HolarchMetadata (TBD, TBR) ve HolarchFrameworks paketleri; kullanıcı tanımlı metadata def; kullanıcı tanımlı anahtar sözcükler ve anlamsal üst veri (#fault def …) |
Yazıldığı gibi saklanır, yorumlanmaz
Holarch bu yapıları tam yazıldığı gibi okur ve saklar, ancak onlara kendine özgü bir anlam vermez:
- SysML ve KerML dışındaki dillerde metinsel temsiller (metin olarak saklanır; bkz. Metinsel temsiller).
Henüz kullanılamıyor
- KerML dosyalarını (
.kerml) içe aktarma. - Systems Modeling API üzerinden
main'e commit, etiketler ve birleştirmeler: diğer araçlar değişiklik talebi dallarına commit eder ve bunları bir onaylayıcı Holarch'ta uygular (bkz. SysML v2 projelerinde API ve MCP). - Kullanıcı tanımlı anahtar sözcükler ve anlamsal üst verinin ötesindeki dil uzantıları.
Denetimler
Holarch metni siz yazarken denetler. Her sorun Düzenleyici'nin kenar boşluğunda işaretlenir ve altı çizilir; ileti önce sorunu, sonra çözümü belirtir. Hatalar bir üyenin uygulanmasını durdurur; uyarılar durdurmaz.
| Alan | Neler denetlenir | Örnek ileti |
|---|---|---|
| Sözdizimi | Karakterler, yorumlar, dizeler, süslü parantezler, ;, beklenen adlar ve belirteçler | This brace has no partner. Add the matching { or }, or delete this one. |
| Adlar | Çözümlenmemiş, belirsiz, geçersiz, yinelenen (uyarı) ve özel adlar | “Batery” is not defined here. Check the spelling, or import its package. |
| Türlendirme ve özelleştirme | Döngüler; doğru türde bir tanımla türlendirme ve özelleştirme; özellikleri alt küme yapma ve yeniden tanımlama; yalnızca devralınan özelliklerin yeniden tanımlanması | “capacity” is not inherited by “Car”. Specialize its type, or subset it with :> instead. |
| Çokluklar | Geçerli ve tam sayı sınırlar; yeniden tanımladığından daha geniş olmayan bir yeniden tanımlama | Multiplicity [3..1] is not valid. Use a lower bound from 0 up to the upper bound. |
| Birimler ve değerler | Eşleşen boyutlar, eksik birimler, birim adları, sayı türleri | The units do not match: kg and s. Convert one side to a compatible unit. |
| İfadeler | Sözdizimi, işlenen türleri, hesaplama argümanları, Boolean koşullar | The condition must be true or false; it is a number. Write a comparison such as x > 0. |
| Yapı | Bağlantı uçları özelliktir, arayüzler portları bağlar, port, akış ve ileti yönleri, akış item türleri, bağlama türleri | These port directions do not fit together. Conjugate one port (~) or change a direction. |
| Eylemler | Aynı gövdedeki eylemler arasındaki ardışıklıklar, denetim düğümlerinin giriş/çıkış sayıları, karar koşulları ve else, start ve done, atamalar, perform hedefleri, bir for döngüsünün üzerinde dolaştığı değerlerin döngü değişkeninin türüne uyumu | then needs an earlier action. Add an action or first … then …. |
| Durumlar | Aynı gövdedeki durumlar arasındaki geçişler, her biri için bir entry/do/exit, başlangıç geçişleri, paralel bölgeler, exhibit hedefleri, bir geçişin do etkisi (alabilen bir şeye send, assign, accept, action veya adlandırılmış bir eylem), bir tetikleyicinin yükünün portunun item'larına uyumu, Real gibi yalın bir kitaplık değeri üzerindeki tetikleyici (uyarı), bir zamanı adlandıran at tetikleyicileri | “electric” has substates but no initial transition, so none of them is entered. Add entry; then <first state>;. |
| Gereksinimler, durumlar ve görünümler | Doğru yerdeki üyeler, tek konu, satisfy/verify/require hedefleri, konu türleri, expose ve import hedefleri, frame hedefleri | verify belongs in the objective of a verification case. Move it into objective { … }. |
| Metinsel gösterimler | SysML ve KerML gövdeleri ayrıştırılır ve temsil ettikleri öğeyi bildirir; bilinmeyen diller belirtilir | The representation of “SpeedLimit” declares a part definition, not a constraint definition. Make the body declare “SpeedLimit” itself. |
| Bireyler, anlık görüntüler ve zaman dilimleri | individual yalnızca oluşumlarda ve tam olarak bir bireysel tanımla; snapshot/timeslice yalnızca bir oluşumun içindeki oluşum kullanımlarında; bir anlık görüntünün içindeki zaman dilimi (uyarı) | “parked” is individual, but none of its definitions is. Type it by an individual definition, or remove individual. |
| Değişkenlik | Bir varyasyon yalnızca varyantlara sahiptir; bir varyant bir varyasyonun içinde bulunur ve onun türündedir; bir seçim kendi noktasının varyantıdır; bir varyasyondaki abstract gereksizdir (not); bir konfigürasyonun açık noktaları (not) | “compact” is not a variant of “pack”. Choose one of: standardPack, largePack. |
| Kullanıcı tanımlı anahtar sözcükler | #Name bir üst veri tanımını adlandırır; dil anahtar sözcüğü olmayan bir bildirim anlamsal üst veri kullanır (uyarı); üst veri yalnızca annotatedElement'inin izin verdiği türleri işaretler; anlamsal bir temel tür bir tanım veya kullanımdır, işaretlediği öğeye uyar (uyarı) ve döngü oluşturmaz | “safetyCritical” applies to PartDefinition, not to “invert” (ActionUsage). Move it, or remove it. |
| Üst veri değerleri | Kullanıcı tanımlı bir üst veri tanımının her zorunlu özelliği bir değer alır (uyarı); her değer ve varsayılan, özelliğinin türüne uyar (Boolean, String, tam sayılar, numaralandırmalar); tanımın kısıtları verilen değerler için sağlanır; bir üst veri gövdesi yalnızca tanımın özelliklerini yeniden tanımlar; soyut üst veri tanımları uygulanmaz; about ile yazılmış anlamsal üst veri (uyarı) | The values of “SafetyRating” break its constraint levelRange: level >= 1 and level <= 4. Change the values. |
| Değerlendirme | Mevcut değerler için sağlanmayan kısıtlar, gereksinimler ve hedefler | “sedanMass” is not met by “sedan”: … is false (…). Change the design values or the requirement. |
Standart kitaplık
Standart kitaplık sayfası her SysML v2 projesinin kullanabileceği paketleri ve tanımları listeler: değerler ve birimler, nicelikler, parçalar, portlar, eylemler, durumlar, gereksinimler, analiz ve daha fazlası. Salt okunurdur.
- Ray araçlarındaki Ayarlar → Standart kitaplık'tan açın. LML projelerinde bulunmaz.
- Klasörler. Sol taraf kitaplık dosyalarını klasöre göre listeler: Kernel Libraries, Systems Library, Domain Libraries (Analysis, Cause and Effect, Geometry, Metadata, Quantities and Units, Requirement Derivation) ve Holarch (TBD ve TBR içeren
HolarchMetadatapaketi,HolarchConfigurationiçerenHolarchVariabilityveObjectiveiçerenHolarchRequirements). - Bir dosya. Paketlerini görmek için bir dosya seçin; her paket belgeleri ve tanımlarının bir tablosuyla gösterilir: Ad, Tür ve Belgeler.
- Bulma. Her dosyanın adlarında ve belgelerinde aramak için Bir paket veya tanım bul… alanına yazın. Sonuçlar dosyayı gösterir; o dosyayı açmak için ona tıklayın. Temizlemek için Esc'ye basın.
- Adı kopyala, bir öğenin nitelikli adını (örneğin
ISQ::MassValue) Düzenleyici'de kullanmak üzere kopyalar. - Metni göster kitaplık dosyasını yazıldığı gibi gösterir; Tanımları göster tablolara döner.
Kitaplık, tek bir düzeltmeyle SysML v2 sürüm kitaplığıdır: bir tonne (takma ad 'metric ton') 1000 kg'a dönüşür; sürüm dosyası 0,001 kg der. Modeliniz ona adıyla başvurur; projeye kopyalanmaz ve bir .sysml dışa aktarmasının parçası değildir.
Sınırlar
- 8 MB'tan büyük bir metin belgesi denetlenmez: This text is larger than 8 MB and is not checked. Split it into several packages. (Bu metin 8 MB'tan büyük ve denetlenmiyor. Onu birkaç pakete bölün.)
- 64 KB'tan uzun bir satır denetlenmez.
- 256 düzeyden derin iç içelik denetlenmez.
- Standart kitaplık düzenlenemez.
İlgili sayfalar
- SysML v2 projelerine başlarken
- Metin düzenleyici ve Gezgin
- SysML v2 görünümleri
- SysML v2 projelerinde gereksinimler ve doğrulama
- SysML v2 modellerinin alışverişi
SysML® ve OMG®, Object Management Group, Inc.'in Amerika Birleşik Devletleri'nde ve diğer ülkelerde tescilli ticari markalarıdır.