Skip to content

Commit 0443c33

Browse files
Merge pull request #112380 from TimShererWithAquent/us1708889a
[CogSvcs] - Content Update: Zone pivots for Custom Vision SDK quickstarts
2 parents 00a3e0d + ae5986a commit 0443c33

20 files changed

+199
-216
lines changed

.openpublishing.redirection.json

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51494,6 +51494,56 @@
5149451494
"source_path": "articles/app-service-mobile/app-service-mobile-xamarin-ios-get-started.md",
5149551495
"redirect_url": "/previous-versions/azure/app-service-mobile/app-service-mobile-xamarin-ios-get-started",
5149651496
"redirect_document_id": false
51497+
},
51498+
{
51499+
"source_path": "articles/cognitive-services/Custom-Vision-Service/csharp-tutorial.md",
51500+
"redirect_url": "/azure/cognitive-services/Custom-Vision-Service/quickstarts/image-classification",
51501+
"redirect_document_id": false
51502+
},
51503+
{
51504+
"source_path": "articles/cognitive-services/Custom-Vision-Service/go-tutorial.md",
51505+
"redirect_url": "/azure/cognitive-services/Custom-Vision-Service/quickstarts/image-classification",
51506+
"redirect_document_id": false
51507+
},
51508+
{
51509+
"source_path": "articles/cognitive-services/Custom-Vision-Service/java-tutorial.md",
51510+
"redirect_url": "/azure/cognitive-services/Custom-Vision-Service/quickstarts/image-classification",
51511+
"redirect_document_id": false
51512+
},
51513+
{
51514+
"source_path": "articles/cognitive-services/Custom-Vision-Service/node-tutorial.md",
51515+
"redirect_url": "/azure/cognitive-services/Custom-Vision-Service/quickstarts/image-classification",
51516+
"redirect_document_id": false
51517+
},
51518+
{
51519+
"source_path": "articles/cognitive-services/Custom-Vision-Service/python-tutorial.md",
51520+
"redirect_url": "/azure/cognitive-services/Custom-Vision-Service/quickstarts/image-classification",
51521+
"redirect_document_id": false
51522+
},
51523+
{
51524+
"source_path": "articles/cognitive-services/Custom-Vision-Service/csharp-tutorial-od.md",
51525+
"redirect_url": "/azure/cognitive-services/Custom-Vision-Service/quickstarts/object-detection",
51526+
"redirect_document_id": false
51527+
},
51528+
{
51529+
"source_path": "articles/cognitive-services/Custom-Vision-Service/go-tutorial-object-detection.md",
51530+
"redirect_url": "/azure/cognitive-services/Custom-Vision-Service/quickstarts/object-detection",
51531+
"redirect_document_id": false
51532+
},
51533+
{
51534+
"source_path": "articles/cognitive-services/Custom-Vision-Service/java-tutorial-od.md",
51535+
"redirect_url": "/azure/cognitive-services/Custom-Vision-Service/quickstarts/object-detection",
51536+
"redirect_document_id": false
51537+
},
51538+
{
51539+
"source_path": "articles/cognitive-services/Custom-Vision-Service/node-tutorial-object-detection.md",
51540+
"redirect_url": "/azure/cognitive-services/Custom-Vision-Service/quickstarts/object-detection",
51541+
"redirect_document_id": false
51542+
},
51543+
{
51544+
"source_path": "articles/cognitive-services/Custom-Vision-Service/python-tutorial-od.md",
51545+
"redirect_url": "/azure/cognitive-services/Custom-Vision-Service/quickstarts/object-detection",
51546+
"redirect_document_id": false
5149751547
}
5149851548
]
5149951549
}

articles/cognitive-services/Custom-Vision-Service/home.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,4 +46,4 @@ As with all of the Cognitive Services, developers using the Custom Vision servic
4646

4747
## Next steps
4848

