Science Score: 44.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
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.3%) to scientific vocabulary
Last synced: 10 months ago · JSON representation ·

Repository

Basic Info
  • Host: GitHub
  • Owner: hsouri
  • License: apache-2.0
  • Language: Python
  • Default Branch: main
  • Size: 14.8 MB
Statistics
  • Stars: 10
  • Watchers: 1
  • Forks: 2
  • Open Issues: 1
  • Releases: 0
Created over 2 years ago · Last pushed over 2 years ago
Metadata Files
Readme Contributing License Code of conduct Citation

README.md

BoB-Detection

This repository is the official implementation of Object Detection and Instance Segmentation task in the Battle of the Backbones: A Large-Scale Comparison of Pretrained Models across Computer Vision Tasks.

:pushpin: Our implementation and instructions are based on mmdetection

Installation

Step 1. Create a conda environment and activate it.

shell conda create --name openmmlab python=3.8 -y conda activate openmmlab

Step 2. Install PyTorch following official instructions, e.g.

On GPU platforms:

shell conda install pytorch==1.13.1 torchvision==0.14.1 torchaudio==0.13.1 pytorch-cuda=11.6 -c pytorch -c nvidia

Step 3. Install MMCV using MIM.

shell pip install -U openmim mim install mmcv-full==1.7.0

Step 4. Install BoB-Detection.

```shell git clone https://github.com/hsouri/bob-detection.git cd bob-detection pip install -v -e .

"-v" means verbose, or more output

"-e" means installing a project in editable mode,

thus any local modifications made to the code will take effect without reinstallation.

```

Step 5. Download COCO (LVIS) and unzip dataset (you can optionally delete downloaded zip files by passing '--delete').

COCO download:

shell python tools/misc/download_dataset.py --dataset-name coco2017 --unzip LVIS download:

shell python tools/misc/download_dataset.py --dataset-name lvis --save-dir data/lvis_v1/ --unzip cd data/lvis_v1/ mkdir annotations mv lvis_v1_train.json annotations/ mv lvis_v1_val.json annotations/

Please refer to Get Started, Dataset Prepare, and Dataset Download for more detailed instructions.

Usage

The config files for all experiments in Battle of the Backbones (BoB) can be found configs/bob.

To train a detector with the existing configs, run:

shell bash ./tools/dist_train.sh <CONFIG_FILE> <GPU_NUM>

Owner

  • Name: Hossein Souri
  • Login: hsouri
  • Kind: user
  • Company: Johns Hopkins University

PhD student at Johns Hopkins University

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
  - name: "MMDetection Contributors"
title: "OpenMMLab Detection Toolbox and Benchmark"
date-released: 2018-08-22
url: "https://github.com/open-mmlab/mmdetection"
license: Apache-2.0

GitHub Events

Total
  • Watch event: 2
Last Year
  • Watch event: 2

Dependencies

.github/workflows/build.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • codecov/codecov-action v1.0.10 composite
  • codecov/codecov-action v2 composite
.github/workflows/build_pat.yml actions
  • actions/checkout v2 composite
.github/workflows/deploy.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
.github/workflows/lint.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
.github/workflows/stale.yml actions
  • actions/stale v4 composite
.github/workflows/test_mim.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
docker/Dockerfile docker
  • pytorch/pytorch ${PYTORCH}-cuda${CUDA}-cudnn${CUDNN}-devel build
docker/serve/Dockerfile docker
  • pytorch/pytorch ${PYTORCH}-cuda${CUDA}-cudnn${CUDNN}-devel build
requirements/albu.txt pypi
  • albumentations >=0.3.2
requirements/build.txt pypi
  • cython *
  • numpy *
requirements/docs.txt pypi
  • docutils ==0.16.0
  • markdown >=3.4.0
  • myst-parser *
  • sphinx ==5.3.0
  • sphinx-copybutton *
  • sphinx_markdown_tables >=0.0.17
  • sphinx_rtd_theme *
requirements/mminstall.txt pypi
  • mmcv-full >=1.3.17
requirements/optional.txt pypi
  • cityscapesscripts *
  • imagecorruptions *
  • sklearn *
requirements/readthedocs.txt pypi
  • mmcv *
  • torch *
  • torchvision *
requirements/runtime.txt pypi
  • einops *
  • matplotlib *
  • numpy *
  • omegaconf *
  • pycocotools *
  • pytorch_lightning *
  • scipy *
  • six *
  • terminaltables *
  • timm *
  • transformers *
requirements/tests.txt pypi
  • asynctest * test
  • codecov * test
  • flake8 * test
  • interrogate * test
  • isort ==4.3.21 test
  • kwarray * test
  • onnx ==1.7.0 test
  • onnxruntime >=1.8.0 test
  • protobuf <=3.20.1 test
  • pytest * test
  • ubelt * test
  • xdoctest >=0.10.0 test
  • yapf * test
requirements.txt pypi
setup.py pypi