Skip to content

Commit 64f7987

Browse files
committed
acrolinx pass
1 parent d80b431 commit 64f7987

File tree

1 file changed

+21
-21
lines changed

1 file changed

+21
-21
lines changed

articles/machine-learning/tutorial-azure-ml-in-a-day.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -22,13 +22,13 @@ ms.custom:
2222

2323
[!INCLUDE [sdk v2](includes/machine-learning-sdk-v2.md)]
2424

25-
This tutorial is an introduction to some of the most used features of the Azure Machine Learning service. In it, you will create, register and deploy a model. This tutorial will help you become familiar with the core concepts of Azure Machine Learning and their most common usage.
25+
This tutorial is an introduction to some of the most used features of the Azure Machine Learning service. In it, you create, register, and deploy a model. This tutorial helps you become familiar with the core concepts of Azure Machine Learning and their most common usage.
2626

27-
You'll learn how to run a training job on a scalable compute resource, then deploy it, and finally test the deployment.
27+
You learn how to run a training job on a scalable compute resource, then deploy it, and finally test the deployment.
2828

29-
You'll create a training script to handle the data preparation, train and register a model. Once you train the model, you'll *deploy* it as an *endpoint*, then call the endpoint for *inferencing*.
29+
You create a training script to handle the data preparation, train, and register a model. Once you train the model, you deploy it as an *endpoint*, then call the endpoint for *inferencing*.
3030

31-
The steps you'll take are:
31+
The steps you take are:
3232

3333
> [!div class="checklist"]
3434
> * Set up a handle to your Azure Machine Learning workspace
@@ -61,13 +61,13 @@ Watch this video for an overview of the steps in this quickstart.
6161

6262
Before we dive in the code, you need a way to reference your workspace. The workspace is the top-level resource for Azure Machine Learning, providing a centralized place to work with all the artifacts you create when you use Azure Machine Learning.
6363

64-
You'll create `ml_client` for a handle to the workspace. You'll then use `ml_client` to manage resources and jobs.
64+
You create `ml_client` for a handle to the workspace. You then use `ml_client` to manage resources and jobs.
6565

6666
In the next cell, enter your Subscription ID, Resource Group name and Workspace name. To find these values:
6767

6868
1. In the upper right Azure Machine Learning studio toolbar, select your workspace name.
69-
1. Copy the value for workspace, resource group and subscription ID into the code.
70-
1. You'll need to copy one value, close the area and paste, then come back for the next one.
69+
1. Copy the value for workspace, resource group and subscription ID into the code.
70+
1. You need to copy one value, close the area and paste, then come back for the next one.
7171

7272
:::image type="content" source="media/tutorial-azure-ml-in-a-day/find-credentials.png" alt-text="Screenshot: find the credentials for your code in the upper right of the toolbar.":::
7373

@@ -117,7 +117,7 @@ os.makedirs(train_src_dir, exist_ok=True)
117117

118118
This script handles the preprocessing of the data, splitting it into test and train data. It then consumes this data to train a tree based model and return the output model.
119119

120-
[MLFlow](how-to-log-mlflow-models.md) will be used to log the parameters and metrics during our pipeline run.
120+
[MLFlow](how-to-log-mlflow-models.md) is used to log the parameters and metrics during our pipeline run.
121121

122122
The cell below uses IPython magic to write the training script into the directory you just created.
123123

@@ -235,13 +235,13 @@ You might need to select **Refresh** to see the new folder and script in your **
235235

236236
## Configure the command
237237

238-
Now that you have a script that can perform the desired tasks, and a compute cluster to run the script, you'll use a general purpose **command** that can run command line actions. This command line action can directly call system commands or run a script.
238+
Now that you have a script that can perform the desired tasks, and a compute cluster to run the script, you use a general purpose **command** that can run command line actions. This command line action can directly call system commands or run a script.
239239

240-
Here, you'll create input variables to specify the input data, split ratio, learning rate and registered model name. The command script will:
241-
* Use an *environment* that defines software and runtime libraries needed for the training script. Azure Machine Learning provides many curated or ready-made environments, which are useful for common training and inference scenarios. You'll use one of those environments here. In [Tutorial: Train a model in Azure Machine Learning](tutorial-train-model.md), you'll learn how to create a custom environment.
240+
Here, you create input variables to specify the input data, split ratio, learning rate and registered model name. The command script will:
241+
* Use an *environment* that defines software and runtime libraries needed for the training script. Azure Machine Learning provides many curated or ready-made environments, which are useful for common training and inference scenarios. You use one of those environments here. In [Tutorial: Train a model in Azure Machine Learning](tutorial-train-model.md), you learn how to create a custom environment.
242242
* Configure the command line action itself - `python main.py` in this case. The inputs/outputs are accessible in the command via the `${{ ... }}` notation.
243243
* In this sample, we access the data from a file on the internet.
244-
* Since a compute resource was not specified, the script will be run on a [serverless compute cluster](how-to-use-serverless-compute.md) that is automatically created.
244+
* Since a compute resource wasn't specified, the script is run on a [serverless compute cluster](how-to-use-serverless-compute.md) that is automatically created.
245245

