TRAIL: Theory and best practices for the Webel Parsing Analysis recipe for SysMLv1.6+

Icon class

icon_class_computed

fas fa-chalkboard-teacher

Quick start

Top-level Package/Model organisation for the Source Input Zone

Keywords

This tutorial assumes at least some experience with Systems Modeling Language v1 (SysML^®). To learn SysML^® please attend our comprehensive course:

Course: Model-Based Systems Engineering with the OMG's Systems Modeling Language® (v1) and the MagicDraw/Cameo (CATIA Magic™) tools for SysML

This tutorial explains the theory behind the Webel Parsing Analysis recipe for SysML^®. This trail is a good introduction for the following complementary tutorial trails:

TRAIL: Webel SysML Parsing Analysis example: Optical telescopes from Wikipedia: Structure and port-based light flow model

TRAIL: Webel SysML Parsing Analysis example: A particle physics taxonomy from Wikipedia

In Webel Parsing Analysis tutorials, Wikipedia pages are often used as a placeholder sources to represent authoritative domain source documents from which text extract "snippets" are sourced, and from which SysML model elements are traceably elicited.

It may help if you've already explored the following section within the main Webel tutorial for SysMLv1.x, although most of the concepts covered there will be covered during this trail anyway (and in more detail):

18:01: Logical grouping with the ElementGroup extension of Comment in SysMLv1.x

We'll be referencing "super-relational" Policy Notes for the recipe as we go along, and we'll also be employing some of the more general Webel Best Practice modelling policies. Note especially that:

The Webel Parsing Analysis recipe for SysML1.x does not use the ElementGroup directly, it extends it as a user-defined Snippet stereotype with keyword «snippet» and with MagicDraw Customization.

Webel Parsing Analysis: typically the quoted extract text (body) of a «snippet» is a short phrase, a sentence, or a couple of short sentences (but not dozens of sentences).

For this relatively academic trail we'll be analysing first the following famous pangram:

Wikipedia: '"The quick brown fox jumps over the lazy dog" is an English-language pangram — a sentence that contains all of the letters of the English alphabet. '

Start here

Top-level Package/Model organisation for the Source Input Zone

Sections

Slides in this trail

If you want to navigate the entire tutorial including the additional explanatory text, click on the title link of the first slide to view the full slide page, then use the next links to move through the slides pages. If you just want to view the slide images only in sequence, click on any slide to view it larger in a viewer, then click again to move through each slide in the tutorial trail.

Top-level Package/Model organisation for the Source Input Zone

Containment tree view of members of a «snippet» ElementGroup in MagicDraw/Cameo

Focus PAD for the Snippet 'The quick brown fox jumps over the lazy dog'

Focus BDD for block FoxDogPangramContext

Focus PAD for the Snippet ''an English-language pangram — a sentence that contains all of the letters of the English alphabet'

Focus BDD for block EnglishPangram

PAD for eliciting the letters of an English-language pangram

Focus BDD for block FoxDogPangram

Package Diagram index of Source Input Zone and elicited model elements in the Target Model Zone

Simplified profile for Webel Parsing Analysis for SysML1.6+ in MagicDraw/Cameo (adapt as required)

«pa:term»: Dealing with synonyms, alternative names, and identifiers

«pa:triple»: Pseudo semantic triples (c.f. RDF/S and OWL)

A «pa:implied» Element: Include a tagged value for at least one Snippet that implies it

Indicating relationships between Snippets using tagged values: contradicts/contradictedBy

More on tracking contradictions: Optical telescope example

Webel Parsing Analysis as a meta-process: Snippets before Requirements!

Using Trace to quickly elicit model elements from an identified figure, drawing, diagram, plot, graphic, or table from a domain source document

Using a generic MagicDraw/Cameo query table to track /tracedTo for any NamedElement type using a derived relationship

REFERENCE CARD: Webel Parsing Analysis for SysML1.x: Auxiliary stereotypes

REFERENCE CARD: Webel Parsing Analysis for SysML1.x: Snippet Customizations

Please email or phone Webel IT Australia on +61 405 029 008 to arrange On-Site, Off-Site, or Live Online remote web training seminars and workshops.

Course: Model-Based Systems Engineering with the OMG's Systems Modeling Language® (v1) and the MagicDraw/Cameo (CATIA Magic™) tools for SysML