Data/Analysis/TekTDS.pm untested

filter: Statementstmt 0.0% 0 / 234 Branchbran 0.0% 0 / 74 Conditioncond 0.0% 0 / 27 MC/DCmcdc 0.0% 0 / 18 Subroutinesub 0.0% 0 / 15 Podpod 0.0% 0 / 5 totaltotal 0.0% 0 / 373 CC 38 SCAR 60.0
CC
38
Cov
0%
Analyze
756.0
_extractWaveform
56.0
_interpolate
20.0
CRAP 402.7
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__