> For the complete documentation index, see [llms.txt](https://help.bioinsight.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.bioinsight.illumina.com/annotation/core-functionality/junction-preserving.md).

# Junction Preserving Annotation

### Background

When a variant can be moved (due to alignment) across junctions (e.g. start, stop or splice site), the annotation may vary depending on which exact alignment was used. For example, a left-aligned deletion that effects the splice acceptor site, upon right-alignment, may become an exon variant.

![Deletion at exon boundary](https://3508920906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ADJyhzPlTHw5HimbPLQ%2Fuploads%2Fgit-blob-b7fd71d449099363b815c0401bf70ddb17a13de2%2F27-nt-deletion.png?alt=media)

Note that:

* When right-aligned the variant starts at the first base of the exon (as pictured).
* When left-aligned the variant can be shifted two base pairs and starts at a splice acceptor site.

From the point of view of the translation mechinary, the important question is whether the sequence that identifies a junction is preserved, regardless of the variant position. In the case of the deletion above, we believe that the variant is more accurately characterized as an `inframe_deletion` not a `splice_acceptor_variant` as splice acceptor sequence `AG` is unaffected.

When faced with such variants, we will assign junction disrupting consequnces only if the variant cannot be shifted out of the junction.

### Implementation

By default and convention, the left-aligned variant is annotated. If the variant overlaps a junction (as judged by consequences), it is right-aligned and annotated. If both alignment produces junction disruption, the left-aligned annotation is reported. If however, only one of the alignment causes junction disruption but not the other, the non-junction-disrupting annotation is reported.

{% hint style="info" %}
This only effects transcript annotations. Supplementary annotations are reported on the left-aligned variant and HGVS notations are calculated on right-aligned variant.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.bioinsight.illumina.com/annotation/core-functionality/junction-preserving.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
