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 — 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
Масса: панели, батарея, 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 внутри системы электропитания — это единственная батарея 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 (система ориентации, бортовой компьютер, конструкция) опущена, чтобы модель оставалась короткой.

Значения не просто хранятся; инструмент их вычисляет. С приведёнными выше числами:

АтрибутВыражениеРезультат
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 м² элементов с КПД 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

  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: Файлы проектов ▾ → Новый демо-проект.

Что дальше