Holarch

Пакет преподавателя · v1.0

Преподавание с Holarch: пакет преподавателя

Результаты обучения и шесть заданий с критериями оценивания для семестрового курса системной инженерии или MBSE, построенные на открытой эталонной MBSE-модели EO-1 v1.1 — вымышленном 6U CubeSat для наблюдения Земли. Бесплатно по лицензии CC BY 4.0.

Скачать пакет преподавателя v1.0

Все файлы (.zip, 17 КБ)

Файлы Markdown, которые открываются в любом редакторе. Используют эталонную модель EO-1 v1.1. Лицензия: CC BY 4.0, указание авторства «Holarch».

На этой странице
  1. Содержимое
  2. Как использовать
  3. Методические указания с решениями
  4. Результаты обучения
    1. Соответствие заданиям
  5. A1 · Проследить потребность
  6. A2 · Доработка и рецензирование требований
  7. A3 · Найти пробелы в покрытии
  8. A4 · Расширить архитектуру
  9. A5 · Провести изменение
  10. A6 · План валидации
  11. Преподавание SysML v2 с Holarch: что он проверяет, а что только хранит
  12. Загрузки
  13. Версии
  14. Как цитировать
  15. Лицензия

Содержимое

ФайлДля когоСодержимое
learning-outcomes.mdПреподаватели, документы аккредитацииРезультаты обучения курса, задания, которые оценивают каждый из них, и используемые возможности Holarch.
assignments/A1-trace-a-need.md – A6-validation-plan.mdСтуденты (раздаточный материал)Шесть заданий на EO-1, в каждом — предыстория, задача, что сдать и критерии оценивания.
sysml-v2-teaching-boundaries.mdПреподавателиЧто проверяют проекты SysML v2 в Holarch, что они хранят без интерпретации и что пока недоступно.

Как использовать

  1. Дайте каждой группе собственную копию EO-1 v1.1. В Holarch: Manage Projects → Project Files ▾ → New Demo Project → CubeSat EO-1 или скачайте eo-1-v1.1.holarch.json с holarch.app/reference-models/eo-1/ и импортируйте через Manage Projects → Project Files ▾ → Import Project…. Каждое задание начинается с модели в исходном виде.
  2. Проводите курс в учебной организации. Добавьте каждое задание со сроком через Organization Settings → Class Review → + New Assignment. Class Review сохраняет версию каждого группового проекта на каждую дату сдачи и показывает работу каждого студента.
  3. Для A2 присоединитесь к каждому групповому проекту как Рецензент: вы можете комментировать, утверждать, отклонять и повторно открывать требования, и ничего больше.
  4. Для A6 студенты начинают со встроенного шаблона Verification and Validation Plan. Чтобы дать им сокращённую версию со своими указаниями, сохраните её как шаблон организации (Write ▾ → Templates ▸ Save as Template…, Save to: Organization) и сделайте шаблоном по умолчанию для Test Plan Document.
  5. Задайте веса, размеры групп и сроки для своего курса. Указанные веса — рекомендации.

В заданиях названы страницы Holarch, но на каждый вопрос можно ответить и по CSV-файлам EO-1, поэтому могут участвовать студенты, работающие в другом инструменте.

Методические указания с решениями

Методические указания с ожидаемыми выводами, образцами ответов и типичными ошибками для A1–A6 не публикуются, чтобы студенты не могли скачать ответы. Преподаватели скачивают их в Holarch: Organization Settings → Class Review → Download Solution Notes. Кнопка видна администраторам (преподавателям и ассистентам) организации со статусом учебного курса.

Результаты обучения

Курс: Model-Based Systems Engineering, один семестр, старшие курсы бакалавриата или первый год магистратуры.

К концу курса студенты умеют:

