Keysight 34970A, 34972A Reference Manual

 

Keysight
34970A/34972A

CommandReference

Notice:ThisdocumentcontainsreferencestoAgilentTechnologies.
Agilent'sformerTestandMeasurementbusinesshasbecomeKeysight
Technologies.Formoreinformation,gotowww.keysight.com.

ThisHelpfilecontainsreferenceinformationtohelpyouprogramthe
Keysight34970A/34972Aoveraremoteinterfaceusingtheprogramming
language.

IntroductiontotheCommandLanguage

CommandsbySubsystem

CommandsA-Z

CommandQuickReference

ErrorMessages

FactoryResetState

InstrumentPresetState

Plug-InModuleReferenceInformation

RelatedInformation

Forfurtherinformation,clickonthelinkofinterest:

LibrariesandInstrumentDrivers
Keysight34970A/34972ADocumentation
Keysight34972AWebInterface
ProgrammingExamples
ContactKeysightTechnologies
Trademarks









©KeysightTechnologies,Inc.
2009-2014

Version2.00



CommandsbySubsystem

ABORt

FETCh?

INITiate

INPut:IMPedance:AUTO

READ?

R?

UNIT:TEMPerature



CALCulateSubsystem

CALibrationSubsystem

CONFigureSubsystem

DATASubsystem

DIAGnosticSubsystem

DISPlaySubsystem

FORMatSubsystemIntroduction

IEEE-488.2CommonCommands

INSTrumentSubsystemIntroduction

MEASureSubsystem

MEMorySubsystem

MMEMorySubsystem

OUTPutSubsystem

ROUTeSubsystem

SENSeSubsystem

SOURceSubsystem

STATusSubsystem

SYSTemSubsystem

TRIGgerSubsystem

ABORt

Syntax|Description|Parameters|Remarks|ReturnFormat|Example

Syntax

ABORt

Description

Thiscommandabortsameasurementinprogressfromascan.

Remarks

Ifascanisinprogresswhenthecommandisreceived,thescan
willnotbecompletedandyoucannotresumethescanfromwhere
itleftoff.Notethatifyouinitiateanewscan,allreadingsare
clearedfrommemory.

The*RSTcommandwillabortameasurement,clearthescanlist,
andsetallmeasurementparameterstotheirfactorysettings.The
InstrumentPreset(SYSTem:PRESetcommand)alsoabortsa
measurementbutitdoesnotclearthescanlist.

Example

Thefollowingcommandabortsthemeasurementinprogress.

ABOR

SeeAlso

*RST

SYSTem:PRESet



FETCh?

Syntax|Description|Parameters|Remarks|ReturnFormat|Example

Syntax

FETCh?

Description

Thiscommandtransfersreadingsstoredinnon-volatilememorytothe
instrument'soutputbuffer,whereyoucanreadthemintoyourcomputer.
Thereadingsstoredinmemoryarenoterasedwhenyoureadthemwith
FETCh?.Theformatofthereadingscanbechangedusing

FORMat:READingcommands.

Remarks

TheFETCh?commandwillwaituntilthemeasurementis
completetoterminate.

Readingscanbeacquiredduringascanusingthemultiplexerand
digitalmodules.

Youcanstoreatleast50,000readingsinmemoryandallreadings
areautomaticallytimestamped.Ifmemoryoverflows,thenew
readingswilloverwritethefirst(oldest)readingsstored;themost
recentreadingsarealwayspreserved.

Eachtimeyoustartanewscan,theinstrumentclearsallreadings
(includingalarmdata)storedinreadingmemoryfromtheprevious
measurement.Therefore,thecontentsofmemoryarealwaysfrom
themostrecentmeasurement.

Whenyouabortameasurement(seeABORtcommand),the
instrumentwillterminateanyreadinginprogress(readingsarenot
clearedfrommemory).Thereadingsremaininmemoryandcan
bereaduntilyouclearthemorinitiateanewscan.

Theoutputfromthiscommandisaffectedbythesettingsofthe

FORMat:READingcommands.Dependingontheformats

selected,eachreadingmayormaynotbestoredwith
measurementunits,timestamp,channelnumber,andalarm
statusinformation.

The*RSTcommandwillclearthescanlistandsetall
measurementparameterstotheirfactorysettings.TheInstrument
Preset(SYSTem:PRESetcommand)willnotclearthescanlist;
however,thiscommandwillclearreadingmemoryandallstored
statisticaldata.

Theinstrumentclearsallreadingsfrommemorywhenanewscan
isinitiated,whenanymeasurementparametersarechanged

