plotly / plotly/plotly.rs

Tracking: trace types not yet exposed in plotly.rs (plotly.js 3.7.0 parity)

Đang mở
#422 3 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Ngôn ngữ chính
Rust
Star
1.5k
Fork
128
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Mô tả

Tracking: trace types not yet exposed in plotly.rs (plotly.js 3.7.0 parity)

Summary

Measured against the actively-supported trace types in plotly.js 3.7.0, plotly.rs exposes 27 of 46, leaving 19 unimplemented. This issue tracks the remaining trace types so contributions can be coordinated and duplicate work avoided.

plotly.js 3.7.0 defines 49 trace types, but 3 are deprecated (the Mapbox family — see below) and are excluded from the parity target. The list was generated by diffing the trace type tags plotly.rs can serialize (the PlotType enum) against the authoritative plot-schema.json shipped with plotly.js v3.7.0.

Note: this is trace-type coverage. Attribute-level parity for the already-implemented traces is being addressed separately in the plotly.js 3.7 attribute backfill work.

Deprecated in plotly.js 3.7.0 — excluded from parity (3)

These are deprecated upstream in favour of the MapLibre map subplot traces (migration guide):

Deprecated trace Recommended replacement plotly.rs status
scattermapbox scattermap both already exposed
densitymapbox densitymap both already exposed
choroplethmapbox choroplethmap replacement already exposed; deprecated trace not implemented (and won't be)

plotly.rs already ships every recommended map replacement, so there is no coverage gap here — no action needed. The two deprecated traces that are implemented (scattermapbox, densitymapbox) can be retained for back-compat and eventually deprecated in lockstep with upstream.

Currently exposed — actively-supported (27)

bar · box · candlestick · choropleth · choroplethmap · contour · densitymap · heatmap · histogram · histogram2dcontour · image · mesh3d · ohlc · pie · sankey · scatter · scatter3d · scattergeo · scattergl · scattermap · scatterpolar · scatterpolargl · sunburst · surface · table · treemap · violin

(plus the deprecated scattermapbox and densitymapbox, listed above)

Missing — actively-supported (19)

3D scientific / volumetric

  • cone — 3D vector / quiver fields
  • streamtube — 3D flow streamlines
  • isosurface — 3D isosurfaces from volume data
  • volume — 3D volume rendering

Carpet family (needs a shared carpet-axis abstraction)

  • carpet — base carpet axis system
  • contourcarpet — contours on a carpet axis
  • scattercarpet — scatter on a carpet axis

Cartesian statistical / financial

  • histogram2d — 2D histogram heatmap
  • funnel — funnel charts
  • waterfall — waterfall / bridge charts

Parallel-coordinate

  • parcoords — parallel coordinates (continuous)
  • parcats — parallel categories (categorical)

Specialized subplots

  • barpolar — bar charts on a polar axis (wind-rose)
  • scatterternary — scatter on a ternary (3-component) plot
  • scattersmith — scatter on a Smith chart (RF / impedance)

Hierarchical

  • icicle — icicle charts (sibling of sunburst / treemap)

Other

  • indicator — KPI gauges / number + delta displays
  • splom — scatter-plot matrix
  • funnelarea — funnel-area (pie-like funnel)
Suggested prioritization
  • Cheap wins — close siblings of existing traces that can reuse most of their building blocks: histogram2d (cf. histogram2dcontour / heatmap) and icicle (cf. sunburst / treemap).
  • High user demand — common business-chart types: indicator, funnel, waterfall, barpolar.
  • Larger effort — the carpet family (carpet + contourcarpet + scattercarpet) depends on first modelling a shared carpet-axis abstraction.
Notes for implementers

Adding a trace follows the established pattern (see CONTRIBUTING.md / CLAUDE.md):

  1. Create plotly/src/traces/<name>.rs, derive FieldSetter with #[field_setter(box_self, kind = "trace")].
  2. Add the corresponding PlotType variant (with the correct serde rename).
  3. Implement Trace::to_json, then re-export from traces/mod.rs and lib.rs.
  4. Add a serialize round-trip test and a CHANGELOG.md entry.

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Hướng nghiên cứu

Bắt đầu với CONTRIBUTING.md và CLAUDE.md, sau đó kiểm tra một trace hiện có trong plotly/src/traces/ và enum PlotType. Chọn một loại trace chưa được đánh dấu, rồi thêm module trace, biến thể enum, các export, bài kiểm tra round-trip serialization và mục nhập trong CHANGELOG.md theo mẫu đã được thiết lập. Hoàn tất khi trace đã chọn được expose và serialize chính xác.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
rust
Lĩnh vực
data-visualization
Loại issue
Tính năng
Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức độ hoạt động
Ít trao đổi
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
38/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.