Skip to content

Commit b4deb31

Browse files
committed
Merge branch '1.x' of github.com:open-mmlab/mmgeneration into plyfager/restart-publish
2 parents e1a583e + e1d7c54 commit b4deb31

29 files changed

+250
-209
lines changed

.circleci/config.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ workflows:
2626
tools/.* lint_only false
2727
configs/.* lint_only false
2828
.circleci/.* lint_only false
29-
base-revision: dev-1.x
29+
base-revision: 1.x
3030
# this is the path of the configuration we should trigger once
3131
# path filtering and pipeline parameter value updates are
3232
# complete. In this case, we are using the parent dynamic

.circleci/test.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -145,15 +145,15 @@ workflows:
145145
torch: 1.6.0
146146
torchvision: 0.7.0
147147
python: 3.6.9 # The lowest python 3.6.x version available on CircleCI images
148-
mmcv: https://download.openmmlab.com/mmcv/dev-2.x/cpu/torch1.6.0/mmcv_full-2.0.0rc0-cp36-cp36m-manylinux1_x86_64.whl
148+
mmcv: https://download.openmmlab.com/mmcv/dist/cpu/torch1.6.0/mmcv-2.0.0rc1-cp36-cp36m-manylinux1_x86_64.whl
149149
requires:
150150
- lint
151151
- build_cpu:
152152
name: maximum_version_cpu
153153
torch: 1.9.0
154154
torchvision: 0.10.0
155155
python: 3.9.0
156-
mmcv: https://download.openmmlab.com/mmcv/dev-2.x/cpu/torch1.9.0/mmcv_full-2.0.0rc0-cp39-cp39-manylinux1_x86_64.whl
156+
mmcv: https://download.openmmlab.com/mmcv/dist/cpu/torch1.9.0/mmcv-2.0.0rc1-cp39-cp39-manylinux1_x86_64.whl
157157
requires:
158158
- minimum_version_cpu
159159
- hold:
@@ -166,7 +166,7 @@ workflows:
166166
# Use double quotation mark to explicitly specify its type
167167
# as string instead of number
168168
cuda: "10.2"
169-
mmcv: https://download.openmmlab.com/mmcv/dev-2.x/cu102/torch1.8.0/mmcv_full-2.0.0rc0-cp37-cp37m-manylinux1_x86_64.whl
169+
mmcv: https://download.openmmlab.com/mmcv/dist/cu102/torch1.8.0/mmcv-2.0.0rc1-cp37-cp37m-manylinux1_x86_64.whl
170170
requires:
171171
- hold
172172
merge_stage_test:
@@ -179,7 +179,7 @@ workflows:
179179
torch: 1.6.0
180180
# Use double quotation mark to explicitly specify its type
181181
# as string instead of number
182-
mmcv: https://download.openmmlab.com/mmcv/dev-2.x/cu101/torch1.6.0/mmcv_full-2.0.0rc0-cp37-cp37m-manylinux1_x86_64.whl
182+
mmcv: https://download.openmmlab.com/mmcv/dist/cu101/torch1.6.0/mmcv-2.0.0rc1-cp37-cp37m-manylinux1_x86_64.whl
183183
cuda: "10.1"
184184
filters:
185185
branches:

LICENSES.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
In this file, we list the operations with other licenses instead of Apache 2.0. Users should be careful about adopting these operations in any commercial matters.
44

