DynExp
Highly flexible laboratory automation for dynamically changing experiments.
DynExpInstr::ZI_MFLIParams Class Reference
+ Inheritance diagram for DynExpInstr::ZI_MFLIParams:

Public Member Functions

 ZI_MFLIParams (DynExp::ItemIDType ID, const DynExp::DynExpCore &Core)
 
virtual ~ZI_MFLIParams ()=default
 
virtual const char * GetParamClassTag () const noexcept override
 This function is intended to be overridden once in each derived class returning the name of the respective class. Parameters defined in any class within the ParamsBase hierarchy will receive a 'this' pointer pointing to ParamsBase when their ParamBase constructors are called. The ParamBase constructors will register the respective parameter in ParamsBase::OwnedParams calling GetParamClassTag() on the given 'this' pointer. This allows the ParamBase constructor to obtain the name of the class where the respective parameter was declared in. The name is used as an XML tag containing related parameters in the project files. Here, it is fully intended that the virtual call to GetParamClassTag() leads only to a call of GetParamClassTag() of the current dynamic type of ParamsBase! More...
 
- Public Member Functions inherited from DynExpInstr::LockinAmplifierParams
 LockinAmplifierParams (DynExp::ItemIDType ID, const DynExp::DynExpCore &Core)
 Constructs the parameters for a LockinAmplifier instance. More...
 
virtual ~LockinAmplifierParams ()=0
 
- Public Member Functions inherited from DynExpInstr::DataStreamInstrumentParams
 DataStreamInstrumentParams (DynExp::ItemIDType ID, const DynExp::DynExpCore &Core)
 Constructs the parameters for a DataStreamInstrument instance. More...
 
virtual ~DataStreamInstrumentParams ()=0
 
- Public Member Functions inherited from DynExp::InstrumentParamsBase
 InstrumentParamsBase (ItemIDType ID, const DynExpCore &Core)
 Constructs the parameters for a InstrumentBase instance. More...
 
virtual ~InstrumentParamsBase ()=0
 
- Public Member Functions inherited from DynExp::RunnableObjectParams
 RunnableObjectParams (ItemIDType ID, const DynExpCore &Core)
 Constructs the base class of an object parameter class. More...
 
virtual ~RunnableObjectParams ()=0
 
bool ConfigureStartupType () const noexcept
 Determines whether the Startup parameter should be user-configurable in settings dialogs. Override ConfigureStartupTypeChild() in order to adjust. More...
 
- Public Member Functions inherited from DynExp::ParamsBase
 ParamsBase (ItemIDType ID, const DynExpCore &Core)
 Constructs the base class of an object parameter class. More...
 
virtual ~ParamsBase ()=0
 
QDomElement ConfigToXML (QDomDocument &Document) const
 Creates an XML node with a tag name as determined by GetParamClassTag() containing all parameters belonging to this ParamsBase instance. More...
 
void ConfigFromXML (const QDomElement &XMLElement) const
 Retrieves all parameters belonging to this ParamsBase instance from an XML node with a tag name as determined by GetParamClassTag() More...
 
void ConfigFromDialog (ParamsConfigDialog &Dialog)
 Adds all parameters belonging to this ParamsBase instance to a settings dialog to let the user configure the parameter values. More...
 
bool Validate () const
 Refer to ParamBase::Validate(). More...
 
ItemIDType GetID () const noexcept
 Returns the ID of the Object this parameter class instance belongs to. More...
 
const auto & GetCore () const noexcept
 Returns a reference to DynExp's core. More...
 
const auto & GetObjectLinkParams () const noexcept
 Returns a list of all object link parameters owned by this parameter class instance. More...
 
bool ConfigureUsageType () const noexcept
 Determines whether the Usage parameter should be configurable in the settings dialog. Override ConfigureUsageTypeChild() in order to adjust. More...
 
const NetworkParamsExtensionGetNetworkAddressParams () const noexcept
 Returns the network address parameters of a derived gRPC instrument. Override GetNetworkAddressParamsChild() in order to adjust. More...
 
