LeCroy_9304A%2FBeschreibung.mw

   1 Dieser Beschreibungstext zur Waveform wird vom Lecroy ausgegeben, wenn man
   2  TMPL?
   3 fragt.
   4
   5 <pre>
   6 TMPL "
   7 /00
   8 000000              LECROY_2_2:  TEMPLATE
   9                     8 66 111
  10 ;
  11 ; Explanation of the formats of waveforms and their descriptors on the
  12 ; LeCroy Digital Oscilloscopes,
  13 ;     Software Release 44.1.1.1, 94/04/18.
  14 ;
  15 ; A descriptor and/or a waveform consists of one or several logical data blocks
  16 ; whose formats are explained below.
  17 ; Usually, complete waveforms are read: at the minimum they consist of
  18 ;       the basic descriptor block WAVEDESC
  19 ;       a data array block.
  20 ; Some more complex waveforms, e.g. Extrema data or the results of a Fourier
  21 ; transform, may contain several data array blocks.
  22 ; When there are more blocks, they are in the following sequence:
  23 ;       the basic descriptor block WAVEDESC
  24 ;       the history text descriptor block USERTEXT (may or may not be present)
  25 ;       the time array block (for RIS and sequence acquisitions only)
  26 ;       data array block
  27 ;       auxiliary or second data array block
  28 ;
  29 ; In the following explanation, every element of a block is described by a
  30 ; single line in the form
  31 ;
  32 ; <byte position>   <variable name>: <variable type> ; <comment>
  33 ;
  34 ;  where
  35 ;
  36 ;   <byte position> = position in bytes (decimal offset) of the variable,
  37 ;                     relative to the beginning of the block.
  38 ;
  39 ;   <variable name> = name of the variable.
  40 ;
  41 ;   <variable type> = string        up to 16-character name
  42 ;                                     terminated with a null byte
  43 ;                       byte         8-bit signed data value
  44 ;                       word        16-bit signed data value
  45 ;                       long        32-bit signed data value
  46 ;                      float        32-bit IEEE floating point value
  47 ;                                   with the format shown below
  48 ;                                   31  30 .. 23   22 ... 0   bit position
  49 ;                                   s   exponent   fraction
  50 ;                                   where
  51 ;                                   s = sign of the fraction
  52 ;                                   exponent = 8 bit exponent e
  53 ;                                   fraction = 23 bit fraction f
  54 ;                                   and the final value is
  55 ;                                   (-1)**s * 2**(e-127) * 1.f
  56 ;                     double        64-bit IEEE floating point value
  57 ;                                   with the format shown below
  58 ;                                   63  62 .. 52   51 ... 0   bit position
  59 ;                                   s   exponent   fraction
  60 ;                                   where
  61 ;                                   s = sign of the fraction
  62 ;                                   exponent = 11 bit exponent e
  63 ;                                   fraction = 52 bit fraction f
  64 ;                                   and the final value is
  65 ;                                   (-1)**s * 2**(e-1023) * 1.f
  66 ;                       enum        enumerated value in the range 0 to N
  67 ;                                   represented as a 16-bit data value.
  68 ;                                   The list of values follows immediately.
  69 ;                                   The integer is preceded by an _.
  70 ;                 time_stamp        double precision floating point number,
  71 ;                                   for the number of seconds and some bytes
  72 ;                                   for minutes, hours, days, months and year.
  73 ;
  74 ;                                   double  seconds     (0 to 59)
  75 ;                                   byte    minutes     (0 to 59)
  76 ;                                   byte    hours       (0 to 23)
  77 ;                                   byte    days        (1 to 31)
  78 ;                                   byte    months      (1 to 12)
  79 ;                                   word    year        (0 to 16000)
  80 ;                                   word    unused
  81 ;                                   There are 16 bytes in a time field.
  82 ;                       data        byte, word or float, depending on the
  83 ;                                   read-out mode reflected by the WAVEDESC
  84 ;                                   variable COMM_TYPE, modifiable via the
  85 ;                                   remote command COMM_FORMAT.
  86 ;                       text        arbitrary length text string
  87 ;                                   (maximum 160)
  88 ;            unit_definition        a unit definition consists of a 48 character
  89 ;                                   ASCII string terminated with a null byte
  90 ;                                   for the unit name.
  91 ;
  92 ;==========================================================================
  93 ;
  94 WAVEDESC: BLOCK
  95 ;
  96 ; Explanation of the wave descriptor block WAVEDESC;
  97 ;
  98 ;
  99 <  0>          DESCRIPTOR_NAME: string  ; the first 8 chars are always WAVEDESC
 100 ;
 101 < 16>          TEMPLATE_NAME: string
 102 ;
 103 < 32>          COMM_TYPE: enum          ; chosen by remote command COMM_FORMAT
 104                _0      byte
 105                _1      word
 106                endenum
 107 ;
 108 < 34>          COMM_ORDER: enum
 109                _0      HIFIRST
 110                _1      LOFIRST
 111                endenum
 112 ;
 113 ;
 114 ; The following variables of this basic wave descriptor block specify
 115 ; the block lengths of all blocks of which the entire waveform (as it is
 116 ; currently being read) is composed. If a block length is zero, this
 117 ; block is (currently) not present.
 118 ;
 119 ;
 120 ;BLOCKS :
 121 ;
 122 < 36>          WAVE_DESCRIPTOR: long    ; length in bytes of block WAVEDESC
 123 < 40>          USER_TEXT: long          ; length in bytes of block USERTEXT
 124 < 44>          RES_DESC1: long          ;
 125 ;
 126 ;ARRAYS :
 127 ;
 128 < 48>          TRIGTIME_ARRAY: long     ; length in bytes of TRIGTIME array
 129 ;
 130 < 52>          RIS_TIME_ARRAY: long     ; length in bytes of RIS_TIME array
 131 ;
 132 < 56>          RES_ARRAY1: long         ; an expansion entry is reserved
 133 ;
 134 < 60>          WAVE_ARRAY_1: long       ; length in bytes of 1st simple
 135                                         ; data array. In transmitted waveform,
 136                                         ; represent the number of transmitted
 137                                         ; bytes in accordance with the NP
 138                                         ; parameter of the WFSU remote command
 139                                         ; and the used format (see COMM_TYPE).
 140 ;
 141 < 64>          WAVE_ARRAY_2: long       ; length in bytes of 2nd simple
 142                                         ; data array
 143 ;
 144 < 68>          RES_ARRAY2: long
 145 < 72>          RES_ARRAY3: long         ; 2 expansion entries are reserved
 146 ;
 147 ; The following variables identify the instrument
 148 ;
 149 < 76>          INSTRUMENT_NAME: string
 150 ;
 151 < 92>          INSTRUMENT_NUMBER: long
 152 ;
 153 < 96>          TRACE_LABEL: string      ; identifies the waveform.
 154 ;
 155 <112>          RESERVED1: word
 156 <114>          RESERVED2: word          ; 2 expansion entries
 157 ;
 158 ; The following variables describe the waveform and the time at
 159 ; which the waveform was generated.
 160 ;
 161 <116>          WAVE_ARRAY_COUNT: long   ; number of data points in the data
 162                                         ; array. If there are two data
 163                                         ; arrays (FFT or Extrema), this number
 164                                         ; applies to each array separately.
 165 ;
 166 <120>          PNTS_PER_SCREEN: long    ; nominal number of data points
 167                                         ; on the screen
 168 ;
 169 <124>          FIRST_VALID_PNT: long    ; count of number of points to skip
 170                                         ; before first good point
 171                                         ; FIRST_VALID_POINT = 0
 172                                         ; for normal waveforms.
 173 ;
 174 <128>          LAST_VALID_PNT: long     ; index of last good data point
 175                                         ; in record before padding (blanking)
 176                                         ; was started.
 177                                         ; LAST_VALID_POINT = WAVE_ARRAY_COUNT-1
 178                                         ; except for aborted sequence
 179                                         ; and rollmode acquisitions
 180 ;
 181 <132>          FIRST_POINT: long        ; for input and output, indicates
 182                                         ; the offset relative to the
 183                                         ; beginning of the trace buffer.
 184                                         ; Value is the same as the FP parameter
 185                                         ; of the WFSU remote command.
 186 ;
 187 <136>          SPARSING_FACTOR: long    ; for input and output, indicates
 188                                         ; the sparsing into the transmitted
 189                                         ; data block.
 190                                         ; Value is the same as the SP parameter
 191                                         ; of the WFSU remote command.
 192 ;
 193 <140>          SEGMENT_INDEX: long      ; for input and output, indicates the
 194                                         ; index of the transmitted segment.
 195                                         ; Value is the same as the SN parameter
 196                                         ; of the WFSU remote command.
 197 ;
 198 <144>          SUBARRAY_COUNT: long     ; for Sequence, acquired segment count,
 199                                         ; between 0 and NOM_SUBARRAY_COUNT
 200 ;
 201 <148>          SWEEPS_PER_ACQ: long     ; for Average or Extrema,
 202                                         ; number of sweeps accumulated
 203                                         ; else 1
 204 ;
 205 <152>          POINTS_PER_PAIR: word    ; for Peak Dectect waveforms (which always
 206                                         ; include data points in DATA_ARRAY_1 and
 207                                         ; min/max pairs in DATA_ARRAY_2).
 208                                         ; Value is the number of data points for
 209                                         ; each min/max pair.
 210 ;
 211 <154>          PAIR_OFFSET: word        ; for Peak Dectect waveforms only
 212                                         ; Value is the number of data points by
 213                                         ; which the first min/max pair in
 214                                         ; DATA_ARRAY_2 is offset relative to the
 215                                         ; first data value in DATA_ARRAY_1.
 216 ;
 217 <156>          VERTICAL_GAIN: float
 218 ;
 219 <160>          VERTICAL_OFFSET: float   ; to get floating values from raw data :
 220                                         ; VERTICAL_GAIN * data - VERTICAL_OFFSET
 221 ;
 222 <164>          MAX_VALUE: float         ; maximum allowed value. It corresponds
 223                                         ; to the upper edge of the grid.
 224 ;
 225 <168>          MIN_VALUE: float         ; minimum allowed value. It corresponds
 226                                         ; to the lower edge of the grid.
 227 ;
 228 <172>          NOMINAL_BITS: word       ; a measure of the intrinsic precision
 229                                         ; of the observation: ADC data is 8 bit
 230                                         ;    averaged data is 10-12 bit, etc.
 231 ;
 232 <174>          NOM_SUBARRAY_COUNT: word ; for Sequence, nominal segment count
 233                                         ; else 1
 234 ;
 235 <176>          HORIZ_INTERVAL: float    ; sampling interval for time domain
 236                                         ;  waveforms
 237 ;
 238 <180>          HORIZ_OFFSET: double     ; trigger offset for the first sweep of
 239                                         ; the trigger, seconds between the
 240                                         ; trigger and the first data point
 241 ;
 242 <188>          PIXEL_OFFSET: double     ; needed to know how to display the
 243                                         ; waveform
 244 ;
 245 <196>          VERTUNIT: unit_definition  ; units of the vertical axis
 246 ;
 247 <244>          HORUNIT: unit_definition   ; units of the horizontal axis
 248 ;
 249 <292>          RESERVED3: word
 250 <294>          RESERVED4: word          ; 2 expansion entries
 251 ;
 252 <296>          TRIGGER_TIME: time_stamp ; time of the trigger
 253 ;
 254 <312>          ACQ_DURATION: float      ; duration of the acquisition (in sec)
 255                                         ; in multi-trigger waveforms.
 256                                         ; (e.g. sequence, RIS,  or averaging)
 257 ;
 258 <316>          RECORD_TYPE: enum
 259                _0      single_sweep
 260                _1      interleaved
 261                _2      histogram
 262                _3      graph
 263                _4      filter_coefficient
 264                _5      complex
 265                _6      extrema
 266                _7      sequence_obsolete
 267                _8      centered_RIS
 268                _9      peak_detect
 269                endenum
 270 ;
 271 <318>          PROCESSING_DONE: enum
 272                _0       no_processing
 273                _1       fir_filter
 274                _2       interpolated
 275                _3       sparsed
 276                _4       autoscaled
 277                _5       no_result
 278                _6       rolling
 279                _7       cumulative
 280                endenum
 281 ;
 282 <320>          RESERVED5: word          ; expansion entry
 283 ;
 284 <322>          RIS_SWEEPS: word         ; for RIS, the number of sweeps
 285                                         ; else 1
 286 ;
 287 ; The following variables describe the basic acquisition
 288 ; conditions used when the waveform was acquired
 289 ;
 290 <324>          TIMEBASE: enum
 291                _0    1_ps/div
 292                _1    2_ps/div
 293                _2    5_ps/div
 294                _3    10_ps/div
 295                _4    20_ps/div
 296                _5    50_ps/div
 297                _6    100_ps/div
 298                _7    200_ps/div
 299                _8    500_ps/div
 300                _9    1_ns/div
 301                _10   2_ns/div
 302                _11   5_ns/div
 303                _12   10_ns/div
 304                _13   20_ns/div
 305                _14   50_ns/div
 306                _15   100_ns/div
 307                _16   200_ns/div
 308                _17   500_ns/div
 309                _18   1_us/div
 310                _19   2_us/div
 311                _20   5_us/div
 312                _21   10_us/div
 313                _22   20_us/div
 314                _23   50_us/div
 315                _24   100_us/div
 316                _25   200_us/div
 317                _26   500_us/div
 318                _27   1_ms/div
 319                _28   2_ms/div
 320                _29   5_ms/div
 321                _30   10_ms/div
 322                _31   20_ms/div
 323                _32   50_ms/div
 324                _33   100_ms/div
 325                _34   200_ms/div
 326                _35   500_ms/div
 327                _36   1_s/div
 328                _37   2_s/div
 329                _38   5_s/div
 330                _39   10_s/div
 331                _40   20_s/div
 332                _41   50_s/div
 333                _42   100_s/div
 334                _43   200_s/div
 335                _44   500_s/div
 336                _45   1_ks/div
 337                _46   2_ks/div
 338                _47   5_ks/div
 339                _100  EXTERNAL
 340                endenum
 341 ;
 342 <326>          VERT_COUPLING: enum
 343                _0      DC_50_Ohms
 344                _1      ground
 345                _2      DC_1MOhm
 346                _3      ground
 347                _4      AC,_1MOhm
 348                endenum
 349 ;
 350 <328>          PROBE_ATT: float
 351 ;
 352 <332>          FIXED_VERT_GAIN: enum
 353                _0   1_uV/div
 354                _1   2_uV/div
 355                _2   5_uV/div
 356                _3   10_uV/div
 357                _4   20_uV/div
 358                _5   50_uV/div
 359                _6   100_uV/div
 360                _7   200_uV/div
 361                _8   500_uV/div
 362                _9   1_mV/div
 363                _10  2_mV/div
 364                _11  5_mV/div
 365                _12  10_mV/div
 366                _13  20_mV/div
 367                _14  50_mV/div
 368                _15  100_mV/div
 369                _16  200_mV/div
 370                _17  500_mV/div
 371                _18  1_V/div
 372                _19  2_V/div
 373                _20  5_V/div
 374                _21  10_V/div
 375                _22  20_V/div
 376                _23  50_V/div
 377                _24  100_V/div
 378                _25  200_V/div
 379                _26  500_V/div
 380                _27  1_kV/div
 381                endenum
 382 ;
 383 <334>          BANDWIDTH_LIMIT: enum
 384                _0      off
 385                _1      on
 386                endenum
 387 ;
 388 <336>          VERTICAL_VERNIER: float
 389 ;
 390 <340>          ACQ_VERT_OFFSET: float
 391 ;
 392 <344>          WAVE_SOURCE: enum
 393                _0      CHANNEL_1
 394                _1      CHANNEL_2
 395                _2      CHANNEL_3
 396                _3      CHANNEL_4
 397                _9      UNKNOWN
 398                endenum
 399 ;
 400 /00              ENDBLOCK
 401 ;
 402 ;==========================================================================
 403 ;
 404 USERTEXT: BLOCK
 405 ;
 406 ; Explanation of the descriptor block USERTEXT at most 160 bytes long.
 407 ;
 408 ;
 409 <  0>          TEXT: text               ; a list of ASCII characters
 410 ;
 411 /00              ENDBLOCK
 412 ;
 413 ;==========================================================================
 414 ;
 415 DATA_ARRAY_1: ARRAY
 416 ;
 417 ; Explanation of the data array DATA_ARRAY_1.
 418 ; This main data array is always present. It is the only data array for
 419 ; most waveforms.
 420 ; The data item is repeated for each acquired or computed data point
 421 ; of the first data array of any waveform.
 422 ;
 423 <  0>          MEASUREMENT: data        ; the actual format of a data is
 424                                         ; given in the WAVEDESC descriptor
 425                                         ; by the COMM_TYPE variable.
 426 ;
 427 /00              ENDARRAY
 428 ;
 429 ;==========================================================================
 430 ;
 431 DATA_ARRAY_2: ARRAY
 432 ;
 433 ; Explanation of the data array DATA_ARRAY_2.
 434 ; This is an optional secondary data array for special types of waveforms:
 435 ;       Complex FFT     imaginary part      (real part in DATA_ARRAY_1)
 436 ;       Extrema         floor trace         (roof trace in DATA_ARRAY_1)
 437 ;       Peak Detect     min/max pairs       (data values in DATA_ARRAY_1)
 438 ; In the first 2 cases, there is exactly one data item in DATA_ARRAY_2 for
 439 ; each data item in DATA_ARRAY_1.
 440 ; In Peak Detect waveforms, there may be fewer data values in DATA_ARRAY_2,
 441 ; as described by the variable POINTS_PER_PAIR.
 442 ;
 443 <  0>          MEASUREMENT: data        ; the actual format of a data is
 444                                         ; given in the WAVEDESC descriptor
 445                                         ; by the COMM_TYPE variable.
 446 ;
 447 /00              ENDARRAY
 448 ;
 449 ;==========================================================================
 450 ;
 451 TRIGTIME: ARRAY
 452 ;
 453 ; Explanation of the trigger time array TRIGTIME.
 454 ; This optional time array is only present with SEQNCE waveforms.
 455 ; The following data block is repeated for each segment which makes up
 456 ; the acquired sequence record.
 457 ;
 458 <  0>          TRIGGER_TIME: double     ; for sequence acquisitions,
 459                                         ; time in seconds from first
 460                                         ; trigger to this one
 461 ;
 462 <  8>          TRIGGER_OFFSET: double   ; the trigger offset is in seconds
 463                                         ; from trigger to zeroth data point
 464 ;
 465 /00              ENDARRAY
 466 ;
 467 ;==========================================================================
 468 ;
 469 RISTIME: ARRAY
 470 ;
 471 ; Explanation of the random-interleaved-sampling (RIS) time array RISTIME.
 472 ; This optional time array is only present with RIS waveforms.
 473 ; This data block is repeated for each sweep which makes up the RIS record
 474 ;
 475 <  0>          RIS_OFFSET: double       ; seconds from trigger to zeroth
 476                                         ; point of segment
 477 ;
 478 /00              ENDARRAY
 479 ;
 480 ;==========================================================================
 481 ;
 482 SIMPLE: ARRAY
 483 ;
 484 ; Explanation of the data array SIMPLE.
 485 ; This data array is identical to DATA_ARRAY_1. SIMPLE is an accepted
 486 ; alias name for DATA_ARRAY_1.
 487 ;
 488 <  0>          MEASUREMENT: data        ; the actual format of a data is
 489                                         ; given in the WAVEDESC descriptor
 490                                         ; by the COMM_TYPE variable.
 491 ;
 492 /00              ENDARRAY
 493 ;
 494 ;==========================================================================
 495 ;
 496 DUAL: ARRAY
 497 ;
 498 ; Explanation of the DUAL array.
 499 ; This data array is identical to DATA_ARRAY_1, followed by DATA_ARRAY_2.
 500 ; DUAL is an accepted alias name for the combined arrays DATA_ARRAY_1 and
 501 ; DATA_ARRAY_2 (e.g. real and imaginary parts of an FFT).
 502 ;
 503 <  0>          MEASUREMENT_1: data      ; data in DATA_ARRAY_1.
 504 ;
 505 <  0>          MEASUREMENT_2: data      ; data in DATA_ARRAY_2.
 506 ;
 507 /00              ENDARRAY
 508 ;
 509 ;
 510 000000               ENDTEMPLATE
 511 "
 512
 513 </pre>