Skip to content

Commit 8cbe6b3

Browse files
authored
Merge pull request #1518 from MicrosoftDocs/master
2/28 AM Publish
2 parents a4af63e + d9686da commit 8cbe6b3

File tree

97 files changed

+2824
-2981
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

97 files changed

+2824
-2981
lines changed

docs/ai/about-ai-tools.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -9,34 +9,35 @@ ms.date: 11/13/2017
99
ms.topic: article
1010
ms.devlang: multiple
1111
ms.service: multiple
12-
ms.workload:
12+
ms.technology: vs-ai-tools
13+
ms.workload:
1314
- "multiple"
1415
---
1516

1617
# Visual Studio Tools for AI
1718

1819
Visual Studio Tools for AI is an extension to build, test, and deploy Deep Learning / AI solutions. It seamlessly integrates with Azure Machine Learning for robust experimentation capabilities, including but not limited to submitting data preparation and model training jobs transparently to different compute targets. Additionally, it provides support for custom metrics and run history tracking, enabling data science reproducibility and auditing. Enterprise ready collaboration, allow to securely work on project with other people.
1920

20-
Get started with deep learning using [Microsoft Cognitive Toolkit (CNTK)](http://www.microsoft.com/en-us/cognitive-toolkit), [Google TensorFlow](https://www.tensorflow.org), or other deep-learning frameworks today.
21-
22-
## Develop, debug and deploy deep learning models and AI solutions
23-
Use the productivity features of Visual Studio to accelerate AI innovation today. Use built-in code editor features like syntax highlighting, IntelliSense and text auto formatting. You can interactively test your deep learning application in your local environment using step-through debugging on local variables and models.
21+
Get started with deep learning using [Microsoft Cognitive Toolkit (CNTK)](http://www.microsoft.com/en-us/cognitive-toolkit), [Google TensorFlow](https://www.tensorflow.org), or other deep-learning frameworks today.
22+
23+
## Develop, debug and deploy deep learning models and AI solutions
24+
Use the productivity features of Visual Studio to accelerate AI innovation today. Use built-in code editor features like syntax highlighting, IntelliSense and text auto formatting. You can interactively test your deep learning application in your local environment using step-through debugging on local variables and models.
2425

2526
![deep learning ide](media\about\ide.png)
2627

27-
## Get started quickly with the Azure Machine Learning Sample Gallery
28-
Visual Studio Tools for AI is integrated with Azure Machine Learning to make it easy to browse through a gallery of sample experiments using CNTK, TensorFlow, MMLSpark and more.
28+
## Get started quickly with the Azure Machine Learning Sample Gallery
29+
Visual Studio Tools for AI is integrated with Azure Machine Learning to make it easy to browse through a gallery of sample experiments using CNTK, TensorFlow, MMLSpark and more.
2930

3031
![sample explorer](media\about\gallery.png)
3132

3233
[Learn more about creating projects from the sample gallery](create-project-gallery.md)
3334

3435
## Scale out deep learning model training and/or inferencing to the cloud
35-
This extension makes it easy to train models on your local computer or you can submit jobs to the cloud by using our integration with Azure Machine Learning. You can submit jobs to different compute targets like Spark clusters, Azure GPU virtual machines and more
36-
36+
This extension makes it easy to train models on your local computer or you can submit jobs to the cloud by using our integration with Azure Machine Learning. You can submit jobs to different compute targets like Spark clusters, Azure GPU virtual machines and more
37+
3738
![submit job](media\about\submitjobs.png)
3839

39-
[Learn more about training models in the cloud](tensorflow-vm.md)
40+
[Learn more about training models in the cloud](tensorflow-vm.md)
4041

4142
## Supported Operating Systems
4243
Currently this extension supports Windows 64-bit operating systems

docs/ai/create-project-existing.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
ms.technology: vs-ai-tools
23
---
34
# Create an AI project from existing code
45

docs/ai/create-project-gallery.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -9,29 +9,30 @@ ms.date: 11/13/2017
99
ms.topic: how to article
1010
ms.devlang: multiple
1111
ms.service: multiple
12-
ms.workload:
12+
ms.technology: vs-ai-tools
13+
ms.workload:
1314
- "multiple"
1415
---
1516

1617
## Create an AI project from the Azure Machine Learning Gallery in Visual Studio
1718

18-
Azure Machine Learning is integrated with Visual Studio Tools for AI. You can use it to submit machine learning jobs to remote compute targets like Azure virtual machines, Spark clusters, and more. Learn more about [Azure Machine Learning Experimentation](https://docs.microsoft.com/azure/machine-learning/preview/experimentation-service-configuration)
19+
Azure Machine Learning is integrated with Visual Studio Tools for AI. You can use it to submit machine learning jobs to remote compute targets like Azure virtual machines, Spark clusters, and more. Learn more about [Azure Machine Learning Experimentation](https://docs.microsoft.com/azure/machine-learning/preview/experimentation-service-configuration)
1920

2021
Once you've [installed Visual Studio Tools for AI](installation.md), it's easy to create a new Python project using pre-made recipes in the Azure Machine Learning Sample Gallery.
2122

22-
> [!NOTE]
23-
> Azure Machine Learning Workbench must be installed. To install it please see the [Azure Machine Learning installation quickstart](https://docs.microsoft.com/azure/machine-learning/preview/quickstart-installation)
23+
> [!NOTE]
24+
> Azure Machine Learning Workbench must be installed. To install it please see the [Azure Machine Learning installation quickstart](https://docs.microsoft.com/azure/machine-learning/preview/quickstart-installation)
2425
25-
1. Launch Visual Studio. Open the **Server Explorer** by opening the **AI Tools** menu and choosing **Select Cluster**
26+
1. Launch Visual Studio. Open the **Server Explorer** by opening the **AI Tools** menu and choosing **Select Cluster**
2627

2728
![Cluster chooser](media\create-project-gallery\select-cluster.png)
2829

2930
1. Sign in to your Azure Machine Learning subscription by right-clicking the **Azure Machine Learning** node in the Server Explorer then select **Login** and follow the directions.
3031

3132
![login](media\create-project-gallery\azureml-login.png)
32-
33-
2. Select **AI Tools > Azure Machine Learning Sample Gallery**.
34-
33+
34+
2. Select **AI Tools > Azure Machine Learning Sample Gallery**.
35+
3536
![Sample gallery](media\create-project-gallery\gallery.png)
3637

3738
1. For this Quickstart, select the "**MNIST using TensorFlow**" sample and click **Install**. Provide the following:
@@ -43,14 +44,14 @@ Once you've [installed Visual Studio Tools for AI](installation.md), it's easy t
4344
- **Add to Solution**: determines whether to add to your current Visual Studio Solution or a create and open a new solution
4445
- **Project Path**: Location to save the code
4546
- **Project Name**: Type **TensorFlowMNIST**
46-
47+
4748
![Resulting project when using the Python Application template](media/create-project-gallery/new-AzureSampleProject.png)
4849

4950
1. Visual Studio creates the project file (a `.pyproj` file on disk) along with other files defined in the sample. With the "MNIST" template, the project contains several files.
5051

5152
![mnist](media\create-project-gallery\azml-mnist.png)
5253

53-
1. Submit the job to Azure Machine Learning.
54+
1. Submit the job to Azure Machine Learning.
5455

5556
![mnist](media\create-project-gallery\submit-azml.png)
5657

docs/ai/create-project-repo.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,14 @@
11
---
2+
ms.technology: vs-ai-tools
23
---
34
# Clone a repository of Python code in Visual Studio
45

56
Once you've [installed Visual Studio Tools for AI](installation.md), you can easily clone a repository of Python code and create a project from it.
67

78
1. To connect to GitHub repositories, run the Visual Studio installer, select **Modify**, and select the **Individual components** tab. Scroll down to the **Code tools** section, select **GitHub extension for Visual Studio**, and select **Modify**.
8-
9+
910
![Selecting the GitHub extension in the Visual Studio installer](media\create-project-repo\installation-github-extension.png)
10-
11+
1112
2. Launch Visual Studio.
1213

1314
3. Select **View > Team Explorer...** to open the **Team Explorer** window in which you can connect to GitHub or Visual Studio Team Services, or clone a repository.

docs/ai/create-project.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,25 @@
11
---
2+
ms.technology: vs-ai-tools
23
---
34
# Create an AI project from a template in Visual Studio
45

56
Once you've [installed Visual Studio Tools for AI](installation.md), it's easy to create a new AI project using a variety of templates.
67

78
1. Launch Visual Studio.
89

9-
1. Select **File > New > Project** (Ctrl+Shift+N). In the **New Project** dialog, search for "**AI Tools**", and select the template you want. Note that selecting a template displays a short description of what the template provides.
10+
1. Select **File > New > Project** (Ctrl+Shift+N). In the **New Project** dialog, search for "**AI Tools**", and select the template you want. Note that selecting a template displays a short description of what the template provides.
1011

1112
![VS2017 New Project dialog with Python template](media\create-project\new-ai-project.png)
1213

13-
1. For this Quickstart, select the "**TensorFlow Application**" template, give the project a name (such as "MNIST") and location, and select **OK**.
14+
1. For this Quickstart, select the "**TensorFlow Application**" template, give the project a name (such as "MNIST") and location, and select **OK**.
1415

1516
1. Visual Studio creates the project file (a `.pyproj` file on disk) along with any other files as described by the template. With the "TensorFlow Application" template, the project contains one file named the same as your project. The file is open in the Visual Studio editor by default.
1617

1718
![Resulting project when using the Python Application template](media\create-project\new-tensorflowapp.png)
1819

19-
1. Notice the code already imports several libraries including TensorFlow, numpy, sys and os. Additionally it starts your application ready with some input arguments to easily enable switching the location of input training data, output models and log files. These params are useful when you submit your jobs to multiple compute contexts (ie different directory on your local dev box than on an Azure File Share).
20+
1. Notice the code already imports several libraries including TensorFlow, numpy, sys and os. Additionally it starts your application ready with some input arguments to easily enable switching the location of input training data, output models and log files. These params are useful when you submit your jobs to multiple compute contexts (ie different directory on your local dev box than on an Azure File Share).
2021

21-
1. Your project also has some properties created to make it easy to debug your app by automatically passing commandline arguments to these input parameters. **Right click** your project then select **Properties**
22+
1. Your project also has some properties created to make it easy to debug your app by automatically passing commandline arguments to these input parameters. **Right click** your project then select **Properties**
2223

2324
![Properties](media\create-project\project-properties.png)
2425

docs/ai/installation.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,8 @@ ms.date: 11/13/2017
99
ms.topic: article
1010
ms.devlang: multiple
1111
ms.service: multiple
12-
ms.workload:
12+
ms.technology: vs-ai-tools
13+
ms.workload:
1314
- "multiple"
1415
---
1516
# Installation
@@ -18,11 +19,11 @@ Visual Studio Tools for AI can be installed on Windows 64-bit operating systems.
1819

1920
## Installing Visual Studio Tools for AI
2021

21-
This extension works with [Visual Studio](https://docs.microsoft.com/visualstudio/) 2015, 2017, Community edition or higher.
22+
This extension works with [Visual Studio](https://docs.microsoft.com/visualstudio/) 2015, 2017, Community edition or higher.
2223

23-
To install, download from the [Visual Studio MarketPlace](http://aka.ms/vstoolsforai) or from within Visual Studio
24+
To install, download from the [Visual Studio MarketPlace](http://aka.ms/vstoolsforai) or from within Visual Studio
2425

25-
1. **Tools**> **Extensions and Updates**
26+
1. **Tools**> **Extensions and Updates**
2627

2728
![install CUDA on Windows](media\installation\extensions.png)
2829

docs/ai/job-details.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
---
2+
ms.technology: vs-ai-tools
23
---
34
# View recent job performance and details
45
Once the jobs are submitted, you can view the list of jobs to see their status, duration and more.
56

6-
1. In the **Server Explorer** expand the specific compute context
7+
1. In the **Server Explorer** expand the specific compute context
78
1. Double-click **Jobs**
8-
1. You will see the list of jobs submitted to that compute context.
9+
1. You will see the list of jobs submitted to that compute context.
910
1. Select a specific **Job** in the list to view details
1011

1112
![monitor jobs](media\job-details\monitor-jobs.png)

docs/ai/manage-storage.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
ms.technology: vs-ai-tools
23
---
34
# Browse storage to upload data or download models and logs
45

@@ -14,6 +15,6 @@ You can browse all storage on the remote machine or Azure file share to enable u
1415
## To access job specific data on the remote machine or file share
1516
1. Open the [Job History](job-details.md)
1617
2. Select the job
17-
3. Click **Working Folder** or click StdOut / Stderr for quick access to these important log files
18+
3. Click **Working Folder** or click StdOut / Stderr for quick access to these important log files
1819

1920
![storage](media\manage-storage\job-workingfolder.png)

docs/ai/monitor-gpu.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
2+
ms.technology: vs-ai-tools
23
---
34
# Monitoring GPU Utilization
45
To monitor GPU utilization of remote Linux machines:
56

67
1. In **Server Explorer**, expand **Remote Machines**
78
2. **Right click** the remote machine you want to monitor
8-
9+
910
![gpu heatmap](media\monitor-gpu\gpu-heatmap-0.png)
1011

1112
2. Click **Show Heat Map**
12-
13+
1314
![gpu heatmap](media\monitor-gpu\heatmap.png)
14-

docs/ai/monitor-tensorboard.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,9 @@
11
---
2+
ms.technology: vs-ai-tools
23
---
34
# Monitor with TensorBoard
45

5-
You can visualize your model training progress with TensorBoard.
6+
You can visualize your model training progress with TensorBoard.
67

78
1. Right click your project and click **Run TensorBoard** then select the directory of your output TensorBoard logs.
89

docs/ai/tensorflow-local.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -9,45 +9,46 @@ ms.date: 11/13/2017
99
ms.topic: quickstart
1010
ms.devlang: python
1111
ms.service: multiple
12-
ms.workload:
12+
ms.technology: vs-ai-tools
13+
ms.workload:
1314
- "multiple"
1415
---
1516

16-
# Train a TensorFlow model locally
17+
# Train a TensorFlow model locally
1718

18-
In this quickstart, we will train a TensorFlow model with the [MNIST](http://yann.lecun.com/exdb/mnist/) dataset locally in Visual Studio Tools for AI.
19-
The MNIST database has a training set of 60,000 examples, and a test set of 10,000 examples of handwritten digits.
19+
In this quickstart, we will train a TensorFlow model with the [MNIST](http://yann.lecun.com/exdb/mnist/) dataset locally in Visual Studio Tools for AI.
20+
The MNIST database has a training set of 60,000 examples, and a test set of 10,000 examples of handwritten digits.
2021

2122
## Prerequisites
2223

2324
Before you begin, ensure you have the following installed:
2425

25-
### Google TensorFlow
26+
### Google TensorFlow
2627

27-
Run the following command in a terminal.
28+
Run the following command in a terminal.
2829
```cmd
2930
C:\>pip.exe install tensorflow
3031
```
3132

32-
### NumPy and SciPy
33-
Install [NumPy](https://www.lfd.uci.edu/~gohlke/pythonlibs/#numpy) and [SciPy](https://www.lfd.uci.edu/~gohlke/pythonlibs/#scipy).
33+
### NumPy and SciPy
34+
Install [NumPy](https://www.lfd.uci.edu/~gohlke/pythonlibs/#numpy) and [SciPy](https://www.lfd.uci.edu/~gohlke/pythonlibs/#scipy).
3435

3536
### Download sample code
36-
Download this [GitHub repository](https://github.com/Microsoft/samples-for-ai) containing samples for getting started with deep learning across TensorFlow, CNTK, Theano, and more.
37+
Download this [GitHub repository](https://github.com/Microsoft/samples-for-ai) containing samples for getting started with deep learning across TensorFlow, CNTK, Theano, and more.
3738

3839
## Open solution and train model
3940

4041
- Launch Visual Studio and select **File > Open > Project/Solution**.
4142

42-
- Select the **Tensorflow Examples** folder from the samples repository downloaded and open the **TensorflowExamples.sln** file.
43+
- Select the **Tensorflow Examples** folder from the samples repository downloaded and open the **TensorflowExamples.sln** file.
4344

4445
![Open project](media\tensorflow-local\open-project.png)
4546

4647
![Open solution](media\tensorflow-local\open-solution.png)
4748

4849
- Find the MNIST Project in the **Solution Explorer**, right-click and select **Set as StartUp Project**.
4950

50-
- Click **Start**.
51+
- Click **Start**.
5152

5253
- The output is printed in the console.
5354

docs/ai/tensorflow-vm.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,14 @@ ms.date: 11/13/2017
99
ms.topic: tutorial
1010
ms.devlang: python
1111
ms.service: multiple
12-
ms.workload:
12+
ms.technology: vs-ai-tools
13+
ms.workload:
1314
- "multiple"
1415
---
1516

1617
# Train a TensorFlow model in the cloud
1718

18-
In this tutorial, we will train a TensorFlow model using the [MNIST dataset](http://yann.lecun.com/exdb/mnist/) in an Azure [Deep Learning](https://docs.microsoft.com/azure/machine-learning/data-science-virtual-machine/deep-learning-dsvm-overview) virtual machine.
19+
In this tutorial, we will train a TensorFlow model using the [MNIST dataset](http://yann.lecun.com/exdb/mnist/) in an Azure [Deep Learning](https://docs.microsoft.com/azure/machine-learning/data-science-virtual-machine/deep-learning-dsvm-overview) virtual machine.
1920

2021
The MNIST database has a training set of 60,000 examples, and a test set of 10,000 examples of handwritten digits.
2122

@@ -24,10 +25,10 @@ Before you begin, ensure you have the following installed and configured:
2425

2526
### Setup Azure Deep Learning Virtual Machine
2627

27-
> [!NOTE]
28+
> [!NOTE]
2829
> Set **OS type** to Linux.
2930
30-
Instructions for setting up Deep Learning Virtual Machine can be found [here](https://docs.microsoft.com/azure/machine-learning/data-science-virtual-machine/provision-deep-learning-dsvm).
31+
Instructions for setting up Deep Learning Virtual Machine can be found [here](https://docs.microsoft.com/azure/machine-learning/data-science-virtual-machine/provision-deep-learning-dsvm).
3132

3233
### Remove comment in parens
3334

@@ -37,21 +38,21 @@ echo -e ". /etc/profile\n$(cat ~/.bashrc)" > ~/.bashrc
3738

3839
### Download sample code
3940

40-
Download this [GitHub repository](https://github.com/Microsoft/samples-for-ai) containing samples for getting started with deep learning across TensorFlow, CNTK, Theano, and more.
41+
Download this [GitHub repository](https://github.com/Microsoft/samples-for-ai) containing samples for getting started with deep learning across TensorFlow, CNTK, Theano, and more.
4142

4243
## Open project
4344

4445
- Launch Visual Studio and select **File > Open > Project/Solution**.
4546

46-
- Select the **Tensorflow Examples** folder from the samples repository downloaded and open the **TensorflowExamples.sln** file.
47+
- Select the **Tensorflow Examples** folder from the samples repository downloaded and open the **TensorflowExamples.sln** file.
4748

4849
![Open project](media\tensorflow-local\open-project.png)
4950

5051
![Open solution](media\tensorflow-local\open-solution.png)
5152

5253
## Add Azure Remote VM
5354

54-
In Server Explorer, right click the **Remote Machines** node under the AI Tools node and select "Add…". Enter the Remote Machine display name, IP host, SSH port, user name, and password/key file.
55+
In Server Explorer, right click the **Remote Machines** node under the AI Tools node and select "Add…". Enter the Remote Machine display name, IP host, SSH port, user name, and password/key file.
5556

5657
![Add a new remote machine](media\tensorflow-vm\add-remote-vm.png)
5758

@@ -64,11 +65,11 @@ In the submission window:
6465

6566
- In the list of **Cluster to use**, select the remote machine (with "rm:" prefix) to submit the job to.
6667

67-
- Enter a **Job name**.
68+
- Enter a **Job name**.
6869

69-
- Click **Submit**.
70+
- Click **Submit**.
7071

71-
## Check status of job
72+
## Check status of job
7273
To see status and details of jobs: expand the virtual machine you submitted the job to in the **Server Explorer**. Double-click on **Jobs**.
7374

7475
![Job browser](media\tensorflow-vm\job-browser.png)

0 commit comments

Comments
 (0)