Was macht biopathway-mechanism-diagram?
Eine Signalweg-Abbildung ist eine Mechanismus-Aussage, die Leser Pfeil für Pfeil in Frage stellen werden. Vertrag dieses Skills: Jede Entität und jede Kante auf der Leinwand führt auf ein wörtliches Zitat mit einer Fundstelle zurück; Interaktionssemantiken (Aktivierung / Inhibition / Bindung / Modifikation / Transport) sind visuell unterscheidbar und werden niemals vermischt; alles, was die Quelle nicht angibt (Richtung, Ort, Zahlen), wird sichtbar als „nicht angegeben“ markiert, nicht geraten. Die Ergebnisse sind ein geschichtetes, über IDs adressierbares, editierbares SVG sowie PNG/PDF-Exporte und eine vertragskonforme result.json.
Wann verwenden / wann nicht
Verwenden für: Mechanismus-Abbildungen, Signalweg-Diagramme, Rezeptor-zu-Zellkern-Kaskaden, Pathway-Übersprechen, „Zeichne Abbildung N aus dieser Publikation“-Aufgaben und Bearbeitungen bestehender Signalweg-Abbildungen (hinzufügen/entfernen von Entitäten oder Kanten, umbenennen). Nicht für: Statistische Diagramme (Balken/Box/Volcano), experimentelle Schemata oder rein ästhetische Nachbearbeitungen; diese gehören zu benachbarten Skills.
Ausführungsvertrag (Plattform-Laufzeit)
- Eingabe:
/input/case.json(+ task.md). Arbeiten unter/app/work; Ergebnisse unter/app/output. - Erste Aktion des gesamten Durchlaufs (bevor der Fall im Detail gelesen wird):
python scripts/scaffold_result.py --input /input/case.json --outdir /app/outputDies schreibt eine result.json mit jedem Ausgabe-Vertragsfeld vorhanden, nicht produzierte null + Begründung. Aktualisieren Sie sie schrittweise; löschen Sie niemals ein Vertragsfeld. - Alle folgenden Skripte übernehmen
--model/--svg-Stil-Pfade und sind reines Python 3 (nur stdlib), sofern nicht anders angegeben.references/wird von den Skripten gelesen; lesen Sie die.md-Dateien selbst vor Schritt 1.
Schritt 0 – Vertrag lesen und Gerüst erstellen (1 Request)
Führen Sie das Gerüst aus. Überfliegen Sie task.md + case.json: Identifizieren Sie das Ziel der Abbildung (welcher Mechanismus, welche Abbildung bei Reproduktion, Szenario „generieren“ vs. „bearbeiten“), die erforderlichen Exportformate und den Umfang der Belege. Notieren Sie die Liste der Vertragsfelder, die Sie füllen müssen. Kostenbewusstsein: Ziel ist es, in 5–8 Modell-Schritten fertig zu werden; Skripte erledigen die Schwerstarbeit, Sie die Wissenschaft.
Schritt 1 – Mechanismus-Modell extrahieren (der wissenschaftliche Kern – selbst machen)
Lesen Sie das tatsächliche Material (PDF wirklich parsen; Dateien lesen, niemals Inhalt aus Labels annehmen). Erstellen Sie /app/work/model.json gemäß references/layout-conventions.md nach EIGENEM URTEIL:
- Entitäten — Gen / Protein / Rezeptor / RNA / Komplex / Molekül / Zelle / Familie. Wenden Sie
references/naming-rules.mdan: Gensymbole kursiv und Gen-Knoten von ihren Proteinen unterscheiden (MYC vs. MYC); bevorzugte Symbole mit Quell-Schreibweisen in Synonymen; Familien vs. Mitglieder; ein Knoten pro angegebenem Komplex. Jede Entität trägtsource: {loc, quote}– ein WÖRTLICHES Zitat und eine Fundstelle, die präzise genug ist, um sie wiederzufinden (Abschnitt/Paragraph/Seite/Abbildungsunterschrift). - Kanten — Typ aus der geschlossenen Menge in
references/edge-types.json(Aktivierung, Inhibition, Bindung, Phosphorylierung, Ubiquitinierung, Transkriptionsregulation, Translokation, Komplexbildung, ...).directedmuss explizit gesetzt werden. Niemals Richtung raten: Wenn das Zitat keinen Richtungshinweis enthält, setzen Siedirected: falseund protokollieren Sie eine Unsicherheit (references/uncertainty-policy.md). Bindung/Rekrutierung ist ungerichtet. Transkriptionsregulation zielt auf einen Gen-Knoten und benötigt ein Vorzeichen. - Kompartments — extrazellulär / Membran / Zytoplasma / Zellkern (+ ER, Golgi, Organell-Unterregionen, wenn der Mechanismus sie benötigt). Entitäten, deren Ort nicht angegeben ist, kommen in das
unspecified-Band – niemals stillschweigend in das Zytoplasma. Rezeptoren verankern sich auf dem Membran-Band. - Reihenfolge – setzen Sie
orderentsprechend der Pathway-Position (topologische Ordnung, nicht Textordnung); Rückkopplungsschleifen entstehen natürlich als rückwärtsgerichtete Kanten. - Zahlen auf der Leinwand (Expression, Signifikanz) nur, wenn sie wörtlich in der Quelle existieren; andernfalls als explizite Nullwerte in den Datenzuordnungen belassen.
Praktische Extraktionsreihenfolge: einmal lesen für den Gesamtfluss; zweiter Durchgang Satz für Satz für Entitäten + Zitate; dritter Durchgang für Kanten einschließlich Inhibitoren, Rückkopplung und Übersprechen (sie verstecken sich in „allerdings/während“-Sätzen).
Schritt 2 – Modell validieren (Skript)
python scripts/validate_model.py --model /app/work/model.json \
--report /app/work/validation-report.json
Beheben Sie jeden E-*-Fehler. E-DIR-01 (gerichtete Kante ohne Richtungshinweis) ist die zentrale wissenschaftliche Absicherung: entweder einen Satz zitieren, der die Richtung angibt, oder auf ungerichtet + Unsicherheit zurückstufen. Warnungen erfordern eine bewusste Entscheidung: Familien-Knoten, Rezeptorplatzierung, Vorzeichen-vs.-Zitat-Ungereimtheiten. Wiederholen, bis das Modell gültig ist. Wenn das Material ein erforderliches Vertragselement nicht stützen kann, notieren Sie dies jetzt (es wird in Schritt 5 zu einem Nullwert + Begründung).
Schritt 3 – SVG rendern und exportieren (Skripte)
python scripts/render_svg.py --model /app/work/model.json \
--out /app/output/pathway.svg --report /app/work/render-report.json
python scripts/export_assets.py --svg /app/output/pathway.svg \
--outdir /app/output --model /app/work/model.json \
--png-width 2400 --report /app/work/export-report.json
Lesen Sie die Warnungen des Render-Reports (Leinwandgrenzen, unbekannte Kompartments). Betrachten Sie das PNG selbst; wenn das Layout den Mechanismus verschleiert (Kantenkreuzungen verstecken eine Verzweigung, Rückkopplung über der Kaskade), passen Sie order/Pin-Positionen im Modell an und rendern Sie neu. Das SVG ist deterministisch: identisches Modell → identisches SVG.
Schritt 4 – Bearbeitungsszenarien (wenn der Fall Bearbeitungen einer vorhandenen Abbildung verlangt)
Rekonstruieren Sie zuerst das Modell der Ziel-Abbildung (Schritt 1 auf dem Quelltext der Original-Abbildung), verwenden Sie dann quellenerhaltende Bearbeitungen – das Original-Modell/SVG wird gesichert, jede Bearbeitung im change_log des Modells protokolliert:
python scripts/apply_edit.py --model /app/work/model.json --op add-edge \
--id e-new --src A --tgt B --type inhibition --directed true \
--sign negative --loc "..." --quote "..."
Operationen: Entität hinzufügen/umbenennen/entfernen (Entfernen verweigert, wenn Kanten angehängt sind, es sei denn mit --cascade; Kaskadenentfernungen werden als Unsicherheiten protokolliert), Kante hinzufügen/entfernen, Kompartment hinzufügen. Jede hinzugefügte Entität/Kante ERFORDERT wörtliches --loc + --quote. Nach Bearbeitungen erneut validieren (automatisch) und erneut rendern (Schritt 3).
Schritt 5 – result.json verifizieren und finalisieren (Skript + Sie)
python scripts/verify_outputs.py --model /app/work/model.json \
--svg /app/output/pathway.svg --result /app/output/result.json \
--exports /app/output/pathway.png /app/output/pathway.pdf \
--report /app/output/verification-report.json
Dies liest das SVG erneut und prüft Knoten-/Kanten-Rücklesung, Legende↔Nutzung-Konsistenz in beide Richtungen, Label-Überlauf, Leinwandgrenzen, Exportexistenz und dass jeder Nullwert in result.json eine Begründung hat. Finalisieren Sie dann result.json selbst: Füllen Sie die Vertragsfelder (editable_source-Pfade, Exporte mit Backend/Parametern, entity_table/edge_table mit Zitaten, legend_basis, Quellen mit Versionen, Unsicherheiten, Verifikationszusammenfassung, ehrlicher Status). Behalten Sie _unanswered_reasons für alles, was Nullwert ist. Teillieferung muss ihre Grenzen in klaren Worten angeben.
Ausnahmebehandlung (echte Pfade, keine Dekoration)
| Fehler | Erkennung | Aktion |
|---|---|---|
| PDF nicht lesbar / keine Textebene | Parsen schlägt fehl oder leerer Text | pdf-render-tool / ocr-tool für den Render, „Textebene fehlt“ in result.json markieren |
| Entitätsname mehrdeutig (zwei Lesarten) | Ihre Extraktion | nach Kontext wählen, Alternative + Unsicherheit aufzeichnen; wenn unentscheidbar, Nullwert + Begründung |
| Richtung nicht angegeben | E-DIR-01 | Herabstufen auf ungerichtete Kante (keine Pfeilspitze) + Unsicherheit. NIEMALS raten |
| Kompartment unbekannt | E-CMP-01 / Layout-Warnung | unspecified-Band + Notiz |
| Fehlende numerische Daten für datenbasierte Visualisierungen | Modell hat keine wörtlichen Zahlen | Topologie zeichnen, Mapping als Nullwert + „Daten fehlen in der Quelle“ markieren |
| Label-Überlauf | verify label_overflow | Label kürzen / in Label+Untertitel aufteilen / neu anordnen |
| Leinwand überschreitet Grenzen | Render-Warnung | In Panels aufteilen oder Verzweigungen reduzieren; notieren |
| Export-Backend fehlt | Export-Report-Status fehlgeschlagen | Fallback-Kette bereits versucht; SVG liefern, Fehler + Anleitung in result.json aufzeichnen |
| Leeres/degeneriertes PNG | blank_check | Render-Report untersuchen; neu rendern; aufzeichnen |
| Validierungsfehler bestehen | Exit-Code 2 | Modell korrigieren; wenn aus dem Material nicht behebbar, gültige Teilmenge + explizite Grenzen liefern |
Qualitätsbarriere (Selbstkontrolle vor Abschluss)
- Könnte ein Gutachter auf einen beliebigen Pfeil zeigen und dessen wörtliche Begründung aus der eingebetteten Tabelle / dem Modell erhalten? (Rückverfolgbarkeit)
- Sind Aktivierung/Inhibition/Bindung/Modifikation visuell unterscheidbar und stimmt die Legende mit dem Gezeichneten überein – keine fehlenden, keine Phantom-Einträge?
- Ist alles, was nicht angegeben ist, sichtbar als nicht angegeben markiert (ungerichtet, unspecified-Band, Nullwert + Begründung)?
- Kann jemand das SVG öffnen, ein Label ändern und erneut exportieren? (geschichtet, über IDs adressierbar, Standard-Schriftartenstapel)
- Deckt result.json jedes Vertragsfeld mit ehrlichem Status ab?
Dateien
scripts/scaffold_result.py– vertragskonforme result.json mit Nullwert+Begründungscripts/validate_model.py– Schema + Richtungsbelege + Namensprüfungenscripts/render_svg.py– deterministisches, geschichtetes SVG aus model.jsonscripts/export_assets.py– PNG/PDF mit Fallback-Kette + Blank-Prüfungscripts/apply_edit.py– quellenerhaltende, protokollierte Bearbeitungenscripts/verify_outputs.py– Rücklese-Verifikation des gesamten Paketsreferences/edge-types.json– maschinenlesbare Symbol-Semantikenreferences/symbol-semantics.md– visuelle Grammatik und ihre Begründungreferences/naming-rules.md– Gen-/Protein-/Familien-/Komplex-Konventionenreferences/uncertainty-policy.md– Herabstufungsregeln; Niemals-Raten-Richtliniereferences/layout-conventions.md– model.json-Schema + Layout-Algorithmusexamples/ras-mapk-case/– ein ausgearbeitetes Beispiel mit echtem Material (Brown & Ried 2022)README.md– eigenständige Nutzungsdokumentation