Руководство · 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 — CubeSat формата 6U для наблюдения Земли на солнечно-синхронной орбите высотой 500 км. Это общий пример этих руководств; пример проекта MBSE проводит весь аппарат от потребностей до верификации. В этом учебнике берётся одна подсистема — система электропитания (EPS) — и записывается в тексте SysML v2.
У EPS три части. Две раскрываемые солнечные панели преобразуют солнечный свет в энергию. Литий-ионный батарейный блок запасает энергию на время тени. Блок распределения питания (PDU) отслеживает точку максимальной мощности панелей, заряжает батарею и стабилизирует шину 12 V. В модели есть и две нагрузки на этой шине: камера полезной нагрузки и передатчик S-диапазона.
Числа взяты из модели EO-1:
| Предмет | Значение | Где используется |
|---|---|---|
| Солнечные панели: площадь элементов, КПД элементов, пиковая мощность | 0,2 м², 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 внутри системы электропитания — это единственная батарея EPS аппарата 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 м² элементов с КПД 0,295 при солнечном излучении 1361 W/m² и угле падения 0,35 рад (cos 0,35 = 0,939) дают 75,4 W. Освещённая доля следует из орбиты: виток на высоте 500 км длится около 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 Power Interface (IFB-1) аппарата EO-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— простое соединение: жгут панелей (интерфейс IF-20 аппарата EO-1).battery.cellsOutкpdu.batteryIn— жгут батареи (IF-21).bind bus = pdu.busOutутверждает, что собственный портbusсистемы электропитания и выход PDU — одно и то же. Так часть выводит внутренний порт на свою границу: нагрузки подключаются к EPS, а не к её внутренностям.interface payloadPower : BusLink connect … to …соединяет два порта через типизированный интерфейс, поэтому соединение несёт смыслBusLink. Два интерфейса шины — это Payload Power Line (IF-01) и Radio Power Line (IF-04) аппарата EO-1.
Interconnection View рисует систему электропитания по этому тексту: каждая часть с портами на краю, сопряжённые порты помечены ~, а связанный порт bus находится на рамке.
epsConnections из шага 9: части EPS, их порты и соединения, нарисованные по тексту.Инженерное следствие: перечень интерфейсов подсистемы теперь — запрос, а не отдельная таблица. Каждое соединение называет оба конца и, если оно типизировано, то, что через него проходит. Это исходный материал для документа управления интерфейсами, и он меняется, когда меняется модель.
Типичная ошибка — дать обоим концам одинаковый, несопряжённый порт. Тогда оба конца отправляют, и ни один не получает:
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, а каждая часть EPS — свои шаги. part redefines eps уточняет систему электропитания, унаследованную от Spacecraft, вместо добавления второй. PDU выполняет два шага — заряд на солнце и питание шины в тени, — потому что один блок делает обе работы.
Это текстовая форма функционального распределения. По ней инструмент может перечислить функции, которые выполняет каждый компонент, или нарисовать поток действий с одной дорожкой на часть, как в представлении выше.
Шаг 7: требования с ограничениями
Требования помещаются в собственный пакет, который импортирует проект. В SysML v2 требование — это ограничение на субъект: текст doc говорит словами, что нужно, а require constraint говорит то же в форме, которую может вычислить инструмент. Три требования — это требования 3.1, 3.2 и 3.3 аппарата EO-1 с собственными идентификаторами и формулировками.
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::**;
}
}
Стандартная библиотека определяет распространённые виды представлений:
| Представление | Показывает | В этой модели |
|---|---|---|
| General View | Любые элементы и их отношения в виде прямоугольников и линий | requirementTree |
| Interconnection View | Части одной сборки с их портами и соединениями | epsConnections |
| Представление Action Flow | Шаги поведения, их порядок и то, что течёт между ними | powerCycleFlow |
| Представление переходов состояний | Состояния и переходы между ними | Нет |
| Представление последовательности | Сообщения между частями во времени | Нет |
| Grid View | Элементы или отношения в виде таблицы или матрицы | Нет |
requirementTree — это General View, фильтр которого оставляет только требования и отношения 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?: зачем инженеры хранят систему в модели.