-
Notifications
You must be signed in to change notification settings - Fork 574
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update get_started.md #16
Conversation
Thank you for your PR, which is very helpful to us! |
@RangeKing There is already PR here. Can you review it? |
docs/zh_cn/get_started.md
Outdated
|
||
# multi-node in slurm environment | ||
python tools/test.py ${CONFIG_FILE} ${CHECKPOINT_FILE} [optional arguments] --launcher slurm | ||
# slurm环境中多个节点 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
slurm 环境中,一般情况下中英文之间有空格会使得文档更加美观
docs/zh_cn/get_started.md
Outdated
|
||
# multi-gpu | ||
./tools/dist_test.sh ${CONFIG_FILE} ${CHECKPOINT_FILE} ${GPU_NUM} [optional arguments] | ||
# 多个GPU |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
多个 GPU
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- 单个 GPU
- 单个节点多个 GPU
- 多个节点多个 GPU
文档开始的这三段中英文之间也需要空格吗?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes
docs/zh_cn/get_started.md
Outdated
python tools/train.py ${CONFIG_FILE} [可选参数] | ||
``` | ||
|
||
如果您想在命令行中指定工作路径,您可以增加参数`--work_dir ${YOUR_WORK_DIR}`。 | ||
如果您想在命令行中指定工作路径,您可以增加参数`--work_dir ${您的工作目录}`。 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
${} 和 [] 中都不需要翻译
代码相关的都不翻译
docs/zh_cn/get_started.md
Outdated
If you have just multiple machines connected with ethernet, you can refer to | ||
PyTorch [launch utility](https://pytorch.org/docs/stable/distributed_deprecated.html#launch-utility). | ||
Usually it is slow if you do not have high speed networking like InfiniBand. | ||
如果您有多台机器联网,您可以参考 PyTorch [launch utility](https://pytorch.org/docs/stable/distributed_deprecated.html#launch-utility). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
需要修改成中文句号
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
已经修改
docs/zh_cn/get_started.md
Outdated
|
||
```shell | ||
python tools/train.py ${CONFIG_FILE} [optional arguments] | ||
``` | ||
|
||
If you want to specify the working directory in the command, you can add an argument `--work_dir ${YOUR_WORK_DIR}`. | ||
如果您想在命令行中指定工作路径,您可以增加参数`--work_dir ${YOUR_WORK_DIR}`。 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
缺少空格
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
已经修改
docs/zh_cn/get_started.md
Outdated
```shell | ||
./tools/dist_test.sh \ | ||
configs/rotated_retinanet/rotated_retinanet_obb_r50_fpn_1x_dota_le90.py \ | ||
checkpoints/SOME_CHECKPOINT.pth 1 --format-only \ | ||
--eval-options submission_dir=work_dirs/Task1_results | ||
``` | ||
|
||
You can change the test set path in the [data_root](.../configs/_base_/datasets/dotav1.py) to the val set or trainval set for the offline evaluation. | ||
您可以修改 [data_root] (.../configs/_base_/datasets/dotav1.py) 中测试集的路径为验证集或训练集路径用于离线的验证。 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
这里 [] 与 () 被空格分开了,markdown 无法识别连接
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
已经修改
docs/zh_cn/get_started.md
Outdated
PyTorch [launch utility](https://pytorch.org/docs/stable/distributed_deprecated.html#launch-utility). | ||
Usually it is slow if you do not have high speed networking like InfiniBand. | ||
如果您有多台机器联网,您可以参考 PyTorch [launch utility](https://pytorch.org/docs/stable/distributed_deprecated.html#launch-utility)。 | ||
如果您没有如无线带宽技术的高速网络,通常训练速度会很慢。 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
如果您没有像 InfiniBand 这样的高速网络,训练速度通常会很慢。
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
已经修改
docs/zh_cn/get_started.md
Outdated
|
||
### 多机多 GPU 训练 | ||
|
||
如果您在 [slurm] (https://slurm.schedmd.com/) 管理的集群上运行 MMRotate,您可以使用脚本 `slurm_train.sh` (此脚本还支持单机训练)。 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
这里也被分开了
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
已经修改
docs/zh_cn/get_started.md
Outdated
```shell | ||
./tools/dist_test.sh \ | ||
configs/rotated_retinanet/rotated_retinanet_obb_r50_fpn_1x_dota_le90.py \ | ||
checkpoints/SOME_CHECKPOINT.pth 1 --format-only \ | ||
--eval-options submission_dir=work_dirs/Task1_results | ||
``` | ||
|
||
You can change the test set path in the [data_root](.../configs/_base_/datasets/dotav1.py) to the val set or trainval set for the offline evaluation. | ||
您可以修改 [data_root](.../configs/_base_/datasets/dotav1.py) 中测试集的路径为验证集或训练集路径用于离线的验证。 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
这里有一个路径错误:
../../configs/base/datasets/dotav1.py
麻烦在英文版本的get_started.md里也修改一下,谢谢!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
好的,稍后修改
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
我认为可以通过了。
line 125 fix "ang" -> "and"
Thanks for your contribution and we appreciate it a lot. The following instructions would make your pull request more healthy and more easily get feedback. If you do not understand some items, don't worry, just make the pull request and seek help from maintainers.
Motivation
line 125 fix "ang" -> "and"
Modification
Please briefly describe what modification is made in this PR.
BC-breaking (Optional)
Does the modification introduce changes that break the back-compatibility of the downstream repos?
If so, please describe how it breaks the compatibility and how the downstream projects should modify their code to keep compatibility with this PR.
Use cases (Optional)
If this PR introduces a new feature, it is better to list some use cases here, and update the documentation.
Checklist