# LIVIA Atlas > LIVIA Atlas (https://flyark.github.io/livia-atlas/) is a searchable browser-based atlas of AlphaFold-Multimer protein-protein interaction screens resolved to individual residues across human, mouse, rat, fly, zebrafish, C. elegans, yeast, viral proteomes, and over 40 additional species, with ortholog and paralog comparisons. ## Scoring & Residue Definitions - **LIR (Local interaction residues)**: Cross-chain residue pairs with `PAE ≤ 12 Å`. Covers structured interfaces as well as disordered segments folded upon binding. - **cLIR (Contact residues)**: Subset of LIR that also satisfies `Cβ ≤ 8 Å` (`Cα` for Gly) in 3D space. - **LIS / cLIS / iLIS**: - `LIS`: Mean of `(12 - PAE) / 12` over cross-chain residue pairs with `PAE ≤ 12 Å`. - `cLIS`: Mean of `(12 - PAE) / 12` over cross-chain residue pairs with `PAE ≤ 12 Å` and `Cβ ≤ 8 Å`. - `iLIS = sqrt(LIS * cLIS)`: Primary interaction confidence score. - **Benchmarked `iLIS` False-Positive-Rate (FPR) Cutoffs** (calibrated on the top-ranked of five models per pair): - `10% FPR`: `iLIS ≥ 0.223` - `5% FPR`: `iLIS ≥ 0.339` - `1% FPR`: `iLIS ≥ 0.551` - **cLIP (clustered Local Interaction Profiler)**: Groups passing models on a protein page by cosine distance over their query `cLIR` fingerprints (average linkage, silhouette cluster selection). Each cluster defines a binding site footprint (residues contacted by `≥ 30%` of the cluster's models). ## Direct Hash URL Routes LIVIA Atlas is a client-side single-page application routed by `location.hash`: - **Home**: `https://flyark.github.io/livia-atlas/#/` - **Species list**: `https://flyark.github.io/livia-atlas/#/species` - **Datasets**: `https://flyark.github.io/livia-atlas/#/datasets` - **Protein page**: `https://flyark.github.io/livia-atlas/#//` - Core `` IDs: `human`, `fly`, `zebrafish`, `worm`, `yeast`, `mus-musculus`, `rattus-norvegicus`, `virus` (plus species listed on `#/species`). - Accepts primary gene symbols, UniProt accessions (`P04637`), or FlyBase IDs (`FBgn0000117`). Unknown aliases or older synonyms fall back automatically to a live UniProt synonym lookup with direct links. - **Query parameters on protein pages**: - `?res=`: Marks and evaluates a single residue (`?res=18`), a residue range (`?res=15-29`), comma-separated multi-spans or mutations (`?res=10-19,188-202`, `?res=R175,R248,R273`), a peptide sequence (`?res=ETFSDLWKLL`, up to 1 mismatch per 5 residues), or an ELM/PROSITE motif (`?res=LXXLL`, `?res=[ST]P`, `?res=PX(2,3)P`). Populates `#res-look` in plain DOM text with matched coordinates, sequence, domain context, AlphaFold DB monomer `pLDDT` mean and min-max, per-match counts, `cLIR` contacting partners/clusters, and `LIR`-only partners. - `?cut=10` | `?cut=5` | `?cut=1`: Sets the active FPR cutoff for binding-site clustering (`10%`, `5%`, or `1%`). - `?set=`: Scopes the protein page to one screen or thematic set. - `?iso=`: Selects a specific isoform or construct when folded separately. - `?fpst=cluster|classic`, `?freqst=total`, `?rlab=0`: Controls Contact residue frequency (`by cluster`, `all models`, or `classic`), fingerprint style, and right-side labels. - `?band=0|10|5|1`, `?ptcl=`, `?kb=rep|unrep|ph|ge`, `?struct=1`, `?q=`: Pre-filters the Interactors table (FPR cutoff, cluster, BioGRID literature evidence, LIVIA 3D structure availability, or partner/contact-span text filter). - **Pair page**: `https://flyark.github.io/livia-atlas/#///` - Shows every ranked model across screens, full `lis.py` metrics (`iLIS`, `iLISA`, `ipTM`, `LIS`, `cLIS`, `ipSAE`, `actifpTM*`, `pDockQ`, `pDockQ2`), exact `LIR` and `cLIR` residue tracks and sequences, BioGRID literature records, ortholog/paralog pair matrices, and sequence exports (`↓ FASTA`, `↓ AF3 JSON`, `↓ Boltz YAML`, `↓ ColabFold CSV`). - **Query parameters on pair pages**: - `?rank=`: Pre-selects ranked model `n` (1-based by `iLIS`). - `?resA=&resB=`: Marks and evaluates specific residues, ranges, comma-separated spans, or motifs on Protein A and/or Protein B, populating `#pair-res-look` with selected-model and all-model `cLIR` / `LIR` overlap counts. - **Network builder**: `https://flyark.github.io/livia-atlas/#/network/?ids=&cut=5` - Optional parameters: `add=none|top|link|tree|pair`, `k=`, `rc=&focus=rc` (opens the Residue chord diagram for up to 12 proteins). ## One-Click Markdown Export & Plain-Text DOM Anchors - **Copy Markdown (`#copy-md`)**: Available in the top action bar of every Protein page, Pair page, and Network page (`Share` row). Copies a token-efficient Markdown report of scores, domains, `pLDDT`, cLIP clusters, and exact `cLIR`/`LIR` spans. - **Protein page DOM anchors**: - `#sites-answer`: One-paragraph summary of passing partners, binding-site count, and top cluster footprint stretches. - `#res-look`: Detailed plain-text readout when `?res=` or `#res-q` is set. - `#cluster-info`: Every cLIP cluster with partner count, model count, consensus `footprint` residue stretches, and linked partner gene names. - `#pt`: Sortable Interactors table with `Contact spans` and `↓ CSV` export (`#pt-csv`). - **Pair page DOM anchor**: - `#pair-res-look`: Plain-text readout when `?resA=` or `?resB=` is set. ## JavaScript Inspection API (`window.LIVIA_ATLAS`) When accessing LIVIA Atlas from an automated browser or DevTools console, use `window.LIVIA_ATLAS` instead of scraping canvas plots: ```js // 1. Resolve a gene symbol, UniProt accession, or UniProt alias/synonym: await window.LIVIA_ATLAS.resolve('UBC6e', 'human'); // -> { ok: true, species: 'human', key: 'Q9Y385', gene: 'UBE2J1', acc: 'Q9Y385', via: 'UniProt synonym', hash: '#/human/Q9Y385' } // 2. Wait for asynchronous bundle loading, cLIP clustering, domains, and AlphaFold DB pLDDT to finish: const data = await window.LIVIA_ATLAS.waitReady(); // 3. Export a structured Markdown summary of the current Protein, Pair, or Network view: const md = window.LIVIA_ATLAS.toMarkdown(); // 4. Query one or more residues, ranges, sequences, or motifs (on Protein or Pair pages): window.LIVIA_ATLAS.queryRegion('10-19,188-202', { mark: true }); // On a Pair page, pass { side: 'A' | 'B', mark: true }: window.LIVIA_ATLAS.queryRegion('10-19', { side: 'A', mark: true }); ``` ## Non-Browser CLI & Python Sandbox Client (`scripts/atlas_query.py`) Agents with shell/Python access (no browser required, zero third-party packages — Python 3 stdlib only) can fetch `https://flyark.github.io/livia-atlas/scripts/atlas_query.py` and run: ```bash python3 scripts/atlas_query.py resolve human UBC6e python3 scripts/atlas_query.py protein human UBE2J1 --res 171-184 --markdown python3 scripts/atlas_query.py protein human CXCR2 --res 10-19,188-202 --json python3 scripts/atlas_query.py pair human CXCR2 CXCL8 --res-a 10-19 --markdown ``` Also packaged as an agent skill at `skill/livia-atlas/SKILL.md`. ## Citation Kim A-R & Perrimon N (2026). LIVIA, bioRxiv. https://doi.org/10.64898/2026.05.01.721633