#РезультатЧем оцениваетсяИспользуемые возможности Holarch
LO1Различать потребности заинтересованных сторон и системные требования и прослеживать каждую потребность до формализующих её требований.A1, промежуточный экзаменStatement, связи traced to, раздел Trace в Item View, матрица прослеживаемости
LO2Писать необходимые, единичные, однозначные и верифицируемые требования с методом верификации и критериями успеха.A2, промежуточный экзаменАтрибуты требований, Quality, TBD/TBR
LO3Проводить цикл рецензирования и утверждения требований и отвечать на замечания рецензентов изменениями в модели.A2, участие в рецензированииРоль Reviewer, Approvals (Approve, Reject…, Reopen), комментарии с упоминаниями
LO4Анализировать прослеживаемость и покрытие верификацией и решать для каждого пробела, что неверно — модель или требование.A3Матрица прослеживаемости, RVTM, проверки модели
LO5Декомпозировать функции, определять логическую архитектуру, распределять функции по логическим и физическим элементам и выводить вытекающие из этого интерфейсы.A4, итоговый экзаменДиаграммы Action и FFBD, Asset, распределение, реестр интерфейсов
LO6Оценивать влияние изменения требования по модели и фиксировать решение для каждого затронутого элемента.A5, итоговый экзаменLinks to Review, анализ влияния, Change Requests, Baselines & Versions
LO7Планировать верификацию и валидацию: различать их, выбирать методы, писать методики испытаний и валидации в нужных терминах и читать RVTM.A6, итоговый экзаменТестовые случаи и наборы, Test Center, RVTM и VCRM, шаблоны документов
LO8Получать инженерные результаты из модели и поддерживать их согласованность с ней: документы с базовыми линиями и матрицы, экспортированные для рецензирования.A2, A6, итоговый экзаменДокументы, живые матрицы, базовые линии, экспорт в Word и Excel
LO9 (необязательно)Читать и писать текстовую нотацию SysML v2 для подсистемы и указывать, какие свойства инструмент проверил, а какие только сохранил.Необязательная часть A6Проект SysML v2, проверки редактора, памятка по преподаванию SysML v2

Соответствие заданиям

РезультатA1 Проследить потребностьA2 Доработка требованийA3 Пробелы в покрытииA4 АрхитектураA5 Влияние измененияA6 План валидации
LO1●○○
LO2●○
LO3●
LO4○●○
LO5●
LO6●
LO7○○○●
LO8○●

● основной оцениваемый результат, ○ также вносит вклад.

Примечания для преподавателя

  • Результаты описывают умения в системной инженерии, а не владение инструментом. Holarch — место для практики; CSV-файлы EO-1 позволяют студенту продемонстрировать любой результат и без него.
  • Результаты следуют общепринятой практике системной инженерии, например техническим процессам ISO/IEC/IEEE 15288: определение потребностей и требований заинтересованных сторон, определение системных требований, определение архитектуры, верификация и валидация. Сопоставьте их с критериями аккредитации вашей программы, как требует ваш вуз.

A1 · Проследить потребность

Результаты: LO1 (основной), LO4, LO7 · Размер группы: индивидуально · Рекомендуемый вес: 8 %

Предыстория

Заказчик EO-1, компания агроаналитики, сформулировал три потребности. N2 Twice-Weekly Revisit гласит: «Farm customers need fresh imagery of their fields at least twice a week in the growing season.» Потребность удовлетворена, только когда формализующие её требования выполнены проектом и верифицированы, а сама потребность валидирована с заказчиком.

Задача

  1. Проследите N2 по модели: требования, к которым она прослеживается, их дочерние требования, функции и компоненты, выполняющие каждое из них, и тестовые случаи, которые их верифицируют, со статусом каждого теста.
  2. Изобразите цепочку в виде таблицы или небольшой диаграммы: одна строка или блок на элемент, с его номером, названием, статусом и связью, которая его соединяет.
  3. Найдите действие валидации для N2 и его статус.
  4. Ответьте: каких свидетельств ещё не хватает, чтобы N2 считалась валидированной? Перечислите каждое недостающее звено, элемент, к которому оно относится, и что его закроет.
  5. Найдите требования, которые поддерживают N2, но не прослеживаются к ней. Назовите одного кандидата и приведите доводы за или против добавления трассы. Не добавляйте её в модель.

В Holarch: откройте N2 в Item View и прочитайте раздел Трассировка, затем используйте Verification → Traceability Matrix, Verification → RVTM и Verification → Test Center. Без Holarch: eo-1-v1.1-traceability.csv и eo-1-v1.1-rvtm.csv.

Что сдать

Записка на одну-две страницы (Word или PDF) с цепочкой, недостающими свидетельствами и ответом на шаг 5. В этом задании модель не изменяйте.

Критерии оценивания