49-
Follow the [Build a classifier](getting-started-build-a-classifier.md) guide to get started using Custom Vision on the web, or complete an [Image classification tutorial](csharp-tutorial.md) to implement a basic scenario in code.
49+
Follow the [Build a classifier](getting-started-build-a-classifier.md) guide to get started using Custom Vision on the web, or complete an [Image classification tutorial](quickstarts/image-classification.md) to implement a basic scenario in code.

articles/cognitive-services/Custom-Vision-Service/includes/clean-ic-project.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99

1010
## Clean up resources
1111

12-
If you wish to implement your own image classification project (or try an [object detection](../csharp-tutorial-od.md) project instead), you may want to delete the tree identification project from this example. A free trial allows for two Custom Vision projects.
12+
If you wish to implement your own image classification project (or try an [object detection](../quickstarts/object-detection.md) project instead), you may want to delete the tree identification project from this example. A free trial allows for two Custom Vision projects.
1313

1414
On the [Custom Vision website](https://customvision.ai), navigate to **Projects** and select the trash can under My New Project.
1515

articles/cognitive-services/Custom-Vision-Service/includes/clean-od-project.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99

1010
## Clean up resources
1111

12-
If you wish to implement your own object detection project (or try an [image classification](../csharp-tutorial.md) project instead), you may want to delete the fork/scissors detection project from this example. A free trial allows for two Custom Vision projects.
12+
If you wish to implement your own object detection project (or try an [image classification](../quickstarts/image-classification.md) project instead), you may want to delete the fork/scissors detection project from this example. A free trial allows for two Custom Vision projects.
1313

1414
On the [Custom Vision website](https://customvision.ai), navigate to **Projects** and select the trash can under My New Project.
1515

articles/cognitive-services/Custom-Vision-Service/csharp-tutorial-od.md renamed to articles/cognitive-services/Custom-Vision-Service/includes/quickstarts/csharp-tutorial-od.md

Lines changed: 6 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,16 @@
11
---
2-
title: "Quickstart: Create an object detection project with the SDK for C# - Custom Vision"
3-
titleSuffix: Azure Cognitive Services
4-
description: Create a project, add tags, upload images, train your project, and detect objects using the .NET SDK with C#.
5-
services: cognitive-services
62
author: PatrickFarley
7-
manager: nitinme
8-
3+
ms.author: pafarley
94
ms.service: cognitive-services
10-
ms.subservice: custom-vision
11-
ms.topic: quickstart
125
ms.date: 04/14/2020
13-
ms.author: pafarley
146
---
157

16-
# Quickstart: Create an object detection project with the Custom Vision .NET SDK
17-
188
This article shows you how to get started using the Custom Vision SDK with C# to build an object detection model. After it's created, you can add tagged regions, upload images, train the project, obtain the project's default prediction endpoint URL, and use the endpoint to programmatically test an image. Use this example as a template for building your own .NET application.
199

2010
## Prerequisites
2111

2212
- Any edition of [Visual Studio 2015 or 2017](https://www.visualstudio.com/downloads/)
23-
- [!INCLUDE [create-resources](includes/create-resources.md)]
13+
- [!INCLUDE [create-resources](../../includes/create-resources.md)]
2414

2515
## Get the Custom Vision SDK and sample code
2616

@@ -33,7 +23,7 @@ Clone or download the [Cognitive Services .NET Samples](https://github.com/Azure
3323

3424
This Visual Studio project creates a new Custom Vision project named __My New Project__, which can be accessed through the [Custom Vision website](https://customvision.ai/). It then uploads images to train and test an object detection model. In this project, the model is trained to detect forks and scissors in images.
3525

36-
[!INCLUDE [get-keys](includes/get-keys.md)]
26+
[!INCLUDE [get-keys](../../includes/get-keys.md)]
3727

3828
## Understand the code
3929

@@ -47,7 +37,7 @@ Also, get your Endpoint URL from the Settings page of the Custom Vision website.
4737

4838
### Create a new Custom Vision Service project
4939

50-
This next bit of code creates an object detection project. The created project will show up on the [Custom Vision website](https://customvision.ai/) that you visited earlier. See the [CreateProject](https://docs.microsoft.com/dotnet/api/microsoft.azure.cognitiveservices.vision.customvision.training.customvisiontrainingclientextensions.createproject?view=azure-dotnet#Microsoft_Azure_CognitiveServices_Vision_CustomVision_Training_CustomVisionTrainingClientExtensions_CreateProject_Microsoft_Azure_CognitiveServices_Vision_CustomVision_Training_ICustomVisionTrainingClient_System_String_System_String_System_Nullable_System_Guid__System_String_System_Collections_Generic_IList_System_String__) method to specify other options when you create your project (explained in the [Build a detector](get-started-build-detector.md) web portal guide).
40+
This next bit of code creates an object detection project. The created project will show up on the [Custom Vision website](https://customvision.ai/) that you visited earlier. See the [CreateProject](https://docs.microsoft.com/dotnet/api/microsoft.azure.cognitiveservices.vision.customvision.training.customvisiontrainingclientextensions.createproject?view=azure-dotnet#Microsoft_Azure_CognitiveServices_Vision_CustomVision_Training_CustomVisionTrainingClientExtensions_CreateProject_Microsoft_Azure_CognitiveServices_Vision_CustomVision_Training_ICustomVisionTrainingClient_System_String_System_String_System_Nullable_System_Guid__System_String_System_Collections_Generic_IList_System_String__) method to specify other options when you create your project (explained in the [Build a detector](../../get-started-build-detector.md) web portal guide).
5141

5242
[!code-csharp[](~/cognitive-services-dotnet-sdk-samples/CustomVision/ObjectDetection/Program.cs?name=snippet_create)]
5343

@@ -109,11 +99,11 @@ Making a prediction:
10999

110100
You can then verify that the test image (found in **Images/Test/**) is tagged appropriately and that the region of detection is correct. At this point, you can press any key to exit the application.
111101

112-
[!INCLUDE [clean-od-project](includes/clean-od-project.md)]
102+
[!INCLUDE [clean-od-project](../../includes/clean-od-project.md)]
113103

114104
## Next steps
115105

116106
Now you've seen how to do every step of the object detection process in code. This sample executes a single training iteration, but often you'll need to train and test your model multiple times in order to make it more accurate. The following guide deals with image classification, but its principles are similar to object detection.
117107

118108
> [!div class="nextstepaction"]
119-
> [Test and retrain a model](test-your-model.md)
109+
> [Test and retrain a model](../../test-your-model.md)

articles/cognitive-services/Custom-Vision-Service/csharp-tutorial.md renamed to articles/cognitive-services/Custom-Vision-Service/includes/quickstarts/csharp-tutorial.md

Lines changed: 7 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,16 @@
11
---
2-
title: "Quickstart: Create an image classification project with the Custom Vision SDK for C#"
3-
titleSuffix: Azure Cognitive Services
4-
description: Create a project, add tags, upload images, train your project, and make a prediction using the .NET SDK with C#.
5-
services: cognitive-services
62
author: PatrickFarley
7-
manager: nitinme
8-
3+
ms.author: pafarley
94
ms.service: cognitive-services
10-
ms.subservice: custom-vision
11-
ms.topic: quickstart
125
ms.date: 04/14/2020
13-
ms.author: pafarley
146
---
157

16-
# Quickstart: Create an image classification project with the Custom Vision .NET SDK
17-
18-
This article provides information and sample code to help you get started using the Custom Vision SDK with C# to build an image classification model. After it's created, you can add tags, upload images, train the project, obtain the project's default prediction endpoint URL, and use the endpoint to programmatically test an image. Use this example as a template for building your own .NET application. If you want to go through the process of building and using a classification model _without_ code, see the [browser-based guidance](getting-started-build-a-classifier.md) instead.
8+
This article provides information and sample code to help you get started using the Custom Vision SDK with C# to build an image classification model. After it's created, you can add tags, upload images, train the project, obtain the project's default prediction endpoint URL, and use the endpoint to programmatically test an image. Use this example as a template for building your own .NET application. If you want to go through the process of building and using a classification model _without_ code, see the [browser-based guidance](../../getting-started-build-a-classifier.md) instead.
199

2010
## Prerequisites
2111

2212
- Any edition of [Visual Studio 2015 or 2017](https://www.visualstudio.com/downloads/)
23-
- [!INCLUDE [create-resources](includes/create-resources.md)]
13+
- [!INCLUDE [create-resources](../../includes/create-resources.md)]
2414

2515
## Get the Custom Vision SDK and sample code
2616

@@ -33,7 +23,7 @@ Clone or download the [Cognitive Services .NET Samples](https://github.com/Azure
3323

3424
This Visual Studio project creates a new Custom Vision project named __My New Project__, which can be accessed through the [Custom Vision website](https://customvision.ai/). It then uploads images to train and test a classifier. In this project, the classifier is intended to determine whether a tree is a __Hemlock__ or a __Japanese Cherry__.
3525

36-
[!INCLUDE [get-keys](includes/get-keys.md)]
26+
[!INCLUDE [get-keys](../../includes/get-keys.md)]
3727

3828
## Understand the code
3929

@@ -49,7 +39,7 @@ The following lines of code execute the primary functionality of the project.
4939

5040
### Create a new Custom Vision service project
5141

52-
The created project will show up on the [Custom Vision website](https://customvision.ai/) that you visited earlier. See the [CreateProject](https://docs.microsoft.com/dotnet/api/microsoft.azure.cognitiveservices.vision.customvision.training.customvisiontrainingclientextensions.createproject?view=azure-dotnet#Microsoft_Azure_CognitiveServices_Vision_CustomVision_Training_CustomVisionTrainingClientExtensions_CreateProject_Microsoft_Azure_CognitiveServices_Vision_CustomVision_Training_ICustomVisionTrainingClient_System_String_System_String_System_Nullable_System_Guid__System_String_System_Collections_Generic_IList_System_String__) method to specify other options when you create your project (explained in the [Build a classifier](getting-started-build-a-classifier.md) web portal guide).
42+
The created project will show up on the [Custom Vision website](https://customvision.ai/) that you visited earlier. See the [CreateProject](https://docs.microsoft.com/dotnet/api/microsoft.azure.cognitiveservices.vision.customvision.training.customvisiontrainingclientextensions.createproject?view=azure-dotnet#Microsoft_Azure_CognitiveServices_Vision_CustomVision_Training_CustomVisionTrainingClientExtensions_CreateProject_Microsoft_Azure_CognitiveServices_Vision_CustomVision_Training_ICustomVisionTrainingClient_System_String_System_String_System_Nullable_System_Guid__System_String_System_Collections_Generic_IList_System_String__) method to specify other options when you create your project (explained in the [Build a classifier](../../getting-started-build-a-classifier.md) web portal guide).
5343

5444
[!code-csharp[](~/cognitive-services-dotnet-sdk-samples/CustomVision/ImageClassification/Program.cs?name=snippet_create)]
5545

@@ -98,11 +88,11 @@ Making a prediction:
9888

9989
You can then verify that the test image (found in **Images/Test/**) is tagged appropriately. Press any key to exit the application. You can also go back to the [Custom Vision website](https://customvision.ai) and see the current state of your newly created project.
10090

101-
[!INCLUDE [clean-ic-project](includes/clean-ic-project.md)]
91+
[!INCLUDE [clean-ic-project](../../includes/clean-ic-project.md)]
10292

10393
## Next steps
10494

10595
Now you've seen how to do every step of the image classification process in code. This sample executes a single training iteration, but often you will need to train and test your model multiple times in order to make it more accurate.
10696

10797
> [!div class="nextstepaction"]
108-
> [Test and retrain a model](test-your-model.md)
98+
> [Test and retrain a model](../../test-your-model.md)

articles/cognitive-services/Custom-Vision-Service/go-tutorial-object-detection.md renamed to articles/cognitive-services/Custom-Vision-Service/includes/quickstarts/go-tutorial-object-detection.md

Lines changed: 6 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,16 @@
11
---
2-
title: "Quickstart: Create an object detection project with the SDK for Go - Custom Vision"
3-
titleSuffix: Azure Cognitive Services
4-
description: Create a project, add tags, upload images, train your project, and detect objects using the Go SDK.
5-
services: cognitive-services
62
author: areddish
73
ms.author: areddish
8-
manager: nitinme
94
ms.service: cognitive-services
10-
ms.subservice: custom-vision
11-
ms.topic: quickstart
125
ms.date: 04/14/2020
136
---
147

15-
# Quickstart: Create an object detection project with the Custom Vision Go SDK
16-
178
This article provides information and sample code to help you get started using the Custom Vision SDK with Go to build an object detection model. After it's created, you can add tagged regions, upload images, train the project, obtain the project's published prediction endpoint URL, and use the endpoint to programmatically test an image. Use this example as a template for building your own Go application.
189

1910
## Prerequisites
2011

2112
- [Go 1.8+](https://golang.org/doc/install)
22-
- [!INCLUDE [create-resources](includes/create-resources.md)]
13+
- [!INCLUDE [create-resources](../../includes/create-resources.md)]
2314

2415
## Install the Custom Vision SDK
2516

@@ -34,9 +25,9 @@ or if you use `dep`, within your repo run:
3425
dep ensure -add github.com/Azure/azure-sdk-for-go
3526
```
3627

37-
[!INCLUDE [get-keys](includes/get-keys.md)]
28+
[!INCLUDE [get-keys](../../includes/get-keys.md)]
3829

39-
[!INCLUDE [python-get-images](includes/python-get-images.md)]
30+
[!INCLUDE [python-get-images](../../includes/python-get-images.md)]
4031

4132
## Add the code
4233

@@ -46,7 +37,7 @@ Create a new file called *sample.go* in your preferred project directory.
4637

4738
Add the following code to your script to create a new Custom Vision service project. Insert your subscription keys in the appropriate definitions. Also, get your Endpoint URL from the Settings page of the Custom Vision website.
4839

49-
See the [CreateProject](https://docs.microsoft.com/java/api/com.microsoft.azure.cognitiveservices.vision.customvision.training.trainings.createproject?view=azure-java-stable#com_microsoft_azure_cognitiveservices_vision_customvision_training_Trainings_createProject_String_CreateProjectOptionalParameter_) method to specify other options when you create your project (explained in the [Build a detector](get-started-build-detector.md) web portal guide).
40+
See the [CreateProject](https://docs.microsoft.com/java/api/com.microsoft.azure.cognitiveservices.vision.customvision.training.trainings.createproject?view=azure-java-stable#com_microsoft_azure_cognitiveservices_vision_customvision_training_Trainings_createProject_String_CreateProjectOptionalParameter_) method to specify other options when you create your project (explained in the [Build a detector](../../get-started-build-detector.md) web portal guide).
5041

5142
```go
5243
import(
@@ -276,11 +267,11 @@ go run sample.go
276267

277268
The output of the application should appear in the console. You can then verify that the test image (found in **samples/vision/images/Test**) is tagged appropriately and that the region of detection is correct.
278269

279-
[!INCLUDE [clean-od-project](includes/clean-od-project.md)]
270+
[!INCLUDE [clean-od-project](../../includes/clean-od-project.md)]
280271

281272
## Next steps
282273

283274
Now you've seen how every step of the object detection process can be done in code. This sample executes a single training iteration, but often you'll need to train and test your model multiple times in order to make it more accurate. The following training guide deals with image classification, but its principles are similar to object detection.
284275

285276
> [!div class="nextstepaction"]
286-
> [Test and retrain a model](test-your-model.md)
277+
> [Test and retrain a model](../../test-your-model.md)

0 commit comments

Comments
 (0)