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ğı.
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,
ifkoş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
- Adımı, ardışıklığı, kararı, döngüyü veya
ifeylemini bir Action Flow View'da, Gezgin'de veya Düzenleyici'de seçin. - Ö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.
- 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::DurationValueyazar); 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. - 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
- Düzenleyici'yi açın.
- Açıklamayı öğenin gövdesinin içine
@HolarchSimulation::Kind { field = value; }olarak veya ondan sonrametadata HolarchSimulation::Kind about element { … }olarak ekleyin. - 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.
- Simülasyon ayarlarını modele taşı…'ya tıklayın.
- Önizleme her ayarı ve onun yerine geçen açıklamayı listeler.
- 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.
- Davranış → Simülatör'ü açın ve Kök olarak bir durum tanımı veya durumları sergileyen bir parça seçin.
- İ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'ı.
- 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.
- ▶ 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.
- 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 sonrakitoCruiseardışıklığının Probability değeri 70'tir;elsedalı kalan %30'u alır.cruisenominal 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;
drivebunun 1,5 Wh'ini Consumes ile tüketir ve kullanım başına 0,4 USD'lik bir Cost'u vardır. - PowertrainStates:
startElectricgeç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'aStartRequestgönderen, bir saat bekleyen, ardındanStopRequestvePlugIngö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
- SysML v2 projelerinde değerlendirme, birimler ve analiz: Simülatör adımları, ardışıklıkları ve süreleri nasıl okur.
- Simülasyon: Simülatör sayfası, panelleri ve Monte Carlo istatistikleri.
- SysML v2 metinsel gösterimi: metinde üst veri ve
about.
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çıklama | Alanlar | Anlamı |
|---|---|---|
| Normal | mean, sd | Normal dağılım. |
| Üçgen | low, mode, high | Üçgen; low ≤ mode ≤ high. |
| Düzgün | low, high | low ile high arasında düzgün. |
| Exponential | mean | Verilen ortalamayla üstel. |
| Gamma | shape, scale | Gama; ortalama shape × scale'dir. |
| LogNormal | median, sigma | Logaritma, medyanın logaritması etrafında normaldir. |
| Weibull | scale, shape | Weibull. |
| Beta | alpha, beta, scale | 0..1 üzerinde Beta, scale ile çarpılır. |
| Poisson | mean, scale | Verilen ortalamayla bir sayım, scale ile çarpılır. |
| Binomial | trials, p, scale | Bir 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 | Üzerinde | Anlamı |
|---|---|---|
Correlation coefficient | about a, b: her biri bir dağılıma sahip iki öznitelik | Değ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 | Üzerinde | Anlamı |
|---|---|---|
Probability percent | Bir karardan çıkan bir ardışıklık | Dalın ağırlığı. Ağırlığı olmayan dallar 100'den kalanı paylaşır. |
Bir if eylemi | Koşul değerlendirilemediğinde then dalının olasılığı. | |
| Bir döngü eylemi | Her geçişten sonra yineleme olasılığı. | |
| Bir geçiş | Koşul değerlendirilemediğinde koşulun sağlanma olasılığı. | |
LoopCount count | Bir döngü eylemi | Geçiş sayısı; döngünün koşullarına göre önceliklidir. |
| LoopExit | Bir döngü gövdesinde done'a giden bir ardışıklık | Yalnızca geçişi değil, tüm döngüyü bitirir. |
Resource'lar ve maliyetler
| Açıklama | Üzerinde | Anlamı |
|---|---|---|
Resource initial, minimum, maximum, unit | Bir 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 amount | about step, pool | Adım başladığında alınır. |
Produces amount | about step, pool | Adım bittiğinde eklenir. |
Seizes amount | about step, pool | Adım başladığında alınır ve bittiğinde geri verilir. |
Utilization amount | Bir perform eylem kullanımı | Adımın, gerçekleştiren parçanın ne kadarını meşgul ettiği. |
Cost amount, rate, unit, label | Bir adım veya gerçekleştiren bir parça | Kullanım başına (CostRate::perUse) veya saat başına (CostRate::perHour) bir maliyet. |
SysML motoru gerektiren açıklamalar
| Açıklama | Anlamı |
|---|---|
Transfer latency, capacity, per | Bir bağlantı veya arayüz üzerinde: onun üzerinden gönderilen item'ları ve sinyalleri geciktirir. |
Size size | Bir item üzerinde: aktarım gecikmeleri için boyutu. |
Timeout limit | Bir birleşim üzerinde: sınır dolduğunda bitmemiş dalları durdurur. |
NotBefore time | Bir adım üzerinde: bu çalıştırma zamanından önce başlamaz. |
| ForkTargets, JoinSources | Paralel bir duruma giren veya ondan çıkan bir geçiş üzerinde: girilen alt durumlar veya etkin olması gereken alt durumlar. |
History deep | Bileşik bir durum üzerinde: yeniden girmek, ayrılındığında etkin olan alt durumdan devam eder. |
HostHook key, points | Holarch 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
| İleti | Anlamı |
|---|---|
| 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.
İlgili
SysML® ve OMG®, Object Management Group, Inc.'in Amerika Birleşik Devletleri'nde ve diğer ülkelerde tescilli ticari markalarıdır.