Science Score: 54.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: arxiv.org, scholar.google
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.0%) to scientific vocabulary
Last synced: 7 months ago · JSON representation ·

Repository

Basic Info
  • Host: GitHub
  • Owner: Zarhult
  • License: apache-2.0
  • Language: Python
  • Default Branch: main
  • Size: 5.24 MB
Statistics
  • Stars: 3
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Created over 1 year ago · Last pushed 8 months ago
Metadata Files
Readme License Citation Support

README.md

HSDA: High-frequency Shuffle Data Augmentation for Bird’s-Eye-View Map Segmentation

& RGCN: Residual Graph Convolutional Network for Bird’s-Eye-View Semantic Segmentation

**Calvin Glisson** · **Qiuxiao Chen** California State University, San Bernardino **WACV 2025** This repo provides runnable code for RGCN and the new RGCN+HSDA method.

Getting Started

Data Download

Please download the nuscenes dataset in data/nuscenes with the following files present. data │ nuscenes │ ├── maps │ ├── samples │ ├── sweeps | ├── v1.0-trainval

Environment Installation

We provide a dockerfile for simple setup of the environment. ```bash

(e.g. docker build -t hsda /share/docker_files/HSDA/docker)

docker build -t $ImageName $dockerfilepath/

(e.g. docker run -it --name hsdacontainer --shm-size=8g --gpus all --mount type=bind,source=/share/dockerfiles,target=/share/code hsda /bin/bash)

docker run -it --name hsdacontainer --shm-size=8g --gpus all --mount type=bind,source=/share/dockerfiles,target=/share/code $ImageName /bin/bash

now inside docker:

pip install --no-cache-dir -v -e . ```

Dataset Preparation

```bash

Generate annotations for the nuscenes dataset.

python tools/create_data.py nuscenes --root-path data/nuscenes --out-dir data/nuscenes --extra-tag nuscenes --bev True

Generate new dataset with HSDA shuffled camera images.

This command may take a while.

If it is interrupted while running, simply re-run the script and it will resume where it left off.

python prepare-hsda-dataset.py

Generate annotations for the HSDA dataset.

python tools/create_data.py nuscenes --root-path data/nuscenes-hsda --out-dir data/nuscenes-hsda --extra-tag nuscenes --bev True ```

Training

```bash

Single-GPU

python train.py $config

Multi-GPU

./disttraingpu.sh $config $num

Example: train baseline+HSDA with 2 gpus

./disttraingpu.sh configs/bevdet_hsda/bevdet-multi-map-aug-seg-only-6class-hsda.py 2 ```

Testing

```bash

We are interested only in the map results.

python test.py $config $pth --eval=bboxmap

Example: test baseline+HSDA after training it

python test.py configs/bevdethsda/bevdet-multi-map-aug-seg-only-6class-hsda.py workdirs/bevdet-multi-map-aug-seg-only-6class-hsda/epoch_20.pth --eval=bboxmap ``` Our pretrained pth file can be downloaded for testing here.

Bibtex

If this work is helpful for your research, please consider citing the following BibTeX entry. @InProceedings{Glisson_2025_WACV, author = {Glisson, Calvin and Chen, Qiuxiao}, title = {HSDA: High-Frequency Shuffle Data Augmentation for Bird's-Eye-View Map Segmentation}, booktitle = {Proceedings of the Winter Conference on Applications of Computer Vision (WACV)}, month = {February}, year = {2025}, pages = {8816-8825} }

Owner

  • Name: Calvin Glisson
  • Login: Zarhult
  • Kind: user

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
  - name: "MMDetection3D Contributors"
title: "OpenMMLab's Next-generation Platform for General 3D Object Detection"
date-released: 2020-07-23
url: "https://github.com/open-mmlab/mmdetection3d"
license: Apache-2.0

GitHub Events

Total
  • Issues event: 2
  • Watch event: 4
  • Issue comment event: 1
  • Member event: 1
  • Public event: 1
  • Push event: 10
  • Fork event: 1
Last Year
  • Issues event: 2
  • Watch event: 4
  • Issue comment event: 1
  • Member event: 1
  • Public event: 1
  • Push event: 10
  • Fork event: 1

Dependencies

docker/Dockerfile docker
  • pytorch/pytorch ${PYTORCH}-cuda${CUDA}-cudnn${CUDNN}-devel build
requirements/build.txt pypi
requirements/docs.txt pypi
  • docutils ==0.16.0
  • m2r *
  • myst-parser *
  • opencv-python *
  • sphinx ==4.0.2
  • sphinx-copybutton *
  • sphinx_markdown_tables *
  • torch *
requirements/mminstall.txt pypi
  • mmcv-full >=1.3.8,<=1.4.0
  • mmdet >=2.14.0,<=3.0.0
  • mmsegmentation >=0.14.1,<=1.0.0
requirements/optional.txt pypi
  • open3d *
  • waymo-open-dataset-tf-2-1-0 ==1.2.0
requirements/readthedocs.txt pypi
  • mmcv *
  • torch *
  • torchvision *
requirements/runtime.txt pypi
  • lyft_dataset_sdk *
  • networkx >=2.2,<2.3
  • numba ==0.48.0
  • numpy <1.20.0
  • nuscenes-devkit *
  • plyfile *
  • scikit-image *
  • tensorboard *
  • trimesh >=2.35.39,<2.35.40
requirements/tests.txt pypi
  • asynctest * test
  • codecov * test
  • flake8 * test
  • interrogate * test
  • isort * test
  • kwarray * test
  • pytest * test
  • pytest-cov * test
  • pytest-runner * test
  • ubelt * test
  • xdoctest >=0.10.0 test
  • yapf * test
requirements.txt pypi
setup.py pypi