(CONFigureandSENSecommands),andwhenthetriggering
configurationischanged(TRIGgercommands).

TheinstrumentclearsallreadingsfrommemoryafteraFactory
Reset(*RSTcommand)orafteranInstrumentPreset
(SYSTem:PRESetcommand).

ReturnFormat

Thecommandtransfersallreadingsfrommemory(withformattingasset
bytheFORMat:READingcommands)butdoesnoterasethem.Multiple
responsesareseparatedbycommas.

Example

ThefollowingprogramsegmentshowshowtousetheFETCh?
commandwiththeCONFigureandINITiatecommands.The

ROUTe:SCANcommandputsthetwochannelsintothescanlist(and

redefinesthescanlist).TheINITiatecommandplacestheinstrumentin
the"wait-for-trigger"state,scansthespecifiedchannelswhentherear­panelExtTrigInputlineispulsedlow,andthensendsthereadingsto
memory.TheFETCh?commandtransfersthereadingsfrommemoryto
theinstrument'soutputbuffer.

CONF:VOLT:DC10,0.003,(@103,108)
ROUT:SCAN(@103,108)
TRIG:SOUREXT
INIT

FETC?

TypicalResponse:+4.27150000E-03,+1.32130000E-03

SeeAlso

INITiate

ROUTe:SCAN



INITiate

Syntax|Description|Parameters|Remarks|ReturnFormat|Example

Syntax

INITiate

Description

Thiscommandchangesthestateofthetriggeringsystemfromthe"idle"
statetothe"wait-for-trigger"state.Scanningwillbeginwhenthe
specifiedtriggerconditionsaresatisfiedfollowingthereceiptofthe
INITiatecommand.Readingsarestoredintheinstrument'sinternal
readingmemory.NotethattheINITiatecommandalsoclearsthe
previoussetofreadingsfrommemory.

Ifascanlistiscurrentlydefined(seeROUTe:SCANcommand),the
INITiatecommandperformsascanofthespecifiedchannels.

Ifascanlistisnotcurrentlydefined,theINITiatecommandfails.

Remarks

StoringreadingsinmemoryusingtheINITiatecommandis
generallyfasterthansendingreadingstomemoryusingthe

READ?command.TheINITiatecommandisalsoan"overlapped"

command.ThismeansthatafterexecutingtheINITiatecommand,
youcansendothercommandsthatdonotaffectthe
measurements.

Youcanstoreupto50,000readingsinmemoryandallreadings
areautomaticallytimestamped.Ifmemoryoverflows,thenew
readingswilloverwritethefirst(oldest)readingsstored;themost
recentreadingsarealwayspreserved.Inaddition,bit9issetin
theQuestionableDataRegister'sconditionregister(seeStatus

SystemIntroduction).

Forscanningmeasurementsusingthemultiplexermodules,an
errorisgeneratediftheinternalDMMisdisabled(see

INSTrument:DMMcommand)ornotinstalledinthemainframe.

TheinternalDMMisnotrequiredforoperationsonthedigital
modules.

Ifascanlistcontainingmultiplexerchannelsiscurrentlydefined
(seeROUTe:SCANcommand),theINITiatecommandperformsa
scanofthespecifiedchannels.Whenthescanisinitiated,the
instrumentwillopenallchannelsinbanksthatcontainoneormore
channelsinthescanlist.

Theinstrumentscansthelistofchannelsinascendingorderfrom
slot100throughslot300(channelsarere-orderedas
needed).Whenyouspecifyarangeofchannelsinthe<scan_list>,
thechannelsarealwayssortedinascendingorder.Therefore,
(@109:101)willalwaysbeinterpretedas101,102,103,etc.

Onceyouinitiateascan,anerrorwillbegeneratedifyouattempt
tochangeanymeasurementparameters(CONFigureandSENSe

commands)orthetriggeringconfiguration(TRIGgercommands).
Toabortascaninprogress,sendtheABORtcommand.

Toretrievethereadingsfrommemory,usetheFETCh?command.
Thereadingsarenoterasedfrommemorywhenyoureadthem.
Youcansendthecommandmultipletimestoretrievethesame
datainreadingmemory.

Example

ThefollowingprogramsegmentshowshowtousetheINITiatecommand
withtheCONFigureandFETCh?commands.TheROUTe:SCAN
commandputsthetwochannelsintothescanlist(andredefinesthe
scanlist).TheINITiatecommandplacestheinstrumentinthe"wait-for­trigger"state,scansthespecifiedchannelswhentherear-panelExtTrig

