megadetector 5.0.28__py3-none-any.whl → 5.0.29__py3-none-any.whl

megadetector/visualization/visualize_detector_output.py

@@ -54,11 +54,11 @@ def _render_image(entry,
     """
     Internal function for rendering a single image.
     """
-    
+
     rendering_result = {'failed_image':False,'missing_image':False,
                         'skipped_image':False,'annotated_image_path':None,
                         'max_conf':None,'file':entry['file']}
-    
+
     image_id = entry['file']
 
     if 'failure' in entry and entry['failure'] is not None:
@@ -66,14 +66,14 @@ def _render_image(entry,
         return rendering_result
 
     assert 'detections' in entry and entry['detections'] is not None
-    
+
     max_conf = get_max_conf(entry)
     rendering_result['max_conf'] = max_conf
-    
+
     if (max_conf < confidence_threshold) and render_detections_only:
         rendering_result['skipped_image'] = True
         return rendering_result
-    
+
     if images_dir is None:
         image_filename_in_abs = image_id
         assert path_is_abs(image_filename_in_abs), \
@@ -89,7 +89,7 @@ def _render_image(entry,
 
     # Load the image
     image = vis_utils.open_image(image_filename_in_abs)
-    
+
     # Find categories we're supposed to blur
     category_ids_to_blur = []
     if category_names_to_blur is not None:
@@ -98,21 +98,21 @@ def _render_image(entry,
         for category_id in detector_label_map:
             if detector_label_map[category_id] in category_names_to_blur:
                 category_ids_to_blur.append(category_id)
-    
+
     detections_to_blur = []
     for d in entry['detections']:
         if d['conf'] >= confidence_threshold and d['category'] in category_ids_to_blur:
             detections_to_blur.append(d)
     if len(detections_to_blur) > 0:
         blur_detections(image,detections_to_blur)
-        
+
     # Resize if necessary
     #
     # If output_image_width is -1 or None, this will just return the original image
     image = vis_utils.resize_image(image, output_image_width)
 
     vis_utils.render_detection_bounding_boxes(
-        entry['detections'], image, 
+        entry['detections'], image,
         label_map=detector_label_map,
         classification_label_map=classification_label_map,
         confidence_threshold=confidence_threshold,
@@ -127,9 +127,9 @@ def _render_image(entry,
         assert not os.path.isabs(image_id), "Can't preserve paths when operating on absolute paths"
         annotated_img_path = os.path.join(out_dir, image_id)
         os.makedirs(os.path.dirname(annotated_img_path),exist_ok=True)
-        
+
     image.save(annotated_img_path)
-    rendering_result['annotated_image_path'] = annotated_img_path        
+    rendering_result['annotated_image_path'] = annotated_img_path
 
     return rendering_result
 
@@ -155,14 +155,13 @@ def visualize_detector_output(detector_output_path,
                               parallelize_rendering_with_threads=True,
                               box_sort_order=None,
                               category_names_to_blur=None):
-    
     """
     Draws bounding boxes on images given the output of a detector.
 
     Args:
         detector_output_path (str): path to detector output .json file
         out_dir (str): path to directory for saving annotated images
-        images_dir (str): folder where the images live; filenames in 
+        images_dir (str): folder where the images live; filenames in
             [detector_output_path] should be relative to [image_dir].  Can be None if paths are
             absolute.
         confidence_threshold (float, optional): threshold above which detections will be rendered
@@ -178,17 +177,17 @@ def visualize_detector_output(detector_output_path,
             classification labels (not detection categories) are displayed
         html_output_file (str, optional): output path for an HTML index file (not written
             if None)
-        html_output_options (dict, optional): HTML formatting options; see write_html_image_list 
-            for details.  The most common option you may want to supply here is 
+        html_output_options (dict, optional): HTML formatting options; see write_html_image_list
+            for details.  The most common option you may want to supply here is
             'maxFiguresPerHtmlFile'.
         preserve_path_structure (bool, optional): if False (default), writes images to unique
             names in a flat structure in the output folder; if True, preserves relative paths
             within the output folder
         parallelize_rendering (bool, optional): whether to use concurrent workers for rendering
-        parallelize_rendering_n_cores (int, optional): number of concurrent workers to use 
+        parallelize_rendering_n_cores (int, optional): number of concurrent workers to use
             (ignored if parallelize_rendering is False)
         parallelize_rendering_with_threads (bool, optional): determines whether we use
-            threads (True) or processes (False) for parallelization (ignored if parallelize_rendering 
+            threads (True) or processes (False) for parallelization (ignored if parallelize_rendering
             is False)
         box_sort_order (str, optional): sorting scheme for detection boxes, can be None, "confidence", or
             "reverse_confidence"
@@ -198,11 +197,11 @@ def visualize_detector_output(detector_output_path,
     Returns:
         list: list of paths to annotated images
     """
-    
+
     assert os.path.exists(detector_output_path), \
         'Detector output file does not exist at {}'.format(detector_output_path)
 
-    if images_dir is not None:        
+    if images_dir is not None:
         assert os.path.isdir(images_dir), \
             'Image folder {} is not available'.format(images_dir)
 
@@ -212,15 +211,15 @@ def visualize_detector_output(detector_output_path,
     ##%% Load detector output
 
     detector_output = load_md_or_speciesnet_file(detector_output_path)
-    
+
     images = detector_output['images']
-    
+
     if confidence_threshold is None:
         confidence_threshold = get_typical_confidence_threshold_from_results(detector_output)
-        
+
     assert confidence_threshold >= 0 and confidence_threshold <= 1, \
         f'Confidence threshold {confidence_threshold} is invalid, must be in (0, 1).'
-    
+
     if 'detection_categories' in detector_output:
         detector_label_map = detector_output['detection_categories']
     else:
@@ -244,77 +243,84 @@ def visualize_detector_output(detector_output_path,
 
     print('Rendering detections above a confidence threshold of {}'.format(
         confidence_threshold))
-    
+
     classification_label_map = None
-    
+
     if 'classification_categories' in detector_output:
         classification_label_map = detector_output['classification_categories']
-        
+
     rendering_results = []
-    
+
     if parallelize_rendering:
-        
+
         if parallelize_rendering_with_threads:
             worker_string = 'threads'
         else:
             worker_string = 'processes'
-            
-        if parallelize_rendering_n_cores is None:
-            if parallelize_rendering_with_threads:
-                pool = ThreadPool()
-            else:
-                pool = Pool()
-        else:
-            if parallelize_rendering_with_threads:
-                pool = ThreadPool(parallelize_rendering_n_cores)
+
+        pool = None
+        try:
+            if parallelize_rendering_n_cores is None:
+                if parallelize_rendering_with_threads:
+                    pool = ThreadPool()
+                else:
+                    pool = Pool()
             else:
-                pool = Pool(parallelize_rendering_n_cores)
-            print('Rendering images with {} {}'.format(parallelize_rendering_n_cores,
-                                                       worker_string))            
-        rendering_results = list(tqdm(pool.imap(
-                                 partial(_render_image,detector_label_map=detector_label_map,
-                                         classification_label_map=classification_label_map,
-                                         confidence_threshold=confidence_threshold,
-                                         classification_confidence_threshold=classification_confidence_threshold,
-                                         render_detections_only=render_detections_only,
-                                         preserve_path_structure=preserve_path_structure,
-                                         out_dir=out_dir,
-                                         images_dir=images_dir,
-                                         output_image_width=output_image_width,
-                                         box_sort_order=box_sort_order,
-                                         category_names_to_blur=category_names_to_blur),
-                                 images), total=len(images)))
-        
+                if parallelize_rendering_with_threads:
+                    pool = ThreadPool(parallelize_rendering_n_cores)
+                else:
+                    pool = Pool(parallelize_rendering_n_cores)
+                print('Rendering images with {} {}'.format(parallelize_rendering_n_cores,
+                                                           worker_string))
+            rendering_results = list(tqdm(pool.imap(
+                                     partial(_render_image,detector_label_map=detector_label_map,
+                                             classification_label_map=classification_label_map,
+                                             confidence_threshold=confidence_threshold,
+                                             classification_confidence_threshold=classification_confidence_threshold,
+                                             render_detections_only=render_detections_only,
+                                             preserve_path_structure=preserve_path_structure,
+                                             out_dir=out_dir,
+                                             images_dir=images_dir,
+                                             output_image_width=output_image_width,
+                                             box_sort_order=box_sort_order,
+                                             category_names_to_blur=category_names_to_blur),
+                                     images), total=len(images)))
+        finally:
+            if pool is not None:
+                pool.close()
+                pool.join()
+                print("Pool closed and joined for detector output visualization")
+
     else:
-                
+
         for entry in tqdm(images):
-            
+
             rendering_result = _render_image(entry,detector_label_map,classification_label_map,
                                             confidence_threshold,classification_confidence_threshold,
                                             render_detections_only,preserve_path_structure,out_dir,
                                             images_dir,output_image_width,box_sort_order,
                                             category_names_to_blur=category_names_to_blur)
             rendering_results.append(rendering_result)
-        
+
     # ...for each image
-    
+
     failed_images = [r for r in rendering_results if r['failed_image']]
     missing_images = [r for r in rendering_results if r['missing_image']]
     skipped_images = [r for r in rendering_results if r['skipped_image']]
-    
+
     print('Skipped {} failed images (of {})'.format(len(failed_images),len(images)))
     print('Skipped {} missing images (of {})'.format(len(missing_images),len(images)))
     print('Skipped {} below-threshold images (of {})'.format(len(skipped_images),len(images)))
-    
+
     print(f'Rendered detection results to {out_dir}')
 
     annotated_image_paths = [r['annotated_image_path'] for r in rendering_results if \
                              r['annotated_image_path'] is not None]
-    
+
     if html_output_file is not None:
-        
+
         html_dir = os.path.dirname(html_output_file)
-        
+
         html_image_info = []
 
         for r in rendering_results:
@@ -329,10 +335,10 @@ def visualize_detector_output(detector_output_path,
                  'text-align:left;margin-top:20;margin-bottom:5'
             d['title'] = '{} (max conf: {})'.format(r['file'],r['max_conf'])
             html_image_info.append(d)
-            
+
         _ = write_html_image_list.write_html_image_list(html_output_file,html_image_info,
                                                     options=html_output_options)
-        
+
     return annotated_image_paths
 
 # ...def visualize_detector_output(...)
@@ -340,8 +346,8 @@ def visualize_detector_output(detector_output_path,
 
 #%% Command-line driver
 
-def main():
-    
+def main(): # noqa
+
     parser = argparse.ArgumentParser(
         formatter_class=argparse.ArgumentDefaultsHelpFormatter,
         description='Annotate the bounding boxes predicted by a detector above '
@@ -399,11 +405,11 @@ def main():
         parser.exit()
 
     args = parser.parse_args()
-    
+
     category_names_to_blur = args.category_names_to_blur
     if category_names_to_blur is not None:
         category_names_to_blur = category_names_to_blur.split(',')
-    
+
     visualize_detector_output(
         detector_output_path=args.detector_output_path,
         out_dir=args.out_dir,
@@ -429,12 +435,12 @@ if __name__ == '__main__':
 #%% Interactive driver
 
 if False:
-    
+
     pass
 
     #%%
-    
-    detector_output_path = os.path.expanduser('~/postprocessing/bellevue-camera-traps/bellevue-camera-traps-2023-12-05-v5a.0.0/combined_api_outputs/bellevue-camera-traps-2023-12-05-v5a.0.0_detections.json')
+
+    detector_output_path = os.path.expanduser('detections.json')
     out_dir = r'g:\temp\preview'
     images_dir = r'g:\camera_traps\camera_trap_images'
     confidence_threshold = 0.15
@@ -465,6 +471,6 @@ if False:
                               parallelize_rendering,
                               parallelize_rendering_n_cores,
                               parallelize_rendering_with_threads)
-    
+
     from megadetector.utils.path_utils import open_file
     open_file(html_output_file)

{megadetector-5.0.28.dist-info → megadetector-5.0.29.dist-info}/METADATA

@@ -1,132 +1,135 @@
-Metadata-Version: 2.4
-Name: megadetector
-Version: 5.0.28
-Summary: MegaDetector is an AI model that helps conservation folks spend less time doing boring things with camera trap images.
-Author-email: Your friendly neighborhood MegaDetector team <cameratraps@lila.science>
-Maintainer-email: Your friendly neighborhood MegaDetector team <cameratraps@lila.science>
-License:     MIT License
-        
-            Permission is hereby granted, free of charge, to any person obtaining a copy
-            of this software and associated documentation files (the "Software"), to deal
-            in the Software without restriction, including without limitation the rights
-            to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-            copies of the Software, and to permit persons to whom the Software is
-            furnished to do so, subject to the following conditions:
-        
-            The above copyright notice and this permission notice shall be included in all
-            copies or substantial portions of the Software.
-        
-            THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-            IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-            FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-            AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-            LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-            OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-            SOFTWARE.
-        
-Project-URL: Homepage, https://github.com/agentmorris/MegaDetector
-Project-URL: Documentation, https://megadetector.readthedocs.io
-Project-URL: Bug Reports, https://github.com/agentmorris/MegaDetector/issues
-Project-URL: Source, https://github.com/agentmorris/MegaDetector
-Keywords: camera traps,conservation,wildlife,ai,megadetector
-Classifier: Programming Language :: Python :: 3
-Requires-Python: <3.14,>=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: mkl==2024.0; sys_platform != "darwin"
-Requires-Dist: numpy>=1.26.4
-Requires-Dist: Pillow>=9.5
-Requires-Dist: tqdm>=4.64.0
-Requires-Dist: jsonpickle>=3.0.2
-Requires-Dist: humanfriendly>=10.0
-Requires-Dist: matplotlib>=3.8.0
-Requires-Dist: opencv-python>=4.8.0
-Requires-Dist: requests>=2.31.0
-Requires-Dist: pyqtree>=1.0.0
-Requires-Dist: scikit-learn>=1.3.1
-Requires-Dist: pandas>=2.1.1
-Requires-Dist: python-dateutil
-Requires-Dist: send2trash
-Requires-Dist: dill
-Requires-Dist: ultralytics-yolov5==0.1.1
-Requires-Dist: yolov9pip==0.0.4
-Requires-Dist: python-dateutil
-Dynamic: license-file
-
-# MegaDetector
-
-This package is a pip-installable version of the support/inference code for [MegaDetector](https://github.com/agentmorris/MegaDetector/?tab=readme-ov-file#megadetector), an object detection model that helps conservation biologists spend less time doing boring things with camera trap images.  Complete documentation for this Python package is available at [megadetector.readthedocs.io](https://megadetector.readthedocs.io).
-
-If you aren't looking for the Python package specifically, and you just want to learn more about what MegaDetector is all about, head over to the [MegaDetector repo](https://github.com/agentmorris/MegaDetector/?tab=readme-ov-file#megadetector).
-
-If you don't want to run MegaDetector, and you just want to use the utilities in this package - postprocessing, manipulating large volumes of camera trap images, etc. - you may want to check out the [megadetector-utils](https://pypi.org/project/megadetector-utils/) package, which is identical to this one, but excludes all of the PyTorch/YOLO dependencies, and is thus approximately one zillion times smaller.
-
-## Installation
-
-Install with:
-
-`pip install megadetector`
-
-MegaDetector model weights aren't downloaded at the time you install the package, but they will be (optionally) automatically downloaded the first time you run the model.
-
-## Package reference
-
-See [megadetector.readthedocs.io](https://megadetector.readthedocs.io).
-
-
-## Examples of things you can do with this package
-
-### Run MegaDetector on one image and count the number of detections
-
-```
-from megadetector.utils import url_utils
-from megadetector.visualization import visualization_utils as vis_utils
-from megadetector.detection import run_detector
-
-# This is the image at the bottom of this page, it has one animal in it
-image_url = 'https://github.com/agentmorris/MegaDetector/raw/main/images/orinoquia-thumb-web.jpg'
-temporary_filename = url_utils.download_url(image_url)
-
-image = vis_utils.load_image(temporary_filename)
-
-# This will automatically download MDv5a; you can also specify a filename.
-model = run_detector.load_detector('MDV5A')
-
-result = model.generate_detections_one_image(image)
-
-detections_above_threshold = [d for d in result['detections'] if d['conf'] > 0.2]
-print('Found {} detections above threshold'.format(len(detections_above_threshold)))
-```
-
-### Run MegaDetector on a folder of images
-
-```
-from megadetector.detection.run_detector_batch import \
-    load_and_run_detector_batch, write_results_to_file
-from megadetector.utils import path_utils
-import os
-
-# Pick a folder to run MD on recursively, and an output file
-image_folder = os.path.expanduser('~/megadetector_test_images')
-output_file = os.path.expanduser('~/megadetector_output_test.json')
-
-# Recursively find images
-image_file_names = path_utils.find_images(image_folder,recursive=True)
-
-# This will automatically download MDv5a; you can also specify a filename.
-results = load_and_run_detector_batch('MDV5A', image_file_names)
-
-# Write results to a format that Timelapse and other downstream tools like.
-write_results_to_file(results,
-                      output_file,
-                      relative_path_base=image_folder,
-                      detector_file=detector_filename)
-```
-
-## Contact
-
-Contact <a href="cameratraps@lila.science">cameratraps@lila.science</a> with questions.
-
-## Gratuitous animal picture
-
-<img src="https://github.com/agentmorris/MegaDetector/raw/main/images/orinoquia-thumb-web_detections.jpg"><br/>Image credit University of Minnesota, from the [Orinoquía Camera Traps](http://lila.science/datasets/orinoquia-camera-traps/) data set.
+Metadata-Version: 2.4
+Name: megadetector
+Version: 5.0.29
+Summary: MegaDetector is an AI model that helps conservation folks spend less time doing boring things with camera trap images.
+Author-email: Your friendly neighborhood MegaDetector team <cameratraps@lila.science>
+Maintainer-email: Your friendly neighborhood MegaDetector team <cameratraps@lila.science>
+License:     MIT License
+        
+            Permission is hereby granted, free of charge, to any person obtaining a copy
+            of this software and associated documentation files (the "Software"), to deal
+            in the Software without restriction, including without limitation the rights
+            to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+            copies of the Software, and to permit persons to whom the Software is
+            furnished to do so, subject to the following conditions:
+        
+            The above copyright notice and this permission notice shall be included in all
+            copies or substantial portions of the Software.
+        
+            THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+            IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+            FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+            AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+            LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+            OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+            SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/agentmorris/MegaDetector
+Project-URL: Documentation, https://megadetector.readthedocs.io
+Project-URL: Bug Reports, https://github.com/agentmorris/MegaDetector/issues
+Project-URL: Source, https://github.com/agentmorris/MegaDetector
+Keywords: camera traps,conservation,wildlife,ai,megadetector
+Classifier: Programming Language :: Python :: 3
+Requires-Python: <3.14,>=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mkl==2024.0; sys_platform != "darwin"
+Requires-Dist: numpy>=1.26.4
+Requires-Dist: Pillow>=9.5
+Requires-Dist: tqdm>=4.64.0
+Requires-Dist: jsonpickle>=3.0.2
+Requires-Dist: humanfriendly>=10.0
+Requires-Dist: matplotlib>=3.8.0
+Requires-Dist: opencv-python>=4.8.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: pyqtree>=1.0.0
+Requires-Dist: scikit-learn>=1.3.1
+Requires-Dist: pandas>=2.1.1
+Requires-Dist: python-dateutil
+Requires-Dist: send2trash
+Requires-Dist: python-dateutil
+Requires-Dist: clipboard
+Requires-Dist: dill
+Requires-Dist: ruff
+Requires-Dist: pytest
+Requires-Dist: ultralytics-yolov5==0.1.1
+Requires-Dist: yolov9pip==0.0.4
+Dynamic: license-file
+
+# MegaDetector
+
+This package is a pip-installable version of the support/inference code for [MegaDetector](https://github.com/agentmorris/MegaDetector/?tab=readme-ov-file#megadetector), an object detection model that helps conservation biologists spend less time doing boring things with camera trap images.  Complete documentation for this Python package is available at [megadetector.readthedocs.io](https://megadetector.readthedocs.io).
+
+If you aren't looking for the Python package specifically, and you just want to learn more about what MegaDetector is all about, head over to the [MegaDetector repo](https://github.com/agentmorris/MegaDetector/?tab=readme-ov-file#megadetector).
+
+If you don't want to run MegaDetector, and you just want to use the utilities in this package - postprocessing, manipulating large volumes of camera trap images, etc. - you may want to check out the [megadetector-utils](https://pypi.org/project/megadetector-utils/) package, which is identical to this one, but excludes all of the PyTorch/YOLO dependencies, and is thus approximately one zillion times smaller.
+
+## Installation
+
+Install with:
+
+`pip install megadetector`
+
+MegaDetector model weights aren't downloaded at the time you install the package, but they will be (optionally) automatically downloaded the first time you run the model.
+
+## Package reference
+
+See [megadetector.readthedocs.io](https://megadetector.readthedocs.io).
+
+
+## Examples of things you can do with this package
+
+### Run MegaDetector on one image and count the number of detections
+
+```
+from megadetector.utils import url_utils
+from megadetector.visualization import visualization_utils as vis_utils
+from megadetector.detection import run_detector
+
+# This is the image at the bottom of this page, it has one animal in it
+image_url = 'https://github.com/agentmorris/MegaDetector/raw/main/images/orinoquia-thumb-web.jpg'
+temporary_filename = url_utils.download_url(image_url)
+
+image = vis_utils.load_image(temporary_filename)
+
+# This will automatically download MDv5a; you can also specify a filename.
+model = run_detector.load_detector('MDV5A')
+
+result = model.generate_detections_one_image(image)
+
+detections_above_threshold = [d for d in result['detections'] if d['conf'] > 0.2]
+print('Found {} detections above threshold'.format(len(detections_above_threshold)))
+```
+
+### Run MegaDetector on a folder of images
+
+```
+from megadetector.detection.run_detector_batch import \
+    load_and_run_detector_batch, write_results_to_file
+from megadetector.utils import path_utils
+import os
+
+# Pick a folder to run MD on recursively, and an output file
+image_folder = os.path.expanduser('~/megadetector_test_images')
+output_file = os.path.expanduser('~/megadetector_output_test.json')
+
+# Recursively find images
+image_file_names = path_utils.find_images(image_folder,recursive=True)
+
+# This will automatically download MDv5a; you can also specify a filename.
+results = load_and_run_detector_batch('MDV5A', image_file_names)
+
+# Write results to a format that Timelapse and other downstream tools like.
+write_results_to_file(results,
+                      output_file,
+                      relative_path_base=image_folder,
+                      detector_file=detector_filename)
+```
+
+## Contact
+
+Contact <a href="cameratraps@lila.science">cameratraps@lila.science</a> with questions.
+
+## Gratuitous animal picture
+
+<img src="https://github.com/agentmorris/MegaDetector/raw/main/images/orinoquia-thumb-web_detections.jpg"><br/>Image credit University of Minnesota, from the [Orinoquía Camera Traps](http://lila.science/datasets/orinoquia-camera-traps/) data set.