Category Component 26.1
Category Component Help

# Create a Cluster Map

You can use the ClusterMapFromResults action to create a map of the clusters that you generate from your query.

You provide XML-formatted cluster information to ClusterMapFromResults as the value of the ImportXML parameter, and the action returns a 2-D cluster map as binary image data. The file is by default in JPEG format, but (as in the case of the ClusterServe2DMap action) you can specify another format by setting the PictureFormat configuration parameter in the `[Cluster]` section of the Content component configuration file.

ClusterMapFromResults also creates and stores a new set of cluster results that includes the map coordinates of the clusters. If your application uses these cluster results to support mouse-over effects when displaying the cluster map, you can retrieve the results by using the ClusterResults action. In this case, use the TargetJobName from the ClusterMapFromResults action as the SourceJobName in the ClusterResults action.

When you use the ImportXML parameter to send data to ClusterMapFromResults, you must use the following format:

    <?xml version='1.0' encoding='UTF-8' ?>
    <autn:clusters xmlns:autn='http://schemas.autonomy.com/aci/'>
        <autn:numclusters>5</autn:numclusters>
        <autn:cluster>
            <autn:title>MyClusterTitle</autn:title>
            <autn:score>5.63</autn:score>
            <autn:term>CAT~[85]</autn:term>
            <autn:term>DOG~[76]</autn:term>
            <autn:term>RABBIT~[65]</autn:term>
            <autn:term>HAMST~[64]</autn:term>
            <!-- more terms -->
            <autn:docs>
                <autn:numdocs>3</autn:numdocs>
                <autn:doc>
                    <autn:title>MyDocTitle</autn:title>
                    <autn:ref>http://foo.com</autn:ref>
                    <autn:score>5</autn:score>
                <autn:doc>
            <!-- more docs-->
            </autn:docs>
        </autn:cluster>
        <!-- more clusters-->
    </autn:clusters>

This XML format is similar to the format of the XML results of a `Query` action. If you pass this data to the ClusterMapFromResults action in the ImportXML parameter, you must first percent-encode it.

NOTE: As an alternative to providing XML data to ClusterMapFromResults, you can provide it with a job name from a previous ClusterCluster action.

Related Topics

- Generate a Cluster Map after You Cluster

Copyright 2025 Open Text
Version 26.1 | Last updated January 2026

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 MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Category Component 26.1

Topic Title: Create a Cluster Map