Inputlineispulsedlow,andthensendsthereadingstomemory.The

FETCh?commandtransfersthereadingsfrommemorytothe

instrument'soutputbuffer.

CONF:VOLT:DC10,0.003,(@103,108)
ROUT:SCAN(@103,108)
TRIG:SOUREXT

INIT

FETC?

TypicalResponse:+4.27150000E-03,+1.32130000E-03

SeeAlso

FETCh?

READ?

ROUTe:SCAN

INPut:IMPedance:AUTO

Syntax|Description|Parameters|Remarks|ReturnFormat|Examples

Syntax

INPut:IMPedance:AUTO<state>[,(@<ch_list>)]

INPut:IMPedance:AUTO?[(@<ch_list>)]

Description

Thiscommandenablesordisablestheautomaticinputresistancemode
forDCvoltagemeasurementsonthespecifiedchannels.

Parameters

Name Type RangeofValues Default

Value

<state> Boolean {OFF|0|ON|1} Thisisa

required
parameter.

<ch_list> Channel

List

Oneormorechannels,
asshown:

(@310)-channel10on
themoduleinslot300.

(@305:310)-channels
05through10onthe
moduleinslot300.

(@202:207,209,302:308)

-channels02through07
and09onthemodulein
slot200andchannels02
through08onthe
moduleinslot300.

Ifyou
omitthe
optional
<ch_list>
parameter,
this
command
appliesto
the
currently
defined
scanlist.

Remarks

WithAUTOOFF(default),theinputresistanceisfixedat10MΩ
forallranges.

WithAUTOON,theinputresistanceissetto>10GΩforthe100
mV,1V,and10Vranges.

ReturnFormat

Thequeryreturnstheinputresistancesettingas0(OFF)or1(ON)on
thespecifiedchannels.

Examples

Thefollowingcommandsetstheimpedanceto>10GΩfortwochannels.

INP:IMP:AUTOON(@105,109)



Thefollowingqueriesfortheimpedanceontwochannels.

INP:IMP:AUTO?(@105,109)

TypicalResponse:1,1

SeeAlso

CONFigure:VOLTage:DC

MEASure:VOLTage:DC?

R?

Syntax|Description|Parameters|Remarks|ReturnFormat|Example

Syntax

R?[<max_count>]

Description

Thisqueryreadsanderasesreadingsfromvolatilememoryuptothe
specified<max_count>.Thereadingsareerasedfrommemorystarting
withtheoldestreadingfirst.Thepurposeofthiscommandistoallowyou
toperiodicallyremovereadingsfrommemorythatwouldnormallycause
readingmemorytooverflow(forexample,duringascanwithaninfinite
scancount).

Parameters

Name Type Rangeof

Values

Default

Value

<max_count> Numeric Maximum

numberof
readings
toberead
anderased
from
memory,
from1to
50,000.

Eraseall
stored
readings,up
to50,000

Remarks

ThiscommandisaspecialversionoftheDATA:REMove?
commandwithfasterexecutiontime.Youcanreadmemoryatany
timeusingtheR?command,evenduringascan.

Readingscanbeacquiredduringascanusingthemultiplexerand
digitalmodules.Forscanningmeasurementsusingthemultiplexer
modules,anerrorisgeneratediftheinternalDMMisdisabled(see

INSTrument:DMMcommand)ornotinstalledinthemainframe.

TheinternalDMMisnotrequiredforoperationsonthedigital
modules.

Youcanstoreupto50,000readingsinmemoryandallreadings
areautomaticallytimestamped.Ifmemoryoverflows,thenew
readingswilloverwritethefirst(oldest)readingsstored;themost
recentreadingsarealwayspreserved.Inaddition,bit9issetin
theQuestionableDataRegister'sconditionregister(seeStatus

SystemIntroduction).

Eachreadingisreturnedwithsomecombinationofmeasurement
units,timestamp,channelnumber,andalarmstatusinformation,
dependingonthesettingssetbytheFORMat:READing
commands.Thetimestampiseitherinrelativeformat(timein
secondssincethebeginningofthescan)orabsoluteformat(time
ofdaywithdate,basedontheinstrument'sclockassetbythe

SYSTem:DATEandSYSTem:TIMEcommands).Thechoiceof

absoluteandrelativetimeisdeterminedbythe

FORMat:READing:TIME:TYPEcommand.