- Public Member Functions inherited from Util::INonCopyable
 INonCopyable (const INonCopyable &)=delete
 
INonCopyableoperator= (const INonCopyable &)=delete
 

Static Public Member Functions

static Util::TextValueListType< DynExpHardware::ZILabOneHardwareAdapter::SignalInputTypeSignalInputTypeStrList ()
 
- Static Public Member Functions inherited from DynExpInstr::LockinAmplifierParams
static Util::TextValueListType< AutoApplyParamsTypeAutoApplyParamsTypeStrList ()
 Maps description strings to the AutoApplyParamsType enum's items. More...
 
- Static Public Member Functions inherited from DynExp::RunnableObjectParams
static Util::TextValueListType< StartupTypeAvlblStartupTypeStrList ()
 Maps description strings to the RunnableObjectParams::StartupType enum's items. More...
 
- Static Public Member Functions inherited from DynExp::ParamsBase
static Util::TextValueListType< UsageTypeAvlblUsageTypeStrList ()
 Maps description strings to the ParamsBase::UsageType enum's items. More...
 
static void DisableUserEditable (ParamBase &Param) noexcept
 Sets the UserEditable property of the parameter Param to false. Refer to ParamBase::UserEditable. More...
 

Public Attributes

Param< DynExp::ObjectLink< DynExpHardware::ZILabOneHardwareAdapter > > HardwareAdapter
 
Param< DynExpHardware::ZILabOneHardwareAdapter::SignalInputTypeSignalInput
 
Param< ParamsConfigDialog::NumberTypeDemodulator
 
Param< ParamsConfigDialog::NumberTypeTriggerChannel
 
- Public Attributes inherited from DynExpInstr::LockinAmplifierParams
Param< AutoApplyParamsTypeAutoApplyParams
 Parameter to indicate whether to apply parameters stored here to the instrument when it is started. Refer to LockinAmplifier::ApplyFromParams(). More...
 
Param< double > Sensitivity { *this, "Sensitivity", 1, 0 }
 Parameter to store the lock-in amplifier's sensitivity/amplification setting. More...
 
Param< double > Phase { *this, "Phase", 0, 0, 2.0 * std::numbers::pi }
 Parameter to store the phase in rad of the lock-in amplifier's demodulator. More...
 
Param< double > TimeConstant { *this, "TimeConstant", 1e-3, 0 }
 Parameter to store the time constant in seconds of the lock-in amplifier's low-poss filter. More...
 
Param< unsigned int > FilterOrder { *this, "FilterOrder", 1, 1, 10 }
 Parameter to store the filter order/quality of the lock-in amplifier's low-poss filter. More...
 
Param< LockinAmplifierDefs::TriggerModeTypeTriggerMode { *this, "TriggerMode", LockinAmplifierDefs::TriggerModeType::ExternSingle }
 Parameter to store the lock-in amplifier's trigger mode. More...
 
Param< LockinAmplifierDefs::TriggerEdgeTypeTriggerEdge { *this, "TriggerEdge", LockinAmplifierDefs::TriggerEdgeType::Fall }
 Parameter to store the lock-in amplifier's trigger edge. More...
 
Param< LockinAmplifierDefs::SignalTypeSignal { *this, "Signal", LockinAmplifierDefs::SignalType::R }
 Parameter to store the lock-in amplifier's signal coordinate type to write to the data stream. More...
 
Param< double > SamplingRate { *this, "SamplingRate", 1000, 1 }
 Parameter to store the lock-in amplifier's sampling rate in samples/s. More...
 
Param< bool > Enable { *this, "Enable", false }
 Parameter to store whether the lock-in amplifier's demodulator is enabled. More...
 
- Public Attributes inherited from DynExp::RunnableObjectParams
Param< StartupTypeStartup
 Determines when the runnable object is started. Refer to RunnableObjectParams::StartupType. More...
 
- Public Attributes inherited from DynExp::ParamsBase
Param< ParamsConfigDialog::TextTypeObjectName = { *this, "ObjectName", "Name", "Name to identify this item", false }
 String set by the user to identify the object this parameter class instance belongs to. More...
 
