# Gating

{% hint style="info" %}

## Power user feature 🥊

This feature is for BactoBox® power users. Use this feature for added value with your BactoBox®, though it's optional for regular use.
{% endhint %}

You have multiple options on this page:

* Upload a [CRS file](/encyclopedia/software/file-formats/crs-file.md) to your BactoBox®
* Star the CRS files in a specific order to change what happens when you press <kbd>Measure</kbd>.
* Download a CRS file from your BactoBox®
* Delete a CRS file from your BactoBox®

A [CRS file](/encyclopedia/software/file-formats/crs-file.md) defines how the *Measure* program works. See [Gating](/encyclopedia/measurements-explained/gating.md) for details.

#### Choose CRS file for the *Measure* program

Both the [Access](/encyclopedia/software/access.md) and [Dash](/encyclopedia/software/user-interface.md) user interfaces allow you to select a specific CRS file before *Measure* starts.

{% columns %}
{% column %}
{% hint style="info" %}

### Choose CRS file in Access

In the [Access](/encyclopedia/software/access.md) user interface, press the <kbd>Measure</kbd> button. A dialog appears. Choose one of the CRS files in the *Select gating* list.
{% endhint %}
{% endcolumn %}

{% column %}
{% hint style="info" %}

### Choose CRS file in Dash

In the [Dash](/encyclopedia/software/user-interface.md) user interface, hold <kbd>Measure</kbd> for a couple of seconds. A menu appears. Select *🫆 Measure with custom gating*. Choose one of the CRS files in the list.
{% endhint %}
{% endcolumn %}
{% endcolumns %}

## Upload a [CRS file](/encyclopedia/software/file-formats/crs-file.md) to your BactoBox®

Drag and drop the [CRS file](/encyclopedia/software/file-formats/crs-file.md) from your computer into the table on the *Gating* page. This immediately starts the file upload.

{% hint style="success" %}

### Refresh the Access user interface

Refresh the Access user interface (press <kbd>F5</kbd>) to see the newly-uploaded CRS file in the *Select gating* list.
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/msWZeY9etdj4UY6gFSiB" alt=""><figcaption><p>Drag and drop a <a data-mention href="/pages/4zaaHJO7qFaOJ1i7MXSK">/pages/4zaaHJO7qFaOJ1i7MXSK</a> from your computer to your BactoBox®.</p></figcaption></figure></div>

## Star CRS files on your BactoBox®

You can star zero or more CRS files. The number of starred CRS files changes what happens when you press <kbd>Measure</kbd> on your BactoBox®.

<table><thead><tr><th width="100">Number of starred files</th><th>What happens when you press Measure</th></tr></thead><tbody><tr><td>0</td><td>The <em>Measure</em> program starts immediately.<br><mark style="color:$info;">BactoBox® uses the system default CRS file. Usually, this is <code>BacTotal-v2024-10.crs.json</code>.</mark></td></tr><tr><td>1</td><td>The <em>Measure</em> program starts immediately.<br><mark style="color:$info;">BactoBox® uses the starred CRS file.</mark></td></tr><tr><td>2 or more</td><td>A <em>Starred programs</em> menu appears.<br><mark style="color:$info;">BactoBox® prompts you to select a CRS file before the </mark><em><mark style="color:$info;">Measure</mark></em><mark style="color:$info;"> program starts.</mark></td></tr></tbody></table>

### Star order

The order in which you star the CRS files matter. This order determines how BactoBox® presents the CRS files in the *Starred programs* menu. The number next to the *Starred* column is the current star order. No. 1 goes in the top of the list, no. 2 goes second, and so on.

<div data-with-frame="true"><figure><img src="/files/pykVb54z7i63yuDrNUHS" alt=""><figcaption><p>Change the starred CRS files on your BactoBox®.</p></figcaption></figure></div>

### Single star

<div data-with-frame="true"><figure><img src="/files/HEtACKK5yLmrYr9fYw6s" alt=""><figcaption><p>Star a single CRS file. Note that the <em>Device behaviour</em> section changes accordingly.</p></figcaption></figure></div>

### Zero stars

<div data-with-frame="true"><figure><img src="/files/x6OLmcuAWro329QUC1vX" alt=""><figcaption><p>Remove all stars from the CRS files. Again, note how the <em>Device behaviour</em> section changes.</p></figcaption></figure></div>

## Download a CRS file from your BactoBox®

Press the link in the *Name* column to download the corresponding CRS file. In Microsoft Edge, the download begins immediately (see quick clip below). Other browsers may open a *Save file as* dialog.

<div data-with-frame="true"><figure><img src="/files/W5NuIuPHtPl4rdPCSMP2" alt=""><figcaption><p>Press the link to download the CRS file. In Microsoft Edge, this starts the download immediately.</p></figcaption></figure></div>

## Remove CRS files from your BactoBox®

Press the garbage bin icon for each CRS file that you want to remove. Then, click the *Save* button.

{% hint style="warning" %}
Once you press the *Save* button, the corresponding files are permanently deleted. There is no way to recover them.
{% endhint %}

Your BactoBox® comes with several built-in CRS files. E.g., `BacTotal_v2024-10.crs.json` and `Salmonella.crs.json`. It's not possible to remove these CRS files.

<div data-with-frame="true"><figure><img src="/files/qahXCe0QaSBwt8E1Th0g" alt=""><figcaption><p>We click the garbage bin icons to remove all the user-provided CRS files. Note how the built-in CRS files do not have a garbage bin icon.</p></figcaption></figure></div>

## Gating FAQ

### How do I create or edit a CRS file?

Contact us for more information.

{% hint style="info" %}

## Power user feature 🥊

This feature is for BactoBox® power users. Use this feature for added value with your BactoBox®, though it's optional for regular use.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://help.sbtinstruments.com/encyclopedia/software/access/pages/gating.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.