Cell Simulator – Network Configuration

You can use a Readable Unit anywhere where you have the option of:

  • number or string

  • integer or string

📃 Corresponding configuration file: cell/network.json

Network

Schema describing the JSON file structure for the network configuration. It is is used to define the properties of the global network. If defined as a number, then the default unit is Gb. Alternatively this can be defined as a string to specify the unit of measurement (e.g. ‘3 MB’).

Properties

Type Description Required Boundaries Default
defaultDownlinkCapacity integer
string		 This downlink capacity value will be used for node-specific capacity calculation, if it wasn’t set in the cell configuration. If defined as a number, then the default unit is Gb. Alternatively this can be defined as a string to specify the unit of measurement (e.g. ‘3 MB’). No None 100 Gb
defaultUplinkCapacity integer
string		 This uplink capacity value will be used for node-specific capacity calculation, if it wasn’t set in the cell configuration. No None 100 Gb
globalNetwork globalNetwork Object to define all coverage properties of one region of the radio access network (ran-part). Such a configuration consists of one uplink-module and one downlink-module. In this context, uplink and downlink always refer to the direction TOWARDS and respectively FROM the GEO entity. ✓ Yes None None
servers server List of configured servers. No None None

globalNetwork

Object to define all coverage properties of one region of the radio access network (ran-part). Such a configuration consists of one uplink-module and one downlink-module. In this context, uplink and downlink always refer to the direction TOWARDS and respectively FROM the GEO entity.

Properties

Type Description Required Boundaries Default
uplink globalNetwork.uplink Object to define the uplink of a network. The uplink direction only allows point-to-point communication (unicast). It is composed of the three nested models for delay, transmission configuration and capacity. ✓ Yes None None
downlink globalNetwork.downlink Object to define the downlink of a network. The downlink supports two individual paths: Point-to-point communication (unicast) and Point-to-multipoint communication (multicast). ✓ Yes None None

Object to define the uplink of a network. The uplink direction only allows point-to-point communication (unicast). It is composed of the three nested models for delay, transmission configuration and capacity.

Properties

Type Description Required Boundaries Default
delay delay Object to define a delay model. ✓ Yes None None
transmission transmission Object to define the properties of a transmission. ✓ Yes None None
capacity integer
string		 The capacity. ✓ Yes None None
maxCapacity number The maximal capacity when no transmission is ongoing. No None None

delay

Object to define a delay model.

Additionally ONE of the following property definitions apply:

gammaDelay

Object to define a model for GammaRandomDelay or GammaSpeedDelay. GammaRandomDelay bases directly on the Gamma distribution (b=2,p=2) with minimum and expected value. Due to the nature of the Gamma distribution, the resulting delays can be far higher than the expected value. GammaSpeedDelay bases on the GammaRandomDelay and includes an additional speed penalty according to the current speed of the vehicle.

Properties

Type Description Required Boundaries Default
type string The type of delay. ✓ Yes Enum None
minDelay number
string		 Minimum delay for the Gamma distribution. If defined as a number, then the default unit is ns. Alternatively this can be defined as a string to specify the unit of measurement (e.g. ‘3 seconds’) ✓ Yes None None
expDelay number
string		 Expected delay for the Gamma distribution. If defined as a number, then the default unit is ns. Alternatively this can be defined as a string to specify the unit of measurement (e.g. ‘3 seconds’) ✓ Yes None None

Further property restrictions:

gammaDelay.type

  • Allowed values:
    • GammaRandomDelay
    • GammaSpeedDelay

constantDelay

Object to define a model for constant delay, which delivers always the same delay.

Properties

Type Description Required Boundaries Default
type string The type of delay. ✓ Yes Enum None
delay number
string		 The delay. If defined as a number, then the default unit is ns. Alternatively this can be defined as a string to specify the unit of measurement (e.g. ‘3 seconds’) ✓ Yes None None

Further property restrictions:

constantDelay.type

  • Allowed values:
    • ConstantDelay

simpleRandomDelay

Object to define a model for a radnomised delay. Delivers number-of-steps different uniformly distributed delays in the interval defined by min and max (e.g. minDelay=30ms, maxDelay=60ms, steps=4 -> possible delays={30,40,50,60}ms.).

Properties

Type Description Required Boundaries Default
type string The type of delay. ✓ Yes Enum None
steps integer Number of possible delays between min and max. ✓ Yes [0, +$\infty$] None
minDelay number
string		 Minimum delay in nanoseconds for the Gamma distribution. If defined as a number, then the default unit is ns. Alternatively this can be defined as a string to specify the unit of measurement (e.g. ‘3 seconds’) ✓ Yes None None
maxDelay number
string		 Maximum delay in nanoseconds for the Gamma distribution. If defined as a number, then the default unit is ns. Alternatively this can be defined as a string to specify the unit of measurement (e.g. ‘3 seconds’) ✓ Yes None None

Further property restrictions:

simpleRandomDelay.type

  • Allowed values:
    • SimpleRandomDelay

tranmission

Object to define the properties of a transmission.

Properties

Type Description Required Boundaries Default
lossProbability number Probability of packet retransmission (in case of configured retries > 0) or packet loss (retries = 0) for the packet retransmission/loss model. A value of 0 equals a lossfree transmission. ✓ Yes [0, 1] None
maxRetries integer Maximum Number of retransmissions. No [0, +$\infty$] 0

Object to define the downlink of a network. The downlink supports two individual paths: Point-to-point communication (unicast) and Point-to-multipoint communication (multicast).

Properties

Type Description Required Boundaries Default
unicast unicast Point-to-point communication (unicast). ✓ Yes None None
multicast multicast Point-to-multipoint communication (multicast). ✓ Yes None None
capacity integer
string		 Shared capacity between unicast and multicast. ✓ Yes None None

unicast

Point-to-point communication (unicast).

Properties

Type Description Required Boundaries Default
delay delay Object to define a delay model. ✓ Yes None None
transmission transmission Object to define the properties of a transmission. ✓ Yes None None

multicast

Point-to-multipoint communication (multicast).

Properties

Type Description Required Boundaries Default
delay delay Object to define a delay model. ✓ Yes None None
transmission transmission Object to define the properties of a transmission. ✓ Yes None None
usableCapacity number The usableCapacity configures the ratio of the overall downlink capacity allowed to be used. ✓ Yes [0, 1] None

server

Properties

Type Description Required Boundaries Default
id string Network-Id for identification. ✓ Yes None None
uplink server.uplink Object to define uplink properties of a network. The uplink direction only allows point-to-point communication (unicast). It is composed of the three nested models for delay, transmission configuration and capacity. No None None
downlink server.downlink No None None

Object to define uplink properties of a network. The uplink direction only allows point-to-point communication (unicast). It is composed of the three nested models for delay, transmission configuration and capacity.

Properties

Type Description Required Boundaries Default
delay delay Object to define a delay model. ✓ Yes None None
transmission transmission Object to define the properties of a transmission. ✓ Yes None None

Properties

Type Description Required Boundaries Default
unicast unicast Point-to-point communication (unicast). ✓ Yes None None