Holarch

SysML v2

SysML v2 projelerinde simülasyon meta verileri

HolarchSimulation meta veri kitaplığı: bir SysML v2 modelinin Simülatör için süreleri, dal olasılıklarını, döngü sayılarını, kaynakları, maliyetleri ve durum makinesi ayarlarını nasıl taşıdığı ve bunların nasıl yazılıp taşınacağı.

Nasıl kullanılır →

Bu sayfada
  1. Genel bakış
  2. Kavramlar
    1. Nominal değer ve dağılım
    2. Hangi ayarlar öncelikli olur
    3. İki simülatör
  3. Nasıl kullanılır
    1. Ne zaman ve neden
    2. Bir süre, olasılık veya döngü sayısı ayarlayın
    3. Açıklamaları metinde yazın
    4. Eski ayarları modele taşıyın
    5. Bir durum makinesini simüle edin
    6. Çalışılmış örnek: Hybrid Car demosu
    7. İpuçları ve iyi uygulamalar
    8. Yaygın hatalar
    9. Nasıl bağlanır
  4. Açıklamalar
    1. Dağılımlar
    2. İlişkili girdiler
    3. Olasılıklar ve sayılar
    4. Resource'lar ve maliyetler
    5. SysML motoru gerektiren açıklamalar
  5. İletiler
  6. Sınırlar
  7. İlgili

Genel bakış

Bir SysML v2 projesinde Simülatör'ün ayarları modelin parçasıdır. Bunlar, her SysML v2 projesinin yüklediği HolarchSimulation kitaplık paketinden üst veri açıklamalarıdır. Bunları kullanan bir model geçerli SysML v2 olarak kalır: diğer araçlar açıklamaları sıradan üst veri olarak okur ve onlara yalnızca Simülatör anlam verir.

Bir açıklama ya açıkladığı öğenin içinde durur ya da o öğeyi about ile adlandırır:

succession toCruise first shift if speed > 30 then cruise {
  @HolarchSimulation::Probability { percent = 70; }
}
metadata HolarchSimulation::Cost about DriveCycle::drive { amount = 0.4; unit = "USD"; label = "Energy"; }

Kavramlar

Nominal değer ve dağılım

Bir adımın süresi duration özniteliğidir (veya DurationValue ya da TimeValue ile türlendirilmiş bir öznitelik). Değeri, diğer araçların ve Holarch'ın değerlendirmesinin gördüğü nominal süredir. O öznitelik üzerindeki bir dağılım açıklaması, Simülatör'ün bunun yerine süreyi çekmesini sağlar:

action cruise {
  attribute duration : ISQ::DurationValue = 1 [min] {
    @HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
  }
}

Hangi ayarlar öncelikli olur

  • Bir dağılım açıklaması özniteliğin kendi değerine göre önceliklidir.
  • Modelin değerlendirebildiği bir koşul, if koşulu veya döngü koşulu kendi başına karar verir. Bir Probability veya LoopCount yalnızca değerlendiremediğinde kullanılır (bir LoopCount geçişleri her zaman sayar).
  • Simülasyon ayarları modele taşınmadan önce yapılan ayarlar, modelin yanında Holarch verisi olarak saklanır. Siz onları içeri taşıyana kadar (bkz. Eski ayarları modele taşıyın) hâlâ önceliklidirler; böylece çalıştırmalar aynı sonuçları verir.

İki simülatör