Param< UsageTypeUsage
 Determines whether an object can be used by only one other ("unique") or by multiple other ("shared") objects. More...
 

Private Member Functions

void ConfigureParamsImpl (dispatch_tag< LockinAmplifierParams >) override final
 Called by DynExp::ParamsBase::ConfigureParams() as a starting point for the tag dispatch mechanism to descend the inheritance hierarchy. Override to add functionality to ConfigureParams(). Refer to DynExp::ParamsBase::dispatch_tag. More...
 
virtual void ConfigureParamsImpl (dispatch_tag< ZI_MFLIParams >)
 

Additional Inherited Members

- Public Types inherited from DynExpInstr::LockinAmplifierParams
enum  AutoApplyParamsType { DoNotApply , AutoApply }
 Type to determine whether to apply parameters stored here to the lock-in amplifier when the instrument is started. More...
 
- Public Types inherited from DynExp::RunnableObjectParams
enum  StartupType { OnCreation , Automatic , Manual }
 Determines when a RunnableObject instance is started. More...
 
- Public Types inherited from DynExp::ParamsBase
enum  UsageType { Unique , Shared }
 Determines whether an Object can be linked to only one (unique) or multiple (shared) other objects. More...
 
using ObjectLinkParamsType = std::vector< std::reference_wrapper< LinkBase > >
 Type of a list of all owned object link parameters. More...
 
using EnumParamSignedIntegerType = intmax_t
 Parameter type to convert signed eumeration parameters to. More...
 
using EnumParamUnsignedIntegerType = uintmax_t
 Parameter type to convert unsigned eumeration parameters to. More...
 
template<typename EnumType >
using LargestEnumUnderlyingType = std::conditional_t< std::is_signed_v< std::underlying_type_t< EnumType > >, EnumParamSignedIntegerType, EnumParamUnsignedIntegerType >
 Type trait providing an integer type for enumeration types which allows to store the value of enumeration variables of that type in a file. More...
 
using Text = Util::TextType
 String type of text-type parameters (DynExp::ParamsBase::Param) More...
 
template<typename ArithmeticType >
using UnderlyingArithmeticParamType = TypedParamBase< ArithmeticType >
 
using UnderlyingTextParamType = TypedParamBase< Util::TextType >
 
using UnderlyingTextListParamType = TypedParamBase< Util::TextType >
 
using UnderlyingIndexedTextListParamType = TypedParamBase< Util::TextListIndexType >
 
template<typename EnumType >
using UnderlyingEnumParamType = TypedParamBase< LargestEnumUnderlyingType< EnumType > >
 If ParamType is an enum, then use largest signed/unsigned integral type as the underlying type since the enum's underlying type has to be integral. More...
 
using UnderlyingLinkParamType = TypedParamBase< ItemIDType >
 
template<typename ArithmeticType >
using UnderlyingArithmeticListParamType = TypedListParamBase< ArithmeticType >
 
using UnderlyingLinkListParamType = TypedListParamBase< ItemIDType >
 
- Protected Member Functions inherited from Util::ISynchronizedPointerLockable
 ISynchronizedPointerLockable ()
 
 ~ISynchronizedPointerLockable ()
 Object should never be destroyed before completely unlocked. More...
 
- Protected Member Functions inherited from Util::INonCopyable
constexpr INonCopyable ()=default
 
 ~INonCopyable ()=default
 

Detailed Description

Definition at line 318 of file ZI_MFLI.h.

Constructor & Destructor Documentation

◆ ZI_MFLIParams()

DynExpInstr::ZI_MFLIParams::ZI_MFLIParams ( DynExp::ItemIDType  ID,
const DynExp::DynExpCore Core 
)
inline

Definition at line 323 of file ZI_MFLI.h.

◆ ~ZI_MFLIParams()

virtual DynExpInstr::ZI_MFLIParams::~ZI_MFLIParams ( )
virtualdefault

Member Function Documentation

◆ ConfigureParamsImpl() [1/2]

void DynExpInstr::ZI_MFLIParams::ConfigureParamsImpl ( dispatch_tag< LockinAmplifierParams )
inlinefinaloverrideprivatevirtual

