Results > Customize Results > Automatic Query Guidance > About the QuerySummary Parameter

About the QuerySummary Parameter
To execute an action with the QuerySummary parameter, add these parameters to your Query, Suggest or SuggestOnText action:
 
IDOL server identifies the three most relevant terms and phrases of the clustered phrases, and returns them in an <autn:querysummary> field. It also returns a list of the specified QuerySummaryLength number of the best terms and phrases.
If multiple sections in a result document match the query, IDOL server displays only the section with the highest conceptual similarity (rather than returning different sections of the same result document). This increases the relevance of the final phrases.
The purpose of the query is to provide query guidance, but not return results at the same time. Printing the results slows IDOL server performance.
Enter the number of results from which to generate the clustered terms and phrases. IDOL server can produce good quality clusters only if it has enough result documents available. However, setting MaxResults too high can slow the query performance (a sensible maximum value may be 50–500).
For example:
http://IDOLhost:port/action=Query&Text=Apollo&QuerySummary=true&Combine=Simple& Print=NoResults&MaxResults=100
In this example, if QuerySummaryLength is set to 10 in the configuration file, IDOL server clusters the results that the query produces and lists the top 10 relevant terms or phrases that the results contain:
<autn:element pdocs="52" poccs="108" cluster="0" docs="56">Apollo program</autn:element>
<autn:element pdocs="29" poccs="83" cluster="0" docs="34">Neil Armstrong</autn:element>
<autn:element pdocs="22" poccs="43" cluster="0" docs="27">command module</autn:element>
<autn:element pdocs="18" poccs="61" cluster="0" docs="54">Lunar Module</autn:element>
<autn:element pdocs="13" poccs="13" cluster="1" docs="13">Greek mythology</autn:element>
<autn:element pdocs="15" poccs="22" cluster="2" docs="35">Royal Navy</autn:element>
<autn:element pdocs="22" poccs="28" cluster="2" docs="26">HMS Apollo</autn:element>
<autn:element pdocs="14" poccs="21" cluster="0" docs="14">moon landings</autn:element>
<autn:element pdocs="8" poccs="8" cluster="2" docs="9">Leander-class frigate</autn:element>
<autn:element pdocs="12" poccs="14" cluster="1" docs="15">Greek god Apollo</autn:element>
The information for the top phrases and terms in the clusters that IDOL server has generated consists of these elements:
 
The number of the cluster that the phrase falls into. A negative number indicates that the associated documents do not fall into any of the generated clusters.
For example:
<autn:element pdocs="52" poccs="108" cluster="0" docs="56">Apollo program</autn:element>
In this example, the phrase “Apollo program” occurs in 52 documents out of the 100 results. The phrase appears 108 times in total in these documents. The phrase falls into cluster 0.
The terms “Apollo” and “program” appear in 56 documents.
IDOL server also returns the best phrases or terms of the top three clusters in a comma-separated list in the <autn:querysummary> field:
<autn:querysummary>Apollo program, Greek mythology, Royal Navy</autn:querysummary>
You can use each of these top cluster phrases as an alternative query, as well as the less relevant terms and phrases in each cluster.