Quick start: Build, run, and deploy a Decision Optimization model

Here are some tips for successfully completing this tutorial.

You need a project to store the data and the AutoAI experiment. You can use an existing project or create a project.

1. From the navigation menu , choose Projects > View all projects

2. Open an existing project. If you want to use a new project:

   1. Click New project.

   2. Select Create an empty project.

   3. Enter a name and optional description for the project.

   4. Choose an existing object storage service instance or create a new one.

   5. Click Create.

3. When the project opens, click the Manage tab and select the Services and integrations page.

   1. On the IBM services tab, click Associate service.

   2. Select your Watson Machine Learning instance. If you don't have a Watson Machine Learning service instance provisioned yet, follow these steps:

      1. Click New service.

      2. Select Watson Machine Learning.

      3. Click Create.

      4. Select the new service instance from the list.

   3. Click Associate service.

   4. If necessary, click Cancel to return to the Services & Integrations page.

For more information, see Creating a project.

To preview this task, watch the video beginning at 00:20.

Now, follow these steps to create the Decision Optimization experiment in your project:

1. From your new project, click New asset > Decision Optimization.

2. Select Local file.

3. Click Get sample files to view the GitHub repository containing the sample files.

   1. In the DO-Samples repository, open the watsonx.ai and Cloud Pak for Data as a Service folder.

   2. Click the HouseConstructionScheduling.zip file containing the house construction sample files.

   3. Click Download to save the zip file to your computer.

4. Return to the Create a Decision Optimization experiment page, and click Browse.

   1. Select the HouseConstructionScheduling.zip file from your computer.

   2. Click Open.

5. If you don't already have a Watson Machine Learning service associated with this project, click Add a service.

   1. If you don't have a Watson Machine Learning service instance provisioned, click New service, select Watson Machine Learning, and click Create.

   2. Select your Watson Machine Learning instance from the list, and click Associate.

   3. If necessary, click Cancel to return to the Services & integrations page.

      For more information on associated services, see Adding associated services.

6. Choose a deployment space to associate with this experiment. If you do not have an existing deployment space, create one:

   1. In the Select deployment space section, click New deployment space.

   2. In the Name field, type House sample to provide a name for the deployment space.1. Select a storage service to use for the deployment space.

   3. Click Create.

   4. When the space is ready, and click Close to return to the Create a Decision Optimization experiment page. Your new deployment space is selected.

7. Click Create to open the Decision Optimization experiment.

To preview this task, watch the video beginning at 01:47.

Follow these steps to build a model and visualize the result using the Decision Optimization Modeling Assistant.

1. In the left pane, click Build model to open the Modeling Assistant. This model was built with the Modeling Assistant so you can see that the objectives and constraints are in natural language, but you can also formulate your model in Python, OPL or import CPLEX and CPO models.

2. Click Run to run the scenario to solve the model and wait for the run to complete.

3. When the run completes, the Explore solution view displays. Under the Results tab, click Solution assets to see the resulting (best) values for the decision variables. These solution tables are displayed in alphabetical order by default.

4. In the left pane, select Visualization.

5. Under the Solutions tab, select Gantt to view the scenario with the optimal schedule.

To preview this task, watch the video beginning at 03:01.

Now, you want to make a change to your model formulation to consider an additional objective. Follow these steps to change the model objectives and constraints:

1. Click Build model.

2. In the left pane, click the Overflow menu next to Scenario 1, and select Duplicate.

3. For the name, type Scenario 2, and click Create.

4. For Scenario 2, add an objective to the model to optimize the quality of work based on the expertise of each contractor.

   1. Under Add to model, in the search field, type overall quality, and press Enter.

   2. Expand the Objective section.

   3. Click Maximize overall quality of Subcontractor-Activity assignments according to table of assignment values to add it as an objective. This new objective is now listed under the Objectives section along with the Minimize time to complete all Activities objective.

   4. For the objective that you just added, click table of assignment values, and select Expertise. A list of Expertise parameters displays.

   5. From this list, click definition to change the field that defines contractor expertise, and select Skill Level.