Theinstrumentclearsallreadingsfrommemorywhenanewscan
isinitiated,whenanymeasurementparametersarechanged
(CONFigureandSENSecommands),andwhenthetriggering
configurationischanged(TRIGgercommands).

TheinstrumentclearsallreadingsfrommemoryafteraFactory

Reset(*RSTcommand)orafteranInstrumentPreset
(SYSTem:PRESetcommand).

ReturnFormat

ThequeryreturnsaseriesofreadingsinDefinite-LengthBlockformat.
Thesyntaxisapoundsign(#)followedbyanon-zerodigitrepresenting
thenumberofdigitsinthedecimalintegertofollow.Thisdigitisfollowed
byadecimalintegerindicatingthenumberof8-bitdatabytestofollow.
Thisisfollowedbyablockofdatacontainingthespecifiednumberof
bytes.

Forexample:

Example

Thisqueryreadsthetwooldestreadingsanderasesthemfrommemory.

R?2

TypicalResponse:#231+2.87536000E-04,+3.18131400E-03

SeeAlso

DATA:REMove?

READ?

Syntax|Description|Parameters|Remarks|ReturnFormat|Examples

Syntax

34970ASyntax:READ?

34972ASyntax:READ?[(@<scan_list>)]

Description

Thiscommandchangestheinstrument'striggeringsystemfromthe"idle"
statetothe"wait-for-trigger"state.Scanningwillbeginwhenthe
specifiedtriggerconditionsaresatisfiedfollowingthereceiptofthe
READ?command.Readingsarethensentimmediatelytoreading
memoryandtheinstrument'soutputbuffer.Onthe34970A,youmust
thenreceivethereadingsintoyourcomputerortheinstrumentwillstop
scanningwhentheoutputbufferbecomesfull.Readingsarenotstored
intheinstrument’sinternalmemorywhenusingREAD?.Onthe34972A,
thereadingsarealwayssenttomemoryandtheywillstillbeavailable
afterREAD?finishes.

UsedWith:

34901A20ChannelMultiplexer(2/4-wire)Module

34902A16ChannelMultiplexer(2/4-wire)Module

34907AMultifunctionModule(digitalinputandtotalizer)

34908A40ChannelSingle-EndedMultiplexerModule

Parameters

Name Type RangeofValues Default

Value

<scan_list> Scan

List

Oneormorechannels,
asshown:

(@310)-channel10on
themoduleinslot300.

(@305:310)-channels
05through10onthe
moduleinslot300.

(@202:207,209,302:308)

-channels02through07
and09onthemodulein
slot200andchannels02
through08onthe
moduleinslot300.

Thisisa
required
parameter.

Remarks

SendingtheREAD?commandissimilartosendingtheINITiate
commandfollowedimmediatelybytheFETCh?command.

Youcanstoreupto50,000readingsinmemoryandallreadings
areautomaticallytimestamped.Ifmemoryoverflows,thenew
readingswilloverwritethefirst(oldest)readingsstored;themost
recentreadingsarealwayspreserved.Inaddition,bit9issetin
theQuestionableDataRegister'sconditionregister(seeStatus

SystemIntroduction).

Forscanningmeasurementsusingthemultiplexermodules,an
errorisgeneratediftheinternalDMMisdisabled(see

INSTrument:DMMcommand)ornotinstalledinthemainframe.

TheinternalDMMisnotrequiredforoperationsonthedigital
modules.

Theinstrumentscansthelistofchannelsinascendingorderfrom
slot100throughslot300(channelsarere-orderedas
needed).Whenyouspecifyarangeofchannelsinthe<scan_list>,
thechannelsarealwayssortedinascendingorder.Therefore,
(@109:101)willalwaysbeinterpretedas101,102,103,etc.

Onceyouinitiateascan,anerrorwillbegeneratedifyouattempt
tochangeanymeasurementparameters(CONFigureandSENSe
commands)orthetriggeringconfiguration(TRIGgercommands).
Toabortascaninprogress,sendtheABORtcommand.

Eachreadingisreturnedwithsomecombinationofmeasurement
units,timestamp,channelnumber,andalarmstatusinformation,
dependingonthesettingssetbytheFORMat:READing
commands.Thetimestampiseitherinrelativeformat(timein
secondssincethebeginningofthescan)orabsoluteformat(time
ofdaywithdate,basedontheinstrument'sclockassetbythe

SYSTem:DATEandSYSTem:TIMEcommands).Thechoiceof

absoluteandrelativetimeisdeterminedbythe

FORMat:READing:TIME:TYPEcommand.

