This section details the Model Class and the logics the Multifactor Elasticity Accelerator deploys. Each step’s aim, outputs, and main reasons to modify the logics are explained. If there is a need to modify the Python job, refer to Run Python Scripts.

In this section:

Multifactor Elasticity Model Class

The Multifactor Elasticity Model Class organizes a list of logics to create the model architecture. It is a JSON file that refers to some logics and it is transformed into an UI in the Pricefx platform that is organized in 4 steps:

Definition − Maps the transactions source and configures the model.
Additional Sources − Allows the user to define up to 3 additional sources to be included in the model training data.
Model Training − Checks the quality of the model after its training and defines the elasticity settings.
Model Predictions − Forecasts quantities and shows elasticity functions details.

There are two types of logics: calculation, which writes tables in the model, and evaluation, whose purpose is only to display some results. The standard Model Class definition is documented in Model Class (MC).

All the logics of the Multifactor Elasticity Model Class follow a standard naming convention: first MFE_ prefix, then the step number and name, then Calc or Eval, depending on the formula nature, then the tab it is referring to.

Library

The logic is MFE_Lib.

This logic contains some functions needed specifically for this Accelerator, such as reading its configuration from the application settings, applying the user filters in each part of the model, preprocessing the data for the charts, and many small helpers for the charts rendering. The elements ParametersUtils, TablesUtils, and LabelsUtils contain the names of many elements, tables and fields of the models.

This lib is the place to change input names inside the model to reflect the user business vocabulary. LabelsUtils contains text that is shown in the UI, ParametersUtils and TablesUtilscontain table names and parameter names, respectively. Here you can also write functions to be used in different places of the model class.

Definition Step

This step runs the MFE_1_Def_Calc_FetchData calculation and displays two tabs: Definition and Model Configuration.

Calculation: Generate Parameter Table

This logic generates a parameter table containing default model training parameters. If the table already exists, it does nothing.

The TrainingParameters parameter table.

To change the default values in the table.

Definition Tab

The logics are MFE_1_Def_Eval_Definition and MFE_1_Def_Eval_Definition_Configurator.

Model Configuration Tab

The logic is MFE_1_Def_Eval_ModelConfiguration.

Additional Sources Step

This step allows the user to define up to 3 additional sources which will be added to the training data selected in the Definition step. The logics are MFE_2_Add_Eval_AdditionalSources and MFE_2_Add_Eval_AdditionalSources_Configurator.

Model Training Step

This step runs the MFE_3_Train_Calc_TrainModel calculation and displays the tabs Model Training Results, Train and Test Forecasts, Training curves, and Elasticity Settings.

Calculation: Train the Model

The logic is MFE_3_Train_Calc_TrainModel.

Model Training Results Tab

The logic is MFE_3_Train_Eval_ModelTrainingResults.

Train and Test Forecasts Tab

The logics are MFE_3_Train_Eval_TrainTestForecasts and MFE_3_Train_Eval_TrainTestForecasts_Configurator.

Training Curves Tab

The logic is MFE_3_Train_Eval_TrainingCurves.

Elasticity Settings Tab

The logic is MFE_3_Train_Eval_ElasticitySettings.

Model Predictions Step

This step runs the MFE_4_Pred_Calc_Results and MFE_4_Pred_Calc_PostProcess calculations and displays two tabs: Overview and Details.

Calculation: Results

The logic is MFE_4_Pred_Calc_Results.

Calculation: Post Process

The logic is MFE_4_Pred_Calc_PostProcess.

Overview Tab

The logic is MFE_4_Pred_Eval_Overview.

Details Tab

The logics are MFE_4_Pred_Eval_Details and MFE_4_Pred_Eval_Details_Configurator.

Evaluation

The model has one evaluation with three elements that return information based on the given input: ElasticityFactorsTableName, ElasticityFallbackTableName, and Configuration. For more details about model evaluations see Query Optimization Engine Results | Using the Evaluator.

The logic is MFE_Eval_QueryResults.

Accelerators Documentation

Technical User Reference (Optimization - Multifactor Elasticity)

Analytics