SysML v2
SysML v2 प्रोजेक्ट में सिमुलेशन मेटाडेटा
HolarchSimulation मेटाडेटा लाइब्रेरी: SysML v2 मॉडल सिम्युलेटर के लिए अवधि, ब्रांच प्रायिकताएं, लूप गिनती, संसाधन, लागत और स्टेट मशीन सेटिंग्स कैसे रखता है, और उन्हें कैसे लिखें और ले जाएं।
अवलोकन
SysML v2 प्रोजेक्ट में सिम्युलेटर की सेटिंग्स मॉडल का हिस्सा हैं। ये लाइब्रेरी पैकेज HolarchSimulation की metadata टिप्पणियां हैं, जिसे हर SysML v2 प्रोजेक्ट लोड करता है। इनका उपयोग करने वाला मॉडल मान्य SysML v2 रहता है: दूसरे टूल टिप्पणियों को सामान्य metadata के रूप में पढ़ते हैं, और केवल सिम्युलेटर उन्हें अर्थ देता है।
टिप्पणी या तो उस एलिमेंट के अंदर होती है जिस पर वह है, या about से उस एलिमेंट का नाम लेती है:
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"; }
अवधारणाएं
नाममात्र मान और distribution
किसी चरण की अवधि उसका attribute duration है (या DurationValue या TimeValue से टाइप किया गया attribute)। इसका मान नाममात्र अवधि है जिसे दूसरे टूल और Holarch का मूल्यांकन देखते हैं। उस attribute पर distribution टिप्पणी सिम्युलेटर से इसके बजाय अवधि निकलवाती है:
action cruise {
attribute duration : ISQ::DurationValue = 1 [min] {
@HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
}
}
कौन सी सेटिंग्स प्रभावी होती हैं
- distribution टिप्पणी attribute के अपने मान पर प्रभावी होती है।
- जिस guard,
ifशर्त या लूप शर्त का मॉडल मूल्यांकन कर सकता है, वह खुद निर्णय लेती है। Probability या LoopCount का उपयोग केवल तब होता है जब वह नहीं कर सकता (LoopCount हमेशा पास गिनता है)। - सिमुलेशन सेटिंग्स के मॉडल में जाने से पहले बनाई गई सेटिंग्स मॉडल के बगल में Holarch डेटा के रूप में रखी जाती हैं। वे तब तक प्रभावी रहती हैं, ताकि रन वही परिणाम दें, जब तक आप उन्हें अंदर नहीं ले जाते (देखें पुरानी सेटिंग्स मॉडल में ले जाएं)।
दो सिम्युलेटर
सिम्युलेटर पेज सेटिंग्स के दाईं ओर दिखाता है कि कौन सा सिम्युलेटर मॉडल चलाता है: SysML इंजन (Holarch Language Engine का सिम्युलेटर) या JavaScript सिम्युलेटर। दोनों वही टिप्पणियां पढ़ते हैं। State machines, stimuli, Resource, Consumes, Produces और Seizes से resources, Cost से costs, और ऐसी टिप्पणियां जिन्हें SysML इंजन चाहिए के नीचे की दूसरी टिप्पणियां केवल SysML इंजन के साथ चलती हैं।
इसका उपयोग कैसे करें
कब और क्यों
जब मॉडल डिज़ाइन का रिकॉर्ड हो, तो सिमुलेशन सेटिंग्स मॉडल में लिखें: संख्याएं .sysml फ़ाइलों के साथ जाती हैं, टेक्स्ट की समीक्षाओं में दिखती हैं, और बाकी मॉडल के साथ संस्करणित होती हैं। किसी परिचालन परिदृश्य (टाइमलाइन, शाखा हिस्से, resource उपयोग) का विश्लेषण करते समय और किसी requirement को Monte Carlo स्टडी के विरुद्ध जांचने से पहले इनका उपयोग करें।
अवधि, प्रायिकता या लूप गिनती सेट करें
- Action Flow View पर, ब्राउज़र में या एडिटर में चरण, succession, decision, loop या
ifaction चुनें। - इंस्पेक्टर के सिमुलेशन सेक्शन में अवधि (एक निश्चित मान या distribution), प्रायिकता (%), पुनरावृत्तियां या then की प्रायिकता (%) सेट करें।
- Holarch टिप्पणी मॉडल में लिखता है: अवधि attribute का मान माध्य पर सेट करती है और distribution टिप्पणी जोड़ती है (या जब चरण में कोई नहीं है तो
attribute duration : ISQ::DurationValueलिखती है); प्रायिकता (%) Probability लिखती है; पुनरावृत्तियां LoopCount लिखती है। हर बदलाव एक ही बार पूर्ववत करके वापस लिया जा सकता है और तुरंत टेक्स्ट में दिखता है। - उसकी टिप्पणी हटाने के लिए फ़ील्ड साफ़ करें।
Holarch हर बदलाव को लिखने से पहले SysML चेकर से जांचता है। जो बदलाव कोई त्रुटि जोड़ेगा, वह नहीं लिखा जाता, और एक संदेश समस्या बताता है।
टेक्स्ट में टिप्पणियां लिखें
- एडिटर खोलें।
- टिप्पणी एलिमेंट की बॉडी के अंदर
@HolarchSimulation::Kind { field = value; }के रूप में जोड़ें, या उसके बादmetadata HolarchSimulation::Kind about element { … }के रूप में। - Consumes, Produces और Seizes के लिए पहले चरण और फिर resource का नाम लें:
metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }।
पुरानी सेटिंग्स मॉडल में ले जाएं
जिन प्रोजेक्ट की सिमुलेशन सेटिंग्स मॉडल में जाने से पहले बनाई गई थीं, वे सिम्युलेटर की सेटिंग्स के ऊपर इस प्रोजेक्ट की कुछ सिमुलेशन सेटिंग्स Holarch डेटा हैं, मॉडल का हिस्सा नहीं। दिखाते हैं।
- सिमुलेशन सेटिंग्स मॉडल में ले जाएं… पर क्लिक करें।
- पूर्वावलोकन हर सेटिंग और उसकी जगह लेने वाली टिप्पणी सूचीबद्ध करता है।
- मॉडल में ले जाएं पर क्लिक करें। सभी सेटिंग्स चली जाती हैं, और एक ही बार पूर्ववत करने से सब वापस हो जाता है; रन वही परिणाम देते हैं।
state machine सिमुलेट करें
State machines SysML इंजन के साथ चलती हैं।
- व्यवहार → सिम्युलेटर खोलें और रूट के रूप में एक state definition, या states exhibit करने वाला part चुनें।
- वैकल्पिक: इसके साथ चलाएं के नीचे एक परिदृश्य action चुनें जो part को signals भेजता है, जैसे डेमो का TestDrive।
- उद्दीपन के नीचे + स्टिमुलस जोड़ें पर क्लिक करें और समय (समय और इकाई), सिग्नल और To (एक मशीन, या हर मशीन जो इसे स्वीकार करती है) सेट करें।
- ▶ चलाएं, ⏭ Step या ⏩ अंत तक चलाएं दबाएं। चलते समय स्टेट मशीन सक्रिय states को रोशन करता है और चले हुए transition को चिह्नित करता है; अवस्थाएं टैब समय के साथ अवस्थाएं और चले हुए संक्रमण दिखाता है।
- Monte Carlo में अवस्थाएं टैब स्टेट में समय और संक्रमण गिनती दिखाता है। Requirement से जांचें… आउटपुट के रूप में हर state का स्टेट में समय और रन में हिस्सा देता है।
State Transition View पर ▶ सिमुलेट करें ▶ चलाएं, ⏭ Step, ⏩ अंत तक चलाएं, रीसेट करें और सिम्युलेटर में खोलें वाली एक पट्टी खोलता है। रन उस state definition के लिए सिम्युलेटर पर सहेजे गए stimuli का उपयोग करता है।
हल किया गया उदाहरण: Hybrid Car डेमो
Hybrid Car डेमो (प्रोजेक्ट प्रबंधित करें → प्रोजेक्ट फ़ाइलें ▾ → नया डेमो प्रोजेक्ट) लाइब्रेरी का उपयोग करता है:
- DriveCycle:
shiftके बाद successiontoCruiseकी Probability 70 है;elseशाखा बाकी 30 % लेती है।cruiseनाममात्र 1 min लेता है, Triangular distribution (45 s, 1 min, 2 min) से निकाला गया। - DrivenCar: पावरट्रेन की बैटरी 62 Wh का एक Resource है;
driveउसमें से 1.5 Wh Consumes करता है और हर उपयोग पर 0.4 USD की Cost है। - PowertrainStates: transition
startElectricके guard के लिए Probability 80 है;accept when charge < 15चार्ज गिरने पर hybrid में बदलता है;accept after 30 [min]चार्जिंग समाप्त करता है। - TestDrive: एक परिदृश्य जो
StartRequestभेजता है, एक घंटा प्रतीक्षा करता है, फिरdemoCarकोStopRequestऔरPlugInभेजता है। पावरट्रेन को states बदलते देखने के लिए Demo Car को Test Drive के साथ चलाएं।
डेमो 0 डायग्नोस्टिक्स के साथ जांच पास करता है।
सुझाव और अच्छे तरीके
- नाममात्र मान को सार्थक रखें: इसे distribution के अपेक्षित मान पर सेट करें, जैसा इंस्पेक्टर करता है।
- जिन successions पर आप टिप्पणी करते हैं, उन्हें नाम दें (
succession toCruise first …), ताकि टिप्पणी टेक्स्ट में आसानी से मिल सके। - प्रायिकताओं के बजाय ऐसी शर्तें पसंद करें जिनका मॉडल मूल्यांकन कर सके; जो मॉडल वर्णित नहीं करता, उसके लिए Probability का उपयोग करें।
सामान्य ग़लतियां
- प्रायिकता का कोई प्रभाव नहीं होता: guard का मूल्यांकन हो सकता है, इसलिए वह निर्णय लेता है। इंस्पेक्टर कहता है "true में मूल्यांकित: हमेशा ली जाती है।" या "false में मूल्यांकित: कभी नहीं ली जाती।"
- शाखा प्रायिकताओं का योग 100 % नहीं होता: बिना Probability वाली शाखाएं बचा हुआ बांटती हैं; जब दी गई प्रायिकताएं 100 % से अधिक हों, तो चेतावनी कहती है "शाखा प्रायिकताओं का योग N % है। इन्हें बदलकर कुल 100 % करें।"
- चरण पर ही अवधि टिप्पणी: distributions duration attribute पर होती हैं, action पर नहीं।
यह कैसे जुड़ता है
- SysML v2 प्रोजेक्ट में मूल्यांकन, इकाइयां और विश्लेषण: सिम्युलेटर चरण, successions और अवधियां कैसे पढ़ता है।
- सिमुलेशन: सिम्युलेटर पेज, उसके पैनल और Monte Carlo आंकड़े।
- SysML v2 टेक्स्ट संकेतन: टेक्स्ट में metadata और
about।
टिप्पणियां
Distributions
किसी duration attribute पर distribution रखें। स्थान और पैमाने के फ़ील्ड इकाई वाली मात्रा लेते हैं (45 [s], 2 [min]); आकार के फ़ील्ड एक संख्या लेते हैं।
| टिप्पणी | फ़ील्ड | अर्थ |
|---|---|---|
| सामान्य (Normal) | mean, sd | सामान्य (Normal) distribution। |
| त्रिकोणीय (Triangular) | low, mode, high | Triangular, low ≤ mode ≤ high के साथ। |
| एकसमान (Uniform) | low, high | low और high के बीच Uniform। |
| Exponential | mean | दिए गए माध्य के साथ Exponential। |
| Gamma | shape, scale | Gamma; माध्य shape × scale है। |
| LogNormal | median, sigma | लघुगणक माध्यिका के लघुगणक के आसपास सामान्य होता है। |
| Weibull | scale, shape | Weibull। |
| Beta | alpha, beta, scale | 0..1 पर Beta, गुणा scale। |
| Poisson | mean, scale | दिए गए माध्य वाली एक गिनती, गुणा scale। |
| Binomial | trials, p, scale | कुछ प्रयासों में सफलताएं, गुणा scale। |
शून्य से नीचे निकली अवधियां फिर से निकाली जाती हैं।
सहसंबद्ध इनपुट
correlation के बिना, किसी distribution से निकला हर मान दूसरों से स्वतंत्र होता है। Correlation उनमें से दो को साथ-साथ चलाता है:
metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
| टिप्पणी | किस पर | अर्थ |
|---|---|---|
Correlation coefficient | about a, b: दो attributes, हर एक distribution के साथ | उनके मानों का रैंक (Spearman) सहसंबंध, -1 से 1 तक। 0 स्वतंत्र है, 1 उन्हें हमेशा एक जैसा रैंक देता है, -1 उलटा। |
- हर attribute अपना distribution रखता है। सिम्युलेटर सभी जोड़ों को एक सहसंबंध मैट्रिक्स (Gaussian copula) में जोड़ता है: किसी रन में किसी attribute के लिए निकला n-वां मान हर उस attribute के n-वें मान के साथ जाता है जिससे वह सहसंबद्ध है।
- सहसंबद्ध attributes के किसी समूह के गुणांक आपस में मेल खाने चाहिए: a का b से मज़बूत, b का c से मज़बूत, लेकिन a का c से उलटा सहसंबंध असंभव है। जांच ऐसे समूह की रिपोर्ट करती है; किसी एक गुणांक को कमज़ोर करें।
- अवधियां और मात्राएं (Consumes, Produces, Seizes) एक ही तरह सहसंबद्ध होती हैं। एक ही सीड वाला रन वही मान देता है।
- सिम्युलेटर पर, SysML इंजन के साथ Monte Carlo मोड में, सहसंबद्ध इनपुट रूट के जोड़े सूचीबद्ध करता है। दो attributes और एक गुणांक चुनें और + सहसंबंध जोड़ें पर क्लिक करें, कोई गुणांक बदलें, या एक हटाने के लिए × पर क्लिक करें; हर बदलाव को एक ही बार पूर्ववत करके वापस लिया जा सकता है। स्टडी के बाद, प्राप्त रनों द्वारा निकाले गए मानों का रैंक सहसंबंध दिखाता है।
- Hybrid Car डेमो का
ChargeStopखाली चार्जर की प्रतीक्षा को चार्जिंग समय (0.6) से सहसंबद्ध करता है।
संभावनाएं और गिनती
| टिप्पणी | किस पर | अर्थ |
|---|---|---|
Probability percent | किसी decision से निकलने वाला succession | शाखा का भार। जिन शाखाओं का भार नहीं है, वे 100 में से बचा हुआ बांटती हैं। |
एक if action | जब शर्त का मूल्यांकन नहीं हो सकता, तब then शाखा की संभावना। | |
| एक loop action | हर पास के बाद दोहराने की संभावना। | |
| एक transition | जब guard का मूल्यांकन नहीं हो सकता, तब उसके लागू होने की संभावना। | |
LoopCount count | एक loop action | पास की संख्या; यह लूप की शर्तों पर प्राथमिकता लेती है। |
| LoopExit | किसी loop बॉडी में done तक एक succession | पूरा लूप समाप्त करता है, केवल पास नहीं। |
Resources और costs
| टिप्पणी | किस पर | अर्थ |
|---|---|---|
Resource initial, minimum, maximum, unit | एक part या item usage | किसी मात्रा का एक पूल। अगर usage attribute level : Real घोषित करता है, तो सिम्युलेटर उसे मात्रा के बराबर रखता है, ताकि guards उसे पढ़ सकें। |
Consumes amount | about step, pool | चरण शुरू होने पर लिया जाता है। |
Produces amount | about step, pool | चरण समाप्त होने पर जोड़ा जाता है। |
Seizes amount | about step, pool | चरण शुरू होने पर लिया जाता है और समाप्त होने पर लौटाया जाता है। |
Utilization amount | एक perform action usage | चरण करने वाले part का कितना हिस्सा घेरता है। |
Cost amount, rate, unit, label | एक चरण या करने वाला part | प्रति उपयोग (CostRate::perUse) या प्रति घंटा (CostRate::perHour) लागत। |
ऐसी टिप्पणियां जिन्हें SysML इंजन चाहिए
| टिप्पणी | अर्थ |
|---|---|
Transfer latency, capacity, per | किसी connection या interface पर: उस पर भेजे गए items और signals को विलंबित करता है। |
Size size | किसी item पर: ट्रांसफ़र विलंब के लिए उसका आकार। |
Timeout limit | किसी join पर: सीमा समाप्त होने पर अधूरी शाखाएं रोकता है। |
NotBefore time | किसी चरण पर: यह इस रन समय से पहले शुरू नहीं होता। |
| ForkTargets, JoinSources | किसी parallel state में या उससे बाहर जाने वाले transition पर: प्रवेश की गई substates, या वे substates जिन्हें सक्रिय होना चाहिए। |
History deep | किसी composite state पर: फिर से प्रवेश करने पर वही substate जारी होती है जो छोड़ते समय सक्रिय थी। |
HostHook key, points | Holarch के लिए आरक्षित: रन सूचीबद्ध बिंदुओं पर इनपुट के लिए रुकता है। |
JavaScript सिम्युलेटर Probability, LoopCount और distributions पढ़ता है।
संदेश
| संदेश | अर्थ |
|---|---|
| इस प्रोजेक्ट की कुछ सिमुलेशन सेटिंग्स Holarch डेटा हैं, मॉडल का हिस्सा नहीं। | पुरानी सेटिंग्स अभी भी मॉडल के बगल में संग्रहीत हैं। सिमुलेशन सेटिंग्स मॉडल में ले जाएं… पर क्लिक करें। |
| सिमुलेशन सेटिंग्स के मॉडल में जाने से पहले का Holarch डेटा; यह मॉडल पर प्रभावी होता है। | इंस्पेक्टर के सिमुलेशन सेक्शन में दिखता है। इसे मॉडल में लिखने के लिए फ़ील्ड बदलें, या सिम्युलेटर पर सभी सेटिंग्स ले जाएं। |
| मॉडल में कोई अवधि नहीं। यहाँ एक सेट करें (यह attribute duration : ISQ::DurationValue लिखता है), या इसे टेक्स्ट में लिखें। | चरण में कोई duration attribute नहीं है। |
| @Normal: sd must be greater than zero. Change sd. (sd शून्य से बड़ा होना चाहिए) (और दूसरे distributions और पैरामीटर के लिए इसी तरह) | कोई distribution पैरामीटर गायब है या सीमा से बाहर है। SysML इंजन के साथ, मॉडल जांच इसकी रिपोर्ट एडिटर में करती है और ठीक होने तक सिम्युलेटर चलने से इनकार करता है। |
| @Normal: sd has another unit dimension than … (sd का इकाई आयाम अलग है) | किसी स्थान या पैमाने के पैरामीटर की इकाइयां attribute से अलग हैं, उदाहरण के लिए किसी अवधि पर मीटर। |
| @LoopCount does not apply to a part … (part पर लागू नहीं होता) | टिप्पणी ऐसे प्रकार के एलिमेंट पर है जिस पर वह लागू नहीं होती। इसे ले जाएं या हटाएं। |
| metadata Consumes … about needs an action and a part or item annotated @Resource. (एक action और @Resource वाला part या item चाहिए) | about के बाद के एलिमेंट संख्या या प्रकार में गलत हैं। |
| N % की प्रायिकता 0 से 100 के बाहर है। | 0 से 100 तक प्रतिशत दर्ज करें। |
| इस decision की शाखा प्रायिकताओं का योग N % है; सिम्युलेटर उन्हें 100 % पर स्केल करता है। | एक चेतावनी: हर शाखा का भार है और उनका योग 100 नहीं है। |
| A correlation needs two different attributes …, … is not an attribute … या … has no distribution, so nothing is drawn to correlate … (correlation को दो अलग attributes चाहिए / attribute नहीं है / कोई distribution नहीं है) | कोई Correlation एक attribute का नाम दो बार लेता है, ऐसी चीज़ का जो attribute नहीं है, या बिना distribution वाले attribute का। |
| The coefficient N is outside -1 to 1. या The correlation has no coefficient. (गुणांक -1 से 1 के बाहर है / correlation में कोई गुणांक नहीं है) | -1 से 1 तक गुणांक दर्ज करें। |
| “a” और “b” पहले से सहसंबद्ध हैं; पहले correlation का उपयोग होता है। … | एक चेतावनी: उसी जोड़े का दूसरा Correlation अनदेखा किया जाता है। दोनों में से एक हटाएं। |
| … के correlations एक-दूसरे का खंडन करते हैं: किसी संयुक्त distribution में वे नहीं होते … | किसी समूह के गुणांक एक साथ नहीं टिक सकते (मैट्रिक्स positive semidefinite नहीं है)। एक को कमज़ोर करें। ठीक होने तक सिम्युलेटर चलने से इनकार करता है। |
| <time> पर गतिरोध: N चरण ऐसी चीज़ की प्रतीक्षा करते हैं जो कभी नहीं आती। | SysML इंजन के साथ परिणामों के ऊपर, हर प्रतीक्षारत चरण के साथ दिखता है। बिना भेजने वाले का accept, कभी न बना item या कभी न छोड़ा गया resource रन रोक देता है। |
सीमाएं
- अवधियां सेकंड, मिनट, घंटे या दिन (
SI::s,SI::min,SI::h,SI::d) में लिखी जाती हैं। मिलीसेकंड सेकंड के रूप में लिखे जाते हैं; सप्ताह, महीने और वर्ष दिनों के रूप में। - State machines, stimuli और इसके साथ चलाएं को SysML इंजन चाहिए।
- सहसंबद्ध इनपुट को SysML इंजन चाहिए; JavaScript सिम्युलेटर हर मान स्वतंत्र रूप से निकालता है। एक समूह में अधिकतम 200 attributes सहसंबद्ध हो सकते हैं।
- खंडन करने वाले गुणांकों की जांच एक namespace में लिखे correlations को कवर करती है; सिम्युलेटर रन के सभी correlations जांचता है।
संबंधित
SysML® और OMG®, संयुक्त राज्य अमेरिका और अन्य देशों में Object Management Group, Inc. के पंजीकृत ट्रेडमार्क हैं।