Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "VIATRA2/Examples/VTCL/GraphPattern"
(→Pattern Matching Semantics) |
(→Pattern Matching Semantics) |
||
(4 intermediate revisions by 4 users not shown) | |||
Line 3: | Line 3: | ||
=== Pattern Matching Semantics === | === Pattern Matching Semantics === | ||
− | |||
− | |||
Patterns may be composed in VTCL a complex way by using the '''find''' construct. | Patterns may be composed in VTCL a complex way by using the '''find''' construct. | ||
Moreover, the injectivity of pattern matching can be further controlled by using the new '''shareable''' keyword as follows: | Moreover, the injectivity of pattern matching can be further controlled by using the new '''shareable''' keyword as follows: | ||
− | * '''Injective pattern matching (default)''': the default behavior of the pattern matcher is that two | + | * '''Injective pattern matching (default)''': the default behavior of the pattern matcher is that two pattern variables cannot be bound to the same value (i.e. element in the model space). Explicit pattern variable assignments (in the form of '''A=B''') can enforce that the two variables do take the same value during pattern matching. |
* '''Shareable (or non-injective) pattern matching''': the injectivity condition is not checked for local pattern variables (thus two variables may be bound to the same value) unless a non-injectvity constraint (in the form of '''A =/= B''') is prescribed explicitly for a pair of variables. | * '''Shareable (or non-injective) pattern matching''': the injectivity condition is not checked for local pattern variables (thus two variables may be bound to the same value) unless a non-injectvity constraint (in the form of '''A =/= B''') is prescribed explicitly for a pair of variables. | ||
Line 14: | Line 12: | ||
a simple state machine formalism (with states as entities and transitions as relations), which potentially contain loop transitions (where the source and target state of a transition is the same). | a simple state machine formalism (with states as entities and transitions as relations), which potentially contain loop transitions (where the source and target state of a transition is the same). | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | // A and B | + | // A and B should be different, i.e. loop transitions are not matched |
− | + | pattern childPatternInj1(A, B) = { | |
− | + | state(A); | |
− | + | state.transition(T, A, B); | |
− | + | state(B); | |
− | } | + | } |
− | // | + | // A and B may be equal, loop transitions are matched |
− | pattern | + | shareable pattern childPatternSha1(A, B) = { |
− | + | state(A); | |
− | } | + | state.transition(T, A, B); |
+ | state(B); | ||
+ | } | ||
− | // Equivalent match set with childPatternInj1: A =/= B | + | // Equivalent match set with childPatternInj1: A =/= B |
− | + | pattern childPatternInj2(A, B) = { | |
− | + | find childPatternSha1(A, B); | |
− | + | } | |
− | } | + | |
− | + | ||
− | And now, let us present some more complex | + | // Equivalent match set with childPatternInj1: A =/= B |
+ | shareable pattern childPatternSha2(A, B) = { | ||
+ | find childPatternSha1(A, B); | ||
+ | A =/= B; | ||
+ | } | ||
+ | |||
+ | And now, let us present some more complex scenarios. As a general rule, the caller (parent) pattern | ||
may prescribe additional injectivity constraints for the local variables. | may prescribe additional injectivity constraints for the local variables. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | // Constraints: X =/= Y, Y =/Z, X =/= Z (thanks to the injectivity of the parent pattern) | + | // Constraints: X =/= Y, Y =/Z, X =/= Z (thanks to the injectivity of the parent pattern) |
− | pattern | + | pattern parentPattern1(X, Y, Z) = { |
− | + | find childPatternInj1(X, Y); | |
− | + | find childPatternInj1(Y, Z); | |
− | } | + | } |
− | // Constraints: X =/= Y, Y =/Z, X =/= Z (thanks to the injectivity of the parent pattern) | + | // Constraints: X =/= Y, Y =/Z, X =/= Z (thanks to the injectivity of the parent pattern) |
− | pattern | + | pattern parentPattern2(X, Y, Z) = { |
− | + | find childPatternInj1(X, Y); | |
− | + | find childPatternSha1(Y, Z); | |
− | } | + | } |
− | // Constraints: X =/= Y, Y =/Z (thanks to the injectivity of the | + | // Constraints: X =/= Y, Y =/Z, X =/= Z (thanks to the injectivity of the parent pattern) |
− | + | pattern parentPattern3(X, Y, Z) = { | |
− | + | find childPatternSha1(X, Y); | |
− | + | find childPatternSha1(Y, Z); | |
− | } | + | } |
− | // Constraints: X =/= Y (thanks to the injectivity of the child pattern) | + | // Constraints: X =/= Y, Y =/Z (thanks to the injectivity of the child pattern) |
− | shareable pattern | + | shareable pattern parentPattern4(X, Y, Z) = { |
− | + | find childPatternInj1(X, Y); | |
− | + | find childPatternInj1(Y, Z); | |
− | } | + | } |
− | // Constraints: | + | // Constraints: X =/= Y (thanks to the injectivity of the child pattern) |
− | shareable pattern | + | shareable pattern parentPattern5(X, Y, Z) = { |
− | + | find childPatternInj1(X, Y); | |
− | + | find childPatternSha1(Y, Z); | |
− | } | + | } |
− | + | ||
− | + | // Constraints: none | |
+ | shareable pattern parentPattern6(X, Y, Z) = { | ||
+ | find childPatternSha1(X, Y); | ||
+ | find childPatternSha1(Y, Z); | ||
+ | } |
Revision as of 20:02, 24 September 2010
Overview: Graph patterns
Pattern Matching Semantics
Patterns may be composed in VTCL a complex way by using the find construct. Moreover, the injectivity of pattern matching can be further controlled by using the new shareable keyword as follows:
- Injective pattern matching (default): the default behavior of the pattern matcher is that two pattern variables cannot be bound to the same value (i.e. element in the model space). Explicit pattern variable assignments (in the form of A=B) can enforce that the two variables do take the same value during pattern matching.
- Shareable (or non-injective) pattern matching: the injectivity condition is not checked for local pattern variables (thus two variables may be bound to the same value) unless a non-injectvity constraint (in the form of A =/= B) is prescribed explicitly for a pair of variables.
The following examples highlight the semantic corner cases using of pattern composition and injective pattern matching. As a example, we use a simple state machine formalism (with states as entities and transitions as relations), which potentially contain loop transitions (where the source and target state of a transition is the same).
// A and B should be different, i.e. loop transitions are not matched pattern childPatternInj1(A, B) = { state(A); state.transition(T, A, B); state(B); }
// A and B may be equal, loop transitions are matched shareable pattern childPatternSha1(A, B) = { state(A); state.transition(T, A, B); state(B); }
// Equivalent match set with childPatternInj1: A =/= B pattern childPatternInj2(A, B) = { find childPatternSha1(A, B); }
// Equivalent match set with childPatternInj1: A =/= B shareable pattern childPatternSha2(A, B) = { find childPatternSha1(A, B); A =/= B; }
And now, let us present some more complex scenarios. As a general rule, the caller (parent) pattern may prescribe additional injectivity constraints for the local variables.
// Constraints: X =/= Y, Y =/Z, X =/= Z (thanks to the injectivity of the parent pattern) pattern parentPattern1(X, Y, Z) = { find childPatternInj1(X, Y); find childPatternInj1(Y, Z); }
// Constraints: X =/= Y, Y =/Z, X =/= Z (thanks to the injectivity of the parent pattern) pattern parentPattern2(X, Y, Z) = { find childPatternInj1(X, Y); find childPatternSha1(Y, Z); }
// Constraints: X =/= Y, Y =/Z, X =/= Z (thanks to the injectivity of the parent pattern) pattern parentPattern3(X, Y, Z) = { find childPatternSha1(X, Y); find childPatternSha1(Y, Z); }
// Constraints: X =/= Y, Y =/Z (thanks to the injectivity of the child pattern) shareable pattern parentPattern4(X, Y, Z) = { find childPatternInj1(X, Y); find childPatternInj1(Y, Z); }
// Constraints: X =/= Y (thanks to the injectivity of the child pattern) shareable pattern parentPattern5(X, Y, Z) = { find childPatternInj1(X, Y); find childPatternSha1(Y, Z); }
// Constraints: none shareable pattern parentPattern6(X, Y, Z) = { find childPatternSha1(X, Y); find childPatternSha1(Y, Z); }