On Mon, Dec 10, 2007, Shai Erera wrote about "Performance Improvement for Search using PriorityQueue": > Hi > > Lucene's PQ implements two methods: put (assumes the PQ has room for the > object) and insert (checks whether the object can be inserted etc.). The > implementation of insert() requires the application that uses it to allocate > a new object every time it calls insert. Specifically, it cannot reuse the > objects that were removed from the PQ.
I've read this entire thread, and would like to add my comments about three independent issues, which I think that can and perhaps should be considered separately: 1. When Shai wanted to add the insertWithOverflow() method to PriorityQueue he couldn't just subclass PriorityQueue in his application, but rather was forced to modify PriorityQueue itself. Why? just because one field of that classi - "heap" - was defined "private" instead of "protected". Is there a special reason for that? If not, can we make the trivial change to make PriorityQueue's fields protected, to allow Shai and others (see the next point) to add functionality on top of PriorityQueue? 2. PriorityQueue, in addition to being used in about a dozen places inside Lucene, is also a public class that advanced users often find useful when implementing features like new collectors, new queries, and so on. Unfortunately, my experience exactly matches Shai's: In the two occasions where I used a PriorityQueue, I found that I needed such a insertWithOverflow() method. If this feature is so useful (I can't believe that Shai and me are the only ones who found it useful), I think it would be nice to add it to Lucene's PriorityQueue, even if it isn't (yet) used inside Lucene. Just to make it sound more interesting, let me give you an example where I needed (and implemented) an "insertWithOverflow()": I was implementing a faceted search capability over Lucene. It calculated a count for each facet value, and then I used a PriorityQueue to find the 10 best values. The problem is that I also needed an "other" aggregator, which was supposed to aggregate (in various ways) all the facets except the 10 best ones. For that, I needed to know which facets dropped off the priorityqueue. 3. Finally, Shai asked for this new PriorityQueue.insertWithOverflow() to be used in TopDocCollector. I have to admit I don't know how much of a benefit this will be in the "typical" case. But I do know that there's no such thing as a "typical" case... I can easily think of a quite typical "worst case" though: Consider a collection indexed in order of document age (a pretty typical scenario for a long-running index), and then you do a sorting query (TopFieldDocCollector), asking it to bring the 10 newest documents. In that case, each and every document will have a new DocScore created - which is the worst-case that Shai feared. It would be nice if Shai or someone else could provide a measurement in that case. P.S. When looking now at PriorityQueue's code, I found two tiny performance improvements that could be easily made to it - I wonder if there's any reason not to do them: 1. Insert can use heap[1] directly instead of calling top(). After all, this is done in an if() that already ensures that size>0. 2. Regardless, top() could return heap[1] always, without any if(). After all, the heap array is initialized to all nulls, so when size==0, heap[1] is null anyway. > PriorityQueue change (added insertWithOverflow method) > ----------------------------------------------------------------------------------- > /** > * insertWithOverflow() is similar to insert(), except its return value: > it > * returns the object (if any) that was dropped off the heap because it > was > * full. This can be the given parameter (in case it is smaller than the > * full heap's minimum, and couldn't be added) or another object that > was > * previously the smallest value in the heap and now has been replaced > by a > * larger one. > */ > public Object insertWithOverflow(Object element) { > if (size < maxSize) { > put(element); > return null; > } else if (size > 0 && !lessThan(element, top())) { > Object ret = heap[1]; > heap[1] = element; > adjustTop(); > return ret; > } else { > return element; > } > } > [Very similar to insert(), only it returns the object that was kicked out of > the Queue, or null] -- Nadav Har'El | Tuesday, Dec 11 2007, 3 Tevet 5768 IBM Haifa Research Lab |----------------------------------------- |A professor is one who talks in someone http://nadav.harel.org.il |else's sleep. --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]