SysML v2
Охват языка SysML v2
Проекты SysML v2 в Holarch основаны на спецификации OMG SysML v2 и поддерживают подмножество языка. На этой странице перечислена каждая область текстовой нотации, степень её поддержки в Holarch и известные пробелы.
Что означают уровни
- Поддерживается: Редактор разбирает и проверяет конструкцию, модель её сохраняет, а представления и страницы, которые её используют, читают и записывают её.
- Частично: поддерживается с ограничениями, указанными в строке.
- Сохраняется, не интерпретируется: разбирается и сохраняется точно в том виде, в каком написано, в тексте и при экспорте, но собственного смысла не получает.
- Пока нет: недоступно.
Один и тот же языковой движок обслуживает Редактор, представления и проверки, поэтому конструкция, которую принимает Редактор, одинакова в каждом представлении. См. также Holarch Language Engine.
Перейти к: Конструкции языка · Файлы и обмен · Проверки · Известные пробелы
Конструкции языка
| Область | Уровень | Конструкции | Ограничения |
|---|---|---|---|
| Пакеты и пространства имён | Поддерживается | package, вложенные пакеты, library package, doc, comment … about, заметки // и //* */, alias … for …, public, private и protected, краткие имена <'1.2'>, имена в кавычках. | Библиотечные пакеты, включая стандартную библиотеку, доступны только для чтения. |
| Импорты | Поддерживается | Импорт членства и пространства имён, ::*, рекурсивный ::**, импорт с видимостью, отфильтрованный импорт [@Kind]. | Фильтры импорта выбирают по метаклассу. |
| Определения и использования | Поддерживается | part, attribute, item, port, connection, interface, flow, action, state, requirement, constraint, calc, use case, analysis, verification, view, viewpoint, concern, enum, occurrence, allocation, metadata; ref, abstract, in, out, inout и end. | Не известны. |
| Специализация, типизация и переопределение | Поддерживается | Специализация :> и specializes, типизация : и defined by, подмножество :> и subsets, переопределение :>> и redefines, сопряжение ~, disjoint, цепочки признаков a.b.c. | Не известны. |
| Кратности | Поддерживается | [n], [n..m], [*], [0..*], ordered, nonunique, выражения в качестве границ. | Не известны. |
| Значения и единицы измерения | Поддерживается | =, :=, default, величины, например 5 [kg], выражения единиц, например [m/s^2], виды величин ISQ, единицы SI и американские традиционные единицы стандартной библиотеки, проверки размерности. | Не известны. |
| Ограничения и вычисления | Поддерживается | Определения и использования ограничений и вычислений, return, assert constraint, вызовы, выражения KerML с арифметикой, сравнением, логикой, if ? else и операциями над последовательностями, вычисление с единицами измерения. | Не известны. |
| Структура | Поддерживается | Порты и сопряжённые порты, connect, интерфейсы с концами, именованные концы соединений с кратностями (connect [1] driver ::> a to [1] driven ::> b), связывающие соединители bind, потоки предметов flow of T from … to …, message. | Не известны. Направления портов, потоков и message проверяются. Представления Interconnection подписывают именованные концы их кратностью, а инспектор позволяет их редактировать. |
| Действия | Частично | Параметры, perform, последования first … then … и then, fork, join, decide, merge, охранные условия, accept, send, assign, if, while, for, loop, start, done, terminate. | Симулятор выполняет потоки действий, включая прогоны Монте-Карло, с длительностями, вероятностями ветвей и числом итераций циклов из модели. |
| Состояния | Частично | Действия entry, do и exit, переходы с триггером, охранным условием и эффектом (редактируются в Представлении переходов состояний и в инспекторе и показываются под переходом в Браузере), состояния parallel, вложенные состояния, exhibit. | Симулятор выполняет машины состояний с движком SysML, со стимулами, и подсвечивает активные состояния во время работы. Проверяется каждый вид эффекта do, полезная нагрузка триггера проверяется по его порту, а другие части модели могут ссылаться на триггер и эффект перехода (plugIn.effect.sentMessage). |
| Требования | Поддерживается | subject, actor, stakeholder, require constraint, assume constraint, frame concern, satisfy … by …, verify, краткие имена как идентификаторы требований, doc как текст требования. | Не известны. |
| Варианты использования | Поддерживается | Определения и использования вариантов использования, subject, actor, objective, include use case. | Не известны. |
| Сценарии анализа и верификации | Частично | Случаи анализа с субъектом, целью и результатом return; случаи верификации с verify и вердиктом. | Случай анализа вычисляется, только когда у каждого входа есть значение. Анализы компромиссов из стандартной библиотеки не вычисляются; вместо этого страница «Анализ компромиссов» в Holarch оценивает альтернативы по значениям из модели. |
| Представления | Частично | view, view def, expose с ::*, ::** и фильтрами, filter, viewpoint, frame, render, стандартные определения представлений. | Представления последовательности рисуют сообщения между линиями жизни, а сообщения внутри if/else, циклов, разветвлений и решений — как фрагменты alt, opt, loop и par с их охранными условиями. |
| Распределение и зависимости | Поддерживается | allocate a to b, определения распределения, dependency from … to …. | Не известны. |
| Метаданные | Частично | @Name { … }, префикс #Name, metadata Name about …, пользовательские metadata def, пакеты метаданных Holarch для значений TBD и TBR и понятий DoDAF и UAF, пользовательские ключевые слова (#safetyCritical part controller), семантические метаданные (#fault def BatteryOverheat;) и метаданные с собственным смыслом: обязательные значения, значения объявленного типа и ограничения определения проверяются при каждом использовании. | Ограничения определения метаданных читают его собственные значения, а не аннотируемый элемент. Метаданные, записанные с about, не добавляют базового типа. |
| Вариативность | Поддерживается | Определения и использования variation, члены variant и ссылки на варианты (variant plugInHybrid;), выбор по значению (part :>> pack = BatteryPack::largePack;), конфигурации, помеченные @HolarchConfiguration. Проверяется и вычисляется: у варианта есть признаки его вариативности, выбор должен быть одним из вариантов точки, а у точки без выбора значение неизвестно, поэтому утверждение над ней ни выполнено, ни нарушено. | Конфигурации записываются в тексте; Holarch пока не ищет допустимые комбинации на своих страницах. |
| Индивиды и временные срезы | Поддерживается | Определения и использования individual (individual part def Car_VIN1234 :> Car), snapshot и timeslice (также после then), их значения и последования. Проверяется и вычисляется: у снимка или временного среза есть признаки вхождения, к которому он относится, и его собственные значения читаются первыми. Поле Вхождение в инспекторе, фильтр Individuals в Браузере и Новый снимок…/Новый временной срез…, а также представления General с «individual», «snapshot» и «timeslice» и Упорядочить как временную шкалу. | Индивидами, снимками или временными срезами могут быть только вхождения. |
| Текстовые представления | Частично | rep language "…" /* … */; тела на SysML и KerML проверяются и подсвечиваются как код, а тело ограничения SysML вычисляется. Инспектор добавляет и редактирует представления, а представления Action Flow помечают действие, у которого оно есть, его языком, например {Python}. | Тела на других языках, например Python, OCL или MATLAB, сохраняются как текст и никогда не выполняются. Тело не может содержать */. |
| KerML | Частично | Текст KerML стандартной библиотеки: библиотеки ядра читаются на KerML. Тела текстовых представлений на KerML проверяются. | Файлы .kerml не импортируются в проекты, а модели, написанные на KerML, не проверяются. |
| Расширения языка | Частично | Пользовательские ключевые слова из семантических метаданных: #fault def BatteryOverheat; специализирует базовый тип метаданных, поэтому имеет признаки этого базового типа; метаданные, ограничивающие то, что они аннотируют (annotatedElement). | Базовый тип читается как имя (faults meta SysML::Usage). Другие расширения языка недоступны, а стандартную библиотеку нельзя редактировать. |
Файлы и обмен
| Формат | Уровень | Что охватывает | Ограничения |
|---|---|---|---|
| Текст SysML v2 (.sysml) | Поддерживается | Импорт и экспорт, также в виде .zip с файлами, с предварительным просмотром до применения импорта. | Идентификаторы элементов сохраняются, если при экспорте отмечено Включить ID элементов; без них повторный импорт сопоставляет элементы по имени. |
| SysML v2 JSON | Частично | Импорт и экспорт в формате элементов Systems Modeling API с сохранением идентификаторов элементов. | Виды элементов, которые Holarch не интерпретирует, сохраняются в импортированном виде и без изменений записываются обратно при экспорте; у них нет текста, и их нельзя редактировать. |
| Модели SysML v1 (XMI, .mdzip) | Частично | Импорт в проект SysML v2 из Cameo или MagicDraw (.mdzip или XMI), Enterprise Architect, Rhapsody и Papyrus (XMI, .uml, .xml). Модель преобразуется в текст SysML v2 и проверяется, а отчёт о преобразовании перечисляет каждый элемент как преобразованный, приближённый или пропущенный, с указанием причины, также в формате CSV. Импорт — один шаг отмены. | Только импорт. Элементы без аналога в SysML v2, например конечные узлы потока, разделы деятельности, расширения вариантов использования и спецификации экземпляров, пропускаются; диаграммы и их раскладка не преобразуются. Один файл не более 64 MB и 250 000 элементов; файлы проектов Enterprise Architect (.eap, .qea) не читаются. |
| Репозитории моделей | Поддерживается | Получение из одной ветки репозитория, поддерживающего Systems Modeling API, и отправка в неё. | Одна ветка на проект. |
| Systems Modeling API в Holarch | Частично | Другие инструменты SysML v2 читают текущую модель проекта и делают коммиты в ветки запросов на изменение. | main доступна только для чтения: коммиты попадают в запросы на изменение, которые утверждающий применяет в Holarch. |
| Файлы KerML (.kerml) | Пока нет | Не импортируются; импорт их пропускает. | Используйте файлы .sysml. |
Пределы размера и все остальные форматы перечислены на странице Импорт и экспорт.
Проверки
Редактор проверяет текст во время ввода и отмечает каждую проблему на месте. Проверки охватывают:
- Синтаксис: символы, комментарии, строки, скобки,
;, ожидаемые имена и лексемы. - Имена: неразрешённые, неоднозначные, повторяющиеся и закрытые имена.
- Типизация и специализация: циклы, правильный вид определения, подмножество и переопределение унаследованных признаков.
- Кратности и единицы измерения: допустимые границы, совпадение размерностей, отсутствующие или неизвестные единицы.
- Выражения: типы операндов, аргументы вычислений и логические условия.
- Структура, действия и состояния: концы соединений, направления портов, потоков и
message, цели последований, управляющие узлы, значения, по которым проходит циклfor, начальные переходы, параллельные области, триггеры переходов (полезная нагрузка через порты, моментыat) и эффектыdo(включая то, куда идётsend). - Пользовательские ключевые слова:
#Nameназывает метаданные, метаданные помечают только допустимые для них виды элементов, а семантический базовый тип — это определение или использование, подходящее помечаемому элементу. - Значения метаданных: каждое использование определения метаданных задаёт его обязательные значения, каждое значение соответствует типу своего признака, а ограничения определения выполняются.
- Вариативность: вариативности содержат только варианты своего вида, выбор является вариантом своей точки, а открытые точки конфигурации отмечаются.
- Требования, случаи и представления: члены на правильном месте, цели
satisfy,verify,exposeиframe. - Текстовые представления: тела на SysML и KerML разбираются и объявляют представляемый ими элемент; язык, неизвестный Holarch, отмечается.
- Вычисление: ограничения, требования и цели, которые не выполняются при текущих значениях.
Каждая проверка с примером сообщения: Проверки.
Известные пробелы
- Нет решателя для случаев анализа. Случай анализа вычисляется, когда у каждого входа есть значение. В Параметрическом представлении «Решить» находит одну неизвестную на ограничение.
- Нет поиска вариантов на страницах. Вариативности, варианты и конфигурации проверяются и вычисляются; страницы Holarch пока не перечисляют все допустимые комбинации.
- Нет файлов KerML. KerML читается только для стандартной библиотеки.
- Расширения языка ограничены пользовательскими ключевыми словами и метаданными. Семантические метаданные применяют свой базовый тип; другие метаданные означают то, что указывает их определение (обязательные значения, типы значений и ограничения), а стандартная библиотека доступна только для чтения.
- Текстовые представления на языках, отличных от SysML и KerML, сохраняются как текст; Holarch никогда их не выполняет.
- Systems Modeling API: нет коммитов в main, тегов и слияний. Другие инструменты делают коммиты в ветки запросов на изменение; утверждающий применяет их в Holarch.
Holarch реализует подмножество спецификации, перечисленное на этой странице. В разделе Что нового перечислено каждое его изменение.