CALCulate<Chn>:RIPPle...    Related Topics

This subsystem defines the ripple limits and controls the ripple check.

 

Command tree: CALCulate<Chn>:RIPPle

:CONTrol

:DOMain

:DATA

:DELete

:ALL

:DISPlay

[:STATe]

:FAIL?

:RDOMain

:FORMat

:SEGMent

:COUNt?

:LIMit

:RESult?

[:STATe]

:STIMulus

:STARt

:STOP

:SOUNd

[:STATe]

:STATe

CALCulate<Chn>:RIPPle:CONTrol:DOMain
FLIN | FLOG | FSEG | FSINgle | TLIN | TLOG | PLIN | PLOG | PSINgle

Deletes the existing ripple limit ranges and (re-)defines the physical units of the stimulus values of the ripple limit lines. The unit of the ripple limit is defined via CALCulate<Chn>:RIPPle:RDOMain:FORMat

<Chn>

Channel number used to identify the active trace.

 

Parameters

Keywords for the units of the stimulus values.

The selected unit must be compatible with the sweep type ([SENSe<Ch>:]SWEep:TYPE); otherwise the ripple limit lines cannot be displayed and no ripple limit check is possible.

Range [def. unit]

The parameters form three groups:

  • FLIN, FLOG, FSEG, and FSINgle select frequency units [default: Hz] for the ripple limit.

  • TLIN and TLOG select time units [default: s].

  • PLIN, PLOG and PSINgle select power units [default: dBm].

*RST value

FLIN

 

SCPI, Command Types

Device-specific, no query.  

 

Example:

SWE:TYPE POW

Select a power sweep.

CALC:RIPP:CONT:DOM PLIN

Delete all existing ripple limit ranges and select level units for the ripple limit of the active trace.

CALC:RIPP:DATA 1, -10,-5,3

Define and enable a ripple limit range in the stimulus range between -10 dBm  and -5 dBm, assigning a ripple limit of 3 dBm.  

 

 

CALCulate<Chn>:RIPPle:DATA <type>, <start_stim>, <stop_stim>, <limit>{,<type>, <start_stim>, <stop_stim>, <limit>}

Adds and enables/disables an arbitrary number of ripple limit ranges, assigning the stimulus values and the ripple limits.

This command does not overwrite existing ripple limit ranges. The defined ranges are appended to the range list as new ranges.

<Chn>

Channel number used to identify the active trace.

 

<type>

Identifier for the type of the ripple limit range.

Range [def. unit]

0 – Ripple limit range off, range defined but no limit check result displayed. The result is still available via CALCulate<Chn>:RIPPle:SEGMent<Seg>:RESult?
1 – Ripple limit range on (with limit check)

<start_stim>,
<stop_stim>,
<limit>

Stimulus values of the first and last points of the ripple limit range and associated ripple limit.

Range [def. unit]

Almost no restriction for limit ranges; see Rules for Limit Line Definition. [Hz for frequency sweeps, dBm for power sweeps, s for time sweeps, see CALCulate<Chn>:RIPPle:CONTrol:DOMain]  

*RST values

– (no ripple limit line defined after *RST)  

 

SCPI, Command Types

Device-specific, with query.

 

Example:

*RST; :CALC:RIPP:DATA 1,1500000000, 2000000000,3, 1, 2000000000, 3000000000, 5

Define and enable a ripple limit range in the stimulus range between 1.5 GHz and 2 GHz, assigning a ripple limit of +3 dBm. Define and enable a second ripple limit range in the stimulus range between 2 GHz and 3 GHz, assigning a ripple limit of +5 dBm.

CALC:RIPP:DISP ON

Show the ripple limit ranges in the active diagram.

 

 

CALCulate<Chn>:RIPPle:DELete:ALL

Deletes all ripple limit ranges.  

<Chn>

Channel number used to identify the active trace.

 

*RST value

–

SCPI, Command Types

Device-specific, no query.

 

Example:

