0 / 0
Quick start: Build, run, and deploy a Decision Optimization model
Last updated: Nov 27, 2024
Quick start: Build, run, and deploy a Decision Optimization model

You can build and run Decision Optimization models to help you make the best decisions to solve business problems based on your objectives. Read about Decision Optimization, then watch a video and take a tutorial that’s suitable for users with some knowledge of prescriptive analytics, but does not require coding.

Required services
watsonx.ai Studio
watsonx.ai Runtime

Your basic workflow includes these tasks:

  1. Create a project. Projects are where you can collaborate with others to work with data.
  2. Add a Decision Optimization Experiment to the project. You can add compressed files or data from sample files.
  3. Associate a watsonx.ai Runtime Service with the project.
  4. Create a deployment space to associate with the project's watsonx.ai Runtime Service.
  5. Review the data, model objectives, and constraints in the Modeling Assistant.
  6. Run one or more scenarios to test your model and review the results.
  7. Deploy your model.

Read about Decision Optimization

Decision Optimization can analyze data and create an optimization model (with the Modeling Assistant) based on a business problem. First, an optimization model is derived by converting a business problem into a mathematical formulation that can be understood by the optimization engine. The formulation consists of objectives and constraints that define the model that the final decision is based on. The model, together with your input data, forms a scenario. The optimization engine solves the scenario by applying the objectives and constraints to limit millions of possibilities and provides the best solution. This solution satisfies the model formulation or relaxes certain constraints if the model is infeasible. You can test scenarios using different data, or by modifying the objectives and constraints and re-running them and viewing solutions. Once satisfied you can deploy your model.

Read more about Decision Optimization

Watch a video about creating a Decision Optimization model

Watch Video Watch this video to see how to run a sample Decision Optimization experiment to create, solve, and deploy a Decision Optimization model with watsonx.ai Studio and watsonx.ai Runtime.

Video disclaimer: Some minor steps and graphical elements in this video might differ from your platform. The user interface is frequently improved.

This video provides a visual method to learn the concepts and tasks in this documentation.


Try a tutorial to create a model that uses Decision Optimization

In this tutorial, you will complete these tasks:

This tutorial will take approximately 30 minutes to complete.





Tips for completing this tutorial
Here are some tips for successfully completing this tutorial.

Use the video picture-in-picture

Tip: Start the video, then as you scroll through the tutorial, the video moves to picture-in-picture mode. Close the video table of contents for the best experience with picture-in-picture. You can use picture-in-picture mode so you can follow the video as you complete the tasks in this tutorial. Click the timestamps for each task to follow along.

The following animated image shows how to use the video picture-in-picture and table of contents features:

How to use picture-in-picture and chapters

Get help in the community

If you need help with this tutorial, you can ask a question or find an answer in the Cloud Pak for Data Community discussion forum.

Set up your browser windows

For the optimal experience completing this tutorial, open Cloud Pak for Data in one browser window, and keep this tutorial page open in another browser window to switch easily between the two applications. Consider arranging the two browser windows side-by-side to make it easier to follow along.

Side-by-side tutorial and UI

Tip: If you encounter a guided tour while completing this tutorial in the user interface, click Maybe later.



Task 1: Open a project

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 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 watsonx.ai Runtime instance. If you don't have a watsonx.ai Runtime service instance provisioned yet, follow these steps:

      1. Click New service.

      2. Select watsonx.ai Runtime.

      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.

Checkpoint icon Check your progress

The following image shows the new project.

The following image shows the new project.




Task 2: Create a Decision Optimization experiment

preview tutorial video 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 > Solve optimization problems.

  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 watsonx.ai Runtime service associated with this project, click Add a service.

    1. If you don't have a watsonx.ai Runtime service instance provisioned, click New service, select watsonx.ai Runtime, and click Create.

    2. Select your watsonx.ai Runtime 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.

Checkpoint icon Check your progress

The following image shows the experiment with the sample files.

The following image shows the experiment with the sample files.




Task 3: Build a model and visualize a scenario result

preview tutorial video 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.

Checkpoint icon Check your progress

The following image shows the Visualization page with a Gantt chart.

The following image shows the Visualization page with a Gantt chart.




Task 4: Change model objectives and constraints

preview tutorial video 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 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.

Checkpoint icon Check your progress

The following image shows the Visualization page with the new Gantt chart.

The following image shows the Visualization page with the new Gantt chart.




Task 5: Deploy the model

preview tutorial video 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 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 Promote to deployment space.

    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.

Checkpoint icon Check your progress

The following image shows the House deployment.

The following image shows the Visualization page with the House deployment.




Task 6: Test a model

preview tutorial video 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 Upload asset to project 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.

Checkpoint icon Check your progress

The following image shows the completed batch job.

The following image shows the Visualization page with the completed batch job.



Next steps

Now you can use this data set for further analysis. For example, you or other users can do any of these tasks:

Additional resources

Parent topic: Quick start tutorials

Generative AI search and answer
These answers are generated by a large language model in watsonx.ai based on content from the product documentation. Learn more