Критерий4 Образцово3 Уверенно2 В развитии1 Начальный уровень
Цепочка полна и верна (40 %)Все элементы от N2 до тестов с правильными связями и статусами, включая оба дочерних требования и действие валидации.Один элемент или статус отсутствует или неверен.Цепочка обрывается на требованиях или пропускает дочернее требование.Элементы перечислены без связей.
Недостающие свидетельства (35 %)Названы все пробелы (непроведённые тесты, родительское требование без собственной верификации, ещё не утверждённые требования, непроведённая валидация, дочернее требование без функции) и что закрывает каждый.Большинство пробелов и что их закрывает.Пробелы перечислены без указания, что их закрывает.Сказано лишь «не хватает тестов».
Верификация и валидация (15 %)Последовательно различает их: верифицируются требования, валидируется потребность.Одна ошибка.Считает пройденный тест валидацией потребности.Различия нет.
Кандидат на трассу (10 %)Конкретное требование с обоснованным доводом в любую сторону.Кандидат со слабым доводом.Кандидат без довода.Отсутствует.

A2 · Доработка и рецензирование требований

Результаты: LO2 (основной), LO3, LO8 · Размер группы: группа · Рекомендуемый вес: 10 %

Предыстория

Три требования EO-1 всё ещё черновики и получают 44 % в проверке качества Holarch:

  • 2.5 Safe Mode Recovery: «The spacecraft should recover from safe mode quickly and resume imaging as appropriate»
  • 3.5 Battery Thermal Control: «The thermal design shall keep the battery warm enough (TBD).»
  • 6.4 Operator Interface: «The operator interface shall be user friendly and/or easy to use.»

У 3.5 также есть открытая проблема ISS-3 Battery heater set point not chosen и замечание совета по проектному рецензированию RID-1 No cold-case analysis for the battery heater.

Задача

  1. Для каждого из трёх перечислите, что делает его слабым, — пословно там, где это важно.
  2. Перепишите каждое в групповом проекте: одно «shall», одно измеримое условие и указанная точка отсчёта или условие там, где речь о времени или диапазоне. Замените каждое TBD значением и запишите его обоснование либо оставьте TBR с ответственным и датой. Для 3.5 укажите, как ваша формулировка отвечает на ISS-3 и RID-1.
  3. Заполните для каждого Verification Method, Уровень верификации и Критерии успеха.
  4. Проследите каждое до его источника (потребности, родительского требования или первоисточника) и до выполняющей его функции. Если функции нет, назовите недостающую функцию.
  5. Переведите каждое в статус In Review. Преподаватель рецензирует их как Reviewer. Ответьте на каждый комментарий в модели (измените требование или ответьте с обоснованием), затем закройте комментарий.
  6. Сохраните базовую линию документа EO-1 System Requirements Specification (SRS-001) с именем «A2 handed in» и экспортируйте её в Word.

В Holarch: Needs & Requirements → Quality, инспектор требования, Needs & Requirements → Approvals, а в документе — Version ▾ → Save Baseline… и Deliver ▾ → Specification (Word).

Что сдать

Экспорт в Word и записка на полстраницы о слабых местах, найденных на шаге 1. Вместе с ним оценивается модель в состоянии на дату сдачи.

Критерии оценивания

Критерий4 Образцово3 Уверенно2 В развитии1 Начальный уровень
Переписанные требования (40 %)Все три единичны, измеримы и верифицируемы; условия и точки отсчёта указаны; значения обоснованы.В одном требовании остался расплывчатый термин или не указано условие.Значения добавлены, но нет условий или обоснования.Формулировка изменена, но требование по-прежнему не верифицируемо.
Атрибуты верификации (20 %)Метод, уровень и критерии успеха подходят каждому требованию и выполнимы в том виде, как написаны.Одно несоответствие, например Test там, где возможен только Analysis.Методы заданы, критерии успеха расплывчаты.Отсутствует.
Прослеживаемость (15 %)Каждое прослежено до источника и выполняющей функции, либо названа недостающая функция.Не хватает одной трассы.Только источники.Нет.
Цикл рецензирования (15 %)На каждый комментарий рецензента дан ответ в модели, и он закрыт; отклонённые требования доработаны и отправлены повторно.Один комментарий остался открытым.На комментарии даны ответы без изменений в модели.Комментарии проигнорированы.
Анализ слабых мест (10 %)Точный: назван каждый расплывчатый термин и почему его нельзя верифицировать.Общий, но верный.Повторяет оценку качества.Отсутствует.

A3 · Найти пробелы в покрытии

Результаты: LO4 (основной), LO1, LO2, LO7 · Размер группы: группа · Рекомендуемый вес: 10 %

Предыстория

