nibcq.OCVTestParameters
=======================

.. py:class:: nibcq.OCVTestParameters

   Bases: :py:obj:`nibcq.measurement.TestParameters`, :py:obj:`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.

   .. attribute:: 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.

   .. attribute:: 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.

   .. attribute:: 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.

   .. attribute:: 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.

   .. rubric:: 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


   .. py:method:: from_json(json_data: Dict[str, Any]) -> OCVTestParameters
      :classmethod:


      Create OCVTestParameters instance from JSON dictionary.

      :param json_data: Dictionary containing OCV configuration data

      :returns: Instance configured from JSON data
      :rtype: OCVTestParameters

      :raises ValueError: If required parameters are missing or invalid
      :raises KeyError: If expected keys are not found in json_data



   .. py:method:: from_file(file_path: str) -> OCVTestParameters
      :classmethod:


      Create OCVTestParameters instance from JSON configuration file.

      :param file_path: Path to JSON configuration file

      :returns: Instance configured from file
      :rtype: OCVTestParameters

      :raises FileNotFoundError: If configuration file is not found
      :raises ValueError: If file content is invalid or required parameters are missing
      :raises json.JSONDecodeError: If file contains invalid JSON