Called by DynExp::ParamsBase::ConfigureParams() as a starting point for the tag dispatch mechanism to descend the inheritance hierarchy. Override to add functionality to ConfigureParams(). Refer to DynExp::ParamsBase::dispatch_tag.

Reimplemented from DynExpInstr::LockinAmplifierParams.

Definition at line 339 of file ZI_MFLI.h.

◆ ConfigureParamsImpl() [2/2]

virtual void DynExpInstr::ZI_MFLIParams::ConfigureParamsImpl ( dispatch_tag< ZI_MFLIParams )
inlineprivatevirtual

Definition at line 340 of file ZI_MFLI.h.

◆ GetParamClassTag()

virtual const char* DynExpInstr::ZI_MFLIParams::GetParamClassTag ( ) const
inlineoverridevirtualnoexcept

This function is intended to be overridden once in each derived class returning the name of the respective class. Parameters defined in any class within the ParamsBase hierarchy will receive a 'this' pointer pointing to ParamsBase when their ParamBase constructors are called. The ParamBase constructors will register the respective parameter in ParamsBase::OwnedParams calling GetParamClassTag() on the given 'this' pointer. This allows the ParamBase constructor to obtain the name of the class where the respective parameter was declared in. The name is used as an XML tag containing related parameters in the project files. Here, it is fully intended that the virtual call to GetParamClassTag() leads only to a call of GetParamClassTag() of the current dynamic type of ParamsBase!

Returns
Name of the class this function is defined in

Reimplemented from DynExpInstr::LockinAmplifierParams.

Definition at line 326 of file ZI_MFLI.h.

◆ SignalInputTypeStrList()

Util::TextValueListType< DynExpHardware::ZILabOneHardwareAdapter::SignalInputType > DynExpInstr::ZI_MFLIParams::SignalInputTypeStrList ( )
static

Definition at line 265 of file ZI_MFLI.cpp.

Member Data Documentation

◆ Demodulator

Param<ParamsConfigDialog::NumberType> DynExpInstr::ZI_MFLIParams::Demodulator
Initial value:
= { *this, "Demodulator", "Demodulator",
"Demodulator of the lock-in amplifier to read out", true, 0, 0, std::numeric_limits<uint8_t>::max(), 1, 0 }

Definition at line 333 of file ZI_MFLI.h.

◆ HardwareAdapter

Param<DynExp::ObjectLink<DynExpHardware::ZILabOneHardwareAdapter> > DynExpInstr::ZI_MFLIParams::HardwareAdapter
Initial value:
= { *this, GetCore().GetHardwareAdapterManager(),
"HardwareAdapter", "ZI LabOne instance", "Underlying hardware adapter of this instrument", DynExpUI::Icons::HardwareAdapter }
const auto & GetCore() const noexcept
Returns a reference to DynExp's core.
Definition: Object.h:1677
constexpr auto HardwareAdapter

Definition at line 328 of file ZI_MFLI.h.

◆ SignalInput

Param<DynExpHardware::ZILabOneHardwareAdapter::SignalInputType> DynExpInstr::ZI_MFLIParams::SignalInput
Initial value:
= {
*this, SignalInputTypeStrList(), "SignalInput", "Input signal type",
"Determines which signal input to use", true, DynExpHardware::ZILabOneHardwareAdapter::SignalInputType::Voltage }
static Util::TextValueListType< DynExpHardware::ZILabOneHardwareAdapter::SignalInputType > SignalInputTypeStrList()
Definition: ZI_MFLI.cpp:265

Definition at line 330 of file ZI_MFLI.h.

◆ TriggerChannel

Param<ParamsConfigDialog::NumberType> DynExpInstr::ZI_MFLIParams::TriggerChannel
Initial value:
= { *this, "TriggerChannel", "Trigger channel",
"Trigger channel to use for external trigger modes", true, 1, 1, std::numeric_limits<uint8_t>::max(), 1, 0 }

Definition at line 335 of file ZI_MFLI.h.


The documentation for this class was generated from the following files: