Charts: add scatter charts (chartType "scatter")
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 68/100
- Issue 类型
- 功能
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- python
调研方向
Start with _add_chart in sdpm/sdpm/engine/builder/elements/chart.py and the named chart round-trip tests in tests/test_chart_roundtrip.py; check how chart data and series colors are currently built. Then trace chart extraction in sdpm/sdpm/engine/converter/chart.py and scatter validation in sdpm/sdpm/engine/schema/lint.py. Done when the listed scatter round-trip, lint, and edit-rebuild cases pass, along with make lint and uv run pytest tests/test_chart_roundtrip.py -v.
由索引模型根据 Issue 内容生成。
描述
What problem would this solve?
Native charts support chartType bar, line, pie and donut only, and all of them plot values against categories. A scatter chart plots two numeric variables against each other (latency vs. payload size, cost vs. throughput, before/after benchmarks), which a category chart cannot show. python-pptx builds scatter charts natively (XL_CHART_TYPE.XY_SCATTER with XyChartData). Today a chartType: "scatter" silently becomes a bar chart (see TestInvalidInput::test_unknown_chart_type_degrades_to_bar).
Proposed solution
Add chartType: "scatter". Its series carry points ([x, y] pairs) instead of values, and it takes no categories:
{
"type": "chart", "chartType": "scatter",
"x": 192, "y": 216, "width": 1536, "height": 700,
"series": [
{"name": "Lambda", "points": [[128, 45], [256, 30], [512, 22], [1024, 18]], "color": "#FF9900"},
{"name": "Fargate", "points": [[128, 60], [512, 35], [1024, 25]], "color": "#41B3FF"}
],
"legend": true,
"valueAxis": {"min": 0},
"title": "Latency (ms) by memory (MB)"
}
- Markers only (
XL_CHART_TYPE.XY_SCATTER); seriescoloris the marker colour;style.markerSizeapplies. Connecting lines (XY_SCATTER_LINES*,XY_SCATTER_SMOOTH*) are out of scope for this issue. valueAxisapplies to the Y axis as it does today. X-axis options can come in a follow-up; keep the default X axis in this issue.
Files to touch:
sdpm/sdpm/engine/builder/elements/chart.py(_add_chart): build the data withXyChartData(add_series(name)thenseries.add_data_point(x, y)) whenchartTypeisscatter, add it to thetype_map, and colour the series markers. The current code always buildsCategoryChartDataand generates placeholder categories, so this is the main change.sdpm/sdpm/engine/converter/chart.py(extract_chart_element): mapXY_SCATTERintype_mapand read each series' points. python-pptx'sseries.valuesgives the Y values only; read X from the series'c:xValelement. Writepoints, notcategories/values.sdpm/sdpm/engine/schema/lint.py: addscatterto_CHART_TYPES, update the "Specify bar, line, pie, or donut" message, skip the categories/values length check for scatter, and flag a scatter series withoutpoints.- Docs: the chart section of
sdpm/references/guides/slide-json-media.md(chartTypelist, thepointsshape, guide list), and a newsdpm/references/guides/chart-scatter.mdmodelled onchart-line.md. If you add the guide, also add it next tochart-bar/chart-line/chart-pieinsdpm/references/guides/slide-json-spec.mdandsdpm/references/workflows/composer.md. CHANGELOG.md: an entry under[Unreleased]→Added.
Done when
-
chartType: "scatter"builds ac:scatterChart, andpptx_to_jsonreads it back aschartType: "scatter"with series names,points(in order) and colours intact. - An edited scatter chart (a changed point) is rebuilt from its JSON, not restored from
_chartXml. -
TestInvalidInput::test_unknown_chart_type_degrades_to_baruses another unknown type name instead ofscatter. - Lint accepts
scatterand still rejects unknown types. -
make lintanduv run pytest tests/test_chart_roundtrip.py -vpass.
Tests to copy: TestChartTypes::test_line_markers, TestSeriesAndCategories::test_non_ascii_and_float_values and TestColors::test_line_series_color in tests/test_chart_roundtrip.py (they use _one_chart / _built_chart, no LibreOffice needed).
Which area?
Slide generation / engine (layouts, elements, charts)
🤖 Created by Kiro Crew
- 主要语言
- Python
- 星标
- 136
- 派生
- 13
- 平均合并
- 7 小时 36 分钟
- 30 天内合并 PR
- 175
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
aws-samples/sample-spec-driven-presentation-maker 的其他 Issue
-
Charts: setting `valueAxis` skips theme styling of axis labels and axis lines可能已有人在做 @ShotaroKataoka 于 1 天前认领。 未关闭bug
难度 3/5 1-2 天 新手友好度 67/100
aws-samples/sample-spec-driven-presentation-maker#630 ·
维护者通常 1 天内回复
-
enhancement
难度 4/5 3-5 天 新手友好度 50/100
aws-samples/sample-spec-driven-presentation-maker#627 ·
维护者通常 1 天内回复
-
Charts: add radar charts (chartType "radar")可能已有人在做 @tridev-tej 于 4 天前认领。 未关闭enhancement good first issue
难度 4/5 3-5 天 新手友好度 25/100
aws-samples/sample-spec-driven-presentation-maker#621 ·
维护者通常 1 天内回复
-
enhancement good first issue
难度 3/5 1-2 天 新手友好度 77/100
aws-samples/sample-spec-driven-presentation-maker#620 ·
维护者通常 1 天内回复
-
Make the element JSON round trip match the docs (4 small fixes)可能已有人在做 @Vedant-200 于 5 天前认领。 未关闭enhancement good first issue
难度 3/5 1-2 天 新手友好度 35/100
aws-samples/sample-spec-driven-presentation-maker#586 ·
维护者通常 1 天内回复
查看 aws-samples/sample-spec-driven-presentation-maker 的全部 Issue
相似的 Issue
-
难度 1/5 1-3 小时 新手友好度 76/100
samuelclay/NewsBlur#2214 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
MODEL_NOT_FOUND gives no suggestion for a model listed only as model:profile可能已有人在做 @ShaiShmuel 今天认领。 未关闭enhancement rust
难度 2/5 1-3 小时 新手友好度 65/100
superlinked/sie#985 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 88/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
readthedocs/readthedocs-builder#73 ·
维护者通常 1 天内回复