Holarch

SysML v2 Projects

Variants and Configurations

A product line is one design with points where its products differ. Each variation point lists its variants (the allowed choices); a configuration is one product, with one variant chosen for each point. Rules (assert constraints of the product line) rule combinations out.

part def CarLine :> Car { part pack : BatteryPack; // a point: BatteryPack is a variation definition variation part charger : Component { // a point with its own variants variant part noCharger; variant part wallbox; } assert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack } } part plugInHybrid : CarLine { @HolarchConfiguration; part :>> pack = BatteryPack::largePack; part :>> charger = charger::wallbox; }

Create a configuration

  • In the Browser, open the row menu (⋯) of the product line, or of its Configurations group, and choose New Configuration…. The inspector's Product Line section and ⌘K / Ctrl+K (New Configuration…) open the same dialog.
  • Check Configures (the product line), enter a Name, and choose one variant for each point under Variant choices. The line below says at once whether the choice meets the rules: Valid, Breaks the rule …, Incomplete or Unknown.
  • Click Create. The configuration is written into the text next to the product line, marked @HolarchConfiguration, and a single Undo takes it all back.

See and change choices

  • Browser: icons mark product lines (stacked boxes), variation points (a diamond), variants (a filled diamond) and configurations (sliders); a product line lists its configurations in a Configurations group, wherever they are declared. Screen readers hear the same, for example plugInHybrid, part, configuration of CarLine.
  • Inspector, product line: its variation points with their variants, its rules, each configuration with its verdict, how many combinations the rules allow, and New Configuration….
  • Inspector, configuration: one list per variation point. Choosing another variant rewrites the binding in the text (a single Undo takes it all back); a choice that adds an error is refused. The status names the rules it breaks or the points still open; Show in View ▾ opens a view of the product line shown as this configuration.
  • Inspector, variation point or variant: its variants, or what it is a variant of, and which configurations choose it.

View as Configuration

  • View as ▾ in the top bar (it reads All configurations ▾) appears once the model has a configuration. Choose a configuration to see the model as that product: in General, Interconnection and Grid Views the variants it does not choose and the other configurations are hidden, and each variation point shows its choice (pack : BatteryPack = largePack). The Database, the inspector and the Product Line page follow the same choice.
  • A banner under the top bar names the configuration and how many elements apply, with Change ▾ and Leave. The choice is kept for this browser tab. View as ▾ → Effectivity ▸ shows the model at a serial number, a build date, or both (Serial Number and Date…).
  • On the Individual and Team plans you can edit in a configuration view: a choice writes the binding, a changed value becomes the configuration's own, new parts belong to it, and deleting an optional inherited element writes [0] for it, each checked first and taken back with a single Undo. A risk, task or other Holarch item created in the view applies to that configuration. On the Free plan the view is read only.
  • The Grid's Table leaves the hidden elements out and names the choices above the table; its Matrix shows the whole product line.
  • A Reliability Block Diagram counts only the variant the configuration chooses at each variation point. With all configurations shown, a variation point is one block with its own values, since its variants are alternatives.
  • Not yet: releasing or retiring a SysML v2 configuration. Every SysML v2 configuration is Draft.

Model Checks

Verification → Model Checks reports each configuration that breaks a rule or leaves a variation point without a variant (ProductLine.3, an error), with the verdict as its note, for example Breaks the rule wallboxNeedsLargePack; the broken rules are listed as related elements.

Trade studies

On a trade study, + From Product Line… adds a product line's configurations, or a variation point's variants, as alternatives (Trade Studies in SysML v2 Projects).

In the Hybrid Car demo, CarLine has the points pack and charger, three configurations (plugInHybrid, selfChargingHybrid, longRangeHybrid) and one rule; the views carLineVariants and carLineConnections show it, and the trade study Configuration Line-up (TR-2) compares its configurations. See also SysML v2 Basics.