# Junctions

Auto-generated from the config schema in the source. See the [config guide](https://jbrowse.org/jb2/docs/config_guide) for concepts. Provided by the `alignments` plugin. [View source](https://github.com/GMOD/jbrowse-components/blob/main/plugins/alignments/src/LinearAlignmentsDisplay/junctionsConfigSchema.ts).

The alignments display's `junctions` setting: the junction arcs, over the
coverage band or in a strip above or below it, and in a strip of their own
while `coverage.show` is off. The band counts each splice junction from the reads'
N gaps and each same-reference join of a split read's segments by its class
(`junction.class`: `deletion`, `duplication`, which a circRNA back-splice
is, or `inversion`), once per pair of read-adjacent segments as the read
arcs count support. A split junction always takes its class's read-arc
color. Which junctions draw is the display's `filter`,
by its `junction` fields.

## Example usage

```js
{
  type: 'LinearAlignmentsDisplay',
  junctions: { placement: 'auto', labels: { show: true } },
  filter: [
    { field: 'junction.reads', gte: 5 },
    { field: 'junction.canonical', equal: true },
    { field: 'junction.class', oneOf: ['splice', 'duplication'] },
  ],
}
```

## Config slots

A setting written to it names members one by one: a member left out stays as it is, and `null` resets one. Slot types (`fileLocation`, `frozen`, ...) are explained in the [config slot types reference](https://jbrowse.org/jb2/docs/config_guides/slot_types). Slots a base configuration contributes are listed here too, so this table is the whole surface.

| Slot | Description |
| --- | --- |
| **show**<br>[`boolean`](https://jbrowse.org/jb2/docs/config_guides/slot_types#boolean) = <code>true</code> | draw the junction arcs |
| **height**<br>[`number`](https://jbrowse.org/jb2/docs/config_guides/slot_types#number) = <code>40</code> | height in pixels of the strip the arcs draw in above or below the coverage band |
| **placement**<br>[`stringEnum`](https://jbrowse.org/jb2/docs/config_guides/slot_types#stringenum) ('overlay', 'above', 'below', 'auto') = <code>'overlay'</code> | where the arcs sit against the coverage band: overlay on its histogram, above in a strip of their own over it, below in a strip under it, or auto, which sends a junction below where it would cross another. With coverage hidden there is nothing to overlay: overlay and auto draw every arc hanging in the strip below, and above keeps its strip, arcs rising |
| **labels**<br>[JunctionLabels](../junctionlabels) | The read count on each arc: `show`. |

