{"id":13443434,"url":"https://github.com/RunpeiDong/PointDistiller","last_synced_at":"2025-03-20T16:31:20.996Z","repository":{"id":40611654,"uuid":"495653026","full_name":"RunpeiDong/PointDistiller","owner":"RunpeiDong","description":"[CVPR 2023] PointDistiller: Structured Knowledge Distillation Towards Efficient and Compact 3D Detection","archived":false,"fork":false,"pushed_at":"2023-05-23T13:01:01.000Z","size":3769,"stargazers_count":66,"open_issues_count":2,"forks_count":1,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-10-28T06:58:22.487Z","etag":null,"topics":["3d-object-detection","knowledge-distillation","point-cloud"],"latest_commit_sha":null,"homepage":"https://arxiv.org/abs/2205.11098","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/RunpeiDong.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-24T03:15:33.000Z","updated_at":"2024-05-11T18:24:12.000Z","dependencies_parsed_at":"2024-01-18T14:43:27.814Z","dependency_job_id":"962e0f0c-5f18-4759-8bc9-6ecb6b525ceb","html_url":"https://github.com/RunpeiDong/PointDistiller","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/RunpeiDong%2FPointDistiller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RunpeiDong%2FPointDistiller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RunpeiDong%2FPointDistiller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RunpeiDong%2FPointDistiller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RunpeiDong","download_url":"https://codeload.github.com/RunpeiDong/PointDistiller/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244649836,"owners_count":20487503,"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":["3d-object-detection","knowledge-distillation","point-cloud"],"created_at":"2024-07-31T03:02:00.672Z","updated_at":"2025-03-20T16:31:18.945Z","avatar_url":"https://github.com/RunpeiDong.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# PointDistiller\n\u003e [**PointDistiller: Structured Knowledge Distillation Towards Efficient and Compact 3D Detection**](https://openaccess.thecvf.com/content/CVPR2023/papers/Zhang_PointDistiller_Structured_Knowledge_Distillation_Towards_Efficient_and_Compact_3D_Detection_CVPR_2023_paper.pdf), CVPR'23 \u003cbr\u003e\n\u003e [Linfeng Zhang](http://group.iiis.tsinghua.edu.cn/~maks/linfeng/index.html)\\*, [Runpei Dong](https://runpeidong.com/)\\*, [Hung-Shuo Tai](https://scholar.google.com/citations?user=_atJMtEAAAAJ\u0026hl=en), and [Kaisheng Ma](http://group.iiis.tsinghua.edu.cn/~maks/leader.html) \u003cbr\u003e\n\n[OpenAccess](https://openaccess.thecvf.com/content/CVPR2023/papers/Zhang_PointDistiller_Structured_Knowledge_Distillation_Towards_Efficient_and_Compact_3D_Detection_CVPR_2023_paper.pdf) | [arXiv](https://arxiv.org/abs/2205.11098) | [Logs](https://drive.google.com/drive/folders/1jA14eMk-0fIywFxku-ijfMIBzFTp7Lef?usp=share_link)\n\nThis repository contains the implementation of the paper **PointDistiller: Structured Knowledge Distillation Towards Efficient and Compact 3D Detection** (CVPR 2023).\n\n![PointDistiller](./resources/point_distiller.png)\n\n## Environment\nThis codebase was tested with the following environment configurations. It may work with other versions.\n- Ubuntu 18.04/20.04\n- CUDA 10.2/11.3\n- GCC 7.5.0/9.4.0\n- Python 3.7.11/3.8.8\n- PyTorch 1.9.0/1.10.0\n- [MMCV](https://mmcv.readthedocs.io/en/latest/) v1.4.8\n- [MMDetection3D](https://github.com/open-mmlab/mmdetection3d) v1.0.0rc0+\n- [MMDetection](https://github.com/open-mmlab/mmdetection) v2.22.0\n- [MMSegmentation](https://github.com/open-mmlab/mmsegmentation) v0.22.1\n\n## 1. Installation\nPlease refer to [getting_started.md](./getting_started.md) for installation.\n\n## 2. Datasets\nWe use [KITTI](https://www.cvlibs.net/datasets/kitti/eval_object.php?obj_benchmark=3d) and [nuScenes](https://www.nuscenes.org/) datsets, please follow the [official instructions](https://mmdetection3d.readthedocs.io/en/latest/) for set up.\n\n## 3. How to Run\nPlease make sure you have set up the environments and you can start knowledge distillation by running \n```bash\nDEVICE_ID = \u003cgpu_id\u003e\nCUDA_VISIBLE_DEVICES=$DEVICE_ID python tools/train.py \u003cstudent_cfg\u003e --use-kd # for single gpu\nbash ./tools/dist_train.sh \u003cstudent_cfg\u003e 8 --use-kd # for multiple gpus\n```\n## License\nPointDistiller is released under the MIT License. See the [LICENSE](./LICENSE) file for more details.\n\n## Acknowledgements\nMany thanks to following codes that help us a lot in building this codebase:\n* [Object-Detection-Knowledge-Distillation-ICLR2021](https://github.com/ArchipLab-LinfengZhang/Object-Detection-Knowledge-Distillation-ICLR2021)\n* [mmdetection](https://github.com/open-mmlab/mmdetection)\n* [mmdetection3d](https://github.com/open-mmlab/mmdetection3d)\n* [mmsegementation](https://github.com/open-mmlab/mmsegmentation)\n\n## Citation\n\nIf you find our work useful in your research, please consider citing:\n```latex\n@inproceedings{pointdistiller23,\n  title={PointDistiller: Structured Knowledge Distillation Towards Efficient and Compact 3D Detection},\n  author={Linfeng Zhang and Runpei Dong and Hung-Shuo Tai and Kaisheng Ma},\n  booktitle={IEEE/CVF Conference on Computer Vision and Pattern Recognition (CVPR)},\n  year={2023},\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRunpeiDong%2FPointDistiller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FRunpeiDong%2FPointDistiller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRunpeiDong%2FPointDistiller/lists"}