# CategoryPartition

Allows you to divide up a specified set of documents into several partitions, with every document being assigned to a partition. This option is similar to clustering, but it addresses all documents in a query set. When the partitions have been created, IDOL Server generates a title for each partition.

You can create categories from your partitions, in a similar way to the CategoryImportFromCluster action.

## Example

    http://12.3.4.56:9000/action=CategoryPartition&DREQuery=finance&NumResults=1000&NumPartitions=10

This action partitions 1,000 documents related to the query `finance` into 10 partitions.

## Required Parameters

The following action parameters are required.

Parameter | Description
--- | ---
DREQuery | The query whose results you want to partition.
NumResults | The number of result documents to partition.

## Optional Parameters

This action accepts the following optional parameters.

Parameter | Description
--- | ---
CreateCategories | Whether to create categories from the partitions.
NumPartitions | The number of partitions that you want to put documents into.
Parent | The parent category in which to create the new categories.
PartitionMaxTerms | The maximum number of terms that a partition can have.

This action accepts the following standard ACI action parameters.

Parameter | Description
--- | ---
ActionID | A string to use to identify an ACI action.
EncryptResponse | Encrypt the output.
FileName | The file to write output to.
ForceTemplateRefresh | Forces the server to load the template from disk.
Output | Writes output to a file.
ResponseFormat | The format of the action output.
Template | The template to use for the action output.
TemplateParamCSVs | A list of variables to use for the specified template.

_FT_HTML5_bannerTitle.htm