Пакет для викладача · 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: Керування проєктами → Project Files ▾ → Новий демопроєкт → CubeSat EO-1 або завантажте
eo-1-v1.1.holarch.jsonз holarch.app/reference-models/eo-1/ й імпортуйте через Керування проєктами → Project Files ▾ → Імпортувати проєкт…. Кожне завдання починається з моделі в тому вигляді, в якому її постачають. - Проводьте курс в організації курсу. Додайте кожне завдання з терміном у Налаштування організації → Огляд курсу → + Нове завдання. «Огляд курсу» зберігає версію кожного групового проєкту на кожен термін і показує роботу кожного студента.
- Для A2 приєднайтеся до кожного групового проєкту з роллю Рецензент: ви можете коментувати, затверджувати, відхиляти й знову відкривати вимоги — і нічого більше.
- Для A6 студенти починають із вбудованого шаблону Verification and Validation Plan. Щоб дати їм скорочену версію з вашими інструкціями, збережіть її як шаблон організації (Write ▾ → Шаблони ▸ Зберегти як шаблон…, Зберегти в: Організація) і зробіть типовою для Test Plan Document.
- Установіть ваги, розміри груп і терміни для свого курсу. Наведені ваги — лише рекомендації.
Завдання називають сторінки 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.» Потребу задоволено лише тоді, коли вимоги, що її формалізують, задовольняються проєктним рішенням і верифіковані, а саму потребу валідовано із замовником.
Завдання
- Простежте N2 у моделі: вимоги, до яких вона простежується, їхні дочірні вимоги, функції та компоненти, що задовольняють кожну з них, і тестові випадки, що їх верифікують, зі статусом кожного тесту.
- Зобразіть ланцюжок у вигляді таблиці або невеликої діаграми: по одному рядку чи блоку на елемент, з його номером, назвою, статусом і зв’язком, що його з’єднує.
- Знайдіть валідаційну активність для N2 та її статус.
- Дайте відповідь: яких доказів ще бракує, щоб N2 вважалася валідованою? Перелічіть кожен відсутній доказ, елемент, до якого він належить, і що його закриє.
- Знайдіть вимоги, які підтримують 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.
Завдання
- Для кожної з трьох перелічіть, що робить її слабкою, слово за словом там, де це важливо.
- Перепишіть кожну в груповому проєкті: одне «shall», одна вимірювана умова та зазначена початкова точка чи умова там, де йдеться про час або діапазон. Замініть кожне TBD значенням і зафіксуйте обґрунтування або залиште TBR із відповідальним і датою. Для 3.5 поясніть, як ваше нове формулювання відповідає на ISS-3 і RID-1.
- Заповніть для кожної Verification Method, Рівень верифікації і Критерії успіху.
- Простежте кожну до її джерела (потреби, батьківської вимоги чи джерела) і до функції, що її задовольняє. Якщо такої функції немає, назвіть функцію, якої бракує.
- Переведіть кожну у статус In Review. Викладач рецензує їх як рецензент. Дайте відповідь на кожен коментар у моделі (змініть вимогу або відповідайте з обґрунтуванням), а потім закрийте коментар.
- Збережіть базову лінію документа 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. Якщо груповий проєкт змінився, скористайтеся свіжою копією.
- Перелічіть усі вимоги, які не задовольняє жодна функція.
- Перелічіть усі вимоги, які не верифікує жоден тестовий випадок, і ті, чиї тести не пройдено, з відкритою проблемою та відхиленням, зафіксованими щодо них.
- Перелічіть вимоги без компонента, що їх задовольняє. Вирішіть, яким із них він потрібен, а які обґрунтовано задовольняються на рівні місії чи сегмента.
- Знайдіть елементи моделі, до яких ніщо не простежується. Підказка: подивіться на рівняння енергоживлення.
- Для кожної прогалини вирішіть: чогось бракує в моделі (функції, компонента, тесту, зв’язку) чи вимога непотрібна або неправильно сформульована? Дайте одне речення обґрунтування на кожну прогалину.
- Закрийте три прогалини на свій вибір у груповому проєкті, кожну як одну зміну, яку можна показати в Контроль і рецензування → Активність.
У 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, але не має логічного рівня.
Завдання
- Додайте логічні елементи для визначення та керування орієнтацією під 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: Архітектура → Активи, Поведінка → Діаграми 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 для перевірки.
Завдання
- Перелічіть кожен елемент, якого стосується зміна: уперед за зв’язками від 3.1, назад до того, з чого виведено 3.1, і елементи, що згадують старе значення без зв’язку з 3.1. Поясніть, як ви знайшли кожен із них.
- Для кожного елемента запишіть питання, яке порушує зміна, вашу знахідку (з числами там, де вони є в моделі) і рішення: без змін (позначити зв’язок перевіреним із коментарем), оновити або передати на розгляд ради зі змін.
- Вирішіть, що робити з TC-06: чи доводить тест, пройдений при 28 W, досягнення 30 W? Покажіть обчислення за рівняннями моделі.
- Знайдіть один елемент, який пропускає аналіз на основі зв’язків, і поясніть, чому він важливий.
- Зафіксуйте свої рішення в груповому проєкті: коментар до кожного зв’язку, який ви позначаєте перевіреним, запит на зміну для того, що має вирішити рада, і базову лінію до й після.
У 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 з опцією Включити настанови з написання або шаблон організації, який викладач опублікував для цього завдання.
Завдання
- 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 (Керування проєктами → 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 залишає в їїdoc28 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.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 ліцензією не охоплено.