Holarch

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.

Nasıl kullanılır →

Bu sayfada
  1. Genel bakış
  2. Kavramlar
    1. Öğeler, sahipler ve nitelikli adlar
    2. Paketler
    3. İçe aktarmalar ve görünürlük
    4. Tanımlar ve kullanımlar
    5. Türlendirme, özelleştirme ve yeniden tanımlama
    6. Çokluklar
    7. Değerler ve birimler
    8. Yapı: portlar, bağlantılar, arayüzler, bağlamalar ve akışlar
    9. Davranış: eylemler
    10. Davranış: durumlar
    11. Gereksinimler, kısıtlar ve doğrulama
    12. Kullanım senaryoları
    13. Görünümler
    14. Yorumlar, belgeler ve üst veriler
    15. Bireyler, anlık görüntüler ve zaman dilimleri
    16. Varyasyonlar, varyantlar ve konfigürasyonlar
    17. Metinsel gösterimler
  3. Nasıl kullanılır
    1. Bir yapıyı modelleyin
    2. Birimli değerler verin
    3. Davranışı tanımlayın
    4. Bir gereksinim yazın ve izleyin
    5. Bir değeri TBD veya TBR olarak işaretleyin
    6. Bir kitaplık adı bulun
  4. Çalışılmış örnek: sedanın gereksinimini okuyun
  5. İpuçları ve yaygın hatalar
  6. Holarch neleri destekler
    1. Yazıldığı gibi saklanır, yorumlanmaz
    2. Henüz kullanılamıyor
  7. Denetimler
  8. Standart kitaplık
  9. Sınırlar
  10. İ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ımKullanımAnlamı
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ükAnlamıÖrnek
:defined byBir kullanımı bir tanımla türlendirirpart engine : Engine;
Bir tanım üzerinde :>specializesTanım diğerinin bir türüdür ve onun üyelerini devralırpart def FuelTank :> Component
Bir kullanım üzerinde :>subsetsKullanım başka bir kullanımın alt kümesidirpart spareWheel :> wheels;
:>>redefinesDevralınan bir kullanımın yerine geçer; örneğin ona bir değer vermek içinattribute redefines mass = 18 [kg];
~Bir portu eşlenik yapar: in ve out özellikleri yer değiştirirport 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. ordered ve nonunique köş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 nedenle motorShaft.driver ona 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; veya a'dan hemen sonra then b;. start ve done başlangıç ve bitiştir.
  • Denetim düğümleri: paralel yollar için fork ve join; alternatifler için decide ve merge. Bir karardan sonra koşullu bir ardışıklık if speed > 30 then cruise; biçimindedir ve else 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;, x oluşumunu bitirir.
  • Diğer eylemler: accept bir sinyal bekler, send bir sinyal gönderir, assign x := expr; bir değeri değiştirir, if bir bloğu çalıştırır veya atlar, while … { … } until …; ve for 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;) ve allocate 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çim transition 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, terminate veya adlandırılmış bir eylem). Gezgin bunları geçişin altında tetikleyici ve etki olarak gösterir. Bunlar geçişin kendi accepter ve effect öğ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 öğesinde accept connectCharger : ChargerConnected via chargePort, portun in connected : ChargerConnected özelliğiyle eşleşir. send new ChargeRequest() to controller etkisi bir parçaya gönderir; öznitelik gibi bir değer ileti alamaz.
  • entry, do ve exit eylemleri duruma girerken, durumdayken ve durumdan çıkarken çalışır. parallel durumları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, stakeholder ve frame concern gereksinimin 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 return sonucu 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.
  • // text ve //* 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ıdan metadata 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;, denetleyiciyi SafetyCritical ü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 ve Fault'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ılan metadata Fault about x;, x'i arıza yapmaz: denetim uyarır ve x'in kendisini #fault ile 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 veya default'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çin true veya false, 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çin HazardAnalysis::fmea gibi 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 bir abstract metadata def uygulanamaz. 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;). individual olarak yazılan bir kullanım tam olarak bir bireysel tanımla türlendirilir: individual car1 : Car_VIN1234;.
  • snapshot ve timeslice bir 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.mileage 15.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 : Car iç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 carLifeline General View'u Car_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: BatteryPack bir Battery olduğu için largePack'in bir capacity'si vardır.
  • Tür anahtar sözcüğü olmadan variant x;, mevcut x kullanımını seçeneklerden biri yapar; seçenek x'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 abstract gereksiz 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 @HolarchConfiguration ile işaretleyin (HolarchVariability paketi, 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ı (pack ve charger) vardır; selfChargingHybrid ve plugInHybrid onun 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 DriveWheels hesaplaması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

  1. Düzenleyici'de bir paket açın (veya + Yeni paket'e tıklayın).
  2. Her bağlantı noktası türü için yönlü özelliklerle (out attribute torque : TorqueValue;) bir port def yazın.
  3. Her bileşen türü için öznitelikleri ve portlarıyla bir part def yazın.
  4. Montaj için her bileşene bir part içeren bir part def yazın.
  5. Parçaları bağlayın: connect a.p to b.q; veya interface name : Def connect a.p to b.q;.
  6. 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

  1. Nicelik türlerini ve birimleri paketin başında içe aktarın: private import ISQ::*; ve private import SI::*;.
  2. Özniteliği bir nicelik türüyle türlendirin ve bir değer verin: attribute mass : MassValue = 45 [kg];.
  3. Özniteliği devralan bir tanımda onu kendi değeriyle yeniden tanımlayın: attribute redefines mass = 18 [kg];.
  4. Değerin üzerine gelin. Birim nicelik türüne uymuyorsa bir hata kartı görünür.

