From fb0c1f0934fb6f06d8c6fce18979baf0d8b0f9a4 Mon Sep 17 00:00:00 2001 From: wHao-Wu Date: Mon, 12 Jul 2021 20:40:56 +0800 Subject: [PATCH 1/4] [Docs] Chinese Document of faq --- docs/faq.md | 11 ++--------- docs_zh-CN/faq.md | 16 ++++++++++++++++ 2 files changed, 18 insertions(+), 9 deletions(-) diff --git a/docs/faq.md b/docs/faq.md index f071adeb3b..f9411a0ebc 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -10,15 +10,8 @@ We list some potential troubles encountered by users and developers, along with please downgrade open3d to 0.9.0.0, because the latest open3d needs the support of file 'GLIBC_2.27', which only exists in Ubuntu 18.04, not in Ubuntu 16.04. -- If you faced the error when importing pycocotools, this is because nuscenes-devkit installs pycocotools but mmdet relies on mmpycocotools. The current workaround is as below. We will migrate to use pycocotools in the future. - - ```shell - pip uninstall pycocotools mmpycocotools - pip install mmpycocotools - ``` - -- If you face the error shown below, and your environment contains numba == 0.48.0 with numpy >= 1.20.0 +- If you face the error shown below, and your environment contains numba == 0.48.0 with numpy >= 1.20.0: ``TypeError: expected dtype object, got 'numpy.dtype[bool_]'`` - please downgrade numpy to < 1.20.0 or install numba == 0.48 from source, because in numpy==1.20.0, `np.dtype` produces subclass due to API change. + please downgrade numpy to < 1.20.0 or install numba == 0.48 from source, because in numpy == 1.20.0, `np.dtype` produces subclass due to API change. diff --git a/docs_zh-CN/faq.md b/docs_zh-CN/faq.md index 99ca2f840c..25e88e610e 100644 --- a/docs_zh-CN/faq.md +++ b/docs_zh-CN/faq.md @@ -1 +1,17 @@ # 常见问题解答 + +我们列出了一些用户和开发者在开发过程中会遇到的一些常见问题以及对应的解决方案，如果您发现了任何频繁出现的问题，请随时扩充本列表，并且非常欢迎您提出的任何解决方案。如果您在环境配置、模型训练等工作中遇到任何的问题，请使用[问题模板](https://github.com/open-mmlab/mmdetection3d/blob/master/.github/ISSUE_TEMPLATE/error-report.md/)来创建相应的 issue ,并将所需的所有信息填入到问题模板中，我们会尽快解决您的问题。 + +## MMCV/MMDet/MMDet3D Installation + +- 如果您在 `import open3d` 时遇到下面的问题： + + ``OSError: /lib/x86_64-linux-gnu/libm.so.6: version 'GLIBC_2.27' not found`` + + 请将 open3d 的版本降级至 0.9.0.0，因为最新版 open3d 需要 'GLIBC_2.27' 文件的支持， Ubuntu 16.04 系统中缺失该文件，且该文件仅存在于 Ubuntu 18.04 及之后的系统中。 + +- 如果您遇到下面的问题，并且您的环境包含 numba == 0.48.0 和 numpy >= 1.20.0： + + ``TypeError: expected dtype object, got 'numpy.dtype[bool_]'`` + + 请将 numpy 的版本降级至 < 1.20.0，或者从源码安装 numba == 0.48，这是由于 numpy == 1.20.0 改变了 API，使得在调用 `np.dtype` 会产生子类。 From 4cde1dfeb43119354c9ea4a02e0ce8e7ac5c74f3 Mon Sep 17 00:00:00 2001 From: wHao-Wu Date: Mon, 12 Jul 2021 20:55:11 +0800 Subject: [PATCH 2/4] Deprecated pycocotools faq --- docs/faq.md | 9 +++++++++ docs_zh-CN/faq.md | 9 +++++++++ 2 files changed, 18 insertions(+) diff --git a/docs/faq.md b/docs/faq.md index f9411a0ebc..2f23896aa4 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -10,6 +10,15 @@ We list some potential troubles encountered by users and developers, along with please downgrade open3d to 0.9.0.0, because the latest open3d needs the support of file 'GLIBC_2.27', which only exists in Ubuntu 18.04, not in Ubuntu 16.04. +- If you faced the error when importing pycocotools, this is because nuscenes-devkit installs pycocotools but mmdet relies on mmpycocotools. The current workaround is as below. We will migrate to use pycocotools in the future. + + ```shell + pip uninstall pycocotools mmpycocotools + pip install mmpycocotools + ``` + + **NOTE**: We have migrated to use pycocotools in mmdet3d >= 0.13.0. + - If you face the error shown below, and your environment contains numba == 0.48.0 with numpy >= 1.20.0: ``TypeError: expected dtype object, got 'numpy.dtype[bool_]'`` diff --git a/docs_zh-CN/faq.md b/docs_zh-CN/faq.md index 25e88e610e..5cac1b01c7 100644 --- a/docs_zh-CN/faq.md +++ b/docs_zh-CN/faq.md @@ -10,6 +10,15 @@ 请将 open3d 的版本降级至 0.9.0.0，因为最新版 open3d 需要 'GLIBC_2.27' 文件的支持， Ubuntu 16.04 系统中缺失该文件，且该文件仅存在于 Ubuntu 18.04 及之后的系统中。 +- 如果您在 `import pycocotools` 时遇到版本错误的问题，这是由于 nuscenes-devkit 需要安装 pycocotools，然而 mmdet 依赖于 mmpycocotools，当前的解决方案如下所示，我们将会在之后全面支持 pycocotools ： + + ```shell + pip uninstall pycocotools mmpycocotools + pip install mmpycocotools + ``` + + **注意**： 我们已经在 0.13.0 及之后的版本中全面支持 pycocotools。 + - 如果您遇到下面的问题，并且您的环境包含 numba == 0.48.0 和 numpy >= 1.20.0： ``TypeError: expected dtype object, got 'numpy.dtype[bool_]'`` From b7f96e7466ded1ce65b221eab004a25f4a62ce9b Mon Sep 17 00:00:00 2001 From: wHao-Wu Date: Wed, 14 Jul 2021 20:21:26 +0800 Subject: [PATCH 3/4] refine doc --- docs_zh-CN/faq.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs_zh-CN/faq.md b/docs_zh-CN/faq.md index 5cac1b01c7..0e9c7263a5 100644 --- a/docs_zh-CN/faq.md +++ b/docs_zh-CN/faq.md @@ -1,6 +1,6 @@ # 常见问题解答 -我们列出了一些用户和开发者在开发过程中会遇到的一些常见问题以及对应的解决方案，如果您发现了任何频繁出现的问题，请随时扩充本列表，并且非常欢迎您提出的任何解决方案。如果您在环境配置、模型训练等工作中遇到任何的问题，请使用[问题模板](https://github.com/open-mmlab/mmdetection3d/blob/master/.github/ISSUE_TEMPLATE/error-report.md/)来创建相应的 issue ,并将所需的所有信息填入到问题模板中，我们会尽快解决您的问题。 +我们列出了一些用户和开发者在开发过程中会遇到的常见问题以及对应的解决方案，如果您发现了任何频繁出现的问题，请随时扩充本列表，非常欢迎您提出的任何解决方案。如果您在环境配置、模型训练等工作中遇到任何的问题，请使用[问题模板](https://github.com/open-mmlab/mmdetection3d/blob/master/.github/ISSUE_TEMPLATE/error-report.md/)来创建相应的 issue,并将所需的所有信息填入到问题模板中，我们会尽快解决您的问题。 ## MMCV/MMDet/MMDet3D Installation From 615cb1ee088749f400ad99e92c6f3ab9050bfc49 Mon Sep 17 00:00:00 2001 From: wHao-Wu Date: Wed, 21 Jul 2021 10:50:24 +0800 Subject: [PATCH 4/4] refine numba doc --- docs/faq.md | 2 +- docs_zh-CN/faq.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/faq.md b/docs/faq.md index 2f23896aa4..f226ea62d0 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -23,4 +23,4 @@ We list some potential troubles encountered by users and developers, along with ``TypeError: expected dtype object, got 'numpy.dtype[bool_]'`` - please downgrade numpy to < 1.20.0 or install numba == 0.48 from source, because in numpy == 1.20.0, `np.dtype` produces subclass due to API change. + please downgrade numpy to < 1.20.0 or install numba == 0.48 from source, because in numpy == 1.20.0, `np.dtype` produces subclass due to API change. Please refer to [here](https://github.com/numba/numba/issues/6041) for more details. diff --git a/docs_zh-CN/faq.md b/docs_zh-CN/faq.md index 0e9c7263a5..91e6132fdf 100644 --- a/docs_zh-CN/faq.md +++ b/docs_zh-CN/faq.md @@ -23,4 +23,4 @@ ``TypeError: expected dtype object, got 'numpy.dtype[bool_]'`` - 请将 numpy 的版本降级至 < 1.20.0，或者从源码安装 numba == 0.48，这是由于 numpy == 1.20.0 改变了 API，使得在调用 `np.dtype` 会产生子类。 + 请将 numpy 的版本降级至 < 1.20.0，或者从源码安装 numba == 0.48，这是由于 numpy == 1.20.0 改变了 API，使得在调用 `np.dtype` 会产生子类。请参考 [这里](https://github.com/numba/numba/issues/6041) 获取更多细节。