Docs: plotting examples should capture returned fig/ax and not close figures
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 66/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- python
- Domain
- documentation
Research direction
Start with the docstring_todos_20260312.md checklist referenced in the issue and locate the listed method docstrings in the Pyleoclim package. Update each plotting example to capture returned figure and axes objects, use axs for the dict-like axes in GeoSeries.map, and remove the figure-closing calls. Done means all listed examples follow the conventions and display their plots in the documentation.
Written by the indexing model from the issue text.
Description
Part of #689 (checklist docstring_todos_20260312.md). Line numbers in that checklist have drifted, so items are listed by method.
Following the convention fig, ax = obj.plot() in docstring examples:
Examples that don't capture the returned objects
-
Coherence.plot(coh.plot(),coh_sig.plot()) -
Coherence.dashboard(coh_sig.dashboard()) -
Coherence.signif_test(coh_sig.plot(),coh_sig2.plot()) -
GlobalCoherence.signif_test(gcoh_sig.plot()) -
GlobalCoherence.plot(gcoh.plot()) -
EnsembleSeries.correlation(corr_res.plot()) -
GeoSeries.segment(mgs.plot()) -
MultipleGeoSeriesclass docstring (Euro2k.map()) -
MultipleGeoSeries.map(Euro2k.map()) -
MultipleGeoSeries.pca(res.modeplot(),res.screeplot()); also split the two plots into separate cells -
MultipleSeries.spectral(ms_psd.plot()) -
PSD.plot(psd_sim.plot()) -
Resolution.plot,Resolution.histplot,Resolution.dashboard -
Series.wavelet_coherence(coh.plot(),coh_wwz.plot(),cwt_sig.dashboard()) -
Series.global_coherence(gcoh.plot()) -
Series.resolution(resolution.dashboard(),.histplot(),.plot())
Dict-like axes captured as ax; use axs
-
GeoSeries.map: three examples (fig, ax = ts.map(...))
Examples that close figures (hides the output in the docs)
-
Series.plot:...; pyleo.closefig(fig) -
Series.summary_plot:pyleo.closefig(fig)
- Dominant language
- Python
- Stars
- 104
- Forks
- 36
- Avg merge
- 1d 7h
- Merged PRs (30d)
- 5
Getting set up
Starts the project's dev container in your browser, under your own GitHub account.
- No Dockerfile or Docker Compose file
- No pull request template
- No contributing guide
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 LinkedEarth/Pyleoclim_util
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
LinkedEarth/Pyleoclim_util#718 ·
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
LinkedEarth/Pyleoclim_util#717 ·
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
LinkedEarth/Pyleoclim_util#716 ·
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
LinkedEarth/Pyleoclim_util#715 ·
-
Broken doc linkOpendocumentation help wanted
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
LinkedEarth/Pyleoclim_util#704 ·
All issues in LinkedEarth/Pyleoclim_util
Similar issues
-
5-minutes algorithm all-levels any-language beginner-friendly community documentation easy first-timers-only good first issue hacktoberfest help wanted learning no-code-needed open-source python students
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Huerte/algo-solutions-python#281 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
apache/flink-agents#1395 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
pybamm-team/PyBaMM#6061 ·
Maintainers usually reply within 2 days
-
A wall-clock ceiling in test_rest_import_off_the_loop turns the gate red on unrelated pull requestsOpenbug help wanted quality
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
pyrite-wiki/pyrite#1550 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
daniel-ospina/tortoise#13049 ·
Maintainers usually reply within 1 day