EO-1 проходит защиту рабочего проекта (CDR). Модель намеренно несовершенна: у некоторых требований нет выполняющей функции, у некоторых нет теста, часть тестов не пройдена, а одно уравнение ни с чем не связано.

Задача

Работайте с моделью в исходном виде версии v1.1. Если групповой проект изменился, используйте свежую копию.

  1. Перечислите все требования, которые не выполняет ни одна функция.
  2. Перечислите все требования, которые не верифицирует ни один тестовый случай, и те, чьи тесты не пройдены, с открытой проблемой и отклонением, зарегистрированными по ним.
  3. Перечислите требования без выполняющего компонента. Решите, каким из них он нужен, а какие обоснованно выполняются на уровне миссии или сегмента.
  4. Найдите элементы модели, к которым ничто не прослеживается. Подсказка: посмотрите на уравнения энергобаланса.
  5. Для каждого пробела решите: в модели чего-то не хватает (функции, компонента, теста, связи) или требование не нужно либо сформулировано неверно? Дайте одно предложение обоснования на пробел.
  6. Закройте три пробела на свой выбор в групповом проекте, каждый — одним изменением, на которое можно указать в Control & Reviews → Activity.

В Holarch: Verification → Traceability Matrix, Verification → RVTM, Verification → Model Checks и Risks, Issues & Decisions → Issues & Actions. Без Holarch: eo-1-v1.1-traceability.csv (его столбец Покрытие), eo-1-v1.1-rvtm.csv, eo-1-v1.1-issues-actions.csv и eo-1-v1.1-deviations-waivers.csv.

Что сдать

Таблица пробелов (пробел, элемент, решение, обоснование, закрыт — да или нет) в Excel или Word и список трёх внесённых изменений.

Критерии оценивания

Критерий4 Образцово3 Уверенно2 В развитии1 Начальный уровень
Найденные пробелы (35 %)Все пробелы по функциям, тестам, компонентам и элементам-сиротам, включая непройденные тесты с их проблемами и отклонением.Пропущены один-два пробела.Найдены только очевидные черновики.Меньше половины.
Решения (35 %)По каждому пробелу принято обоснованное решение; отсутствие проектного решения отличено от ненужных или неверно ограниченных требований и от выполнения на уровне миссии.Большинство решений обоснованы.Каждый пробел решается как «добавить связь».Решений нет.
Внесённые изменения (20 %)Три изменения, действительно закрывающие пробелы, каждое — один чистый шаг в журнале.Два хороших изменения.Изменения, скрывающие пробел, например связь, добавленная без причины.Нет.
Оформление (10 %)Таблица полна и допускает сортировку.Небольшие упущения.Трудно разобраться.Отсутствует.

A4 · Расширить архитектуру

Результаты: LO5 (основной), LO4 · Размер группы: группа · Рекомендуемый вес: 12 %

Предыстория

Логическая архитектура EO-1 (L0) охватывает только срезы электропитания и обработки данных: от L1 Power Generation до L6 Fault Management. Каждый логический элемент объединяет функции (allocated to) и реализуется физической частью (related to); например, F3.1 Convert Sunlight to Power распределена на L1, а 1.3.1 Solar Arrays реализует L1. Для определения и управления ориентацией есть функции F4.1 Estimate Attitude, F4.2 Compute Control Torques, F4.3 Drive Reaction Wheels и F4.4 Unload Wheel Momentum и физические части под 1.2 ADCS, но нет логического уровня.

Задача

  1. Добавьте под L0 логические элементы для определения и управления ориентацией. Каждый элемент описывает своё назначение, не называя оборудования.
  2. Распределите на них F4.1–F4.4 и свяжите каждый логический элемент с физическими частями под 1.2 ADCS, которые его реализуют, по образцу L1–L6.
  3. Нарисуйте диаграмму Action для F4 с элементами, передаваемыми между её подфункциями, например оценкой ориентации и командами моментов, если в проекте группы её ещё нет.
  4. Выведите интерфейсы из потоков, пересекающих границы элементов. Сравните их с существующими интерфейсами IF-06, IF-16, IF-17 и IF-18: какие совпадают, каких не хватает и какие передают элементы, не используемые ни одной функцией?
  5. Убедитесь, что каждое из требований 2.1–2.4 выполняется функцией, которая делает эту работу, и укажите, какой логический элемент тогда отвечает за каждое требование.

В Holarch: Architecture → Assets, Behavior → Action Diagrams (F4), раздел Трассировка инспектора для распределения, Interfaces → Interface Register и предустановка Иерархия распределения диаграммы иерархии. Без Holarch: eo-1-v1.1-allocation-chain.csv и eo-1-v1.1-icd.csv.

