[jqnatividad]

Stacked on #4839 (parcoords), which is stacked on #4838 (the plotly.rs pin bump). Retarget to master once both merge.

What's new

• viz barpolar: a polar bar chart (wind rose). One bar per --x category, clockwise from north.
  • Bar length is the --agg of --y (sum by default), or the row count when --y is omitted. --agg sum/mean/min/max without --y is a usage error.
  • --series stacks colored segments. When every series label starts with a number (0-10, 10-20, 30+), they stack low to high; otherwise first-appearance order.
  • Angular placement:
    • Compass labels (N, NE, NNE…, case-insensitive) sit at their true bearings on a full 8- or 16-point rose, so a direction with no data stays an empty slot instead of shifting the others.
    • Other categories get evenly spaced slots in first-appearance order (numeric labels sort ascending). The axis is forced to category, because plotly would otherwise read hour or month numbers as degrees and bunch them into a narrow wedge.
    • --degrees (new option, barpolar only) reads a numeric --x as a true bearing on a linear angular axis, folding 360 onto 0. A non-numeric value is an error, and --degrees on any other chart is a usage error.
  • Negative totals are rejected, as in viz funnel.
• viz smart seasonality panel:
  • Draws one BarPolar bar per hour, day or month instead of a filled ScatterPolar ring, so each phase is its own hover target ("Thu, 1.44× average").
  • Now reads like a 24-hour dial: the first phase (00h, Mon, Jan) at the top, running clockwise. It previously started at 3 o'clock and ran counterclockwise (plotly's default), which an hour ring invites misreading as a clock.
  • The panel is HTML-only, so there is no static-export twin to change.
• plotly.rs pin moved to 3223bd7 (two commits added to Release 0.15.0: complete plotly.js 3.7 trace coverage, remove kaleido/EPS, dependency security bumps plotly/plotly.rs#442):
  • The polar layout structs no longer serialize unset fields as null.
  • The plotly_dark template now styles polar and ternary subplots, matching plotly.py. Before this, viz radar and viz barpolar with --theme plotly_dark drew a white polar disc on the dark page; viz radar already did this on master. Ternary is covered for the upcoming viz ternary. 3D-scene styling is still missing, because plotly.rs axes have no background attributes yet.
• No new i18n keys: the count label reuses viz.chart.count, and the panel hover reuses viz.hover.polar_index.
• Regenerated docs/help/viz.md and qsv-viz.json (new subcommand, --degrees, the --series/--agg descriptions, two examples).

Gallery

• New wind rose figure from a synthetic wind_obs.csv (1,440 hourly observations, prevailing south-westerlies), listed in the README dataset table.
• The four dashboards with a seasonality panel (smart_allegheny_dogs, smart_nyc311, smart_timeseries, smart_wpa_211_requests) are regenerated for the clock-face polar bars. Dashboards whose only regen diff was timestamps were not committed.

Not regenerated

The Pittsburgh, Boston and Brazil link-out dashboards (pitt311data.html, smart_boston_311_2025.html, smart-brazil-lpg-4-semanas.html) keep the old line rings: their source data isn't committed.

Verification

• cargo t viz -F all_features: 485 unit and 654 integration tests pass. 7 new barpolar integration tests; the 8 seasonality tests now assert barpolar and the clock-face axis on every ring.
• Mutation-checked: reverting the panel to ScatterPolar, disabling compass placement, the 16-point rose, --degrees normalization and its linear axis, the numeric slot sort, the sum default, the binned-series sort and the clockwise direction each fails a test.
• scripts/double-run-check.py --check OK; cargo +nightly fmt; clippy reports no warnings on added lines; cargo build --locked (the lockfile change is only the three plotly entries); qsvlite builds.
• In Chrome: wind rose by compass names (with gaps) and by --degrees, the gallery figure, three dashboards' seasonality panels (hover, clock layout, three side-by-side rings), and dark-theme barpolar/radar.

The wiki Visualization page update is staged locally and will be pushed after merge.

🤖 Generated with Claude Code

[codacy-production]

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

_{NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.}