`to_png()` static export loses title/subtitle/axis ticks/labels/legend when a layer uses `linetype=0`
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 62/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Quiet
- Domain
- data-visualization
Research direction
Start with the static export path reached by ggplot.to_png() or ggsave(..., format="png") and compare it with _repr_html(); reproduce the minimal geom_segment case using linetype=0. Trace how that parameter affects rendering, then verify that the PNG retains the title, subtitle, axes, gridlines, and legend while hiding only the connector.
Written by the indexing model from the issue text.
Description
Summary
I have been experiencing an odd behavior when a plot contains any layer with linetype=0 (I have been using this "trick" to annotate (think markers of interesting things) my plots by making a line invisible while still showing e.g. an arrowhead via arrow=... - this is legacy code that I have built upon, I am certain there might be better ways nowadays), the static PNG export (ggplot.to_png() / ggsave(..., format="png"), Only the raw geometry (bars, points, the visible arrowhead, etc.) is drawn.
The interactive HTML/JS rendering (_repr_html_(), browser display) is not affected — the plot renders correctly there. This makes the bug easy to miss during development (e.g. in Jupyter or a web app preview) and only surface when exporting a static image (e.g. for embedding into PowerPoint, PDF, or email reports).
Environment
lets-plotversion: 4.11.0- OS: Linux (reproduced in a headless container)
- Python: 3.12
Minimal Reproduction
The following code is a derivation
from io import BytesIO
import pandas as pd
import lets_plot as lp
df = pd.DataFrame({
"x": ["A", "B", "C", "D"],
"y": [10, 20, 15, 25],
})
# BROKEN: linetype=0 on geom_segment wipes out title/subtitle/axis ticks/labels/legend
p_broken = (
lp.ggplot(df, lp.aes(x="x", y="y"))
+ lp.geom_bar(stat="identity")
+ lp.theme_bw()
+ lp.labs(title="Title is missing", subtitle="Subtitle is missing too",
x="X axis label missing", y="Y axis label missing")
+ lp.ggsize(800, 500)
+ lp.geom_segment(x=2, y=25, xend=3, yend=25, linetype=0, arrow=lp.arrow(type="closed"))
)
with open("broken.png", "wb") as f:
p_broken.to_png(f)
# WORKING: identical plot, only difference is the segment keeps its default linetype
p_ok = (
lp.ggplot(df, lp.aes(x="x", y="y"))
+ lp.geom_bar(stat="identity")
+ lp.theme_bw()
+ lp.labs(title="Title is missing", subtitle="Subtitle is missing too",
x="X axis label missing", y="Y axis label missing")
+ lp.ggsize(800, 500)
+ lp.geom_segment(x=2, y=25, xend=3, yend=25, arrow=lp.arrow(type="closed"))
)
with open("ok.png", "wb") as f:
p_ok.to_png(f)
Expected Result
Both broken.png and ok.png should render identically apart from the visibility of the connecting line segment (hidden vs. visible), i.e. both should show:
- Title: "Title is missing"
- Subtitle: "Subtitle is missing too"
- X axis label + tick labels (A, B, C, D)
- Y axis label + tick labels (0-25)
- Gridlines from
theme_bw()
Actual Result
ok.png(nolinetype=0): renders correctly — title, subtitle, axis ticks/labels, gridlines all present.
broken.png(withlinetype=0on thegeom_segmentlayer): title, subtitle, axis ticks, axis labels, and gridlines are all missing. Only the bare bar geometry (and the arrowhead) is drawn on a blank canvas.
Additional Notes
- This issue shall not serve as a canvas to argue about the actual purpose of the borderline edgecase of linetype=0 on a segment geometry. It shall purely show the unexpected behavior of basically destroying any plot information such as title, subtitle, labels, ticks, etc.
- The interactive/HTML rendering path (
_repr_html_()) rendersp_brokencorrectly — this appears to be isolated to the static Skia PNG export path only. - We discovered this while exporting plots with an "arrow pointing at the last data point" annotation pattern:
which is a common idiom for hiding the connecting line while keeping only the arrowhead visible. Removinglp.geom_segment(x=x0, y=y0, xend=x1, yend=y1, arrow=lp.arrow(type="closed"), linetype=0, show_legend=False)linetype=0(accepting a visible connector line, or using an alternative to hide it, e.g.alpha=0— untested) avoids the bug. - Bisection confirmed:
arrow=...alone: not the cause.fill="white"on the segment: not the cause.linetype=0: is the cause — removing only this parameter (keeping everything else identical) fixes the export.
- This was reproduced consistently across multiple real-world plots (bar charts with
theme_bw(), discrete x-axis with 50+ categories,ggtb()toolbar, legend fromscale_fill_manual()), not just the minimal example above, so it does not appear to depend on plot complexity/data volume — the minimal repro triggers it with a trivial 4-row dataset.
Impact
Any application that exports lets-plot charts to static images (PNG/PDF/PPTX embedding, etc.) using this common "hide line, show arrow" pattern will silently produce images missing critical context (title, axis meaning, legend), which can be misleading in reports/dashboards if not caught visually.
- Dominant language
- Kotlin
- Stars
- 1.8k
- Forks
- 63
- PR merge metrics
- No merged PRs in 30d
Getting set up
This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from JetBrains/lets-plot
-
SyntaxWarning upon library importPossibly taken @Shriraj1901 claimed this 12 days ago. Open
Difficulty 1/5 Under an hour Newbie friendliness 78/100
-
Difficulty 3/5 1-2 days Newbie friendliness 57/100
-
Difficulty 3/5 1-2 days Newbie friendliness 67/100
-
Difficulty 3/5 1-2 days Newbie friendliness 65/100
-
Difficulty 4/5 3-5 days Newbie friendliness 52/100
All issues in JetBrains/lets-plot
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
AlfaazPlus/QuranApp#752 · 2 comments ·
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
theopenconversationkit/tock#2148 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
music-assistant/mobile-app#1393 · 2 comments ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 67/100