{"id":16519259,"url":"https://github.com/davidmascharka/detection-utils","last_synced_at":"2025-03-23T13:32:25.847Z","repository":{"id":52223034,"uuid":"190956919","full_name":"davidmascharka/detection-utils","owner":"davidmascharka","description":"Common functionality for object detection","archived":false,"fork":false,"pushed_at":"2021-05-04T16:02:50.000Z","size":10653,"stargazers_count":17,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-10T04:51:47.454Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://detection-utils.readthedocs.io/en/latest/contents.html","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davidmascharka.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-06-09T02:47:48.000Z","updated_at":"2023-12-24T18:30:28.000Z","dependencies_parsed_at":"2022-08-24T04:51:18.080Z","dependency_job_id":null,"html_url":"https://github.com/davidmascharka/detection-utils","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmascharka%2Fdetection-utils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmascharka%2Fdetection-utils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmascharka%2Fdetection-utils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmascharka%2Fdetection-utils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidmascharka","download_url":"https://codeload.github.com/davidmascharka/detection-utils/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244306082,"owners_count":20431737,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-11T16:46:06.024Z","updated_at":"2025-03-23T13:32:23.085Z","avatar_url":"https://github.com/davidmascharka.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# detection-utils\n\u003e Written by [David Mascharka](https://github.com/davidmascharka), [Ryan Soklaski](https://github.com/rsokl), and [Arjun Majumdar](https://github.com/arjunmajum)\n\n![build status](https://img.shields.io/travis/davidmascharka/detection-utils.svg) \n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4287380.svg)](https://doi.org/10.5281/zenodo.4287380)\n\n\nCommon functionality for object detection\n\nThis repository hosts functions that are commonly used across object detection projects. The\nfunctionality here includes:\n\n- [Box overlap computation](src/detection_utils/boxes.py#L29) (IoU)\n- [Precision](src/detection_utils/metrics.py#L27) and [recall](src/detection_utils/metrics.py#L93) calculations\n- [Computing targets](src/detection_utils/boxes.py#L82) for training a detector given a set of ground-truth objects\n- [Non-maximum suppression](src/detection_utils/boxes.py#L170)\n- [Coordinate transform utilities](src/detection_utils/boxes.py#L241)\n- [Focal loss in PyTorch](src/detection_utils/pytorch.py#L26)\n\nAll the functions here are\n[well-tested](tests) to ensure proper\nfunctionality of these utilities. This repository is meant to ensure that modifications and improvements that are\nimplemented as part of one program migrate to other programs when appropriate.\n\n## Installation\n\nTo use `detection-utils` you will need `numpy`, `numba`, and optionally `pytorch`. We recommend either fetching `numpy`\nfrom [Anaconda](https://www.anaconda.com/distribution/) or ensuring you can link against MKL yourself for\nperformance. You can install `numba` via pip and [PyTorch](https://pytorch.org/get-started/locally/) should be installed\naccording to your needs. For example:\n\n``` shell\n$ conda install numpy\n$ pip install numba torch torchvision\n```\n\n#### Pip\n\n`detection-utils` is availabe on PyPI: install via\n\n``` shell\n$ pip install detection-utils\n```\n\n#### Git\nClone this repository and install:\n\n``` shell\n$ git clone https://github.com/davidmascharka/detection-utils.git \u0026\u0026 cd detection-utils\n$ pip install .\n```\n\n#### Verifying Installation\n\nTo verify installation, ensure that [pytest](https://docs.pytest.org/en/latest/) and\n[hypothesis](https://hypothesis.readthedocs.io/en/latest/) are installed, then run\n`pytest` from the `detection-utils` base directory.\n\n## Contributing\nIf you're interested in contributing to this library, a good place to start is by browsing for [open\nissues](https://github.com/davidmascharka/detection-utils/issues) to see if there are\ndesired features waiting for implementation. Please see the [contributors file](CONTRIBUTING.md) before you submit a\npull request.\n\n## Copyright\nDISTRIBUTION STATEMENT A. Approved for public release. Distribution is unlimited.\n\nThis material is based upon work supported by the Under Secretary of Defense for Research and\nEngineering under Air Force Contract No. FA8702-15-D-0001. Any opinions, findings, conclusions or\nrecommendations expressed in this material are those of the author(s) and do not necessarily\nreflect the views of the Under Secretary of Defense for Research and Engineering.\n\n© 2019 Massachusetts Institute of Technology.\n\nMIT Proprietary, Subject to FAR52.227-11 Patent Rights - Ownership by the contractor (May 2014)\n\nThe software/firmware is provided to you on an As-Is basis\n\nDelivered to the U.S. Government with Unlimited Rights, as defined in DFARS Part 252.227-7013 or\n7014 (Feb 2014). Notwithstanding any copyright notice, U.S. Government rights in this work are\ndefined by DFARS 252.227-7013 or DFARS 252.227-7014 as detailed above. Use of this work other\nthan as specifically authorized by the U.S. Government may violate any copyrights that exist in\nthis work.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidmascharka%2Fdetection-utils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidmascharka%2Fdetection-utils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidmascharka%2Fdetection-utils/lists"}