Davranışı tanımlayın

  1. in ve out parametreleriyle bir action def yazın.
  2. Her action kullanımı için bir adım ekleyin ve onları first … then …; veya then ile sıralayın.
  3. Paralel adımlar için fork ve join, alternatifler için decide ve merge kullanın.
  4. Item aktaran adımlar arasına flow of Item from a.out to b.in; ekleyin.
  5. Davranışı yürüten parçada perform action name : Def;, onun parçalarında ise perform name.step; yazın.
  6. Ç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

  1. requirement <'ID'> name { doc /* The system shall … */ subject s : Def; } yazın.
  2. Gereksinim değerlere karşı denetlenebiliyorsa require constraint { … } ekleyin.
  3. Tasarımın onu karşıladığı yere satisfy name by somePart; yazın.
  4. Hedefi onu doğrulayan (verify) bir verification yazın.
  5. İ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.

  1. İçe aktarın: private import HolarchMetadata::*;.
  2. Ö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).
  3. 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

  1. Ray araçlarından Standart kitaplık'ı açın.
  2. Bir paket veya tanım bul… alanına adın bir kısmını yazın; örneğin MassValue.
  3. Satırdaki Adı kopyala'ya tıklayın. Nitelikli ad, burada ISQBase::MassValue, kopyalanır.
  4. 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.

  1. Demoyu açın ve Düzenleyici'nin Paketler listesinde VehicleRequirements'ı seçin.
  2. requirement def <'VR-1'> CurbMass'ı bulun. Onun require constraint { car.curbMass <= limit } ifadesi konunun boş ağırlığını limit ile karşılaştırır.
  3. requirement carSpec'i bulun. requirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; } içerir. Kullanım limit'i paket düzeyindeki hedef maxCurbMass = 1650 [kg] ile yeniden tanımlar.
  4. satisfy carSpec by fleet.sedan;'ı bulun. sedan'a ⌘ / Ctrl ile tıklayın: Düzenleyici Vehicles'ı part sedan : Car konumunda açar; orada attribute redefines curbMass = 1580 [kg]; değeri verir.
  5. VehicleRequirements'a dönüp verification def CurbMassTest'i bulun. Hedefi verify carSpec.sedanMass; onu VR-1.1'in bir doğrulama durumu yapar ve verification sedanWeighing : CurbMassTest { subject car = fleet.sedan; } onu sedana uygular.
  6. 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 gereksinimin sedan tarafı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ızca SI'ı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 durumunun objective { verify R; } bölümüne koyun.
  • Ad olarak anahtar sözcükler. part, state veya action gibi 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.

AlanDestekleniyor
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ımlarpart, 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
Eylemlerparametreler, perform, ardışıklıklar (first … then …, then), fork, join, decide, merge, koşullar, accept, send, assign, if, while, for, loop, start, done, terminate
Durumlarentry/do/exit, tetikleyici, koşul ve etki içeren geçişler, parallel durumlar, iç içe durumlar, exhibit
Gereksinimlersubject, actor, stakeholder, require constraint, assume constraint, frame concern, satisfy … by …, verify, kimlik olarak kısa adlar, gereksinim metni olarak doc
Kısıtlar ve hesaplamalarkı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ğrulamasubject, actor, objective, include use case, return sonucu olan analiz durumları, verify ve bir hükmü olan doğrulama durumları
Görünümlerview, view def, expose (::*, ::** ve filtrelerle), filter, viewpoint, frame, render, standart görünüm tanımları
Tahsis ve izlerallocate a to b, tahsis tanımları, dependency from … to …
Bireysel öğelerindividual tanımları ve kullanımları, snapshot ve timeslice (then sonrasında da), değerleri ve ardışıklıkları
Değişkenlikvariation 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.

AlanNeler denetlenirÖrnek ileti
SözdizimiKarakterler, yorumlar, dizeler, süslü parantezler, ;, beklenen adlar ve belirteçlerThis 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ştirmeDö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.
ÇokluklarGeçerli ve tam sayı sınırlar; yeniden tanımladığından daha geniş olmayan bir yeniden tanımlamaMultiplicity [3..1] is not valid. Use a lower bound from 0 up to the upper bound.
Birimler ve değerlerEşleşen boyutlar, eksik birimler, birim adları, sayı türleriThe units do not match: kg and s. Convert one side to a compatible unit.
İfadelerSözdizimi, işlenen türleri, hesaplama argümanları, Boolean koşullarThe 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ürleriThese port directions do not fit together. Conjugate one port (~) or change a direction.
EylemlerAynı 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 uyumuthen needs an earlier action. Add an action or first … then ….
DurumlarAynı 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ümlerDoğru yerdeki üyeler, tek konu, satisfy/verify/require hedefleri, konu türleri, expose ve import hedefleri, frame hedefleriverify belongs in the objective of a verification case. Move it into objective { … }.
Metinsel gösterimlerSysML ve KerML gövdeleri ayrıştırılır ve temsil ettikleri öğeyi bildirir; bilinmeyen diller belirtilirThe 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 dilimleriindividual 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şkenlikBir 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ğerleriKullanı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ğerlendirmeMevcut 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 HolarchMetadata paketi, HolarchConfiguration içeren HolarchVariability ve Objective içeren HolarchRequirements).
  • 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.

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