| 1 | package Lab::Data::Analysis::TekTDS; | ||
| 2 | #ABSTRACT: Analysis routine for Tektronix TDS1000/TDS2000/etc. scopes | ||
| 3 | $Lab::Data::Analysis::TekTDS::VERSION = '3.901'; | ||
| 4 | use v5.20; | ||
| 5 | |||
| 6 | use strict; | ||
| 7 | use warnings; | ||
| 8 | use Carp; | ||
| 9 | use Data::Dumper; | ||
| 10 | use Lab::SCPI; | ||
| 11 | use Lab::Instrument::TDS2024B; | ||
| 12 | use Lab::Data::Analysis; | ||
| 13 | use Clone qw(clone); | ||
| 14 | |||
| 15 | our @ISA = ("Lab::Data::Analysis"); | ||
| 16 | |||
| 17 | our $DEBUG = 0; | ||
| 18 | |||
| 19 | # default config values, copied to $self->{CONFIG} initially | ||
| 20 | |||
| 21 | our $DEFAULT_CONFIG = {}; | ||
| 22 | |||
| 23 | |||
| 24 | sub new { | ||
| 25 | my $proto = shift; | ||
| 26 | my $class = ref($proto) || $proto; | ||
| 27 | my $self = {}; | ||
| 28 | bless $self, $class; | ||
| 29 | |||
| 30 | my ( $stream, $tail ) | ||
| 31 | = Lab::Data::Analysis::_check_args( \@_, qw(stream) ); | ||
| 32 | |||
| 33 | $self->{STREAM} = $stream; # hash of stream fileheader info | ||
| 34 | |||
| 35 | return $self; | ||
| 36 | } | ||
| 37 | |||
| 38 | |||
| 39 | sub Analyze { | ||
| 40 | my $self = shift; | ||
| 41 | my $event = shift; | ||
| 42 | |||
| 43 | # handle analysis options | ||
| 44 | my $option = shift; | ||
| 45 | $option = {} unless defined $option && ref($option) eq 'HASH'; | ||
| 46 | $option->{dropraw} = 0 unless exists $option->{dropraw}; | ||
| 47 | $option->{interpolate} = 1 unless exists $option->{interpolate}; | ||
| 48 | $option->{print_summary} = 0 unless exists $option->{print_summary}; | ||
| 49 | |||
| 50 | my $stream = $self->{STREAM}->{NUMBER}; | ||
| 51 | |||
| 52 | my $a = {}; | ||
| 53 | $a->{MODULE} = 'TekTDS'; | ||
| 54 | $a->{RAW} = {}; | ||
| 55 | $a->{RAW}->{CHAN} = {}; | ||
| 56 | $a->{CHAN} = {}; | ||
| 57 | $a->{COMMENT} = []; | ||
| 58 | $a->{RUN} = $event->{RUN}; | ||
| 59 | $a->{EVENT} = $event->{EVENT}; | ||
| 60 | $a->{STREAM} = $stream; | ||
| 61 | $a->{OPTIONS} = clone($option); | ||
| 62 | |||
| 63 | # event->{ANALYZE}->{stream#}->{TekTDS}->{analysis stuff}? | ||
| 64 | |||
| 65 | foreach my $c ( @{ $event->{STREAM}->{$stream}->{COMMENT} } ) { | ||
| 66 | push( @{ $a->{COMMENT} }, $c ); | ||
| 67 | } | ||
| 68 | |||
| 69 | my $ch; | ||
| 70 | my $seq = []; | ||
| 71 | foreach my $g ( @{ $event->{STREAM}->{$stream}->{GPIB} } ) { | ||
| 72 | my $str = substr( $g, 1 ); | ||
| 73 | next if $str =~ /^\d+/; | ||
| 74 | $seq = scpi_parse_sequence( $str, $seq ); | ||
| 75 | } | ||
| 76 | print "seq = ", Dumper($seq), "\n", if $DEBUG; | ||
| 77 | |||
| 78 | my $fseq = scpi_flat( | ||
| 79 | $seq, | ||
| 80 | $Lab::Instrument::TDS2024B::fields{scpi_override} | ||
| 81 | ); | ||
| 82 | print "fseq = ", Dumper($fseq), "\n" if $DEBUG; | ||
| 83 | |||
| 84 | for ( my $j = 0; exists( $fseq->[$j] ); $j++ ) { | ||
| 85 | if ( exists( $fseq->[$j]->{'DAT:SOU'} ) ) { | ||
| 86 | $ch = $fseq->[$j]->{'DAT:SOU'}; | ||
| 87 | $a->{RAW}->{CHAN}->{$ch} = {} | ||
| 88 | unless exists $a->{RAW}->{CHAN}->{$ch}; | ||
| 89 | $a->{CHAN}->{$ch} = {} unless exists $a->{CHAN}->{$ch}; | ||
| 90 | $a->{CHAN}->{$ch}->{CHAN} = $ch; | ||
| 91 | $a->{RAW}->{CHAN}->{$ch}->{CHAN} = $ch; | ||
| 92 | } | ||
| 93 | |||
| 94 | foreach my $k ( keys( %{ $fseq->[$j] } ) ) { | ||
| 95 | print "\$fseq->[$j]->{$k} = '", $fseq->[$j]->{$k}, "'\n" | ||
| 96 | if $DEBUG; | ||
| 97 | if ( $k =~ /^(DAT|WFMP|CURV)/ ) { | ||
| 98 | $a->{RAW}->{CHAN}->{$ch}->{$k} = $fseq->[$j]->{$k}; | ||
| 99 | } | ||
| 100 | } | ||
| 101 | |||
| 102 | } | ||
| 103 | print Dumper($a) if $DEBUG > 2; | ||
| 104 | $self->_PrintSummary( $a, $option ) if $option->{print_summary}; | ||
| 105 | |||
| 106 | foreach $ch ( keys( %{ $a->{RAW}->{CHAN} } ) ) { | ||
| 107 | my $id = $a->{RAW}->{CHAN}->{$ch}->{'WFMP:WFI'}; | ||
| 108 | my $x0 = $a->{RAW}->{CHAN}->{$ch}->{'WFMP:XZE'}; | ||
| 109 | my $y0 = $a->{RAW}->{CHAN}->{$ch}->{'WFMP:YZE'}; | ||
| 110 | my $dx = $a->{RAW}->{CHAN}->{$ch}->{'WFMP:XIN'}; | ||
| 111 | my $xoff = $a->{RAW}->{CHAN}->{$ch}->{'WFMP:PT_O'}; | ||
| 112 | my $xun = $a->{RAW}->{CHAN}->{$ch}->{'WFMP:XUN'}; | ||
| 113 | my $dy = $a->{RAW}->{CHAN}->{$ch}->{'WFMP:YMU'}; | ||
| 114 | my $yoff = $a->{RAW}->{CHAN}->{$ch}->{'WFMP:YOF'}; | ||
| 115 | my $yun = $a->{RAW}->{CHAN}->{$ch}->{'WFMP:YUN'}; | ||
| 116 | my $j0 = $a->{RAW}->{CHAN}->{$ch}->{'DAT:STAR'}; | ||
| 117 | my $j1 = $a->{RAW}->{CHAN}->{$ch}->{'DAT:STOP'}; | ||
| 118 | my $enc = $a->{RAW}->{CHAN}->{$ch}->{'DAT:ENC'}; | ||
| 119 | my $wd = $a->{RAW}->{CHAN}->{$ch}->{'DAT:WID'}; | ||
| 120 | my $d = $a->{RAW}->{CHAN}->{$ch}->{'CURV'}; | ||
| 121 | |||
| 122 | $id =~ s/^\"(.*)\"/$1/; | ||
| 123 | $a->{CHAN}->{$ch}->{ID} = $id; | ||
| 124 | $xun =~ s/^\"(.*)\"/$1/; | ||
| 125 | $yun =~ s/^\"(.*)\"/$1/; | ||
| 126 | $a->{CHAN}->{$ch}->{Xunit} = $xun; | ||
| 127 | $a->{CHAN}->{$ch}->{Yunit} = $yun; | ||
| 128 | $a->{CHAN}->{$ch}->{DX} = $dx; | ||
| 129 | $a->{CHAN}->{$ch}->{X} = []; | ||
| 130 | |||
| 131 | my (@dat) = _extractWaveform( $enc, $wd, $d ); | ||
| 132 | my ( $ymin, $ymax ); | ||
| 133 | if ( $a->{RAW}->{CHAN}->{$ch}->{'WFMP:PT_F'} eq 'Y' ) { | ||
| 134 | $a->{CHAN}->{$ch}->{Y} = []; | ||
| 135 | $a->{CHAN}->{$ch}->{START} = $j0; | ||
| 136 | $a->{CHAN}->{$ch}->{STOP} = $j1; | ||
| 137 | for ( my $j = 0; $j <= $#dat; $j++ ) { | ||
| 138 | $a->{CHAN}->{$ch}->{X}->[ $j + $j0 ] | ||
| 139 | = $x0 + $dx * ( $j - $xoff ); | ||
| 140 | my $y = $y0 + $dy * ( $dat[$j] - $yoff ); | ||
| 141 | $a->{CHAN}->{$ch}->{Y}->[ $j + $j0 ] = $y; | ||
| 142 | $ymin = $y unless defined $ymin && $y > $ymin; | ||
| 143 | $ymax = $y unless defined $ymax && $y < $ymax; | ||
| 144 | } | ||
| 145 | } | ||
| 146 | else { #envelope | ||
| 147 | $a->{CHAN}->{$ch}->{Y0} = []; | ||
| 148 | $a->{CHAN}->{$ch}->{Y1} = []; | ||
| 149 | $a->{CHAN}->{$ch}->{START} = $j0; | ||
| 150 | $a->{CHAN}->{$ch}->{STOP} = $j0 + $#dat / 2; | ||
| 151 | for ( my $j = 0; $j <= $#dat; $j += 2 ) { | ||
| 152 | $a->{CHAN}->{$ch}->{X}->[ $j / 2 + $j0 ] | ||
| 153 | = $x0 + $dx * ( $j - $xoff ); | ||
| 154 | my $y = $y0 + $dy * ( $dat[$j] - $yoff ); | ||
| 155 | $a->{CHAN}->{$ch}->{Y0}->[ $j / 2 + $j0 ] = $y; | ||
| 156 | $ymin = $y unless defined $ymin && $y > $ymin; | ||
| 157 | $ymax = $y unless defined $ymax && $y < $ymax; | ||
| 158 | |||
| 159 | $y = $y0 + $dy * ( $dat[ $j + 1 ] - $yoff ); | ||
| 160 | $a->{CHAN}->{$ch}->{Y1}->[ $j / 2 + $j0 ] = $y; | ||
| 161 | $ymin = $y unless defined $ymin && $y > $ymin; | ||
| 162 | $ymax = $y unless defined $ymax && $y < $ymax; | ||
| 163 | } | ||
| 164 | } | ||
| 165 | $a->{CHAN}->{$ch}->{YMIN} = $ymin; | ||
| 166 | $a->{CHAN}->{$ch}->{YMAX} = $ymax; | ||
| 167 | |||
| 168 | $a->{CHAN}->{$ch}->{XMIN} = $a->{CHAN}->{$ch}->{X}->[$j0]; | ||
| 169 | $a->{CHAN}->{$ch}->{XMAX} = $a->{CHAN}->{$ch}->{X}->[$j1]; | ||
| 170 | |||
| 171 | # | ||
| 172 | # creates an anonymous sub that interpolates into the waveform | ||
| 173 | # | ||
| 174 | if ( $option->{interpolate} ) { | ||
| 175 | $a->{CHAN}->{$ch}->{Yfunc} = sub { | ||
| 176 | use feature 'state'; | ||
| 177 | state $hchan; | ||
| 178 | $hchan = $a->{CHAN}->{$ch} unless defined $hchan; | ||
| 179 | return ( _interpolate( $hchan, @_ ) ); | ||
| 180 | }; | ||
| 181 | $a->{CHAN}->{$ch}->{Yfunc}->(0); # initialize state var | ||
| 182 | } | ||
| 183 | } | ||
| 184 | delete( $a->{RAW} ) if $option->{dropraw}; | ||
| 185 | $event->{ANALYZE} = {} unless exists $event->{ANALYZE}; | ||
| 186 | |||
| 187 | $event->{ANALYZE}->{$stream} = {} | ||
| 188 | unless exists $event->{ANALYZE}->{$stream}; | ||
| 189 | |||
| 190 | $event->{ANALYZE}->{$stream}->{TekTDS} = $a; | ||
| 191 | |||
| 192 | # push(@{$event->{ANALYZED}},$a); | ||
| 193 | return $event; | ||
| 194 | } | ||
| 195 | |||
| 196 | sub _interpolate { | ||
| 197 | my $h = shift; # hash pointer to {CHAN}->{$ch} | ||
| 198 | if ( ref($h) ne 'HASH' ) { | ||
| 199 | carp("bad hash pointer for wfd interpolation"); | ||
| 200 | return undef; | ||
| 201 | } | ||
| 202 | my $x = shift; | ||
| 203 | |||
| 204 | return undef if $x < $h->{XMIN} || $x > $h->{XMAX}; | ||
| 205 | |||
| 206 | my $nx = ( $x - $h->{XMIN} ) / $h->{DX}; | ||
| 207 | my $nx0 = int($nx); | ||
| 208 | my ( $y0, $y1, $ry0, $ry1 ); | ||
| 209 | if ( exists( $h->{Y} ) ) { | ||
| 210 | $y0 = $h->{Y}->[$nx0]; | ||
| 211 | $y1 = $h->{Y}->[ $nx0 + 1 ]; | ||
| 212 | return $y0 + ( $y1 - $y0 ) * ( $nx - $nx0 ); | ||
| 213 | } | ||
| 214 | else { | ||
| 215 | $y0 = $h->{Y0}->[$nx0]; | ||
| 216 | $y1 = $h->{Y0}->[ $nx0 + 1 ]; | ||
| 217 | $ry0 = ( $y1 - $y0 ) * ( $nx - $nx0 ); | ||
| 218 | |||
| 219 | $y0 = $h->{Y1}->[$nx0]; | ||
| 220 | $y1 = $h->{Y1}->[ $nx0 + 1 ]; | ||
| 221 | $ry1 = ( $y1 - $y0 ) * ( $nx - $nx0 ); | ||
| 222 | return ( $ry0, $ry1 ); | ||
| 223 | } | ||
| 224 | } | ||
| 225 | |||
| 226 | sub _PrintSummary { | ||
| 227 | my $self = shift; | ||
| 228 | my $a = shift; | ||
| 229 | my $opt = shift; | ||
| 230 | |||
| 231 | print "TekTDS Analysis Summary: Run ", $a->{RUN}, | ||
| 232 | " Event ", $a->{EVENT}, " Stream ", $a->{STREAM}, "\n"; | ||
| 233 | |||
| 234 | print "\nAnalysis Options:\n"; | ||
| 235 | foreach my $k ( sort( keys( %{ $a->{OPTIONS} } ) ) ) { | ||
| 236 | print "\t $k = ", $a->{OPTIONS}->{$k}, "\n"; | ||
| 237 | } | ||
| 238 | |||
| 239 | print "\nDAQ inline comments:\n"; | ||
| 240 | foreach my $c ( @{ $a->{COMMENT} } ) { | ||
| 241 | print "\t \"$c\"\n"; | ||
| 242 | } | ||
| 243 | |||
| 244 | print "\nChannels:"; | ||
| 245 | foreach my $ch ( sort( keys( %{ $a->{RAW}->{CHAN} } ) ) ) { | ||
| 246 | print " $ch"; | ||
| 247 | } | ||
| 248 | print "\n"; | ||
| 249 | |||
| 250 | foreach my $ch ( sort( keys( %{ $a->{RAW}->{CHAN} } ) ) ) { | ||
| 251 | print "Channel $ch info: \n"; | ||
| 252 | |||
| 253 | foreach my $k ( sort( keys( %{ $a->{RAW}->{CHAN}->{$ch} } ) ) ) { | ||
| 254 | next if $k =~ /\?$/; | ||
| 255 | next if $k eq 'CURV'; | ||
| 256 | my $key = sprintf( "%-18s", $k ); | ||
| 257 | print "\t$key : ", $a->{RAW}->{CHAN}->{$ch}->{$k}, "\n"; | ||
| 258 | } | ||
| 259 | print "\n"; | ||
| 260 | } | ||
| 261 | |||
| 262 | } | ||
| 263 | |||
| 264 | sub _extractWaveform { | ||
| 265 | my $enc = shift; | ||
| 266 | my $wd = shift; | ||
| 267 | my $dat = shift; | ||
| 268 | |||
| 269 | my (@result); | ||
| 270 | |||
| 271 | $enc =~ s/^\s*//; | ||
| 272 | |||
| 273 | if ( $enc =~ /^ASC/i ) { | ||
| 274 | @result = split( /,/, $dat ); | ||
| 275 | } | ||
| 276 | else { | ||
| 277 | if ( substr( $dat, 0, 2 ) !~ /^#\d/ ) { | ||
| 278 | croak("bad binary curve data"); | ||
| 279 | } | ||
| 280 | my $nx = substr( $dat, 1, 1 ); | ||
| 281 | my $n = substr( $dat, 2, $nx ); | ||
| 282 | my $form; | ||
| 283 | if ( $wd == 1 ) { | ||
| 284 | if ( $enc =~ /^RPB/i ) { | ||
| 285 | $form = 'C'; | ||
| 286 | } | ||
| 287 | else { | ||
| 288 | $form = 'c'; | ||
| 289 | } | ||
| 290 | } | ||
| 291 | else { | ||
| 292 | if ( $enc =~ /RPB/i ) { | ||
| 293 | $form = 'S'; # unsigned | ||
| 294 | } | ||
| 295 | else { | ||
| 296 | $form = 's'; # RIB signed | ||
| 297 | } | ||
| 298 | if ( $enc =~ /^S/i ) { # LSB first | ||
| 299 | $form .= '<'; | ||
| 300 | } | ||
| 301 | else { | ||
| 302 | $form .= '>'; # MSB first | ||
| 303 | } | ||
| 304 | } | ||
| 305 | $form .= '*'; | ||
| 306 | @result = unpack( $form, substr( $dat, $nx + 2 ) ); | ||
| 307 | } | ||
| 308 | return (@result); | ||
| 309 | } | ||
| 310 | |||
| 311 | 1; # End of Lab::Data::Analysis::TekTDS | ||
| 312 | |||
| 313 | __END__ |