TheREAD?queryisnotvalidwiththe*TRGcommand(usedwith

TRIGger:SOURceBUScommandforsoftwaretriggering).

TheinstrumentclearsallreadingsfrommemoryafteraFactory
Reset(*RSTcommand)orafteranInstrumentPreset
(SYSTem:PRESetcommand).

Ifyouspecifya<scan_list>withthisquery(34972Aonly),itwill
overwritethecurrentscanlist.

ReturnFormat

Thecommandsendsreadingsdirectlytoreadingmemoryandthe
instrument'soutputbuffer(withformattingassetbythe

FORMat:READingcommands).Multipleresponsesareseparatedby

commas.

Examples

ThefollowingprogramsegmentshowshowtousetheREAD?command
withtheCONFigurecommand.TheROUTe:SCANcommandputsthe
twochannelsintothescanlist(andredefinesthescanlist).TheREAD?
commandplacestheinstrumentinthe"wait-for-trigger"state,scansthe
specifiedchannelswhentherear-panelExtTrigInputlineispulsedlow,
sendsthereadingstoreadingmemoryandtheinstrument'soutput
buffer.

CONF:VOLT:DC10,0.003,(@103,108)!Configure
channels
ROUT:SCAN(@103,108)!Definethescanlist
TRIG:SOUREXT
READ?!Appliestothepresentscanlist

TypicalResponse:+4.27150000E-03,+1.32130000E-03

SeeAlso

FETCh?

INITiate

ROUTe:SCAN



UNIT:TEMPerature

Syntax|Description|Parameters|Remarks|ReturnFormat|Examples

Syntax

UNIT:TEMPerature<units>[,(@<ch_list>)]

UNIT:TEMPerature?[(@<ch_list>)]

Description

Thiscommandselectsthetemperatureunits(°C,°F,orKelvin)onthe
specifiedchannels.Ifyouomittheoptional<ch_list>parameter,this
commandappliestothecurrentlydefinedscanlist.

Thefollowingtableshowswhichtemperaturetransducersaresupported
byeachofthemultiplexermodules.

Module Thermocouple RTD

2-

Wire

RTD

4-

Wire

Thermistor

34901A
Armature
Multiplexer

Yes Yes Yes Yes

34902A
Reed
Multiplexer

Yes Yes Yes Yes

34908A
Armature
Multiplexer
(1-Wire)

Not

Recommended

1

Yes No Yes

1

Withaone-wiremultiplexer,evenverysmallgroundcurrentscan

introducesubstantialmeasurementerror.

Parameters

Name Type RangeofValues Default

Value

<units> Discrete {C|F|K},forCelsius,

FahrenheitorKelvin

Thisisa
required
parameter.

The
factory
defaultis
C.

<ch_list> Channel

List

Oneormorechannels,
asshown:

(@310)-channel10on
themoduleinslot300.

(@305:310)-channels
05through10onthe
moduleinslot300.

(@202:207,209,302:308)

-channels02through07
and09onthemodulein
slot200andchannels02
through08onthe
moduleinslot300.

Ifyou
omitthe
optional
<ch_list>
parameter,
this
command
appliesto
the
currently
defined
scanlist.

Remarks

Youcanmixtemperatureunitsondifferentchannelswithinthe
instrumentandonthesamemodule.

Ifthecorrespondingchannelsarenotconfiguredfortemperature
measurementspriortothesendingoftheUNIT:TEMPerature
command,theinstrumentwilldispatchanerrormessage.

SettingtheMx+B(seeCALCulate:SCALe:UNITcommand)
measurementlabelto°C,°F,orKhasnoeffectonthe
temperaturemeasurementunitscurrentlyselected.

TheCONFigureandMEASure?commandsautomaticallyselect
°C.

Theinstrumentsetsthetemperatureunitsto°CafteraFactory
Reset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESet
command)orCardReset(SYSTem:CPONcommand)doesnot
changethesetting.

ReturnFormat

ThequeryreturnsC,F,orKforeachchannelspecified.Multiple
responsesareseparatedbycommas.

Examples

Thefollowingcommandsetsthetemperatureunitsto°Fonchannels12
and13inslot300.

CONF:TEMPTC,B,(@312,313)

UNIT:TEMPF,(@312,313)



Thefollowingqueryreturnsthetemperatureunitsselectedonchannels
12and13inslot300.

UNIT:TEMP?(@312,313)

TypicalResponse:F,F

SeeAlso

CALCulate:SCALe:UNIT

CONFigure:TEMPerature

MEASure:TEMPerature?

