Holarch

Пакет для викладача · v1.0

Викладання з Holarch: пакет для викладача

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

Завантажити пакет для викладача v1.0

Усі файли (.zip, 17 KB)

Файли 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: Керування проєктами → Project Files ▾ → Новий демопроєкт → CubeSat EO-1 або завантажте eo-1-v1.1.holarch.json з holarch.app/reference-models/eo-1/ й імпортуйте через Керування проєктами → Project Files ▾ → Імпортувати проєкт…. Кожне завдання починається з моделі в тому вигляді, в якому її постачають.
  2. Проводьте курс в організації курсу. Додайте кожне завдання з терміном у Налаштування організації → Огляд курсу → + Нове завдання. «Огляд курсу» зберігає версію кожного групового проєкту на кожен термін і показує роботу кожного студента.
  3. Для A2 приєднайтеся до кожного групового проєкту з роллю Рецензент: ви можете коментувати, затверджувати, відхиляти й знову відкривати вимоги — і нічого більше.
  4. Для A6 студенти починають із вбудованого шаблону Verification and Validation Plan. Щоб дати їм скорочену версію з вашими інструкціями, збережіть її як шаблон організації (Write ▾ → Шаблони ▸ Зберегти як шаблон…, Зберегти в: Організація) і зробіть типовою для Test Plan Document.
  5. Установіть ваги, розміри груп і терміни для свого курсу. Наведені ваги — лише рекомендації.

Завдання називають сторінки Holarch, але на кожне запитання можна відповісти й за файлами CSV EO-1, тож студенти, які працюють в іншому інструменті, теж можуть узяти участь.

Нотатки з розв’язками

Нотатки з розв’язками з очікуваними знахідками, зразками відповідей і типовими помилками для A1–A6 не публікуються, тож студенти не можуть завантажити відповіді. Викладачі завантажують їх у Holarch: Налаштування організації → Огляд курсу → Завантажити примітки до розв’язків. Кнопку бачать адміністратори (викладачі й асистенти) організації зі статусом курсу.

Результати навчання

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

Після завершення курсу студенти вміють:

#РезультатЧим оцінюєтьсяВикористані можливості Holarch
LO1Розрізняти потреби зацікавлених сторін і системні вимоги та простежувати кожну потребу до вимог, що її формалізують.A1, проміжний контрольStatement, зв’язки traced to, розділ «Трасування» в поданні елемента, матриця простежуваності
LO2Писати вимоги, які є необхідними, одиничними, однозначними й верифіковними, з методом верифікації та критеріями успіху.A2, проміжний контрольАтрибути вимог, якість, TBD/TBR
LO3Проводити цикл рецензування й затвердження вимог і відповідати на коментарі рецензентів змінами в моделі.A2, участь у рецензуванніРоль рецензента, «Затвердження» («Затвердити», «Відхилити…», «Відкрити знову»), коментарі зі згадками
LO4Аналізувати покриття простежуваністю та верифікацією і для кожної прогалини вирішувати, що помилкове: модель чи вимога.A3Матриця простежуваності, RVTM, перевірки моделі
LO5Декомпонувати функції, визначати логічну архітектуру, розподіляти функції на логічні та фізичні елементи й виводити інтерфейси, що з цього випливають.A4, підсумковий контрольДіаграми Action і FFBD, Asset, розподіл, реєстр інтерфейсів
LO6Оцінювати вплив зміни вимоги за моделлю й фіксувати рішення для кожного зачепленого елемента.A5, підсумковий контрольЗв’язки для перевірки, аналіз впливу, запити на зміну, базові лінії та версії
LO7Планувати верифікацію та валідацію: розрізняти їх, вибирати методи, писати процедури тестування й валідації правильними термінами та читати RVTM.A6, підсумковий контрольТестові випадки й набори, Центр тестування, 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 у поданні елемента й прочитайте його розділ Трасування, потім скористайтеся Верифікація → Матриця простежуваності, Верифікація → RVTM і Верифікація → Центр тестування. Без 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. Викладач рецензує їх як рецензент. Дайте відповідь на кожен коментар у моделі (змініть вимогу або відповідайте з обґрунтуванням), а потім закрийте коментар.
  6. Збережіть базову лінію документа EO-1 System Requirements Specification (SRS-001) під назвою «A2 handed in» і експортуйте її у Word.

У Holarch: Потреби та вимоги → Якість, інспектор вимоги, Потреби та вимоги → Затвердження, а в документі Версія ▾ → Зберегти базову лінію… і Deliver ▾ → Specification (Word).

Що здати

Експорт у Word і записка на пів сторінки про слабкі місця, знайдені на кроці 1. Разом із ними оцінюється модель у стані на дату здачі.

Рубрика

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

A3 · Знайти прогалини в покритті

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

Передумови

EO-1 перебуває на етапі критичного аналізу проєкту. Модель навмисно недосконала: деякі вимоги не мають функції, що їх задовольняє, деякі не мають тесту, деякі тести не пройдено, а одне рівняння ні з чим не пов’язане.

Завдання

