Посібник · SysML v2
Посібник із SysML v2: модель системи живлення CubeSat у текстовій нотації
Слухати цей посібник 24 хв
Цей підручник із SysML v2 крок за кроком будує невелику завершену модель: систему електроживлення CubeSat EO-1 з її частинами, величинами й одиницями, портами й з’єднаннями, циклом освітлення й тіні, вимогами, які може перевірити інструмент, випадком верифікації та поданнями. Кожен лістинг на цій сторінці — це текст SysML v2, перевірений мовним рушієм, а кожен ключовий крок показує діаграму, яку створює текст.
На цій сторінці
- Що ви побудуєте
- Перша ідея: визначення й використання
- Крок 1: пакет та його імпорти
- Крок 2: визначення частин і атрибути з одиницями
- Крок 3: збірка зі значеннями
- Крок 4: порти, інтерфейси й з’єднання
- Крок 5: поведінка з діями й потоками
- Крок 6: розподіл поведінки на структуру
- Крок 7: вимоги з обмеженнями
- Крок 8: випадок верифікації
- Крок 9: подання й діаграми
- Повна модель
- Як перевіряли лістинги
- Спробуйте в Holarch
- Куди далі
Що ви побудуєте
EO-1 — це 6U CubeSat для спостереження Землі на сонячно-синхронній орбіті висотою 500 km. Це спільний приклад цих посібників; приклад проєкту MBSE простежує весь космічний апарат від потреб до верифікації. Цей підручник бере одну підсистему, систему електроживлення (СЕЖ), і записує її в тексті SysML v2.
СЕЖ має три частини. Дві розгортні сонячні батареї перетворюють сонячне світло на енергію. Літій-іонний акумуляторний блок запасає енергію на час тіні. Блок розподілу живлення (PDU) відстежує точку максимальної потужності батарей, заряджає акумулятор і стабілізує шину 12 V. У моделі є й два навантаження на цій шині: камера корисного навантаження та передавач S-діапазону.
Числа взято з моделі EO-1:
| Елемент обміну | Значення | Де використовується |
|---|---|---|
| Сонячні батареї: площа елементів, ККД елементів, пікова потужність | 0.2 m², 0.295, 75.4 W | Крок 3 |
| ККД тракту живлення; освітлена частка орбіти | 0.6; 0.62 | Крок 3 |
| Акумуляторний блок: ємність; енергія, витрачена за 36 хвилин тіні | 77 Wh; 18.5 Wh | Крок 3 |
| Маса: батареї, акумулятор, PDU | 0.45 kg, 0.62 kg, 0.28 kg | Крок 3 |
| Середньовиткове споживання: камера, передавач S-діапазону | 6.2 W, 3.4 W | Крок 3 |
| Вимога 3.1 Orbit Average Power | щонайменше 28 W наприкінці строку служби | Крок 7 |
| Вимога 3.2 Battery Capacity | щонайменше 77 Wh на початку строку служби | Кроки 7 і 8 |
| Вимога 3.3 Depth of Discharge | не більше 30% за виток | Крок 7 |
| Тестовий випадок TC-07 Battery Capacity Test | розряд струмом C/2 у камері за 20 °C | Крок 8 |
Модель має три пакети:
| Пакет | Містить | Кроки |
|---|---|---|
CubeSatEPS | Порти, частини, обчислення, збірки з їхніми значеннями та поведінка | Від 1 до 6 |
CubeSatEPSRequirements | Вимоги 3.1–3.3 і випадок верифікації TC-07 | 7 і 8 |
CubeSatEPSViews | Подання, що вибирають частини моделі для діаграм | 9 |
Щоб виконувати кроки, конкретний інструмент не потрібен: текст — це звичайний SysML v2, і він завантажується в будь-який інструмент, що читає текстову нотацію. Повна модель наведена наприкінці сторінки і доступна для завантаження, а останній розділ показує, як завантажити її в Holarch.
Перша ідея: визначення й використання
SysML v2 відокремлює визначення від використання. Визначення каже, чим є певний вид речей: part def BatteryPack описує кожен акумуляторний блок цієї конструкції з його атрибутами й портами. Використання — це така річ у контексті: part battery : BatteryPack усередині системи живлення — це єдиний акумулятор СЕЖ EO-1, з’єднаний з її PDU.
Та сама пара проходить через усю мову: attribute def і attribute, port def і port, action def і action, requirement def і requirement. Ключове слово з def оголошує вид; те саме ключове слово без def його використовує. Конкретні значення зазвичай належать використанням, бо саме у використанні ухвалюється проєктне рішення.
Читачі, які знають SysML v1, можуть порівняти визначення з блоком, а використання — з властивістю частини. У SysML v2 ця ідея застосовується до кожного виду елементів, а використання вкладаються одне в одне й уточнюють одне одного на будь-яку глибину. SysML v1 і SysML v2 порівнює дві мови конструкція за конструкцією.
Крок 1: пакет та його імпорти
Пакет — це простір імен: він групує елементи й дає їм кваліфіковані імена, як-от CubeSatEPS::BatteryPack. Почніть із порожнього пакета й потрібних йому імпортів бібліотек.
package CubeSatEPS {
doc /* The electrical power system (EPS) of the EO-1 CubeSat: solar arrays, a battery pack and a power distribution unit that feed the payload camera and the S-band transmitter. */
private import ScalarValues::*;
private import ISQ::*;
private import SI::*;
}
doc /* … */додає документацію до пакета. На відміну від коментаря//, вона є частиною моделі, і інструменти показують її разом з елементом.ScalarValuesнадає базові типи, як-отReal,Integer,BooleanіString.ISQнадає типи величин з Міжнародної системи величин, як-отMassValue,PowerValueіEnergyValue.SIнадає одиниці SI, як-отkg,V,Wіh.privateзалишає імпортовані імена всередині цього пакета, тож пакет, який імпортуєCubeSatEPS, не отримує їх через нього.
Без імпортів таке ім’я, як MassValue, не може бути розпізнане, і засіб перевірки повідомить, що воно невідоме.
Крок 2: визначення частин і атрибути з одиницями
Кожен компонент отримує визначення частини з типізованими атрибутами. Типізація атрибута величиною, а не Real, фіксує, що саме він вимірює: масу, потужність, енергію. Тоді інструмент може перевірити кожне значення й кожен вираз на узгодженість розмірностей.
part def SolarArray {
attribute mass : MassValue;
attribute cellArea : AreaValue;
attribute cellEfficiency : Real;
attribute peakPower : PowerValue;
attribute pathEfficiency : Real;
}
part def BatteryPack {
attribute mass : MassValue;
attribute capacity : EnergyValue;
}
part def PowerDistributionUnit {
attribute mass : MassValue;
attribute busVoltage : ElectricPotentialValue;
}
part def PayloadCamera {
attribute powerDraw : PowerValue;
}
part def SBandTransmitter {
attribute powerDraw : PowerValue;
}
Ці рядки розміщуються у фігурних дужках пакета. Два ККД залишаються простим Real, бо це безрозмірні відношення.
Значень поки немає. Визначення описує кожен акумуляторний блок цього виду; числа з’являться разом із власним акумулятором EO-1 на наступному кроці.
Крок 3: збірка зі значеннями
Система живлення теж є визначенням частини, складеним з використань частин: сонячних батарей, акумулятора й PDU. Кожне використання задає значення атрибутам, які воно успадковує від свого визначення. Багаторазове обчислення перетворює пікову потужність батарей на середньовиткову потужність, щодо якої сформульовано вимогу 3.1.
calc def OrbitAverage {
doc /* Orbit-average array output (EQ-1.3): peak power times the sunlit fraction times the power path efficiency. */
in peakPower : PowerValue;
in sunlitFraction : Real;
in pathEfficiency : Real;
return : PowerValue = peakPower * sunlitFraction * pathEfficiency;
}
part def ElectricalPowerSystem {
part solarArrays : SolarArray {
attribute redefines mass = 0.45 [kg];
attribute redefines cellArea = 0.2 [m^2];
attribute redefines cellEfficiency = 0.295;
attribute redefines peakPower = 75.4 [W];
attribute redefines pathEfficiency = 0.6;
}
part battery : BatteryPack {
attribute redefines mass = 0.62 [kg];
attribute redefines capacity = 77 [W*h];
}
part pdu : PowerDistributionUnit {
attribute redefines mass = 0.28 [kg];
attribute redefines busVoltage = 12 [V];
}
attribute sunlitFraction : Real = 0.62;
attribute eclipseEnergy : EnergyValue = 18.5 [W*h];
attribute orbitAveragePower : PowerValue = OrbitAverage(solarArrays.peakPower, sunlitFraction, solarArrays.pathEfficiency);
attribute depthOfDischarge : Real = eclipseEnergy / battery.capacity;
attribute totalMass : MassValue = solarArrays.mass + battery.mass + pdu.mass;
}
part def Spacecraft {
part eps : ElectricalPowerSystem;
part camera : PayloadCamera {
attribute redefines powerDraw = 6.2 [W];
}
part transmitter : SBandTransmitter {
attribute redefines powerDraw = 3.4 [W];
}
}
part battery : BatteryPackоголошує використання з іменемbattery, типізоване визначеннямBatteryPack.attribute redefines capacity = 77 [W*h]задає значення успадкованому атрибутуcapacity. Коротка форма:>> capacity = 77 [W*h];означає те саме. Безredefinesрядок оголосив би другий атрибут, що лише має те саме ім’я, а успадкованийcapacityтак і залишився б без значення.77 [W*h]— це величина: число й одиниця. Одиниці поєднуються через*,/і^, тож ват-години — цеW*h, а квадратні метри —m^2.calc def OrbitAverage— це обчислення з входами й типізованим результатом.OrbitAverage(…)викликає його зі значеннями батарей, тож формула записується один раз, і кожне її використання враховує зміну.depthOfDischargeділить енергію на енергію. Одиниці скорочуються, і результат є простим відношенням.Spacecraftрозміщує систему живлення поряд із двома навантаженнями, які розглядає цей підручник. Решту EO-1 (систему орієнтації, бортовий комп’ютер, конструкцію) пропущено, щоб модель залишалася короткою.
Значення не просто зберігаються; інструмент їх обчислює. З наведеними вище числами:
| Атрибут | Вираз | Результат |
|---|---|---|
orbitAveragePower | 75.4 W × 0.62 × 0.6 | 28.05 W |
depthOfDischarge | 18.5 Wh ÷ 77 Wh | 0.24 |
totalMass | 0.45 kg + 0.62 kg + 0.28 kg | 1.35 kg |
Сама пікова потужність має джерело, яке можна перевірити: 0.2 m² елементів із ККД 0.295 під сонячним світлом 1361 W/m² за кута падіння 0.35 rad (cos 0.35 = 0.939) дають 75.4 W. Освітлена частка випливає з орбіти: виток на висоті 500 km триває близько 94.6 хвилини, з них 36 у тіні, тож на сонячне світло припадає 0.62 орбіти.
Оскільки кожне значення має одиницю, помилка розмірності проявляється, щойно модель перевіряють. Поширена помилка в моделях живлення — записати ємність акумулятора у ватах замість ват-годин:
package UnitCheck {
private import ISQ::*;
private import SI::*;
part def BatteryPack {
attribute capacity : EnergyValue;
}
part battery : BatteryPack {
attribute redefines capacity = 77 [W];
}
}
Засіб перевірки, що обчислює одиниці, відхиляє значення: потужність — не енергія. У Holarch Редактор позначає рядок помилкою розмірності. В електронній таблиці та сама помилка непомітно потрапила б у глибину розряду.
Крок 4: порти, інтерфейси й з’єднання
Порти — це точки, де частина стикається з оточенням. Визначення порту перелічує, що перетинає межу, кожну характеристику з напрямком: out — для того, що власник надсилає, in — для того, що він отримує.
port def DCPowerPort {
out attribute voltage : ElectricPotentialValue;
out attribute current : ElectricCurrentValue;
}
port def BusPowerPort {
out attribute voltage : ElectricPotentialValue;
out attribute powerLimit : PowerValue;
}
interface def BusLink {
end source : BusPowerPort;
end load : ~BusPowerPort;
}
Сторона, що отримує, використовує те саме визначення порту, спряжене за допомогою ~. ~BusPowerPort — дзеркальне відображення BusPowerPort: кожне out стає in. Одне визначення порту описує обидва кінці зв’язку, тож два кінці не можуть розійтися.
Визначення інтерфейсу описує вид з’єднання з типізованими кінцями. BusLink з’єднує шину 12 V, що надсилає енергію, з навантаженням, яке її отримує. Воно відіграє роль інтерфейсу живлення 12 V EO-1 (IFB-1).
Тепер додайте порти до частин і з’єднайте їх. Рядки коментарів замінюють рядки з попередніх кроків.
part def SolarArray {
// attributes as in step 2
port arrayOut : DCPowerPort;
}
part def BatteryPack {
// attributes as in step 2
port cellsOut : DCPowerPort;
}
part def PowerDistributionUnit {
// attributes as in step 2
port arrayIn : ~DCPowerPort;
port batteryIn : ~DCPowerPort;
port busOut : BusPowerPort;
}
part def PayloadCamera {
// attributes as in step 2
port powerIn : ~BusPowerPort;
}
part def SBandTransmitter {
// attributes as in step 2
port powerIn : ~BusPowerPort;
}
part def ElectricalPowerSystem {
// parts as in step 3
port bus : BusPowerPort;
connect solarArrays.arrayOut to pdu.arrayIn;
connect battery.cellsOut to pdu.batteryIn;
bind bus = pdu.busOut;
// computed attributes as in step 3
}
part def Spacecraft {
// parts as in step 3
interface payloadPower : BusLink connect eps.bus to camera.powerIn;
interface radioPower : BusLink connect eps.bus to transmitter.powerIn;
}
connect solarArrays.arrayOut to pdu.arrayIn— звичайне з’єднання: джгут сонячних батарей (інтерфейс EO-1 IF-20).battery.cellsOutдоpdu.batteryIn— джгут акумулятора (IF-21).bind bus = pdu.busOutстверджує, що власний портbusсистеми живлення й вихід PDU — одне й те саме. Так частина виводить внутрішній порт на свою межу: навантаження з’єднуються з СЕЖ, а не з її нутрощами.interface payloadPower : BusLink connect … to …з’єднує два порти через типізований інтерфейс, тож з’єднання несе значенняBusLink. Два інтерфейси шини — це Payload Power Line (IF-01) і Radio Power Line (IF-04) EO-1.
Подання взаємозв’язків малює систему живлення з цього тексту: кожну частину з портами на краю, спряжені порти, позначені ~, і прив’язаний порт bus на рамці.
epsConnections з кроку 9: частини СЕЖ, їхні порти й з’єднання, намальовані з тексту.Інженерний наслідок: перелік інтерфейсів підсистеми тепер є запитом, а не окремою таблицею. Кожне з’єднання називає обидва кінці і, якщо воно типізоване, те, що через нього проходить. Це вихідний матеріал для документа контролю інтерфейсів, і він змінюється, коли змінюється модель.
Поширена помилка — дати обом кінцям однаковий неспряжений порт. Тоді обидва кінці надсилають, і жоден не отримує:
package PortCheck {
private import ISQ::*;
port def BusPowerPort {
out attribute voltage : ElectricPotentialValue;
}
part def PowerDistributionUnit { port busOut : BusPowerPort; }
part def PayloadCamera { port powerIn : BusPowerPort; }
part def Spacecraft {
part pdu : PowerDistributionUnit;
part camera : PayloadCamera;
connect pdu.busOut to camera.powerIn;
}
}
Текст розбирається, але засіб перевірки, що порівнює напрямки, попереджає, що обидва кінці з’єднання надсилають voltage. Спряження кінця, що отримує, port powerIn : ~BusPowerPort;, це виправляє.
Крок 5: поведінка з діями й потоками
Структура каже, чим є система; поведінка — що вона робить. Визначення дії описує поведінку з вхідними й вихідними параметрами. Визначення предметів описують те, що протікає, — тут сонячне світло й електроенергію в різних формах.
item def Sunlight;
item def ArrayPower;
item def ChargePower;
item def DischargePower;
item def BusPower;
action def ConvertSunlight {
in item sun : Sunlight;
out item power : ArrayPower;
}
action def ChargeBattery {
in item power : ArrayPower;
out item charge : ChargePower;
}
action def StoreEnergy {
in item charge : ChargePower;
out item discharge : DischargePower;
}
action def SupplyBus {
in item discharge : DischargePower;
out item bus : BusPower;
}
action def RunPowerCycle {
doc /* One orbit: about 59 minutes of sunlight, then a 36 minute eclipse. */
action collect : ConvertSunlight;
action charge : ChargeBattery;
action store : StoreEnergy;
action supply : SupplyBus;
flow collect.power to charge.power;
flow charge.charge to store.charge;
flow store.discharge to supply.discharge;
first start then collect;
first collect then charge;
first charge then store;
first store then supply;
first supply then done;
}
- Параметри
inіout— це входи й виходи дії. - Усередині
RunPowerCycleчотири використання дій є кроками одного витка: на сонці батареї збирають енергію, а PDU заряджає акумулятор; у тіні акумулятор віддає енергію, і PDU живить від нього шину. flow collect.power to charge.powerозначає, що вихід одного кроку є входом наступного.first collect then charge— це послідовність: один крок завершується до початку наступного. Потоки кажуть, що рухається; послідовності — у якому порядку.startіdone— початок і кінець охопної дії.
Кроки відповідають енергетичним функціям EO-1: F3.1 Convert Sunlight to Power, F3.2 Store Battery Energy і F3.3 Regulate Bus Power. Виведення таких функцій з вимог і їх упорядкування — предмет функціонального аналізу; визначення дій — це місце, куди ця робота потрапляє в SysML v2.
Наведене нижче Подання Action Flow намальовано з цього тексту разом із розподілом із кроку 6, який дає кожному кроку доріжку.
powerCycleFlow: кроки на сонці, потім кроки в тіні, з енергією, що протікає між ними.Інженерний наслідок: акумулятор стоїть на шляху кожного вата, який шина споживає в тіні. Те, що акумулятор запасає на сонці, має покрити навантаження в тіні, — саме це й обмежують вимоги 3.2 і 3.3 на кроці 7.
Крок 6: розподіл поведінки на структуру
Досі поведінка не належить жодному компоненту. Оператор perform вказує, яка частина виконує який крок:
part eo1 : Spacecraft {
part redefines eps {
perform action powerCycle : RunPowerCycle;
part redefines solarArrays { perform powerCycle.collect; }
part redefines battery { perform powerCycle.store; }
part redefines pdu {
perform powerCycle.charge;
perform powerCycle.supply;
}
}
}
eo1 — це використання Spacecraft на верхньому рівні пакета: космічний апарат цієї конструкції. Його система живлення виконує RunPowerCycle, а кожна частина СЕЖ виконує свої кроки. part redefines eps уточнює систему живлення, успадковану від Spacecraft, замість додавання другої. PDU виконує два кроки — заряджання на сонці й живлення шини в тіні, — бо один блок виконує обидві роботи.
Це текстова форма функціонального розподілу. З неї інструмент може перелічити функції, які виконує кожен компонент, або намалювати потік дій з однією доріжкою на частину, як у поданні вище.
Крок 7: вимоги з обмеженнями
Вимоги розміщуються в окремому пакеті, який імпортує проєкт. У SysML v2 вимога є обмеженням на суб’єкт: текст doc словами каже, що потрібно, а require constraint каже те саме у формі, яку може обчислити інструмент. Три вимоги — це вимоги EO-1 3.1, 3.2 і 3.3 з їхніми власними ідентифікаторами й формулюваннями.
package CubeSatEPSRequirements {
doc /* Electrical power requirements of EO-1 (section 3) and how one of them is verified. */
private import CubeSatEPS::*;
private import ScalarValues::*;
private import ISQ::*;
private import SI::*;
requirement def <'3.1'> OrbitAveragePower {
doc /* The solar arrays shall generate at least 28 W orbit-average power at end of life. */
subject eps : ElectricalPowerSystem;
attribute required : PowerValue;
require constraint { eps.orbitAveragePower >= required }
}
requirement def <'3.2'> BatteryCapacity {
doc /* The battery shall store at least 77 Wh at beginning of life. */
subject eps : ElectricalPowerSystem;
attribute minimum : EnergyValue;
require constraint { eps.battery.capacity >= minimum }
}
requirement def <'3.3'> DepthOfDischarge {
doc /* The EPS shall limit battery depth of discharge to 30% per orbit. */
subject eps : ElectricalPowerSystem;
attribute limit : Real;
require constraint { eps.depthOfDischarge <= limit }
}
requirement powerSpec {
doc /* The electrical power requirements EO-1 is built to. */
subject eps : ElectricalPowerSystem;
requirement orbitAveragePower : OrbitAveragePower {
attribute redefines required = 28 [W];
}
requirement batteryCapacity : BatteryCapacity {
attribute redefines minimum = 77 [W*h];
}
requirement depthOfDischarge : DepthOfDischarge {
attribute redefines limit = 0.3;
}
}
satisfy powerSpec by eo1.eps;
}
<'3.1'>— це коротке ім’я: ідентифікатор, який інженери згадують на рецензуваннях. Інші елементи моделі посилаються на повне ім’я,OrbitAveragePower.subject eps : ElectricalPowerSystemназиває, чого стосується вимога.require constraint { eps.orbitAveragePower >= required }— умова, яка має виконуватися. Межа є параметром, тож те саме визначення придатне для космічного апарата з іншою потребою в енергії.powerSpecзбирає вимоги до EO-1 і задає межі: 28 W, 77 Wh і 0.3.satisfy powerSpec by eo1.epsстверджує, що система живлення EO-1 відповідає специфікації.
Стежте, щоб текст doc і обмеження казали одне й те саме. Рецензенти читають текст; інструменти обчислюють обмеження. Зв’язки від вимоги до проєкту й тесту — це основа простежуваності вимог.
Подання вимог показує специфікацію як дерево разом із частиною, що її задовольняє, і випадком верифікації з кроку 8:
requirementTree: вимоги 3.1–3.3, те, що їх задовольняє, і те, що їх верифікує.Оскільки обмеження можна обчислити, засіб перевірки робить більше, ніж малює лінію satisfy: він перевіряє твердження за значеннями з кроку 3. З моделлю в нинішньому вигляді виконуються всі три: 28.05 W проти 28 W, 77 Wh проти 77 Wh і глибина розряду 0.24 проти 0.3.
Перший із цих запасів невеликий. Знизьте ККД тракту живлення з 0.6 до 0.59, тобто менш ніж на два відсотки, і середньовиткова потужність падає до 27.58 W. Тоді засіб перевірки повідомляє, що вимога 3.1 більше не виконується, і наводить значення, які її порушили:
Інженерний наслідок: вимога 3.1 уже містить системний запас (її обґрунтування в EO-1 — навантаження 24 W у режимі зйомки плюс 15%), але самі батареї виконують 3.1 із запасом лише 0.05 W. Будь-яка втрата, якої не було в оцінці, як-от швидша деградація елементів, потребує або більшої площі батарей, або меншого навантаження. Модель, що перевіряє вимогу за кожної зміни, показує це, щойно число зсувається, а не на наступному рецензуванні. Щоб побачити, наскільки ймовірно, що запас утримається, коли вхідні дані невизначені, а не фіксовані, див. аналіз Монте-Карло в системній інженерії.
Крок 8: випадок верифікації
Зв’язок satisfy — це твердження, і перевірка на кроці 7 перевіряє його лише за власними числами моделі. Випадок верифікації вказує, як твердження перевіряють на реальному обладнанні: випробуванням, оглядом, аналізом або демонстрацією. EO-1 верифікує ємність акумулятора тестовим випадком TC-07.
verification def <'TC-07'> BatteryCapacityTest {
doc /* Discharge the pack at C/2 from full charge in a thermal chamber at 20 degrees C and measure the energy delivered. */
subject eps : ElectricalPowerSystem;
objective {
verify powerSpec.batteryCapacity;
}
return verdict : Boolean = eps.battery.capacity >= powerSpec.batteryCapacity.minimum;
}
verification batteryTest : BatteryCapacityTest {
subject eps = eo1.eps;
}
objective { verify powerSpec.batteryCapacity; }називає вимогу, яку верифікує цей випадок. Із таких зв’язків будується матриця верифікації: кожна вимога проти випадків, що її верифікують.return verdict— це результат: тут — чи досягає виміряна ємність 77 Wh із вимоги 3.2.batteryTest— використання цього випадку для системи живлення EO-1: заплановане випробування, суб’єкт якого прив’язано доeo1.eps.
Задоволення й верифікацію розділено навмисно. Задоволення вказує, який елемент проєкту відповідає на вимогу; верифікація — як ви знаєте, що він це робить. У проєкті EO-1 TC-07 пройдено з виміряними 78.3 Wh. Вимоги 3.1 і 3.3 ще потребують власних випадків, і саме в матриці верифікації вимог ця прогалина стає видно.
Крок 9: подання й діаграми
У SysML v2 діаграма — не окреме креслення. Подання — це елемент моделі, що вказує, що показати (expose) і які види елементів включити (filter). Інструмент відображає подання й зберігає його компонування; вміст завжди береться з моделі. Три знімки екрана вище — це ці три подання.
package CubeSatEPSViews {
doc /* Views of the EO-1 power system. Each view selects part of the model; the layout belongs to the tool. */
private import CubeSatEPS::*;
private import CubeSatEPSRequirements::*;
private import StandardViewDefinitions::*;
// The EPS parts, their ports and connections.
view epsConnections : InterconnectionView {
expose CubeSatEPS::ElectricalPowerSystem;
}
// One orbit: the sunlit steps, the eclipse steps and the power that flows between them.
view powerCycleFlow : ActionFlowView {
expose CubeSatEPS::RunPowerCycle;
}
// The requirements with what satisfies and verifies them.
view requirementTree : GeneralView {
filter @SysML::RequirementDefinition or @SysML::RequirementUsage or @SysML::SatisfyRequirementUsage;
expose CubeSatEPSRequirements::**;
}
}
Стандартна бібліотека визначає поширені види подань:
| Подання | Показує | У цій моделі |
|---|---|---|
| Загальне подання | Будь-які елементи та їхні зв’язки у вигляді прямокутників і ліній | requirementTree |
| Подання взаємозв’язків | Частини однієї збірки з їхніми портами й з’єднаннями | epsConnections |
| Подання Action Flow | Кроки поведінки, їхній порядок і те, що протікає між ними | powerCycleFlow |
| Подання переходів станів | Стани й переходи між ними | Немає |
| Подання послідовності | Повідомлення між частинами в часі | Немає |
| Табличне подання (Grid View) | Елементи або зв’язки у вигляді таблиці чи матриці | Немає |
requirementTree — це Загальне подання, фільтр якого залишає лише вимоги й зв’язки satisfy; інструменти, що знають види діаграм SysML v1, серед них Holarch, показують таке подання як діаграму вимог. Оскільки подання є частиною моделі, перейменування акумулятора змінює кожну діаграму, що його показує, а рецензент може точно прочитати в тексті, що включає діаграма.
Повна модель
Три пакети разом. Завантажити модель системи живлення EO-1 (cubesat-eps.sysml) або скопіюйте текст нижче; вони однакові.
package CubeSatEPS {
doc /* The electrical power system (EPS) of the EO-1 CubeSat: solar arrays, a battery pack and a power distribution unit that feed the payload camera and the S-band transmitter. */
private import ScalarValues::*;
private import ISQ::*;
private import SI::*;
// ---- Ports and interfaces ----
port def DCPowerPort {
out attribute voltage : ElectricPotentialValue;
out attribute current : ElectricCurrentValue;
}
port def BusPowerPort {
out attribute voltage : ElectricPotentialValue;
out attribute powerLimit : PowerValue;
}
interface def BusLink {
end source : BusPowerPort;
end load : ~BusPowerPort;
}
// ---- Components ----
part def SolarArray {
attribute mass : MassValue;
attribute cellArea : AreaValue;
attribute cellEfficiency : Real;
attribute peakPower : PowerValue;
attribute pathEfficiency : Real;
port arrayOut : DCPowerPort;
}
part def BatteryPack {
attribute mass : MassValue;
attribute capacity : EnergyValue;
port cellsOut : DCPowerPort;
}
part def PowerDistributionUnit {
attribute mass : MassValue;
attribute busVoltage : ElectricPotentialValue;
port arrayIn : ~DCPowerPort;
port batteryIn : ~DCPowerPort;
port busOut : BusPowerPort;
}
part def PayloadCamera {
attribute powerDraw : PowerValue;
port powerIn : ~BusPowerPort;
}
part def SBandTransmitter {
attribute powerDraw : PowerValue;
port powerIn : ~BusPowerPort;
}
// ---- Calculations ----
calc def OrbitAverage {
doc /* Orbit-average array output (EQ-1.3): peak power times the sunlit fraction times the power path efficiency. */
in peakPower : PowerValue;
in sunlitFraction : Real;
in pathEfficiency : Real;
return : PowerValue = peakPower * sunlitFraction * pathEfficiency;
}
// ---- The assembly ----
part def ElectricalPowerSystem {
part solarArrays : SolarArray {
attribute redefines mass = 0.45 [kg];
attribute redefines cellArea = 0.2 [m^2];
attribute redefines cellEfficiency = 0.295;
attribute redefines peakPower = 75.4 [W];
attribute redefines pathEfficiency = 0.6;
}
part battery : BatteryPack {
attribute redefines mass = 0.62 [kg];
attribute redefines capacity = 77 [W*h];
}
part pdu : PowerDistributionUnit {
attribute redefines mass = 0.28 [kg];
attribute redefines busVoltage = 12 [V];
}
port bus : BusPowerPort;
connect solarArrays.arrayOut to pdu.arrayIn;
connect battery.cellsOut to pdu.batteryIn;
bind bus = pdu.busOut;
attribute sunlitFraction : Real = 0.62;
attribute eclipseEnergy : EnergyValue = 18.5 [W*h];
attribute orbitAveragePower : PowerValue = OrbitAverage(solarArrays.peakPower, sunlitFraction, solarArrays.pathEfficiency);
attribute depthOfDischarge : Real = eclipseEnergy / battery.capacity;
attribute totalMass : MassValue = solarArrays.mass + battery.mass + pdu.mass;
}
part def Spacecraft {
part eps : ElectricalPowerSystem;
part camera : PayloadCamera {
attribute redefines powerDraw = 6.2 [W];
}
part transmitter : SBandTransmitter {
attribute redefines powerDraw = 3.4 [W];
}
interface payloadPower : BusLink connect eps.bus to camera.powerIn;
interface radioPower : BusLink connect eps.bus to transmitter.powerIn;
}
// ---- Behavior ----
item def Sunlight;
item def ArrayPower;
item def ChargePower;
item def DischargePower;
item def BusPower;
action def ConvertSunlight {
in item sun : Sunlight;
out item power : ArrayPower;
}
action def ChargeBattery {
in item power : ArrayPower;
out item charge : ChargePower;
}
action def StoreEnergy {
in item charge : ChargePower;
out item discharge : DischargePower;
}
action def SupplyBus {
in item discharge : DischargePower;
out item bus : BusPower;
}
action def RunPowerCycle {
doc /* One orbit: about 59 minutes of sunlight, then a 36 minute eclipse. */
action collect : ConvertSunlight;
action charge : ChargeBattery;
action store : StoreEnergy;
action supply : SupplyBus;
flow collect.power to charge.power;
flow charge.charge to store.charge;
flow store.discharge to supply.discharge;
first start then collect;
first collect then charge;
first charge then store;
first store then supply;
first supply then done;
}
part eo1 : Spacecraft {
part redefines eps {
perform action powerCycle : RunPowerCycle;
part redefines solarArrays { perform powerCycle.collect; }
part redefines battery { perform powerCycle.store; }
part redefines pdu {
perform powerCycle.charge;
perform powerCycle.supply;
}
}
}
}
package CubeSatEPSRequirements {
doc /* Electrical power requirements of EO-1 (section 3) and how one of them is verified. */
private import CubeSatEPS::*;
private import ScalarValues::*;
private import ISQ::*;
private import SI::*;
requirement def <'3.1'> OrbitAveragePower {
doc /* The solar arrays shall generate at least 28 W orbit-average power at end of life. */
subject eps : ElectricalPowerSystem;
attribute required : PowerValue;
require constraint { eps.orbitAveragePower >= required }
}
requirement def <'3.2'> BatteryCapacity {
doc /* The battery shall store at least 77 Wh at beginning of life. */
subject eps : ElectricalPowerSystem;
attribute minimum : EnergyValue;
require constraint { eps.battery.capacity >= minimum }
}
requirement def <'3.3'> DepthOfDischarge {
doc /* The EPS shall limit battery depth of discharge to 30% per orbit. */
subject eps : ElectricalPowerSystem;
attribute limit : Real;
require constraint { eps.depthOfDischarge <= limit }
}
requirement powerSpec {
doc /* The electrical power requirements EO-1 is built to. */
subject eps : ElectricalPowerSystem;
requirement orbitAveragePower : OrbitAveragePower {
attribute redefines required = 28 [W];
}
requirement batteryCapacity : BatteryCapacity {
attribute redefines minimum = 77 [W*h];
}
requirement depthOfDischarge : DepthOfDischarge {
attribute redefines limit = 0.3;
}
}
satisfy powerSpec by eo1.eps;
verification def <'TC-07'> BatteryCapacityTest {
doc /* Discharge the pack at C/2 from full charge in a thermal chamber at 20 degrees C and measure the energy delivered. */
subject eps : ElectricalPowerSystem;
objective {
verify powerSpec.batteryCapacity;
}
return verdict : Boolean = eps.battery.capacity >= powerSpec.batteryCapacity.minimum;
}
verification batteryTest : BatteryCapacityTest {
subject eps = eo1.eps;
}
}
package CubeSatEPSViews {
doc /* Views of the EO-1 power system. Each view selects part of the model; the layout belongs to the tool. */
private import CubeSatEPS::*;
private import CubeSatEPSRequirements::*;
private import StandardViewDefinitions::*;
// The EPS parts, their ports and connections.
view epsConnections : InterconnectionView {
expose CubeSatEPS::ElectricalPowerSystem;
}
// One orbit: the sunlit steps, the eclipse steps and the power that flows between them.
view powerCycleFlow : ActionFlowView {
expose CubeSatEPS::RunPowerCycle;
}
// The requirements with what satisfies and verifies them.
view requirementTree : GeneralView {
filter @SysML::RequirementDefinition or @SysML::RequirementUsage or @SysML::SatisfyRequirementUsage;
expose CubeSatEPSRequirements::**;
}
}
Як перевіряли лістинги
Кожен лістинг на цій сторінці розібрано й перевірено за допомогою Holarch Language Engine — рушія Редактора SysML v2 у Holarch — із завантаженою стандартною бібліотекою SysML v2. Перевірки розпізнають кожне ім’я, порівнюють одиниці й розмірності, зіставляють напрямки портів у з’єднаннях і обчислюють обмеження вимог за значеннями, що їх задовольняють.
- Повна модель і окремий лістинг не дають ні помилок, ні попереджень.
- Кожен фрагмент з’являється в повній моделі рядок у рядок і в тому самому порядку.
- Два лістинги з помилками дають саме ту помилку й те попередження, які описано поруч із ними.
- Повна модель із ККД тракту живлення 0.59 дає рівно одне попередження: вимогу 3.1 не виконано.
Які конструкції SysML v2 підтримує рушій і які в нього відомі прогалини, див. у покритті мови SysML v2. Щоб порівняти інструменти за тими самими пунктами, див. що перевірити в інструменті SysML v2; ця модель досить мала, щоб слугувати тестовим файлом.
Спробуйте в Holarch
- Завантажте
cubesat-eps.sysmlабо збережіть повну модель під цією назвою. - Відкрийте Модель → Імпорт і експорт, виберіть У новий проєкт SysML v2 і перетягніть файл. Див. імпорт файлів у новий проєкт.
- Відкрийте Модель → Редактор, щоб читати й змінювати текст. Кожен пакет є документом. Див. Редактор.
- Відкрийте список Діаграми й натисніть
epsConnections,powerCycleFlowабоrequirementTree. Див. відкриття подання. - У CubeSatEPS змініть
pathEfficiency = 0.6на0.59і зачекайте. Редактор показує попередження в рядкуsatisfyу CubeSatEPSRequirements. Відмінити — ⌘Z / Ctrl+Z.
Щоб натомість набрати модель самостійно, створіть проєкт SysML v2, натисніть + Новий пакет у Редакторі й запишіть кроки по черзі; текст, що розбирається без помилок, застосовується після короткої паузи. Див. початок роботи з проєктами SysML v2. Увесь космічний апарат EO-1 з його документами, тестами й бюджетами — це демо CubeSat: Файли проєкту ▾ → Новий демопроєкт.
Куди далі
- Проєкти SysML v2 у Holarch: текст, подання й інженерні сторінки на одній моделі.
- Довідник із текстової нотації: що підтримує Holarch, перевірки й стандартна бібліотека.
- Довідник із подань: кожен вид подання і як редагувати в ньому модель.
- Вимоги й верифікація в проєктах SysML v2: сторінки вимог, Центр тестування і RVTM.
- Аналіз у проєктах SysML v2: параметрика, бюджети й аналіз компромісів.
- Що таке MBSE?: чому інженери зберігають систему в моделі.