*RST; :CALC:RIPP:DATA 1,1500000000, 2000000000,3, 1, 2000000000, 3000000000, 5

Define and enable a ripple limit range in the stimulus range between 1.5 GHz and 2 GHz, assigning a ripple limit of +3 dBm. Define and enable a second ripple limit range in the stimulus range between 2 GHz and 3 GHz, assigning a ripple limit of +5 dBm.

CALC:RIPP:DEL:ALL

Delete both created ripple limit ranges.

 

 

CALCulate<Chn>:RIPPle:DISPlay[:STATe] <Boolean>

Displays or hides all ripple limit lines (including all ranges) associated to the active trace.

<Chn>

Channel number used to identify the active trace.  

 

<Boolean>

ON | OFF - Limit line on or off.  

*RST value

OFF  

 

SCPI, Command Types

Device-specific, command or query.  

 

Example:

*RST; :CALC:RIPP:DATA 1,1500000000, 2000000000,3

Define and enable a ripple limit range in the stimulus range between 1.5 GHz and 2 GHz, assigning a ripple limit of +3 dBm.

CALC:RIPP:DISP ON

Show the ripple limit range in the active diagram.

 

 

CALCulate<Chn>:RIPPle:FAIL?

Returns a 0 or 1, to indicate whether or not the global ripple limit check has failed.

Use CALCulate<Chn>:RIPPle:SEGMent<Seg>:RESult? to query the result for a single ripple limit range.

In remote control, the ripple limit check result is calculated once at the end of each sweep. If the ripple limits are changed, a new sweep is required to obtain updated ripple limit check results. In single sweep mode (INITiate<Ch>:CONTinuous OFF), the new sweep must be started explicitly using INITiate<Ch>[:IMMediate]:SCOPe ALL | SINGle. This behavior is different from manual control where a changed ripple limit line can directly affect the pass/fail result of the displayed trace.  

<Chn>

Channel number used to identify the active trace.  

 

Response

0 | 1 - 0 represents pass (or a disabled limit check), 1 represents fail in at least one ripple limit range.

*RST value

0

 

SCPI, Command Types

Device-specific, query only.  

 

Example:

*RST; :CALC:RIPP:DATA 1,1500000000, 2000000000,3

Define and enable a ripple limit range in the stimulus range between 1.5 GHz and 2 GHz, assigning a ripple limit of +3 dBm.

CALC:RIPP:STAT ON; FAIL?

Switch the limit check on and query the result.  

 

 

CALCulate<Chn>:RIPPle:RDOMain:FORMat
COMPlex | MAGNitude | PHASe | REAL | IMAGinary | SWR | GDELay | L | C

Deletes the existing ripple limit ranges and (re-)defines the physical unit of the ripple limit. The units of the stimulus values are defined via CALCulate<Chn>:RIPPle:CONTrol:DOMain.

<Chn>

Channel number used to identify the active trace.

 

Parameters

Keyword for the physical unit of the response values.

Range [def. unit]

The parameters form four groups:

  • COMPlex, REAL, IMAGinary, and SWR select dimensionless numbers (U) for the ripple limit.

  • MAGNitude selects relative units (dB).

  • PHASe selects phase units (deg).

  • GDELay selects time units (s).

  • L selects inductance units (H/Henry).

  • C selects capacitance units (F/Farad).

[–]

*RST value

–

 

SCPI, Command Types

Device-specific, no query.

Example

*RST; :CALC:RIPP:DATA 1,1500000000, 2000000000,3

Define and enable a ripple limit range in the stimulus range between 1.5 GHz and 2 GHz, assigning a ripple limit of +3 dBm.

CALC:RIPP:RDOM:FORM COMP

Delete the ripple limit range, select complex units for the ripple limit.  

 

 

CALCulate<Chn>:RIPPle:SEGMent<Seg>:LIMit <limit_value>

Defines the ripple limit for ripple limit range no. <Seg>. A range must be created first to enable this command (e.g CALCulate<Chn>:RIPPle:DATA).

