# allyhub reference set

> A set of references as statistics: every number their reference.json holds, by its path, with its quantiles; each value's share of their interpretation.json labels; and one folder's percentile among them

Source: https://allyhub.com/docs/reference/cli/reference-set · AllyHub 0.10.0
Index of all docs: https://allyhub.com/llms.txt

## Usage

```bash
allyhub reference set [folders…] [options]
```

## Arguments

| Argument | Type | What it is |
| --- | --- | --- |
| `<folders>` | list of string | Reference folders, or folders of them (default the project's .allyhub/work/reference/) |

## Options

| Option | Type | Default | What it does |
| --- | --- | --- | --- |
| `--where` | list of string |  | Only the references whose interpretation.json labels hold this, label=value (a list holds what it contains) |
| `--place` | string |  | A reference folder to place among the set: each of its numbers with its percentile (a piece measured with allyhub reference served) |

## Global options

`--dir <value>`: the project's folder; default the one around where it is run. `--json`: print the result as JSON.

## Output

With `--json`, the command prints an object with these fields:

| Field | Type | What it is |
| --- | --- | --- |
| `n` | number |  |
| `numbers` |  |  |

## Examples

```bash
allyhub reference set
allyhub reference set --where format=talking-head --place .allyhub/work/reference/film-tiktok
```

## Exit codes

`0` when it succeeds; the others are listed in [Exit codes](https://allyhub.com/docs/reference/cli/exit-codes.md).

## In the work

**references**: Studying reference videos, and a piece against them

[`reference`](https://allyhub.com/docs/reference/cli/reference.md) → [`reference compare`](https://allyhub.com/docs/reference/cli/reference-compare.md) → `reference set` → [`frames`](https://allyhub.com/docs/reference/cli/frames.md) → [`frames compare`](https://allyhub.com/docs/reference/cli/frames-compare.md) → [`words`](https://allyhub.com/docs/reference/cli/words.md) → [`audio`](https://allyhub.com/docs/reference/cli/audio.md) → [`align`](https://allyhub.com/docs/reference/cli/align.md)
