Пакет преподавателя · v1.0
Преподавание с Holarch: пакет преподавателя
Результаты обучения и шесть заданий с критериями оценивания для семестрового курса системной инженерии или MBSE, построенные на открытой эталонной MBSE-модели EO-1 v1.1 — вымышленном 6U CubeSat для наблюдения Земли. Бесплатно по лицензии CC BY 4.0.
Скачать пакет преподавателя v1.0
Файлы Markdown, которые открываются в любом редакторе. Используют эталонную модель EO-1 v1.1. Лицензия: CC BY 4.0, указание авторства «Holarch».
На этой странице
- Содержимое
- Как использовать
- Методические указания с решениями
- Результаты обучения
- A1 · Проследить потребность
- A2 · Доработка и рецензирование требований
- A3 · Найти пробелы в покрытии
- A4 · Расширить архитектуру
- A5 · Провести изменение
- A6 · План валидации
- Преподавание SysML v2 с Holarch: что он проверяет, а что только хранит
- Загрузки
- Версии
- Как цитировать
- Лицензия
Содержимое
| Файл | Для кого | Содержимое |
|---|---|---|
learning-outcomes.md | Преподаватели, документы аккредитации | Результаты обучения курса, задания, которые оценивают каждый из них, и используемые возможности Holarch. |
assignments/A1-trace-a-need.md – A6-validation-plan.md | Студенты (раздаточный материал) | Шесть заданий на EO-1, в каждом — предыстория, задача, что сдать и критерии оценивания. |
sysml-v2-teaching-boundaries.md | Преподаватели | Что проверяют проекты SysML v2 в Holarch, что они хранят без интерпретации и что пока недоступно. |
Как использовать
- Дайте каждой группе собственную копию 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…. Каждое задание начинается с модели в исходном виде. - Проводите курс в учебной организации. Добавьте каждое задание со сроком через Organization Settings → Class Review → + New Assignment. Class Review сохраняет версию каждого группового проекта на каждую дату сдачи и показывает работу каждого студента.
- Для A2 присоединитесь к каждому групповому проекту как Рецензент: вы можете комментировать, утверждать, отклонять и повторно открывать требования, и ничего больше.
- Для A6 студенты начинают со встроенного шаблона Verification and Validation Plan. Чтобы дать им сокращённую версию со своими указаниями, сохраните её как шаблон организации (Write ▾ → Templates ▸ Save as Template…, Save to: Organization) и сделайте шаблоном по умолчанию для Test Plan Document.
- Задайте веса, размеры групп и сроки для своего курса. Указанные веса — рекомендации.
В заданиях названы страницы 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.» Потребность удовлетворена, только когда формализующие её требования выполнены проектом и верифицированы, а сама потребность валидирована с заказчиком.
Задача
- Проследите N2 по модели: требования, к которым она прослеживается, их дочерние требования, функции и компоненты, выполняющие каждое из них, и тестовые случаи, которые их верифицируют, со статусом каждого теста.
- Изобразите цепочку в виде таблицы или небольшой диаграммы: одна строка или блок на элемент, с его номером, названием, статусом и связью, которая его соединяет.
- Найдите действие валидации для N2 и его статус.
- Ответьте: каких свидетельств ещё не хватает, чтобы N2 считалась валидированной? Перечислите каждое недостающее звено, элемент, к которому оно относится, и что его закроет.
- Найдите требования, которые поддерживают 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.
Задача
- Для каждого из трёх перечислите, что делает его слабым, — пословно там, где это важно.
- Перепишите каждое в групповом проекте: одно «shall», одно измеримое условие и указанная точка отсчёта или условие там, где речь о времени или диапазоне. Замените каждое TBD значением и запишите его обоснование либо оставьте TBR с ответственным и датой. Для 3.5 укажите, как ваша формулировка отвечает на ISS-3 и RID-1.
- Заполните для каждого Verification Method, Уровень верификации и Критерии успеха.
- Проследите каждое до его источника (потребности, родительского требования или первоисточника) и до выполняющей его функции. Если функции нет, назовите недостающую функцию.
- Переведите каждое в статус In Review. Преподаватель рецензирует их как Reviewer. Ответьте на каждый комментарий в модели (измените требование или ответьте с обоснованием), затем закройте комментарий.
- Сохраните базовую линию документа 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. Если групповой проект изменился, используйте свежую копию.
- Перечислите все требования, которые не выполняет ни одна функция.
- Перечислите все требования, которые не верифицирует ни один тестовый случай, и те, чьи тесты не пройдены, с открытой проблемой и отклонением, зарегистрированными по ним.
- Перечислите требования без выполняющего компонента. Решите, каким из них он нужен, а какие обоснованно выполняются на уровне миссии или сегмента.
- Найдите элементы модели, к которым ничто не прослеживается. Подсказка: посмотрите на уравнения энергобаланса.
- Для каждого пробела решите: в модели чего-то не хватает (функции, компонента, теста, связи) или требование не нужно либо сформулировано неверно? Дайте одно предложение обоснования на пробел.
- Закройте три пробела на свой выбор в групповом проекте, каждый — одним изменением, на которое можно указать в 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, но нет логического уровня.
Задача
- Добавьте под L0 логические элементы для определения и управления ориентацией. Каждый элемент описывает своё назначение, не называя оборудования.
- Распределите на них F4.1–F4.4 и свяжите каждый логический элемент с физическими частями под 1.2 ADCS, которые его реализуют, по образцу L1–L6.
- Нарисуйте диаграмму Action для F4 с элементами, передаваемыми между её подфункциями, например оценкой ориентации и командами моментов, если в проекте группы её ещё нет.
- Выведите интерфейсы из потоков, пересекающих границы элементов. Сравните их с существующими интерфейсами IF-06, IF-16, IF-17 и IF-18: какие совпадают, каких не хватает и какие передают элементы, не используемые ни одной функцией?
- Убедитесь, что каждое из требований 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 для проверки.
Задача
- Перечислите все элементы, которых касается изменение: вперёд по связям от 3.1, назад к тому, из чего выведено 3.1, и элементы, упоминающие старое значение без связи с 3.1. Укажите, как вы нашли каждый.
- Для каждого элемента запишите вопрос, который поднимает изменение, ваш вывод (с числами, где они есть в модели) и решение: без изменений (отметить связь как проверенную с комментарием), обновить или передать на совет по изменениям.
- Решите, что делать с TC-06: доказывает ли тест, пройденный при 28 Вт, выполнение 30 Вт? Покажите расчёт по уравнениям модели.
- Найдите один элемент, который пропускает анализ по связям, и объясните, почему он важен.
- Зафиксируйте решения в групповом проекте: комментарий к каждой связи, отмеченной как проверенная, запрос на изменение для того, что должен решить совет, и базовая линия до и после.
В 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 с Включить рекомендации по написанию или шаблон организации, опубликованный преподавателем для этого задания.
Задача
- 5.1 Operational Scenarios: опишите сценарий для VAL-01 в терминах заказчика: кто что делает, в какой день и с каким результатом. Назовите потребность, которую он проверяет.
- 5.2 Users and Participants: назовите представительных пользователей и что решает каждый из них.
- 5.3 Validation Environment: опишите среду, чем она отличается от эксплуатации и что это отличие значит для результата.
- Сформулируйте критерии приёмки VAL-01 так, чтобы заказчик мог ответить «да» или «нет» без инженерной экспертизы, и запишите их в поле Ожидаемый результат тестового случая.
- 8 Verification Status: прочитайте живую матрицу. Возьмите непройденный тест TC-04 Pointing Accuracy Test и объясните, что означал бы результат VAL-01, если к моменту пилота TC-04 всё ещё не пройден.
- Экспортируйте план в 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.md | A1 Проследить потребность. |
assignments/A2-requirements-rework.md | A2 Доработка и рецензирование требований. |
assignments/A3-coverage-gaps.md | A3 Найти пробелы в покрытии. |
assignments/A4-extend-the-architecture.md | A4 Расширить архитектуру. |
assignments/A5-work-the-change.md | A5 Провести изменение. |
assignments/A6-validation-plan.md | A6 План валидации. |
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 лицензия не распространяется.