Holarch

Посібник · SysML v2

Посібник із SysML v2: модель системи живлення CubeSat у текстовій нотації

Слухати цей посібник 24 хв

Цей підручник із SysML v2 крок за кроком будує невелику завершену модель: систему електроживлення CubeSat EO-1 з її частинами, величинами й одиницями, портами й з’єднаннями, циклом освітлення й тіні, вимогами, які може перевірити інструмент, випадком верифікації та поданнями. Кожен лістинг на цій сторінці — це текст SysML v2, перевірений мовним рушієм, а кожен ключовий крок показує діаграму, яку створює текст.

На цій сторінці
  1. Що ви побудуєте
  2. Перша ідея: визначення й використання
  3. Крок 1: пакет та його імпорти
  4. Крок 2: визначення частин і атрибути з одиницями
  5. Крок 3: збірка зі значеннями
  6. Крок 4: порти, інтерфейси й з’єднання
  7. Крок 5: поведінка з діями й потоками
  8. Крок 6: розподіл поведінки на структуру
  9. Крок 7: вимоги з обмеженнями
  10. Крок 8: випадок верифікації
  11. Крок 9: подання й діаграми
  12. Повна модель
  13. Як перевіряли лістинги
  14. Спробуйте в Holarch
  15. Куди далі

Що ви побудуєте

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
Маса: батареї, акумулятор, PDU0.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-077 і 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 (систему орієнтації, бортовий комп’ютер, конструкцію) пропущено, щоб модель залишалася короткою.

Значення не просто зберігаються; інструмент їх обчислює. З наведеними вище числами:

АтрибутВиразРезультат
orbitAveragePower75.4 W × 0.62 × 0.628.05 W
depthOfDischarge18.5 Wh ÷ 77 Wh0.24
totalMass0.45 kg + 0.62 kg + 0.28 kg1.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

  1. Завантажте cubesat-eps.sysml або збережіть повну модель під цією назвою.
  2. Відкрийте Модель → Імпорт і експорт, виберіть У новий проєкт SysML v2 і перетягніть файл. Див. імпорт файлів у новий проєкт.
  3. Відкрийте Модель → Редактор, щоб читати й змінювати текст. Кожен пакет є документом. Див. Редактор.
  4. Відкрийте список Діаграми й натисніть epsConnections, powerCycleFlow або requirementTree. Див. відкриття подання.
  5. У CubeSatEPS змініть pathEfficiency = 0.6 на 0.59 і зачекайте. Редактор показує попередження в рядку satisfy у CubeSatEPSRequirements. Відмінити — ⌘Z / Ctrl+Z.

Щоб натомість набрати модель самостійно, створіть проєкт SysML v2, натисніть + Новий пакет у Редакторі й запишіть кроки по черзі; текст, що розбирається без помилок, застосовується після короткої паузи. Див. початок роботи з проєктами SysML v2. Увесь космічний апарат EO-1 з його документами, тестами й бюджетами — це демо CubeSat: Файли проєкту ▾ → Новий демопроєкт.

Куди далі