ruviz 0.6.0

High-performance 2D plotting library for Rust
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
/// Histogram plot implementation with automatic binning and statistical analysis
use crate::core::plot::PlotBuilder;
use crate::core::style_utils::{StyleResolver, defaults};
use crate::core::{PlottingError, Result};
use crate::data::Data1D;
use crate::plots::traits::{PlotArea, PlotConfig, PlotData, PlotRender};
use crate::render::{Color, SkiaRenderer, Theme};

/// Configuration for histogram plots
#[derive(Debug, Clone)]
pub struct HistogramConfig {
    /// Number of bins (auto-calculated if None)
    pub bins: Option<usize>,
    /// Range for histogram (auto-calculated if None)
    pub range: Option<(f64, f64)>,
    /// Whether to normalize to probability density
    pub density: bool,
    /// Whether to show cumulative distribution
    pub cumulative: bool,
    /// Bin edges calculation method
    pub bin_method: BinMethod,
    /// Fill alpha (opacity), default from defaults::HISTOGRAM_FILL_ALPHA
    pub fill_alpha: Option<f32>,
    /// Edge color (auto-derived from fill if None)
    pub edge_color: Option<Color>,
    /// Edge width in points (default from defaults::PATCH_LINE_WIDTH)
    pub edge_width: Option<f32>,
    /// Bar width as fraction of bin width (0.0-1.0, default 0.9)
    pub bar_width: Option<f32>,
}

/// Methods for calculating histogram bin edges
#[derive(Debug, Clone, Copy, PartialEq, Default)]
pub enum BinMethod {
    /// Equal-width bins
    Uniform,
    /// Sturges' rule: ceil(log2(n) + 1) (default)
    #[default]
    Sturges,
    /// Scott's rule: 3.5 * std / n^(1/3)
    Scott,
    /// Freedman-Diaconis rule: 2 * IQR / n^(1/3)
    FreedmanDiaconis,
}

/// Computed histogram data
#[derive(Debug, Clone)]
pub struct HistogramData {
    /// Bin edges (length = counts.len() + 1)
    pub bin_edges: Vec<f64>,
    /// Count or density in each bin
    pub counts: Vec<f64>,
    /// Total number of data points
    pub n_samples: usize,
    /// Whether the data is normalized to density
    pub is_density: bool,
    /// Fill alpha (from config or default)
    pub fill_alpha: f32,
    /// Edge color (None = auto-derive from fill)
    pub edge_color: Option<Color>,
    /// Edge width in points
    pub edge_width: f32,
    /// Bar width as fraction of bin width
    pub bar_width: f32,
}

impl HistogramData {
    /// Resolve the bar edge for this histogram against `theme` and the fill colour.
    ///
    /// Histogram bars are drawn edge-to-edge, so without a stroke two neighbouring
    /// bins of similar height merge into a single silhouette and the binning stops
    /// being readable. This is the single source of truth for that stroke — every
    /// backend (raster, SVG, parallel) resolves it here so they cannot drift apart.
    ///
    /// Returns `(colour, width_in_points)`, or `None` when the edge is disabled by
    /// [`HistogramConfig::edge_width(0.0)`](HistogramConfig::edge_width).
    pub fn resolved_edge(&self, theme: &Theme, fill: Color) -> Option<(Color, f32)> {
        self.resolved_edge_with_width(theme, fill, Some(self.edge_width))
    }

    /// [`Self::resolved_edge`] with an explicit width override in points.
    ///
    /// `None` falls back to the shared patch line width.
    pub(crate) fn resolved_edge_with_width(
        &self,
        theme: &Theme,
        fill: Color,
        width: Option<f32>,
    ) -> Option<(Color, f32)> {
        let resolver = StyleResolver::new(theme);
        let width = resolver.patch_line_width(width);
        resolver.patch_edge(fill, self.edge_color, width)
    }
}

// Implement PlotData trait for HistogramData
impl PlotData for HistogramData {
    fn data_bounds(&self) -> ((f64, f64), (f64, f64)) {
        let x_min = self.bin_edges.first().copied().unwrap_or(0.0);
        let x_max = self.bin_edges.last().copied().unwrap_or(1.0);
        let y_min = 0.0; // Histogram always starts at 0
        let y_max = self
            .counts
            .iter()
            .copied()
            .fold(f64::NEG_INFINITY, f64::max);

        ((x_min, x_max), (y_min, y_max))
    }

