# gnomAD v4.1 Gene Constraint Metrics (LOEUF, pLI, missense Z)

## Facts

- Provider: gnomAD Production Team, Broad Institute
- License: CC0-1.0 (https://github.com/broadinstitute/gnomad-browser/blob/main/browser/about/policies/terms.md)
- Format: JSON (in sampled files)
- Stored at: Amazon S3, s3://gnomad-public-us-east-1/release/4.1/constraint (us-east-1)
- Access: public, readable without an account
- Category: Genomics & Bioinformatics
- Source: https://doi.org/10.1038/s41586-020-2308-7
- Page: https://scigantic.com/archive/f45d0c87-a14b-5cf1-a377-7ecf639eb2e4
- Keywords: Genomics & Bioinformatics, JSON, AWS Open Data

## About

Per-transcript mutational constraint metrics from the gnomAD v4.1 exome release (730,947 exomes), measuring how depleted each gene is of predicted loss-of-function (pLoF), missense and synonymous variation compared with a mutational model. Columns, documented in README.txt, include observed, expected and possible variant counts, observed/expected ratios with 90% confidence intervals, LOEUF (the upper bound of the pLoF o/e interval, with transcript rank and decile for MANE Select or canonical transcripts), pLI, pRec and pNull, Z-scores for pLoF, missense and synonymous variants, PolyPhen-2 probably-damaging missense counts, mutation rates, separate high-confidence and high-plus-low-confidence pLoF sets, and constraint_flags explaining missing values (no_variants, outlier_lof and so on). Rows cover Ensembl and RefSeq transcripts with canonical and MANE Select flags. Measured 2026-11-15: gnomad.v4.1.constraint_metrics.tsv (96 MB), the same data as a Hail Table (gnomad.v4.1.constraint_metrics.ht, about 3,000 objects) and README.txt. Load the TSV with pandas or the HT with hail.read_table. gnomAD primary data are released under CC0 1.0; cite the gnomAD v4.1 release and Karczewski et al., Nature 2020 (LOEUF).

## Load the data

```python
import boto3
from botocore import UNSIGNED
from botocore.client import Config
s3 = boto3.client('s3', region_name='us-east-1', config=Config(signature_version=UNSIGNED))
s3.list_objects_v2(Bucket='gnomad-public-us-east-1', Prefix='release/4.1/constraint/', Delimiter='/')
```

Lists the files with anonymous access. Runs on any machine, with no cloud account.

## Data structure

File types in sampled files: JSON

Example file: `release/4.1/constraint/gnomad.v4.1.constraint_metrics.ht/globals/metadata.json.gz`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/f45d0c87-a14b-5cf1-a377-7ecf639eb2e4
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/f45d0c87-a14b-5cf1-a377-7ecf639eb2e4
- Over MCP: `get_schema_card` with id `f45d0c87-a14b-5cf1-a377-7ecf639eb2e4` at https://api.scigantic.com/mcp

## Related topics

- [JSON datasets](https://scigantic.com/topics/json)
- [Genomics & Bioinformatics datasets](https://scigantic.com/topics/genomics-and-bioinformatics)
