List of Parameters¶
Below is a full list of the parameters that the create_network
function can take, along with a description of the values required.
arrival_distributions¶
Required
Describes the inter-arrival distributions for each node and customer class. This is a dictionary, with keys as customer classes, and values are lists containing the inter-arrival distribution objects for each node. If only one class of customer is required it is sufficient to simply enter a list of inter-arrival distributions. For more details on inputting distributions, see How to Set Arrival & Service Distributions.
An example is shown:
arrival_distributions={'Class 0': [ciw.dists.Exponential(rate=2.4),
ciw.dists.Uniform(lower=0.3, upper=0.5)],
'Class 1': [ciw.dists.Exponential(rate=3.0),
ciw.dists.Deterministic(value=0.8)]}
An example where only one class of customer is required:
arrival_distributions=[ciw.dists.Exponential(rate=2.4),
ciw.dists.Exponential(rate=2.0)]
batching_distributions¶
Optional
Describes the discrete distributions of size of the batch arrivals for each node and customer class. This is a dictionary, with keys as customer classes, and values are lists containing the batch distribution objects for each node. If only one class of customer is required it is sufficient to simply enter a list of batch distributions. For more details on batching, see How to Set Batch Arrivals.
An example is shown:
batching_distributions={'Class 0': [ciw.dists.Deterministic(value=1),
ciw.dists.Sequential(sequence=[1, 1, 2])],
'Class 1': [ciw.dists.Deterministic(value=3),
ciw.dists.Deterministic(value=2)]}
An example where only one class of customer is required:
batching_distributions=[ciw.dists.Deterministic(value=2),
ciw.dists.Deterministic(value=1)]
baulking_functions¶
Optional
A dictionary of baulking functions for each customer class and each node. It describes the baulking mechanism of the customers. For more details see How to Simulate Baulking Customers. If left out, then no baulking occurs.
Example:
baulking_functions={'Class 0': [probability_of_baulking]}
class_change_matrices¶
Optional
A dictionary of class change matrices for each node. For more details see How to Set Dynamic Customer Classes.
An example for a two node network with two classes of customer:
class_change_matrices=[
{'Class 0': {'Class 0': 0.3, 'Class 1': 0.4, 'Class 2': 0.3},
'Class 1': {'Class 0': 0.1, 'Class 1': 0.9, 'Class 2': 0.0},
'Class 2': {'Class 0': 0.5, 'Class 1': 0.1, 'Class 2': 0.4}},
{'Class 0': {'Class 0': 1.0, 'Class 1': 0.0, 'Class 2': 0.0},
'Class 1': {'Class 0': 0.4, 'Class 1': 0.5, 'Class 2': 0.1},
'Class 2': {'Class 0': 0.2, 'Class 1': 0.2, 'Class 2': 0.6}}
]
number_of_servers¶
Required
A list of the number of parallel servers at each node.
If a server schedule is used, the schedule is given instead of a number.
For more details on server schedules, see How to Set Server Schedules.
A value of float('inf')
may be given is infinite servers are required.
Example:
number_of_servers=[1, 2, float('inf'), 1, [[1, 10], [2, 15]]]
priority_classes¶
Optional
A dictionary mapping customer classes to priorities. For more information see How to Set Priority Classes. If left out, no priorities are used, that is all customers have equal priorities.
Example:
priority_classes={'Class 0': 0,
'CLass 1': 1,
'Class 2': 1}
queue_capacities¶
Optional
A list of maximum queue capacities at each node.
If ommitted, default values of float('inf')
for every node are given.
Example:
queue_capacities=[5, float('inf'), float('inf'), 10]
routing¶
Required for more than 1 node
Optional for 1 node
Describes how each customer class routes around the system. This may be a routing matrix for each customer class, or a list routing function for process-based simulations, see How to Define Process-Based Routing.
This is a dictionary, with keys as customer classes, and values are lists of lists (matrices) containing the routing probabilities. If only one class of customer is required it is sufficient to simply enter single routing matrix (a list of lists).
An example is shown:
routing={'Class 0': [[0.1, 0.3],
[0.0, 0.8]],
'Class 1': [[0.0, 1.0],
[0.0, 0.0]]}
An example where only one class of customer is required:
routing=[[0.5, 0.3],
[0.2, 0.6]]
If using only one node, the default value is:
routing={'Class 0': [[0.0]]}
Otherwise a process-based routing function:
routing=[routing_function]
service_distributions¶
Required
Describes the service distributions for each node and customer class. This is a dictionary, with keys as customer classes, and values are lists containing the service distribution objects for each node. If only one class of customer is required it is sufficient to simply enter a list of service distributions. For more details on inputting distributions, see How to Set Arrival & Service Distributions.
An example is shown:
service_distributions={'Class 0': [ciw.dists.Exponential(rate=4.4),
ciw.dists.Uniform(lower=0.1, upper=0.9)],
'Class 1': [ciw.dists.Exponential(rate=6.0),
ciw.dists.Lognormal(mean=0.5, sd=0.6)]}
An example where only one class of customer is required:
service_distributions=[ciw.dists.Exponential(rate=4.8),
ciw.dists.Exponential(rate=5.2)]