CALCulateSubsystemIntroduction

TheinternalDMMisrequiredtostorereadingsinmemoryandperform
calculations.Readingscanbeacquiredduringascanusingthe
34970A/34972Amultiplexermoduleslistedbelow.



34901A20ChannelMultiplexer(2/4-wire)Module

34902A16ChannelMultiplexer(2/4-wire)Module

34907AMultifunctionModule

34908A40ChannelSingle-EndedMultiplexerModule

CommandSummary

CALCulate:AVERage:AVERage?

CALCulate:AVERage:CLEar

CALCulate:AVERage:COUNt?

CALCulate:AVERage:MAXimum?

CALCulate:AVERage:MAXimum:TIME?

CALCulate:AVERage:MINimum?

CALCulate:AVERage:MINimum:TIME?

CALCulate:AVERage:PTPeak?



CALCulate:COMPare:DATA

CALCulate:COMPare:DATA?

CALCulate:COMPare:MASK

CALCulate:COMPare:MASK?

CALCulate:COMPare:STATe

CALCulate:COMPare:STATe?

CALCulate:COMPare:TYPE

CALCulate:COMPare:TYPE?



CALCulate:LIMit:LOWer

CALCulate:LIMit:LOWer?

CALCulate:LIMit:LOWer:STATe

CALCulate:LIMit:LOWer:STATe?

CALCulate:LIMit:UPPer

CALCulate:LIMit:UPPer?

CALCulate:LIMit:UPPer:STATe

CALCulate:LIMit:UPPer:STATe?



CALCulate:SCALe:GAIN

CALCulate:SCALe:GAIN?

CALCulate:SCALe:OFFSet

CALCulate:SCALe:OFFSet?

CALCulate:SCALe:OFFSet:NULL

CALCulate:SCALe:STATe

CALCulate:SCALe:STATe?

CALCulate:SCALe:UNIT

CALCulate:SCALe:UNIT?

CALCulate:AVERage:MINimum?
CALCulate:AVERage:AVERage?
CALCulate:AVERage:MAXimum?

Syntax|Description|Parameters|Remarks|ReturnFormat|Example

Syntax

CALCulate:AVERage:MINimum?[(@<ch_list>)]

CALCulate:AVERage:AVERage?[(@<ch_list>)]

CALCulate:AVERage:MAXimum?[(@<ch_list>)]

Description

Thesequeriesreturntheminimum,average(arithmeticmean)and
maximumvaluesfoundoneachofthespecifiedchannelsduringthe
scan.Eachchannelshouldbeamultiplexer,digitalortotalizerchannel
thathasbeenconfiguredtobepartofthescanlist.Ifitisnotpartofthe
scanlist,noerrorwillbegenerated,butthevaluereturnedwillbea
meaninglessvalueof0.

Parameters

Name Type RangeofValues Default

Value

<ch_list> Channel

List

Oneormorechannels,
asshown:

(@310)-channel10on
themoduleinslot300.

(@305:310)-channels
05through10onthe
moduleinslot300.

(@202:207,209,302:308)

-channels02through07
and09onthemodulein
slot200andchannels02
through08onthe
moduleinslot300.

Ifyou
omitthe
optional
<ch_list>
parameter,
this
command
appliesto
the
currently
defined
scanlist.

Remarks

Youcanreadthevaluesatanytime,evenduringascan.Anerror
isgeneratediftheinternalDMMisdisabled(see

INSTrument:DMMcommand)ornotinstalledinthemainframe.

ThecalculationstartswhentheinternalDMMistriggered.The
instrumentclearsthestoredstatisticaldataonallchannelswhena
newscanisstarted,whentheCALCulate:AVERage:CLEar
commandisexecuted,afteraFactoryReset(*RSTcommand),or
afteranInstrumentPreset(SYSTem:PRESetcommand).

ReturnFormat

Thequeryreturnsanumberintheform"+2.61920000E+01".Multiple
responsesareseparatedbycommas.Ifnodataisavailableforthe
specifiedchannels,itreturns+0.00000000E+00.

Example

Thefollowingqueryreturnstheminimumvaluesfoundonchannels05
through08onthemoduleinslot100.

Inthisexample,youcanreplacetheMINnodewithMAXorAVER.

CALC:AVER:MIN?(@105:108)

TypicalResponse:
+3.13830293E+01,+1.98732123E+01,9.38293055E+00,1.20393822E+01

SeeAlso

CALCulateSubsystemIntroduction

CALCulate:AVERage:CLEar

