# Pattern syntax

A Pattern is defined through 3 different parts that are all optional.

• at most one positive clause introduced by keyword pattern which describes a positive pattern that must be found in the graph.
• any number of negative clauses introduced by the keyword without; each clause filters out a subpart of the matchings previously selected.
• [Since version 1.2] at most one global clause introduced by the keyword global which filters out a subpart of graphs.

The global matching process is:

• Take a graph and a pattern as input.
• Output a set of matchings; a matching being a function from nodes and edges defined in the positive clause to nodes and edges of the host graph.

• If the graph does not satisfied one of the global constrains, the output is empty.

• Else the set M is initialised as the set of matchings which satisfies the positive pattern.

• For each negative clause, matchings which satisfies the negative pattern are removed from M.
• Output M.

Note that if there is more than one negative matchings, there are all interpreted independently.

The basic syntax of patterns in grew can be learned using the tutorial part of the Grew-match tool.

## Positive and negative patterns

Positive and negative patterns both follow the same syntax. These patterns are described by a list of clauses: node clauses, edge clauses and additional constraints

### Node clauses

In a node clause, a node is described by an identifier and some constraints on the feature structure.

N [upos = VERB, Mood = Ind|Imp, Tense <> Fut, Number, !Person, lemma = "être" ]


The clause above illustrated the syntax of constraint that can be expressed, in turn:

• upos = VERB requires that the feature upos is defined with the value VERB
• Mood = Ind|Imp requires that the feature Mood is defined with one of the two values Ind or Imp
• Tense <> Fut requires that the feature Tense is defined with the value different from Fut
• Number requires that the feature Number is defined whatever is its value
• !Person requires that the feature Person is not defined
• lemma = "être" quotes are required when non-ASCII characters are used

### Edge clauses

All edge clauses below require the existence of an edge between the node selected by N and the node selected by M, evntually with additional constraints:

• N -> M : no additional constrains
• N -[nsubj]-> M: the edge label is nsubj
• N -[nsubj|obj]-> M: the edge label is either nsubj or obj
• N -[^nsubj|obj]-> M: the edge label is different from nsubj and obj
• N -[re".*subj"]-> M: the edge follows the regular expression (see here for regular expressions accepted)

Edge may also be named for future use (in commands for instance) with an identifier:

• e: N -> M : no additional constrains

Note that edge may refer to undeclared nodes, these nodes are then implicitly declared with any constraint. For instance, the two patterns below are equivalent:

pattern { N -[nsubj]-> M }

pattern { N[]; M[]; N -[nsubj]-> M }


Since version 1.2, more complex edges can be used, see here.

These constrains do not identify new elements in the graph, but must be respected.

• Constraints on features values:
• N.lemma = M.lemma two feature values must be equal
• N.lemma <> M.lemma two feature values must be different
• N.lemma = re".*ing" the value of a feature must follow a regular expression (see here for regular expressions accepted)
• Constraints on node ordering:
• N < M the node N immediately precedes the node M
• N << M the node N precedes the node M
• Constraints on edges:
• * -[nsubj]-> M there is an incoming edge with label nsubj with target M
• M -[nsubj]-> * there is an outgoing edge with label nsubj with source M
• [Since version 1.3] Constraints on edge labels:
• label(e1) = label(e2) the labels of the two edges e1 and e2 are equal
• label(e1) <> label(e2) the labels of the two edges e1 and e2 are different

When two or more nodes are equivalent in a pattern, each occurrence of the pattern in a graph will be found several times (up to permutation in the sets of equivalent nodes). For instance, in the pattern below, the 3 nodes N1, N2 and N3 are equivalent.

pattern { N1 -[ARG1]-> N; N2 -[ARG1]-> N; N3 -[ARG1]-> N; }


This pattern is found 120 times in the Little Prince corpus (Grew-match) but there are only 20 different occurrences, each one is reported 6 times with all permutations on N1, N2 and N3. To avoid this, a constraint id(N1) < id(N2) can be used. It imposes an ordering on some internal representation of the nodes and so avoid these permutations.

The pattern below returns the 20 expected occurrences (Grew-match)

pattern {
N1 -[ARG1]-> N; N2 -[ARG1]-> N; N3 -[ARG1]-> N;
id(N1) < id(N2); id(N2) < id (N3);
}


## Global pattern

Global patterns were introduced in version 1.2 to let the user express constrain about the whole graph. Currently, constraints may be expressed with a fixed list of keywords. We plan to add more constraints in the near future. Please drop us a feature request if you like to suggest one. We describe below 4 of the constraints available in version 1.2. For each one, its negation is available by changing the is_ prefix by the is_not_ prefix.

• is_cyclic: the graph satisfied this constrain if and only if it contains a cycle. A cycle is a list of nodes N1, N2N(k-1), Nk such that there are edges N1 -> N2, N2 -> N3, N(k-1) -> Nk, Nk -> N1. In graph theory, a non cyclic graph is also called a Directed Acyclic Graph (DAG).

• is_forest: the graph satisfied this constrain if and only it is acyclic and if there are no couples of edges with the same target. In other words, a graph is a forest if and only if it is acyclic and each node has at most one incoming edge.

• is_tree: a graph is a tree if it is a forest and if it have exactly one root.

• is_projective: the usual notion of projectivity defined on tree is generalized by saying the a structure is projective if there are no 4-tuples (A, B, C, D) of ordered nodes (i.e. A << B, B << C and C << D) such that A and C are linked and B and D are linked (two nodes are linked when there is at least one edge between the two, whatever is the orientation).