Что сдать

Краткое описание архитектуры (две-три страницы, Word или PDF): логические элементы с их назначением, таблица распределения (функция → логический элемент → физическая часть), диаграмма Action для F4 и сравнение интерфейсов.

Критерии оценивания

Критерий4 Образцово3 Уверенно2 В развитии1 Начальный уровень
Логические элементы (25 %)Независимы от решения, целостны, у каждого ясное назначение; без названий оборудования.Один элемент называет оборудование или смешивает назначения.Элементы повторяют физические части.Отсутствуют или неясны.
Распределение (30 %)Каждая подфункция распределена один раз на правильный элемент; элементы реализованы частями; модель согласована.Одно распределение сомнительно.Распределение только на части, в обход логического уровня.Неполно.
Потоки и интерфейсы (30 %)Интерфейсы выведены из потоков, пересекающих границы; точное сравнение с IF-06, IF-16, IF-17 и IF-18, включая пробелы в обе стороны.Сравнение в основном верно.Интерфейсы перечислены, но не выведены.Отсутствует.
Ответственность за требования (15 %)Каждое из 2.1–2.4 прослежено через свою функцию до логического элемента, несоответствия названы.Одного не хватает.Перечислены без проверки.Отсутствует.

A5 · Провести изменение

Результаты: LO6 (основной), LO7 · Размер группы: группа · Рекомендуемый вес: 10 %

Предыстория

После проектного рецензирования требование 3.1 Orbit Average Power изменилось с 28 Вт на 30 Вт средневитковой мощности в конце срока службы. Тестовый случай TC-06 Solar Array Power Test был пройден по старому значению. Holarch пометил связи 3.1 для проверки.

Задача

  1. Перечислите все элементы, которых касается изменение: вперёд по связям от 3.1, назад к тому, из чего выведено 3.1, и элементы, упоминающие старое значение без связи с 3.1. Укажите, как вы нашли каждый.
  2. Для каждого элемента запишите вопрос, который поднимает изменение, ваш вывод (с числами, где они есть в модели) и решение: без изменений (отметить связь как проверенную с комментарием), обновить или передать на совет по изменениям.
  3. Решите, что делать с TC-06: доказывает ли тест, пройденный при 28 Вт, выполнение 30 Вт? Покажите расчёт по уравнениям модели.
  4. Найдите один элемент, который пропускает анализ по связям, и объясните, почему он важен.
  5. Зафиксируйте решения в групповом проекте: комментарий к каждой связи, отмеченной как проверенная, запрос на изменение для того, что должен решить совет, и базовая линия до и после.

В Holarch: Needs & Requirements → Links to Review, анализ влияния от 3.1 (Open in ▾ → Spider, затем Влияние), раздел Трассировка инспектора, уравнения энергобаланса EQ-1.1–EQ-1.4 и TPM-2 (Architecture → Budgets & TPMs), Control & Reviews → Change Requests и Control & Reviews → Baselines & Versions. Без Holarch: eo-1-v1.1-traceability.csv и eo-1-v1.1-change-impact-3.1.csv — опубликованная запись влияния; сначала проведите собственный анализ, затем сравните.

Что сдать

Запись влияния (таблица: элемент, как найден, вопрос, вывод, решение, статус) и рекомендация совету по изменениям в один абзац.

Критерии оценивания

Критерий4 Образцово3 Уверенно2 В развитии1 Начальный уровень
Охват (30 %)Найдены элементы вперёд, назад и по текстовому поиску, включая те, до которых не доходит ни одна связь.Только связи, но все.Часть прямых связей.Только 3.1 и TC-06.
Выводы с числами (30 %)Использованы значения и уравнения модели; недостача по TC-06 рассчитана и объяснена.Числа в основном верны.Только качественно.Неверные выводы.
Решения (25 %)У каждого элемента решение соответствует выводу; связи отмечены как проверенные только с обоснованием; вопросы для совета отделены.Одно решение слабое.Связи отмечены как проверенные без обоснований.Решений нет.
Запись в модели (15 %)Комментарии, запрос на изменение и базовые линии на месте и согласованы с записью.Одного не хватает.Только документ.В модели ничего нет.

A6 · План валидации

Результаты: LO7 (основной), LO8, LO1 · Размер группы: группа · Рекомендуемый вес: 10 %

Предыстория