    fn is_empty(&self) -> bool {
        self.counts.is_empty() || self.counts.iter().all(|&c| c == 0.0)
    }
}

// Implement PlotRender trait for HistogramData
impl PlotRender for HistogramData {
    fn render(
        &self,
        renderer: &mut SkiaRenderer,
        area: &PlotArea,
        theme: &Theme,
        color: Color,
    ) -> Result<()> {
        self.render_styled(
            renderer,
            area,
            theme,
            color,
            self.fill_alpha,
            Some(self.edge_width),
        )
    }

    fn render_styled(
        &self,
        renderer: &mut SkiaRenderer,
        area: &PlotArea,
        theme: &Theme,
        color: Color,
        alpha: f32,
        line_width: Option<f32>,
    ) -> Result<()> {
        if self.is_empty() {
            return Ok(());
        }

        // Resolve styling
        let fill_alpha = alpha.clamp(0.0, 1.0);
        let fill_color = color.with_alpha(fill_alpha);
        let edge = self.resolved_edge_with_width(theme, color, line_width);

        // Draw bars
        for (i, &count) in self.counts.iter().enumerate() {
            if count <= 0.0 {
                continue;
            }

            let left = self.bin_edges[i];
            let right = self.bin_edges[i + 1];
            let bin_width = right - left;

            // Apply bar_width factor (center bars within bin)
            let bar_actual_width = bin_width * self.bar_width as f64;
            let bar_offset = (bin_width - bar_actual_width) / 2.0;
            let bar_left = left + bar_offset;
            let bar_right = right - bar_offset;

            // Convert to screen coordinates
            let (x1, y1) = area.data_to_screen(bar_left, 0.0);
            let (x2, y2) = area.data_to_screen(bar_right, count);

            // Calculate rectangle bounds
            let rect_x = x1.min(x2);
            let rect_y = y1.min(y2);
            let rect_width = (x2 - x1).abs();
            let rect_height = (y2 - y1).abs();

            // Fill and edge in one pass; the edge width is in points and is
            // scaled to device pixels by the renderer, so it is DPI-invariant.
            renderer.draw_rectangle_styled(
                rect_x,
                rect_y,
                rect_width,
                rect_height,
                Some(fill_color),
                edge,
            )?;
        }

        Ok(())
    }
}

impl Default for HistogramConfig {
    fn default() -> Self {
        Self {
            bins: None,
            range: None,
            density: false,
            cumulative: false,
            bin_method: BinMethod::Sturges,
            fill_alpha: None,
            edge_color: None,
            edge_width: None,
            bar_width: None,
        }
    }
}

// Implement PlotConfig marker trait
impl PlotConfig for HistogramConfig {}

impl HistogramConfig {
    pub fn new() -> Self {
        Self::default()
    }

    /// Resolve the bar edge straight from the configuration, before binning.
    ///
    /// [`HistogramData::resolved_edge`] is the render-time twin. Both go
    /// through [`StyleResolver::patch_edge`], and `compute_histogram` copies
    /// `edge_color`/`edge_width` verbatim into the data, so a legend key built
    /// from the config always matches the bars built from the data.
    pub fn resolved_edge(&self, theme: &Theme, fill: Color) -> Option<(Color, f32)> {
        let resolver = StyleResolver::new(theme);
        let width = resolver.patch_line_width(self.edge_width);
        resolver.patch_edge(fill, self.edge_color, width)
    }

    pub fn bins(mut self, bins: usize) -> Self {
        self.bins = Some(bins);
        self
    }

    pub fn range(mut self, min: f64, max: f64) -> Self {
        self.range = Some((min, max));
        self
    }

    pub fn density(mut self, density: bool) -> Self {
        self.density = density;
        self
    }

    pub fn cumulative(mut self, cumulative: bool) -> Self {
        self.cumulative = cumulative;
        self
    }

    pub fn bin_method(mut self, method: BinMethod) -> Self {
        self.bin_method = method;
        self
    }

    /// Set fill alpha (0.0-1.0)
    pub fn fill_alpha(mut self, alpha: f32) -> Self {
        self.fill_alpha = Some(alpha.clamp(0.0, 1.0));
        self
    }

    /// Set edge color explicitly
    pub fn edge_color(mut self, color: Color) -> Self {
        self.edge_color = Some(color);
        self
    }

    /// Set edge width in points
    pub fn edge_width(mut self, width: f32) -> Self {
        self.edge_width = Some(width);
        self
    }

