2.1 cavget

• description: cavget retrieves values of one or more EPICS process variables using Channel Access or PVAccess. It supports formatting, repeated acquisition and statistical analysis for scripting and data collection.
• examples:
  cavget -list=my:pv  
  cavget -repeat=number=10,pause=1 -labeled -list=quadrupole:current  
  cavget -statistics=number=100,pause=0.1,format=SDDS,file=stats.sdds -list=cavit:readback  
  cavget -list=Q -range=begin=1,end=4,format=%02d -list=:I

• synopsis:
  usage: cavget [-list=<string>[=<value>][,<string>[=<value>]...]]  
        [-range=begin=<integer>,end=<integer>[,format=<string>][,interval=<integer>]]  
        [-floatformat=<printfString>] [-charArray] [-delimiter=<string>] [-labeled]  
        [-noQuotes] [-embrace=start=<string>,end=<string>] [-cavputForm]  
        [-statistics=number=<value>,pause=<value>  
          [,format=[tagvalue][pretty][SDDS,file=<filename>]]]  
        [-pendIoTime=<seconds>] [-dryRun]  
        [-repeat=number=<integer>,pause=<seconds>[,average[,sigma]]]  
        [-numerical] [-errorValue=<string>] [-excludeErrors]  
        [-despike[[neighbors=<integer>][,passes=<integer>]  
          [,averageOf=<integer>][,threshold=<value>]]]  
        [-provider={ca|pva}] [-info] [-printErrors] pvname [...]

• switches:
  • -list — Build PV names from components or explicit names. Multiple -list entries are concatenated in order, so -list=quad -list=:readback becomes quad:readback. Appending =<value> sets a value for use with cavput.
  • -range — Append integer ranges to PV prefixes.
    For example, -list=Q -range=begin=1,end=4,format=%02d -list=:I
    produces names Q01:I through Q04:I.
  • -floatformat — Set printf-style format for floating point numbers.
  • -charArray — Print character arrays as strings.
  • -delimiter — String used to separate values.
  • -labeled — Prepend PV names to values.
  • -noQuotes — Suppress quotes around string values.
  • -embrace — Surround output with given start and end strings.
  • -cavputForm — Format output suitable for input to cavput.
  • -statistics — Compute statistics over repeated readings.
  • -pendIoTime — Maximum time to wait for connections.
  • -dryRun — List PV names without fetching values.
  • -repeat — Take multiple readings with optional pause.
  • -numerical — Use numerical values for enumerations.
  • -errorValue — Substitute a value if a read fails.
  • -excludeErrors — Omit values if a read fails.
  • -despike — Remove outliers using neighbors/passes settings.
  • -provider — Select Channel Access (ca) or PVAccess (pva).
  • -info — Show connection and data type information.
  • -printErrors — Print errors without aborting.
• see also:
  • cavput()
  • cawait()
• author: Michael Borland, Robert Soliday, ANL/APS.