Simülatör sayfası, ayarların sağında modeli hangi simülatörün çalıştırdığını gösterir: SysML motoru (Holarch Language Engine'in simülatörü) veya JavaScript simülatörü. İkisi de aynı açıklamaları okur. Durum makineleri, uyaranlar, Resource, Consumes, Produces ve Seizes'ten gelen resource'lar, Cost'tan gelen maliyetler ve SysML motoru gerektiren açıklamalar altındaki diğer açıklamalar yalnızca SysML motoruyla çalışır.

Nasıl kullanılır

Ne zaman ve neden

Model tasarımın kaydı olduğunda simülasyon ayarlarını modele yazın: sayılar .sysml dosyalarıyla birlikte taşınır, metnin incelemelerinde görünür ve modelin geri kalanıyla birlikte sürümlenir. Bunları bir operasyonel senaryoyu analiz ederken (zaman çizelgeleri, dal payları, resource kullanımı) ve bir gereksinimi bir Monte Carlo çalışmasına göre denetlemeden önce kullanın.

Bir süre, olasılık veya döngü sayısı ayarlayın

  1. Adımı, ardışıklığı, kararı, döngüyü veya if eylemini bir Action Flow View'da, Gezgin'de veya Düzenleyici'de seçin.
  2. Özellik panelinin Simülasyon bölümünde Süre (sabit bir değer veya bir dağılım), Olasılık (%), Yinelemeler veya then olasılığı (%) ayarlayın.
  3. Holarch açıklamayı modele yazar: Süre özniteliğin değerini ortalamaya ayarlar ve dağılım açıklamasını ekler (veya adımda yoksa attribute duration : ISQ::DurationValue yazar); Olasılık (%) Probability yazar; Yinelemeler LoopCount yazar. Her değişiklik tek bir Geri al ile geri alınabilir ve hemen metinde görünür.
  4. Açıklamasını kaldırmak için bir alanı temizleyin.

Holarch her değişikliği yazmadan önce SysML denetleyicisiyle denetler. Hata ekleyecek bir değişiklik yazılmaz ve bir ileti sorunu adlandırır.

Açıklamaları metinde yazın

  1. Düzenleyici'yi açın.
  2. Açıklamayı öğenin gövdesinin içine @HolarchSimulation::Kind { field = value; } olarak veya ondan sonra metadata HolarchSimulation::Kind about element { … } olarak ekleyin.
  3. Consumes, Produces ve Seizes için önce adımı, ikinci olarak resource'u adlandırın: metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }.

Eski ayarları modele taşıyın

Simülasyon ayarları modele taşınmadan önce yapılmış projeler, Simülatör'ün ayarlarının üstünde Bu projenin bazı simülasyon ayarları modelin parçası değil, Holarch verisidir. gösterir.

  1. Simülasyon ayarlarını modele taşı…'ya tıklayın.
  2. Önizleme her ayarı ve onun yerine geçen açıklamayı listeler.
  3. Modele taşı'ya tıklayın. Tüm ayarlar taşınır ve tek bir Geri al ile hepsi geri alınır; çalıştırmalar aynı sonuçları verir.

Bir durum makinesini simüle edin

Durum makineleri SysML motoruyla çalışır.

  1. Davranış → Simülatör'ü açın ve Kök olarak bir durum tanımı veya durumları sergileyen bir parça seçin.
  2. İsteğe bağlı: Şununla birlikte çalıştır altında parçaya sinyal gönderen bir senaryo eylemi seçin; örneğin demonun TestDrive'ı.
  3. Uyaranlar altında + Uyaran ekle'ye tıklayın ve Zaman (zaman ve birim), Sinyal ve Alıcı (bir makine veya Onu kabul eden her makine) ayarlayın.
  4. ▶ Oynat, ⏭ Adım veya ⏩ Sona kadar çalıştır'a basın. Çalışırken durum makinesi etkin durumları yakar ve tetiklenen geçişi işaretler; Durumlar sekmesi Zamana göre durumlar ve Tetiklenen geçişler'i gösterir.
  5. Monte Carlo'da Durumlar sekmesi Durumda geçen süre ve Geçiş sayıları'nı gösterir. Gereksinime göre denetle…, her durumun durumda geçen süresini ve çalıştırmadaki payını çıktı olarak sunar.

Bir Durum geçişi görünümünde ▶ Simüle et; ▶ Oynat, ⏭ Adım, ⏩ Sona kadar çalıştır, Sıfırla ve Simülatörde aç içeren bir çubuk açar. Çalıştırma, o durum tanımı için Simülatör'de kaydedilen uyaranları kullanır.

Çalışılmış örnek: Hybrid Car demosu

Hybrid Car demosu (Projeleri yönet → Proje dosyaları ▾ → Yeni demo proje) kitaplığı kullanır:

  • DriveCycle: shift'ten sonraki toCruise ardışıklığının Probability değeri 70'tir; else dalı kalan %30'u alır. cruise nominal olarak 1 dk sürer; süre bir Triangular dağılımından (45 sn, 1 dk, 2 dk) çekilir.
  • DrivenCar: aktarma organının bataryası 62 Wh'lik bir Resource'dur; drive bunun 1,5 Wh'ini Consumes ile tüketir ve kullanım başına 0,4 USD'lik bir Cost'u vardır.
  • PowertrainStates: startElectric geçişinin koşulu için Probability değeri 80'dir; accept when charge < 15, şarj düştüğünde hibrite geçer; accept after 30 [min] şarjı bitirir.
  • TestDrive: demoCar'a StartRequest gönderen, bir saat bekleyen, ardından StopRequest ve PlugIn gönderen bir senaryo. Aktarma organının durum değiştirdiğini görmek için Demo Car'ı Test Drive ile birlikte çalıştırın.

Demo 0 tanılamayla denetlenir.

İpuçları ve iyi uygulamalar

  • Nominal değeri anlamlı tutun: özellik panelinin yaptığı gibi onu dağılımın beklenen değerine ayarlayın.
  • Açıklamanın metinde kolayca bulunması için açıklama eklediğiniz ardışıklıkları adlandırın (succession toCruise first …).
  • Olasılıklar yerine modelin değerlendirebildiği koşulları tercih edin; modelin tanımlamadığı şeyler için Probability kullanın.

Yaygın hatalar

  • Bir olasılığın etkisi yok: koşul değerlendirilebiliyor, bu nedenle o karar veriyor. Özellik paneli “true olarak değerlendirilir: her zaman seçilir.” veya “false olarak değerlendirilir: hiçbir zaman seçilmez.” der.
  • Dal olasılıklarının toplamı %100 değil: Probability değeri olmayan dallar kalanı paylaşır; verilenler %100'ü aştığında uyarı şöyledir: “Dal olasılıklarının toplamı %N. Toplam %100 olacak şekilde değiştirin.”
  • Adımın kendisinde bir süre açıklaması: dağılımlar eylemde değil, süre özniteliğinde yer alır.

Nasıl bağlanır

Açıklamalar

Dağılımlar

Bir süre özniteliğine bir dağılım koyun. Konum ve ölçek alanları birimli bir nicelik alır (45 [s], 2 [min]); şekil alanları bir sayı alır.

AçıklamaAlanlarAnlamı
Normalmean, sdNormal dağılım.
Üçgenlow, mode, highÜçgen; low ≤ mode ≤ high.
Düzgünlow, highlow ile high arasında düzgün.
ExponentialmeanVerilen ortalamayla üstel.
Gammashape, scaleGama; ortalama shape × scale'dir.
LogNormalmedian, sigmaLogaritma, medyanın logaritması etrafında normaldir.
Weibullscale, shapeWeibull.
Betaalpha, beta, scale0..1 üzerinde Beta, scale ile çarpılır.
Poissonmean, scaleVerilen ortalamayla bir sayım, scale ile çarpılır.
Binomialtrials, p, scaleBir deneme sayısındaki başarılar, scale ile çarpılır.

Sıfırın altında çekilen süreler yeniden çekilir.

İlişkili girdiler

Korelasyon olmadan bir dağılımdan çekilen her değer diğerlerinden bağımsızdır. Correlation ikisinin birlikte hareket etmesini sağlar:

metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
AçıklamaÜzerindeAnlamı
Correlation coefficientabout a, b: her biri bir dağılıma sahip iki öznitelikDeğerlerinin sıra (Spearman) korelasyonu, -1 ile 1 arasında. 0 bağımsızdır, 1 onları her zaman aynı sıralar, -1 ters sıralar.
  • Her öznitelik kendi dağılımını korur. Simülatör tüm çiftleri tek bir korelasyon matrisinde (Gauss kopulası) birleştirir: bir çalıştırmada bir öznitelik için çekilen n. değer, ilişkili olduğu her özniteliğin n. değeriyle eşleşir.
  • Birbiriyle ilişkili özniteliklerden oluşan bir grubun katsayıları birbirine uymalıdır: a'nın b ile, b'nin c ile güçlü biçimde ilişkili olması ama a'nın c'ye ters olması imkânsızdır. Denetim böyle bir grubu bildirir; katsayılardan birini zayıflatın.
  • Süreler ve miktarlar (Consumes, Produces, Seizes) aynı şekilde ilişkilendirilir. Aynı tohumla yapılan bir çalıştırma aynı değerleri verir.
  • Simülatör'de, SysML motoruyla Monte Carlo modunda İlişkili girdiler kökün çiftlerini listeler. İki öznitelik ve bir katsayı seçip + Korelasyon ekle'ye tıklayın, bir katsayıyı değiştirin veya birini kaldırmak için ×'e tıklayın; her değişiklik tek bir Geri al ile geri alınır. Bir çalışmadan sonra Ulaşıldı, çalıştırmaların çektiği değerlerin sıra korelasyonunu gösterir.
  • Hybrid Car demosunun ChargeStop'u boş bir şarj cihazı bekleme süresini şarj süresiyle ilişkilendirir (0,6).

Olasılıklar ve sayılar

AçıklamaÜzerindeAnlamı
Probability percentBir karardan çıkan bir ardışıklıkDalın ağırlığı. Ağırlığı olmayan dallar 100'den kalanı paylaşır.
Bir if eylemiKoşul değerlendirilemediğinde then dalının olasılığı.
Bir döngü eylemiHer geçişten sonra yineleme olasılığı.
Bir geçişKoşul değerlendirilemediğinde koşulun sağlanma olasılığı.
LoopCount countBir döngü eylemiGeçiş sayısı; döngünün koşullarına göre önceliklidir.
LoopExitBir döngü gövdesinde done'a giden bir ardışıklıkYalnızca geçişi değil, tüm döngüyü bitirir.

Resource'lar ve maliyetler

AçıklamaÜzerindeAnlamı
Resource initial, minimum, maximum, unitBir parça veya item kullanımıBir miktar havuzu. Kullanım attribute level : Real bildiriyorsa simülatör onu miktara eşit tutar; böylece koşullar onu okuyabilir.
Consumes amountabout step, poolAdım başladığında alınır.
Produces amountabout step, poolAdım bittiğinde eklenir.
Seizes amountabout step, poolAdım başladığında alınır ve bittiğinde geri verilir.
Utilization amountBir perform eylem kullanımıAdımın, gerçekleştiren parçanın ne kadarını meşgul ettiği.
Cost amount, rate, unit, labelBir adım veya gerçekleştiren bir parçaKullanım başına (CostRate::perUse) veya saat başına (CostRate::perHour) bir maliyet.

SysML motoru gerektiren açıklamalar

AçıklamaAnlamı
Transfer latency, capacity, perBir bağlantı veya arayüz üzerinde: onun üzerinden gönderilen item'ları ve sinyalleri geciktirir.
Size sizeBir item üzerinde: aktarım gecikmeleri için boyutu.
Timeout limitBir birleşim üzerinde: sınır dolduğunda bitmemiş dalları durdurur.
NotBefore timeBir adım üzerinde: bu çalıştırma zamanından önce başlamaz.
ForkTargets, JoinSourcesParalel bir duruma giren veya ondan çıkan bir geçiş üzerinde: girilen alt durumlar veya etkin olması gereken alt durumlar.
History deepBileşik bir durum üzerinde: yeniden girmek, ayrılındığında etkin olan alt durumdan devam eder.
HostHook key, pointsHolarch için ayrılmıştır: çalıştırma listelenen noktalarda girdi için duraklar.

JavaScript simülatörü Probability, LoopCount ve dağılımları okur.

İletiler

İletiAnlamı
Bu projenin bazı simülasyon ayarları modelin parçası değil, Holarch verisidir.Eski ayarlar hâlâ modelin yanında saklanıyor. Simülasyon ayarlarını modele taşı…'ya tıklayın.
Simülasyon ayarları modele taşınmadan önceki Holarch verisi; modele göre önceliklidir.Özellik panelinin Simülasyon bölümünde gösterilir. Modele yazmak için alanı değiştirin veya tüm ayarları Simülatör'de taşıyın.
Modelde süre yok. Burada bir tane ayarlayın (attribute duration : ISQ::DurationValue yazar) veya metinde yazın.Adımın süre özniteliği yok.
@Normal: sd must be greater than zero. Change sd. (ve diğer dağılımlar ve parametreler için benzerleri)Bir dağılım parametresi eksik veya aralık dışında. SysML motoruyla model denetimi bunu Düzenleyici'de bildirir ve Simülatör düzeltilene kadar çalışmayı reddeder.
@Normal: sd has another unit dimension than …Bir konum veya ölçek parametresinin birimleri öznitelikten farklı; örneğin bir süre üzerinde metre.
@LoopCount does not apply to a part …Açıklama, uygulanmadığı türde bir öğe üzerinde duruyor. Taşıyın veya silin.
metadata Consumes … about needs an action and a part or item annotated @Resource.about'tan sonraki öğelerin sayısı veya türü yanlış.
A probability of N % is outside 0 to 100.0 ile 100 arasında bir yüzde girin.
The branch probabilities of this decision add up to N %; the simulator scales them to 100 %.Bir uyarı: her dalın bir ağırlığı var ve toplamları 100 değil.
A correlation needs two different attributes …, … is not an attribute … veya … has no distribution, so nothing is drawn to correlate …Bir Correlation bir özniteliği iki kez, öznitelik olmayan bir şeyi veya dağılımı olmayan bir özniteliği adlandırıyor.
The coefficient N is outside -1 to 1. veya The correlation has no coefficient.-1 ile 1 arasında bir katsayı girin.
“a” and “b” are already correlated; the first correlation is used. …Bir uyarı: aynı çiftin ikinci bir Correlation'ı yok sayılır. İkisinden birini kaldırın.
The correlations of … contradict each other: no joint distribution has them …Bir grubun katsayıları bir arada tutunamıyor (matris pozitif yarı tanımlı değil). Birini zayıflatın. Simülatör düzeltilene kadar çalışmayı reddeder.
Deadlock at <time>: N steps wait for something that never comes.SysML motoruyla sonuçların üstünde, bekleyen her adımla birlikte gösterilir. Göndericisi olmayan bir accept, hiç üretilmeyen bir item veya hiç serbest bırakılmayan bir resource çalıştırmayı durdurur.

Sınırlar

  • Süreler saniye, dakika, saat veya gün olarak yazılır (SI::s, SI::min, SI::h, SI::d). Milisaniyeler saniye olarak; haftalar, aylar ve yıllar gün olarak yazılır.
  • Durum makineleri, uyaranlar ve Şununla birlikte çalıştır SysML motorunu gerektirir.
  • İlişkili girdiler SysML motorunu gerektirir; JavaScript simülatörü her değeri bağımsız olarak çeker. Bir grupta en fazla 200 öznitelik ilişkilendirilebilir.
  • Çelişen katsayıların denetimi tek bir ad alanında yazılmış korelasyonları kapsar; Simülatör çalıştırmanın tüm korelasyonlarını denetler.

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