    /// Set bar width as fraction of bin width (0.0-1.0)
    pub fn bar_width(mut self, width: f32) -> Self {
        self.bar_width = Some(width.clamp(0.0, 1.0));
        self
    }
}

/// Histogram configuration reachable straight from [`Plot::histogram`].
///
/// [`Plot::histogram`] returns `PlotBuilder<HistogramConfig>`, exactly like the
/// other series methods return their own `PlotBuilder<C>`, so these mirror
/// [`HistogramConfig`]'s own setters one for one and can be interleaved freely
/// with the shared styling and plot-level methods on the builder.
///
/// ```rust,no_run
/// use ruviz::prelude::*;
///
/// let data: Vec<f64> = (0..500).map(|i| (i as f64 / 50.0).sin()).collect();
///
/// Plot::new()
///     .histogram(&data)
///     .bins(25)
///     .density(true)
///     .fill_alpha(0.7)
///     .save("histogram.png")?;
/// # Ok::<(), Box<dyn std::error::Error>>(())
/// ```
///
/// [`Plot::histogram`]: crate::core::Plot::histogram
impl PlotBuilder<HistogramConfig> {
    /// Set the number of bins explicitly (overrides [`Self::bin_method`]).
    pub fn bins(mut self, bins: usize) -> Self {
        self.config = std::mem::take(&mut self.config).bins(bins);
        self
    }

    /// Restrict binning to `[min, max]` instead of the data's own range.
    pub fn range(mut self, min: f64, max: f64) -> Self {
        self.config = std::mem::take(&mut self.config).range(min, max);
        self
    }

    /// Normalize the bars to a probability density instead of raw counts.
    pub fn density(mut self, density: bool) -> Self {
        self.config = std::mem::take(&mut self.config).density(density);
        self
    }

    /// Accumulate counts across bins to show a cumulative distribution.
    pub fn cumulative(mut self, cumulative: bool) -> Self {
        self.config = std::mem::take(&mut self.config).cumulative(cumulative);
        self
    }

    /// Choose the automatic bin-count rule used when [`Self::bins`] is unset.
    pub fn bin_method(mut self, method: BinMethod) -> Self {
        self.config = std::mem::take(&mut self.config).bin_method(method);
        self
    }

    /// Set the bar fill opacity (0.0-1.0).
    pub fn fill_alpha(mut self, alpha: f32) -> Self {
        self.config = std::mem::take(&mut self.config).fill_alpha(alpha);
        self
    }

    /// Set the bar edge colour explicitly.
    pub fn edge_color(mut self, color: Color) -> Self {
        self.config = std::mem::take(&mut self.config).edge_color(color);
        self
    }

    /// Set the bar edge width in points; `0.0` turns the edge off.
    pub fn edge_width(mut self, width: f32) -> Self {
        self.config = std::mem::take(&mut self.config).edge_width(width);
        self
    }

    /// Set bar width as a fraction of the bin width (0.0-1.0).
    pub fn bar_width(mut self, width: f32) -> Self {
        self.config = std::mem::take(&mut self.config).bar_width(width);
        self
    }
}

