Holarch

SysML v2

Primeros pasos con proyectos SysML v2

Elija entre un proyecto LML y uno SysML v2, cree un proyecto SysML v2 o una demostración, escriba un primer modelo y oriéntese.

Cómo usarlo →

En esta página
  1. Resumen
  2. Conceptos
    1. Dos tipos de proyecto
    2. El modelo y el texto son uno
    3. Datos del modelo y datos de Holarch
    4. Definiciones y usos
  3. Cómo usarlo
    1. Elegir un tipo de proyecto
    2. Crear un proyecto SysML v2
    3. Abrir la demostración Hybrid Car
    4. Abrir la demostración Hybrid Car Battery Pack
    5. Abrir la demostración Earth Observation Satellite
    6. Escribir su primer modelo
    7. Orientarse
  4. Ejemplo práctico: explorar el Hybrid Car
  5. Consejos y errores comunes
  6. La barra lateral en los proyectos SysML v2
  7. Modo simple
    1. Activarlo o desactivarlo
    2. Qué muestra
    3. Mostrar todo
  8. Inicio
  9. Preguntar a la IA
  10. Aún no disponible
  11. Mensajes
  12. Límites
  13. Páginas relacionadas

Resumen

Holarch admite proyectos SysML v2. Un proyecto SysML v2 contiene un modelo, escrito en la notación textual de SysML v2 y basado en la especificación OMG SysML v2.

El modelo se escribe como texto en el Editor. Holarch mantiene el mismo modelo como elementos: paquetes, definiciones, usos y relaciones. El Navegador, las vistas y las páginas del ciclo de vida (requisitos, verificación, interfaces, riesgo, plan) muestran todos esos mismos elementos.

Esta página explica los dos tipos de proyecto, cómo empezar un proyecto SysML v2 y dónde está cada cosa. El lenguaje en sí se describe en Notación textual de SysML v2. El Editor y el Navegador se describen en El editor de texto y el navegador.

Conceptos

Dos tipos de proyecto

Cada proyecto de Holarch es un proyecto LML o un proyecto SysML v2. El tipo se elige al crear el proyecto. Es fijo: un proyecto cambia de tipo solo mediante una copia convertida (consulte Convertir entre LML y SysML v2).

LMLSysML v2
Para qué sirveModelar un sistema en el Lifecycle Modeling Language: requisitos, funciones, la arquitectura física, interfaces, pruebas, riesgos y el calendario. Holarch comprueba su trabajo en cada paso.Construir un modelo en el lenguaje SysML v2, como texto, con conceptos estándar de SysML v2: paquetes, definiciones y usos, puertos, conexiones, acciones, estados y requisitos.
Cómo se construye el modeloLa base de datos, formularios y más de 30 tipos de diagrama.Texto en el Editor, además de vistas y las páginas del ciclo de vida, que escriben en el mismo texto.
Qué se puede intercambiarImportaciones de Word, Excel, CSV, ReqIF y XMI; exportaciones de Word, Excel y diagramas; archivos de proyecto.Texto SysML v2 (.sysml) y JSON de SysML v2 (consulte Intercambiar modelos SysML v2); importaciones de SysML v1 desde XMI y desde archivos .mdzip de Cameo o MagicDraw (consulte Importar modelos SysML v1); archivos de proyecto.

Si tiene dudas, elija LML. Tiene todas las páginas y diagramas de Holarch y es adecuado para quienes se inician en MBSE. Elija SysML v2 cuando su equipo ya modele en SysML v2 o intercambie modelos con herramientas SysML v2.

El modelo y el texto son uno

Un proyecto SysML v2 no contiene archivos. El modelo es un conjunto de elementos, y el Editor muestra un documento de texto por cada paquete de nivel superior. Cuando el texto se analiza correctamente, Holarch lo aplica al modelo. Cuando usted cambia el modelo en otro lugar (una vista, una tabla, el inspector), el texto cambia con él. Consulte El texto y las vistas se mantienen sincronizados.

Datos del modelo y datos de Holarch

