Edit a Scenario Definition

After creating an optimization scenario, the next step is defining how it will work.  This document provides information on the steps and details for defining a scenario.

It is helpful to understand the basic concepts related to doing optimization in LityxIQ.  See this document as a starting point: https://support.lityxiq.com/971326-Conceptual-Overview-of-LityxIQ-Optimize.

First, select the scenario from the list of available scenarios in the selected scenario library.  Then click Edit Settings from the Selected Scenario menu or from the right click menu.  If you just created a new scenario, this step will not be necessary.


The Scenario Settings dialog has a number of tabs, each with a number of options.  These are described below:


Dataset & Settings Tab

Scenario Definition Method - The standard setting is "Do Not Use a Template".  This setting implies that you will define everything about the scenario directly in this dialog.  You also are able to select other scenarios that have been defined in the project.  If you select another scenario, that scenario's definition will be imported, and you can always start again with its definition by clicking the Reset Scenario to Match Template button.

Dataset - Select the dataset that will serve as the basis for the data that will drive the optimization results.  Any dataset you have permissions for in Data Manager will be available.

Optimization Dimension - Select the variable that will serve as optimization dimension.  The optimization decisions that are made will be made individually for all unique combinations of the levels of the selected dimensions.  A typical example is to select a unique individual ID variable when optimizing decisions for prospects (for example).  In this case, the output of the optimization will give a decision such as "target" or "not target" for each unique ID.  In Operations Research, this is often referred to as the Decision Variable.

Attributes - Select the variables that can be used as a basis for constraints or for reporting. Only string and integer variables (with not too many unique values) can be selected. Although you can select any number of variables in this list, it is more efficient to just select the ones you will actually use since LityxIQ will track data for all selected Attributes.

Data Elements - Select the variables that can you wish to use as quantitative data about each dimension level.  They are used to define optimization metrics, and can also be used within constraint definitions to provide dynamic constraint bounds.  Only numeric variables are available in this list.  Although you can select any or all numeric variables from the dataset in this list, it is more efficient to just select the ones you will actually use since LityxIQ will track data for all selected Data Elements.

Output Label - Enter into this text box the variable label you would like to assign to the result of this optimization run.  This setting for Output Label will be the name of that variable in the resulting datasets, and it will have a value assigned for each unique value of the Optimization Dimension variable.

Output Data Type - Choose the option that matches your problem and the required output.

  • Binary - the result of the optimization will be a 0/1 decision (binary decision) for each unique level of the Optimization Dimension variable.  This is a common setting, and is appropriate for situation where you want to optimize the decision of "doing something" or "not doing something".  An example is the decision to target a specific prospect, or not target them.
  • Integer - the result of the optimization will be an integer result, for each unique level of the Optimization Dimension variable.  This setting would be used in situation where you are looking to decide the optimal number of times to do something.  For example, the optimal number of emails to send over a certain time period would be a use case for the "Integer" setting.
  • Continuous Values - the result of the optimization can be any continuous (real) number.  This setting would be used in a situation where the result you require for each unique level of the Optimization Dimension variable is a value such a budget level, or perhaps a value such as lifetime value.


Metrics & Objective Tab

On the Metrics & Objective tab, you will define the metric variables to be used in the optimization settings, as well as the settings related to how the optimization reaches an optimal result.

Defined Metrics - Metrics are summaries of the dataset than can be used to optimize against, or for reporting purposes.  Mathematically, these may be referred to as "objective functions".  More information for defining optimization metrics and working with this list is provided in this document: https://support.lityxiq.com/773516-Define-Optimization-Metrics.

Max/Min - Select either Maximize or Minimize.  The correct choice depends completely on the Objective Function you pick in the next option, and the overall business objective of your situation.

Objective Function - The metrics that have been defined on the "Dataset & Settings" tab will appear in this list.  Only metrics that meet the definition of a mathematical "objective function" will be on the list.  Select the metric that you want to optimize (in combination with the Max/Min selection).

Solver Option - Select the standard solver, or the Gurobi solver.  You will only have access to the Gurobi solver if your organization is subscribed to the Gurobi-enhanced LityxIQ license.

  • Note: the option "Use Gurobi-Enhanced License if Token Available" is relevant if your organization has a Gurobi-enhanced LityxIQ license.  In this case, the number of simultaneous problems that can be solved using the Gurobi solver is determined by the license.  This option allows you to use the Standard solver automatically in case all license slots are currently in use by other problems.


Constraints Tab

The Constraints tab provides a list of all constraints, as well as the ability to add new constraints, or delete and modify existing constraints.  This functionality is explained further in this document: https://support.lityxiq.com/845223-Manage-Optimization-Constraints.


Filter Tab

The filter tab can be used to specify a subset of the data that will be used in the optimization.  See https://support.lityxiq.com/806706-Using-the-Filter-Dialog for more information on using the filtering and searching dialog. 


When finished, click Save to save the scenario settings and close the dialog.