rustplotlib 2.0.0__tar.gz → 4.0.0__tar.gz

rustplotlib-4.0.0/CONTRIBUTING.md

@@ -0,0 +1,195 @@
+# Contributing to RustPlotLib
+
+Thanks for wanting to help rebuild matplotlib in Rust! This guide will help you get started quickly.
+
+## How to Pick a Task
+
+1. Open [ROADMAP.md](ROADMAP.md) — every unchecked `[ ]` item is up for grabs
+2. Open a GitHub Issue saying "I'm working on [feature]" to avoid duplicate work
+3. Features are organized by priority version (v3, v4, v5, v6)
+
+**Best first contributions:**
+- Any item in the **v3.0.0** section (formatters, locators, missing plots)
+- Bug fixes and edge cases
+- Improving existing stubs (turning them into real implementations)
+
+## Project Structure
+
+```
+rustplotlib/
+├── src/                          # Rust core (this is where the rendering happens)
+│   ├── lib.rs                    # PyO3 module registration
+│   ├── figure.rs                 # Figure + PyO3 bindings (savefig, render, etc.)
+│   ├── axes.rs                   # Axes (2D plotting area, ~1500 lines)
+│   ├── axes3d.rs                 # Axes3D (3D plotting)
+│   ├── projection3d.rs           # 3D camera + projection math
+│   ├── transforms.rs             # Data coords → pixel coords
+│   ├── colors.rs                 # Color parsing (named, hex, RGB, RGBA)
+│   ├── text.rs                   # Text rendering (ab_glyph + DejaVu Sans font)
+│   ├── ticker.rs                 # Auto-tick computation
+│   ├── svg_renderer.rs           # Native SVG output
+│   ├── window.rs                 # Interactive window (winit + softbuffer)
+│   └── artists/                  # One file per plot type
+│       ├── mod.rs                # Artist trait definition
+│       ├── line2d.rs             # plot()
+│       ├── scatter.rs            # scatter()
+│       ├── bar.rs                # bar()
+│       ├── hist.rs               # hist()
+│       ├── image.rs              # imshow() + colormaps
+│       ├── contour.rs            # contour/contourf
+│       ├── surface3d.rs          # plot_surface()
+│       ├── ... (31 total)
+│       └── legend.rs             # Legend rendering
+│
+├── python/rustplotlib/           # Python API layer
+│   ├── __init__.py               # Package exports
+│   ├── pyplot.py                 # Main API (drop-in replacement for matplotlib.pyplot)
+│   ├── style/__init__.py         # Style themes (dark_background, ggplot, etc.)
+│   ├── animation.py              # FuncAnimation + GIF export
+│   ├── ticker.py                 # Formatters and Locators
+│   ├── dates.py                  # Date handling
+│   ├── ... (23 modules total)
+│   └── mpl_toolkits/mplot3d/     # 3D axes support
+│
+├── tests/                        # Python tests
+│   ├── test_colors.py
+│   ├── test_figure.py
+│   ├── test_pyplot.py
+│   ├── test_3d.py
+│   ├── test_benchmark.py
+│   └── ... (200+ tests)
+│
+├── Cargo.toml                    # Rust dependencies
+├── pyproject.toml                # Python package config (maturin)
+├── README.md                     # Project documentation
+├── ROADMAP.md                    # Feature roadmap with checkboxes
+└── CONTRIBUTING.md               # This file
+```
+
+## How to Add a New Plot Type
+
+Example: adding `spy()` (sparsity pattern)
+
+### Option A: Pure Python (simple cases)
+If the new plot can be built on top of existing Rust functions:
+
+```python
+# In python/rustplotlib/pyplot.py, add to AxesProxy:
+def spy(self, Z, precision=0, **kwargs):
+    import numpy as np
+    Z = np.asarray(Z)
+    mask = np.abs(Z) > precision
+    self.imshow(mask.astype(float), cmap='gray_r', **kwargs)
+    self.set_aspect('equal')
+```
+
+### Option B: Rust Implementation (performance-critical)
+For new rendering that needs to be fast:
+
+**1. Create the artist** (`src/artists/my_plot.rs`):
+```rust
+use crate::artists::Artist;
+use crate::colors::Color;
+use crate::transforms::Transform;
+
+pub struct MyPlot {
+    pub data: Vec<f64>,
+    pub color: Color,
+    pub label: Option<String>,
+}
+
+impl Artist for MyPlot {
+    fn draw(&self, pixmap: &mut tiny_skia::Pixmap, transform: &Transform) {
+        // Draw using tiny-skia
+    }
+    fn data_bounds(&self) -> (f64, f64, f64, f64) {
+        // Return (xmin, xmax, ymin, ymax)
+    }
+    fn legend_label(&self) -> Option<&str> { self.label.as_deref() }
+    fn legend_color(&self) -> Color { self.color }
+}
+```
+
+**2. Register in** `src/artists/mod.rs`:
+```rust
+pub mod my_plot;
+```
+
+**3. Add method to Axes** (`src/axes.rs`):
+```rust
+pub fn my_plot(&mut self, data: Vec<f64>, color: Option<Color>) {
+    let c = color.unwrap_or_else(|| self.next_color());
+    self.artists.push(Box::new(my_plot::MyPlot { data, color: c, label: None }));
+}
+```
+
+**4. Add PyO3 binding** (`src/figure.rs`):
+```rust
+fn axes_my_plot(&mut self, ax_id: usize, data: Vec<f64>, kwargs: &Bound<'_, PyDict>) -> PyResult<()> {
+    let ax = self.axes.get_mut(ax_id).ok_or_else(|| ...)?;
+    let color = if let Some(c) = kwargs.get_item("color")? { Some(parse_color_value(&c)?) } else { None };
+    ax.my_plot(data, color);
+    Ok(())
+}
+```
+
+**5. Add Python wrapper** (`python/rustplotlib/pyplot.py`):
+```python
+# In AxesProxy:
+def my_plot(self, data, **kwargs):
+    self._fig.axes_my_plot(self._id, _to_list(data), kwargs)
+
+# Module level:
+def my_plot(data, **kwargs):
+    _gca().my_plot(data, **kwargs)
+```
+
+**6. Add test** (`tests/test_my_plot.py`):
+```python
+def test_my_plot():
+    import rustplotlib.pyplot as plt
+    plt.my_plot([1, 2, 3])
+    plt.savefig("/tmp/test_my_plot.png")
+    plt.close()
+    import os
+    assert os.path.exists("/tmp/test_my_plot.png")
+    os.remove("/tmp/test_my_plot.png")
+```
+
+## Development Setup
+
+```bash
+# Clone
+git clone https://github.com/Thi4gon/rustplotlib.git
+cd rustplotlib
+
+# Setup (requires Rust and Python 3.9+)
+python -m venv .venv
+source .venv/bin/activate  # or .venv\Scripts\activate on Windows
+pip install maturin numpy pytest
+
+# Build
+maturin develop
+
+# Test
+pytest tests/ -v
+
+# Build release (for benchmarks)
+maturin develop --release
+```
+
+## Code Style
+
+- **Rust:** standard rustfmt, no `unsafe`, proper error handling (no `.unwrap()` on user input)
+- **Python:** keep it simple, follow existing patterns in pyplot.py
+- **Tests:** every new feature needs at least one test
+- **Security:** validate all inputs at PyO3 boundary, no path traversal, no panics
+
+## PR Checklist
+
+- [ ] All existing tests pass (`pytest tests/ -v`)
+- [ ] New tests added for new features
+- [ ] `maturin develop` compiles without errors
+- [ ] No new warnings in Rust compilation
+- [ ] README.md updated if adding user-facing features
+- [ ] ROADMAP.md checkbox checked for completed items