To define several ripple limit ranges with a single command, use CALCulate<Chn>:RIPPle:DATA.

<Chn>

Channel number used to identify the active trace.

 

<Seg>

Segment number

 

<limit_value>

Limit value, to be defined in accordance with the selected format (CALCulate<Chn>:RIPPle:RDOMain:FORMat).

Range [def. unit]

Almost no restriction for limit ranges; see Rules for Limit Line Definition.
[Hz for frequency sweeps, dBm for power sweeps, s for time sweeps]

*RST value

– (no ripple limit line defined after *RST)

 

SCPI, Command Types

Device-specific, with query.

 

Example:

See CALCulate<Chn>:RIPPle:SEGMent<Seg>:STIMulus:STARt.   

 

 

CALCulate<Chn>:RIPPle:SEGMent<Seg>:COUNt?

Queries the number of ripple limit ranges.

<Chn>

Channel number used to identify the active trace.  

 

<Seg>

Ripple limit range number. This suffix is ignored; the command counts all ranges.

Response

0 | 1 | ...- number of (enabled or disabled)) ripple limit ranges.

*RST value

0

 

SCPI, Command Types

Device-specific, query only.  

 

Example:

*RST; :CALC:RIPP:DATA 1,1500000000, 2000000000,3, 1, 2000000000, 3000000000, 5

Define and enable a ripple limit range in the stimulus range between 1.5 GHz and 2 GHz, assigning a ripple limit of +3 dBm. Define and enable a second ripple limit range in the stimulus range between 2 GHz and 3 GHz, assigning a ripple limit of +5 dBm.

CALC:RIPP:SEGM:COUNT?

Query the number of ranges. The response is 2.   

 

 

CALCulate<Chn>:RIPPle:SEGMent<Seg>:RESult?

Returns the result of the ripple limit check in the previously defined limit range no. <Seg>.  

Use CALCulate<Chn>:RIPPle:FAIL? to query the result for global ripple limit check.

In remote control, the ripple limit check result is calculated once at the end of each sweep. If the ripple limits are changed, a new sweep is required to obtain updated ripple limit check results. In single sweep mode (INITiate<Ch>:CONTinuous OFF), the new sweep must be started explicitly using INITiate<Ch>[:IMMediate]:SCOPe ALL | SINGle. This behavior is different from manual control where a changed ripple limit line can directly affect the pass/fail result of the displayed trace.  

<Chn>

Channel number used to identify the active trace.  

 

<Seg>

Ripple limit range number

Response:

 

<Fail>,
<Limit>

0 | 1 - 0 represents pass, 1 represents fail
Measured ripple in the limit range. A result is returned even if the limit check in the range no. <Seg> is disabled; see example below.

*RST value

– (a reset deletes all ripple limit ranges)

 

SCPI, Command Types

Device-specific, query only  

 

Example:

*RST; :CALC:RIPP:DATA 1,1500000000, 2000000000,3

Define and enable a ripple limit range in the stimulus range between 1.5 GHz and 2 GHz, assigning a ripple limit of +3 dBm.

CALC:RIPP:STAT ON; SEGM:RES?

Enable the limit check and query the result for the created range. Possible response: 0,0.3529814004.  

CALC:RIPP:DATA 0,2500000000, 3000000000,3

Define a second ripple limit range with disabled limit check (no limit check results are displayed in the diagram area).

CALC:RIPP:SEGM2:RES?

Query the result for the second range. Possible response: 0,1.149071925.  

 

CALCulate<Chn>:RIPPle:SEGMent<Seg>:STIMulus:STARt <start_value>

Changes the start stimulus value (i.e. the smallest stimulus value) of a ripple limit range. A range must be created first to enable this command (e.g CALCulate<Chn>:RIPPle:DATA).

To define several ripple limit ranges with a single command, use CALCulate<Chn>:RIPPle:DATA.

<Chn>

