Some parts of this website may do not work correctly, because your browser doesn't support JavaScript or you have disabled it. In order to use all features please enable JavaScript in your browser.

Specification for annotator > converter > joiner

joiner

Joiner combines all the edges matching one tag mask ("left" mask given with --left-mask option) with all the edges spanning the same pair of vertices, having the same parent edge and matching another tag mask (--right-mask option). In other words, joiner generates a Cartesian product of two sets of edges for the same pair of vertices and the same parent edge.

In a way, joiner generates a sort of left outer join for edges ("outer" means that a new edge is generated also for "left" edges, for which no "right" edges were found, outer join can be switched off with --no-outer-join option).

If you want to generate additional new edge for every "left" edge, even if some "right" edges were found for it, use the option --extended-outer-join.

By default the new edge inherits the text and the category field from the "left" edge and inherits attributes from both the "left" and "right" edges. This could be changed with appropriate options.

Generated edges are labelled with tags specified with the --out-tags option.

Options

Allowed options:
  --lang arg (=guess)      language
  --force-language         force using specified language even if a text was 
                           resognised otherwise
  --left-mask arg          tag mask specification for the "left" mask
  --right-mask arg         tag mask specification for the "right" mask
  --out-tags arg           tags for generated edges
  --take-right-text        take the text field from the "right" edge (by 
                           default, the left one is used)
  --take-right-category    take the text field from the "right" edge (by 
                           default, the right one is used
  --take-left-attributes   take only attributes from the "left" edge (by 
                           default the attributes from the "left" one and the 
                           "right" one are merged
  --take-right-attributes  take only attributes from the "right" edge
  --no-outer-join          switch off "outer" join
  --extended-outer-join    switch on "extended" outer join

Other help resources