Diagrams and Elements Spec

This program creates diagrams that strive for compatibility to

In some cases, it deviates from these standards for several reasons:

This section gives an overview on standards and implementation-status of crystal_facet_uml. It may be incomplete.

Classifiers

Classifiers are the nodes in the model-graph.

Spec

Concept

Filter

Comment

Block

SysML

I(+C)

-

Limitations: Compartment Order is "properties, operations" instead of "constraints, operations, receptions, parts, (bound) references, values, properties, stereotype-tagged-values, behavior, namespace, structure"

Limitations: No labeled compartments

Limitations: no Multiplicities of Block-Instances.

Constraint Property/Equation

SysML

dyn

-

Limitations: Only the rounded-rect symbol is supported, ports are not completely inside the rounded-rect.

Node

UML

I(+C)

-

Limitations: -

Component

UML

C(+I)

-

Limitations: -

Part

UML

I only

-

Limitations: -

Interface

UML

C(+I)

-

Limitations: -

Package

UML, SysML

C(+I)

-

Limitations: -

Class

UML

C(+I)

-

Limitations: -

Object

UML

I only

-

Limitations: -

Artifact

UML

I(+C)

-

Limitations: -

Comment

UML, SysML

I(+C)

unconditional features

Limitations: -

Feature

-

I(+C)

-

Represents a group of requirements

Requirement

SysML

I(+C)

-

Limitations: -

Actor

UML, SysML

C(+I)

unconditional features

Limitations: -

Use Case

UML, SysML

dyn

-

Limitations: No SysML extension points

System Boundary

UML, SysML

I(+C)

unconditional features

Limitations: -

Diagram Reference

UML

I(+C)

unconditional features

Limitations: -

Activity

UML

dyn

unconditional features

Limitations: -

Interruptable Region

UML

dyn

unconditional features

Limitations: -

Fork

UML, SysML

dyn

unconditional features

Limitations: -

Join

UML, SysML

dyn

unconditional features

Limitations: -

Accept Event

UML, SysML

dyn

unconditional features

Limitations: -

Accept Time Event

UML, SysML

dyn

unconditional features

Limitations: -

Send Signal

UML, SysML

dyn

unconditional features

Limitations: -

Decision

UML, SysML

dyn

unconditional features

Limitations: -

Initial Node

UML, SysML

dyn

unconditional features

Limitations: There is no distinction in ActivityInitial and FlowInitial

Final Node

UML, SysML

dyn

unconditional features

Limitations: There is no distinction in ActivityFinal and FlowFinal

State

UML, SysML

dyn

unconditional features

Limitations: -

Shallow History

UML, SysML

dyn

unconditional features

Limitations: -

Deep History

UML, SysML

dyn

unconditional features

Limitations: -

Value Type

SysML

C(+I)

-

not supported.

Limitations: Compartment Order of Classifiers is "properties, operations" instead of "operations, properties, stereotype-tagged-values"

Enumeration

UML, SysML

C(+I)

-

not supported.

Note: Use a class instead.

ActivityParameterNode

SysML

dyn

-

not supported.

MergeNode

UML, SysML

dyn

unconditional features

not supported.

Note: Either directly connect to the target activity or use a decision node.

ActivityPartition

UML, SysML

dyn

unconditional features

not supported.

Note: Use a parent activity instead.

Legend

Concept

Defines if the classifier can be abstract(class) and concrete (instance)

C

The classifier is an abstract concept that can be instantiated

I

The classifier is a concrete instance

dyn

The classifier describes dynamic behavior. Only the context of the diagram defines if a single-instance or a concept is described.

TODO Marker

Features

Features are elements attached to one classifier.

Spec

Scope

Comment

Property

UML, SysML

unconditional

Limitations: no SysML Flow-Properties refinement

Operation

UML, SysML

unconditional

Limitations: -

Port

UML, SysML

unconditional

Limitations: no SysML-compartment Notation supported

Limitations: no SysML-nested-ports, SysML-proxy-port, SysML full-ports supported

Provided Interface

UML, SysML

unconditional

Limitations: -

Required Interface

UML, SysML

unconditional

Limitations: -

Lifeline

UML, SysML

scenario, 1 per diagram

Limitations: One lifeline is visible only in one diagram

Legend

Scope

scope is unconditional if a feature belongs to a classifier unconditionally, scenario if only applicable in 1 diagram

Relationships

Relationships are the edges of the model-graph.

Spec

Diagram Types

Comment

Dependency

UML, SysML

any

Limitations: -

Containment