Верификация отвечает на вопрос, правильно ли EO-1 построен относительно требований; валидация — та ли это система, которая нужна фермерам-заказчикам. Набор валидации EO-1 TS-3 Mission Validation содержит VAL-01 Customer Alert Pilot (для N1, не проводился), VAL-02 Growing Season Revisit Simulation (для N2, не проводился) и VAL-03 Agronomist Map Review (для N3, пройден).

Начните план в Needs & Requirements → Documents → + New Document. В разделе Шаблон установите для Шаблоны для значение Test Plan Document и выберите встроенный Verification and Validation Plan с Включить рекомендации по написанию или шаблон организации, опубликованный преподавателем для этого задания.

Задача

  1. 5.1 Operational Scenarios: опишите сценарий для VAL-01 в терминах заказчика: кто что делает, в какой день и с каким результатом. Назовите потребность, которую он проверяет.
  2. 5.2 Users and Participants: назовите представительных пользователей и что решает каждый из них.
  3. 5.3 Validation Environment: опишите среду, чем она отличается от эксплуатации и что это отличие значит для результата.
  4. Сформулируйте критерии приёмки VAL-01 так, чтобы заказчик мог ответить «да» или «нет» без инженерной экспертизы, и запишите их в поле Ожидаемый результат тестового случая.
  5. 8 Verification Status: прочитайте живую матрицу. Возьмите непройденный тест TC-04 Pointing Accuracy Test и объясните, что означал бы результат VAL-01, если к моменту пилота TC-04 всё ещё не пройден.
  6. Экспортируйте план в Word.

Необязательно: бонус по SysML v2 (LO9, до 10 % дополнительно)

Создайте проект SysML v2 из eo-1-v1.1-power-subsystem.sysml (Manage Projects → Project Files ▾ → Import SysML v2 Files…). В файле требование 3.1 всё ещё задано как 28 Вт. Измените требуемую средневитковую мощность на 30 Вт (изменение из A5) и прочитайте, что сообщает редактор. Это ошибка моделирования или проектный вывод? Затем меняйте проектные значения, а не требование, пока строка состояния редактора не покажет Проблем нет, и укажите, физически ли правдоподобны ваши новые значения. На полстраницы укажите, какие из ваших утверждений инструмент проверил, а какие только сохранил; памятка по преподаванию SysML v2, которую даёт преподаватель, перечисляет и то и другое.

Что сдать

  • Экспорт плана в Word.
  • Для бонуса по SysML v2: файл .sysml и полстраницы текста.

Критерии оценивания

Критерий4 Образцово3 Уверенно2 В развитии1 Начальный уровень
Сценарий в терминах заказчика (30 %)Конкретный, из повседневной работы, без инженерного жаргона; явно проверяет N1.Ясный, с долей жаргона.Методика испытаний, а не сценарий.Отсутствует или общий.
Критерии приёмки (25 %)Наблюдаемые, с ответом «да» или «нет», принадлежат заказчику; связаны с формулировкой N1 «on the day of an overpass».В основном наблюдаемые.Только инженерные пороги.Расплывчатые.
Участники и среда (20 %)Названы представительные пользователи с их решениями; указаны отличия от эксплуатации и их влияние.Одного не хватает.Перечислены без влияния.Отсутствует.
Рассуждения о V&V (15 %)Объясняет, почему пилот валидации может быть успешным или неуспешным независимо от TC-04 и что означает каждый исход.В основном обоснованно.Путает верификацию и валидацию.Отсутствует.
Результат (10 %)Чистый экспорт в Word, подсказки шаблона заменены содержанием.Остались подсказки.Экспортировано частично.Отсутствует.
Бонус по SysML v2 (до +10 %)Вывод объяснён; No problems при правдоподобных значениях; точно сказано, что проверено, а что сохранено.No problems; утверждение общее.Ослаблено требование вместо изменения проекта или остались проблемы.Баллы не начисляются.

Преподавание SysML v2 с Holarch: что он проверяет, а что только хранит

Проекты SysML v2 в Holarch поддерживают подмножество спецификации OMG SysML v2. Текущее состояние каждой области приведено на странице поддержки языка SysML v2 (holarch.app/sysml-v2-coverage/); проверяйте её перед каждым семестром. Преподавая язык с Holarch, различайте три вида утверждений, чтобы студенты не приняли ограничение инструмента за правило языка, а сохранённую инструментом конструкцию — за проверенную:

  • Проверяется: редактор разбирает конструкцию и проверяет её по мере ввода, а представления и страницы её используют. Если строка состояния редактора показывает No problems, эти проверки пройдены.
  • Хранится, не интерпретируется: разбирается и хранится ровно так, как написано, в тексте и при экспорте, но смысла не получает. No problems ничего не говорит о том, верно ли это.
  • В Holarch пока нет: конструкция или возможность в Holarch недоступна. При этом она остаётся допустимым SysML v2.

