Schema: Model

(v0.0.1)

Model

kind: Model
metadata:
  name: string
  labels:
    property1: string
    property2: string
  annotations:
    ? property1
    ? property2
spec:
  runtime:
    dynlib:
      - path: string
        os: string
        arch: string
        variant: string
        libs:
          - string
        annotations:
          ? property1
          ? property2
    executable:
      - os: string
        arch: string
        libs:
          - string
        annotations:
          ? property1
          ? property2
    gateway:
      annotations:
        ? property1
        ? property2
    mcl:
      - path: string
        os: string
        arch: string
        variant: string
        libs:
          - string
        annotations:
          ? property1
          ? property2
  channels:
    - name: string
      alias: string
      expectedModelCount: 0
      selectors:
        property1: string
        property2: string
      annotations:
        ? property1
        ? property2

This schema object defines a Model kind. A Model kind is used to define a model which participates within a DSE based simulation.

Properties

NameTypeRequiredDescription
kindstringtruenone
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
specModelSpectruenone

Enumerated Values

PropertyValue
kindModel

ModelSpec

runtime:
  dynlib:
    - path: string
      os: string
      arch: string
      variant: string
      libs:
        - string
      annotations:
        ? property1
        ? property2
  executable:
    - os: string
      arch: string
      libs:
        - string
      annotations:
        ? property1
        ? property2
  gateway:
    annotations:
      ? property1
      ? property2
  mcl:
    - path: string
      os: string
      arch: string
      variant: string
      libs:
        - string
      annotations:
        ? property1
        ? property2
channels:
  - name: string
    alias: string
    expectedModelCount: 0
    selectors:
      property1: string
      property2: string
    annotations:
      ? property1
      ? property2

Properties

NameTypeRequiredDescription
runtimeobjectfalseSelects (or defines) the kind of runtime that a particular model implements. In some cases several runtimes of a particular type may be defined according to operating system architecture.
» dynlib[LibrarySpec]falseDynamic Library runtime specifications.
» executable[ExecutableSpec]falseExecutable runtime specifications.
» gatewayGatewaySpecfalseDefines a Gateway Model which represents a connection from a remote simulation system. The remote system loads a model which includes the ModelC Gateway functionality, that model is then able to connect to a DSE based simulation using the ModelC Gateway functionality.
The remote system may be a different type of simulation environment.
» mcl[LibrarySpec]falseModel Compatibility Library runtime specifications.
channels[object]falseA list of channels belonging to this model.
» 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

LibrarySpec

path: string
os: string
arch: string
variant: string
libs:
  - string
annotations:
  ? property1
  ? property2

Defines a Model which is implemented as a dynamic library. The model defined here will be loaded by an appropriate runtime executable, that executable provides all necessary library functions related to the DSE simulation environment. Addition libraries may be specified via the libs property.

Properties

NameTypeRequiredDescription
pathstringtrueThe relative (to the model package) path to the runtime artifact.
osstringfalseIndicate the operating system of the runtime (e.g. linux, windows).
archstringfalseIndicate the architecture of the runtime (e.g. amd64, w32)
variantstringfalseIndicate the architecture sub variant of the runtime (e.g. v7)
libs[string]falseA list of libraries on which the runtime is dependant.
annotationsobjectfalseNon identifying information (i.e. information specific to the object itself).
» additionalPropertiesanyfalsenone

GatewaySpec

annotations:
  ? property1
  ? property2

Defines a Gateway Model which represents a connection from a remote simulation system. The remote system loads a model which includes the ModelC Gateway functionality, that model is then able to connect to a DSE based simulation using the ModelC Gateway functionality. The remote system may be a different type of simulation environment.

Properties

NameTypeRequiredDescription
annotationsLibrarySpec/properties/annotationsfalseNon identifying information (i.e. information specific to the object itself).

ExecutableSpec

os: string
arch: string
libs:
  - string
annotations:
  ? property1
  ? property2

Defines a model implemented in an executable. The functions representing the model functionality will be taken directly from linked symbols in the executable file.

Properties

NameTypeRequiredDescription
osstringfalseIndicate the operating system of the executable (e.g. linux, windows).
archstringfalseIndicate the architecture of the executable (e.g. amd64, w32)
libs[string]falseA list of libraries on which the executable is dependant. The executable would load each of the listed libraries.
annotationsLibrarySpec/properties/annotationsfalseNon identifying information (i.e. information specific to the object itself).

undefined