mmocr/projects/example_project
Tong Gao 06a20fae71
[Community] Add 'Projects/' folder, and the first example project (#1524)
* [Community] Add the first example project

* amend

* update

* update readme
2022-11-16 16:49:05 +08:00
..
configs [Community] Add 'Projects/' folder, and the first example project (#1524) 2022-11-16 16:49:05 +08:00
dummy [Community] Add 'Projects/' folder, and the first example project (#1524) 2022-11-16 16:49:05 +08:00
README.md [Community] Add 'Projects/' folder, and the first example project (#1524) 2022-11-16 16:49:05 +08:00

README.md

Dummy ResNet Wrapper

This is an example README for community projects/. We have provided detailed explanations for each field in the form of html comments, which are visible when you read the source of this README file. If you wish to submit your project to our main repository, then all the fields in this README are mandatory for others to understand what you have achieved in this implementation. For more details, read our contribution guide or approach us in Discussions.

Description

This project implements a dummy ResNet wrapper, which literally does nothing new but prints "hello world" during initialization.

Usage

Training commands

In MMOCR's root directory, run the following command to train the model:

python tools/train.py projects/example_project/configs/dbnet_dummy-resnet_fpnc_1200e_icdar2015.py

Testing commands

In MMOCR's root directory, run the following command to test the model:

python tools/test.py projects/example_project/confsigs/dbnet_dummy-resnet_fpnc_1200e_icdar2015.py ${CHECKPOINT_PATH}

Results

Method Backbone Pretrained Model Training set Test set #epoch Test size Precision Recall Hmean Download
DBNet_dummy DummyResNet - ICDAR2015 Train ICDAR2015 Test 1200 736 0.8853 0.7583 0.8169 model | log

Citation

@software{MMOCR_Contributors_OpenMMLab_Text_Detection_2020,
author = {{MMOCR Contributors}},
license = {Apache-2.0},
month = {8},
title = {{OpenMMLab Text Detection, Recognition and Understanding Toolbox}},
url = {https://github.com/open-mmlab/mmocr},
version = {0.3.0},
year = {2020}
}

Checklist

  • Milestone 1: PR-ready, and acceptable to be one of the projects/.

    • Finish the code

    • Basic docstrings & proper citation

    • Test-time correctness

    • A full README

  • Milestone 2: Indicates a successful model implementation.

    • Training-time correctness

  • Milestone 3: Good to be a part of our core package!

    • Type hints and docstrings

    • Unit tests

    • Code polishing

    • Metafile.yml

  • Move your modules into the core package following the codebase's file hierarchy structure.

  • Refactor your modules into the core package following the codebase's file hierarchy structure.