nibcq.LCRTestParameters
=======================

.. py:class:: nibcq.LCRTestParameters

   Bases: :py:obj:`nibcq.measurement.ConfigFileSupport`


   Test parameters specific to LCR Meter (PXIe-4190) ACIR measurements.

   Unlike SMU/DMM parameters, LCR does NOT use powerline_frequency.
   The LCR hardware handles noise rejection internally.

   Supports two ways to create instances:
   1. Direct instantiation with keyword arguments
   2. Loading from JSON file via from_file() classmethod

   .. attribute:: cable_length

      Cable length setting.
      Default is NI_STANDARD_1M (1 meter).

      :type: nidcpower.CableLength

   .. attribute:: voltage_range

      Peak voltage range (10V or 40V),
      converted to RMS internally. Default is PEAK_10V (7V RMS).

      :type: LCRVoltageRange

   .. attribute:: current_amplitude

      AC current amplitude in Amperes RMS.
      Range: 7.08e-9 A to 0.707 A. Default is 0.07 A.

      :type: float

   .. attribute:: open_compensation_enabled

      Enable open compensation from onboard storage.

      :type: bool

   .. attribute:: short_compensation_enabled

      Enable short compensation from onboard storage.

      :type: bool

   .. attribute:: load_compensation_enabled

      Enable load compensation from onboard storage.
      Note: Load compensation requires both open AND short to be enabled.

      :type: bool

   .. rubric:: Examples

   >>> # Direct instantiation
   >>> params = LCRTestParameters(
   ...     voltage_range=LCRVoltageRange.PEAK_10V,
   ...     current_amplitude=0.07,
   ...     open_compensation_enabled=True,
   ... )
   >>> # From JSON file
   >>> params = LCRTestParameters.from_file("config/lcr_config.json")


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


      Create LCRTestParameters instance from JSON dictionary.

      :param json_data: Dictionary containing LCR configuration data.
      :type json_data: Dict[str, Any]

      :returns: Instance configured from JSON data.
      :rtype: LCRTestParameters

      :raises LCRParameterError: If parameters are invalid.
      :raises KeyError: If expected keys are not found.



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


      Create LCRTestParameters instance from JSON configuration file.

      :param file_path: Path to JSON configuration file.
      :type file_path: str

      :returns: Instance configured from file.
      :rtype: LCRTestParameters

      :raises FileNotFoundError: If configuration file is not found.
      :raises LCRParameterError: If file content is invalid.
      :raises json.JSONDecodeError: If file contains invalid JSON.