Skip to content

Enhance PlotNado with new features, examples, and improvements#33

Merged
alsmith151 merged 2 commits into
mainfrom
docs/update-examples-in-docs
May 27, 2026
Merged

Enhance PlotNado with new features, examples, and improvements#33
alsmith151 merged 2 commits into
mainfrom
docs/update-examples-in-docs

Conversation

@alsmith151

Copy link
Copy Markdown
Owner

This pull request refactors the documentation and example import structure to improve clarity, maintainability, and user experience. The main changes include removing the local docs/_examples.py in favor of re-exporting from plotnado.examples, updating all documentation to use the new import path, and adding a new "Worked Examples" page with real-data demos. There are also minor improvements to navigation and formatting.

Documentation and Example Import Refactor:

  • Removed docs/_examples.py and replaced it with a shim that re-exports all names from plotnado.examples, ensuring that documentation and user code share the same source of example data and functions.
  • Updated all documentation files to import example data/functions from plotnado.examples instead of docs._examples, and added explanatory comments to code blocks for clarity. [1] [2] [3] [4] [5] [6] [7]

New and Improved Documentation Content:

  • Added a new docs/examples.qmd page ("Worked Examples") featuring real-data demos using public Blueprint Epigenome BigWig/BigBed files, showcasing advanced figure construction and usage.
  • Added an "Examples" entry to the navigation sidebar in _quarto.yml for easy access to the new page.

Formatting and Navigation Tweaks:

  • Changed the default page layout in _quarto.yml from full to article for improved readability and consistency.

These changes streamline the documentation, make it easier for users to find and use example code, and provide richer, real-world usage demonstrations.

- Updated index.qmd to include a new example figure using GenomicFigure.
- Added a new BED file for candidate peaks in the data directory.
- Introduced a register_genome function to allow users to register custom genome files.
- Enhanced Bigwig and Bed aesthetics to support binning options.
- Improved label positioning for BED tracks with new BedLabelPosition enum.
- Added synthetic data generation functions for testing and examples.
- Updated tests to cover new genome registration functionality and ensure proper error handling.
- Refactored code for better readability and maintainability.
@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

❌ Patch coverage is 29.58580% with 119 lines in your changes missing coverage. Please review.
✅ Project coverage is 79.09%. Comparing base (cce6fbc) to head (a61be42).

Files with missing lines Patch % Lines
plotnado/examples.py 0.00% 81 Missing ⚠️
plotnado/tracks/bigwig.py 30.00% 21 Missing ⚠️
plotnado/tracks/peaks.py 0.00% 9 Missing ⚠️
plotnado/tracks/bed.py 65.00% 7 Missing ⚠️
plotnado/tracks/genes.py 94.44% 1 Missing ⚠️
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.
Additional details and impacted files
@@            Coverage Diff             @@
##             main      #33      +/-   ##
==========================================
- Coverage   80.62%   79.09%   -1.53%     
==========================================
  Files          41       42       +1     
  Lines        5393     5554     +161     
==========================================
+ Hits         4348     4393      +45     
- Misses       1045     1161     +116     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@alsmith151 alsmith151 merged commit 5f934ad into main May 27, 2026
2 checks passed
@alsmith151 alsmith151 deleted the docs/update-examples-in-docs branch May 27, 2026 15:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants