Measurement Values¶

:RATE {<num>[<unit>]|NONE}¶

Syntax

:RATE {<num>[<unit>]|NONE}

Description

Set numeric data aggregation time for output

Parameter

Name	Type	Range	Default
{<num>[<unit>] \| NONE}	Nrf,Literal	1–5000ms\| 0.001-5s \| NONE	None

Explanation

Set numeric data aggregation for output. If “NONE” specified, the aggregation time is off and the last hold value will be returned on :NUM:NORM:VAL?

The resolution is milliseconds.

Since revision 1.6: Data aggregation is implemented for scalar values only. More precisely, the last hold value will be returned for array channels.

Example

->  :RATE 500ms

:RATE?¶

Syntax	:RATE?
Description	Queries the numeric data aggregation time for output
Parameter
Explanation	The returned numeric is without unit according to the SCPI reference. But, the implicit unit is [s].
Return Format	<NRf>\|NONE
Example	-> :RATE 500ms -> :RATE? <- 5.0E-1

:NUMeric:NORMal:ITEMS <channel>[,<channel>[,…]]¶

Syntax

:NUMeric:NORMal:ITEMS <channel> [,<channel> [,…]]

Description

Set numeric data output items

Parameter

Name	Type	Range	Default
<channel>	ASCII String	Oxygen Channel Name	None
“ABS-TIME”	ASCII String	Include Absolute Time Channel “YYYY-MM-DDTHH:mm:ss.sss”
“REL-TIME”	ASCII String	Include Relative Time Channel <NRf> Seconds since Acquisition Start

Explanation

Set numeric data output items starting from index 1 on directly

Example

-> :NUMeric:NORMal:ITEMS "Channel-Name1","U1_tRMS@PowerGroup"

:NUMeric:NORMal:ITEMS?¶

Syntax	:NUMeric:NORMal:ITEMS?
Description	Query numeric data output items
Parameter	None
Explanation	Get the full list of channels in the numeric data output system
Return Format	String[,[String[,…]]]
Example	-> :NUMeric:NORMal:ITEMS "ABS-TIME","U1_tRMS@PowerGroup" -> :NUMeric:NORMal:ITEMS? -> "ABS-TIME","U1_tRMS@PowerGroup"

:NUMeric:NORMAL:ITEM<x> <channel>¶

Syntax

:NUMeric:NORMAL:ITEM<x> <channel>

Description

Set output item to specified channel name or system channel

Parameter

Name	Type	Range	Default
<channel>	String	Oxygen Channel Name or a system channel (“ABS-TIME”, “REL-TIME”)	None

Explanation

Example

-> :NUMeric:NORMAL:ITEM1 "U1_tRMS@PowerGroup"

:NUMeric:NORMal:ITEM<x>?¶

Syntax	:NUMeric:NORMal:ITEM<x>?
Description	Query channel name of output item
Parameter	None
Explanation
Return Format	String
Example	-> :NUMeric:NORMAL:ITEM1 "U1_tRMS@PowerGroup" -> :NUMeric:NORMAL:ITEM1? <- "U1_tRMS@PowerGroup"

:NUMeric:NORMal:CLEar {ALL|<NUM>[,<NUM>]}¶

Syntax

:NUMeric:NORMal:CLEar {ALL|<num>[,<num>]}

Description

Clear (Set to NONE) given items

Parameter

Name	Type	Range	Default
<num>	Integer	1 - 32768	None
ALL	Literal		None

Explanation

Clear (Set to NONE) given items. If “ALL” is specified the hole list is cleared

Example

-> :NUMeric:NORMal:ITEMS "ABS-TIME","U1_tRMS@PowerGroup" -
-> :NUMeric:NORMal:CLEar ALL
-> :NUMeric:NORMal:ITEMS?
<- 0

:NUMeric:NORMal:DELete <NUM>[,<NUM>]¶

Syntax

:NUMeric:NORMal:DELete {<num>[,<num>]}

Description

Delete Items, shift remaining to left

Parameter

Name	Type	Range	Default
<num>	Integer	1 - 32768	None

Explanation

Example

-> :NUMeric:NORMal:ITEMS "ABS-TIME","U1_tRMS@PowerGroup"
-> :NUMeric:NORMal:DELete 1
-> :NUMeric:NORMAL:ITEM1?
<- "U1_tRMS@PowerGroup"

:NUMeric:NORMal:NUMber {<num>|ALL}¶

Syntax

:NUMeric:NORMal:NUMber {<num>|ALL}}

Description

Sets the number of items to be transferred beginning from index 0

Parameter

Name	Type	Range	Default
<num>	Integer	1 - 32768	15
ALL	Literal		None

Explanation

Example

-> :NUMeric:NORMal:ITEMS "ABS-TIME","U1_tRMS@PowerGroup"
-> :NUMeric:NORMal:NUMber 2

:NUMeric:NORMal:NUMber?¶

Syntax	:NUMeric:NORMal:NUMber?
Description	Queries the number of items to be transferred
Parameter	None
Explanation	Queries the number of items to be transferred
Return Format	Nr1
Example	-> :NUMeric:NORMal:ITEMS "ABS-TIME","U1_tRMS@PowerGroup" -> :NUMeric:NORMal:NUMber 1 -> :NUMeric:NORMal:NUMber? <- 1

:NUMeric:NORMal:DIM<x> { <i_max> | <i_list> | MAX }¶

Syntax

:NUMeric:NORMal:DIM<x> { <i_max> | <i_list> | MAX }

Description

Selects indices of array channels to be included in output of :NUMeric:NORMal:VALue?

Parameter

Name	Type	Range	Default
<i_max>	Integer	1 - 32768	None
<i_list>	Numeric list		None
MAX	Literal		None

Explanation

By specifying the single value parameter <I_MAX>, you limit the number of elements of array channels to the first <I_MAX> values.

If you want to include a specific set of indices, you can provide an <I_LIST>.

In order to reset the selected indices to all available indices, use the parameter mnemonic MAX.

If <I_MAX> or entries from <I_LIST> lie outside the range supported by the array channel, only indices in the allowed range will be saved, and an error will be generated.

Any call to this command will clear the effect of a previously issued :NUM:NORM:DIM command for the selected item.

Note that the indexing of array channels starts at 1.

Example

-> :NUMeric:NORMal:ITEM1 "AI 1/1"
-> :NUMeric:NORMal:ITEM3 "U1_hRMS@PowerGroup"
-> :NUMeric:NORMal:DIM1?
<- 1
-> :NUMeric:NORMal:DIM2?
<- 1
-> :NUMeric:NORMal:DIM3?
<- 128
-> :NUMeric:NORMal:DIM3 10
-> :NUMeric:NORMal:DIM3?
<- 10
-> :NUMeric:NORMal:DIM3 MAX
-> :NUMeric:NORMal:DIM3?
<- 128
-> :NUMeric:NORMal:DIM3 (1:10,50,60:70)
-> :NUMeric:NORMal:DIM3?
<- (1:10,50,60:70)

:NUMeric:NORMal:DIM<x>?¶

Syntax	:NUMeric:NORMal:DIM<x>?
Description	Queries the dimension of the data to be transferred for one item
Parameter	None
Explanation	for each scalar channel, 1 will be returned; for each NONE item, 1 will be returned; for array channels, the output format will vary depending on how the item was set up with :NUM:DIM<X>: if no upper bound was set, the number of items of the array channel will be returned if an upper bound was set, that value will be returned if a range of indices was selected, that range will be returned
Return Format	<NR1>\|<NumericList>
Example	Cf. :NUMeric:NORMal:DIM<x> command.

:NUMeric:NORMal:DIMS?¶

Syntax	:NUMeric:NORMal:DIMS?
Description	Queries the dimension of the data to be transferred for each item
Parameter	None
Explanation	The list returned will contain one entry for each item in the format used for :NUM:NORM:DIM<x>?
Return Format	[<NR1>\|<NumericList>[,…]
Example	Cf. :NUMeric:NORMal:DIM<x> command.

:NUMeric:NORMal:FORMat {ASCII|BIN_INTEL|BIN_MOTOROLA}¶

Syntax

:NUMeric:NORMal:FORMat {ASCII|BIN_INTEL|BIN_MOTOROLA}

Description

Sets the requested output format

Parameter

Name	Type	Range	Default
Format	ASCII literal(s)	ASCII BIN_INTEL BIN_MOTOROLA	ASCII

Explanation

When format is set to ASCII, all numbers are returned in an ASCII format (NR3 for values, timestamps in NR2 format or as Strings)

When format is set to BIN_INTEL or BIN_MOTOROLA, all values are returned in a single array of IEEE 754 float32 values (in the corresponding byte order). See Arbitrary Block for more information. Values that are not convertible to float32 values are reported as NaN.

Example

-> :NUMeric:NORMal:FORMat BIN_INTEL

:NUMeric:NORMal:FORMat?¶

Syntax	:NUMeric:NORMal:FORMat?
Description	Queries the currently configured output format
Parameter	None
Explanation	Returns the currently configured output format
Return Format	{ASCII\|BIN_INTEL\|BIN_MOTOROLA}
Example	-> :NUMeric:NORMal:FORM ASCII -> :NUMeric:NORMal:FORM? <- ASCII

:NUMeric:NORMal:VALue? [<NUM>]¶

Syntax

:NUMeric:NORMal:VALue? [<num>]

Description

Query numeric values of the preset item list

Parameter

Name	Type	Range	Default
<num>	Integer	1…32768: Only return the value of the entry at index <num> in ITEMS.	Returns a flat list containing the values of all entries in ITEMS.

Explanation

If no index is specified, all values in the list will be returned in a comma separated list (for ASCII format) up to the number of items to be transferred.

Since 1.6: The list returned by this query will be flat, i.e. values for array channels will be included as a sequence of values. Use the :NUM:NORM:DIMS? query to retrieve the number of elements that can be expected for each item.

If an index is specified the value for the item at index is returned, regardless if the index is higher than the number of items to be transferred.

Since 1.20: When the format is BIN_INTEL or BIN_MOTOROLA, instead of comma separated ASCII characters, on block of binary <Arbitrary Block> is returned. The data layout is the same as for ASCII.

Return Format

{ASCII|BIN_INTEL|BIN_MOTOROLA}

Example

-> :NUMeric:NORMal:ITEMS "REL-TIME","U1_tRMS@PowerGroup"
-> :NUMeric:NORMal:VALue?
<- 15.2,2.4553
-> :NUMeric:NORMal:VALue? 2
<- 2.4553
-> :NUMeric:NORMal:ITEM3 "U1_fRMS@PowerGroup"
-> :NUMeric:NORMal:VALue? 3
<- 2.3451,-1.2425,...,4.0124