Data

Tools

Indexes

Applications

Experiments

Open Source Science

mmcv

OpenMMLab Computer Vision Foundation

https://github.com/open-mmlab/mmcv

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
  • ✓
    Committers with academic emails
    11 of 279 committers (3.9%) from academic institutions
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (13.4%) to scientific vocabulary

Keywords from Contributors

swin-transformer transformers deeplabv3 medical-image-segmentation pspnet realtime-segmentation vessel-segmentation semantic-segmentation retinal-vessel-segmentation pretrained-models
Last synced: 6 months ago · JSON representation ·

Repository

OpenMMLab Computer Vision Foundation

Basic Info
Statistics
  • Stars: 6,230
  • Watchers: 84
  • Forks: 1,707
  • Open Issues: 443
  • Releases: 62
Created over 7 years ago · Last pushed 10 months ago
Metadata Files
Readme Contributing License Citation

README.md

 
OpenMMLab website HOT      OpenMMLab platform TRY IT OUT
 
[![platform](https://img.shields.io/badge/platform-Linux%7CWindows%7CmacOS-blue)](https://mmcv.readthedocs.io/en/latest/get_started/installation.html) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mmcv)](https://pypi.org/project/mmcv/) [![pytorch](https://img.shields.io/badge/pytorch-1.8~2.0-orange)](https://pytorch.org/get-started/previous-versions/) [![cuda](https://img.shields.io/badge/cuda-10.1~11.8-green)](https://developer.nvidia.com/cuda-downloads) [![PyPI](https://img.shields.io/pypi/v/mmcv)](https://pypi.org/project/mmcv) [![badge](https://github.com/open-mmlab/mmcv/workflows/build/badge.svg)](https://github.com/open-mmlab/mmcv/actions) [![codecov](https://codecov.io/gh/open-mmlab/mmcv/branch/master/graph/badge.svg)](https://codecov.io/gh/open-mmlab/mmcv) [![license](https://img.shields.io/github/license/open-mmlab/mmcv.svg)](https://github.com/open-mmlab/mmcv/blob/master/LICENSE) [📘Documentation](https://mmcv.readthedocs.io/en/latest/) | [🛠️Installation](https://mmcv.readthedocs.io/en/latest/get_started/installation.html) | [🤔Reporting Issues](https://github.com/open-mmlab/mmcv/issues/new/choose)
English | [简体中文](README_zh-CN.md)

Highlights

The OpenMMLab team released a new generation of training engine MMEngine at the World Artificial Intelligence Conference on September 1, 2022. It is a foundational library for training deep learning models. Compared with MMCV, it provides a universal and powerful runner, an open architecture with a more unified interface, and a more customizable training process.

MMCV v2.0.0 official version was released on April 6, 2023. In version 2.x, it removed components related to the training process and added a data transformation module. Also, starting from 2.x, it renamed the package names mmcv to mmcv-lite and mmcv-full to mmcv. For details, see Compatibility Documentation.

MMCV will maintain both 1.x (corresponding to the original master branch) and 2.x (corresponding to the main branch, now the default branch) versions simultaneously. For details, see Branch Maintenance Plan.

Introduction

MMCV is a foundational library for computer vision research and it provides the following functionalities:

It supports the following systems:

  • Linux
  • Windows
  • macOS

See the documentation for more features and usage.

Note: MMCV requires Python 3.7+.

Installation

There are two versions of MMCV:

  • mmcv: comprehensive, with full features and various CUDA ops out of the box. It takes longer time to build.
  • mmcv-lite: lite, without CUDA ops but all other features, similar to mmcv<1.0.0. It is useful when you do not need those CUDA ops.

Note: Do not install both versions in the same environment, otherwise you may encounter errors like ModuleNotFound. You need to uninstall one before installing the other. Installing the full version is highly recommended if CUDA is available.

Install mmcv

Before installing mmcv, make sure that PyTorch has been successfully installed following the PyTorch official installation guide. For apple silicon users, please use PyTorch 1.13+.

The command to install mmcv:

bash pip install -U openmim mim install mmcv

If you need to specify the version of mmcv, you can use the following command:

bash mim install mmcv==2.0.0

If you find that the above installation command does not use a pre-built package ending with .whl but a source package ending with .tar.gz, you may not have a pre-build package corresponding to the PyTorch or CUDA or mmcv version, in which case you can build mmcv from source.

Installation log using pre-built packages Looking in links: https://download.openmmlab.com/mmcv/dist/cu102/torch1.8.0/index.html
Collecting mmcv
Downloading https://download.openmmlab.com/mmcv/dist/cu102/torch1.8.0/mmcv-2.0.0-cp38-cp38-manylinux1_x86_64.whl
Installation log using source packages Looking in links: https://download.openmmlab.com/mmcv/dist/cu102/torch1.8.0/index.html
Collecting mmcv==2.0.0
Downloading mmcv-2.0.0.tar.gz

For more installation methods, please refer to the Installation documentation.

Install mmcv-lite

If you need to use PyTorch-related modules, make sure PyTorch has been successfully installed in your environment by referring to the PyTorch official installation guide.

bash pip install -U openmim mim install mmcv-lite

FAQ

If you face some installation issues, CUDA related issues or RuntimeErrors, you may first refer to this Frequently Asked Questions.

If you face installation problems or runtime issues, you may first refer to this Frequently Asked Questions to see if there is a solution. If the problem is still not solved, feel free to open an issue.

Citation

If you find this project useful in your research, please consider cite:

latex @misc{mmcv, title={{MMCV: OpenMMLab} Computer Vision Foundation}, author={MMCV Contributors}, howpublished = {\url{https://github.com/open-mmlab/mmcv}}, year={2018} }

Contributing

We appreciate all contributions to improve MMCV. Please refer to CONTRIBUTING.md for the contributing guideline.

License

MMCV is released under the Apache 2.0 license, while some specific operations in this library are with other licenses. Please refer to LICENSES.md for the careful check, if you are using our code for commercial matters.

Branch Maintenance Plan

MMCV currently has four branches, namely main, 1.x, master, and 2.x, where 2.x is an alias for the main branch, and master is an alias for the 1.x branch. The 2.x and master branches will be deleted in the future. MMCV's branches go through the following three stages:

| Phase | Time | Branch | description | | -------------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | RC Period | 2022.9.1 - 2023.4.5 | Release candidate code (2.x version) will be released on 2.x branch. Default master branch is still 1.x version | Master and 2.x branches iterate normally | | Compatibility Period | 2023.4.6 - 2023.12.31 | The 2.x branch has been renamed to the main branch and set as the default branch, and 1.x branch will correspond to 1.x version | We still maintain the old version 1.x, respond to user needs, but try not to introduce changes that break compatibility; main branch iterates normally | | Maintenance Period | From 2024/1/1 | Default main branch corresponds to 2.x version and 1.x branch is 1.x version | 1.x branch is in maintenance phase, no more new feature support; main branch is iterating normally |

Projects in OpenMMLab

  • MMEngine: OpenMMLab foundational library for training deep learning models.
  • MMCV: OpenMMLab foundational library for computer vision.
  • MIM: MIM installs OpenMMLab packages.
  • MMClassification: OpenMMLab image classification toolbox and benchmark.
  • MMDetection: OpenMMLab detection toolbox and benchmark.
  • MMDetection3D: OpenMMLab's next-generation platform for general 3D object detection.
  • MMRotate: OpenMMLab rotated object detection toolbox and benchmark.
  • MMYOLO: OpenMMLab YOLO series toolbox and benchmark.
  • MMSegmentation: OpenMMLab semantic segmentation toolbox and benchmark.
  • MMOCR: OpenMMLab text detection, recognition, and understanding toolbox.
  • MMPose: OpenMMLab pose estimation toolbox and benchmark.
  • MMHuman3D: OpenMMLab 3D human parametric model toolbox and benchmark.
  • MMSelfSup: OpenMMLab self-supervised learning toolbox and benchmark.
  • MMRazor: OpenMMLab model compression toolbox and benchmark.
  • MMFewShot: OpenMMLab fewshot learning toolbox and benchmark.
  • MMAction2: OpenMMLab's next-generation action understanding toolbox and benchmark.
  • MMTracking: OpenMMLab video perception toolbox and benchmark.
  • MMFlow: OpenMMLab optical flow toolbox and benchmark.
  • MMEditing: OpenMMLab image and video editing toolbox.
  • MMGeneration: OpenMMLab image and video generative models toolbox.
  • MMDeploy: OpenMMLab model deployment framework.

Owner

  • Name: OpenMMLab
  • Login: open-mmlab
  • Kind: organization
  • Location: China

Citation (CITATION.cff) 

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
  - name: "MMCV Contributors"
title: "OpenMMLab Computer Vision Foundation"
date-released: 2018-08-22
url: "https://github.com/open-mmlab/mmcv"
license: Apache-2.0

Committers

Last synced: 10 months ago

All Time
  • Total Commits: 1,436
  • Total Committers: 279
  • Avg Commits per committer: 5.147
  • Development Distribution Score (DDS): 0.863
Past Year
  • Commits: 42
  • Committers: 17
  • Avg Commits per committer: 2.471
  • Development Distribution Score (DDS): 0.738
Top Committers
Name Email Commits
Zaida Zhou 5****a 197
Kai Chen c****v@g****m 177
Jerry Jiarui XU x****6@g****m 51
Wenwei Zhang 4****e 43
q.yao y****n@s****m 29
Jintao Lin 5****5@q****m 29
Miao Zheng 7****g 28
Shilong Zhang 6****g 25
Jiazhen Wang 4****1 25
Cao Yuhang y****6@g****m 25
q.yao s****o@l****m 24
Mashiro 5****E 24
Y. Xiong x****y@g****m 23
lizz i****e 22
Rui Xu n****y@g****m 22
Wang Xinjiang w****g@s****m 21
Harry h****7@m****n 18
pc l****o@s****m 18
tripleMu 9****u 16
pangjm p****u@g****m 14
Yining Li l****2@g****m 13
Ma Zerun m****6@1****m 12
LXXXXR 7****R 11
Wang Yixuan 8****n 11
dingchang h****r@s****m 11
Qiaofei Li 3****s 10
RunningLeon m****g@s****m 10
Yue Zhou 5****9@q****m 10
David de la Iglesia Castro d****o@g****m 9
WRH 1****i 8
and 249 more...
Committer Domains (Top 20 + Academic)
qq.com: 25 sensetime.com: 12 163.com: 9 huawei.com: 6 126.com: 5 mail2.sysu.edu.cn: 3 foxmail.com: 3 pjlab.org.cn: 3 yandex.ru: 2 live.cn: 2 mails.tsinghua.edu.cn: 2 bonnaerens.be: 1 connect.ust.hk: 1 buaa.edu.cn: 1 zyc.ai: 1 mthreads.com: 1 sjtu.edu.cn: 1 insta360.com: 1 kitware.com: 1 qiwen.name: 1 whu.edu.cn: 1 umich.edu: 1 live.rhul.ac.uk: 1 stu.xmu.edu.cn: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 283
  • Total pull requests: 462
  • Average time to close issues: about 1 month
  • Average time to close pull requests: about 1 month
  • Total issue authors: 256
  • Total pull request authors: 129
  • Average comments per issue: 3.36
  • Average comments per pull request: 1.1
  • Merged pull requests: 187
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 55
  • Pull requests: 109
  • Average time to close issues: 2 days
  • Average time to close pull requests: 9 days
  • Issue authors: 52
  • Pull request authors: 23
  • Average comments per issue: 0.67
  • Average comments per pull request: 0.43
  • Merged pull requests: 50
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
  • zbl929 (4)
  • cqray1990 (4)
  • Annarine (3)
  • kelvinwang139 (3)
  • HarborYuan (3)
  • Balabala-Hong (3)
  • 123-cq (3)
  • hailong23-jin (2)
  • appreciatehxy (2)
  • dust-removal (2)
  • FrancescoSaverioZuppichini (2)
  • BoomSky0416 (2)
  • mcmingchang (2)
  • hiyyg (2)
  • zhongqiu1245 (2)
Pull Request Authors
  • hust17yixuan (36)
  • momo609 (26)
  • zhouzaida (19)
  • Binary2355 (16)
  • Annarine (14)
  • 673958639 (14)
  • HAOCHENYE (13)
  • sunyanguomt (12)
  • ClowDragon (12)
  • dflhw (12)
  • huangyuan64 (10)
  • GeorgePearse (10)
  • RRaoyzee (10)
  • Hua-yuxiu (9)
  • CokeDong (8)
Top Labels
Issue Labels
Installation (12) new architecture (5) Windows (3) Bug (2) Community help wanted (2) NPU (2) awaiting response (2) Feature Request (1) installation/env (1) kind/bug (1) ROCm (1) Enhancement (1) Op (1) ONNX (1) Deploy (1) TensorRT (1)
Pull Request Labels
MLU (28) NPU (14) CodeCamp (2) WIP (2) Ready (1) size/XS (1)

Packages

  • Total packages: 11
  • Total downloads:
    • pypi 188,423 last-month
  • Total docker downloads: 20,498
  • Total dependent packages: 64
    (may contain duplicates)
  • Total dependent repositories: 2,671
    (may contain duplicates)
  • Total versions: 369
  • Total maintainers: 6
pypi.org: mmcv

OpenMMLab Computer Vision Foundation

  • Versions: 105
  • Dependent Packages: 38
  • Dependent Repositories: 1,786
  • Downloads: 108,815 Last month
  • Docker Downloads: 4,702
Rankings
Dependent repos count: 0.3%
Dependent packages count: 0.4%
Stargazers count: 0.4%
Average: 0.9%
Downloads: 1.0%
Forks count: 1.1%
Docker downloads count: 2.1%
Maintainers (2)
openmmlab kchen
Last synced: 6 months ago
pypi.org: mmcv-full

OpenMMLab Computer Vision Foundation

  • Versions: 60
  • Dependent Packages: 23
  • Dependent Repositories: 871
  • Downloads: 66,323 Last month
  • Docker Downloads: 15,796
Rankings
Dependent repos count: 0.4%
Stargazers count: 0.4%
Dependent packages count: 0.4%
Average: 0.9%
Forks count: 1.1%
Downloads: 1.4%
Docker downloads count: 2.0%
Maintainers (2)
openmmlab kchen
Last synced: 6 months ago
pypi.org: mmcv-lite

OpenMMLab Computer Vision Foundation

  • Versions: 8
  • Dependent Packages: 2
  • Dependent Repositories: 8
  • Downloads: 12,767 Last month
Rankings
Stargazers count: 0.4%
Forks count: 1.1%
Downloads: 3.1%
Average: 3.4%
Dependent repos count: 5.3%
Dependent packages count: 7.4%
Maintainers (1)
openmmlab
Last synced: 6 months ago
proxy.golang.org: github.com/open-mmlab/mmcv
  • Versions: 101
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Forks count: 0.6%
Stargazers count: 0.9%
Average: 5.1%
Dependent packages count: 8.4%
Dependent repos count: 10.6%
Last synced: 6 months ago
pypi.org: mmcv-nightly

OpenMMLab Computer Vision Foundation

  • Versions: 83
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 479 Last month
Rankings
Stargazers count: 0.4%
Forks count: 1.1%
Dependent packages count: 7.4%
Average: 7.9%
Downloads: 8.6%
Dependent repos count: 22.2%
Maintainers (3)
openmmlab kchen yl-1993
Last synced: 6 months ago
conda-forge.org: mmcv-full

MMCV is a foundational library for computer vision research and supports many research projects.

  • Versions: 5
  • Dependent Packages: 1
  • Dependent Repositories: 2
Rankings
Forks count: 3.9%
Stargazers count: 5.0%
Average: 14.5%
Dependent repos count: 20.0%
Dependent packages count: 28.9%
Last synced: 6 months ago
pypi.org: vitrox-mmcv

OpenMMLab Computer Vision Foundation

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 5 Last month
Rankings
Stargazers count: 0.4%
Forks count: 1.1%
Dependent packages count: 7.4%
Average: 17.3%
Dependent repos count: 22.2%
Downloads: 55.4%
Maintainers (1)
yeong-khang.lee
Last synced: 6 months ago
pypi.org: jcl-mmcv

test mmcv

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 6 Last month
Rankings
Stargazers count: 0.4%
Forks count: 1.1%
Dependent packages count: 7.4%
Average: 17.8%
Dependent repos count: 22.2%
Downloads: 57.7%
Maintainers (1)
jamesliang
Last synced: 6 months ago
pypi.org: vitrox-mmcv-full

OpenMMLab Computer Vision Foundation

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 5 Last month
Rankings
Stargazers count: 0.4%
Forks count: 1.1%
Dependent packages count: 7.4%
Average: 18.7%
Dependent repos count: 22.2%
Downloads: 62.5%
Maintainers (1)
yeong-khang.lee
Last synced: 6 months ago
pypi.org: mmcv-open2

OpenMMLab Computer Vision Foundation

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 10 Last month
Rankings
Dependent packages count: 10.6%
Average: 35.1%
Dependent repos count: 59.6%
Maintainers (1)
nisyad-ms
Last synced: 6 months ago
pypi.org: mmcv-open

OpenMMLab Computer Vision Foundation

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 13 Last month
Rankings
Dependent packages count: 10.6%
Average: 35.1%
Dependent repos count: 59.7%
Maintainers (1)
nisyad-ms
Last synced: 6 months ago

Dependencies

requirements/build.txt pypi
  • pytest-runner *
requirements/docs.txt pypi
  • docutils ==0.16.0
  • myst-parser *
  • opencv-python *
  • sphinx ==4.0.2
  • sphinx-copybutton *
  • sphinx_markdown_tables *
  • torch *
requirements/optional.txt pypi
  • ninja *
requirements/runtime.txt pypi
  • Pillow *
  • addict *
  • numpy *
  • packaging *
  • pyyaml *
  • regex *
  • yapf *
requirements/test.txt pypi
  • PyTurboJPEG *
  • coverage *
  • lmdb *
  • onnx ==1.7.0
  • onnxoptimizer *
  • onnxruntime >=1.8.0
  • protobuf *
  • pytest *
  • scipy *
  • tifffile *
.github/workflows/build_macos_wheel.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • actions/upload-artifact v3 composite
.github/workflows/lint.yml actions
  • DoozyX/clang-format-lint-action v0.11 composite
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
.github/workflows/merge_stage_test.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • codecov/codecov-action v1.0.14 composite
.github/workflows/pr_stage_test.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • codecov/codecov-action v1.0.14 composite
.github/workflows/publish-to-pypi.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v1 composite
.circleci/docker/Dockerfile docker
  • pytorch/pytorch ${PYTORCH}-cuda${CUDA}-cudnn${CUDNN}-devel build
docker/dev/Dockerfile docker
  • pytorch/pytorch ${PYTORCH}-cuda${CUDA}-cudnn${CUDNN}-devel build
docker/release/Dockerfile docker
  • pytorch/pytorch ${PYTORCH}-cuda${CUDA}-cudnn${CUDNN}-devel build
requirements.txt pypi
setup.py pypi