about summary refs log tree commit diff
path: root/docs
diff options
context:
space:
mode:
authorPjotr <wrk@bosa.lan>2026-11-11 15:05:55 +0000
committerPjotr <wrk@bosa.lan>2026-11-11 15:05:55 +0000
commit22e2d8fedcba427f15859ecd1b1cb79c3aefd59c (patch)
treecc461f24f6d89ae8184e43bfc607e4a9df2c9dc4 /docs
parent8bb9c54d2eb7b4ae2d330a588eff32feceb4324f (diff)
downloadgenenetwork4-22e2d8fedcba427f15859ecd1b1cb79c3aefd59c.tar.gz
docs: the gene link-outs GN2's trait page offers, checked and tableted
GeneNetwork2's webqtlConfig.py holds the link-out URLs its trait page shows
by gene symbol; twelve of them were still alive when checked (2026-11-11,
HTTP 200 and, where the page is not a JavaScript shell, the gene found), and
the SKILL now carries them as a table with descriptions and the URL
templates to hand a user:

  RGD (gene search, mouse/rat/human -- the best single hub for both rodents),
  MGI, Alliance of Genome Resources, NCBI Gene, Wikidata (the QID
  /genes/{symbol}/aliases already returns), UniProt (symbol search or
  accession), Ensembl (gene id), GTEx (human symbols only), STRING,
  GeneMANIA (per species), Open Targets, Human Protein Atlas, GWBI GWAS
  Catalog, BioGPS, Allen Brain Atlas, GeneCup.

Named so they are not offered by mistake: HomoloGene (NCBI retired it 2021),
UniGene (410), Genotation and GeneBridge (dead), PhenoGen (404), chibi
GEMMA, wiki-Pi; PANTHER answers 403 to a bot but works in a browser.

Two conventions: quote the species the symbol came from, and pick the
species-appropriate service (a mouse symbol in GTEx is an empty report).
The API hook is noted but not built: a `links` array on
/genes/{symbol}/aliases, so a client need not hold the URL vocabulary.
Diffstat (limited to 'docs')
-rw-r--r--docs/www/SKILL.md46
1 files changed, 46 insertions, 0 deletions
diff --git a/docs/www/SKILL.md b/docs/www/SKILL.md
index c9abd07..64faed5 100644
--- a/docs/www/SKILL.md
+++ b/docs/www/SKILL.md
@@ -380,6 +380,52 @@ call to a thousand small ones; do not use `/search` for bulk work.
 trait), `/publications/2760876/traits` (PubMed id), and
 `/search?q=cerebellum AND group:BXD&limit=5`.
 
+## 3a. Gene link-outs: where else to send a user about a gene
+
+GeneNetwork2's trait page links out to a dozen services by gene symbol. These
+are the ones that still resolve (checked 2026-11-11, HTTP 200 and — where the
+page is not a JavaScript shell — the gene actually found), with the URL template
+to hand to a user. `{SYMBOL}` is the gene symbol; taxa are **mouse 10090, rat
+10116, human 9606**.
+
+| service | URL template | what it is for |
+|---|---|---|
+| **RGD** (gene search) | `https://rgd.mcw.edu/rgdweb/elasticResults.html?term={SYMBOL}&category=Gene&species={Mouse\|Rat\|Human}` | the best single hub *for mouse and rat*: orthologs, phenotypes, expression, QTLs. Works for all three species |
+| **MGI** | `https://www.informatics.jax.org/searchtool/SearchResults?query={SYMBOL}` | mouse gene authority: alleles, phenotypes, knockouts |
+| **Alliance of Genome Resources** | `https://www.alliancegenome.org/search?category=gene&q={SYMBOL}` | cross-species reference: orthologs and disease models |
+| **NCBI Gene** | `https://www.ncbi.nlm.nih.gov/gene/?term={SYMBOL}[gene]+AND+mouse[orgn]` | the canonical record; also the source of Gene IDs |
+| **Wikidata** | `https://www.wikidata.org/wiki/{QID}` | identifiers and aliases across databases. The QID is what `/genes/{SYMBOL}/aliases` returns, so this link costs nothing to build |
+| **UniProt** | `https://www.uniprot.org/uniprotkb?query=gene:{SYMBOL}+AND+organism_id:{TAXON}` (or `…/uniprotkb/{ACCESSION}`) | protein entry, domains, variants. Search by symbol, link by accession |
+| **Ensembl** | `https://www.ensembl.org/Mus_musculus/Gene/Summary?g={ENSEMBL_ID}` | genome browser, transcripts, orthologs. Needs the Ensembl gene id |
+| **GTEx** | `https://www.gtexportal.org/home/gene/{HUMAN_SYMBOL}` | human tissue expression. **Human symbol only** — a mouse symbol shows an empty report |
+| **STRING** | `https://string-db.org/cgi/network?identifier={SYMBOL}&species={TAXON}` | protein–protein interaction network |
+| **GeneMANIA** | `https://genemania.org/search/{mouse\|rat\|human}/{SYMBOL}` | functional association network, per species |
+| **Open Targets** | `https://platform.opentargets.org/search?q={SYMBOL}` | target–disease associations (human) |
+| **Human Protein Atlas** | `https://www.proteinatlas.org/search/{SYMBOL}` | human tissue/cell expression at protein level |
+| **EBI GWAS Catalog** | `https://www.ebi.ac.uk/gwas/search?query={SYMBOL}` | published GWAS associations |
+| **BioGPS** | `http://biogps.org/?org=10090#goto=genereport&id={SYMBOL}` | mouse expression across tissues and datasets |
+| **Allen Brain Atlas** | `https://mouse.brain-map.org/search/show?search_type=gene&search_term={SYMBOL}` | in-situ hybridisation in mouse brain |
+| **GeneCup** | `https://genecup.org/progress?type=GWAS&query={SYMBOL}` | literature-mined gene–disease links |
+
+**Do not offer these** (checked at the same time): HomoloGene (NCBI retired it
+in 2021 — the URL answers with a notice), UniGene (retired, HTTP 410),
+Genotation and GeneBridge (no DNS/connection), PhenoGen (404), the old chibi
+GEMMA gene page, wiki-Pi. PANTHER answers 403 to a bot but works in a browser,
+so offer it only as a "works in your browser" link:
+`https://www.pantherdb.org/genes/geneList.do?searchType=basic&fieldName=all&organism=all&listType=1&fieldValue={SYMBOL}`.
+
+**How to use them.** Quote the symbol and the species you found it in, and let
+the user click. Do not synthesise what the other service says — say *"RGD has a
+gene report for Shh (rat)"* and give the link, not a paraphrase of a page you
+did not read. For a **rat** symbol prefer RGD and GeneMANIA(rat); for a **mouse**
+symbol all of the above except Human Protein Atlas and GWAS apply; for a **human**
+symbol use GTEx, Open Targets and the Protein Atlas.
+
+**If an API is needed**: `/genes/{SYMBOL}/aliases` already returns the Wikidata
+QID and the aliases; the natural next step is a `links` array on that reply
+(`[{name, href, description}]`) built from the table above, so a client does not
+have to hold the URL vocabulary. Until then, build them from the templates.
+
 ## 4. Gotchas that cost time
 
 * Compute replies are big (about 21 000 rows; GEMMA about 2 MB). Save to a file,