{"id":13738365,"url":"https://github.com/jbwang1997/OBBDetection","last_synced_at":"2025-05-08T16:33:39.518Z","repository":{"id":37641919,"uuid":"355244547","full_name":"jbwang1997/OBBDetection","owner":"jbwang1997","description":"OBBDetection is an oriented object detection library, which is based on MMdetection.","archived":false,"fork":false,"pushed_at":"2024-02-01T08:51:37.000Z","size":13488,"stargazers_count":545,"open_issues_count":110,"forks_count":115,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-15T07:34:18.839Z","etag":null,"topics":["object-detection","oriented-object-detection"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jbwang1997.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-04-06T15:45:20.000Z","updated_at":"2024-11-11T01:57:43.000Z","dependencies_parsed_at":"2022-08-08T21:15:18.258Z","dependency_job_id":"4a121ed1-8f8a-4755-90db-f179268cd890","html_url":"https://github.com/jbwang1997/OBBDetection","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbwang1997%2FOBBDetection","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbwang1997%2FOBBDetection/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbwang1997%2FOBBDetection/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbwang1997%2FOBBDetection/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jbwang1997","download_url":"https://codeload.github.com/jbwang1997/OBBDetection/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253105520,"owners_count":21855047,"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":["object-detection","oriented-object-detection"],"created_at":"2024-08-03T03:02:20.229Z","updated_at":"2025-05-08T16:33:38.119Z","avatar_url":"https://github.com/jbwang1997.png","language":"Python","readme":"# OBBDetection\n\n**note**: If you have questions or good suggestions, feel free to propose issues and contact me.\n\n## introduction\n\nOBBDetection is an oriented object detection toolbox modified from [MMdetection v2.2](https://github.com/open-mmlab/mmdetection).\n\n![demo image](demo/obbdet_show.jpg)\n\n### Major features\n\n- **MMdetection feature inheritance**\n\n  OBBDetection doesn't change the structure and codes of original MMdetection and the additive codes are under MMdetection logic. Therefore, our OBBDetection inherits all features from MMdetection.\n\n- **Support of multiple frameworks out of box**\n\n  We implement multiple oriented object detectors in this toolbox (*e.g.* RoI Transformer, Gliding Vertex). Attributing to moudlar design of MMdetection, Many parts of detectors (*e.g.* backbone, RPN, sampler and assigner) have multiple options.\n\n- **Flexible representation of oriented boxes**\n\n  Horizontal bounding boxes (HBB), oriented bounding boxes (OBB) and 4 point boxes (POLY) are supported in this toolbox. The program will confirm the type of bounding box by the tensor shape or the default setting.\n\nWe develop [BboxToolkit](https://github.com/jbwang1997/BboxToolkit) to support oriented bounding boxes operations, which is heavily depended on by this toolbox.\n\n## License\n\nThis project is released under the [Apache 2.0 license](LICENSE).\n\n## Update\n\n- (**2022-03-15**) Support oriented mask. Open source [Oriented R-CNN and Beyond](configs/obb/oriented_rcnn_beyond).\n- (**2021-12-14**) Thanks [liuyanyi](https://github.com/liuyanyi) for reimplementing [S2ANet](configs/obb/s2anet) in OBBDetection.\n- (**2021-11-29**) Discard mmcv-0.6.2 and support mmcv-full.\n- (**2021-09-18**) Implement [Double Head OBB](configs/obb/double_heads_obb) in the OBBDetection.\n- (**2021-09-01**) Implement [FCOS OBB](configs/obb/fcos_obb) in the OBBDetection.\n- (**2021-08-21**) Reimplement the [PolyIoULoss](configs/obb/poly_iou_loss).\n\n## Benchmark and model zoo\n\nResults and models are available in the [model zoo](docs/model_zoo.md).\n\nSupported backbones:\n- [x] ResNet\n- [x] ResNeXt\n- [x] VGG\n- [x] HRNet\n- [x] RegNet\n- [x] Res2Net\n\nSupported oriented detection methods:\n- [x] [S2ANet (TGRS)](configs/obb/s2anet)\n- [x] [Oriented R-CNN (ICCV'2021)](configs/obb/oriented_rcnn)\n- [x] [Oriented R-CNN and Beyond (IJCV 2024)](configs/obb/oriented_rcnn_beyond)\n- [x] [Poly IoU Loss](configs/obb/poly_iou_loss)\n- [x] [Faster R-CNN OBB](configs/obb/faster_rcnn_obb)\n- [x] [Double Head OBB](configs/obb/double_heads_obb)\n- [x] [RetinaNet OBB](configs/obb/retinanet_obb)\n- [x] [Gliding Vertex](configs/obb/gliding_vertex)\n- [x] [RoI Transformer](configs/obb/roi_transformer)\n- [x] [FCOS OBB](configs/obb/fcos_obb)\n\nSupported horizontal detection methods:\n- [x] [RPN](configs/rpn)\n- [x] [Fast R-CNN](configs/fast_rcnn)\n- [x] [Faster R-CNN](configs/faster_rcnn)\n- [x] [Mask R-CNN](configs/mask_rcnn)\n- [x] [Cascade R-CNN](configs/cascade_rcnn)\n- [x] [Cascade Mask R-CNN](configs/cascade_rcnn)\n- [x] [SSD](configs/ssd)\n- [x] [RetinaNet](configs/retinanet)\n- [x] [GHM](configs/ghm)\n- [x] [Mask Scoring R-CNN](configs/ms_rcnn)\n- [x] [Double-Head R-CNN](configs/double_heads)\n- [x] [Hybrid Task Cascade](configs/htc)\n- [x] [Libra R-CNN](configs/libra_rcnn)\n- [x] [Guided Anchoring](configs/guided_anchoring)\n- [x] [FCOS](configs/fcos)\n- [x] [RepPoints](configs/reppoints)\n- [x] [Foveabox](configs/foveabox)\n- [x] [FreeAnchor](configs/free_anchor)\n- [x] [NAS-FPN](configs/nas_fpn)\n- [x] [ATSS](configs/atss)\n- [x] [FSAF](configs/fsaf)\n- [x] [PAFPN](configs/pafpn)\n- [x] [Dynamic R-CNN](configs/dynamic_rcnn)\n- [x] [PointRend](configs/point_rend)\n- [x] [CARAFE](configs/carafe/README.md)\n- [x] [DCNv2](configs/dcn/README.md)\n- [x] [Group Normalization](configs/gn/README.md)\n- [x] [Weight Standardization](configs/gn+ws/README.md)\n- [x] [OHEM](configs/faster_rcnn/faster_rcnn_r50_fpn_ohem_1x_coco.py)\n- [x] [Soft-NMS](configs/faster_rcnn/faster_rcnn_r50_fpn_soft_nms_1x_coco.py)\n- [x] [Generalized Attention](configs/empirical_attention/README.md)\n- [x] [GCNet](configs/gcnet/README.md)\n- [x] [Mixed Precision (FP16) Training](configs/fp16/README.md)\n- [x] [InstaBoost](configs/instaboost/README.md)\n- [x] [GRoIE](configs/groie/README.md)\n- [x] [DetectoRS](configs/detectors/README.md)\n- [x] [Generalized Focal Loss](configs/gfl/README.md)\n\n## Installation\n\nPlease refer to [install.md](docs/install.md) for installation and dataset preparation.\n\n## Get Started\n\n### Oriented models training and testing\n\nIf you want to train or test a oriented model, please refer to [oriented_model_starting.md](docs/oriented_model_starting.md).\n\n### How to use MMDetection\n\nIf you are not familiar with MMdetection, please see [getting_started.md](docs/getting_started.md) for the basic usage of MMDetection. There are also tutorials for [finetuning models](docs/tutorials/finetune.md), [adding new dataset](docs/tutorials/new_dataset.md), [designing data pipeline](docs/tutorials/data_pipeline.md), and [adding new modules](docs/tutorials/new_modules.md).\n\n## Acknowledgement\n\nWe refered [S2ANet](https://github.com/csuhan/s2anet) and [AerialDetection](https://github.com/dingjiansw101/AerialDetection) when develping OBBDetection.\n\nThis toolbox is modified from [MMdetection](https://github.com/open-mmlab/mmdetection). If you use this toolbox or benchmark in your research, please cite the following information.\n\n```\n@article{mmdetection,\n  title   = {{MMDetection}: Open MMLab Detection Toolbox and Benchmark},\n  author  = {Chen, Kai and Wang, Jiaqi and Pang, Jiangmiao and Cao, Yuhang and\n             Xiong, Yu and Li, Xiaoxiao and Sun, Shuyang and Feng, Wansen and\n             Liu, Ziwei and Xu, Jiarui and Zhang, Zheng and Cheng, Dazhi and\n             Zhu, Chenchen and Cheng, Tianheng and Zhao, Qijie and Li, Buyu and\n             Lu, Xin and Zhu, Rui and Wu, Yue and Dai, Jifeng and Wang, Jingdong\n             and Shi, Jianping and Ouyang, Wanli and Loy, Chen Change and Lin, Dahua},\n  journal = {arXiv preprint arXiv:1906.07155},\n  year={2019}\n}\n```\n\nThis is the official implement of [Oriented R-CNN](configs/obb/oriented_rcnn). if it is used in your research, please cite the following information.\n\n```\n@InProceedings{Xie_2021_ICCV,\n  author = {Xie, Xingxing and Cheng, Gong and Wang, Jiabao and Yao, Xiwen and Han, Junwei},\n  title = {Oriented R-CNN for Object Detection},\n  booktitle = {Proceedings of the IEEE/CVF International Conference on Computer Vision (ICCV)},\n  month = {October},\n  year = {2021},\n  pages = {3520-3529} }\n```\n\n```\n@ARTICLE{orcnn_beyond,\n  author={Xie, Xingxing and Cheng, Gong and Wang, Jiabao and Li, Ke and Han, Junwei},\n  journal={International Journal of Computer Vision}, \n  title={Oriented R-CNN and Beyond}, \n  year={2024},\n  pages={1-23},\n  doi={https://doi.org/10.1007/s11263-024-01989-w}\n}\n```\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjbwang1997%2FOBBDetection","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjbwang1997%2FOBBDetection","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjbwang1997%2FOBBDetection/lists"}