Syntax|Description|Parameters|Remarks|ReturnFormat|Example

Syntax

CALCulate:AVERage:CLEar[(@<ch_list>)]

Description

Thiscommandclearsallvaluesfromthestatisticsregistersforthe
specifiedchannels.Eachchannelshouldbeamultiplexer,digitalor
totalizerchannelthathasbeenconfiguredtobepartofthescanlist.Ifit
isnotpartofthescanlist,noerrorwillbegenerated,butthevalue
returnedwillbeameaninglessvalueof0.Theminimum,maximum,
average,count,andpeak-to-peakvaluesarecleared.Thevaluesforall
scannedchannelsarealsoclearedatthestartofanewscan.

Parameters

Name Type RangeofValues Default

Value

<ch_list> Channel

List

Oneormorechannels,
asshown:

(@310)-channel10on
themoduleinslot300.

(@305:310)-channels
05through10onthe
moduleinslot300.

(@202:207,209,302:308)

-channels02through07
and09onthemodulein
slot200andchannels02
through08onthe
moduleinslot300.

Ifyou
omitthe
optional
<ch_list>
parameter,
this
command
appliesto
the
currently
defined
scanlist.

Remarks

Althoughthiscommandclearstheminimum,maximum,average,
count,andpeak-to-peakvalues,noreadingsareclearedfrom
memory.

TheinstrumentgeneratesanerroriftheinternalDMMisdisabled
(seeINSTrument:DMM)ornotinstalledinthemainframe.

Theinstrumentclearsthestoredstatisticaldataonallchannels
whenanewscanisstarted,afteraFactoryReset(*RST
command),orafteranInstrumentPreset(SYSTem:PRESet
command).

Example

Thefollowingcommandclearsthestoredstatisticaldataonchannels1
through10inslot200.

CALC:AVER:CLEar(@201:210)

SeeAlso

CALCulateSubsystemIntroduction

CALCulate:AVERage:MINimum?

CALCulate:AVERage:MAXimum?

CALCulate:AVERage:AVERage?

CALCulate:AVERage:COUNt?

CALCulate:AVERage:PTPeak?

CALCulate:AVERage:COUNt?

Syntax|Description|Parameters|Remarks|ReturnFormat|Example

Syntax

CALCulate:AVERage:COUNt?[(@<ch_list>)]

Description

Thisqueryreturnsthenumberofreadingstakenoneachofthespecified
channelsduringthescan.Eachchannelshouldbeamultiplexer,digital
ortotalizerchannelthathasbeenconfiguredtobepartofthescanlist.If
itisnotpartofthescanlist,noerrorwillbegenerated,butthevalue
returnedwillbeameaninglessvalueof0.

Parameters

Name Type RangeofValues Default

Value

<ch_list> Channel

List

Oneormorechannels,
asshown:

(@310)-channel10on
themoduleinslot300.

(@305:310)-channels
05through10onthe
moduleinslot300.

(@202:207,209,302:308)

-channels02through07
and09onthemodulein
slot200andchannels02
through08onthe
moduleinslot300.

Ifyou
omitthe
optional
<ch_list>
parameter,
this
command
appliesto
the
currently
defined
scanlist.

Remarks

Youcanreadthevaluesatanytime,evenduringascan.Anerror
isgeneratediftheinternalDMMisdisabled(see

INSTrument:DMMcommand)ornotinstalledinthemainframe.

ThecalculationstartswhentheinternalDMMistriggered.The
instrumentclearsthestoredstatisticaldataonallchannelswhena
newscanisstarted,whentheCALCulate:AVERage:CLEar
commandisexecuted,afteraFactoryReset(*RSTcommand),or
afteranInstrumentPreset(SYSTem:PRESetcommand).

ReturnFormat

Thequeryreturnsanumberintheform"+7.90000000E+01".Multiple
responsesareseparatedbycommas.Ifnodataisavailableforthe
specifiedchannels,itreturns0.

Example

Thefollowingqueryreturnsthenumberofreadingstakenonchannels
05through08onthemoduleinslot100.

CALC:AVER:COUNt?(@105:108)

TypicalResponse:
+2.00000000E+01,1.90000000E+01,2.10000000E+01,2.00000000E+01

SeeAlso

CALCulateSubsystemIntroduction

CALCulate:AVERage:MINimum?

CALCulate:AVERage:MAXimum?

CALCulate:AVERage:AVERage?

CALCulate:AVERage:MINimum:TIME?
CALCulate:AVERage:MAXimum:TIME?