{rustplotlib-2.0.0 → rustplotlib-4.0.0}/Cargo.lock

@@ -1368,7 +1368,7 @@ dependencies = [
 
 [[package]]
 name = "rustplotlib"
-version = "2.0.0"
+version = "4.0.0"
 dependencies = [
  "ab_glyph",
  "numpy",

{rustplotlib-2.0.0 → rustplotlib-4.0.0}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rustplotlib"
-version = "2.0.0"
+version = "4.0.0"
 edition = "2021"
 readme = "README.md"
 

{rustplotlib-2.0.0 → rustplotlib-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rustplotlib
-Version: 2.0.0
+Version: 4.0.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: MIT License
@@ -87,15 +87,16 @@ plt.show()
 
 ## What's Implemented
 
-### 2D Plot Types (17 types)
+### 2D Plot Types (40+ types)
 | Function | Description |
 |---|---|
-| `plot()` | Line plots with color, linestyle, linewidth, markers, markevery, labels, alpha |
-| `scatter()` | Scatter plots with per-point sizes, colors, markers, alpha |
-| `bar()` / `barh()` | Vertical and horizontal bar charts (stacked via `bottom` param) |
+| `plot()` | Line plots with color, linestyle, linewidth, markers, markevery, labels, alpha, zorder |
+| `scatter()` | Scatter plots with per-point sizes, colors, markers, alpha, zorder |
+| `bar()` / `barh()` | Vertical and horizontal bar charts (stacked, hatch patterns, zorder) |
 | `hist()` | Histograms with configurable bins |
-| `imshow()` | Image/heatmap display with 35+ colormaps |
+| `imshow()` | Image/heatmap display with 70+ colormaps, bilinear interpolation, annotations |
 | `fill_between()` / `fill_betweenx()` | Filled area between curves (vertical and horizontal) |
+| `fill()` | Filled polygon from vertex arrays |
 | `errorbar()` | Error bars with caps (xerr/yerr) |
 | `step()` | Step plots (pre/post/mid) |
 | `pie()` | Pie charts with labels |
@@ -106,8 +107,29 @@ plt.show()
 | `hexbin()` | Hexagonal binning for 2D histograms |
 | `quiver()` | Vector field arrows |
 | `streamplot()` | Streamlines for vector fields (Euler integration) |
-
-### 3D Plot Types (5 types)
+| `stackplot()` | Stacked area charts |
+| `broken_barh()` | Broken horizontal bar charts |
+| `eventplot()` | Event/raster plots |
+| `pcolormesh()` / `pcolor()` | Pseudocolor plots for irregular grids |
+| `matshow()` | Matrix display with integer ticks |
+| `radar()` | Radar/spider charts |
+| `sankey()` | Sankey flow diagrams |
+| `spy()` | Sparsity pattern visualization |
+| `stairs()` | Step-wise constant function with edges |
+| `ecdf()` | Empirical cumulative distribution |
+| `triplot()` | Triangulation edge drawing |
+| `hist2d()` | 2D histogram heatmap |
+| `specgram()` | Spectrogram (STFT-based) |
+| `acorr()` / `xcorr()` | Auto/cross correlation |
+| `psd()` | Power spectral density (Welch) |
+| `magnitude_spectrum()` | FFT magnitude |
+| `angle_spectrum()` / `phase_spectrum()` | FFT phase |
+| `cohere()` / `csd()` | Coherence / cross spectral density |
+| `semilogx()` / `semilogy()` / `loglog()` | Convenience log-scale plots |
+| `arrow()` | Arrow drawing |
+| `axline()` | Infinite line through point with slope |
+
+### 3D Plot Types (7 types)
 | Function | Description |
 |---|---|
 | `plot()` (3D) | 3D line plots |
@@ -115,6 +137,8 @@ plt.show()
 | `plot_surface()` | 3D surface plots with colormaps |
 | `plot_wireframe()` | 3D wireframe plots |
 | `bar3d()` | 3D bar charts with shading |
+| `plot_trisurf()` | 3D triangulated surface |
+| `contour3D()` | 3D contour lines at Z offset |
 
 ### Layout & Figure
 | Function | Description |
@@ -129,6 +153,9 @@ plt.show()
 | `add_subplot(projection='3d')` | Add 3D subplot |
 | `clf()` / `cla()` / `close()` | Clear and close figures |
 | `gcf()` / `gca()` | Get current figure/axes |
+| `subplot2grid()` | Subplot at specific grid position |
+| `fig.add_gridspec()` | GridSpec from figure |
+| `fig.legend()` | Figure-level legend |
 
 ### Axes Customization
 | Function | Description |
@@ -145,7 +172,9 @@ plt.show()
 | `axis('off')` | Hide axes completely |
 | `set_facecolor()` | Axes background color |
 | `spines['right'].set_visible(False)` | Spine customization |
-| `twinx()` | Secondary y-axis |
+| `twinx()` / `twiny()` | Secondary y-axis / x-axis |
+| `zorder` | Drawing order control for all artists |
+| `hatch` | Hatch patterns for bars (`/`, `\\`, `|`, `-`, `+`, `x`, `o`, `.`, `*`) |
 | `legend()` | Legend with line+marker swatches and positioning |
 | `grid()` | Grid lines with color, linewidth, linestyle, alpha, which |
 | `text()` | Positioned text annotations |
@@ -155,6 +184,13 @@ plt.show()
 | `axhspan()` / `axvspan()` | Shaded horizontal/vertical regions |
 | `hlines()` / `vlines()` | Multiple reference lines with bounds |
 | `colorbar()` | Color scale bar for imshow/contour |
+| `get_xlim()` / `get_ylim()` | Get current axis limits (functional) |
+| `clear()` | Clear all artists from axes |
+| `ax.set(**kwargs)` | Set multiple properties at once |
+| `minor=True` in set_xticks/yticks | Minor tick support |
+| `bar_label()` | Value labels on bars |
+| `set_xlabel(color=...)` | Label color customization |
+| `title(loc='left')` | Title alignment |
 
 ### Output Formats
 | Method | Description |
@@ -191,9 +227,13 @@ plt.show()
 - **Format strings:** `"r--o"` = red + dashed + circle markers
 - **markevery:** show marker every N points
 
-### Colormaps (35+)
+### Colormaps (70+)
+35 base colormaps + all reversed variants (`_r` suffix):
+
 `viridis` `plasma` `inferno` `magma` `cividis` `twilight` `turbo` `hot` `cool` `gray` `jet` `spring` `summer` `autumn` `winter` `copper` `bone` `pink` `binary` `gist_heat` `ocean` `terrain` `Blues` `Reds` `Greens` `YlOrRd` `YlGnBu` `RdYlBu` `RdBu` `PiYG` `PRGn` `BrBG` `Spectral` `Set1` `Set2` `Set3` `Pastel1` `Pastel2` `tab20`
 
+All also available as `viridis_r`, `plasma_r`, `hot_r`, etc.
+
 ### Text Rendering
 - Embedded DejaVu Sans font (no system font dependency)
 - LaTeX-to-Unicode conversion (`$\theta$` -> theta, `$x_1$` -> x1, Greek letters, sub/superscripts, math operators)
@@ -205,21 +245,31 @@ plt.show()
 - **Dates:** `date2num()`, `num2date()`, date formatters and locators
 - **Categorical axes:** string-based x values automatically converted
 
-### Compatibility Modules
+### Compatibility Modules (23 modules)
 | Module | Status |
 |---|---|
-| `rustplotlib.pyplot` | Full implementation |
+| `rustplotlib.pyplot` | Full implementation (50+ functions) |
 | `rustplotlib.style` | Full implementation (6 themes) |
 | `rustplotlib.animation` | FuncAnimation + GIF export |
 | `rustplotlib.widgets` | Stubs (Slider, Button, CheckButtons, RadioButtons, TextBox, Cursor) |
-| `rustplotlib.font_manager` | FontProperties stub |
-| `rustplotlib.ticker` | FormatStrFormatter stub |
+| `rustplotlib.font_manager` | FontProperties |
+| `rustplotlib.ticker` | FormatStrFormatter |
 | `rustplotlib.patches` | Rectangle, Circle, Polygon, FancyBboxPatch, Wedge |
 | `rustplotlib.colors` | LinearSegmentedColormap, Normalize, LogNorm |
 | `rustplotlib.dates` | Date conversion, formatters, locators |
 | `rustplotlib.gridspec` | GridSpec, SubplotSpec |
-| `rustplotlib.backends` | Backend system with `use()` |
+| `rustplotlib.backends` | Backend system, PdfPages |
 | `rustplotlib.mpl_toolkits.mplot3d` | Axes3D for 3D plotting |
+| `rustplotlib.cm` | Colormap access by name |
+| `rustplotlib.collections` | LineCollection, PathCollection, PatchCollection |
+| `rustplotlib.lines` | Line2D with get/set methods |
+| `rustplotlib.text` | Text, Annotation |
+| `rustplotlib.transforms` | Bbox, Affine2D, BboxTransform |
+| `rustplotlib.patheffects` | Stroke, withStroke, SimplePatchShadow |
+| `rustplotlib.spines` | Spine |
+| `rustplotlib.axes` | Axes class reference |
+| `rustplotlib.figure` | Figure class reference |
+| `rustplotlib.cycler` | cycler compatibility |
 
 ---
 
@@ -389,11 +439,22 @@ Contributions are welcome! This is an open-source project under the MIT license.
 3. Open a PR against `master`
 4. PRs require at least 1 review before merging
 
+**Project stats:**
+- **45+ Rust source files** — 16,000+ lines of native code
+- **23 Python modules** — 5,000+ lines of API
+- **47+ plot functions** (40 2D + 7 3D)
+- **70+ colormaps** (35 base + 35 reversed)
+- **262 tests** passing
+- **12 formatters + 10 locators** (functional)
+- **RGB/RGBA imshow**, bilinear interpolation, heatmap annotations
+- **Signal processing**: specgram, psd, acorr, xcorr, coherence
+- **Zero `unsafe` blocks**
+
 **Priority areas for contribution:**
 - Turning stub modules into full implementations (widgets, formatters/locators)
-- Adding more colormaps with exact matplotlib data
 - Improving SVG output fidelity
-- Jupyter inline display support
+- Interactive 3D (mouse rotation)
+- Qt/GTK backends
 - More comprehensive test coverage
 
 ---

{rustplotlib-2.0.0 → rustplotlib-4.0.0}/README.md

@@ -67,15 +67,16 @@ plt.show()
 
 ## What's Implemented
 
-### 2D Plot Types (17 types)
+### 2D Plot Types (40+ types)
 | Function | Description |
 |---|---|
-| `plot()` | Line plots with color, linestyle, linewidth, markers, markevery, labels, alpha |
-| `scatter()` | Scatter plots with per-point sizes, colors, markers, alpha |
-| `bar()` / `barh()` | Vertical and horizontal bar charts (stacked via `bottom` param) |
+| `plot()` | Line plots with color, linestyle, linewidth, markers, markevery, labels, alpha, zorder |
+| `scatter()` | Scatter plots with per-point sizes, colors, markers, alpha, zorder |
+| `bar()` / `barh()` | Vertical and horizontal bar charts (stacked, hatch patterns, zorder) |
 | `hist()` | Histograms with configurable bins |
-| `imshow()` | Image/heatmap display with 35+ colormaps |
+| `imshow()` | Image/heatmap display with 70+ colormaps, bilinear interpolation, annotations |
 | `fill_between()` / `fill_betweenx()` | Filled area between curves (vertical and horizontal) |
+| `fill()` | Filled polygon from vertex arrays |
 | `errorbar()` | Error bars with caps (xerr/yerr) |
 | `step()` | Step plots (pre/post/mid) |
 | `pie()` | Pie charts with labels |
@@ -86,8 +87,29 @@ plt.show()
 | `hexbin()` | Hexagonal binning for 2D histograms |
 | `quiver()` | Vector field arrows |
 | `streamplot()` | Streamlines for vector fields (Euler integration) |
-
-### 3D Plot Types (5 types)
+| `stackplot()` | Stacked area charts |
+| `broken_barh()` | Broken horizontal bar charts |
+| `eventplot()` | Event/raster plots |
+| `pcolormesh()` / `pcolor()` | Pseudocolor plots for irregular grids |
+| `matshow()` | Matrix display with integer ticks |
+| `radar()` | Radar/spider charts |
+| `sankey()` | Sankey flow diagrams |
+| `spy()` | Sparsity pattern visualization |
+| `stairs()` | Step-wise constant function with edges |
+| `ecdf()` | Empirical cumulative distribution |
+| `triplot()` | Triangulation edge drawing |
+| `hist2d()` | 2D histogram heatmap |
+| `specgram()` | Spectrogram (STFT-based) |
+| `acorr()` / `xcorr()` | Auto/cross correlation |
+| `psd()` | Power spectral density (Welch) |
+| `magnitude_spectrum()` | FFT magnitude |
+| `angle_spectrum()` / `phase_spectrum()` | FFT phase |
+| `cohere()` / `csd()` | Coherence / cross spectral density |
+| `semilogx()` / `semilogy()` / `loglog()` | Convenience log-scale plots |
+| `arrow()` | Arrow drawing |
+| `axline()` | Infinite line through point with slope |
+
+### 3D Plot Types (7 types)
 | Function | Description |
 |---|---|
 | `plot()` (3D) | 3D line plots |
@@ -95,6 +117,8 @@ plt.show()
 | `plot_surface()` | 3D surface plots with colormaps |
 | `plot_wireframe()` | 3D wireframe plots |
 | `bar3d()` | 3D bar charts with shading |
+| `plot_trisurf()` | 3D triangulated surface |
+| `contour3D()` | 3D contour lines at Z offset |
 
 ### Layout & Figure
 | Function | Description |
@@ -109,6 +133,9 @@ plt.show()
 | `add_subplot(projection='3d')` | Add 3D subplot |
 | `clf()` / `cla()` / `close()` | Clear and close figures |
 | `gcf()` / `gca()` | Get current figure/axes |
+| `subplot2grid()` | Subplot at specific grid position |
+| `fig.add_gridspec()` | GridSpec from figure |
+| `fig.legend()` | Figure-level legend |
 
 ### Axes Customization
 | Function | Description |
@@ -125,7 +152,9 @@ plt.show()
 | `axis('off')` | Hide axes completely |
 | `set_facecolor()` | Axes background color |
 | `spines['right'].set_visible(False)` | Spine customization |
-| `twinx()` | Secondary y-axis |
+| `twinx()` / `twiny()` | Secondary y-axis / x-axis |
+| `zorder` | Drawing order control for all artists |
+| `hatch` | Hatch patterns for bars (`/`, `\\`, `|`, `-`, `+`, `x`, `o`, `.`, `*`) |
 | `legend()` | Legend with line+marker swatches and positioning |
 | `grid()` | Grid lines with color, linewidth, linestyle, alpha, which |
 | `text()` | Positioned text annotations |
@@ -135,6 +164,13 @@ plt.show()
 | `axhspan()` / `axvspan()` | Shaded horizontal/vertical regions |
 | `hlines()` / `vlines()` | Multiple reference lines with bounds |
 | `colorbar()` | Color scale bar for imshow/contour |
+| `get_xlim()` / `get_ylim()` | Get current axis limits (functional) |
+| `clear()` | Clear all artists from axes |
+| `ax.set(**kwargs)` | Set multiple properties at once |
+| `minor=True` in set_xticks/yticks | Minor tick support |
+| `bar_label()` | Value labels on bars |
+| `set_xlabel(color=...)` | Label color customization |
+| `title(loc='left')` | Title alignment |
 
 ### Output Formats
 | Method | Description |
@@ -171,9 +207,13 @@ plt.show()
 - **Format strings:** `"r--o"` = red + dashed + circle markers
 - **markevery:** show marker every N points
 
-### Colormaps (35+)
+### Colormaps (70+)
+35 base colormaps + all reversed variants (`_r` suffix):
+
 `viridis` `plasma` `inferno` `magma` `cividis` `twilight` `turbo` `hot` `cool` `gray` `jet` `spring` `summer` `autumn` `winter` `copper` `bone` `pink` `binary` `gist_heat` `ocean` `terrain` `Blues` `Reds` `Greens` `YlOrRd` `YlGnBu` `RdYlBu` `RdBu` `PiYG` `PRGn` `BrBG` `Spectral` `Set1` `Set2` `Set3` `Pastel1` `Pastel2` `tab20`
 
+All also available as `viridis_r`, `plasma_r`, `hot_r`, etc.
+
 ### Text Rendering
 - Embedded DejaVu Sans font (no system font dependency)
 - LaTeX-to-Unicode conversion (`$\theta$` -> theta, `$x_1$` -> x1, Greek letters, sub/superscripts, math operators)
@@ -185,21 +225,31 @@ plt.show()
 - **Dates:** `date2num()`, `num2date()`, date formatters and locators
 - **Categorical axes:** string-based x values automatically converted
 
-### Compatibility Modules
+### Compatibility Modules (23 modules)
 | Module | Status |
 |---|---|
-| `rustplotlib.pyplot` | Full implementation |
+| `rustplotlib.pyplot` | Full implementation (50+ functions) |
 | `rustplotlib.style` | Full implementation (6 themes) |
 | `rustplotlib.animation` | FuncAnimation + GIF export |
 | `rustplotlib.widgets` | Stubs (Slider, Button, CheckButtons, RadioButtons, TextBox, Cursor) |
-| `rustplotlib.font_manager` | FontProperties stub |
-| `rustplotlib.ticker` | FormatStrFormatter stub |
+| `rustplotlib.font_manager` | FontProperties |
+| `rustplotlib.ticker` | FormatStrFormatter |
 | `rustplotlib.patches` | Rectangle, Circle, Polygon, FancyBboxPatch, Wedge |
 | `rustplotlib.colors` | LinearSegmentedColormap, Normalize, LogNorm |
 | `rustplotlib.dates` | Date conversion, formatters, locators |
 | `rustplotlib.gridspec` | GridSpec, SubplotSpec |
-| `rustplotlib.backends` | Backend system with `use()` |
+| `rustplotlib.backends` | Backend system, PdfPages |
 | `rustplotlib.mpl_toolkits.mplot3d` | Axes3D for 3D plotting |
+| `rustplotlib.cm` | Colormap access by name |
+| `rustplotlib.collections` | LineCollection, PathCollection, PatchCollection |
+| `rustplotlib.lines` | Line2D with get/set methods |
+| `rustplotlib.text` | Text, Annotation |
+| `rustplotlib.transforms` | Bbox, Affine2D, BboxTransform |
+| `rustplotlib.patheffects` | Stroke, withStroke, SimplePatchShadow |
+| `rustplotlib.spines` | Spine |
+| `rustplotlib.axes` | Axes class reference |
+| `rustplotlib.figure` | Figure class reference |
+| `rustplotlib.cycler` | cycler compatibility |
 
 ---
 
@@ -369,11 +419,22 @@ Contributions are welcome! This is an open-source project under the MIT license.
 3. Open a PR against `master`
 4. PRs require at least 1 review before merging
 
+**Project stats:**
+- **45+ Rust source files** — 16,000+ lines of native code
+- **23 Python modules** — 5,000+ lines of API
+- **47+ plot functions** (40 2D + 7 3D)
+- **70+ colormaps** (35 base + 35 reversed)
+- **262 tests** passing
+- **12 formatters + 10 locators** (functional)
+- **RGB/RGBA imshow**, bilinear interpolation, heatmap annotations
+- **Signal processing**: specgram, psd, acorr, xcorr, coherence
+- **Zero `unsafe` blocks**
+
 **Priority areas for contribution:**
 - Turning stub modules into full implementations (widgets, formatters/locators)
-- Adding more colormaps with exact matplotlib data
 - Improving SVG output fidelity
-- Jupyter inline display support
+- Interactive 3D (mouse rotation)
+- Qt/GTK backends
 - More comprehensive test coverage
 
 ---