Class SimulationArgs

Class respresenting the arguments passed to a WMSimulator instance when a DecisionModel is to be simulated with a specified set of control arguments.

Inheritance

object

SimulationArgs

Implements

IDocumentedEntity

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: Quantellia.WMServer.Simulation

Assembly: WMServer.dll

Syntax

public class SimulationArgs : IDocumentedEntity

Constructors

SimulationArgs()

Declaration

public SimulationArgs()

Properties

DecisionModelID

The ID of the decision model to run this simulation on

Declaration

public string DecisionModelID { get; set; }

Property Value

Type	Description
string

Remarks

The first time the supplied decision model is ran, World Modeler Server will create a new WMProcessor instance, assign it a unique ID, and cache it for further use. Each subsequent run of the supplied decision model during the simulation will make use of this cached processor to save system resources.

Documentation

If the saveAs arguments is not null, then this arguments allows a longer documentation string to be included in the record of the saved evaluation. The MIME type of the string must be specified in the DocumentationMIMEType arguments.

Declaration

public string? Documentation { get; set; }

Property Value

Type	Description
string

DocumentationMIMEType

If both the saveAs arguments and the documentation arguments are not null, then this arguments must be set to the string identifying the MIME type of text in the documentation arguments. If either SaveAs or Documentation are null, then this arguments is ignored.

Declaration

public string? DocumentationMIMEType { get; set; }

Property Value

Type	Description
string

ReturnElements

List of IDs of the DecisionModelElements whose values will be returned to the caller after evaluation of the DecisionModel. If null, all model elements will be returned. If an empty list, then no model elements will be returned.

Declaration

public List<string>? ReturnElements { get; set; }

Property Value

Type	Description
List<string>

Remarks

Returning a smaller subset of model elements can improve efficiency by reducing the I/O processing load. ///

SaveAs

If the inputs and results of the evaluation are to be saved, then this arguments specifies the name used to refer to the saved evaluation. If this arguments is null, then the evaluation will not be saved.

Declaration

public string? SaveAs { get; set; }

Property Value

Type	Description
string

SimulationParams

Dictionary of name = value pairs specifiying values to set for an execution run of the model.

Declaration

public SimulationParams SimulationParams { get; set; }

Property Value

Type	Description
SimulationParams

Remarks

The name (key) specified for each entry can be:

• The short Name of each DecisionModelElement whose value is to be set. This requires that the Name is unique in the model.
• The FullyQualifiedName of the DecisionModelElementwhose value is to be set. This should be used in preference of the short Name if the short Name is not unique in the model.

The object may be either a native data type (int, double, string, DateTime, etc.) or a subtype of ElementValue.

Summary

If the saveAs arguments is not null, then this arguments allows a short summary string to be included in the record of the saved evaluation. If SaveAs is null, then this arguments is ignored.

Declaration

public string? Summary { get; set; }

Property Value

Type	Description
string

UserData

An optional, user-definable string for associated data with this invocation. The data will also be available in object returned to the caller, and matching this invocation.

Declaration

public string? UserData { get; set; }

Property Value

Type	Description
string

Remarks

If the caller needs to be able to associate results to the invocations that generated them, then setting the UserData data to a unique value (e.g. a sequence number) is an effective way to do this. For example, when presenting results in the same order as requests in an asynchronous environment.

Implements

IDocumentedEntity