5. Click Run to run the scenario to build the model and wait for the run to complete.

6. Return to the Explore solution page to view the Objectives and Solution assets.

7. In the left pane, select Visualization.

8. Under the Solutions tab, select Gantt to view the scenario with the optimal schedule.

9. Click Overview in the left pane to compare statistics between Scenario 1 and Scenario 2.

To preview this task, watch the video beginning at 04:07.

Next, follow these steps to promote the model to a deployment space, and create a deployment:

1. Click the Overflow menu next to Scenario 1, and select Save for deployment.

2. In the Model name field, type House Construction, and click Next.

3. Review the model information, and click Save.

4. After the model is successfully saved, a notification bar displays with a link to the model. Click View in project.

   1. If you miss the notification, then click the project name in the navigation trail.

   2. Click the Assets tab in the project.

   3. Click the House Construction model.

5. Click the Promote to deployment space icon.

   1. For the Target space, select House sample (or your deployment space) from the list.

   2. Check the option to Check Go to the model in the space after deploying it.

   3. Click Promote.

6. After the model is successfully promoted, the House Construction model displays in the deployment space.

7. Click New deployment.

   1. For the deployment name, type House deployment.

   2. For the Hardware definition, select 2 CPU and 8 GB RAM from the list.

   3. Click Create.

8. Wait for the deployment status to change to Deployed.

To preview this task, watch the video beginning at 04:55.

To test the model with a scenario, you must upload data files from your computer to the deployment space. Follow these steps to test the model by creating a job using the CSV files included with the sample zip file:

1. Click House sample (or your deployment space) in the navigation trail to return to the deployment space.

2. Click the Assets tab.

   1. In the HouseConstructionScheduling.zip file on your computer, you will find several CSV files in the .containers > Scenario 1 folder.

   2. Click the Upload asset icon to open the Data panel.

   3. Drag the Subcontractor.csv, Activity.csv, and Expertise.csv files into the Drop files here or browse for files to upload area in the Data panel.

3. Click the Deployments tab.

4. Click House deployment.

5. Now to submit a job to score the model, click New job.

6. For the job name, type House construction job.

7. Click Next.

8. Select the default values on the Configure page, and click Next.

9. Select the default values on the Schedule page, and click Next.

10. Select the default values on the Notify page, and click Next.

11. On the Choose data page, in the Input section, select the corresponding data assets that you previously loaded into your space for each input ID.

    1. For Input ID Subcontractor.csv, click Select data source > Data asset > Subcontractor.csv > Confirm.

    2. For Input ID Activity.csv, click Select data source > Data asset > Activity.csv > Confirm.

    3. For Input ID Expertise.csv, click Select data source > Data asset > Expertise.csv > Confirm.

12. In the Output section, you will provide the name for each solution table to be created.

    1. For Output ID ScheduledActivities.csv, click Select data source > Create new, type ScheduledActivities.csv for the name, and click Confirm.

    2. For Output ID NotScheduledActivities.csv, click Select data source > Create new, type NotScheduledActivities.csv for the name, and click Confirm.

    3. For Output ID stats.csv, click Select data source > Create new, type stats.csv for the name, and click Confirm.

    4. For Output ID kpis.csv, click Select data source > Create new, type kpis.csv for the name, and click Confirm.

    5. For Output ID solution.json, click Select data source > Create new, type solution.json for the name, and click Confirm.

    6. For Output ID log.txt, click Select data source > Create new, type log.txt for the name, and click Confirm.

13. Review the information on the Choose data page, and then click Next.

14. Review the information on the Review and create page, and then click Create and run.

15. From the House deployment model page, click the job that you created named House construction job to see its status.

16. After the job run completes, click House sample (or your deployment space) to return to the deployment space.

17. On the Assets tab, you will see the output files:

    • ScheduledActivities.csv

    • NotScheduledactivities.csv

    • stats.csv

    • kpis.csv

    • solution.json

    • log.txt

18. For each of these assets, click the Download icon, and then view each of these files.