All the codes are tested in the following environment:
- Linux (tested on Ubuntu 14.04/16.04)
- Python 3.6+
- PyTorch 1.1 or higher (tested on PyTorch 1.1)
- CUDA 9.0 or higher
spconv v1.0(commit 8da6f96)
NOTE: Please re-install pcdet v0.2 by running python setup.py develop if you have already installed pcdet v0.1 previously.
a. Clone this repository.
git clone https://github.com/open-mmlab/OpenPCDet.gitb. Install the dependent libraries as follows:
- Install the dependent python libraries:
pip install -r requirements.txt
- Install the SparseConv library, we use the non-official implementation from
spconv. Note that we use the initial version ofspconv, make sure you install thespconv v1.0(commit 8da6f96) instead of the latest one.
c. Install this pcdet library by running the following command:
python setup.py developCurrently we provide the dataloader of KITTI dataset, and the supporting of more datasets are on the way.
- Please download the official KITTI 3D object detection dataset and organize the downloaded files as follows (the road planes could be downloaded from [road plane], which are optional for data augmentation in the training):
- NOTE: if you already have the data infos from
pcdet v0.1, you can choose to use the old infos and set the DATABASE_WITH_FAKELIDAR option in tools/cfgs/dataset_configs/kitti_dataset.yaml as True. The second choice is that you can create the infos and gt database again and leave the config unchanged.
PCDet
├── data
│ ├── kitti
│ │ │──ImageSets
│ │ │──training
│ │ │ ├──calib & velodyne & label_2 & image_2 & (optional: planes)
│ │ │──testing
│ │ │ ├──calib & velodyne & image_2
├── pcdet
├── tools
- Generate the data infos by running the following command:
python -m pcdet.datasets.kitti.kitti_dataset create_kitti_infos tools/cfgs/dataset_configs/kitti_dataset.yaml