[CodeCamp2023-259]Document Writing: Advanced Tutorial - Custom Data Augmentation

[chaodyna]

Motivation

To add advanced tutorial: customize_transforms in zh_CN and en language.
添加了 [进阶教程：自定义数据变换和增强] 文档的简体中文和英文版本。

Modification

Added customize_transforms.md in the docs/advanced directory. The transforms.md file provides a preliminary analysis of data transformation and data augmentation.
补充了docs/advanced目录下的customize_transforms.md 文件，对数据变换和数据增强做了初步的分析

BC-breaking (Optional)

Use cases (Optional)

Checklist

Before PR:

• I have read and followed the workflow indicated in the CONTRIBUTING.md to create this PR.
• Pre-commit or linting tools indicated in CONTRIBUTING.md are used to fix the potential lint issues.
• Bug fixes are covered by unit tests, the case that causes the bug should be added in the unit tests.
• New functionalities are covered by complete unit tests. If not, please add more unit tests to ensure correctness.
• The documentation has been modified accordingly, including docstring or example tutorials.

After PR:

• CLA has been signed and all committers have signed the CLA in this PR.

[CLAassistant]

All committers have signed the CLA.

[Tau-J]

In this tutorial, please use MMPose's TRANSFORMS to give the example. Please avoid to use mmcv if it is not necessary.

[chaodyna]

Thanks for your comment, It seems that I need to modification and correction. There are stil a lot to learn for me (

[Tau-J]

Thanks for you contribution. As an advanced tutorial of MMPose, I think it is necessary to make sure all contents are related to MMPose (e.g. the code examples, the registry you use etc.) Please do not directly copy and paste the example from tutorial of MMEngine.

[Tau-J]

Hi @chaodyna , since your pr branch lags behind our current dev-1.x. Please conduct following process to rebase your branch:

# switch to your forked dev-1.x
git checkout dev-1.x

# pull latest version of dev-1.x
git pull upstream dev-1.x

# switch back to your branch
git checkout chaodyna/advanced_customize_transforms_doc

# rebase dev-1.x
git rebase dev-1.x

# update your pr
git push origin chaodyna/advanced_customize_transforms_doc -f

If you meet any problem during this process, please feel free to contact us.

[chaodyna]

Thanks for your guidance! I just followed to pull my forked branch. If there is any need to improve or supplement, It's my expectation to help myself better.

[Tau-J]

Hello @chaodyna , the document after your recent modifications is much improved compared to before. I hope you could further expand on the section about the RandomFlip example. Please inform users that the key to custom data augmentation lies in writing the transform() function. Also, explain the input and output format and content of the 'transform()' function.

[chaodyna]

Thank you for your correction. I will complete my work well as learning more about data processing.

…

---- Replied Message ---- | From | ***@***.***> | | Date | 08/20/2023 23:34 | | To | ***@***.***> | | Cc | ***@***.***>***@***.***> | | Subject | Re: [open-mmlab/mmpose] [CodeCamp2023-259]Document Writing: Advanced Tutorial - Custom Data Augmentation (PR #2605) | Hello @chaodyna , the document after your recent modifications is much improved compared to before. I hope you could further expand on the section about the RandomFlip example. Please inform users that the key to custom data augmentation lies in writing the transform() function. Also, explain the input and output format and content of the 'transform()' function. — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you were mentioned.Message ID: ***@***.***>

[OpenMMLab-Assistant-004]

Hi @chaodyna,

We'd like to express our appreciation for your valuable contributions to the mmpose. Your efforts have significantly aided in enhancing the project's quality.
It is our pleasure to invite you to join our community thorugh Discord_Special Interest Group (SIG) channel. This is a great place to share your experiences, discuss ideas, and connect with other like-minded people. To become a part of the SIG channel, send a message to the moderator, OpenMMLab, briefly introduce yourself and mention your open-source contributions in the #introductions channel. Our team will gladly facilitate your entry. We eagerly await your presence. Please follow this link to join us: ​https://discord.gg/UjgXkPWNqA.

If you're on WeChat, we'd also love for you to join our community there. Just add our assistant using the WeChat ID: openmmlabwx. When sending the friend request, remember to include the remark "mmsig + Github ID".

Thanks again for your awesome contribution, and we're excited to have you as part of our community!

[Tau-J]

Hi @chaodyna , would you please save this diagram as an image and upload it? Our doc is based on readthedocs and it seems that the diagram cannot be rendered.

[Tau-J]

You can check the compiled docs here:

[chaodyna]

Well, The flowchart is already in the assets and was wrote so well🤣. I changed the linking image to mermaid.live, which is a useful tool and seems like steady to use. If there is any necessity to renovate and amend, I would like to learn from other friends and read the docs since it' been some time.

[Tau-J]

LGTM