/// Calculate histogram from data
pub fn calculate_histogram<T, D: Data1D<T>>(
    data: &D,
    config: &HistogramConfig,
) -> Result<HistogramData>
where
    T: Into<f64> + Copy,
{
    // Collect and validate data using shared utility
    let values = crate::data::collect_finite_values_sorted(data)?;
    let n_samples = values.len();

    // Determine range
    let (mut data_min, mut data_max) = match config.range {
        Some((min, max)) => (min, max),
        None => (*values.first().unwrap(), *values.last().unwrap()),
    };

    // Handle edge case where all values are identical
    if (data_max - data_min).abs() < f64::EPSILON {
        // Create a small range around the single value
        let epsilon = if data_min.abs() > f64::EPSILON {
            data_min.abs() * 0.1
        } else {
            1.0
        };
        data_min -= epsilon;
        data_max += epsilon;
    }

    if data_max <= data_min {
        return Err(PlottingError::InvalidInput(
            "Histogram range max must be greater than min".to_string(),
        ));
    }

    // Determine number of bins
    let n_bins = match config.bins {
        Some(bins) => {
            if bins == 0 {
                return Err(PlottingError::InvalidInput(
                    "Number of bins must be greater than 0".to_string(),
                ));
            }
            bins
        }
        None => calculate_optimal_bins(&values, config.bin_method),
    };

    // Create bin edges
    let bin_edges = create_bin_edges(data_min, data_max, n_bins);

    // Count values in each bin
    let mut counts = vec![0.0; n_bins];
    for &value in &values {
        if value < data_min || value > data_max {
            continue; // Skip out-of-range values
        }

        let bin_idx = if value == data_max {
            n_bins - 1 // Last value goes in last bin
        } else {
            ((value - data_min) / (data_max - data_min) * n_bins as f64).floor() as usize
        };

        if bin_idx < n_bins {
            counts[bin_idx] += 1.0;
        }
    }

    // Apply cumulative if requested
    if config.cumulative {
        for i in 1..counts.len() {
            counts[i] += counts[i - 1];
        }
    }

    // Apply density normalization if requested
    let is_density = config.density;
    if config.density {
        let bin_width = (data_max - data_min) / n_bins as f64;
        let total_area = counts.iter().sum::<f64>() * bin_width;
        if total_area > 0.0 {
            for count in &mut counts {
                *count /= total_area;
            }
        }
    }

    // Extract styling from config, using defaults for None values
    let fill_alpha = config.fill_alpha.unwrap_or(defaults::HISTOGRAM_FILL_ALPHA);
    let edge_color = config.edge_color;
    let edge_width = config.edge_width.unwrap_or(defaults::PATCH_LINE_WIDTH);
    let bar_width = config.bar_width.unwrap_or(defaults::HISTOGRAM_BAR_WIDTH);

    Ok(HistogramData {
        bin_edges,
        counts,
        n_samples,
        is_density,
        fill_alpha,
        edge_color,
        edge_width,
        bar_width,
    })
}

fn calculate_optimal_bins(values: &[f64], method: BinMethod) -> usize {
    let n = values.len() as f64;

    match method {
        BinMethod::Uniform => 10, // Default fallback
        BinMethod::Sturges => (n.log2() + 1.0).ceil() as usize,
        BinMethod::Scott => {
            let std_dev = calculate_std_dev(values);
            let bin_width = 3.5 * std_dev / n.powf(1.0 / 3.0);
            let range = values.last().unwrap() - values.first().unwrap();
            (range / bin_width).ceil().max(1.0) as usize
        }
        BinMethod::FreedmanDiaconis => {
            let iqr = calculate_iqr(values);
            if iqr == 0.0 {
                return 1; // All values are the same
            }
            let bin_width = 2.0 * iqr / n.powf(1.0 / 3.0);
            let range = values.last().unwrap() - values.first().unwrap();
            (range / bin_width).ceil().max(1.0) as usize
        }
    }
}

fn create_bin_edges(min: f64, max: f64, n_bins: usize) -> Vec<f64> {
    let mut edges = Vec::with_capacity(n_bins + 1);
    for i in 0..=n_bins {
        let edge = min + (max - min) * i as f64 / n_bins as f64;
        edges.push(edge);
    }
    edges
}

// Use shared statistical utilities
use super::statistics::{iqr as calculate_iqr, std_dev as calculate_std_dev};

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_resolved_edge_defaults_to_a_darker_stroke() {
        let data = vec![1.0, 2.0, 3.0, 4.0, 5.0];
        let histogram = calculate_histogram(&data, &HistogramConfig::new().bins(5)).unwrap();
        let theme = Theme::default();
        let fill = Color::from_rgb(31, 119, 180);

        let (edge_color, edge_width) = histogram
            .resolved_edge(&theme, fill)
            .expect("the default histogram must carry an edge so bins stay separable");
        assert_eq!(edge_width, defaults::PATCH_LINE_WIDTH);
        assert_eq!(edge_color, fill.darken(0.3));
        assert!(
            i32::from(edge_color.r) + i32::from(edge_color.g) + i32::from(edge_color.b)
                < i32::from(fill.r) + i32::from(fill.g) + i32::from(fill.b),
            "the default edge must be darker than the fill"
        );
    }

    #[test]
    fn test_resolved_edge_honours_explicit_config() {
        let data = vec![1.0, 2.0, 3.0, 4.0, 5.0];
        let theme = Theme::default();
        let fill = Color::from_rgb(31, 119, 180);

        let explicit = calculate_histogram(
            &data,
            &HistogramConfig::new()
                .bins(5)
                .edge_color(Color::from_rgb(255, 255, 255))
                .edge_width(2.0),
        )
        .unwrap();
        assert_eq!(
            explicit.resolved_edge(&theme, fill),
            Some((Color::from_rgb(255, 255, 255), 2.0))
        );

        let disabled =
            calculate_histogram(&data, &HistogramConfig::new().bins(5).edge_width(0.0)).unwrap();
        assert_eq!(disabled.resolved_edge(&theme, fill), None);
    }

    #[test]
    fn test_histogram_basic_functionality() {
        let data = vec![1.0, 2.0, 3.0, 4.0, 5.0];
        let config = HistogramConfig::new().bins(5);

        let result = calculate_histogram(&data, &config).unwrap();

        assert_eq!(result.n_samples, 5);
        assert_eq!(result.bin_edges.len(), 6); // n_bins + 1
        assert_eq!(result.counts.len(), 5);
        assert!(!result.is_density);

        // Each bin should contain exactly one value
        for count in &result.counts {
            assert_eq!(*count, 1.0);
        }
    }

    #[test]
    fn test_histogram_empty_data() {
        let data: Vec<f64> = vec![];
        let config = HistogramConfig::new();

        let result = calculate_histogram(&data, &config);
        assert!(result.is_err());

        match result.unwrap_err() {
            PlottingError::EmptyDataSet => {}
            _ => panic!("Expected EmptyDataSet error"),
        }
    }

    #[test]
    fn test_histogram_invalid_range() {
        let data = vec![1.0, 2.0, 3.0];
        let config = HistogramConfig::new().range(5.0, 3.0); // max < min

        let result = calculate_histogram(&data, &config);
        assert!(result.is_err());
    }

    #[test]
    fn test_histogram_zero_bins() {
        let data = vec![1.0, 2.0, 3.0];
        let config = HistogramConfig::new().bins(0);

        let result = calculate_histogram(&data, &config);
        assert!(result.is_err());
    }

    #[test]
    fn test_histogram_density_normalization() {
        let data = vec![1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0];
        let config = HistogramConfig::new().bins(5).density(true);

        let result = calculate_histogram(&data, &config).unwrap();

        assert!(result.is_density);

        // For density, the area under histogram should be 1
        let bin_width = result.bin_edges[1] - result.bin_edges[0];
        let total_area: f64 = result.counts.iter().map(|&c| c * bin_width).sum();
        assert!((total_area - 1.0).abs() < 1e-10);
    }

    #[test]
    fn test_histogram_cumulative() {
        let data = vec![1.0, 2.0, 3.0, 4.0, 5.0];
        let config = HistogramConfig::new().bins(5).cumulative(true);

        let result = calculate_histogram(&data, &config).unwrap();

        // Cumulative histogram should be monotonic increasing
        for i in 1..result.counts.len() {
            assert!(result.counts[i] >= result.counts[i - 1]);
        }

        // Last bin should contain total count
        assert_eq!(result.counts.last().unwrap(), &5.0);
    }

    #[test]
    fn test_histogram_sturges_rule() {
        let data = vec![1.0; 100]; // 100 identical values
        let config = HistogramConfig::new().bin_method(BinMethod::Sturges);

        let result = calculate_histogram(&data, &config).unwrap();

        // Sturges rule: ceil(log2(n) + 1) = ceil(log2(100) + 1) ≈ 8
        let expected_bins = (100.0_f64.log2() + 1.0).ceil() as usize;
        assert_eq!(result.bin_edges.len(), expected_bins + 1);
    }

    #[test]
    fn test_histogram_with_outliers() {
        let data = vec![1.0, 2.0, 3.0, 4.0, 5.0, 1000.0]; // 1000.0 is outlier
        let config = HistogramConfig::new().bins(5).range(0.0, 10.0);

        let result = calculate_histogram(&data, &config).unwrap();

        // Outlier should be excluded from range
        assert_eq!(result.n_samples, 6); // Still counts all samples
        let total_in_range: f64 = result.counts.iter().sum();
        assert_eq!(total_in_range, 5.0); // Only 5 values in range
    }

    #[test]
    fn test_histogram_bin_edges() {
        let data = vec![0.0, 10.0];
        let config = HistogramConfig::new().bins(10).range(0.0, 10.0);

        let result = calculate_histogram(&data, &config).unwrap();

        // Check bin edges are evenly spaced
        assert_eq!(result.bin_edges.len(), 11);
        assert_eq!(result.bin_edges[0], 0.0);
        assert_eq!(result.bin_edges[10], 10.0);

        for i in 0..10 {
            let expected = i as f64;
            assert!((result.bin_edges[i] - expected).abs() < 1e-10);
        }
    }

    #[test]
    fn test_histogram_identical_values() {
        let data = vec![5.0; 100]; // All identical values
        let config = HistogramConfig::new().bins(1);

        let result = calculate_histogram(&data, &config).unwrap();

        assert_eq!(result.counts.len(), 1);
        assert_eq!(result.counts[0], 100.0);
    }

    #[test]
    fn test_histogram_with_nan_values() {
        let data = vec![1.0, 2.0, f64::NAN, 4.0, 5.0];
        let config = HistogramConfig::new().bins(4);

        let result = calculate_histogram(&data, &config).unwrap();

        // NaN values should be filtered out
        let total_count: f64 = result.counts.iter().sum();
        assert_eq!(total_count, 4.0); // Only finite values counted
    }

    #[test]
    fn test_histogram_scott_method() {
        let data: Vec<f64> = (0..1000).map(|x| x as f64 * 0.01).collect(); // 0.0 to 9.99
        let config = HistogramConfig::new().bin_method(BinMethod::Scott);

        let result = calculate_histogram(&data, &config);
        assert!(result.is_ok());

        let hist = result.unwrap();
        assert!(hist.bin_edges.len() > 1);
        assert_eq!(hist.bin_edges.len(), hist.counts.len() + 1);
    }

    #[test]
    fn test_histogram_freedman_diaconis_method() {
        let data: Vec<f64> = (0..1000).map(|x| x as f64 * 0.01).collect();
        let config = HistogramConfig::new().bin_method(BinMethod::FreedmanDiaconis);

        let result = calculate_histogram(&data, &config);
        assert!(result.is_ok());

        let hist = result.unwrap();
        assert!(hist.bin_edges.len() > 1);
        assert_eq!(hist.bin_edges.len(), hist.counts.len() + 1);
    }

    #[test]
    fn test_histogram_plot_data_trait() {
        let data = vec![1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0];
        let config = HistogramConfig::new().bins(5);

        let hist = calculate_histogram(&data, &config).unwrap();

        // Test data_bounds
        let ((x_min, x_max), (y_min, y_max)) = hist.data_bounds();
        assert!((x_min - 1.0).abs() < 1e-10);
        assert!((x_max - 10.0).abs() < 1e-10);
        assert!((y_min - 0.0).abs() < 1e-10); // histogram y starts at 0
        assert!(y_max > 0.0);

        // Test is_empty
        assert!(!hist.is_empty());
    }

    #[test]
    fn test_histogram_styling_defaults() {
        let data = vec![1.0, 2.0, 3.0, 4.0, 5.0];
        let config = HistogramConfig::new().bins(5);

        let hist = calculate_histogram(&data, &config).unwrap();

        // Check default styling values from defaults module
        assert!((hist.fill_alpha - 1.0).abs() < 1e-10); // HISTOGRAM_FILL_ALPHA = 1.0
        assert!((hist.edge_width - 0.8).abs() < 1e-10); // PATCH_LINE_WIDTH = 0.8
        assert!((hist.bar_width - 0.9).abs() < 1e-10); // HISTOGRAM_BAR_WIDTH = 0.9
        assert!(hist.edge_color.is_none()); // Auto-derived
    }

    #[test]
    fn test_histogram_custom_styling() {
        let data = vec![1.0, 2.0, 3.0, 4.0, 5.0];
        let config = HistogramConfig::new()
            .bins(5)
            .fill_alpha(0.5)
            .edge_width(2.0)
            .bar_width(0.7)
            .edge_color(Color::RED);

        let hist = calculate_histogram(&data, &config).unwrap();

        assert!((hist.fill_alpha - 0.5).abs() < 1e-10);
        assert!((hist.edge_width - 2.0).abs() < 1e-10);
        assert!((hist.bar_width - 0.7).abs() < 1e-10);
        assert_eq!(hist.edge_color, Some(Color::RED));
    }

    #[test]
    fn test_histogram_config_is_plot_config() {
        // Verify HistogramConfig implements PlotConfig
        fn accepts_plot_config<T: PlotConfig>(_: &T) {}
        let config = HistogramConfig::default();
        accepts_plot_config(&config);
    }
}