analyze_error_by_value

Overview

analyze_error_by_value rearranges ADC errors by their corresponding output codes, revealing code-dependent patterns like DNL-related errors, missing codes, and systematic nonlinearity.

Syntax

from adctoolbox import analyze_error_by_value

# Basic usage
result = analyze_error_by_value(signal, show_plot=True)

# With resolution specification
result = analyze_error_by_value(signal, resolution=12, show_plot=True)

Parameters

  • signal (array_like) — Input ADC signal (sine wave excitation)

  • resolution (int, optional) — ADC resolution in bits

  • show_plot (bool, default=False) — Display error vs. code plot

  • ax (matplotlib axis, optional) — Axis for plotting

Returns

Dictionary containing:

  • error_by_code — Errors grouped by ADC code

  • codes — Unique code values

  • mean_error — Mean error per code

  • std_error — Standard deviation per code

Use Cases

  • Identify code-dependent errors (DNL, missing codes)

  • Reveal systematic nonlinearity patterns

  • Validate calibration effectiveness

See Also

References

  1. IEEE Std 1241-2010, "IEEE Standard for Terminology and Test Methods for ADCs"