Manage clusters

Once you have generated clusters, the Manage clusters page lets you review them, reorganize their elements and clean up cluster runs before exporting.

clusters

Layout

The page is split in two parts:

  • on the left, every cluster run of the project is listed, each with its clusters underneath, shown with a thumbnail, their label and their number of elements,

  • on the right, the elements of the currently selected cluster are displayed, grouped by their original folder.

Clicking on a cluster in the left panel loads its elements on the right.

Cluster runs

A cluster run is a group of clusters generated together, through a single cluster generation. Next to its name, two actions are available:

  • the green + icon adds a new, empty cluster to that run,

  • the red trash icon deletes the whole cluster run.

Deleting a cluster run removes all its clusters. The elements that were part of them are not deleted, only unlinked from any cluster. This action is irreversible.

Editing a cluster

Every cluster can be renamed and described by clicking the pencil icon next to it, in the left panel. This opens a modal where you can edit its label and description, both displayed above its elements on the right.

Moving elements between clusters

The elements of a cluster are displayed 50 at a time by default, grouped by their original folder. The number of elements per page can be changed with the dropdown above the elements list, and is remembered by your browser. Each element card shows its type as a tag (such as page or line), and its Score tag, when present, describes the distance between the element and the cluster core elements.

Select the elements to move, as described below. The number of selected elements is displayed above the elements list, next to a dropdown listing every other cluster of the project, including clusters from other cluster runs. Pick a target cluster and click Move to reassign the selected elements to it.

Selecting elements

Selecting elements works like in a file manager:

  • click on an element card to select it, and click on it again to deselect it,

  • shift+click on an element to select every element between the last one you clicked and this one, above or below it. When you have not clicked any element of the current page yet, the range starts from the top of the page,

  • shift+click on an element that is already selected to deselect every element between the last one you clicked and this one, whether they were selected or not,

  • click and drag from anywhere in the elements list to draw a rectangle: every element it touches is selected,

  • shift and drag to draw a red rectangle instead: every element it touches is deselected.

Selected elements are outlined in green.

Checkboxes also select whole groups of elements at once. They are empty when none of their elements is selected, show a dash when only some of them are, and a check mark when all of them are:

  • the checkbox next to a folder name selects every element of that folder displayed on the current page. Click on it again, once all of them are selected, to deselect them,

  • the checkbox above the elements list, next to the selection counter, selects every element of the cluster, including the ones on the other pages. Click on it again, once all of them are selected, to clear the whole selection.

Shift+click on any of these checkboxes to directly deselect all of its elements, whatever its state.

Your selection is kept while you browse through the pages of a single cluster, but is cleared as soon as you select another cluster. Apart from the cluster checkbox, every way of selecting elements only applies to the elements displayed on the current page, so you can change the number of elements per page to select more of them at once.

After a move, the thumbnails of both the source and target clusters are regenerated in the background, so they may take a moment to reflect the change.

Re-clustering elements from existing clusters

To iterate on the clustering process, you can select existing clusters on the left panel by clicking on the checkbox, then start a new clustering using their elements by clicking on the ▶︎ symbol at the top of the left panel.

re cluster

You will then be prompted to enter the parameters for HDBscan clustering. Once the task has run, the selected clusters will be removed and a new cluster run will be created from the elements.

re cluster form

Next step

Once you have moderated your clusters, you can export them.