Працюйте з моделлю в тому вигляді, в якому її постачають у v1.1. Якщо груповий проєкт змінився, скористайтеся свіжою копією.

  1. Перелічіть усі вимоги, які не задовольняє жодна функція.
  2. Перелічіть усі вимоги, які не верифікує жоден тестовий випадок, і ті, чиї тести не пройдено, з відкритою проблемою та відхиленням, зафіксованими щодо них.
  3. Перелічіть вимоги без компонента, що їх задовольняє. Вирішіть, яким із них він потрібен, а які обґрунтовано задовольняються на рівні місії чи сегмента.
  4. Знайдіть елементи моделі, до яких ніщо не простежується. Підказка: подивіться на рівняння енергоживлення.
  5. Для кожної прогалини вирішіть: чогось бракує в моделі (функції, компонента, тесту, зв’язку) чи вимога непотрібна або неправильно сформульована? Дайте одне речення обґрунтування на кожну прогалину.
  6. Закрийте три прогалини на свій вибір у груповому проєкті, кожну як одну зміну, яку можна показати в Контроль і рецензування → Активність.

У Holarch: Верифікація → Матриця простежуваності, Верифікація → RVTM, Верифікація → Перевірки моделі і Ризики, проблеми та рішення → Проблеми й дії. Без 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: Архітектура → Активи, Поведінка → Діаграми Action (F4), розділ Трасування в інспекторі для розподілів, Інтерфейси → Реєстр інтерфейсів і набір Ієрархія розподілу діаграми ієрархії. Без 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 W на 30 W середньої за орбіту потужності наприкінці строку служби. Тестовий випадок TC-06 Solar Array Power Test пройдено щодо старого значення. Holarch позначив зв’язки 3.1 для перевірки.

Завдання

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

У Holarch: Потреби та вимоги → Зв’язки для перевірки, аналіз впливу від 3.1 (Відкрити в ▾ → Spider, потім Вплив), розділ Трасування в інспекторі, рівняння енергоживлення EQ-1.1–EQ-1.4 і TPM-2 (Архітектура → Бюджети й TPM), Контроль і рецензування → Запити на зміну і Контроль і рецензування → Базові лінії та версії. Без 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, пройдено).

Почніть план у Потреби та вимоги → Документи → + Новий документ. У розділі Шаблон установіть Шаблони для на 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 (Керування проєктами → Project Files ▾ → Імпортувати файли SysML v2…). У файлі вимога 3.1 досі має 28 W. Змініть потрібну середню за орбіту потужність на 30 W (зміна з 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 %)Знахідку пояснено; «Немає проблем» із правдоподібними значеннями; точне твердження про те, що перевірено, а що збережено.«Немає проблем»; твердження загальне.Послаблено вимогу замість зміни проєкту або залишилися проблеми.Без балів.

Викладання SysML v2 з Holarch: що він перевіряє, а що лише зберігає

Проєкти SysML v2 у Holarch підтримують підмножину специфікації OMG SysML v2. Поточний стан кожної області наведено на сторінці покриття мови SysML v2 (holarch.app/sysml-v2-coverage/); переглядайте її перед кожним семестром. Викладаючи мову з Holarch, розрізняйте три види тверджень, щоб студенти не сприйняли обмеження інструмента як правило мови і не вважали конструкцію, яку інструмент лише зберіг, перевіреною:

  • Перевіряється: редактор розбирає конструкцію й перевіряє її під час введення, а подання й сторінки її використовують. Коли рядок стану редактора показує Немає проблем, ці перевірки пройдено.
  • Зберігається, не інтерпретується: розбирається й зберігається точно так, як написано, у тексті та в експорті, але не отримує значення. Немає проблем нічого не каже про її правильність.
  • Поки немає в 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 і вердикт.Випадок аналізу обчислюється лише тоді, коли кожен вхід має значення; розв’язувача немає. У параметричному поданні «Розв’язати» знаходить одну невідому на обмеження. Аналізи компромісів зі стандартної бібліотеки не обчислюються.
Поданняview, view def, expose, фільтри, точки зору та стандартні визначення подань; подання послідовності малюють фрагменти 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 не інтерпретує, зберігаються як імпортовані й записуються без змін; вони не мають тексту й не редагуються.

Зберігається, не інтерпретується: «Немає проблем» тут нічого не доводить

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

Важливо й зворотне: статус вимог, результати верифікації та мітки — це дані Holarch. Їх немає в тексті й в експорті .sysml.

Поки немає в Holarch

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

Як використовувати це в курсі

  • Кажіть «інструмент перевірив» лише щодо перевірених областей. Наприклад, Немає проблем означає, що одиниці узгоджені, а вимоги виконуються для поточних значень. Це не означає, що текст doc відповідає значенням або що тіло на Python правильне.
  • Оцінюйте збережені конструкції, читаючи їх. Оцінюйте їх за переглядом, а не за кількістю проблем.
  • Поведінка виконується в симуляторі — як потоки дій, так і машини станів. Тривалості та ймовірності, які використовує симулятор, — це налаштування Holarch: якщо студенти здають лише файл .sysml, попросіть також налаштування.
  • Правила мови визначає специфікація, а не інструмент. Якщо Holarch щось не реалізував, кажіть «поки немає в Holarch», а не «заборонено».
  • Бонус A6 спирається на цю нотатку: студенти змінюють 3.1 на 30 W у підсистемі енергоживлення 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