5.14. SENSe

The SENSe control the current measurement range, energy counting/window, the data acquisition sequence and DLOG viewer parameters.

 

SCPI command

Description

SENSe

 

:CURRent

 

[:DC]

 

RANGe[:UPPer] {<range>}

Selects a DC current measurement range

:DLOG

 

:FUNCtion

 

:CURRent {<bool>}, {<channel>}

Enables/disables output current internal data logging

:POWer {<bool>}, {<channel>}

Enables/disables output power internal data logging

:VOLTage {<bool>}, {<channel>}

Enables/disables output voltage internal data logging

:PERiod {<time>}

Sets the sample period for internal data logging

:TIME {<time>}

Sets the sample duration for internal data logging

:TRACe

 

[:DATA] {<value>}[, ...]

Adds new data into log file

:REMark {<user remark>}

Adds user description to the log file

:X

 

:LABel {<label>}

Sets X-axis label

[:RANGe]:MIN {<min>}

Sets X-axis min. value

[:RANGe]:MAX {<max>}

Sets X-axis max. value

SCALe

 

:STEP {<step>}

Sets X-axis step value

:UNIT {<unit>}

Sets X-axis units

:Y<n>

 

:LABel {<label>}

Sets Y-axis<n> label

[:RANGe]:MIN {<min>}

Sets Y-axis<n> min. value

[:RANGe]:MAX {<max>}

Sets Y-axis<n> max. value

:SCALe

 

:UNIT {<unit>}

Sets Y-axis<n> units

5.14.1. SENSe:CURRent[:DC]:RANGe[:UPPer]

Syntax

SENSe:CURRent[:DC]:RANGe[:UPPer] {<range>}

SENSe:CURRent[:DC]:RANGe[:UPPer]?

Modules

 DCP 

Description

This command selects a DC current measurement range when Power board with multiple current ranges is installed (e.g. DCP405 that can be find out with the SYSTem:CHANnel:MODel? command). The entered value must be higher than the maximum current that you expect to measure. Units are in amperes.

Parameters

Name

Type

Range

Default

<range>

NR2|Discrete

0.5, 5, LOW|HIGH|BEST

BEST

Usage example

SENS:CURR:RANG?

0.05

Errors

-241,"Hardware missing"

Related Commands

SYSTem:CHANnel:MODel?

5.14.2. SENSe:DLOG:FUNCtion:CURRent

Syntax

SENSe:DLOG:FUNCtion:CURRent {<bool>}, {<channel>}

SENSe:DLOG:FUNCtion:CURRent? {<channel>}

Description

Use this command to enable or disable output current internal data logging on the specified channel.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

OFF

<channel>

Discrete

CH1|CH2|CH3|CH4|CH5|CH6

Return

The query command returns the status (0 or 1) of the output current internal data logging enabled on the specified channel

Usage example

SENS:DLOG:FUNC:CURR ON, CH1

Related Commands

INIT:DLOG

SENSe:DLOG:FUNCtion:POWer

SENSe:DLOG:FUNCtion:VOLTage

SENSe:DLOG:PERiod

SENSe:DLOG:TIME

5.14.3. SENSe:DLOG:FUNCtion:POWer

Syntax

SENSe:DLOG:FUNCtion:POWer {<bool>}, {<channel>}

SENSe:DLOG:FUNCtion:POWer? {<channel>}

Description

Use this command to enable or disable output power internal data logging on the specified channel.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

OFF

<channel>

Discrete

CH1|CH2|CH3|CH4|CH5|CH6

Return

The query command returns the status (0 or 1) of the output power internal data logging enabled on the specified channel

Usage example

SENS:DLOG:FUNC:VOLT OFF, CH2

Related Commands

INIT:DLOG

SENSe:DLOG:FUNCtion:CURRent

SENSe:DLOG:FUNCtion:VOLTage

SENSe:DLOG:PERiod

SENSe:DLOG:TIME

5.14.4. SENSe:DLOG:FUNCtion:VOLTage

Syntax

SENSe:DLOG:FUNCtion:VOLTage {<bool>}, {<channel>}

SENSe:DLOG:FUNCtion:VOLTage? {<channel>}

Description

Use this command to enable or disable output voltage internal data logging on the specified channel.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

OFF

<channel>

Discrete

CH1|CH2|CH3|CH4|CH5|CH6

Return

The query command returns the status (0 or 1) of the output voltage internal data logging enabled on the specified channel

Usage example

SENS:DLOG:FUNC:VOLT OFF, CH2

Related Commands

INIT:DLOG

SENSe:DLOG:FUNCtion:CURRent

SENSe:DLOG:FUNCtion:POWer

SENSe:DLOG:PERiod

SENSe:DLOG:TIME

5.14.5. SENSe:DLOG:PERiod

Syntax

SENSe:DLOG:PERiod {<time>}

SENSe:DLOG:PERiod?

Description

Use this command to set the data logging sample period in seconds.

Parameters

Name

Type

Range

Default

<time>

NR2

0.005 – 120

0.02

Return

The query command returns the sample period in seconds.

Usage example

SENS:DLOG:PER 1

Related Commands

INITiate:DLOG

SENSe:DLOG:TIME

5.14.6. SENSe:DLOG:TIME

Syntax

SENSe:DLOG:TIME {<time>}

SENSe:DLOG:TIME?

Description

This command sets the data logging sample duration, the entered value is in seconds. For sample duration, the maximum is 86 400 000 seconds or 24 000 hours or 1000 days (depending of the available space on the installed SD Card, see the MMEMory:INFOrmation? command).

Parameters

Name

Type

Range

Default

<time>

NR1

1 – 86400000

60

Return

The query command returns the sample duration in seconds.

Usage example

SENS:DLOG:TIME 3600

Related Commands

INITiate:DLOG

MMEMory:INFOrmation?

SENSe:DLOG:PERiod

5.14.7. SENSe:DLOG:TRACe[:DATA]

Syntax

SENSe:DLOG:TRACe[:DATA] {<value>}[, ...]

Description

When the X-axis and all Y-axes is defined, and when the DLOG file name is specified, it remains to add points (data) into DLOG. Use this command to do this as many times as needed. The first time this command is called, the Y-axis values are set for the first point (as many <value> parameters as the Y-axis should be set), the second time for the second point, etc.

When the values of all points are defined, execute the ABORt:DLOG command and the creation of the DLOG file is complete.

Parameters

Name

Type

Range

Default

<value>

NR2

Y:RANGe:MINimum to Y:RANGe:MAXimum

Usage example

SENS:DLOG:TRAC 10.2, 33.34, 0.022

Related Commands

ABORt:DLOG

5.14.8. SENSe:DLOG:TRACe:X:LABel

Syntax

SENSe:DLOG:TRACe:X:LABel {<label>}

SENSe:DLOG:TRACe:X:LABel?

Description

Use this command to set DLOG X-axis label name.

Parameters

Name

Type

Range

Default

<label>

Quoted string

0 to 32 characters

Return

The query returns X-axis label name as quoted string.

Usage example

SENS:DLOG:TRAC:X:LAB "Imon"

Related Commands

SENSe:DLOG:TRACe:X:STEP

SENSe:DLOG:TRACe:X:UNIT

5.14.9. SENSe:DLOG:TRACe:REMark

Syntax

SENSe:DLOG:TRACe:REMark {<user remark>}

SENSe:DLOG:TRACe:REMark?

Description

Use this command to add description to the log file.

Parameters

Name

Type

Range

Default

<user remark>

Quoted string

0 to 128 characters

Return

The query command returns log file description as a quoted string.

Usage example

SENS:DLOG:TRAC:REM "Test data log"

Related Commands

INITiate:DLOG

INITiate:DLOG:TRACe

SENSe:DLOG:TRACe[:DATA]

5.14.10. SENSe:DLOG:TRACe:X:UNIT

Syntax

SENSe:DLOG:TRACe:X:UNIT {<unit>}

SENSe:DLOG:TRACe:X:UNIT?

Description

This command specifies DLOG X-axis unit, typically this is the time, or SECond.

Parameters

Name

Type

Range

Default

<unit>

Discrete

VOLT|AMPEr|WATT|JOULe|SECOnd|OHM|FARAd|HERTz

Return

The query command returns log file X-axis units name as quoted string.

Usage example

SENS:DLOG:TRAC:X:UNIT VOLT

Related Commands

SENSe:DLOG:TRACe:X:STEP

SENSe:DLOG:TRACe:X:LABel

5.14.11. SENSe:DLOG:TRACe:X:STEP

Syntax

SENSe:DLOG:TRACe:X:STEP {<step>}

SENSe:DLOG:TRACe:X:STEP?

Description

Use this command to set step or ∆x, i.e. the distance between two points on the X-axis of the DLOG.

Parameters

Name

Type

Range

Default

<step>

NR2

Greater then zero

Return

The query command returns X-axis step value.

Usage example

SENS:DLOG:TRAC:X:STEP 0.1

Related Commands

SENSe:DLOG:TRACe:X:LABel

SENSe:DLOG:TRACe:X:UNIT

5.14.12. SENSe:DLOG:TRACe:X[:RANGe]:MIN

Syntax

SENSe:DLOG:TRACe:X[:RANGe]:MIN {<min>}

SENSe:DLOG:TRACe:X[:RANGe]:MIN?

Description

Use this command to set the first point of the DLOG X-axis. The next point has the value MIN + STEP, then MIN + 2 * STEP, etc.

Parameters

Name

Type

Range

Default

<min>

NR2

Return

The query command returns set X-axis minimal value.

Usage example

SENS:DLOG:TRAC:X:MIN 0

Related Commands

SENSe:DLOG:TRACe:X:UNIT

5.14.13. SENSe:DLOG:TRACe:X[:RANGe]:MAX

Syntax

SENSe:DLOG:TRACe:X[:RANGe]:MAX {<max>}

SENSe:DLOG:TRACe:X[:RANGe]:MAX?

Description

Optional command to set the value of the last point on the DLOG X-axis.

Parameters

Name

Type

Range

Default

<max>

NR2

Return

The query command returns set X-axis maximum value.

Usage example

SENS:DLOG:TRAC:X:MAX 20

Related Commands

SENSe:DLOG:TRACe:X:UNIT

5.14.14. SENSe:DLOG:TRACe:X:SCALe

Syntax

SENSe:DLOG:TRACe:X:SCALe {<scale>}

SENSe:DLOG:TRACe:X:SCALe?

Description

Use this command to set the X-axis scale.

 

Currently, only linear (LINear) scale is supported.

 

Parameters

Name

Type

Range

Default

<scale>

Discrete

LINear|LOGarithmic

Return

The query command returns X-axis scale type.

Usage example

SENS:DLOG:TRAC:X:SCAL LIN

Related Commands

SENSe:DLOG:TRACe:Y:SCALe

5.14.15. SENSe:DLOG:TRACe:Y<n>:LABel

Syntax

SENSe:DLOG:TRACe:Y<n>:LABel {<label>}

SENSe:DLOG:TRACe:Y<n>:LABel?

Description

Use this command to set DLOG Y-axis label name. DLOG file could contains up to 18 Y-axis defined by <n>.

Parameters

Name

Type

Range

Default

<label>

Quoted string

0 to 32 characters

Return

The query returns label name as quoted string of the selected Y-axis.

Usage example

SENS:DLOG:TRAC:Y1:LAB "Umon"

Related Commands

SENSe:DLOG:TRACe:Y<n>:UNIT

5.14.16. SENSe:DLOG:TRACe:Y<n>[:RANGe]:MIN

Syntax

SENSe:DLOG:TRACe:Y<n>[:RANGe]:MIN {<min>}

SENSe:DLOG:TRACe:Y<n>[:RANGe]:MIN?

Description

Use this command to set the first point of the <n> Y-axis. The next point has the value MIN + STEP, then MIN + 2 * STEP, etc.

Parameters

Name

Type

Range

Default

<min>

NR2

Return

The query command returns set <n> Y-axis minimal value.

Usage example

SENS:DLOG:TRAC:Y1:MIN 1

Related Commands

SENSe:DLOG:TRACe:Y<n>[:RANGe]:MAX

SENSe:DLOG:TRACe:Y<n>:UNIT

5.14.17. SENSe:DLOG:TRACe:Y<n>[:RANGe]:MAX

Syntax

SENSe:DLOG:TRACe:Y<n>[:RANGe]:MAX {<max>}

SENSe:DLOG:TRACe:Y<n>[:RANGe]:MAX?

Description

Optional command to set the value of the last point on the <n> Y-axis.

Parameters

Name

Type

Range

Default

<max>

NR2

Return

The query command returns set <n> Y-axis maximum value.

Usage example

SENS:DLOG:TRAC:Y1:MAX 50

Related Commands

SENSe:DLOG:TRACe:Y<n>[:RANGe]:MIN

SENSe:DLOG:TRACe:Y<n>:UNIT

5.14.18. SENSe:DLOG:TRACe:Y:SCALe

Syntax

SENSe:DLOG:TRACe:Y:SCALe {<scale>}

SENSe:DLOG:TRACe:Y:SCALe?

Description

Use this command to set the Y-axis scale.

Parameters

Name

Type

Range

Default

<scale>

Discrete

LINear|LOGarithmic

Return

The query command returns Y-axis scale type.

Usage example

SENS:DLOG:TRAC:Y:SCAL LIN

Related Commands

SENSe:DLOG:TRACe:X:SCALe

5.14.19. SENSe:DLOG:TRACe:Y<n>:UNIT

Syntax

SENSe:DLOG:TRACe:Y<n>:UNIT {<unit>}

SENSe:DLOG:TRACe:Y<n>:UNIT?

Description

This command specifies DLOG <n> Y-axis unit.

Parameters

Name

Type

Range

Default

<unit>

Discrete

VOLT|AMPEr|WATT|JOULe|SECOnd|OHM|FARAd|HERTz

Return

The query command returns <n> Y-axis units name as quoted string.

Usage example

SENS:DLOG:TRAC:Y1:UNIT "AMPE"

Related Commands

SENSe:DLOG:TRACe:Y<n>:LABel

SENSe:DLOG:TRACe:Y<n>:UNIT