MindInsight文档
================

MindInsight是昇思MindSpore的可视化调试调优工具。利用MindInsight，您可以可视化地查看训练过程、优化模型性能、调试精度问题。您还可以通过MindInsight提供的命令行方便地搜索超参，迁移模型。在MindInsight的帮助下，您可以更轻松地获得满意的模型精度和性能。

MindInsight包括以下内容：

- 训练过程可视 (`收集Summary数据、查看训练看板 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/summary_record.html>`_)
- `训练溯源及对比 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/lineage_and_scalars_comparison.html>`_
- `性能调优 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/performance_profiling.html>`_
- `精度调试 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/debugger.html>`_
- `超参调优 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/hyper_parameters_auto_tuning.html>`_
- `模型迁移 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/migrate_3rd_scripts_mindconverter.html>`_

.. raw:: html

   <img src="https://mindspore-website.obs.cn-north-4.myhuaweicloud.com/website-images/r1.8/docs/mindinsight/docs/source_zh_cn/images/mindinsight.png" width="700px" alt="" >

使用MindInsight可视化训练过程
------------------------------

1. `收集可视化训练数据 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/summary_record.html>`_

   在训练脚本中使用SummaryCollector记录训练信息，再执行训练。

2. `启动MindInsight可视化训练 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/mindinsight_commands.html#启动服务>`_

   启动MindInsight，并通过 ``--summary-base-dir`` 参数指定summary日志文件目录。

3. `查看训练看板 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/dashboard.html>`_

   在浏览器中打开MindInsight访问地址，点击“训练看板”按钮查看详细信息。

使用MindInsight分析模型性能
---------------------------

1. `收集模型分析数据 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/performance_profiling_ascend.html#准备训练脚本>`_

   在训练脚本中调用MindSpore Profiler相关接口，再执行训练。

2. `启动MindInsight分析模型 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/mindinsight_commands.html>`_

   启动MindInsight服务，并通过 ``--summary-base-dir`` 参数指定性能数据目录。

3. `分析性能数据 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/performance_profiling_ascend.html#数据准备性能分析>`_

   在浏览器中打开MindInsight访问地址，点击“性能分析”按钮查看并分析训练性能数据。

使用MindInsight调试模型精度
----------------------------

1. `以调试模式启动MindInsight <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/debugger_online.html#以调试模式启动mindinsight>`_

   通过配置 ``--enable-debugger True`` ``--debugger-port 50051`` 参数使MindInsight以调试模式启动。

2. `以调试模式运行训练脚本 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/debugger_online.html#以调试模式运行训练脚本>`_

   设置环境变量 ``export ENABLE_MS_DEBUGGER=True`` ，将训练指定为调试模式，并设置训练要连接的调试服务和端口： ``export MS_DEBUGGER_HOST=127.0.0.1；`` ``export MS_DEBUGGER_PORT=50051`` ，然后执行训练脚本。

3. `在MindInsight界面设置监测点并分析 <https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/debugger_online.html#设置监测点>`_

   在浏览器中打开MindInsight访问地址，点击“调试器”页签，等待训练连接后，设置监测点，分析计算图、张量、监测点命中等数据，识别精度问题根因。

.. toctree::
   :glob:
   :maxdepth: 1
   :caption: 安装部署

   mindinsight_install

.. toctree::
   :glob:
   :maxdepth: 1
   :caption: 使用指南

   summary_record
   dashboard
   lineage_and_scalars_comparison
   hyper_parameters_auto_tuning
   migrate_3rd_scripts_mindconverter
   performance_profiling
   debugger
   landscape
   mindinsight_commands

.. toctree::
   :maxdepth: 1
   :caption: 调优指南

   accuracy_problem_preliminary_location
   accuracy_optimization
   performance_tuning_guide

.. toctree::
   :maxdepth: 1
   :caption: API参考

   mindinsight.debugger

.. toctree::
   :glob:
   :maxdepth: 1
   :caption: 参考文档

   training_visual_design
   graph_visual_design
   tensor_visual_design
   profiler_design
   faq

.. toctree::
   :glob:
   :maxdepth: 1
   :caption: RELEASE NOTES

   RELEASE