Проверяется: можно преподавать и оценивать с помощью инструмента

ОбластьЧто редактор гарантированно отловит
СинтаксисСимволы, комментарии, строки, скобки, ;, ожидаемые имена и лексемы.
Имена и импортНеразрешённые, неоднозначные, повторяющиеся и закрытые имена; импорт членов, пространств имён, рекурсивный и фильтрованный импорт.
Определения, использования, специализацияpart, attribute, port, action, state, requirement и другие виды и их определения; типизация, подмножества, переопределение и сопряжение; циклы и неподходящий вид определения.
Кратности, значения и единицыДопустимые границы; величины с видами величин ISQ и единицами SI и американской системы; проверка размерностей: мощность там, где ожидается масса, — ошибка.
Ограничения и вычисленияТипы операндов, аргументы вычислений, логические условия и вычисление: сообщается об ограничениях, требованиях и целях, не выполняющихся при текущих значениях.
СтруктураКонцы соединений; направления портов, потоков и сообщений; интерфейсы и связывающие соединители.
Действия и состоянияЦели последовательностей, управляющие узлы, значения, по которым проходит цикл for, начальные переходы, параллельные области, триггеры переходов и эффекты do.
Требования и варианты использованияsubject, actor, stakeholder, require и assume constraint, цели satisfy, verify и frame в правильных местах.
Распределениеallocate … to …, определения распределения, зависимости.
ВариативностьВариация содержит только варианты своего вида, выбор является вариантом своей точки, а значения выбора вычисляются.
Экземпляры, снимки и временные срезыКаждый обладает характеристиками вхождения, которому принадлежит; собственные значения читаются первыми.

Проверяется частично: преподавайте, называя ограничение

ОбластьПроверяется или выполняетсяОграничение, о котором сказать студентам
ДействияСимулятор выполняет потоки действий, включая прогоны Монте-Карло.Длительности шагов, вероятности ветвлений и число итераций циклов — это настройки симулятора, хранящиеся в Holarch, а не в тексте, поэтому экспорт .sysml их не содержит.
СостоянияСимулятор выполняет конечные автоматы со стимулами и показывает активные состояния.То же: настройки симулятора не входят в текст.
Сценарии анализа и верификацииСубъект, цель, возвращаемый результат; verify и вердикт.Сценарий анализа вычисляется, только когда у каждого входа есть значение; решателя нет. В Parametric View команда Solve находит одну неизвестную на ограничение. Анализы компромиссов из стандартной библиотеки не вычисляются.
Представленияview, view def, expose, фильтры, точки зрения и стандартные определения представлений; Sequence View рисуют фрагменты alt, opt, loop и par.Компоновка принадлежит Holarch, а не модели.
ВариативностьВариации, варианты и конфигурации проверяются и вычисляются.Holarch пока не ищет и не перечисляет все допустимые комбинации.
Метаданные и ключевые слова@Name, #Name, metadata … about, пользовательские ключевые слова из семантических метаданных.Прочие пользовательские метаданные не имеют смысла сверх своих значений; метаданные, записанные с about, не добавляют базового типа.
Текстовые представленияТела rep … language на SysML и KerML проверяются, а тело ограничения на SysML вычисляется.Тела на других языках, например Python, OCL или MATLAB, хранятся как текст и никогда не выполняются.
Обмен в формате SysML v2 JSONИмпорт и экспорт в формате элементов Systems Modeling API с сохранением идентификаторов элементов.Виды элементов, которые Holarch не интерпретирует, сохраняются в импортированном виде и записываются обратно без изменений; у них нет текста, и их нельзя редактировать.

Хранится, не интерпретируется: No problems здесь ничего не доказывает

  • Тела текстовых представлений на языках, отличных от SysML и KerML.
  • Значения пользовательских метаданных, кроме семантических.
  • Текст doc и комментарии: никогда не сравниваются с моделью. В подсистеме электропитания EO-1 после изменения требования 3.1 на 30 Вт его doc продолжает говорить 28 Вт, и никакой проблемы не сообщается. Хорошее упражнение.
  • Виды элементов в импортированном файле SysML v2 JSON, которые Holarch не интерпретирует.