Channel number used to identify the active trace.

 

<Seg>

Ripple limit range number

 

<start_value>

Frequency, power or time value, to be defined in accordance with the domain setting (CALCulate<Chn>:RIPPle:CONTrol:DOMain).

Range [def. unit]

Almost no restriction for limit ranges; see Rules for Limit Line Definition.
[Hz for frequency sweeps, dBm for power sweeps, s for time sweeps]

*RST value

– (no ripple limit line defined after *RST)

 

SCPI, Command Types

Device-specific, with query.

 

Example:

*RST; :CALC:RIPP:DATA 1,1500000000, 2000000000,3

Define and enable a ripple limit range in the stimulus range between 1.5 GHz and 2 GHz, assigning a ripple limit of +3 dBm.

CALC:RIPP:SEGM:STIM:STAR 1GHZ; STOP 2.5 GHZ; :CALC:RIPP:SEGM:LIM 5

Change the range to a stimulus range between 1 GHz and 2.5 GHz and a limit of 5 dB.  

CALC:RIPP:SEGM:STAT OF

Disable the limit check in the modified stimulus range.

 

 

CALCulate<Chn>:RIPPle:SEGMent<Seg>[:STATe] <Boolean>

Enables or disables the limit check in the ripple limit range no. <Seg>.

<Chn>

Channel number used to identify the active trace.  

 

<Seg>

Segment number

<Boolean>

ON | OFF - Limit check on or off. A result is available even if the limit check is disabled; see example for CALCulate<Chn>:RIPPle:SEGMent<Seg>:RESult?.

*RST value

– (no ripple limit line defined after *RST)

 

SCPI, Command Types

Device-specific, command or query.  

 

Example:

See CALCulate<Chn>:RIPPle:SEGMent<Seg>:STIMulus:STARt.   

 

 

CALCulate<Chn>:RIPPle:SEGMent<Seg>:STIMulus:STOP <stop_value>

Changes the stop stimulus value (i.e. the largest stimulus value) of a ripple limit range. A range must be created first to enable this command (e.g CALCulate<Chn>:RIPPle:DATA).

To define several ripple limit ranges with a single command, use CALCulate<Chn>:RIPPle:DATA.

<Chn>

Channel number used to identify the active trace.

 

<Seg>

Segment number

 

<stop_value>

Frequency, power or time value, to be defined in accordance with the domain setting (CALCulate<Chn>:RIPPle:CONTrol:DOMain).

Range [def. unit]

Almost no restriction for limit ranges; see Rules for Limit Line Definition.
[Hz for frequency sweeps, dBm for power sweeps, s for time sweeps]

*RST value

– (no ripple limit line defined after *RST)

 

SCPI, Command Types

Device-specific, with query.

 

Example:

See CALCulate<Chn>:RIPPle:SEGMent<Seg>:STIMulus:STARt.   

 

 

CALCulate<Chn>:RIPPle:SOUNd[:STATe] <Boolean>

Switches the acoustic signal (fail beep) on or off. The fail beep is generated each time the analyzer detects an exceeded limit.

<Chn>

Channel number used to identify the active trace.  

 

<Boolean>

ON | OFF - Fail beep on or off.

*RST value

OFF

 

SCPI, Command Types

Device-specific, command or query.  

 

Example:

CALC:RIPP:STAT ON; SOUN ON

Switch the limit check on and activate the fail beep.  

 

 

CALCulate<Chn>:RIPPle:STATe <Boolean>

Switches the global ripple limit check on or off. This check covers all traces in the active setup.

Use CALCulate<Chn>:RIPPle:SEGMent<Seg>[:STATe] to switch the limit check for a single ripple limit range on or off.

<Chn>

Channel number used to identify the active trace.  

 

<Boolean>

ON | OFF - Limit check on or off.

*RST value

OFF

 

SCPI, Command Types

Device-specific, command or query.  

 

Example:

See CALCulate<Chn>:RIPPle:FAIL?