Custom tokenization and Lucene's FastVectorHighlighter

NOTE: The approach described below is wrong, you may want to read the follow-up post.

Perhaps you have tackled this before: you wanted to use Lucene's FastVectorHighlighter (aka FVH), but since you have a custom CharFilter in your analysis chain, the highlighter fails to produce valid fragments.

In my particular case, I used HTMLStripCharFilter (available to Lucene.Net through my pet contrib project) to extract text content from HTML pages, and then pass it through the rest of the analysis process. This confused FVH, since it was taking the full content from store, where HTML was still present, and token positions were not taking that into account. And any other custom CharFilter that is added to the analysis chain is going to cause the same troubles.

To overcome this, I needed to make sure FVH is aware of all content stripping operations that are made before or while tokenization is happening. All I had to do was to implement a custom FragmentsBuilder, looking as follows (.Net code; a Java version would look almost identical):

[code lang="csharp"] public class HtmlFragmentsBuilder : BaseFragmentsBuilder { /// <summary> /// a constructor. /// </summary> public HtmlFragmentsBuilder() : base() { } /// <summary> /// a constructor. /// </summary> /// <param name="preTags">array of pre-tags for markup terms</param> /// <param name="postTags">array of post-tags for markup terms</param> public HtmlFragmentsBuilder(String[] preTags, String[] postTags) : base(preTags, postTags) { } /// <summary> /// do nothing. return the source list. /// </summary> public override List<WeightedFragInfo> GetWeightedFragInfoList(List<WeightedFragInfo> src) { return src; } protected override String GetFragmentSource(StringBuilder buffer, int[] index, Field[] values, int startOffset, int endOffset) { string fieldText; while (buffer.Length < endOffset && index[0] < values.Length) { fieldText = GetFilteredFieldText(values[index[0]]); if (index[0] > 0 && values[index[0]].IsTokenized() && fieldText.Length > 0) buffer.Append(' '); buffer.Append(fieldText); ++(index[0]); } var eo = buffer.Length < endOffset ? buffer.Length : endOffset; return buffer.ToString().Substring(startOffset, eo - startOffset); } /// <summary> /// Gets the field text, after applying custom filtering /// </summary> /// <param name="field"></param> /// <returns></returns> protected string GetFilteredFieldText(Field field) { var theStream = new MemoryStream(Encoding.UTF8.GetBytes(field.StringValue())); var reader = CharReader.Get(new StreamReader(theStream)); reader = new HTMLStripCharFilter(reader); int r; var sb = new StringBuilder(); while ((r = reader.Read()) != -1) { sb.Append((char)r); } return sb.ToString(); } } [/code]

FVH will then need to be configured to use it:

[code lang="csharp"] var fvh = new FastVectorHighlighter(FastVectorHighlighter.DEFAULT_PHRASE_HIGHLIGHT, FastVectorHighlighter.DEFAULT_FIELD_MATCH, new SimpleFragListBuilder(), new HtmlFragmentsBuilder()); // ... var fq = fvh.GetFieldQuery(query); var fragment = fvh.GetBestFragment(fq, searcher.GetIndexReader(), hits[i].doc, "Content", 300); [/code]

If you're using Lucene.Net, you'll have to make sure this patch is applied to your FVH before this could compile.

That was the easiest way to get this working, and fast. Perhaps I could make it more generic, or change the original implementation to allow that and submit it as a patch. Maybe I'll do it someday. Or you could...


  • DIGY

    FVH works well with custom analyzers too. If you use the same analyzer while indexing & searching there should be no need for HtmlFragmentsBuilder. e.g. public class HtmlStripAnalyzer : Analyzer { public override TokenStream TokenStream(string fieldName, TextReader reader) { return new LowerCaseFilter(new WhitespaceTokenizer(new HTMLStripCharFilter(Lucene.Net.Analysis.CharReader.Get(reader)))); } }

  • DIGY

    Do you think, I sent it without testing? Yes the content loaded by FVH is HTML but the analyzer knows the tokens startoffset & length in HTML. Therefore Highlighting on HTML content is possible.

  • Yuval

    Itamar, please see Sujit Pal's approach to customizing the FVH (in Java, but the principle is similar):

  • FastVectorHighlighter issues revisited &laquo; Code972

    [...] a previous post I described how to use FVH to highlight contents which went through filters / readers like [...]

Comments are now closed