Важно и обратное: статус требований, результаты верификации и метки — это данные Holarch. Их нет ни в тексте, ни в экспорте .sysml.

В Holarch пока нет

  • Файлы .kerml: не импортируются, а модели, написанные на KerML, не проверяются. KerML читается только для стандартной библиотеки.
  • Расширения языка, кроме пользовательских ключевых слов; стандартную библиотеку нельзя редактировать.
  • Решатель для сценариев анализа и поиск допустимых комбинаций вариантов на страницах Holarch.
  • Коммиты Systems Modeling API в main, теги и слияния: другие инструменты выполняют коммиты в ветки запросов на изменение, а утверждающий применяет их в Holarch.

Как использовать это в курсе

  • Говорите «инструмент проверил» только для проверяемых областей. Например, No problems означает, что единицы согласованы и требования выполняются при текущих значениях. Это не значит, что текст doc соответствует значениям или что тело на Python верно.
  • Оценивайте сохраняемые конструкции, читая их. Оценивайте их просмотром, а не по числу проблем.
  • Поведение выполняется в симуляторе — и потоки действий, и конечные автоматы. Длительности и вероятности, которые использует симулятор, — настройки Holarch: если студенты сдают только файл .sysml, попросите и настройки.
  • Правила языка берутся из спецификации, а не из какого-либо инструмента. Если что-то в Holarch не реализовано, говорите «в Holarch пока нет», а не «не допускается».
  • Бонус A6 опирается на эту памятку: студенты меняют 3.1 на 30 Вт в подсистеме электропитания EO-1, видят, как об этом сообщает проверка вычислением, исправляют проект и записывают, что было проверено, а что только сохранено.

Загрузки

Пакет — один zip-файл. Версия указана в его имени, поэтому курс может сослаться именно на ту копию, которую использовал. CSV-файлы и файлы проекта для заданий — это загрузки эталонной модели EO-1 v1.1 на странице EO-1.

ФайлСодержимое
teaching-with-holarch-v1.0.zipВсе файлы ниже в одной папке.
README.txtСодержимое, порядок использования пакета, лицензионное уведомление и история изменений.
LICENSE.txtЛицензионное уведомление.
learning-outcomes.mdРезультаты обучения курса и их соответствие заданиям.
assignments/A1-trace-a-need.mdA1 Проследить потребность.
assignments/A2-requirements-rework.mdA2 Доработка и рецензирование требований.
assignments/A3-coverage-gaps.mdA3 Найти пробелы в покрытии.
assignments/A4-extend-the-architecture.mdA4 Расширить архитектуру.
assignments/A5-work-the-change.mdA5 Провести изменение.
assignments/A6-validation-plan.mdA6 План валидации.
sysml-v2-teaching-boundaries.mdПреподавание SysML v2 с Holarch: что он проверяет, а что только хранит.

Методических указаний с решениями в zip-файле нет; см. Методические указания с решениями.

Версии

Это пакет преподавателя Teaching with Holarch v1.0, написанный для эталонной модели EO-1 v1.1. Новая версия получает новые имена файлов; прежние версии остаются доступны по своим адресам.

  • v1.0: первый выпуск: результаты обучения курса и задания A1–A6 с критериями оценивания для эталонной модели EO-1 v1.1.

Как цитировать

Цитируйте использованную версию:

Holarch. Teaching with Holarch: instructor package, version 1.0. https://holarch.app/academic/instructor-package/. Licensed under CC BY 4.0.

Лицензия

Файлы пакета преподавателя распространяются по лицензии Creative Commons Attribution 4.0 International License (CC BY 4.0). Их можно копировать, распространять и адаптировать для любых целей, в том числе коммерческих, при условии надлежащего указания авторства, ссылки на лицензию и указания, были ли внесены изменения. Указание авторства: «Teaching with Holarch instructor package v1.0, Holarch, CC BY 4.0». Это уведомление есть в каждой загрузке.

Эталонная модель EO-1 сохраняет собственную строку авторства: «EO-1 Reference Model v1.1, Holarch, CC BY 4.0». Все названия, люди и результаты в EO-1 вымышлены.

Лицензия распространяется только на файлы пакета. Методические указания с решениями не входят в пакет, а на программное обеспечение Holarch лицензия не распространяется.

Издатель: Holarch