5-
| Operation | Files | License |
6-
| :------------------: | :-----------------------------------------------------------------------------------------------------------------------------------: | :------------: |
7-
| conv2d_gradfix | [mmgen/ops/conv2d_gradfix.py](https://github.com/open-mmlab/mmgeneration/blob/master/mmgen/ops/conv2d_gradfix.py) | NVIDIA License |
8-
| compute_pr_distances | [mmgen/core/evaluation/metric_utils.py](https://github.com/open-mmlab/mmgeneration/blob/master/mmgen/core/evaluation/metric_utils.py) | NVIDIA License |
5+
| Operation | Files | License |
6+
| :------------------: | :--------------------------------------------------------------------------------------------------------------------------------: | :------------: |
7+
| conv2d_gradfix | [mmgen/ops/conv2d_gradfix.py](https://github.com/open-mmlab/mmgeneration/blob/1.x/mmgen/ops/conv2d_gradfix.py) | NVIDIA License |
8+
| compute_pr_distances | [mmgen/core/evaluation/metric_utils.py](https://github.com/open-mmlab/mmgeneration/blob/1.x/mmgen/core/evaluation/metric_utils.py) | NVIDIA License |

README.md

Lines changed: 49 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -20,36 +20,36 @@
2020
</div>
2121

2222
[![PyPI](https://img.shields.io/pypi/v/mmgen)](https://pypi.org/project/mmgen)
23-
[![docs](https://img.shields.io/badge/docs-latest-blue)](https://mmgeneration.readthedocs.io/en/latest/)
23+
[![docs](https://img.shields.io/badge/docs-latest-blue)](https://mmgeneration.readthedocs.io/en/1.x/)
2424
[![badge](https://github.com/open-mmlab/mmgeneration/workflows/build/badge.svg)](https://github.com/open-mmlab/mmgeneration/actions)
25-
[![codecov](https://codecov.io/gh/open-mmlab/mmgeneration/branch/master/graph/badge.svg)](https://codecov.io/gh/open-mmlab/mmgeneration)
26-
[![license](https://img.shields.io/github/license/open-mmlab/mmgeneration.svg)](https://github.com/open-mmlab/mmgeneration/blob/master/LICENSE)
25+
[![codecov](https://codecov.io/gh/open-mmlab/mmgeneration/branch/1.x/graph/badge.svg)](https://codecov.io/gh/open-mmlab/mmgeneration)
26+
[![license](https://img.shields.io/github/license/open-mmlab/mmgeneration.svg)](https://github.com/open-mmlab/mmgeneration/blob/1.x/LICENSE)
2727
[![open issues](https://isitmaintained.com/badge/open/open-mmlab/mmgeneration.svg)](https://github.com/open-mmlab/mmgeneration/issues)
2828
[![issue resolution](https://isitmaintained.com/badge/resolution/open-mmlab/mmgeneration.svg)](https://github.com/open-mmlab/mmgeneration/issues)
2929

30-
[📘Documentation](https://mmgeneration.readthedocs.io/en/latest/) |
31-
[🛠️Installation](https://mmgeneration.readthedocs.io/en/latest/get_started.html#installation) |
32-
[👀Model Zoo](https://mmgeneration.readthedocs.io/en/latest/modelzoo_statistics.html) |
33-
[🆕Update News](https://github.com/open-mmlab/mmgeneration/blob/master/docs/en/changelog.md) |
30+
[📘Documentation](https://mmgeneration.readthedocs.io/en/1.x/) |
31+
[🛠️Installation](https://mmgeneration.readthedocs.io/en/1.x/get_started.html#installation) |
32+
[👀Model Zoo](https://mmgeneration.readthedocs.io/en/1.x/modelzoo_statistics.html) |
33+
[🆕Update News](https://github.com/open-mmlab/mmgeneration/blob/1.x/docs/en/notes/changelog.md) |
3434
[🚀Ongoing Projects](https://github.com/open-mmlab/mmgeneration/projects) |
3535
[🤔Reporting Issues](https://github.com/open-mmlab/mmgeneration/issues)
3636

3737
English | [简体中文](README_zh-CN.md)
3838

3939
## Introduction
4040

41-
MMGeneration is a powerful toolkit for generative models, especially for GANs now. It is based on PyTorch and [MMCV](https://github.com/open-mmlab/mmcv). The master branch works with **PyTorch 1.5+**.
41+
MMGeneration is a powerful toolkit for generative models, especially for GANs now. It is based on PyTorch and [MMCV](https://github.com/open-mmlab/mmcv/tree/2.x). The master branch works with **PyTorch 1.5+**.
4242

4343
<div align="center">
4444
<img src="https://user-images.githubusercontent.com/12726765/114534478-9a65a900-9c81-11eb-8087-de8b6816eed8.png" width="800"/>
4545
</div>
4646

4747
## Major Features
4848

49-
- **High-quality Training Performance:** We currently support training on Unconditional GANs, Internal GANs, and Image Translation Models. Support for conditional models will come soon.
50-
- **Powerful Application Toolkit:** A plentiful toolkit containing multiple applications in GANs is provided to users. GAN interpolation, GAN projection, and GAN manipulations are integrated into our framework. It's time to play with your GANs! ([Tutorial for applications](docs/en/tutorials/applications.md))
51-
- **Efficient Distributed Training for Generative Models:** For the highly dynamic training in generative models, we adopt a new way to train dynamic models with `MMDDP`. ([Tutorial for DDP](docs/en/tutorials/ddp_train_gans.md))
52-
- **New Modular Design for Flexible Combination:** A new design for complex loss modules is proposed for customizing the links between modules, which can achieve flexible combination among different modules. ([Tutorial for new modular design](docs/en/tutorials/customize_losses.md))
49+
- **High-quality Training Performance:** MMGeneration currently support training on Unconditional GANs, Conditional GANs, Internal GANs, Image Translation Models, and Diffusion Models.
50+
- **Powerful Application Toolkit:** A toolkit that provides plentiful applications to users. MMGeneration supports GAN interpolation, GAN projection, GAN manipulations and many other popular GAN's applications. It's time to play with your GANs! ([Tutorial for applications](docs/en/advanced_guides/applications.md))
51+
- **Efficient Distributed Training for Generative Models:** With support of [MMSeparateDistributedDataParallel](https://github.com/open-mmlab/mmengine/blob/main/mmengine/model/wrappers/seperate_distributed.py), distributed training for dynamic architectures can be easily implemented.
52+
- **New Modular Design for Flexible Combination:** A new design for complex loss modules is proposed for customizing the links between modules, which can achieve flexible combination among different modules.(Tutorial for [losses](docs/en/advanced_guides/losses.md))
5353

5454
<table>
5555
<thead>
@@ -88,13 +88,22 @@ MMGeneration is a powerful toolkit for generative models, especially for GANs no
8888
- Conditional GANs have been supported in our toolkit. More methods and pre-trained weights will come soon.
8989
- Mixed-precision training (FP16) for StyleGAN2 has been supported. Please check [the comparison](configs/styleganv2/README.md) between different implementations.
9090

91-
## Changelog
91+
## What's new
9292

93-
v0.7.1 was released on 30/04/2022. Please refer to [changelog.md](docs/en/changelog.md) for details and release history.
93+
v1.0.0rc0 was released in 31/8/2022.
94+
95+
This release introduced a brand new and flexible training & test engine, but it's still in progress. Welcome
96+
to try according to [the documentation](https://mmgeneration.readthedocs.io/en/1.x/).
97+
98+
And there are some BC-breaking changes. Please check [the migration tutorial](https://mmgeneration.readthedocs.io/en/1.x/migration.html).
99+
100+
The release candidate will last until the end of 2022, and during the release candidate, we will develop on the `1.x` branch. And we will still maintain 0.x version still at least the end of 2023.
101+
102+
Please refer to [changelog.md](https://mmgeneration.readthedocs.io/en/1.x/notes/changelog.html) for more details and other release history.
94103

95104
## Installation
96105

97-
MMGeneration depends on [PyTorch](https://pytorch.org/) and [MMCV](https://github.com/open-mmlab/mmcv).
106+
MMGeneration depends on [PyTorch](https://pytorch.org/) and [MMCV](https://github.com/open-mmlab/mmcv/tree/2.x).
98107
Below are quick steps for installation.
99108

100109
**Step 1.**
@@ -109,15 +118,16 @@ pip3 install torch torchvision
109118
Install MMCV with [MIM](https://github.com/open-mmlab/mim).
110119

111120
```
112-
pip3 install openmim
113-
mim install mmcv-full
121+
pip install -U openmim
122+
# wait for more pre-compiled pkgs to release
123+
mim install 'mmcv>=2.0.0rc1'
114124
```
115125

116126
**Step 3.**
117127
Install MMGeneration from source.
118128

119129
```
120-
git clone https://github.com/open-mmlab/mmgeneration.git
130+
git clone -b 1.x https://github.com/open-mmlab/mmgeneration.git
121131
cd mmgeneration
122132
pip3 install -e .[all]
123133
```
@@ -126,7 +136,7 @@ Please refer to [get_started.md](docs/en/get_started.md) for more detailed instr
126136

127137
## Getting Started
128138

129-
Please see [get_started.md](docs/en/get_started.md) for the basic usage of MMGeneration. [docs/en/quick_run.md](docs/en/quick_run.md) can offer full guidance for quick run. For other details and tutorials, please go to our [documentation](https://mmgeneration.readthedocs.io/).
139+
Please see [get_started.md](docs/en/get_started.md) for the basic usage of MMGeneration. For other details and tutorials, please go to our [documentation](https://mmgeneration.readthedocs.io/en/1.x/).
130140

131141
## ModelZoo
132142

@@ -185,7 +195,7 @@ These methods have been carefully studied and supported in our frameworks:
185195

186196
## Contributing
187197

188-
We appreciate all contributions to improve MMGeneration. Please refer to [CONTRIBUTING.md](https://github.com/open-mmlab/mmcv/blob/master/CONTRIBUTING.md) in MMCV for more details about the contributing guideline.
198+
We appreciate all contributions to improve MMGeneration. Please refer to [CONTRIBUTING.md](https://github.com/open-mmlab/mmcv/tree/2.x/CONTRIBUTING.md) in MMCV and \[https://github.com/open-mmlab/mmengine/blob/main/CONTRIBUTING.md\] in MMEngine for more details about the contributing guideline.
189199

190200
## Citation
191201

@@ -204,24 +214,25 @@ If you find this project useful in your research, please consider cite:
204214

205215
This project is released under the [Apache 2.0 license](LICENSE). Some operations in `MMGeneration` are with other licenses instead of Apache2.0. Please refer to [LICENSES.md](LICENSES.md) for the careful check, if you are using our code for commercial matters.
206216

207-
## Projects in OpenMMLab
217+
## Projects in OpenMMLab 2.0
208218

209-
- [MMCV](https://github.com/open-mmlab/mmcv): OpenMMLab foundational library for computer vision.
219+
- [MMEngine](https://github.com/open-mmlab/mmengine): OpenMMLab foundational library for training deep learning models.
220+
- [MMCV](https://github.com/open-mmlab/mmcv/tree/2.x): OpenMMLab foundational library for computer vision.
210221
- [MIM](https://github.com/open-mmlab/mim): MIM installs OpenMMLab packages.
211-
- [MMClassification](https://github.com/open-mmlab/mmclassification): OpenMMLab image classification toolbox and benchmark.
212-
- [MMDetection](https://github.com/open-mmlab/mmdetection): OpenMMLab detection toolbox and benchmark.
213-
- [MMDetection3D](https://github.com/open-mmlab/mmdetection3d): OpenMMLab's next-generation platform for general 3D object detection.
214-
- [MMRotate](https://github.com/open-mmlab/mmrotate): OpenMMLab rotated object detection toolbox and benchmark.
215-
- [MMSegmentation](https://github.com/open-mmlab/mmsegmentation): OpenMMLab semantic segmentation toolbox and benchmark.
216-
- [MMOCR](https://github.com/open-mmlab/mmocr): OpenMMLab text detection, recognition, and understanding toolbox.
217-
- [MMPose](https://github.com/open-mmlab/mmpose): OpenMMLab pose estimation toolbox and benchmark.
218-
- [MMHuman3D](https://github.com/open-mmlab/mmhuman3d): OpenMMLab 3D human parametric model toolbox and benchmark.
219-
- [MMSelfSup](https://github.com/open-mmlab/mmselfsup): OpenMMLab self-supervised learning toolbox and benchmark.
220-
- [MMRazor](https://github.com/open-mmlab/mmrazor): OpenMMLab model compression toolbox and benchmark.
221-
- [MMFewShot](https://github.com/open-mmlab/mmfewshot): OpenMMLab fewshot learning toolbox and benchmark.
222-
- [MMAction2](https://github.com/open-mmlab/mmaction2): OpenMMLab's next-generation action understanding toolbox and benchmark.
223-
- [MMTracking](https://github.com/open-mmlab/mmtracking): OpenMMLab video perception toolbox and benchmark.
224-
- [MMFlow](https://github.com/open-mmlab/mmflow): OpenMMLab optical flow toolbox and benchmark.
225-
- [MMEditing](https://github.com/open-mmlab/mmediting): OpenMMLab image and video editing toolbox.
226-
- [MMGeneration](https://github.com/open-mmlab/mmgeneration): OpenMMLab image and video generative models toolbox.
222+
- [MMClassification](https://github.com/open-mmlab/mmclassification/tree/1.x): OpenMMLab image classification toolbox and benchmark.
223+
- [MMDetection](https://github.com/open-mmlab/mmdetection/tree/3.x): OpenMMLab detection toolbox and benchmark.
224+
- [MMDetection3D](https://github.com/open-mmlab/mmdetection3d/tree/1.x): OpenMMLab's next-generation platform for general 3D object detection.
225+
- [MMRotate](https://github.com/open-mmlab/mmrotate/tree/1.x): OpenMMLab rotated object detection toolbox and benchmark.
226+
- [MMSegmentation](https://github.com/open-mmlab/mmsegmentation/tree/1.x): OpenMMLab semantic segmentation toolbox and benchmark.
227+
- [MMOCR](https://github.com/open-mmlab/mmocr/tree/1.x): OpenMMLab text detection, recognition, and understanding toolbox.
228+
- [MMPose](https://github.com/open-mmlab/mmpose/tree/1.x): OpenMMLab pose estimation toolbox and benchmark.
229+
- [MMHuman3D](https://github.com/open-mmlab/mmhuman3d/tree/1.x): OpenMMLab 3D human parametric model toolbox and benchmark.
230+
- [MMSelfSup](https://github.com/open-mmlab/mmselfsup/tree/1.x): OpenMMLab self-supervised learning toolbox and benchmark.
231+
- [MMRazor](https://github.com/open-mmlab/mmrazor/tree/1.x): OpenMMLab model compression toolbox and benchmark.
232+
- [MMFewShot](https://github.com/open-mmlab/mmfewshot/tree/1.x): OpenMMLab fewshot learning toolbox and benchmark.
233+
- [MMAction2](https://github.com/open-mmlab/mmaction2/tree/1.x): OpenMMLab's next-generation action understanding toolbox and benchmark.
234+
- [MMTracking](https://github.com/open-mmlab/mmtracking/tree/1.x): OpenMMLab video perception toolbox and benchmark.
235+
- [MMFlow](https://github.com/open-mmlab/mmflow/tree/1.x): OpenMMLab optical flow toolbox and benchmark.
236+
- [MMEditing](https://github.com/open-mmlab/mmediting/tree/1.x): OpenMMLab image and video editing toolbox.
237+
- [MMGeneration](https://github.com/open-mmlab/mmgeneration/tree/1.x): OpenMMLab image and video generative models toolbox.
227238
- [MMDeploy](https://github.com/open-mmlab/mmdeploy): OpenMMLab model deployment framework.

0 commit comments

Comments
 (0)