Schema: Stack

(v0.0.1)

Stack

kind: Stack
metadata:
  name: default
  annotations:
    simulation:
      stepsize: 0.0005
      endtime: 0.2
spec:
  connection:
    transport:
      redis:
        timeout: 60
        uri: redis://localhost:6379
  models:
    - name: simbus
      uid: 0
      model:
        name: simbus
      channels:
        - expectedModelCount: 1
          name: physical
    - name: input
      uid: 1
      model:
        name: dse.modelc.csv
      runtime:
        env:
          CSV_FILE: model/input/data/input.csv
        paths:
          - model/input/data
      channels:
        - alias: signal_channel
          name: physical
          selectors:
            channel: signal_vector
            model: input

A stack definition.

Properties

NameTypeRequiredDescription
kindstringtrueIndicate the type of object.
metadataobjectfalseInformation relating to an object.
» namestringfalseThe name of the object.
» labelsobjectfalseIdentifying information used to identify objects within the system (e.g. giving a specific ’label’ to an object).
»» additionalPropertiesstringfalsenone
» annotationsobjectfalseNon identifying information (i.e. information specific to the object itself).
»» additionalPropertiesanyfalsenone
specStackSpectruenone

Enumerated Values

PropertyValue
kindStack

StackSpec

connection:
  timeout: string
  transport:
    redis:
      uri: string
      timeout: 0
runtime:
  env:
    property1: string
    property2: string
  stacked: true
  sequential: true
models:
  - name: string
    uid: 0
    annotations:
      ? property1
      ? property2
    model:
      name: string
      mcl:
        strategy: string
        models:
          - name: string
    runtime:
      env:
        property1: string
        property2: string
      files:
        - string
      paths:
        - string
      x32: true
      i386: true
      external: true
    channels:
      - name: string
        alias: string
        expectedModelCount: 0
        selectors:
          property1: string
          property2: string
        annotations:
          ? property1
          ? property2

Properties

NameTypeRequiredDescription
connectionobjectfalsenone
» timeoutstringfalseModel timeout for messages from the transport.
» transportobjectfalsenone

oneOf

NameTypeRequiredDescription
»» anonymousobjectfalsenone
»»» redisRedisConnectiontrueRedis connection.

xor

NameTypeRequiredDescription
»» anonymousobjectfalsenone
»»» redispubsubRedisConnectiontrueRedis connection.

xor

NameTypeRequiredDescription
»» anonymousobjectfalsenone
»»» mqMessageQueuetrueMessage Queue based connection.

continued

NameTypeRequiredDescription
runtimeStackRuntimefalseRuntime properties of a Stack.
models[ModelInstance]false[A model instance object.]

ModelInstance

name: string
uid: 0
annotations:
  ? property1
  ? property2
model:
  name: string
  mcl:
    strategy: string
    models:
      - name: string
runtime:
  env:
    property1: string
    property2: string
  files:
    - string
  paths:
    - string
  x32: true
  i386: true
  external: true
channels:
  - name: string
    alias: string
    expectedModelCount: 0
    selectors:
      property1: string
      property2: string
    annotations:
      ? property1
      ? property2

A model instance object.

Properties

NameTypeRequiredDescription
namestringtruenone
uidintegertruenone
annotationsobjectfalseNon identifying information (i.e. information specific to the object itself).
» additionalPropertiesanyfalsenone
modelobjecttruenone
» namestringtruenone
» mclobjectfalsenone
»» strategystringtruenone
»» models[object]trueA list of models belonging to this MCL.
»»» namestringtrueThe name of the MCL model.
runtimeModelInstanceRuntimefalseRuntime properties of a Model Instance.
channels[object]falsenone
» namestringfalseThe name of the channel, used when connecting this channel to the SimBus.
» aliasstringfalseThe alias of the channel, used when the channel name will be determined elsewhere.
» expectedModelCountintegerfalseIndicates how many models are expected to connect to this channel (used by SimBus only).
» selectorsobjectfalseIdentifying information used to identify objects within the system (e.g. giving a specific ’label’ to an object).
»» additionalPropertiesstringfalsenone
» annotationsobjectfalseNon identifying information (i.e. information specific to the object itself).
»» additionalPropertiesanyfalsenone

StackRuntime

env:
  property1: string
  property2: string
stacked: true
sequential: true

Runtime properties of a Stack.

Properties

NameTypeRequiredDescription
envobjectfalseEnvironment variables.
» additionalPropertiesstringfalsenone
stackedbooleanfalseRun all Models (of this stack) in a single instance of ModelC.
sequentialbooleanfalseRun the Models in this Stack as a Sequential Co-Simulation. All Models run in a single instance of ModelC (i.e. setting stacked is implicitly selected).

ModelInstanceRuntime

env:
  property1: string
  property2: string
files:
  - string
paths:
  - string
x32: true
i386: true
external: true

Runtime properties of a Model Instance.

Properties

NameTypeRequiredDescription
envobjectfalseEnvironment variables.
» additionalPropertiesstringfalsenone
files[string]falseAdditional file arguments passed to ModelC.
paths[string]falsePaths to scan for additional (YAML) files, subsequently passed as arguments ModelC.
x32booleanfalseRun Model with 32bit ModelC executable (x32 abi).
i386booleanfalseRun Model with 32bit ModelC executable (i386 abi).
externalbooleanfalseThis model is external to the operated simulation (e.g. a Gateway).

RedisConnection

uri: string
timeout: 0

Redis connection.

Properties

NameTypeRequiredDescription
uristringfalsenone
timeoutintegerfalsenone

MessageQueue

uri: string

Message Queue based connection.

Properties

NameTypeRequiredDescription
uristringfalsenone

undefined