Skip to main content

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.

Jump to: navigation, search

Difference between revisions of "VIATRA2/Examples/VTCL/GraphPattern"

< VIATRA2‎ | Examples‎ | VTCL
(Pattern Matching Semantics)
(Pattern Matching Semantics)
(9 intermediate revisions by 4 users not shown)
Line 3: Line 3:
 
=== Pattern Matching Semantics ===
 
=== Pattern Matching Semantics ===
  
<source lang="text">
 
pattern parentPattern1(X, Y, Z) = {
 
}
 
  
sharedvar pattern parentPattern2(X, Y, Z) = {
+
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.
  
pattern childPattern1(A, B) = {
+
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).
  
sharedvar pattern childPattern2(A, B) = {
 
  
}
+
  // A and B should be different, i.e. loop transitions are not matched
</source>
+
  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);
 +
  }

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);
 }

Back to the top