Loading and Capturing Partial Data Sets

• You might be able to improve performance by populating only the input entities an execution mode requires, and capturing only the entities that it has changed when the model exits. This limits the amount of data that must be loaded and transmitted over the network, which can improve performance with large data sets.
• Similarly, you might be able to reduce the resource requirements of an execution mode by limiting the amount of data that must be read into memory.
• You might want to preserve results from previous model executions with different execution modes. If you have an execution mode that changes only a few entities from their initial values, you can choose to capture only those entities when the model exits. Other entities are unaffected, which means that result values from previous model executions are preserved. You can use this approach to overlay the results of multiple model runs using different execution modes.

To populate only the required entities from Insight, pass a list of entity names to insightpopulate, as in this example:

!@insight.execmodes.LOAD
public procedure doload
  insightpopulate(['UserNames', 'UserEmails'])

  ! Log out the user names and emails
  forall (id in UserIDs) do
    writeln('User #', id, ': ', UserNames[id], ' (', UserEmails[id], ')')
  end-do

end-procedure

When the model runs using this execution mode, only the specified entities and any required index sets are populated. All other input entities retain their default initial values as defined by the model.

To capture only certain result entities when the model exits, call the insightcapture procedure and pass a list of entity names, as in this example:

!@insight.execmodes.RUN
public procedure dorun
  ! Populate with Insight scenario data and solve model 1
  insightpopulate
  solvemodel1
  ! Capture just the entities updated by model 1
  insightcapture(['profit1', 'factories'])
end-procedure

When the model exits, Xpress Insight captures and persists only the specified entities and any required index sets. All other entities retain their existing values.

Note: Calling insightcapture is optional. If you do not call insightcapture, Insight will capture all result entities when the model exits.