Merge pull request #5485 from cdpark/refresh-ml-designer-3

Feature 438779: Q&M: Azure ML Designer doc Freshness - batch 3

Author: JillGrant615

articles/machine-learning/v1/how-to-designer-python.md

@@ -1,5 +1,5 @@
 ---
-title: Execute Python Script in the designer
+title: Execute Python Script in the Designer
 titleSuffix: Azure Machine Learning
 description: Learn how to use the Execute Python Script model in Azure Machine Learning designer to run custom operations written in Python.
 services: machine-learning
@@ -8,7 +8,7 @@ ms.subservice: core
 author: lgayhardt
 ms.author: lagayhar
 ms.reviewer: keli19
-ms.date: 02/08/2023
+ms.date: 06/10/2025
 ms.topic: how-to
 ms.custom: UpdateFrequency5, designer, devx-track-python
 ---
@@ -17,36 +17,38 @@ ms.custom: UpdateFrequency5, designer, devx-track-python
 
 [!INCLUDE [v1 deprecation](../includes/sdk-v1-deprecation.md)]
 
-In this article, you'll learn how to use the [Execute Python Script](../algorithm-module-reference/execute-python-script.md) component to add custom logic to the Azure Machine Learning designer. In this how-to, you use the Pandas library to do simple feature engineering.
+This article explains how to use the [Execute Python Script](../algorithm-module-reference/execute-python-script.md) component to add custom logic to the Azure Machine Learning designer. In this guide, you use the Pandas library to do simple feature engineering.
 
-You can use the in-built code editor to quickly add simple Python logic. You should use the zip file method to add more complex code, or to upload additional Python libraries.
+You can use the in-built code editor to quickly add simple Python logic. You should use the zip file method to add more complex code, or to upload more Python libraries.
 
-The default execution environment uses the Anacondas distribution of Python. See the [Execute Python Script component reference](../algorithm-module-reference/execute-python-script.md) page for a complete list of pre-installed packages.
+The default execution environment uses the Anacondas distribution of Python. See the [Execute Python Script](../algorithm-module-reference/execute-python-script.md) component reference for a complete list of preinstalled packages.
 
-![Execute Python input map](media/how-to-designer-python/execute-python-map.png)
+:::image type="content" source="media/how-to-designer-python/execute-python-map.png" alt-text="Diagram that shows the input map for Execute Python Script.":::
 
 > [!IMPORTANT]
-> If you do not see graphical elements mentioned in this document, such as buttons in studio or designer, you may not have the right level of permissions to the workspace. Please contact your Azure subscription administrator to verify that you have been granted the correct level of access. For more information, see [Manage users and roles](../how-to-assign-roles.md).
+> If you don't see graphical elements mentioned in this document, such as buttons in studio or designer, you might not have the right level of permissions to the workspace. Contact your Azure subscription administrator to verify that you have been granted the correct level of access. For more information, see [Manage users and roles](../how-to-assign-roles.md).
 
-## Execute Python written in the designer
+## Execute Python code in the designer
 
 ### Add the Execute Python Script component
 
-1. Find the **Execute Python Script** component in the designer palette. It can be found in the **Python Language** section.
+1. Sign in to the [Azure Machine Learning studio](https://ml.azure.com), and select the workspace you want to use.
 
-1. Drag and drop the component onto the pipeline canvas.
+1. Select **Designer** from the sidebar menu. Under **Classic prebuilt**, choose **Create a new pipeline using classic prebuilt components**.
 
-### Connect input datasets
+1. To the left of the pipeline canvas, select **Component**.
+
+1. In the **Python Language** section, find the **Execute Python Script** component. Drag and drop the component onto the pipeline canvas.
 
-This article uses the **Automobile price data (Raw)** sample dataset.
+### Connect input datasets
 
-1. Drag and drop your dataset to the pipeline canvas.
+1. Find the **Automobile price data (Raw)** sample dataset in the **Sample data** section. Drag and drop the dataset to the pipeline canvas.
 
 1. Connect the output port of the dataset to the top-left input port of the **Execute Python Script** component. The designer exposes the input as a parameter to the entry point script.
 
     The right input port is reserved for zipped Python libraries.
 
-    ![Connect datasets](media/how-to-designer-python/connect-dataset.png)
+    :::image type="content" source="media/how-to-designer-python/connect-dataset.png" alt-text="Screenshot that shows how to connect the dataset nodes together.":::
 
 1. Carefully note the specific input port you use. The designer assigns the left input port to the variable `dataset1`, and the middle input port to `dataset2`.
 
@@ -56,9 +58,9 @@ Input components are optional, since you can generate or import data directly in
 
 The designer provides an initial entry point script for you to edit and enter your own Python code.
 
-In this example, you use Pandas to combine two of the automobile dataset columns - **Price** and **Horsepower** - to create a new column, **Dollars per horsepower**. This column represents how much you pay for each horsepower unit, which could become a useful information point to decide if a specific car is a good deal for its price.
+In this example, you use Pandas to combine two of the automobile dataset columns, **Price** and **Horsepower**, to create a new column called **Dollars per horsepower**. This column represents how much you pay for each horsepower unit, which could become a useful information point to decide if a specific car is a good deal for its price.
 
-1. Select the **Execute Python Script** component.
+1. Double-click the **Execute Python Script** component.
 
 1. In the pane that appears to the right of the canvas, select the **Python script** text box.
 
@@ -71,18 +73,20 @@ In this example, you use Pandas to combine two of the automobile dataset columns
         dataframe1['Dollar/HP'] = dataframe1.price / dataframe1.horsepower
         return dataframe1
     ```
+
     Your pipeline should look like this image:
-    
-    ![Execute Python pipeline](media/how-to-designer-python/execute-python-pipeline.png)
+
+    :::image type="content" source="media/how-to-designer-python/execute-python-pipeline.png" alt-text="Screenshot that shows the Execute Python pipeline.":::
 
     The entry point script must contain the function `azureml_main`. The function has two function parameters that map to the two input ports for the **Execute Python Script** component.
 
-    The return value must be a Pandas Dataframe. You can return at most two dataframes as component outputs.
-    
+    The return value must be a Pandas dataframe. You can return at most two dataframes as component outputs.
+
 1. Submit the pipeline.
 
 Now you have a dataset, which has a new **Dollars/HP** feature. This new feature could help to train a car recommender. This example shows feature extraction and dimensionality reduction.
 
-## Next steps
+## Next step
 
-Learn how to [import your own data](how-to-designer-import-data.md) in Azure Machine Learning designer.
+> [!div class="nextstepaction"]
+> [Import data into Azure Machine Learning designer](how-to-designer-import-data.md)