Parte de la información forma parte del texto SysML; otra parte la guarda Holarch junto al modelo.

  • En el texto: nombres de elementos, nombres cortos (números de requisito), documentación, tipos, multiplicidades, valores y relaciones como satisfy, verify, perform y connect.
  • Junto al modelo (datos de Holarch): estado y aprobaciones de requisitos, resultados de verificación, etiquetas, responsables asignados, fechas límite, comentarios de discusión, diseños de las vistas, ajustes del simulador, presupuestos, riesgos, decisiones y tareas. Se vinculan a los elementos del modelo por su identidad, de modo que los vínculos sobreviven a cambios de nombre y traslados.

Los datos de Holarch no se escriben en el texto SysML y no forman parte de una exportación .sysml.

Definiciones y usos

La mayoría de las palabras clave de SysML v2 tienen dos formas. Una definición (part def Wheel;) describe un tipo de cosa. Un uso (part frontWheel : Wheel;) es un uso de una definición dentro de otro elemento. El mismo patrón se aplica a port def/port, action def/action y requirement def/requirement. Notación textual de SysML v2 lo explica en detalle.

Cómo usarlo

Elegir un tipo de proyecto

Decida el tipo antes de crear el proyecto.

  1. Elija LML para usar el método completo de Holarch: la base de datos, los diagramas LML y las comprobaciones guiadas en cada paso.
  2. Elija SysML v2 cuando el modelo deba ser texto SysML v2, por ejemplo para intercambiarlo con otra herramienta SysML v2.
  3. Para probar primero SysML v2, abra la demostración Hybrid Car (dos flujos de trabajo más abajo) en lugar de un proyecto en blanco.

Crear un proyecto SysML v2

  1. Abra Gestionar proyectos y haga clic en + Nuevo proyecto.
  2. En ¿Cómo va a modelar este sistema?, elija SysML v2.
  3. Introduzca un nombre y haga clic en Crear proyecto.

El proyecto se abre en Inicio. La etiqueta SysML v2 aparece junto al nombre del proyecto en la barra superior y en Gestionar proyectos. Un modelo nuevo está vacío: Próximas acciones en Inicio dice Escribir el primer package en el Editor.

Abrir la demostración Hybrid Car

La demostración Hybrid Car es un modelo SysML v2 terminado para explorar y editar.

  1. Abra Gestionar proyectos.
  2. Haga clic en Archivos de proyecto ▾ → Nuevo proyecto de demostración → Hybrid Car (SysML v2).

Holarch crea el proyecto Hybrid Car (SysML v2 demo) y lo abre en Inicio. Haga clic en Editor en la barra lateral para leer el texto. El modelo tiene seis paquetes de nivel superior: Vehicles, VehicleRequirements, VehicleBehavior, VehicleViews, HolarchFrameworks y HybridCarArchitecture. Cada uno es un documento de la lista Packages del Editor.

La demostración es su propia copia. Cámbiela libremente o vuelva a crearla para empezar de cero.

Para abrir la demostración desde un enlace, use https://app.holarch.app/#/?demo=hybrid. Crea la demostración y la abre; en la aplicación alojada, se abre después de iniciar sesión.

Abrir la demostración Hybrid Car Battery Pack

La demostración Hybrid Car Battery Pack es la batería de tracción del coche tal como la modela su proveedor, en un proyecto propio. Si la demostración Hybrid Car también está entre sus proyectos, creada antes o después, tres requisitos de la batería están vinculados a los requisitos de batería del coche (BP-1 a VR-3, BP-2 a VR-6, BP-3 a VR-5), de modo que Gestionar proyectos → Mapa del programa muestra cómo se conectan los dos proyectos. Estos vínculos de demostración funcionan en todos los planes.

  1. Abra Gestionar proyectos.
  2. Haga clic en Archivos de proyecto ▾ → Nuevo proyecto de demostración → Hybrid Car Battery Pack (SysML v2).

