# MindInsight
<!-- TOC -->
- [Introduction](#introduction)
- [Installation](#installation)
- [System Environment Information Confirmation](#system-environment-information-confirmation)
- [Installation Methods](#installation-methods)
- [Installation by pip](#installation-by-pip)
- [Installation by Source Code](#installation-by-source-code)
- [Downloading Source Code from Gitee](#downloading-source-code-from-gitee)
- [Compiling MindInsight](#compiling-mindInsight)
- [Installation Verification](#installation-verification)
- [Quick Start](#quick-start)
- [Docs](#docs)
- [Community](#community)
- [Governance](#governance)
- [Communication](#communication)
- [Vulkan Vision](#vulkan-vision)
- [Contributing](#contributing)
- [Release Notes](#release-notes)
- [License](#license)
<!-- /TOC -->
[简体中文](./README_CN.md)
## Introduction
MindInsight provides MindSpore with easy-to-use debugging and tuning capabilities. During the training, data such as scalar, tensor, image, computational graph, model hyper parameter and training's execution time can be recorded in the file for viewing and analysis through the visual page of MindInsight.
Click to view the [MindInsight design document](https://www.mindspore.cn/mindinsight/docs/en/master/training_visual_design.html), learn more about the design.
Click to view the [Tutorial documentation](https://www.mindspore.cn/mindinsight/docs/en/master/index.html) learn more about the MindInsight tutorial.
## Installation
### System Environment Information Confirmation
- The hardware platform supports Ascend, GPU and CPU.
- Confirm that [Python](https://www.python.org/ftp/python/3.7.5/Python-3.7.5.tgz) 3.7.5 is installed.
- The versions of MindInsight and MindSpore must be consistent.
- If you use source code to compile and install, the following dependencies also need to be installed:
- Confirm that [node.js](https://nodejs.org/en/download/) 10.19.0 or later is installed.
- Confirm that [wheel](https://pypi.org/project/wheel/) 0.32.0 or later is installed.
- All other dependencies are included in [requirements.txt](https://gitee.com/mindspore/mindinsight/blob/master/requirements.txt).
### Installation Methods
You can install MindInsight either by pip or by source code.
#### Installation by pip
Install from PyPI:
```bash
pip install mindinsight
```
Install with customized version:
```bash
pip install https://ms-release.obs.cn-north-4.myhuaweicloud.com/{version}/MindInsight/any/mindinsight-{version}-py3-none-any.whl --trusted-host ms-release.obs.cn-north-4.myhuaweicloud.com -i https://pypi.tuna.tsinghua.edu.cn/simple
```
> - When the network is connected, dependency items are automatically downloaded during .whl package installation. (For details about other dependency items, see [requirements.txt](https://gitee.com/mindspore/mindinsight/blob/master/requirements.txt)). In other cases, you need to manually install dependency items.
> - `{version}` denotes the version of MindInsight. For example, when you are downloading MindSpore 1.3.0, `{version}` should be 1.3.0.
> - MindInsight supports only Linux distro with x86 architecture 64-bit or ARM architecture 64-bit.
#### Installation by Source Code
##### Downloading Source Code from Gitee
```bash
git clone https://gitee.com/mindspore/mindinsight.git
```
##### Compiling MindInsight
You can choose any of the following installation methods:
1. Run the following command in the root directory of the source code:
```bash
cd mindinsight
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
python setup.py install
```
2. Build the `whl` package for installation.
Enter the root directory of the source code, first execute the MindInsight compilation script in the `build` directory, and then execute the command to install the `whl` package generated in the `output` directory.
```bash
cd mindinsight
bash build/build.sh
pip install output/mindinsight-{version}-py3-none-any.whl -i https://pypi.tuna.tsinghua.edu.cn/simple
```
### Installation Verification
Execute the following command:
```bash
mindinsight start [--port PORT]
```
*notes: the param --port default value is 8080*
If it prompts the following information, the installation is successful:
```bash
Web address: http://127.0.0.1:8080
service start state: success
```
## Quick Start
Before using MindInsight, the data in the training process should be recorded. When starting MindInsight, the directory of the saved data should be specified. After successful startup, the data can be viewed through the web page. Here is a brief introduction to recording training data, as well as starting and stopping MindInsight.
[SummaryCollector](https://www.mindspore.cn/docs/en/master/api_python/mindspore/mindspore.SummaryCollector.html#mindspore.SummaryCollector) is the interface MindSpore provides for a quick and easy collection of common data about computational graphs, loss values, learning rates, parameter weights, and so on. Below is an example of using `SummaryCollector` for data collection, specifying the directory where the data is stored in `./summary_dir`.
```python
...
from mindspore import SummaryCollector
summary_collector = SummaryCollector(summary_dir='./summary_dir')
model.train(epoch=1, ds_train, callbacks=[summary_collector])
```
For more ways to record visual data, see the [MindInsight Tutorial](https://www.mindspore.cn/mindinsight/docs/en/master/index.html).
After you've collected the data, when you launch MindInsight, specify the directory in which the data has been stored.
```bash
mindinsight start --summary-base-dir ./summary_dir [--port PORT]
```
*notes: the param --port default value is 8080*
After successful startup, visit `http://127.0.0.1:8080` through the browser to view the web page.
Command of stopping the MindInsight service:
```bash
mindinsight stop [--port PORT]
```
*notes: the param --port default value is 8080, you can stop the specified port MI service.*
For more about MindInsight command_line，see the [MindInsight Command_line](https://www.mindspore.cn/mindinsight/docs/en/r1.5/index.html).
## Docs
More details about installation guide, tutorials and APIs, please see the
[User Documentation](https://gitee.com/mindspore/docs).
## Community
### Governance
Check out how MindSpore Open Governance [works](https://gitee.com/mindspore/community/blob/master/governance.md).
### Communication
- [MindSpore Slack](https://join.slack.com/t/mindspore/shared_invite/zt-dgk65rli-3ex4xvS4wHX7UDmsQmfu8w) - Communication platform for developers.
- IRC channel at `#mindspore` (only for meeting minutes logging purpose)
- Video Conferencing: TBD
- Mailing-list: <https://mailweb.mindspore.cn/postorius/lists>
## Vulkan Vision
Vulkan Vision(V-Vision) provides an unprecedented level of detail into the execution of Vulkan applications through dynamic instrumentation. V-Vision supports analyzing AI workloads implemented using the a compute pipeline as well as traditional raster and ray-tracing Vulkan applications. To use V-Vision please refer to the [build instructions](https://gitee.com/mindspore/mindinsight/blob/master/ecosystem_tools/VulkanVision/README.md). For more information, please refer to [the paper](https://webdocs.cs.ualberta.ca/~amaral/papers/PankratzCGO21) published at CGO 2021.
## Contributing
Welcome contributions. See our [Contributor Wiki](https://gitee.com/mindspore/mindspore/blob/master/CONTRIBUTING.md) for more details.
## Release Notes
The release notes, see our [RELEASE](RELEASE.md).
## License
[Apache License 2.0](LICENSE)
Raw data
{
"_id": null,
"home_page": "https://www.mindspore.cn",
"name": "mindinsight",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "mindinsight",
"author": "The MindSpore Authors",
"author_email": "contact@mindspore.cn",
"download_url": "https://files.pythonhosted.org/packages/f1/b4/1b2007860b8a110cd5e9c10641b2867dccb18329bf04722fada3301fdb20/mindinsight-2.3.1.tar.gz",
"platform": "linux",
"description": "# MindInsight\n\n<!-- TOC -->\n\n- [Introduction](#introduction)\n- [Installation](#installation)\n - [System Environment Information Confirmation](#system-environment-information-confirmation)\n - [Installation Methods](#installation-methods)\n - [Installation by pip](#installation-by-pip)\n - [Installation by Source Code](#installation-by-source-code)\n - [Downloading Source Code from Gitee](#downloading-source-code-from-gitee)\n - [Compiling MindInsight](#compiling-mindInsight)\n - [Installation Verification](#installation-verification)\n- [Quick Start](#quick-start)\n- [Docs](#docs)\n- [Community](#community)\n - [Governance](#governance)\n - [Communication](#communication)\n- [Vulkan Vision](#vulkan-vision)\n- [Contributing](#contributing)\n- [Release Notes](#release-notes)\n- [License](#license)\n\n<!-- /TOC -->\n\n[\u7b80\u4f53\u4e2d\u6587](./README_CN.md)\n\n## Introduction\n\nMindInsight provides MindSpore with easy-to-use debugging and tuning capabilities. During the training, data such as scalar, tensor, image, computational graph, model hyper parameter and training's execution time can be recorded in the file for viewing and analysis through the visual page of MindInsight.\n\n\n\nClick to view the [MindInsight design document](https://www.mindspore.cn/mindinsight/docs/en/master/training_visual_design.html), learn more about the design.\nClick to view the [Tutorial documentation](https://www.mindspore.cn/mindinsight/docs/en/master/index.html) learn more about the MindInsight tutorial.\n\n## Installation\n\n### System Environment Information Confirmation\n\n- The hardware platform supports Ascend, GPU and CPU.\n- Confirm that [Python](https://www.python.org/ftp/python/3.7.5/Python-3.7.5.tgz) 3.7.5 is installed.\n- The versions of MindInsight and MindSpore must be consistent.\n- If you use source code to compile and install, the following dependencies also need to be installed:\n - Confirm that [node.js](https://nodejs.org/en/download/) 10.19.0 or later is installed.\n - Confirm that [wheel](https://pypi.org/project/wheel/) 0.32.0 or later is installed.\n- All other dependencies are included in [requirements.txt](https://gitee.com/mindspore/mindinsight/blob/master/requirements.txt).\n\n### Installation Methods\n\nYou can install MindInsight either by pip or by source code.\n\n#### Installation by pip\n\nInstall from PyPI:\n\n```bash\npip install mindinsight\n```\n\nInstall with customized version:\n\n```bash\npip install https://ms-release.obs.cn-north-4.myhuaweicloud.com/{version}/MindInsight/any/mindinsight-{version}-py3-none-any.whl --trusted-host ms-release.obs.cn-north-4.myhuaweicloud.com -i https://pypi.tuna.tsinghua.edu.cn/simple\n```\n\n> - When the network is connected, dependency items are automatically downloaded during .whl package installation. (For details about other dependency items, see [requirements.txt](https://gitee.com/mindspore/mindinsight/blob/master/requirements.txt)). In other cases, you need to manually install dependency items.\n> - `{version}` denotes the version of MindInsight. For example, when you are downloading MindSpore 1.3.0, `{version}` should be 1.3.0.\n> - MindInsight supports only Linux distro with x86 architecture 64-bit or ARM architecture 64-bit.\n\n#### Installation by Source Code\n\n##### Downloading Source Code from Gitee\n\n```bash\ngit clone https://gitee.com/mindspore/mindinsight.git\n```\n\n##### Compiling MindInsight\n\nYou can choose any of the following installation methods:\n\n1. Run the following command in the root directory of the source code:\n\n ```bash\n cd mindinsight\n pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple\n python setup.py install\n ```\n\n2. Build the `whl` package for installation.\n\n Enter the root directory of the source code, first execute the MindInsight compilation script in the `build` directory, and then execute the command to install the `whl` package generated in the `output` directory.\n\n ```bash\n cd mindinsight\n bash build/build.sh\n pip install output/mindinsight-{version}-py3-none-any.whl -i https://pypi.tuna.tsinghua.edu.cn/simple\n ```\n\n### Installation Verification\n\nExecute the following command:\n\n```bash\nmindinsight start [--port PORT]\n```\n\n*notes: the param --port default value is 8080*\n\nIf it prompts the following information, the installation is successful:\n\n```bash\nWeb address: http://127.0.0.1:8080\nservice start state: success\n```\n\n## Quick Start\n\nBefore using MindInsight, the data in the training process should be recorded. When starting MindInsight, the directory of the saved data should be specified. After successful startup, the data can be viewed through the web page. Here is a brief introduction to recording training data, as well as starting and stopping MindInsight.\n\n[SummaryCollector](https://www.mindspore.cn/docs/en/master/api_python/mindspore/mindspore.SummaryCollector.html#mindspore.SummaryCollector) is the interface MindSpore provides for a quick and easy collection of common data about computational graphs, loss values, learning rates, parameter weights, and so on. Below is an example of using `SummaryCollector` for data collection, specifying the directory where the data is stored in `./summary_dir`.\n\n```python\n...\n\nfrom mindspore import SummaryCollector\nsummary_collector = SummaryCollector(summary_dir='./summary_dir')\nmodel.train(epoch=1, ds_train, callbacks=[summary_collector])\n```\n\nFor more ways to record visual data, see the [MindInsight Tutorial](https://www.mindspore.cn/mindinsight/docs/en/master/index.html).\n\nAfter you've collected the data, when you launch MindInsight, specify the directory in which the data has been stored.\n\n```bash\nmindinsight start --summary-base-dir ./summary_dir [--port PORT]\n```\n\n*notes: the param --port default value is 8080*\n\nAfter successful startup, visit `http://127.0.0.1:8080` through the browser to view the web page.\n\nCommand of stopping the MindInsight service:\n\n```bash\nmindinsight stop [--port PORT]\n```\n\n*notes: the param --port default value is 8080, you can stop the specified port MI service.*\n\nFor more about MindInsight command_line\uff0csee the [MindInsight Command_line](https://www.mindspore.cn/mindinsight/docs/en/r1.5/index.html).\n\n## Docs\n\nMore details about installation guide, tutorials and APIs, please see the\n[User Documentation](https://gitee.com/mindspore/docs).\n\n## Community\n\n### Governance\n\nCheck out how MindSpore Open Governance [works](https://gitee.com/mindspore/community/blob/master/governance.md).\n\n### Communication\n\n- [MindSpore Slack](https://join.slack.com/t/mindspore/shared_invite/zt-dgk65rli-3ex4xvS4wHX7UDmsQmfu8w) - Communication platform for developers.\n- IRC channel at `#mindspore` (only for meeting minutes logging purpose)\n- Video Conferencing: TBD\n- Mailing-list: <https://mailweb.mindspore.cn/postorius/lists>\n\n## Vulkan Vision\n\nVulkan Vision(V-Vision) provides an unprecedented level of detail into the execution of Vulkan applications through dynamic instrumentation. V-Vision supports analyzing AI workloads implemented using the a compute pipeline as well as traditional raster and ray-tracing Vulkan applications. To use V-Vision please refer to the [build instructions](https://gitee.com/mindspore/mindinsight/blob/master/ecosystem_tools/VulkanVision/README.md). For more information, please refer to [the paper](https://webdocs.cs.ualberta.ca/~amaral/papers/PankratzCGO21) published at CGO 2021.\n\n## Contributing\n\nWelcome contributions. See our [Contributor Wiki](https://gitee.com/mindspore/mindspore/blob/master/CONTRIBUTING.md) for more details.\n\n## Release Notes\n\nThe release notes, see our [RELEASE](RELEASE.md).\n\n## License\n\n[Apache License 2.0](LICENSE)\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "mindinsight platform: linux, cpu: x86_64, git version: [sha1]:6e8f0e75, [branch]: (HEAD -> master, origin/master, origin/HEAD)",
"version": "2.3.1",
"project_urls": {
"Download": "https://gitee.com/mindspore/mindinsight/tags",
"Homepage": "https://www.mindspore.cn",
"Issue Tracker": "https://gitee.com/mindspore/mindinsight/issues",
"Sources": "https://gitee.com/mindspore/mindinsight"
},
"split_keywords": [
"mindinsight"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "11f4e98a3e2b97566e3fdd9fc5ecf09fd00ece902dec25e9c870a88bd0825fe3",
"md5": "0103f3ce265212574fb066d994963b95",
"sha256": "dc5a4a5a1031c866aa72550fdd6a699ffb6591ed8d2c77647d57c2fcbb4d627c"
},
"downloads": -1,
"filename": "mindinsight-2.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0103f3ce265212574fb066d994963b95",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 6848431,
"upload_time": "2024-08-24T09:32:08",
"upload_time_iso_8601": "2024-08-24T09:32:08.555449Z",
"url": "https://files.pythonhosted.org/packages/11/f4/e98a3e2b97566e3fdd9fc5ecf09fd00ece902dec25e9c870a88bd0825fe3/mindinsight-2.3.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f1b41b2007860b8a110cd5e9c10641b2867dccb18329bf04722fada3301fdb20",
"md5": "4fb2d526075c467c84b132fcf8c4082d",
"sha256": "b9939e8ecc74d423aaa046c79f3cd8c8a1b6766a8ef9458096f414e76e536f03"
},
"downloads": -1,
"filename": "mindinsight-2.3.1.tar.gz",
"has_sig": false,
"md5_digest": "4fb2d526075c467c84b132fcf8c4082d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 6441712,
"upload_time": "2024-08-24T09:32:16",
"upload_time_iso_8601": "2024-08-24T09:32:16.967527Z",
"url": "https://files.pythonhosted.org/packages/f1/b4/1b2007860b8a110cd5e9c10641b2867dccb18329bf04722fada3301fdb20/mindinsight-2.3.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-24 09:32:16",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "mindinsight"
}
JSON