]> git.donarmstrong.com Git - lilypond.git/blob - buildscripts/output-distance.py
(test_basic_compare): add
[lilypond.git] / buildscripts / output-distance.py
1 #!@TARGET_PYTHON@
2 import sys
3 import optparse
4 import os
5
6 ## so we can call directly as buildscripts/output-distance.py
7 me_path = os.path.abspath (os.path.split (sys.argv[0])[0])
8 sys.path.insert (0, me_path + '/../python/')
9
10
11 import safeeval
12
13
14 X_AXIS = 0
15 Y_AXIS = 1
16 INFTY = 1e6
17
18 OUTPUT_EXPRESSION_PENALTY = 1
19 ORPHAN_GROB_PENALTY = 1
20 inspect_max_count = 0
21
22 def max_distance (x1, x2):
23     dist = 0.0
24
25     for (p,q) in zip (x1, x2):
26         dist = max (abs (p-q), dist)
27         
28     return dist
29
30
31 empty_interval = (INFTY, -INFTY)
32 empty_bbox = (empty_interval, empty_interval)
33
34 def interval_is_empty (i):
35     return i[0] > i[1]
36
37 def interval_length (i):
38     return max (i[1]-i[0], 0) 
39     
40 def interval_union (i1, i2):
41     return (min (i1[0], i2[0]),
42             max (i1[1], i2[1]))
43
44 def interval_intersect (i1, i2):
45     return (max (i1[0], i2[0]),
46             min (i1[1], i2[1]))
47
48 def bbox_is_empty (b):
49     return (interval_is_empty (b[0])
50             or interval_is_empty (b[1]))
51
52 def bbox_union (b1, b2):
53     return (interval_union (b1[X_AXIS], b2[X_AXIS]),
54             interval_union (b2[Y_AXIS], b2[Y_AXIS]))
55             
56 def bbox_intersection (b1, b2):
57     return (interval_intersect (b1[X_AXIS], b2[X_AXIS]),
58             interval_intersect (b2[Y_AXIS], b2[Y_AXIS]))
59
60 def bbox_area (b):
61     return interval_length (b[X_AXIS]) * interval_length (b[Y_AXIS])
62
63 def bbox_diameter (b):
64     return max (interval_length (b[X_AXIS]),
65                 interval_length (b[Y_AXIS]))
66                 
67
68 def difference_area (a, b):
69     return bbox_area (a) - bbox_area (bbox_intersection (a,b))
70
71 class GrobSignature:
72     def __init__ (self, exp_list):
73         (self.name, self.origin, bbox_x,
74          bbox_y, self.output_expression) = tuple (exp_list)
75         
76         self.bbox = (bbox_x, bbox_y)
77         self.centroid = (bbox_x[0] + bbox_x[1], bbox_y[0] + bbox_y[1])
78
79     def __repr__ (self):
80         return '%s: (%.2f,%.2f), (%.2f,%.2f)\n' % (self.name,
81                                                    self.bbox[0][0],
82                                                    self.bbox[0][1],
83                                                    self.bbox[1][0],
84                                                    self.bbox[1][1])
85                                                  
86     def axis_centroid (self, axis):
87         return apply (sum, self.bbox[axis])  / 2 
88     
89     def centroid_distance (self, other, scale):
90         return max_distance (self.centroid, other.centroid) / scale 
91         
92     def bbox_distance (self, other):
93         divisor = bbox_area (self.bbox) + bbox_area (other.bbox)
94
95         if divisor:
96             return (difference_area (self.bbox, other.bbox) +
97                     difference_area (other.bbox, self.bbox)) / divisor
98         else:
99             return 0.0
100         
101     def expression_distance (self, other):
102         if self.output_expression == other.output_expression:
103             return 0
104         else:
105             return 1
106
107 ################################################################
108 # single System.
109
110 class SystemSignature:
111     def __init__ (self, grob_sigs):
112         d = {}
113         for g in grob_sigs:
114             val = d.setdefault (g.name, [])
115             val += [g]
116
117         self.grob_dict = d
118         self.set_all_bbox (grob_sigs)
119
120     def set_all_bbox (self, grobs):
121         self.bbox = empty_bbox
122         for g in grobs:
123             self.bbox = bbox_union (g.bbox, self.bbox)
124
125     def closest (self, grob_name, centroid):
126         min_d = INFTY
127         min_g = None
128         try:
129             grobs = self.grob_dict[grob_name]
130
131             for g in grobs:
132                 d = max_distance (g.centroid, centroid)
133                 if d < min_d:
134                     min_d = d
135                     min_g = g
136
137
138             return min_g
139
140         except KeyError:
141             return None
142     def grobs (self):
143         return reduce (lambda x,y: x+y, self.grob_dict.values(), [])
144
145 ################################################################
146 ## comparison of systems.
147
148 class SystemLink:
149     def __init__ (self, system1, system2):
150         self.system1 = system1
151         self.system2 = system2
152         
153         self.link_list_dict = {}
154         self.back_link_dict = {}
155
156
157         ## pairs
158         self.orphans = []
159
160         ## pair -> distance
161         self.geo_distances = {}
162
163         ## pairs
164         self.expression_changed = []
165
166         self._geometric_distance = None
167         self._expression_change_count = None
168         self._orphan_count = None
169         
170         for g in system1.grobs ():
171
172             ## skip empty bboxes.
173             if bbox_is_empty (g.bbox):
174                 continue
175             
176             closest = system2.closest (g.name, g.centroid)
177             
178             self.link_list_dict.setdefault (closest, [])
179             self.link_list_dict[closest].append (g)
180             self.back_link_dict[g] = closest
181
182
183     def calc_geometric_distance (self):
184         total = 0.0
185         for (g1,g2) in self.back_link_dict.items ():
186             if g2:
187                 d = g1.bbox_distance (g2)
188                 if d:
189                     self.geo_distances[(g1,g2)] = d
190
191                 total += d
192
193         self._geometric_distance = total
194     
195     def calc_orphan_count (self):
196         count = 0
197         for (g1, g2) in self.back_link_dict.items ():
198             if g2 == None:
199                 self.orphans.append ((g1, None))
200                 
201                 count += 1
202
203         self._orphan_count = count
204     
205     def calc_output_exp_distance (self):
206         d = 0
207         for (g1,g2) in self.back_link_dict.items ():
208             if g2:
209                 d += g1.expression_distance (g2)
210
211         self._expression_change_count = d
212
213     def output_expression_details_string (self):
214         return ', '.join ([g1.name for g1 in self.expression_changed])
215     
216     def geo_details_string (self):
217         results = [(d, g1,g2) for ((g1, g2), d) in self.geo_distances.items()]
218         results.sort ()
219         results.reverse ()
220         
221         return ', '.join (['%s: %f' % (g1.name, d) for (d, g1, g2) in results])
222
223     def orphan_details_string (self):
224         return ', '.join (['%s-None' % g1.name for (g1,g2) in self.orphans if g2==None])
225
226     def geometric_distance (self):
227         if self._geometric_distance == None:
228             self.calc_geometric_distance ()
229         return self._geometric_distance
230     
231     def orphan_count (self):
232         if self._orphan_count == None:
233             self.calc_orphan_count ()
234             
235         return self._orphan_count
236     
237     def output_expression_change_count (self):
238         if self._expression_change_count == None:
239             self.calc_output_exp_distance ()
240         return self._expression_change_count
241         
242     def distance (self):
243         return (self.output_expression_change_count (),
244                 self.orphan_count (),
245                 self.geometric_distance ())
246     
247 def read_signature_file (name):
248     print 'reading', name
249     
250     entries = open (name).read ().split ('\n')
251     def string_to_tup (s):
252         return tuple (map (float, s.split (' '))) 
253
254     def string_to_entry (s):
255         fields = s.split('@')
256         fields[2] = string_to_tup (fields[2])
257         fields[3] = string_to_tup (fields[3])
258
259         return tuple (fields)
260     
261     entries = [string_to_entry (e) for e in entries
262                if e and not e.startswith ('#')]
263
264     grob_sigs = [GrobSignature (e) for e in entries]
265     sig = SystemSignature (grob_sigs)
266     return sig
267
268
269 ################################################################
270 # different systems of a .ly file.
271
272 class FileLink:
273     def __init__ (self):
274         self.original_name = ''
275         self.base_names = ('','')
276         self.system_links = {}
277         self._distance = None
278         
279     def add_system_link (self, link, number):
280         self.system_links[number] = link
281
282     def calc_distance (self):
283         d = 0.0
284
285         orphan_distance = 0.0
286         for l in self.system_links.values ():
287             d = max (d, l.geometric_distance ())
288             orphan_distance += l.orphan_count ()
289             
290         return d + orphan_distance
291
292     def distance (self):
293         if type (self._distance) != type (0.0):
294             return self.calc_distance ()
295         
296         return self._distance
297
298     def text_record_string (self):
299         return '%-30f %-20s\n' % (self.distance (),
300                              self.original_name)
301
302     def source_file (self):
303         for ext in ('.ly', '.ly.txt'):
304             if os.path.exists (self.base_names[1] + ext):
305                 return self.base_names[1] + ext
306         return ''
307     
308     def add_file_compare (self, f1, f2):
309         system_index = [] 
310
311         def note_system_index (m):
312             system_index.append (int (m.group (1)))
313             return ''
314         
315         base1 = re.sub ("-([0-9]+).signature", note_system_index, f1)
316         base2 = re.sub ("-([0-9]+).signature", note_system_index, f2)
317
318         self.base_names = (os.path.normpath (base1),
319                            os.path.normpath (base2))
320
321         def note_original (match):
322             self.original_name = match.group (1)
323             return ''
324         
325         if not self.original_name:
326             self.original_name = os.path.split (base1)[1]
327
328             ## ugh: drop the .ly.txt
329             for ext in ('.ly', '.ly.txt'):
330                 try:
331                     re.sub (r'\\sourcefilename "([^"]+)"',
332                             note_original, open (base1 + ext).read ())
333                 except IOError:
334                     pass
335                 
336         s1 = read_signature_file (f1)
337         s2 = read_signature_file (f2)
338
339         link = SystemLink (s1, s2)
340
341         self.add_system_link (link, system_index[0])
342
343     def link_files_for_html (self, old_dir, new_dir, dest_dir):
344         for ext in ('.png', '.ly', '-page*png'):
345             for oldnew in (0,1):
346                 for f in glob.glob (self.base_names[oldnew] + ext):
347                     print f
348                     link_file (f, dest_dir + '/' + f)
349
350     def html_record_string (self,  old_dir, new_dir):
351         def img_cell (ly, img, name):
352             if not name:
353                 name = 'source'
354             else:
355                 name = '<tt>%s</tt>' % name
356                 
357             return '''
358 <td align="center">
359 <a href="%(img)s">
360 <img src="%(img)s" style="border-style: none; max-width: 500px;">
361 </a><br>
362 <font size="-2">(<a href="%(ly)s">%(name)s</a>)
363 </font>
364 </td>
365 ''' % locals ()
366
367         def multi_img_cell (ly, imgs, name):
368             if not name:
369                 name = 'source'
370             else:
371                 name = '<tt>%s</tt>' % name
372
373             imgs_str = '\n'.join (['''<a href="%s">
374 <img src="%s" style="border-style: none; max-width: 500px;">
375 </a><br>''' % (img, img) 
376                                   for img in imgs])
377
378
379             return '''
380 <td align="center">
381 %(imgs_str)s
382 <font size="-2">(<a href="%(ly)s">%(name)s</a>)
383 </font>
384 </td>
385 ''' % locals ()
386
387
388
389         def cell (base, name):
390             pages = glob.glob (base + '-page*.png')
391             
392             if pages:
393                 return multi_img_cell (base + '.ly', sorted (pages), name)
394             else:
395                 return img_cell (base + '.ly', base + '.png', name)
396             
397
398         img_1  = self.base_names[0] + '.png'
399         ly_1  = self.base_names[0] + '.ly'
400         img_2  = self.base_names[1] + '.png'
401         ly_2  = self.base_names[1] + '.ly'
402         html_2  = self.base_names[1] + '.html'
403         name = self.original_name
404         
405         html_entry = '''
406 <tr>
407 <td>
408 %f<br>
409 (<a href="%s">details</a>)
410 </td>
411
412 %s
413 %s
414 </tr>
415 ''' % (self.distance (), html_2,
416        cell (self.base_names[0], name),
417        cell (self.base_names[1], name))
418
419         return html_entry
420
421
422     def html_system_details_string (self):
423         systems = self.system_links.items ()
424         systems.sort ()
425
426         html = ""
427         for (c, link) in systems:
428             e = '<td>%d</td>' % c
429             for d in link.distance ():
430                 e += '<td>%f</td>' % d
431             
432             e = '<tr>%s</tr>' % e
433
434             html += e
435
436             e = '<td>%d</td>' % c
437             for s in (link.output_expression_details_string (),
438                       link.orphan_details_string (),
439                       link.geo_details_string ()):
440                 e += "<td>%s</td>" % s
441
442             
443             e = '<tr>%s</tr>' % e
444             html += e
445             
446         original = self.original_name
447         html = '''<html>
448 <head>
449 <title>comparison details for %(original)s</title>
450 </head>
451 <body>
452 <table border=1>
453 <tr>
454 <th>system</th>
455 <th>output</th>
456 <th>orphan</th>
457 <th>geo</th>
458 </tr>
459
460 %(html)s
461 </table>
462
463 </body>
464 </html>
465 ''' % locals ()
466         return html
467
468     def write_html_system_details (self, dir1, dir2, dest_dir):
469         dest_file =  os.path.join (dest_dir, self.base_names[1] + '.html')
470
471         details = open_write_file (dest_file)
472         details.write (self.html_system_details_string ())
473
474 ################################################################
475 # Files/directories
476
477 import glob
478 import re
479
480
481
482 def compare_signature_files (f1, f2):
483     s1 = read_signature_file (f1)
484     s2 = read_signature_file (f2)
485     
486     return SystemLink (s1, s2).distance ()
487
488 def paired_files (dir1, dir2, pattern):
489     """
490     Search DIR1 and DIR2 for PATTERN.
491
492     Return (PAIRED, MISSING-FROM-2, MISSING-FROM-1)
493
494     """
495     
496     files1 = dict ((os.path.split (f)[1], 1) for f in glob.glob (dir1 + '/' + pattern))
497     files2 = dict ((os.path.split (f)[1], 1) for f in glob.glob (dir2 + '/' + pattern))
498
499     pairs = []
500     missing = []
501     for f in files1.keys ():
502         try:
503             files2.pop (f)
504             pairs.append (f)
505         except KeyError:
506             missing.append (f)
507
508     return (pairs, files2.keys (), missing)
509     
510 class ComparisonData:
511     def __init__ (self):
512         self.result_dict = {}
513         self.missing = []
514         self.added = []
515         self.file_links = {}
516
517     def compare_trees (self, dir1, dir2):
518         self.compare_directories (dir1, dir2)
519         
520         (root, dirs, files) = os.walk (dir1).next ()
521         for d in dirs:
522             d1 = os.path.join (dir1, d)
523             d2 = os.path.join (dir2, d)
524
525             if os.path.islink (d1) or os.path.islink (d2):
526                 continue
527             
528             if os.path.isdir (d2):
529                 self.compare_trees (d1, d2)
530     
531     def compare_directories (self, dir1, dir2):
532
533         (paired, m1, m2) = paired_files (dir1, dir2, '*.signature')
534
535         self.missing += [(dir1, m) for m in m1] 
536         self.added += [(dir2, m) for m in m2] 
537
538         for p in paired:
539             if (inspect_max_count
540                 and len (self.file_links) > inspect_max_count):
541                 
542                 continue
543             
544             f2 = dir2 +  '/' + p
545             f1 = dir1 +  '/' + p
546             self.compare_files (f1, f2)
547
548     def compare_files (self, f1, f2):
549         name = os.path.split (f1)[1]
550         name = re.sub ('-[0-9]+.signature', '', name)
551         
552         file_link = None
553         try:
554             file_link = self.file_links[name]
555         except KeyError:
556             file_link = FileLink ()
557             self.file_links[name] = file_link
558
559         file_link.add_file_compare (f1,f2)
560
561     def write_text_result_page (self, filename, threshold):
562         print 'writing "%s"' % filename
563         out = None
564         if filename == '':
565             out = sys.stdout
566         else:
567             out = open_write_file (filename)
568
569         ## todo: support more scores.
570         results = [(link.distance(), link)
571                    for link in self.file_links.values ()]
572         results.sort ()
573         results.reverse ()
574
575         
576         for (score, link) in results:
577             if score > threshold:
578                 out.write (link.text_record_string ())
579
580         out.write ('\n\n')
581         out.write ('%d below threshold\n' % len ([1 for s,l  in results
582                                                     if threshold >=  s > 0.0]))
583         out.write ('%d unchanged\n' % len ([1 for (s,l) in results if s == 0.0]))
584         
585     def create_text_result_page (self, dir1, dir2, dest_dir, threshold):
586         self.write_text_result_page (dest_dir + '/index.txt', threshold)
587         
588     def create_html_result_page (self, dir1, dir2, dest_dir, threshold):
589         dir1 = dir1.replace ('//', '/')
590         dir2 = dir2.replace ('//', '/')
591         
592         results = [(link.distance(), link)
593                    for link in self.file_links.values ()]
594         results.sort ()
595         results.reverse ()
596
597         html = ''
598         old_prefix = os.path.split (dir1)[1]
599         for (score, link) in results:
600             if score <= threshold:
601                 continue
602
603             link.link_files_for_html (dir1, dir2, dest_dir) 
604             link.write_html_system_details (dir1, dir2, dest_dir)
605             html += link.html_record_string (dir1, dir2)
606
607
608         html = '''<html>
609 <table rules="rows" border bordercolor="blue">
610 <tr>
611 <th>distance</th>
612 <th>%(dir1)s</th>
613 <th>%(dir2)s</th>
614 </tr>
615 %(html)s
616 </table>
617 </html>''' % locals()
618
619         html += ('<p>')
620         below_count  =len ([1 for s,l  in results
621                             if threshold >=  s > 0.0])
622
623         if below_count:
624             html += ('<p>%d below threshold</p>' % below_count)
625
626         html += ('<p>%d unchanged</p>'
627                  % len ([1 for (s,l) in results if s == 0.0]))
628
629
630         dest_file = dest_dir + '/index.html'
631         open_write_file (dest_file).write (html)
632         
633     def print_results (self, threshold):
634         self.write_text_result_page ('', threshold)
635
636 def compare_trees (dir1, dir2, dest_dir, threshold):
637     data = ComparisonData ()
638     data.compare_trees (dir1, dir2)
639     data.print_results (threshold)
640
641     if os.path.isdir (dest_dir):
642         system ('rm -rf %s '% dest_dir)
643
644     data.create_html_result_page (dir1, dir2, dest_dir, threshold)
645     data.create_text_result_page (dir1, dir2, dest_dir, threshold)
646     
647 ################################################################
648 # TESTING
649
650 def mkdir (x):
651     if not os.path.isdir (x):
652         print 'mkdir', x
653         os.makedirs (x)
654
655 def link_file (x, y):
656     mkdir (os.path.split (y)[0])
657     try:
658         os.link (x, y)
659     except OSError, z:
660         print 'OSError', x, y, z
661         raise OSError
662     
663 def open_write_file (x):
664     d = os.path.split (x)[0]
665     mkdir (d)
666     return open (x, 'w')
667
668
669 def system (x):
670     
671     print 'invoking', x
672     stat = os.system (x)
673     assert stat == 0
674
675
676 def test_paired_files ():
677     print paired_files (os.environ["HOME"] + "/src/lilypond/scripts/",
678                         os.environ["HOME"] + "/src/lilypond-stable/buildscripts/", '*.py')
679                   
680     
681 def test_compare_trees ():
682     system ('rm -rf dir1 dir2')
683     system ('mkdir dir1 dir2')
684     system ('cp 20{-*.signature,.ly,.png} dir1')
685     system ('cp 20{-*.signature,.ly,.png} dir2')
686     system ('cp 20expr{-*.signature,.ly,.png} dir1')
687     system ('cp 19{-*.signature,.ly,.png} dir2/')
688     system ('cp 19{-*.signature,.ly,.png} dir1/')
689     system ('cp 19-1.signature 19-sub-1.signature')
690     system ('cp 19.ly 19-sub.ly')
691     system ('cp 19.png 19-sub.png')
692
693     system ('cp 20multipage* dir1')
694     system ('cp 20multipage* dir2')
695     system ('cp 19multipage-1.signature dir2/20multipage-1.signature')
696
697     
698     system ('mkdir -p dir1/subdir/ dir2/subdir/')
699     system ('cp 19-sub{-*.signature,.ly,.png} dir1/subdir/')
700     system ('cp 19-sub{-*.signature,.ly,.png} dir2/subdir/')
701     system ('cp 20grob{-*.signature,.ly,.png} dir2/')
702     system ('cp 20grob{-*.signature,.ly,.png} dir1/')
703
704     ## introduce differences
705     system ('cp 19-1.signature dir2/20-1.signature')
706     system ('cp 20-1.signature dir2/subdir/19-sub-1.signature')
707
708     ## radical diffs.
709     system ('cp 19-1.signature dir2/20grob-1.signature')
710     system ('cp 19-1.signature dir2/20grob-2.signature')
711
712     compare_trees ('dir1', 'dir2', 'compare-dir1dir2', 0.5)
713
714
715 def test_basic_compare ():
716     ly_template = r"""
717 #(set! toplevel-score-handler print-score-with-defaults)
718  #(set! toplevel-music-handler
719   (lambda (p m)
720   (if (not (eq? (ly:music-property m 'void) #t))
721      (print-score-with-defaults
722      p (scorify-music m p)))))
723
724 \sourcefilename "my-source.ly"
725  
726 %(papermod)s
727 \header { tagline = ##f } 
728 <<
729 \new Staff \relative c {
730   c4^"%(userstring)s" %(extragrob)s
731   }
732 \new Staff \relative c {
733   c4^"%(userstring)s" %(extragrob)s
734   }
735 >>
736 """
737
738     dicts = [{ 'papermod' : '',
739                'name' : '20',
740                'extragrob': '',
741                'userstring': 'test' },
742              { 'papermod' : '#(set-global-staff-size 19.5)',
743                'name' : '19',
744                'extragrob': '',
745                'userstring': 'test' },
746              { 'papermod' : '',
747                'name' : '20expr',
748                'extragrob': '',
749                'userstring': 'blabla' },
750              { 'papermod' : '',
751                'name' : '20grob',
752                'extragrob': 'r2. \\break c1',
753                'userstring': 'test' },
754                 
755              ]
756
757     for d in dicts:
758         open (d['name'] + '.ly','w').write (ly_template % d)
759         
760     names = [d['name'] for d in dicts]
761     
762     system ('lilypond -ddump-signatures --png -b eps ' + ' '.join (names))
763     
764
765     multipage_str = r'''
766     #(set-default-paper-size "a6")
767     {c1 \pageBreak c1 }
768     '''
769
770     open ('20multipage', 'w').write (multipage_str)
771     open ('19multipage', 'w').write ('#(set-global-staff-size 19.5)\n' + multipage_str)
772     system ('lilypond -ddump-signatures --png 19multipage 20multipage ')
773  
774     test_compare_signatures (names)
775     
776 def test_compare_signatures (names, timing=False):
777
778     import time
779
780     times = 1
781     if timing:
782         times = 100
783
784     t0 = time.clock ()
785
786     count = 0
787     for t in range (0, times):
788         sigs = dict ((n, read_signature_file ('%s-1.signature' % n)) for n in names)
789         count += 1
790
791     if timing:
792         print 'elapsed', (time.clock() - t0)/count
793
794
795     t0 = time.clock ()
796     count = 0
797     combinations = {}
798     for (n1, s1) in sigs.items():
799         for (n2, s2) in sigs.items():
800             combinations['%s-%s' % (n1, n2)] = SystemLink (s1,s2).distance ()
801             count += 1
802
803     if timing:
804         print 'elapsed', (time.clock() - t0)/count
805
806     results = combinations.items ()
807     results.sort ()
808     for k,v in results:
809         print '%-20s' % k, v
810
811     assert combinations['20-20'] == (0.0,0.0,0.0)
812     assert combinations['20-20expr'][0] > 0.0
813     assert combinations['20-19'][2] < 10.0
814     assert combinations['20-19'][2] > 0.0
815
816
817 def run_tests ():
818     dir = 'output-distance-test'
819
820     do_clean = not os.path.exists (dir)
821
822     print 'test results in ', dir
823     if do_clean:
824         system ('rm -rf ' + dir)
825         system ('mkdir ' + dir)
826         
827     os.chdir (dir)
828     if do_clean:
829         test_basic_compare ()
830         
831     test_compare_trees ()
832     
833 ################################################################
834 #
835
836 def main ():
837     p = optparse.OptionParser ("output-distance - compare LilyPond formatting runs")
838     p.usage = 'output-distance.py [options] tree1 tree2'
839     
840     p.add_option ('', '--test-self',
841                   dest="run_test",
842                   action="store_true",
843                   help='run test method')
844     
845     p.add_option ('--max-count',
846                   dest="max_count",
847                   metavar="COUNT",
848                   type="int",
849                   default=0, 
850                   action="store",
851                   help='only analyze COUNT signature pairs')
852
853     p.add_option ('', '--threshold',
854                   dest="threshold",
855                   default=0.3,
856                   action="store",
857                   type="float",
858                   help='threshold for geometric distance')
859
860     (o,a) = p.parse_args ()
861
862     if o.run_test:
863         run_tests ()
864         sys.exit (0)
865
866     if len (a) != 2:
867         p.print_usage()
868         sys.exit (2)
869
870     global inspect_max_count
871     inspect_max_count = o.max_count
872
873     compare_trees (a[0], a[1], os.path.join (a[1],  'compare-' +  a[0]),
874                    o.threshold)
875
876 if __name__ == '__main__':
877     main()
878