> For the complete documentation index, see [llms.txt](https://helpdocs.conducttr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpdocs.conducttr.com/labs/free-apps/colibri/colibri-analyser.md).

# Colibri Analyser

The **Colibri Analyser** is a dashboard for exploring the Colibri report CSV file: upload the file, slice it with filters, visualise responses, and decode multiple-choice answers.

<figure><img src="/files/YNaW6SUGiydy9LyvVgh4" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
No assessment data is saved in this app. You can save assessment schema but your Colibri data is never saved.
{% endhint %}

### Exercises: your workspaces

An **exercise** is a saved workspace. **Each exercise keeps its own filters, saved correlations, and report settings, so you can keep different analyses cleanly separated.**

* On the **Select an Exercise** screen, click **Create exercise** to start a new one and give it a name
* Click an existing exercise to open it
* Use the delete control to remove exercises you no longer need

Everything you configure inside an exercise (filters, saved correlations, settings) is stored automatically and will be there when you come back.

### Uploading a CSV file

Once you're inside an exercise, you'll see the upload area.

1. **Drag and drop** your CSV file onto the dashed dropzone, or **click to browse** for it
2. A *"Processing file…"* spinner appears while the file is read
3. The dashboard populates as soon as parsing finishes

A few things to know:

* Your file is parsed **entirely in your browser**
* To swap in a different file, click **New File** in the header to clear the current data and start over

<figure><img src="/files/f4DuTNS4q5EpZMVWq52I" alt=""><figcaption></figcaption></figure>

### Filtering and searching data

The data table shows every respondent and their answers. There are two ways to narrow it down.

#### Quick search

Use the **search bar** to instantly filter the table by email address.

#### Advanced filters

Click `Filters` to open the filter builder, where you can create precise rules:

1. Click `+ Rule` to create a condition
2. Choose a **column**, a **comparator**, and a **value**
3. Add as many rules as you need. Use `+ Group` to nest conditions together
4. Toggle each group between **AND** and **OR** logic to control how rules combine
5. Click NOT next to any rule to invert it (e.g. turn "equals" into "does not equal" without changing the comparator)

The table updates live as you build your filter, and a "Showing X of Y rows" count appears so you can see at a glance how much the filter has narrowed things down.

**Comparators explained:**&#x20;

<table><thead><tr><th width="304.20001220703125">Comparator</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Equals / Does not equal</strong></td><td>Exact match (or exclusion) on the full value</td></tr><tr><td><strong>Contains / Does not contain</strong></td><td>Matches if the value appears anywhere in the field</td></tr><tr><td><strong>Starts with / Ends with</strong></td><td>Matches the beginning or end of the value</td></tr><tr><td><strong>Greater than / Less than</strong></td><td>Numeric comparison</td></tr><tr><td><strong>Greater than or equal to / Less than or equal to</strong></td><td>Numeric comparison, inclusive</td></tr><tr><td><strong>Is empty / Is not empty</strong></td><td>Matches blank fields, or fields with any value</td></tr></tbody></table>

#### Sorting

Click any **column header** to sort by it. Clicking again cycles through ascending, descending, and unsorted. An arrow icon shows the current direction.

### Saved filters

Complex filters can be reused. Inside the filter area, open the **Saved Filters** dropdown to:

* **Save** the current filter under a name
* **Reload** a previously saved filter with one click

Saved filters live with the exercise, so your team's standard views are always a click away.

<figure><img src="/files/kI5IMbCH3pwSRh8fvXYW" alt=""><figcaption></figcaption></figure>

### Charts and visualisations

The analytics tabs sit directly under the *Analytics* heading. Click a tab name to switch views (only one is open at a time):

* **Score Distribution**: bar charts showing how often each score occurs, per score column
* **Response Analysis**: pick a column to see a distribution bar chart. You can also build a **correlation heatmap**: choose **Column A** and **Column B** to see a grid showing how their values overlap. Click any cell to drill into the exact respondents in that intersection

<figure><img src="/files/8xEMo1X4iOUREle1dbxK" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/kAow6a2KFGpRLYzXBd2W" alt=""><figcaption></figcaption></figure>

* **Stacked Count**: choose several columns plus a "Group By" column to compare response counts as stacked bars

<figure><img src="/files/QfAS74uwXefXO6XFXtt3" alt=""><figcaption></figcaption></figure>

* **Multi-Choice**: appears after you upload a `.txps` exercise file (see the next section). It shows charts with readable answer text instead of raw 0/1 values

### Decoding binary columns with a .txps file

Some CSV exports store multiple-choice answers as **binary columns** — lots of 0s and 1s where each column represents one possible answer. On their own these are hard to read.

When Colibri Analyser detects binary columns, it shows a notice and a button to upload the matching **exercise file** (a `.txps` file) that contains the real question and answer text.

1. Click **Upload exercise file** (it shows how many binary columns were detected)
2. Drag in or browse for your `.txps` file
3. The app matches each binary column to its question, and a **Multi-Choice** tab appears with fully readable charts. Decoded values also show up in the user detail view

<figure><img src="/files/50IExszLpfAYqpMqw8uY" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://helpdocs.conducttr.com/labs/free-apps/colibri/colibri-analyser.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.