Source code for rsrtx.Implementations.Digital.Data.Header

from ....Internal.Core import Core
from ....Internal.CommandsGroup import CommandsGroup
from ....Internal.StructBase import StructBase
from ....Internal.ArgStruct import ArgStruct
from .... import repcap


# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
class HeaderCls:
	"""
	| Commands in total: 1
	| Subgroups: 0
	| Direct child commands: 1
	"""

	def __init__(self, core: Core, parent):
		self._core = core
		self._cmd_group = CommandsGroup("header", core, parent)

	# noinspection PyTypeChecker


	class GetStruct(StructBase):
		"""
		Response structure. Fields: \n
			- 1 Start: float: No parameter help available
			- 2 Stop: float: No parameter help available
			- 3 Record_Length: int: No parameter help available
			- 4 Vals_Per_Smp: int: No parameter help available
		"""
		__meta_args_list = [
			ArgStruct.scalar_float('Start'),
			ArgStruct.scalar_float('Stop'),
			ArgStruct.scalar_int('Record_Length'),
			ArgStruct.scalar_int('Vals_Per_Smp')]

		def __init__(self):
			StructBase.__init__(self, self)
			self.Start: float = None
			self.Stop: float = None
			self.Record_Length: int = None
			self.Vals_Per_Smp: int = None




	def get(self, digitalNull=repcap.DigitalNull.Default) -> GetStruct:
		"""
		``DIGital<*>:DATA:HEADer`` \n
		Snippet: ``value: GetStruct = driver.digital.data.header.get(digitalNull = repcap.DigitalNull.Default)`` \n
		Returns the header of digital channel data
		Position / Meaning / Example \n
			- 1 / XStart, acquisition time before trigger, in s / 5E-008 = - 50 ns
			- 2 / XStop, acquisition time after trigger, in s / 5E-008 = 50 ns
			- 3 / Record length of the waveform in Samples / 1000
			- 4 / Number of values per sample interval. For digital data the result is 1. / 1

		:param digitalNull: optional repeated capability selector. Default value: Nr0 (settable in the interface 'Digital')
		:return: structure: for return value, see the help for GetStruct structure arguments.
		"""
		digitalNull_cmd_val = self._cmd_group.get_repcap_cmd_value(digitalNull, repcap.DigitalNull)
		return self._core.io.query_struct(f'DIGital{digitalNull_cmd_val}:DATA:HEADer?', self.__class__.GetStruct())