Visualization Export

---
name: visualization-export
description: "Construct and export Lux Clause, Vis, and VisList visualizations."
disable-model-invocation: true
metadata:
  disco-role: operating
license: Apache 2.0
---

# Lux visualization export router

Use this sub-skill when the user needs to construct Lux `Clause`, `Vis`, or `VisList` objects directly; enumerate wildcard visualization collections; refresh a visualization against a new dataframe; or export chart code/specifications from an individual `Vis`.

## Route here for

- Creating a single visualization with `lux.vis.Vis.Vis` and intent strings or `Clause` objects.
- Creating a collection with `lux.vis.VisList.VisList`, including wildcard `"?"`, list-valued attributes, and manually composed lists of `Vis` objects.
- Exporting a single `Vis` with `to_altair(standalone=False)`, `to_matplotlib()`, `to_vegalite(prettyOutput=True)`, or `to_code(language=...)`.
- Handling special-character columns, long labels, and the difference between `df.exported[0]` as a `Vis` and multiple exported widget selections as a `VisList`.
- Explaining `VisList.sort`, `showK`, `normalize_score`, `refresh_source`, `map`, `get`, and the present-but-not-implemented `set` method.

## Route elsewhere

- Pandas import-hook basics, dataframe intent, recommendations, `df.recommendation`, and `df.current_vis`: use `pandas-intent-recommendations`.
- Global plotting backend, plot style, chart scale, label length, top-k, sort, widget setup, and custom recommendation actions: use `configuration-actions`.
- Semantic data types, datetime/geographic/id behavior, groupby/index views, and type overrides: use `special-data-types`.
- PostgreSQL-backed `LuxSQLTable` or SQL export workflows: use `sql-backend`.

## Required references

Read these bundled references before giving detailed guidance:

1. `references/api-reference.md` for verified Lux 0.5.1 signatures and method behavior.
2. `references/workflows.md` for construction, wildcard, refresh, export, standalone-data, and `df.exported` workflows.
3. `references/troubleshooting.md` for multi-visualization errors, export failures, special-character columns, long labels, stale sources, and unsupported code-export languages.

A safe offline smoke script is bundled at `scripts/vis_export_smoke.py`. Use it to verify that the installed Lux package can construct `Clause`, `Vis`, and `VisList` objects and emit Altair, Matplotlib, and Vega-Lite export tokens on a tiny local dataframe.