gget

Was macht gget?

Nutze diese Fähigkeit, wenn eine Aufgabe schnelle Bioinformatik-Recherchen über genomische Referenzdatenbanken mit dem gget CLI oder Python-Paket erfordert.

Wann verwenden

• Finden von Ensembl-IDs, Gen-Metadaten, Transkriptdetails oder Sequenzen.
• Ausführen schneller BLAST- oder BLAT-Abfragen ohne Aufbau einer vollständigen lokalen Pipeline.
• Abrufen von Referenzgenom-Links und Annotationen von Ensembl.
• Abfragen von Proteinstruktur-, Pathway-, Krebs-, Expressions- oder Krankheitsassoziationsmodulen über eine einzige Schnittstelle.
• Erstellen eines reproduzierbaren ersten Evidenzprotokolls, bevor schwerere Werkzeuge wie Biopython, Snakemake, Nextflow, BLAST+ oder datenbankspezifische Clients verwendet werden.

Verwende einen dedizierten Workflow anstelle von gget, wenn die Aufgabe eine regulierte klinische Interpretation, Hochdurchsatz-Produktionspipelines oder eine fein granulare Kontrolle über Datenbankversionen und lokale Indizes erfordert.

Installation

Verwende eine saubere Python-Umgebung.

python -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install --upgrade gget
gget --help

Falls uv verfügbar ist:

uv venv
. .venv/bin/activate
uv pip install gget

Bevor du dich auf eine ältere Umgebung verlässt, aktualisiere gget und überprüfe die Moduldokumentation erneut. Die von gget abgefragten upstream Datenbanken ändern sich im Laufe der Zeit.

Grundlegende Muster

CLI-Form:

gget <modul> [argumente] [optionen]

Python-Form:

import gget

ergebnis = gget.search(["BRCA1"], species="human")
print(ergebnis)

Häufiger Workflow:

1. Identifiziere die Spezies, das Assembly, den Gen-ID-Typ und die benötigte Datenbank.
2. Überprüfe die aktuelle Moduldokumentation auf Argumente.
3. Führe zuerst eine kleine Abfrage aus.
4. Speichere die Ausgabe mit einem expliziten Dateinamen und Datum.
5. Notiere Modulname, Version, Argumente und Datenbankannahmen.

Häufige Module

Verwende die aktuellen upstream Dokumentationen für genaue Argumente. Diese Module sind häufige erste Anlaufstellen:

• gget search: Finde Ensembl-IDs aus Suchbegriffen.
• gget info: Rufe Metadaten für Ensembl-, UniProt- oder verwandte IDs ab.
• gget seq: Rufe Nukleotid- oder Aminosäuresequenzen ab.
• gget ref: Rufe Download-Links für Referenzgenome ab.
• gget blast: Führe eine schnelle BLAST-Abfrage aus.
• gget blat: Lokalisiere eine Sequenz gegen unterstützte Genomassemblies.
• gget muscle: Führe ein multiples Sequenzalignment aus.
• gget diamond: Führe lokales Sequenzalignment gegen Referenzsequenzen durch.
• gget alphafold und gget pdb: Untersuche Proteinstruktur-Referenzen.
• gget enrichr, gget opentargets, gget archs4, gget bgee, gget cbio und gget cosmic: Erkunde Anreicherungs-, Ziel-, Expressions-, Krebs- und Krankheitsassoziationsdaten.

Gehe nicht davon aus, dass jedes Modul jede Python-Version oder jeden Abhängigkeitssatz unterstützt. Einige optionale wissenschaftliche Abhängigkeiten haben einen engeren Versionssupport als das Kernpaket.

Kurzbeispiele

Gene finden:

gget search -s human brca1 dna repair -o brca1-search.json

Gen-Metadaten abrufen:

gget info ENSG00000012048 -o brca1-info.json

Sequenz abrufen:

gget seq ENSG00000012048 -o brca1-seq.fa

Kleine BLAST-Abfrage ausführen:

gget blast "MEEPQSDPSVEPPLSQETFSDLWKLLPEN" -l 10 -o blast-results.json

Python-Beispiel:

import gget

gene = gget.search(["BRCA1", "DNA repair"], species="human")
info = gget.info(["ENSG00000012048"])
sequenz = gget.seq("ENSG00000012048")

Reproduzierbarkeitsprotokoll

Für wissenschaftliche Ausgaben füge ausreichend Metadaten ein, um die Abfrage wiederholen zu können.

| Datum | gget-Version | Modul | Abfrage | Spezies/Assembly | Ausgabe | Anmerkungen |
| --- | --- | --- | --- | --- | --- | --- |
| 2026-05-11 | `gget --version` | search | `BRCA1 DNA repair` | human | `brca1-search.json` | Dokumentation vor Ausführung geprüft |

Notiere außerdem:

• Python-Version und Umgebungsmanager.
• Jegliche optionale Abhängigkeit, die über gget setup installiert wurde.
• Datenspezifische Identifikatoren, die von der Abfrage zurückgegeben wurden.
• Ob die Ausgabe JSON, CSV, FASTA oder ein DataFrame-Export ist.
• Alle Fehler, die durch ein Upgrade von gget behoben wurden.

Überprüfungs-Checkliste

• Hast du die installierte gget-Version aktualisiert oder überprüft?
• Hast du die aktuellen upstream-Moduldokumentationen vor der Verwendung von Argumenten geprüft?
• Ist die Spezies oder das Assembly explizit angegeben?
• Werden Identifikatoren exakt beibehalten, einschließlich Ensembl-/UniProt-Präfixe?
• Ist das Ergebnis als Datenbankausgabe und nicht als klinische Interpretation gekennzeichnet?
• Ist die Abfrage aus dem gespeicherten Befehl oder Python-Snippet reproduzierbar?
• Sind optionale Abhängigkeiten in einer isolierten Umgebung installiert?

Referenzen

• gget Dokumentation
• gget Updates
• gget GitHub Repository
• gget Bioinformatik-Paper