docs: add Combo Charts visualization page - #333
Draft
jswir wants to merge 3 commits into
Draft
Conversation
Document the new # combo_chart dual-axis chart type (malloydata/malloy#3008): two measures on two independent y-axes (bars + line) for comparing measures with different units or magnitudes. - New src/documentation/visualizations/combo_charts.malloynb with a properties table and runnable examples (smart defaults, explicit channels/swapped marks, axis pinning, line styling, neutral axes, embedded tags, nested-in-table). - Table-of-contents entry after Line Charts.
I, James Swirhun <james@credibledata.com>, hereby add my Signed-off-by to this commit: d2fab75 Signed-off-by: James Swirhun <james@credibledata.com>
The '# combo_chart { ... }' example spanned multiple lines, but Malloy's
'#' tag terminates at the newline, so only '# combo_chart {' was parsed.
Use the '#| ... |#' block-annotation form, which dedents and concatenates
its body into a single valid combo_chart tag.
Signed-off-by: James Swirhun <james@credibledata.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a Combo Charts page to the visualization docs for the new
# combo_chartdual-axis chart type introduced in malloydata/malloy#3008 — two measures on two independent y-axes (bars + line), for comparing measures with different units or magnitudes (volume vs. rate, count vs. dollars).src/documentation/visualizations/combo_charts.malloynb: a properties table plus runnable examples using the existingflightssample — smart defaults, explicit channels with swapped marks, the crossover pitfall + axis pinning (y.min/y2.min), line styling (line_width/points), neutral axes (color_axes=false), embedded# y/# y2tags, and nested-in-table.src/table_of_contents.json: entry after Line Charts.Content mirrors the in-repo
renderer_tags_overview.md/renderer_tag_cheatsheet.mdupdates that ship in malloydata/malloy#3008, adapted into executable notebook examples.The
# combo_charttag is only understood by a@malloydata/renderbuild that includes the plugin from malloydata/malloy#3008. This site currently pins:At that version the notebook will not render — the
# combo_charttag falls back / errors. To un-block:@malloydata/renderrelease is cut that includes it. The render package is at0.0.426in-repo today (latest published0.0.425), so the release including #3008 will be0.0.426+ (whatever the actual release number is when it merges).@malloydata/malloyand@malloydata/renderinpackage.json(they release in lockstep at the same version) to that release, and refresh the lockfile — ideally as its own commit so the version bump is reviewable separately from the doc page.Only then does the page render live, and this PR can come out of draft. The Malloy queries in the notebook are valid today; only the
# combo_chartrendering depends on the bump.Test plan
table_of_contents.jsonvalidated as JSON.dep_delay,distance,dep_time,carriers.nickname) againstdata/flights.parquet.