Qué probar:

  • Valores calculados: en el Editor, Pack::mass suma los módulos (12 celdas y una carcasa cada uno), el sistema de gestión de la batería, la caja de conexiones, la refrigeración y la envolvente: 43 kg frente al límite de 48 kg, de modo que massMargin es 5 kg. Pack::capacity suma las 120 celdas: 1,44 kWh frente a 1,4 kWh. Seleccione un atributo para ver su valor en el inspector.
  • Vista paramétrica: abra packParametrics. Las comprobaciones de capacidad, masa, tiempo de carga y equilibrado de celdas están vinculadas cada una a los valores de la batería y se cumplen.
  • RVTM: capacidad y masa están en Superada, la aceptación de carga está en Fallida (la prueba de carga en caliente tardó 34 minutos frente a 30) y el equilibrado de celdas aún no se ha ejecutado. Cada caso de verificación calcula su veredicto a partir del modelo.
  • Simulador: el Simulador se abre en pack junto con Hot Day Charge. Haga clic en Ejecutar hasta el final y después en Estados: la carga baja a media potencia cuando las celdas se sobrecalientan y se reanuda cuando se enfrían. Elija Cell Over Voltage Fault en Ejecutar junto con para ver una parada de protección y el restablecimiento de servicio.

Abrir la demostración Earth Observation Satellite

La demostración Earth Observation Satellite es un modelo más grande: la misión EO-2, un satélite de imágenes de 12U con su segmento terreno, en unas 3.000 líneas repartidas en 14 paquetes. Los datos propios de Holarch están rellenados sobre el modelo, de modo que cada página tiene algo que mostrar.

  1. Abra Gestionar proyectos.
  2. Haga clic en Archivos de proyecto ▾ → Nuevo proyecto de demostración → Satélite de observación de la Tierra (SysML v2).

Holarch crea el proyecto Earth Observation Satellite (SysML v2 demo) y abre Inicio. La demostración tiene 1.549 elementos, más que los 1.000 elementos por proyecto del plan Free: en el plan Free, su entrada de menú está desactivada y dice Necesita el plan Individual (1.549 elementos). El enlace https://app.holarch.app/#/?demo=eosat también la crea. Qué probar:

  • Documentos: abra EO-2 System Requirements Specification. Sus secciones contienen los requisitos de EORequirements, valores en vivo y una matriz de verificación.
  • Presupuestos: la masa del generador de imágenes supera su asignación de 4,0 kg; el TPM Imager Mass muestra la tendencia.
  • Vínculos por revisar y TBD/TBR: requisitos cambiados y valores abiertos por resolver.
  • Simulador: ejecute el paso de toma de imágenes desde la vista imagingPassFlow.
  • Líneas base: compare la línea base PDR Data Freeze con el modelo actual.
  • Vistas: los modos de la nave, las vistas de interconexión y la secuencia de asignación de tareas.

Escribir su primer modelo

Este flujo de trabajo construye un pequeño modelo de dron con este texto:

package Drone {
    private import ISQ::*;
    private import SI::*;

    part def Battery {
        attribute mass : MassValue = 0.4 [kg];
    }
    part def Quadcopter {
        part battery : Battery;
    }
}
  1. Abra Modelo → Editor, haga clic en + Nuevo package, introduzca Drone y confirme. El Editor abre el texto del nuevo paquete.
  2. Escriba las importaciones y los miembros dentro de las llaves del paquete, como arriba.
  3. Deje de escribir. Tras una breve pausa, la línea de estado bajo el texto dice Aplicado. El modelo contiene ahora el paquete, las dos definiciones de parte, el atributo y la parte, y un solo Deshacer lo revierte todo.
  4. Abra Modelo → Navegador y expanda Drone para ver los mismos elementos como un árbol.

Si una línea tiene un error, la línea de estado dice No aplicado: corrija la línea N. El modelo conserva su último estado correcto hasta que el texto se vuelva a analizar sin errores. Consulte Errores y borradores.

Orientarse

Los proyectos SysML v2 conservan la barra lateral del ciclo de vida de Holarch. Cada grupo trabaja sobre el modelo SysML v2.

  1. Empiece en Inicio para ver lo que requiere atención, los grupos del ciclo de vida y las próximas acciones.
  2. Use Modelo → Editor para escribir texto y Modelo → Navegador para ver el árbol.
  3. Use Necesidades y requisitos y Verificación para los requisitos, los casos de verificación y la trazabilidad.
  4. Use Comportamiento, Arquitectura e Interfaces para las vistas y las páginas de análisis.
  5. Abra la herramienta Diagramas en la parte inferior de la barra lateral para ver todas las vistas.
  6. Pulse ⌘K / Ctrl+K para encontrar cualquier elemento por su nombre, su nombre corto, su nombre calificado (Vehicles::Car) o el texto de su documentación.
  7. ¿Es nuevo en SysML v2? Active el modo simple para ver primero los elementos más usados.

Ejemplo práctico: explorar el Hybrid Car

Este recorrido usa la demostración Hybrid Car.

  1. Cree la demostración (consulte Abrir la demostración Hybrid Car). Se abre en Inicio. Abra Modelo → Editor y elija Vehicles en la lista Packages.
  2. Busque part def Car. Tiene las partes body, powertrain, frontAxle, rearAxle y spare : Wheel [0..1].
  3. Haga ⌘ / Ctrl-clic en Powertrain en part powertrain : Powertrain;. El cursor salta a part def Powertrain, con sus partes tank, engine, motor, battery, transmission y controller, e interfaces como interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;.
  4. Señale MassValue en attribute mass : MassValue;. Una tarjeta muestra su tipo y su nombre calificado de la biblioteca estándar.
  5. Abra Modelo → Navegador. Escriba sedan en Filtrar por nombre. El árbol muestra sedan bajo fleet en Vehicles. Selecciónelo: el inspector muestra Tipo part, Tipado por Car y el nombre calificado Vehicles::fleet::sedan.
  6. Abra Inicio. La tarjeta Ciclo de vida de Necesidades y requisitos cuenta los requisitos del modelo; Requiere atención muestra los vínculos por revisar, los TBD vencidos y los riesgos altos del modelo.
  7. Abra Necesidades y requisitos → Requisitos. Las filas incluyen VR-1.1 sedanMass, un uso de requisito cuyo número es su nombre corto <'VR-1.1'>.
  8. Abra la herramienta Diagramas y abra driveCycleFlow, la vista de flujo de acciones de DriveCycle. Cambie allí el nombre de una acción y vuelva al Editor: VehicleBehavior muestra el nuevo nombre.

Consejos y errores comunes

  • Empiece por la demostración. Copiar patrones del texto de Hybrid Car es la forma más rápida de aprender la notación.
  • Importe las unidades. 5 [kg] necesita que SI sea visible (y MassValue necesita ISQ). Añada private import ISQ::*; y private import SI::*; al paquete.
  • Mantenga un modelo por proyecto. Divida un modelo grande en varios paquetes de nivel superior; cada uno es su propio documento en el Editor.
  • Elegir el tipo equivocado. El tipo no se puede cambiar en el propio proyecto. Cree una copia convertida desde Gestionar proyectos (⋯ → Crear una copia LML… o Crear una copia SysML v2…).
  • Esperar el estado en el texto. El estado de los requisitos, los resultados de verificación y las etiquetas son datos de Holarch. No aparecen en el texto ni en una exportación .sysml.

La barra lateral en los proyectos SysML v2

GrupoPáginas
InicioRequiere atención, Ciclo de vida, Próximas acciones y los demás paneles de Inicio
Necesidades y requisitosDocumentos, Requisitos, Calidad, TBD/TBR, Vínculos por revisar, Aprobaciones, Matriz de cumplimiento*
ModeloEditor, Navegador, Importación y exportación
ComportamientoAnálisis funcional, Flujos de acciones, FFBD, Máquinas de estados, Secuencias, Simulador
ArquitecturaPartes, Vistas generales, Vistas de interconexión, Jerarquía, Presupuestos y TPM
InterfacesRegistro de interfaces, ICD, Diagramas N², Elementos y E/S
VerificaciónRVTM, Casos de verificación, Desviaciones y exenciones*, Matriz de trazabilidad, Cobertura del programa, Comprobaciones del modelo
Seguridad y fiabilidad†Registro de peligros, AMFEC, Árboles de fallos, Diagramas de bloques de fiabilidad
Riesgos, incidencias y decisionesRegistro de riesgos, Diagramas de riesgos, Estudios de alternativas, Decisiones, Incidencias y acciones
PlanMi trabajo, Proceso de IS, Gestión de proyectos, Gráficos, Pizarras, Presentaciones
Control y revisionesSolicitudes de cambio, Líneas base y versiones, Bibliotecas, Revisiones, Actividad
Marcos de referenciaDoDAF, UAF

* Con el programa formal activado. † Con el programa de seguridad y fiabilidad activado. Ambos se activan en Preferencias del proyecto → Funciones del programa.

Las herramientas de la parte inferior de la barra de navegación son las mismas que en los proyectos LML: Base de datos, Diagramas, Papelera, Ajustes y Ayuda. En los proyectos SysML v2, Ajustes también incluye la Biblioteca estándar. Las páginas que no se aplican a los proyectos SysML v2 no se muestran.

Las páginas se describen en Vistas de SysML v2, Requisitos y verificación en proyectos SysML v2, Evaluación, unidades y análisis en proyectos SysML v2 y Funciones de Holarch en proyectos SysML v2.

Modo simple

El modo simple está pensado para quienes empiezan con SysML v2. Muestra los elementos con los que empiezan la mayoría de los modelos, explica cada uno en una frase y oculta el resto hasta que lo pida. Solo cambia lo que ve: el modelo, su texto y todas las exportaciones siguen igual.

Activarlo o desactivarlo

  • Preferencias → SysML v2 → Modo simple.
  • Modo simple en el encabezado de la página Modelo → Navegador (pulsado mientras está activado).
  • ⌘K / Ctrl+K → Activar modo simple o Desactivar modo simple.

Está desactivado de forma predeterminada. El ajuste pertenece a su cuenta: le acompaña en cualquier equipo en el que inicie sesión, y al iniciar sesión se aplica el ajuste de la cuenta. Restablecer preferencias no lo cambia.

La primera vez que abre un proyecto SysML v2, una nota bajo la barra superior dice ¿Es nuevo en SysML v2? Active el modo simple para ver primero los elementos más usados. Haga clic en Activar para activar el modo simple, o en × para descartar la nota. Cualquiera de las dos respuestas se guarda con su cuenta y la nota no vuelve a aparecer. Mientras no la responda, aparece cada vez que abre un proyecto SysML v2. No aparece si el modo simple ya está activado.

Qué muestra

Doce conceptos, los que más usan la demostración Hybrid Car y los tutoriales: paquete, parte, atributo, puerto, conexión e interfaz, acción, flujo y sucesión, estado, transición, requisito, satisfacción y verificación.

DóndeEn modo simpleOcultos hasta Mostrar todo
Vista general, panel AñadirPaquete, Definición de part, Part, Definición de port, Port, Atributo, Definición de interfaz, Definición de action, Action, Definición de requisito, Requisito, Caso de verificaciónDefinición de atributo, Definición de item, Definición de enumeración
Diagrama Spider, panel AñadirPaquete, Definición de part, Part, Definición de port, Port, Atributo, Definición de action, Action, Estado, Definición de requisito, Requisito, Caso de verificaciónDefinición de item, Item, Definición de atributo, Caso de uso
Vista de interconexión, panel AñadirPart, PortElemento
Vista de transición de estados, panel AñadirEstado inicial, Estado final, Estado, Acción de entrada, Acción do, Acción de salidaEstado paralelo, Región
Vista de flujo de acciones, panel Añadir y + Action ▾Action, Bifurcación, Unión, Decisión, Combinación, CalleAceptar, Enviar, Bucle, Terminar
Editor, Insertar ▾Paquete, Definición de part, Part, Atributo, Definición de port, Port, Interfaz, Conexión, Definición de action, Action, Sucesión, Flujo, Definición de estado, Estado, Estado inicial, Transición, Definición de requisito, Requisito, Satisfacer, Definición de verificación, VerificarTodos los demás fragmentos que encajan en la posición del cursor
Modelo → NavegadorPaquetes, definiciones, usos, conexiones, flujos, transiciones, requisitos, satisfy y verifyImportaciones, alias, exposiciones, comentarios, documentación, metadatos, paquetes de biblioteca, conectores de enlace (binding), elementos de nivel KerML, y las filas de disparador y efecto de una transición

Señale un elemento en un panel Añadir, o el tipo de una fila en el Navegador, para leer una explicación de una frase sobre ese elemento.

Las vistas de requisitos, casos de uso, paramétrica, secuencia, paquetes y geometría, y los paneles Jerarquía, Árbol, IDEF0 y FFBD conservan todos sus elementos: cada uno trata del tipo que añade. + Nuevo diagrama, las tablas, la búsqueda, el inspector y la escritura en el Editor (con autocompletado) no se filtran.

Mostrar todo

  • Paneles Añadir: Mostrar todo (n más) bajo los elementos; Mostrar menos los vuelve a ocultar.
  • + Action ▾: Mostrar todo… al final vuelve a abrir el menú con todos los tipos.
  • Insertar ▾: marque Mostrar todo en su encabezado.
  • Navegador: marque Mostrar todo en la barra de filtros.

Mostrar todo dura hasta que recarga la página o cambia el modo simple, y mientras tanto el modo simple sigue activado. En el Navegador, un elemento que abre desde otro lugar (por ejemplo, Mostrar en el Navegador en el inspector) se muestra siempre, junto con sus propietarios, aunque su tipo esté oculto.

Inicio

Inicio es la misma página que en los proyectos LML (consulte Inicio): Requiere atención (vínculos que revisar, TBD vencidos, pruebas fallidas, superaciones de TPM, riesgos altos, comprobaciones del modelo, estado de guardado), una tarjeta Ciclo de vida por grupo de la barra de navegación y paneles como Próximas acciones, Puerta del proceso de IS e Hitos. Los recuentos proceden del modelo SysML v2 y de los datos de Holarch que lo acompañan. ✦ Redactar resumen del proyecto no se ofrece en los proyectos SysML v2.

  • Los grupos de la barra de navegación muestran los mismos indicadores de problemas, y la página de resumen de cada grupo enumera lo que requiere atención y sus cifras.
  • + Añadir panel → Contenido del modelo muestra Paquetes (con el número de paquetes de nivel superior), Definiciones, Usos, Relaciones y Requisitos (n no satisfechos · n no verificados), elementos mal ubicados cuando hay elementos que han perdido su propietario, y Cambios recientes: los últimos cambios del modelo (creado, cambiado, movido, eliminado o restaurado) con el tipo del elemento y la hora.

Preguntar a la IA

Preguntar a la IA responde preguntas sobre el lenguaje SysML v2 y sobre el uso de Holarch, a partir de la Ayuda y la Documentación. En los planes Individual y Team, y con su propia clave de IA o la de su organización, también responde preguntas sobre el modelo abierto y propone cambios, que se abren para revisión antes de aplicarse. Consulte Preguntar a la IA.

Aún no disponible

  • Confirmar cambios en main, etiquetas y fusiones a través de la Systems Modeling API: otras herramientas confirman cambios en ramas de solicitudes de cambio, que un aprobador aplica en Holarch (consulte La API y MCP en proyectos SysML v2).
  • Editar el lenguaje: la biblioteca estándar es de solo lectura.

Notación textual de SysML v2 enumera en detalle el lenguaje admitido.

Mensajes

MensajeSignificado
El modelo está vacíoEl proyecto no tiene elementos. Haga clic en + Nuevo package y escriba sus miembros en el Editor.
No aplicado: corrija la línea N.El texto tiene un error en la línea N. El modelo conserva su último estado correcto hasta que el texto se analice sin errores.
Solo lectura: pida acceso de edición a un propietario.Tiene acceso de lectura al proyecto. El texto y las páginas son de solo lectura.
Este proyecto necesita una versión más reciente de Holarch.Una versión más reciente de Holarch guardó el proyecto, y esta página es más antigua. El proyecto se abre en modo de solo lectura y el aviso de la parte superior explica el motivo. Haga clic en Recargar en el aviso para obtener la nueva versión.

Límites

  • El tipo de proyecto se fija al crearlo.
  • Un modelo por proyecto.
  • Un documento de texto de más de 8 MB no se comprueba; divídalo en varios paquetes.

SysML® y OMG® son marcas registradas de Object Management Group, Inc. en los Estados Unidos y otros países.