These commands take the instrument from its current state, enable the specified measurement and put the instrument into single sweep mode. They correct any Parametersthat are invalid given the new measurement state such that a valid measurement can take place. Other settings may be changed; see the documentation of CONFigure for each measurement. They then initiate the measurement. When the measurement is complete, they return the result.
To make a measurement with settings other than the “default” measurement settings applied by CONFigure, do the following:
• Send the appropriate CONFigure command to set the desired measurement.
• Modify the settings as required.
• Send the appropriate READ command to measure and return the result.
To get the current measurement data, use the appropriate FETCh command.
:MEASure:CHPower?
Title
Measure Channel Power And Density
Description
Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement and returns the channel power and channel power density results. It is a combination of the commands :CONFigure:CHPower;:READ:CHPower? For a Descriptionof the default channel power measurement Parameterssee :CONFigure:CHPower. To make a channel power measurement with settings other than the default values send: :CONFigure:CHPower Commands to set desired settings :READ:CHPower? Data is returned as 2 comma-separated values: channel power, channel power density.
:MEASure:CHPower:CHPower?
Title
Measure Channel Power
Description
Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement and returns channel power as the result. To measure both channel power and channel power density use MEASure:CHPower? It is a combination of the commands :CONFigure:CHPower;:READ:CHPower? For a Descriptionof the default channel power measurement Parameterssee :CONFigure:CHPower. To make a channel power measurement with settings other than the default values send: :CONFigure:CHPower Commands to set desired settings :READ:CHPower?
:MEASure:CHPower:DENSity?
Title
Measure Channel Power Density
Description
Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement and returns channel power density as the result.To measure both channel power and channel power density use MEASure:CHPower? It is a combination of the commands :CONFigure:CHPower;:READ:CHPower? For a Descriptionof the default channel power measurement Parameterssee: :CONFigure:CHPower. To make a channel power measurement with settings other than the default values send: :CONFigure:CHPower Commands to set desired settings :READ:CHPower?
:MEASure:IQ:CAPTure
Title
Measure IQ Capture
Description
This set command is used to start the IQ capture measurement. If IQ:MODE is SINGle, this command will triger a single I/Q block capture. While the capture is in progress the I/Q Capture bit of STATus:OPERation? will be set to 1. Clients can read the captured data with the TRAC:IQ:DATA? query.
If IQ:MODE is STREAM, this command will start streaming capture of I/Q data. The most recently captured block of I/Q data can be read with the TRAC:IQ:DATA? query. In STREAM capture mode, the capture will not complete until aborted. While streaming is going, clients will need to continuously read captured blocks with TRAC:IQ:DATA?.
Regardless of the capture mode, the capture can be aborted. The capture can be aborted with the ABORt command preferably, though most commands which change hardware settings will also abort the capture (clients should assume that any non-query command sent while a capture is in progress will abort the capture). To determine if the capture was aborted, check the output of STATus:OPERation?.
The capture will also be ’paused’ if the instrument detects an overpower or overheat condition: in this situation, any pending TRAC:IQ:DATA? query will immediately return #0 and a device-specific error will be added to the SCPI error queue. When the condition is rectified (either by removing the source of the overpower and closing the overpower relay, or waiting for the instrument to cool down), the capture will automatically restart. Additionally if the instrument detects a change in reference source (either due to a loss/acquisition of GPS or a connection/disconnection of external reference) a device-specific error will be added to the SCPI error queue.
In either capture mode, this command will do nothing if a capture is already in progress.
The device-specific errors this command adds to the SCPI error queue include a Descriptionthat looks like the following:
• Device-specific error;Reference source changed during capture @ Thu Jun 18 17:02:03 2015
• Device-specific error;Capture paused due to overheating @ Thu Jun 18 17:02:03 2015
• Device-specific error;Capture paused due to RF overpower @ Thu Jun 18 17:02:03 2015
Each Descriptioncontains the reason for the error and a timestamp when the error occurred.