autoeq-plot 0.5.5

Plotly visualizations and report generation for AutoEQ
Documentation
use super::consts::CEA2034_CURVE_NAMES;
use super::consts::CEA2034_CURVE_NAMES_DI;
use super::consts::CEA2034_CURVE_NAMES_FULL;
use super::misc::shorten_curve_name;
use crate::filter_color::filter_color;
use ndarray::Array1;
use plotly::Scatter;
use plotly::common::Mode;
use std::collections::HashMap;

/// Create CEA2034 combined traces for a single subplot, including DI on a secondary y-axis
///
/// # Arguments
/// * `curves` - HashMap of curve names to Curve data
/// * `x_axis` - Axis id for x (e.g. "x7")
/// * `y_axis` - Axis id for primary y (left) (e.g. "y7")
pub(super) fn create_cea2034_combined_traces(
    curves: &HashMap<String, crate::Curve>,
    x_axis: &str,
    y_axis: &str,
    y_axis_di: &str,
) -> Vec<Scatter<f64, f64>> {
    let mut traces = Vec::new();
    for (i, curve_name) in CEA2034_CURVE_NAMES_FULL.iter().enumerate() {
        if let Some(curve) = curves.get(*curve_name) {
            let trace = Scatter::new(curve.freq.to_vec(), curve.spl.to_vec())
                .mode(Mode::Lines)
                .name(shorten_curve_name(curve_name))
                .x_axis(x_axis)
                .y_axis(y_axis)
                .line(plotly::common::Line::new().color(filter_color(i)));
            traces.push(*trace);
        }
    }
    // DI curves on secondary y-axis
    for (j, curve_name) in CEA2034_CURVE_NAMES_DI.iter().enumerate() {
        if let Some(curve) = curves.get(*curve_name) {
            let trace = Scatter::new(curve.freq.to_vec(), curve.spl.to_vec())
                .mode(Mode::Lines)
                .name(shorten_curve_name(curve_name))
                .x_axis(x_axis)
                .y_axis(y_axis_di)
                .line(plotly::common::Line::new().color(filter_color(j + 2)));
            traces.push(*trace);
        }
    }
    traces
}

/// Create CEA2034 combined traces with EQ applied on a single subplot
///
/// # Arguments
/// * `curves` - HashMap of curve names to Curve data
/// * `eq_response` - EQ response to apply to the primary CEA2034 curves
/// * `x_axis` - Axis id for x (e.g. "x8")
/// * `y_axis` - Axis id for primary y (left) (e.g. "y8")
pub(super) fn create_cea2034_with_eq_combined_traces(
    curves: &HashMap<String, crate::Curve>,
    eq_response: &Array1<f64>,
    x_axis: &str,
    y_axis: &str,
    y_axis_di: &str,
) -> Vec<Scatter<f64, f64>> {
    let mut traces = Vec::new();
    for (i, curve_name) in CEA2034_CURVE_NAMES_FULL.iter().enumerate() {
        if let Some(curve) = curves.get(*curve_name) {
            let trace = Scatter::new(curve.freq.to_vec(), (&curve.spl + eq_response).to_vec())
                .mode(Mode::Lines)
                .name(format!("{} w/EQ", shorten_curve_name(curve_name)))
                .x_axis(x_axis)
                .y_axis(y_axis)
                .line(plotly::common::Line::new().color(filter_color(i)));
            traces.push(*trace);
        }
    }
    // DI curves unchanged, on secondary y-axis
    for (j, curve_name) in CEA2034_CURVE_NAMES_DI.iter().enumerate() {
        if let Some(curve) = curves.get(*curve_name) {
            let trace = Scatter::new(curve.freq.to_vec(), curve.spl.to_vec())
                .mode(Mode::Lines)
                .name(shorten_curve_name(curve_name))
                .x_axis(x_axis)
                .y_axis(y_axis_di)
                .line(plotly::common::Line::new().color(filter_color(j + 2)));
            traces.push(*trace);
        }
    }
    traces
}

/// Create CEA2034 traces for the combined plot
///
/// # Arguments
/// * `curves` - HashMap of curve names to Curve data
///
/// # Returns
/// * Vector of Scatter traces for CEA2034 curves
///
/// # Details
/// Creates traces for standard CEA2034 curves
pub(super) fn create_cea2034_traces(
    curves: &HashMap<String, crate::Curve>,
) -> Vec<Scatter<f64, f64>> {
    let mut traces = Vec::new();

    let axes = ["x1y1", "x2y2", "x3y3", "x4y4"];

    for (i, (curve_name, axis)) in CEA2034_CURVE_NAMES.iter().zip(axes.iter()).enumerate() {
        let mut x_axis_name = &axis[..2];
        let mut y_axis_name = &axis[2..];
        if x_axis_name == "x1" || y_axis_name == "y1" {
            x_axis_name = "x";
            y_axis_name = "y";
        }
        if let Some(curve) = curves.get(*curve_name) {
            let trace = Scatter::new(curve.freq.to_vec(), curve.spl.to_vec())
                .mode(Mode::Lines)
                .name(shorten_curve_name(curve_name))
                .x_axis(x_axis_name)
                .y_axis(y_axis_name)
                .line(plotly::common::Line::new().color(filter_color(i)));
            traces.push(*trace);
        }
    }

    traces
}

/// Create CEA2034 traces with EQ response applied
///
/// # Arguments
/// * `curves` - HashMap of curve names to Curve data
/// * `eq_response` - Array of EQ response values to apply
///
/// # Returns
/// * Vector of Scatter traces for CEA2034 curves with EQ applied
///
/// # Details
/// Creates traces for standard CEA2034 curves with the EQ response
/// applied, using the same alias mapping as create_cea2034_traces.
pub(super) fn create_cea2034_with_eq_traces(
    curves: &HashMap<String, crate::Curve>,
    eq_response: &Array1<f64>,
) -> Vec<Scatter<f64, f64>> {
    let mut traces = Vec::new();

    let axes = ["x1y1", "x2y2", "x3y3", "x4y4"];

    for (i, (curve_name, axis)) in CEA2034_CURVE_NAMES.iter().zip(axes.iter()).enumerate() {
        let mut x_axis_name = &axis[..2];
        let mut y_axis_name = &axis[2..];
        if x_axis_name == "x1" || y_axis_name == "y1" {
            x_axis_name = "x";
            y_axis_name = "y";
        }
        if let Some(curve) = curves.get(*curve_name) {
            let trace = Scatter::new(curve.freq.to_vec(), (&curve.spl + eq_response).to_vec())
                .mode(Mode::Lines)
                .name(format!("{} w/EQ", shorten_curve_name(curve_name)))
                .x_axis(x_axis_name)
                .y_axis(y_axis_name)
                .line(plotly::common::Line::new().color(filter_color(i + 4)));
            traces.push(*trace);
        }
    }

    traces
}