Metadata-Version: 2.5
Name: altar-opentargets-e2g
Version: 0.9.1
Summary: Open Targets ENCODE-rE2G binding for Altar's variant-gene link contract
Project-URL: Documentation, https://kundajelab.github.io/altar/
Author: Riya Sinha
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: altar[gcs]<0.10,>=0.9.1
Provides-Extra: build
Requires-Dist: altar[http]<0.10,>=0.9.1; extra == 'build'
Requires-Dist: duckdb>=1.0.0; extra == 'build'
Requires-Dist: pyarrow>=17.0.0; extra == 'build'
Provides-Extra: test
Requires-Dist: pytest-asyncio>=0.24; extra == 'test'
Requires-Dist: pytest>=8; extra == 'test'
Description-Content-Type: text/markdown

# altar-opentargets-e2g

`altar-opentargets-e2g` adds the genes a variant's regulatory element is predicted to regulate to Altar runs,
from the [Open Targets Platform](https://platform.opentargets.org/)'s ENCODE-rE2G `enhancer_to_gene` dataset, as
the `opentargets_e2g` annotation source.

Maturity: Stable; reading your own BigQuery table (`table`) is Preview: tested on the BigQuery emulator and
DuckDB; not run against live BigQuery. Validation: Matches upstream on spot checks.

## Install

```console
pip install altar-opentargets-e2g
```

The source reads Open Targets release 26.09 on hg38 from a public bucket the Kundaje lab publishes, with no
download and no credentials. To build another release (26.03 or later):

```console
pip install "altar-opentargets-e2g[build]"
altar-opentargets-e2g-build --input <the release's enhancer_to_gene directory> --release 26.09 \
  --output ./opentargets-e2g-26.09
```

## Use it in a run spec

```toml
[sources.e2g]
type = "opentargets_e2g"
options = { filters = { context_names = ["liver"] } }  # optional: keep only some biosamples' links
```

`altar sources opentargets_e2g` lists the columns and options.

Documentation: <https://kundajelab.github.io/altar/integrations/opentargets-e2g/>

## Cite and terms

- Open Targets: Buniello A, et al. *Nucleic Acids Research* 2025;53(D1):D1467–D1475. doi:10.1093/nar/gkae1128.
- ENCODE-rE2G: Gschwind AR, et al. An encyclopedia of human enhancer–gene regulatory interactions. *Nature*
  2026;657(8130):179–190. doi:10.1038/s41586-026-10781-4.
- ENCODE: the ENCODE Project Consortium, with the accessions of the prediction files (`ENCFF…`) you rely on.
- Terms: Open Targets Platform data is released under [CC0 1.0](https://platform-docs.opentargets.org/licence).
  The package ships no data.

## Licence

MIT.