246246

247247
```python
@@ -269,7 +269,7 @@ job = command(
269269

270270
## Submit the job
271271

272-
It's now time to submit the job to run in Azure Machine Learning. This time you'll use `create_or_update` on `ml_client`.
272+
It's now time to submit the job to run in Azure Machine Learning. This time you use `create_or_update` on `ml_client`.
273273

274274

275275
```python
@@ -280,7 +280,7 @@ ml_client.create_or_update(job)
280280

281281
View the job in Azure Machine Learning studio by selecting the link in the output of the previous cell.
282282

283-
The output of this job will look like this in the Azure Machine Learning studio. Explore the tabs for various details like metrics, outputs etc. Once completed, the job will register a model in your workspace as a result of training.
283+
The output of this job looks like this in the Azure Machine Learning studio. Explore the tabs for various details like metrics, outputs etc. Once completed, the job registers a model in your workspace as a result of training.
284284

285285
:::image type="content" source="media/tutorial-azure-ml-in-a-day/view-job.gif" alt-text="Screenshot shows the overview page for the job.":::
286286

@@ -291,11 +291,11 @@ The output of this job will look like this in the Azure Machine Learning studio.
291291

292292
Now deploy your machine learning model as a web service in the Azure cloud, an [`online endpoint`](concept-endpoints.md).
293293

294-
To deploy a machine learning service, you'll use the model you registered.
294+
To deploy a machine learning service, you use the model you registered.
295295

296296
## Create a new online endpoint
297297

298-
Now that you have a registered model, it's time to create your online endpoint. The endpoint name needs to be unique in the entire Azure region. For this tutorial, you'll create a unique name using [`UUID`](https://en.wikipedia.org/wiki/Universally_unique_identifier).
298+
Now that you have a registered model, it's time to create your online endpoint. The endpoint name needs to be unique in the entire Azure region. For this tutorial, you create a unique name using [`UUID`](https://en.wikipedia.org/wiki/Universally_unique_identifier).
299299

300300

301301
```python
@@ -349,9 +349,9 @@ print(
349349

350350
## Deploy the model to the endpoint
351351

352-
Once the endpoint is created, deploy the model with the entry script. Each endpoint can have multiple deployments. Direct traffic to these deployments can be specified using rules. Here you'll create a single deployment that handles 100% of the incoming traffic. We have chosen a color name for the deployment, for example, *blue*, *green*, *red* deployments, which is arbitrary.
352+
Once the endpoint is created, deploy the model with the entry script. Each endpoint can have multiple deployments. Direct traffic to these deployments can be specified using rules. Here you create a single deployment that handles 100% of the incoming traffic. We chose a color name for the deployment, for example, *blue*, *green*, *red* deployments, which is arbitrary.
353353

354-
You can check the **Models** page on Azure Machine Learning studio, to identify the latest version of your registered model. Alternatively, the code below will retrieve the latest version number for you to use.
354+
You can check the **Models** page on Azure Machine Learning studio, to identify the latest version of your registered model. Alternatively, the code below retrieves the latest version number for you to use.
355355

356356

357357
```python
@@ -362,7 +362,7 @@ latest_model_version = max(
362362
print(f'Latest model is version "{latest_model_version}" ')
363363
```
364364

365-
Deploy the latest version of the model.
365+
Deploy the latest version of the model.
366366

367367

368368
```python
@@ -428,7 +428,7 @@ ml_client.online_endpoints.invoke(
428428

429429
## Clean up resources
430430

431-
If you're not going to use the endpoint, delete it to stop using the resource. Make sure no other deployments are using an endpoint before you delete it.
431+
If you're not going to use the endpoint, delete it to stop using the resource. Make sure no other deployments are using an endpoint before you delete it.
432432

433433

434434
> [!NOTE]
@@ -461,7 +461,7 @@ Now that you have an idea of what's involved in training and deploying a model,
461461

462462
|Tutorial |Description |
463463
|---------|---------|
464-
| [Upload, access and explore your data in Azure Machine Learning](tutorial-explore-data.md) | Store large data in the cloud and retrieve it from notebooks and scripts |
464+
| [Upload, access, and explore your data in Azure Machine Learning](tutorial-explore-data.md) | Store large data in the cloud and retrieve it from notebooks and scripts |
465465
| [Model development on a cloud workstation](tutorial-cloud-workstation.md) | Start prototyping and developing machine learning models |
466466
| [Train a model in Azure Machine Learning](tutorial-train-model.md) | Dive in to the details of training a model |
467467
| [Deploy a model as an online endpoint](tutorial-deploy-model.md) | Dive in to the details of deploying a model |

0 commit comments

Comments
 (0)