Syntax|Description|Parameters|Remarks|ReturnFormat|Example

Syntax

CALCulate:AVERage:MINimum:TIME?[(@<ch_list>)]

CALCulate:AVERage:MAXimum:TIME?[(@<ch_list>)]

Description

Thesequeriesreturnthetimethattheminimumormaximumreading
wastakenonthespecifiedchannelsduringthescan(infulltimeand
dateformat).Eachchannelmustbeamultiplexer,digitalinputortotalizer
channelthathasbeenconfiguredtobepartofthescanlist.

Parameters

Name Type RangeofValues Default

Value

<ch_list> Channel

List

Oneormorechannels,
asshown:

(@310)-channel10on
themoduleinslot300.

(@305:310)-channels
05through10onthe
moduleinslot300.

(@202:207,209,302:308)

-channels02through07
and09onthemodulein
slot200andchannels02
through08onthe
moduleinslot300.

Ifyou
omitthe
optional
<ch_list>
parameter,
this
command
appliesto
the
currently
defined
scanlist.

Remarks

Youcanreadthevaluesatanytime,evenduringascan.Anerror
isgeneratediftheinternalDMMisdisabled(see

INSTrument:DMMcommand)ornotinstalledinthemainframe.

ThecalculationstartswhentheinternalDMMistriggered.The
instrumentclearsthestoredstatisticaldataonallchannelswhena
newscanisstarted,whentheCALCulate:AVERage:CLEar
commandisexecuted,afteraFactoryReset(*RSTcommand),or
afteranInstrumentPreset(SYSTem:PRESetcommand).

Thiscommandisnotaffectedbythe

FORMat:READing:TIME:TYPEcommand,whichselectsthetime

formatforstoringscanneddatainmemory(absolutetimeversus
relativetime).

ReturnFormat

Foreachchannel,thequeryreturnsthetimeintheform
yyyy,mm,dd,hh,mm,ss.sss.Forexample,2009,10,03,14,35,06.215would
meanOctober3,2009at2:35:06.215PM.

Example

Thefollowingqueryreturnsthetimeoftheminimumreadingonchannels
03and04onthemoduleinslot100.

CALC:AVER:MIN:TIME?(@103:104)

TypicalResponse:2009,12,20,08,39,27.283,2009,12,20,08,39,28.011

SeeAlso

CALCulateSubsystemIntroduction

CALCulate:AVERage:PTPeak?

Syntax|Description|Parameters|Remarks|ReturnFormat|Example

Syntax

CALCulate:AVERage:PTPeak?[(@<ch_list>)]

Description

Thisqueryreturnsthepeaktopeakvalue(maximumminusminimum)
foundoneachofthespecifiedchannelsduringthescan.Eachchannel
shouldbeamultiplexer,digitalortotalizerchannelthathasbeen
configuredtobepartofthescanlist.Ifitisnotpartofthescanlist,no
errorwillbegenerated,butthevaluereturnedwillbeameaningless
valueof0.

Parameters

Name Type RangeofValues Default

Value

<ch_list> Channel

list

Oneormorechannels,
asshown:

(@310)-channel10on
themoduleinslot300.

(@305:310)-channels
05through10onthe
moduleinslot300.

(@202:207,209,302:308)

-channels02through07
and09onthemodulein
slot200andchannels02
through08onthe
moduleinslot300.

Ifyou
omitthe
optional
<ch_list>
parameter,
this
command
appliesto
the
currently
defined
scanlist.

Remarks

Youcanreadthevaluesatanytime,evenduringascan.Anerror
isgeneratediftheinternalDMMisdisabled(see

INSTrument:DMMcommand)ornotinstalledinthemainframe.

ThecalculationstartswhentheinternalDMMistriggered.The
instrumentclearsthestoredstatisticaldataonallchannelswhena
newscanisstarted,whentheCALCulate:AVERage:CLEar
commandisexecuted,afteraFactoryReset(*RSTcommand),or
afteranInstrumentPreset(SYSTem:PRESetcommand).

ReturnFormat

Thequeryreturnsanumberintheform"+2.61920000E+01".Multiple
responsesareseparatedbycommas.Ifnodataisavailableforthe
specifiedchannels,itreturns+0.00000000E+00.

Example

Thefollowingqueryreturnsthepeaktopeakvaluesfoundonchannels
05through08onthemoduleinslot100.

CALC:AVER:PTP?(@105:108)

TypicalResponse:
+3.13830293E+01,+1.98732123E+01,9.38293055E+00,1.20393822E+01