SysML v2
Tutoriales de SysML v2
Nueve tutoriales guiados para proyectos SysML v2, desde el primer paquete hasta puertos, acciones, estados, requisitos, verificación, restricciones y variantes, con un panel de pasos que comprueba su trabajo.
En esta página
Holarch tiene una serie de tutoriales guiados para proyectos SysML v2. Cada uno crea un pequeño proyecto inicial SysML v2 y abre un panel de pasos junto a la página. El panel comprueba el modelo mientras trabaja: un paso se pone verde cuando el modelo tiene lo que el paso pide. Esta página enumera todos los pasos como texto, de modo que también puede seguirlos desde aquí.
El primer tutorial usa la WS-1 Weather Station, como los tutoriales de LML. Los demás construyen partes de un coche híbrido, el modelo de la demostración Hybrid Car: tipos de valor y componentes, los puertos e interfaces del tren motriz, un ciclo de conducción, los estados del tren motriz, los requisitos del coche, su verificación, las comprobaciones de los valores del sedán y la línea de productos. Cada tutorial tiene su propio proyecto inicial, así que puede hacerlos en cualquier orden. Todos los proyectos iniciales y todos los tutoriales terminados se comprueban con 0 problemas.
| Tutorial | Tiempo | Aprenderá a |
|---|---|---|
| Primeros pasos | 15 min | escribir texto SysML v2, verlo como árbol y como vista, dibujar en la vista y añadir un requisito |
| Definiciones y atributos | 20 min | escribir enumeraciones, tipos de valor y definiciones abstractas, especializar con valores y unidades, y usar el autocompletado, Insertar y el cambio de nombre |
| Puertos e interfaces | 20 min | definir puertos e interfaces, conjugar puertos, conectar partes y dibujar una interfaz en una vista de interconexión |
| Acciones y flujos | 20 min | escribir definiciones de acción y un ciclo de conducción con una bifurcación, flujos y una unión, añadir calles y construir pasos en el FFBD |
| Estados y transiciones | 20 min | escribir señales y una máquina de estados con disparadores, guardas y acciones de estado, y dibujar una transición temporizada |
| Requisitos | 20 min | escribir límites, definiciones y usos de requisitos, satisfacerlos y ver un requisito que no se cumple |
| Verificación y trazabilidad | 15 min | escribir un caso de verificación, trazar un paso en la Matriz de trazabilidad y derivar un requisito |
| Restricciones y cálculos | 20 min | escribir restricciones y cálculos, enlazar valores en una vista paramétrica, ejecutar un caso de análisis y marcar valores TBD y TBR |
| Variantes y configuraciones | 15 min | escribir variaciones y variantes, una línea de productos con una regla, configuraciones y una palabra clave propia |
Cómo usarlo
Iniciar un tutorial de SysML v2
- Abra Ayuda → Tutoriales en la barra de navegación, o pulse ⌘K / Ctrl+K y escriba
tutorial. Fuera de un proyecto, la página Tutoriales enumera primero los tutoriales de LML y después Tutoriales para proyectos SysML v2. Dentro de un proyecto SysML v2 solo enumera los tutoriales de SysML v2. - Haga clic en Iniciar en una tarjeta. Holarch crea el proyecto, por ejemplo Tutorial: SysML v2 Ports and Interfaces (Hybrid Car), y lo abre con el panel de pasos a la derecha.
El panel de pasos funciona como en los tutoriales de LML: Mostrarme resalta el control que necesita un paso, Ir allí abre la página, Leer más abre el tema de Ayuda, y Reiniciar…, Marcar como hecho y × funcionan igual. Consulte Tutoriales.
Escribir el texto de un paso
La mayoría de los pasos indican texto SysML que se escribe en Modelo → Editor. El paso dice dónde van las líneas, por ejemplo «antes de la última llave de cierre del paquete». El texto se aplica al modelo cuando deja de escribir; el estado bajo el editor lo indica y el paso se pone verde.
- Escriba las líneas tal como se muestran. La sangría no importa para el modelo; el Editor conserva la suya.
- Un subrayado rojo marca un error: señálelo para leer el mensaje. El texto con un error de sintaxis queda como borrador y no se aplica hasta que lo corrija.
- ⌘Z / Ctrl+Z deshace el último cambio aplicado.
Consejos
- La primera vez, haga los tutoriales en orden: cada uno explica el texto que usa, y los posteriores dan por sabidas las ideas anteriores (definiciones y usos,
:>y:>>). - Un paso que sigue abierto suele tener una errata en un nombre. Compare su texto con las líneas del paso; en SysML v2 los nombres distinguen mayúsculas de minúsculas.
- Los tutoriales enseñan el mismo lenguaje que Conceptos básicos de SysML v2; la página Notación textual tiene los detalles.
Primeros pasos
Escriba un primer modelo de la Weather Station: abra el texto, añada una definición de part con un valor y una unidad, úsela en otra definición, vea el modelo en el Navegador y en una vista general, dibuje una parte en la vista y vea cómo aparece en el texto, añada un requisito con satisfy y exporte el modelo como archivo .sysml. Los pasos se describen en Primeros pasos con proyectos SysML v2.
Definiciones y atributos
El proyecto inicial tiene el paquete Vehicles con una definición de part, Car.
- Abra el paquete. Haga clic en Modelo → Editor. Cada declaración es una palabra clave y un nombre, seguidos de un cuerpo entre llaves o de un punto y coma.
- Escriba una enumeración. Encima de
part def Car {, añadaenum def DriveMode { enum economy; enum normal; enum sport; }(un valor por línea). - Defina un tipo de valor. Debajo, añada
attribute def TirePressure :> ScalarValue;.:>significa «especializa». - Escriba una definición abstracta. Añada
abstract part def Componentcon un comentariodocy los atributosmass : MassValue,partNumber : Stringypower : PowerValue.//inicia una nota que solo queda en el texto. - Deje que el comprobador encuentre un error. Añada
part def Battery :> Componentconattribute redefines mass = 45 [kg];y, a propósito,attribute redefines power = 60 [kg];. El comprobador subraya la unidad: los kilogramos no son una potencia. - Corrija la unidad. Cámbiela a
60 [W]. - Complete un nombre. En la batería, escriba
attribute capacity : Ener, acepteEnergyValuede la lista de autocompletado con Enter y termine con;. - Búsquelo en la Biblioteca estándar. Haga clic en Ajustes → Biblioteca estándar en la parte inferior de la barra de navegación y escriba
EnergyValueen el cuadro de búsqueda. - Inserte una definición. En el Editor, pulse ⌃⇧Space / Ctrl+Shift+Space (o haga clic en Insertar ▾) en una línea vacía, elija Definición de part y complete
part def Engine :> Componentconattribute redefines mass = 110 [kg];yattribute cylinders : Integer;. - Use las definiciones. En
Car, añadaattribute mode : DriveMode;,part battery : Battery;ypart engine : Engine;. - Cambie el nombre en todas partes. Sitúe el cursor en
cylinders, pulse F2 y cámbielo acylinderCount.
Puertos e interfaces
El proyecto inicial tiene los componentes del tren motriz con sus puertos de par y de potencia, las definiciones de port TorquePort y PowerPort, y las definiciones de interfaz Shaft y HighVoltageBus.
- Defina un puerto. Encima de
port def TorquePort, añadaport def FuelPortconout attribute flowRate : Real;yattribute kind : FuelKind;.outsignifica que el valor sale de la parte propietaria del puerto. - Dé puertos a las partes. Añada
port fuelOut : FuelPort;aFuelTankyport fuelIn : ~FuelPort;aEngine.~conjuga el puerto: entrada y salida se invierten. - Defina una interfaz. Añada
interface def FuelLine { end supply : FuelPort; end consumer : ~FuelPort; }. - Construya el tren motriz. Al final del paquete, añada
part def Powertraincon las partestank,engine,motor,batteryytransmission, un puertooutput : TorquePortybind output = transmission.output;. - Conecte dos partes. En el tren motriz, añada
interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;. - Añada los ejes. Añada
interface engineShaft : Shaft connect engine.output to transmission.engineIn;yinterface motorShaft : Shaft connect motor.output to transmission.motorIn;. - Cree una vista de interconexión. Haga clic en Arquitectura → Vistas de interconexión y después en + Nuevo diagrama. Elija
Powertrainen Muestra y haga clic en Crear. - Dibuje una interfaz. Arrastre desde el tirador del puerto
powerOutde la batería hasta el puertopowerIndel motor y suelte sobre Interface : HighVoltageBus. - Ponga nombre a la interfaz. Seleccione la nueva línea e introduzca
hvBuscomo su Nombre en el inspector. - Véalo en el texto. Haga clic en Modelo → Editor: la interfaz está en el tren motriz, con su nombre, su tipo y sus extremos.
Acciones y flujos
El proyecto inicial tiene el paquete VehicleBehavior con los items Fuel y Torque, las funciones ProduceTorque (F.2) y DriveWheels (F.3), y tres definiciones de part.
- Defina una función. Añada
action def <'F.1'> SupplyFuelconin attribute fuelDemand : Real;yout item fuel : Fuel;. El nombre corto entre corchetes angulares es el número de la función. - Escriba el ciclo de conducción. Añada
action def <'F'> DriveCycleconfirst start then split;,fork split;,then supply;,then produce;y los pasosaction supply : SupplyFuelyaction produce : ProduceTorque, cada uno con unaduration. - Añada un flujo. En el ciclo de conducción, añada
flow of Fuel from supply.fuel to produce.fuel;. - Una las ramas. Añada
first supply then ready;,first produce then ready;,join ready;,then action drive : DriveWheels { … },then done;yflow produce.torque to drive.torque;. - Cree una vista de flujo de acciones. Haga clic en Comportamiento → Flujos de acciones, después en + Nuevo diagrama, y elija
DriveCycleen Muestra. - Indique quién realiza cada paso. Añada
part def DrivenCarconperform action trip : DriveCycle;y las partestank,engineytransmission, cada una conperform trip.supply;,perform trip.produce;operform trip.drive;. La vista recibe una calle por parte. - Abra Análisis funcional. Haga clic en Comportamiento → Análisis funcional, haga clic en Elegir… y seleccione
DriveCycle. - Declare otra acción. Añada
action def EmergencyShutdown;. - Construya pasos en el FFBD. Haga clic en Comportamiento → FFBD, después en + Nuevo diagrama, y elija
EmergencyShutdown. En el panel Añadir, escribaOpen Contactorsy pulse Enter, y despuésCut Fuel. - Vea los pasos en el texto. Haga clic en Modelo → Editor: el FFBD escribió los pasos y sus sucesiones.
Estados y transiciones
El proyecto inicial tiene el paquete PowertrainBehavior con una part def Car vacía.
- Defina las señales. Añada
attribute def StartRequest;, yStopRequest,PlugInyUnplugde la misma forma. - Escriba una definición de estado. Añada
state def PowertrainStatesconin attribute charge : Real;,entry; then off;y los estadosoff,electricyhybrid. - Añada transiciones. Después de
state off;, añadaaccept StartRequest if charge > 20 then electric;yaccept StartRequest then hybrid;. - Dé acciones a un estado. Sustituya
state electric;por un cuerpo que contengaentry action spinUpMotor;,do action driveElectric;yexit action holdMotor;. - Salga del estado eléctrico. Después de él, añada
if charge < 15 then hybrid;yaccept StopRequest then off;; añada tambiénaccept StopRequest then off;después destate hybrid;. - Añada un estado con transiciones con nombre. Añada
state charging { do action chargeBattery; },transition plugIn first off accept PlugIn then charging;ytransition unplugged first charging accept Unplug then off;. - Cree una vista de transición de estados. Haga clic en Comportamiento → Máquinas de estados, después en + Nuevo diagrama, y elija
PowertrainStatesen Muestra. - Dibuje una transición temporizada. Arrastre desde el tirador de
charginghastaoffy suelte sobre Transición. En el panel de la transición, introduzca el Nombrechargedy el Disparadorafter 30 [min]. - Véalo en el texto. Haga clic en Modelo → Editor: la transición está escrita como una transición con nombre.
- Haga que el coche exhiba los estados. En
Car, añadaexhibit state powertrainStates : PowertrainStates;.
Requisitos
El proyecto inicial tiene el paquete VehicleRequirements con una pequeña copia del diseño: Battery, Car y el sedan de la flota, con una masa en vacío de 1580 kg.
- Ponga nombre a los límites. Añada
attribute maxCurbMass : MassValue = 1650 [kg];yattribute minBatteryCapacity : EnergyValue = 1.2 [kW*h];. - Escriba una definición de requisito. Añada
requirement def <'VR-1'> CurbMasscon un enunciadodoc,subject car : Car;,attribute limit : MassValue;yrequire constraint { car.curbMass <= limit }. - Inserte un requisito. Pulse ⌃⇧Space / Ctrl+Shift+Space en una línea vacía, elija Definición de requisito y escriba
VR-3 BatteryCapacitycon el sujetobattery : Batteryyrequire constraint { battery.capacity >= minBatteryCapacity }. - Anide requisitos en una especificación. Añada
requirement carSpecconsubject car : Car;yrequirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; }. - Indique qué los satisface. Añada
satisfy carSpec by fleet.sedan;ysatisfy requirement batterySpec : BatteryCapacity by fleet.sedan.battery;. - Incumpla un requisito. Cambie la masa en vacío del sedán a
1700 [kg]. El Editor marca el satisfy: el sedán ya no cumple VR-1.1. - Vuelva a cumplirlo. Pulse ⌘Z / Ctrl+Z, o vuelva a cambiarla a
1580 [kg]. - Vea la tabla de requisitos. Haga clic en Necesidades y requisitos → Requisitos.
- Cree una vista de requisitos. En la página Diagramas, haga clic en + Nuevo diagrama, elija Vista de requisitos y
carSpecen Muestra. - Compruebe los enunciados. Haga clic en Necesidades y requisitos → Calidad y en Comprobar calidad.
Verificación y trazabilidad
El proyecto inicial tiene el requisito de masa en vacío y la especificación del coche, un ciclo de conducción con los pasos cruise y brake, VR-6 batteryMassLimit y VR-7 stopFromCruise.
- Escriba un caso de verificación. Añada
verification def <'VC-1'> CurbMassTestconsubject car : Car;,objective massObjective { verify carSpec.sedanMass; }yreturn verdict : Boolean = car.curbMass <= maxCurbMass;. - Aplíquelo al sedán. Añada
verification <'VC-1.1'> sedanWeighing : CurbMassTest { subject car = fleet.sedan; }. - Abra los casos de verificación. Haga clic en Verificación → Casos de verificación. Los pasos, los resultados y el estado son datos de Holarch junto al modelo. En la fila de Sedan Weighing, haga clic en + Pasos y después en + Añadir paso, escriba
Weigh the caren Action y haga clic en Aplicar. Después haga clic en Aprobados en sus botones de estado. - Lea la RVTM. Haga clic en Verificación → RVTM.
- Trace un paso hasta un requisito. Haga clic en Verificación → Matriz de trazabilidad, muestre los requisitos como filas y las acciones como columnas, haga clic en la celda de
stopFromCruiseybrakey elija satisfied by. - Derive un requisito. Añada
private import RequirementDerivation::*;yconnection batteryMassDerivation : Derivation connect carSpec.sedanMass to batteryMassLimit;. - Ejecute las comprobaciones del modelo. Haga clic en Verificación → Comprobaciones del modelo.
Restricciones y cálculos
El proyecto inicial tiene el paquete VehicleAnalysis con el motor, la batería, el coche y los valores del sedán, y los objetivos maxCurbMass y minPowerToWeight.
- Escriba una definición de restricción. Añada
constraint def MassLimitconin mass : MassValue;,in limit : MassValue;y la expresiónmass <= limit. - Escriba un cálculo. Añada
calc def PowerToWeightcon los parámetrospowerymassyreturn ratio = power / mass;. - Enlace los valores del sedán. Añada
constraint sedanMassCheck : MassLimit { in mass = fleet.sedan.curbMass; in limit = maxCurbMass; }. - Cree una vista paramétrica. En la página Diagramas, haga clic en + Nuevo diagrama, elija Vista paramétrica y
VehicleAnalysisen Muestra. La comprobación se supera: 1580 kg está dentro de 1650 kg. - Haga que la comprobación falle. Cambie la masa en vacío del sedán a
1700 [kg]; la vista muestra que la comprobación falla. - Haga que vuelva a superarse. Deshaga el cambio, o vuelva a cambiarla a
1580 [kg]. Resolver todo vuelve a comprobar todas las restricciones. - Ejecute un caso de análisis. Añada
analysis def PowerToWeightAnalysiscon un objetivo que exijaratio >= minPowerToWeight, yanalysis sedanPowerToWeight : PowerToWeightAnalysis { subject car = fleet.sedan; }. - Marque los valores abiertos. Añada
private import HolarchMetadata::*;y el requisito VR-5ChargeTimecon#TBRen su límite de tiempo y@TBDcon un responsable, una fecha límite y una justificación en la potencia del cargador.TBDyTBRproceden de la bibliotecaHolarchMetadatade Holarch, no de la biblioteca estándar de SysML v2; especializan los metadatos estándarStatusInfo. - Abra el registro de TBD/TBR. Haga clic en Necesidades y requisitos → TBD/TBR. El tiempo de carga aparece con el responsable y la fecha límite de sus metadatos
@TBD. El registro es de solo lectura: cambie el responsable o la fecha en los metadatos, en el Editor. - Sume la masa. Haga clic en Arquitectura → Presupuestos y TPM y seleccione la parte raíz
sedan.
Variantes y configuraciones
El proyecto inicial tiene Component, Battery, Controller, Car y Powertrain.
- Importe el paquete de variabilidad. Añada
private import HolarchVariability::*;. - Escriba una variación. En una línea vacía, pulse ⌃⇧Space / Ctrl+Shift+Space (o haga clic en Insertar ▾), elija Variación y complete
variation part def BatteryPack :> Batterycon las variantesstandardPack(1,4 kWh) ylargePack(12 kWh, 120 kg). - Escriba la línea de productos. Añada
part def CarLine :> Carconpart pack : BatteryPack;, unavariation part chargercon las variantesnoChargerywallbox, yassert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack }. - Inicie una configuración. Elija Insertar ▾ → Configuración y complete
part plugInHybrid : CarLine { @HolarchConfiguration; }. El Editor indica los puntos de variación que siguen abiertos. - Elija las variantes. En
plugInHybrid, elija Insertar ▾ → Elección de variante para cada punto y completepart :>> pack = BatteryPack::largePack;ypart :>> charger = charger::wallbox;. - Añada una segunda configuración. Añada
selfChargingHybridde la misma forma, con el paquete de baterías estándar y sin cargador. - Defina una palabra clave propia. Añada
metadata def <safetyCritical> SafetyCritical. - Use la palabra clave. En
Powertrain, escriba#safetyCritical part controller : Controller;. - Vea la línea de productos. Cree una vista general de
Vehicles: el paquete de baterías aparece marcado como variación.
Proyectos de tutorial
Los proyectos de tutorial de SysML v2 siguen las mismas reglas que los demás proyectos de tutorial: no cuentan para los proyectos activos de su plan, admiten hasta 300 elementos y puede tener uno por tutorial. Consulte Tutoriales.
Relacionado
- Tutoriales
- Primeros pasos con proyectos SysML v2
- El editor de texto y el explorador
- Notación textual
- Vistas
- Requisitos en proyectos SysML v2
SysML® y OMG® son marcas registradas de Object Management Group, Inc. en los Estados Unidos y otros países.