egutierrez
a03675113a
- .claude/agents/fn-orquestador/SKILL.md - .claude/commands/fn_claude.md - .claude/rules/INDEX.md - .claude/rules/cpp_apps.md - .claude/rules/ids_naming.md - CHANGELOG.md - apps/dag_engine/README.md - apps/dag_engine/api.go - apps/dag_engine/dags_migrated/example.yaml - apps/dag_engine/dags_migrated/example_lineage_tracking.yaml - ... Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
85 lines
4.7 KiB
Markdown
85 lines
4.7 KiB
Markdown
---
|
|
name: viz_render
|
|
kind: function
|
|
lang: cpp
|
|
domain: viz
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "bool viz::render(const data_table::StageOutput& out, data_table::ViewMode mode, const data_table::ViewConfig& cfg, ImVec2 size = ImVec2(-1,-1), int* clicked_row_out = nullptr)"
|
|
description: "Dispatcher de visualizaciones ImPlot sobre StageOutput. Cada modo (bar/column/pie/donut/funnel/scatter/bubble/heatmap/line/area/stacked/etc.) elige automaticamente columnas relevantes salvo override desde ViewConfig. Hit-test devuelve clicked_row_out para drill-down en los modos que lo soportan."
|
|
tags: [tables, viz, implot, tql, cpp-tables, dispatcher, drilldown]
|
|
uses_functions: []
|
|
uses_types:
|
|
- data_table_types_cpp_core
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: [imgui, implot]
|
|
tested: true
|
|
tests:
|
|
- "first_numeric_col returns -1 on empty output"
|
|
- "first_numeric_col returns 0 for all-numeric output"
|
|
- "first_numeric_col skips string columns"
|
|
- "first_category_col returns -1 on all-numeric output"
|
|
- "first_category_col returns first string column"
|
|
- "extract_numeric returns NaN for unparseable cells"
|
|
- "extract_numeric returns empty for out-of-range col"
|
|
- "extract_category returns empty strings for null cells"
|
|
- "extract_category returns empty for out-of-range col"
|
|
test_file_path: "cpp/tests/test_viz_render.cpp"
|
|
file_path: "cpp/functions/viz/viz_render.cpp"
|
|
framework: imgui
|
|
params:
|
|
- name: out
|
|
desc: "StageOutput del stage activo: headers, types, cells row-major (output de compute_stage o compute_pipeline)"
|
|
- name: mode
|
|
desc: "ViewMode a renderizar: Bar, Column, GroupedBar, StackedBar, Line, Area, Stairs, Scatter, Bubble, Histogram, Histogram2D, Heatmap, BoxPlot, Stem, ErrorBars, Pie, Donut, Funnel, Waterfall, KPI, KPIGrid, Candlestick, Radar"
|
|
- name: cfg
|
|
desc: "ViewConfig con overrides de auto-detect: x_col, y_cols, cat_col, size_col, primary_color, hist_bins, pie_radius, show_legend, show_markers, locked, fit_request"
|
|
- name: size
|
|
desc: "Tamano en pixeles del plot. ImVec2(-1,-1) usa todo el espacio disponible del contenedor ImGui"
|
|
- name: clicked_row_out
|
|
desc: "Output param: si != nullptr y el usuario clico un punto drillable, se escribe el indice de row en StageOutput. -1 si no hubo click. Solo activo en: Bar, Column, Pie, Donut, Funnel, Scatter, Bubble, Heatmap"
|
|
output: "true si el modo fue renderizado correctamente; false si faltan columnas requeridas (se muestra texto de ayuda centrado) o si out esta vacio"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```cpp
|
|
#include "viz/viz_render.h"
|
|
|
|
// Construir StageOutput trivial (3 filas, 2 cols: categoria + numerica)
|
|
data_table::StageOutput out;
|
|
out.headers = {"categoria", "valor"};
|
|
out.types = {data_table::ColumnType::String, data_table::ColumnType::Float};
|
|
out.rows = 3; out.cols = 2;
|
|
// Cells row-major: category0, val0, category1, val1, category2, val2
|
|
static const char* raw[] = {"alfa", "10.0", "beta", "25.5", "gamma", "7.2"};
|
|
for (auto p : raw) out.cells.push_back(p);
|
|
|
|
data_table::ViewConfig cfg;
|
|
int clicked = -1;
|
|
bool ok = viz::render(out, data_table::ViewMode::Bar, cfg,
|
|
ImVec2(-1, 300), &clicked);
|
|
if (ok && clicked >= 0) {
|
|
// clicked = indice de row clicado por el usuario
|
|
}
|
|
```
|
|
|
|
## Cuando usarla
|
|
|
|
Cuando tienes un `StageOutput` (salida de `compute_stage` o `compute_pipeline`) y quieres renderizarlo visualmente en un panel ImGui. El dispatcher elige las columnas correctas automaticamente; usa `ViewConfig` para forzar columnas concretas o cambiar colores/leyenda/zoom.
|
|
|
|
## Gotchas
|
|
|
|
- Requiere contexto ImGui y contexto ImPlot vivos en el hilo actual. Llamar solo desde dentro del loop de render de `fn::run_app` (entre `ImGui::NewFrame()` y `ImGui::Render()`).
|
|
- El hit-test (`clicked_row_out`) solo esta activo en los modos: Bar, Column, Pie, Donut, Funnel, Scatter, Bubble, Heatmap. En el resto de modos `*clicked_row_out` queda en -1.
|
|
- Thread-safety: render DEBE llamarse desde el mismo hilo que `ImGui::NewFrame()`. No hay mutex interno.
|
|
- Para ViewMode::Table la funcion devuelve `false` inmediatamente (la tabla se renderiza con `table_view_cpp_viz`, no con este dispatcher).
|
|
- `cfg.fit_request` es `mutable`: la funcion lo consume (pone a false) al hacer el fit. Si pasas un `const ViewConfig&` el campo mutado no se propaga al caller salvo que sea el mismo objeto.
|
|
- Modo Candlestick asume que las 4 primeras columnas numericas son O/H/L/C en ese orden. Modo Radar usa solo la primera fila como poligono.
|
|
|
|
## Tests parciales
|
|
|
|
`render()` requiere ImPlot context vivo — no se puede ejercitar sin ventana. Los tests de este archivo cubren las funciones helper puras (`first_numeric_col`, `first_category_col`, `extract_numeric`, `extract_category`) que no dependen de ImGui/ImPlot. Smoke real del dispatcher via `primitives_gallery --capture` (golden images, issue 0048).
|