nibcq.OCVTestParameters

class nibcq.OCVTestParameters

Bases: nibcq.measurement.TestParameters, nibcq.measurement.ConfigFileSupport

Configuration parameters for Open Circuit Voltage (OCV) measurements.

This class extends the base TestParameters to provide DMM-specific configuration options for precision DC voltage measurements. OCV measurements are fundamental in battery testing and electrochemical analysis where accurate voltage measurement without load is critical for state-of-charge determination and system health assessment.

The parameters control measurement accuracy, speed, and noise rejection characteristics of the Digital Multimeter (DMM) used for OCV measurements. Proper configuration balances measurement precision with acquisition speed based on application requirements.

range

DMM voltage measurement range from DMMRange enum. Should be selected to provide adequate resolution while avoiding saturation. Common ranges include DC_10V for battery cells, DC_1000V for high-voltage systems. Auto-ranging is typically avoided for highest precision.

aperture_time

Integration time per measurement in powerline cycles. Longer aperture times improve noise rejection and measurement stability but increase acquisition time. Values of 1-10 cycles are typical for most applications.

number_of_averages

Number of internal measurements to average for each reported result. Higher values improve measurement precision by reducing random noise but increase total measurement time. Values of 1-100 are common.

adc_calibration

Enable/disable internal ADC calibration before measurement. When enabled, improves measurement accuracy by correcting for internal reference drift, but adds measurement time. Recommended for highest precision applications.

Example

>>> params = OCVTestParameters(
...     range=DMMRange.DC_10V,
...     aperture_time=1.0,
...     number_of_averages=10,
...     adc_calibration=True
... )
>>> # Configuration optimized for precision battery voltage measurement
classmethod from_json(json_data: Dict[str, Any]) → OCVTestParameters

Create OCVTestParameters instance from JSON dictionary.

Parameters:

json_data (Dict[str, Any]) – Dictionary containing OCV configuration data

Returns:

Instance configured from JSON data

Return type:

OCVTestParameters

Raises:

  • ValueError – If required parameters are missing or invalid

  • KeyError – If expected keys are not found in json_data

classmethod from_file(file_path: str) → OCVTestParameters

Create OCVTestParameters instance from JSON configuration file.

Parameters:

file_path (str) – Path to JSON configuration file

Returns:

Instance configured from file

Return type:

OCVTestParameters

Raises: