gget

Was macht gget?

Verwenden Sie diese Fähigkeit, wenn eine Aufgabe eine schnelle bioinformatische Abfrage über genomische Referenzdatenbanken mit dem gget CLI oder Python-Paket erfordert.

Verwendungszweck

• Finden von Ensembl-IDs, Genmetadaten, Transkriptdetails oder Sequenzen.
• Durchführen schneller BLAST- oder BLAT-Abfragen ohne Aufbau einer vollständigen lokalen Pipeline.
• Abrufen von Referenzgenom-Links und Annotationen von Ensembl.
• Abfragen von Protein-Struktur-, Pathway-, Krebs-, Expressions- oder Krankheitsassoziationen über eine einzige Schnittstelle.
• Erstellen eines reproduzierbaren ersten Belegprotokolls, bevor man zu schwereren Werkzeugen wie Biopython, Snakemake, Nextflow, BLAST+ oder datenbankspezifischen Clients übergeht.

Verwenden Sie einen dedizierten Workflow anstelle von gget, wenn die Aufgabe eine regulierte klinische Interpretation, Hochdurchsatz-Produktionspipelines oder eine feinkörnige Kontrolle über Datenbankversionen und lokale Indizes erfordert.

Installation

Verwenden Sie 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

Wenn uv verfügbar ist:

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

Bevor Sie sich auf eine ältere Umgebung verlassen, aktualisieren Sie gget und überprüfen Sie die Modul-Dokumentation 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 Arbeitsablauf:

1. Identifizieren Sie die Spezies, Assembly, Gen-ID-Typ und benötigte Datenbank.
2. Überprüfen Sie die aktuelle Modul-Dokumentation auf Argumente.
3. Führen Sie zuerst eine kleine Abfrage durch.
4. Speichern Sie die Ausgabe mit einem expliziten Dateinamen und Datum.
5. Notieren Sie Modulname, Version, Argumente und Datenbankannahmen.

Häufige Module

Verwenden Sie die aktuellen Upstream-Dokumentationen für genaue Argumente. Diese Module sind häufige erste Wahl:

• gget search: Finden Sie Ensembl-IDs aus Suchbegriffen.
• gget info: Rufen Sie Metadaten für Ensembl-, UniProt- oder verwandte IDs ab.
• gget seq: Rufen Sie Nukleotid- oder Aminosäuresequenzen ab.
• gget ref: Rufen Sie Download-Links für Referenzgenome ab.
• gget blast: Führen Sie eine schnelle BLAST-Abfrage durch.
• gget blat: Finden Sie eine Sequenz gegen unterstützte Genome-Assemblies.
• gget muscle: Führen Sie multiple Sequenzalignments durch.
• gget diamond: Führen Sie lokale Sequenzalignments gegen Referenzsequenzen durch.
• gget alphafold und gget pdb: Untersuchen Sie Protein-Struktur-Referenzen.
• gget enrichr, gget opentargets, gget archs4, gget bgee, gget cbio und gget cosmic: Erkunden Sie Anreicherungs-, Ziel-, Expressions-, Krebs- und Krankheitsassoziationsdaten.

Gehen Sie nicht davon aus, dass jedes Modul jede Python-Version oder jeden Abhängigkeitssatz unterstützt. Einige optionale wissenschaftliche Abhängigkeiten haben eine engere Versionsunterstützung als das Kernpaket.

Schnelle Beispiele

Finden von Genen:

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

Abrufen von Genmetadaten:

gget info ENSG00000012048 -o brca1-info.json

Abrufen einer Sequenz:

gget seq ENSG00000012048 -o brca1-seq.fa

Durchführen einer kleinen BLAST-Abfrage:

gget blast "MEEPQSDPSVEPPLSQETFSDLWKLLPEN" -l 10 -o blast-ergebnisse.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ügen Sie genügend Metadaten bei, um die Abfrage wiederholen zu können.

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

Notieren Sie auch:

• Python-Version und Umgebungsmanager.
• Optionale Abhängigkeiten, die über gget setup installiert wurden.
• Von der Abfrage zurückgegebene datenbankspezifische Identifikatoren.
• Ob die Ausgabe JSON, CSV, FASTA oder ein DataFrame-Export ist.
• Fehler, die durch ein Upgrade von gget behoben wurden.

Überprüfungs-Checkliste

• Haben Sie die installierte gget-Version aktualisiert oder überprüft?
• Haben Sie die aktuellen Upstream-Modul-Dokumentationen vor der Verwendung von Argumenten überprüft?
• Ist die Spezies oder 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-Schnipsel reproduzierbar?
• Sind optionale Abhängigkeiten in einer isolierten Umgebung installiert?

Referenzen

• gget Dokumentation
• gget Updates
• gget GitHub Repository
• gget Bioinformatics Paper