UML, SysML

Deployment, Package

Limitations: -

Deploy

UML

Deployment

Limitations: -

Manifest

UML

Deploy

Limitations: -

Communication Path

UML, SysML

Component, Use Case

Limitations: -

Association

UML, SysML

Class Diag

Note: SysML calls this ReferenceAssociation

Limitations: no AssociationClass(SysML: ParticipantProperty) exists.

Limitations: no AssociationEnd Classes exist, no Multiplicities, no Roles.

Aggregation

UML, SysML

Class Diag

Note: SysML calls this SharedAssociation

Limitations: -

Composition

UML, SysML

Class Diag

Note: SysML calls this PartAssociation

Limitations: -

Generalization

UML, SysML

Class Diag, Use Case

Limitations: no Generalization-Sets supported

Realization

UML

Class Diag

Limitations: -

Trace

SysML

Requirement

Limitations: -

Refine

SysML

Requirement

Limitations: -

Extend

UML, SysML

Use Case

Limitations: no SysML-condition-notes can be attched to this relationship

Include

UML, SysML

Use Case

Limitations: -

Control Flow

UML, SysML

Activity

Limitations: -

Object Flow

UML, SysML

Activity

Limitations: -

Async. Call

UML, SysML (?)

Sequence

Limitations: -

Sync. Call

UML, SysML (?)

Sequence

Limitations: -

Return Call

UML, SysML (?)

Sequence

Limitations: -

Connector

UML, SysML

Internal Block Diag.

not supported.

Limitations: No Bi-directional Connectors

Note: SysML calls this BindingConnector

Note: Use a Communication Path instead.

Item Flow

SysML

Block Definition

not supported.

Note: Use an Object Flow instead.

Diagrams

Diagrams are views on the model-graph. They select classifiers and may filter their features and relationships.

Spec

Filter

Comment

List Diagram

-

features, relationships

This is an overview diagram showing only classifiers without features and without relationships

Box Diagram

-

features, relationships

This is an overview diagram showing only classifiers without features and without relationships

Block Definition Diagram

SysML

lifelines

Internal Block Diagram

SysML

lifelines

Limitations: -

Parametric Diagram

SysML

lifelines

Limitations: -

Deployment Diagram

UML

lifelines

Limitations: -

Component Diagram

UML

lifelines

Limitations: -

Composite Structure Diagram

UML

lifelines

Limitations: -

Package Diagram

UML, SysML

lifelines

Limitations: -

Class Diagram

UML

lifelines

Limitations: -

Profile Diagram

UML

lifelines

not supported

Requirements Diagram

SysML

lifelines

Limitations: -

Use Case Diagram

UML, SysML

lifelines

Limitations: -

Interaction Overview Diagram

UML

lifelines

Limitations: There is no link from Diagram-References to referenced Diagrams

Activity Diagram

UML, SysML

lifelines

Limitations: -

State Machine Diagram

UML, SysML

lifelines

Limitations: -

Communication Diagram

UML

unconditional relationships except containments(ro), unconditional features (Scenario)

Limitations: -

Sequence Diagram

UML, SysML

unconditional relationships, unconditional features (Scenario)

Limitations: -

Timing Diagram

UML

unconditional relationships, unconditional features (Scenario)

Limitations: -

Legend

Filter

Defines which elements are not visible in the diagram

Scenario

Diagrams show only relationships associated with the lifeline of visible classifiers.

TODO Marker

Maximum stringlengths

All strings (names, descriptions, stereotypes) have a maximum length.

Ascii characters require one, most other characters two bytes. Current sizes in bytes are:

Classifiers:

  • DATA_CLASSIFIER_MAX_NAME_LENGTH = 47,

  • DATA_CLASSIFIER_MAX_STEREOTYPE_LENGTH = 47,

  • DATA_CLASSIFIER_MAX_DESCRIPTION_LENGTH = 4095,

Features:

  • DATA_FEATURE_MAX_KEY_LENGTH = 47, (name)

  • DATA_FEATURE_MAX_VALUE_LENGTH = 255, (type)

  • DATA_FEATURE_MAX_DESCRIPTION_LENGTH = 1023,

Relationships:

  • DATA_RELATIONSHIP_MAX_NAME_LENGTH = 47,

  • DATA_RELATIONSHIP_MAX_DESCRIPTION_LENGTH = 1023,

Diagrams:

  • DATA_DIAGRAM_MAX_NAME_LENGTH = 47,

  • DATA_DIAGRAM_MAX_DESCRIPTION_LENGTH = 8191,