schemdraw — Esquemas Científicos Editables con Trazabilidad hasta la Fuente
Ruta del script: Esta habilidad está instalada en
/skills/weekly-skill/, la ruta absoluta del script es/skills/weekly-skill/scripts/(el directorio de trabajo es/app/work, no uses rutas relativas).
Produce una figura que sea correcta, editable y conforme a la exportación: cada entidad/relación se traza hasta el material, la leyenda coincide con los datos, el texto permanece seleccionable y las exportaciones cumplen con la resolución objetivo. El modo de fallo que esta habilidad busca prevenir: una imagen bonita con relaciones de entidades incorrectas, nombres de genes o concentraciones inventados, una leyenda que contradice los datos y una salida solo en mapa de bits que no se puede editar.
Método en una línea: extraer entidades/relaciones del material → organizarlas como un SVG en capas (agrupado, texto seleccionable, dirección de flecha según tipo de relación) → construir el gráfico a partir de los mismos datos fuente con leyenda explícita/mapa de colores → exportar PDF+PNG → validar trazabilidad y contrato de exportación.
Cuándo usarlo
- Entrada: un archivo de caso (por defecto
/input/case.json) con el material científico, listas opcionales de entidades/relaciones, datos del gráfico y especificaciones de exportación. - Salida: en
/app/output—figure.svg,chart.svg,figure.pdf,figure.png,entities.json,export_report.json,validation.json,result.json. - El SVG es la fuente editable; PDF/PNG son exportaciones.
Pipeline (ejecutar en orden)
Fase 1 — Extraer y dibujar
python3 /skills/weekly-skill/scripts/schem.py --case /input/case.json --work /app/work
- Lee cada material (texto/Markdown), fusiona las
entidades/relacionesproporcionadas con relaciones extraídas mediante patrones:X activa|promueve|estimula Y,X inhibe|suprime|bloquea Y,X -> Y,X --| Y,X se une|interactúa con Y,X contiene|incluye Y. - Cada relación lleva
procedencia(patrón-de-texto+ la cita fuente) o proviene de la lista proporcionada. - Escribe
entities.jsony unfigure.svgen capas:<g id="arrows">condata-source/data-target/data-type,<g id="nodes">con un grupo por entidad y etiquetas<text>. El color/tipo de línea de la flecha codifica el tipo de relación (verde = activación, rojo = inhibición, discontinua = contención). - Si el caso tiene datos de gráfico, escribe
chart.svgcuyas barras llevandata-label/data-valuey cuya leyenda usa el mismo índice de paleta que las barras.
Fase 2 — Exportar
python3 /skills/weekly-skill/scripts/export.py --work /app/work --dpi 300
LibreOffice en modo cabeza convierte SVG → PDF (vectorial, texto seleccionable); PyMuPDF rasteriza PDF → PNG a los DPI solicitados. Escribe export_report.json. Si falta LibreOffice, el informe lo indica y el estado se vuelve parcial — nunca un fallo silencioso.
Fase 3 — Validar
python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work
Verifica:
- cada extremo de relación es una entidad declarada (sin flechas colgantes);
- cada relación tiene procedencia o una cita fuente;
- las etiquetas y valores de la leyenda del gráfico coinciden exactamente con los datos fuente;
- el SVG tiene
<text>(seleccionable) y ≥2 capas; - las exportaciones PDF y PNG existen y el PNG no es sospechosamente pequeño.
Fase 4 — Copiar entregables
mkdir -p /app/output
cp /app/work/figure.svg /app/work/chart.svg /app/work/figure.pdf /app/work/figure.png \
/app/work/entities.json /app/work/export_report.json /app/work/result.json /app/output/
# validation.json lo escribe validate.py; cópialo también si está presente
Reglas que deben cumplirse
- Las entidades provienen del material. No se inventan nombres de genes, concentraciones o puntos de tiempo; cualquier cosa que agregue el modelo debe tener fuente y estar marcada.
- La dirección de la relación son datos.
A activa Bse dibuja A → B, nunca al revés; el tipo de flecha sigue el tipo de relación. - Consistencia leyenda ⇄ datos. Las etiquetas y colores de la leyenda provienen del mismo arreglo que las barras; cambiar los datos cambia la leyenda.
- Fuente editable + exportación conforme. Siempre entregar el SVG (editable) y el PDF/PNG (exportación) juntos.
- La exportación se verifica, no se asume. Los DPI, la incrustación de fuentes y la existencia de archivos se registran; una exportación fallida se informa.
Manejo de excepciones
| Situación | Comportamiento |
|---|---|
| Sin material / vacío | lista de entidades vacía; el SVG aún se escribe con un título |
| Extremo de relación desconocido | se mantiene en entities (añadido desde el patrón) y se dibuja |
| Datos de gráfico faltantes | chart.svg se omite; entities.json.chart_svg = null |
| LibreOffice faltante | PDF/PNG faltan, export_report.status = partial, limitación registrada |
| Sin relaciones | SVG solo con nodos; la validación anota 0 relaciones |
Autocomprobación
python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work
python3 -c "import json;e=json.load(open('/app/work/entities.json'));print(len(e['entities']), len(e['relations']), e['relation_counts'])"
Se requiere valid: true; el modelo debe rellenar cualquier entidad/relación que el extractor determinista haya omitido, siempre con una fuente.