IDOL 12.13

# Worked Examples

In all cases, the response of a `QuerySummary` query is not designed to be presented to an end user in raw form. It is the interpretation and filtering of the elements that solves a problem or presents useful functionality.

The following XML is an example of results for a query for the term Apollo. This section gives some ideas on how you might use the elements.

    <autn:querysummary>Apollo program, Greek mythology, Apollo Theater</autn:querysummary>
       <autn:qs>
          <autn:element pdocs="498"poccs="1734"cluster="-1"docs="498">Apollo</autn:element>
          <autn:element pdocs="53"poccs="75"cluster="0"docs="115">Apollo program</autn:element>
          <autn:element pdocs="47"poccs="99"cluster="0"docs="55">lunar module</autn:element>
          <autn:element pdocs="36"poccs="60"cluster="0"docs="38">Space Shuttle</autn:element>
          <autn:element pdocs="29"poccs="43"cluster="0"docs="50">lunar orbit</autn:element>
          <autn:element pdocs="25"poccs="31"cluster="0"docs="82">Apollo spacecraft</autn:element>
          <autn:element pdocs="47"poccs="60"cluster="1"docs="55">Greek mythology/autn:element>
          <autn:element pdocs="55"poccs="244"cluster="0"docs="55">Gemini/autn:element>
          <autn:element pdocs="20"poccs="24"cluster="2"docs="33">Apollo Theater/autn:element>
          <autn:element pdocs="20"poccs="23"cluster="0"docs="20">Neil Armstrong/autn:element>
          <autn:element pdocs="19"poccs="25"cluster="0"docs="55">Apollo Missions/autn:element>
          <autn:element pdocs="19" poccs="31" cluster="1" docs="77">Mount Olympus</autn:element>
          <autn:element pdocs="18" poccs="25" cluster="0" docs="68">space flight</autn:element>
          <autn:element pdocs="16" poccs="29" cluster="0" docs="32">lunar surface</autn:element>
          <autn:element pdocs="23" poccs="30" cluster="0" docs="88">manned mission</autn:element>
          <autn:element pdocs="29" poccs="69" cluster="0" docs="29">Skylab</autn:element>
          <autn:element pdocs="13" poccs="14" cluster="0" docs="15">Buzz Aldrin</autn:element>
          <autn:element pdocs="12" poccs="12" cluster="1" docs="33">ancient Greek</autn:element>
          <autn:element pdocs="9" poccs="13" cluster="0" docs="36">American astronaut</autn:element>
          <autn:element pdocs="9" poccs="12" cluster="0" docs="12">Eugene Cernan</autn:element>
          <autn:element pdocs="15" poccs="24" cluster="0" docs="57">NASA astronaut</autn:element>
          <autn:element pdocs="44" poccs="98" cluster="0" docs="44">Saturn</autn:element>
          <autn:element pdocs="8" poccs="14" cluster="0" docs="10">Jim Lovell</autn:element>
          <autn:element pdocs="8" poccs="11" cluster="0" docs="28">John Young</autn:element>
          <autn:element pdocs="5" poccs="8" cluster="2" docs="5">Grammy Awards</autn:element>
          <autn:element pdocs="4" poccs="11" cluster="-4" docs="77">Apollo Records</autn:element>
          <autn:element pdocs="4" poccs="9" cluster="-4" docs="4">Super Bowl</autn:element>
          <autn:element pdocs="4" poccs="5" cluster="-4" docs="21">music group</autn:element>
          <autn:element pdocs="5" poccs="5" cluster="2" docs="14">Apollo Theater in Harlem</autn:element>
          <autn:element pdocs="5" poccs="6" cluster="-4" docs="83">number one</autn:element>
          <autn:element pdocs="3" poccs="4" cluster="-4" docs="10">record companies</autn:element>
       </autn:qs>

- Dynamic Thesaurus. To return a Dynamic Thesaurus of elements that allows a user to refine the query, simply list the elements in the order that they return. Again, you can tailor it to fit your purposes:

  - To return a fixed number, for example the top 10, display the first 10 results that do not have negative clusters.

        Apollo program, lunar module, Space Shuttle,s lunar orbit, Apollo spacecraft, Greek mythology, Gemini, Apollo Theater, Neil Armstrong, Apollo missions

  - To vary the number of elements, return them according to a sensible limit. For example, return all values that occur in more than 10 documents (`pdocs` more than 10), again ignoring those with negative cluster numbers.

        Apollo program, lunar module, Space Shuttle, ... Ancient Greek, NASA astronaut, Saturn

- Query Refinement. To refine the query, you can send a new query (for example `Apollo AND "lunar module"`), or you can use the IDs (returned when you configure `QuerySummaryIDs`) to return the documents in the set that contained that element.

- Automatic Query Disambiguation. To return separate conceptual topics that occur in the query results, use the cluster number. In this case, you can extract and present the top elements of each cluster. You might also add the next few elements in each cluster to elaborate on each topic:

      Apollo program    (lunar module, Space Shuttle)

      Greek mythology   (Mount Olympus, ancient Greek)

      Apollo Theater    (Grammy Awards, Apollo Theater in Harlem)

- Dynamic Clustering. To fully partition your results set into conceptual topics, you can use the cluster number in combination with the IDs returned when `QuerySummaryIDs` is configured. For example, go down the list of elements and assign each document ID to the indicated cluster unless it is already assigned to a different cluster.

  TIP: For more information about when you might use this clustering method for your data, see Cluster Data and Dynamic Clustering.

© Copyright 2022 Micro Focus or one of its affiliates
Version 12.13 | Last updated October 2022

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL 12.13

Topic Title: Worked Examples