Metadata specification for Discrete Event Systems
Specification (DEVS) simulation models

Version: 1.0

Summary

This metadata specification documents Discrete Event Systems Specification (DEVS) simulation models with the goal of supporting model discoverability, composability and reusability. The specification aims to strike a balance between convenience and useful preservation of models for future use.

The specification subsets relevant elements of the Dublin Core Metadata Initiative (DCMI) and adds a DEVS specific set of metadata properties. Most properties of the DCMI used are specialized by assuming that the documented resource is a DEVS simulation model

Table of contents

• 1. Specification overview
• 1.1 Descriptive metadata
• 1.2 Administrative metadata
• 1.3 Technical metadata
• 1.4 DEVS specific metadata
• 2. Elements of the specification
• 2.1 Elements of descriptive metadata
• 2.2 Elements of administrative metadata
• 2.3 Elements of technical metadata
• 2.4 Elements of DEVS specific metadata
• 3. Examples
• 3.1 JSON example
• 3.2 XML example

1. Specification overview

1.1 Descriptive metadata

1.2 Administrative metadata

1.3 Technical metadata

1.4 DEVS specific metadata

2. Elements of the specification

Each element of the specification is described using the following attributes:

2.1 Elements of descriptive metadata

2.2 Elements of administrative metadata

2.3 Elements of technical metadata

2.4 Elements of DEVS specific metadata

3. Examples

3.1 JSON example

{
   "identifier": "b867ca77-ee01-46bc-9ee2-71a0110f13f2",
   "title": "Hospital Case Load",
   "alternative": "HCL",
   "creator": "Bruno St-Aubin",
   "contributor": ["Carleton University", "ARSLab"],
   "type": "coupled",
   "language": ["en-ca", "fr-ca"],
   "description": "Geographic areas generate emergency periodically. Emergencies are sent to 3 closest hospitals by 
                   road network. If the hospitals have capacity, they are accepted otherwise rejected.",
   "subject": ["network", "web", "computer systems"],
   "spatial coverage": [{
      "placename": "Ottawa",
      "extent": {
         "reference": "epsg:4326",
         "x min": -76.037,
         "x max": -75.243
         "y min": 45.151,
         "y max": 45.489,
      }
   },{
      "placename": "Gatineau",
      "extent": {
         "reference": "epsg:4326",
         "x min": -76.070,
         "x max": -75.306
         "y min": 45.402,
         "y max": 45.685,
      }
   }],
   "temporal coverage": {
      "start": "2020-01-01",
      "end": "2022-01-01",
      "scheme": "ISO 8601",
   },
   "license": "MIT License",
   "created": "2020-05-11",
   "modified": ["2021-02-13", "2021-03-28", "2021-07-06"],
   "time": "NDTime",
   "behavior": "Every 24 hours, a random number of emergencies are generated by a geographic area. The number of emergencies 
                is proportional to the population count of the area and uses a random factor for variance. Emergencies are sent 
                to the first closest hospital by driving distance. Hospitals have a capacity and a number of active cases. If
                a hospital is over capacity, the emergency is rejected and returned to the geographic area. The area then sends 
                it to the second hospital, then third hospital to be processed. If the emergencies are rejected by all 3
                hospitals, they are counted as casualties.",
   "state": null,
   "subcomponent": [{
      "identifier": "generator_1",
      "model": "75b388da-5ac6-11ec-bf63-0242ac130002"
   },{
      "identifier": "receiver_1",
      "model": "7ae167dc-5ac6-11ec-bf63-0242ac130002"
   },{
      "identifier": "subnet_1",
      "model": "800ea31e-5ac6-11ec-bf63-0242ac130002"
   },{
      "identifier": "network_1",
      "model": "856306b6-5ac6-11ec-bf63-0242ac130002"
   },{
      "identifier": "network_2",
      "model": "856306b6-5ac6-11ec-bf63-0242ac130002"
   }],
   "port": [{
      "type": "output",
      "name": "rejected",
      "message": 1
   },
   "message":[{
      "identifier": 1,
      "field": [{
         "name": "area",
         "description": "geographic area id that rejected the emergencies.",
         "type": "nominal"
      },{
         "name": "count",
         "description": "number of emergencies rejected by the geographic area.",
         "type": "numerical",
         "uom": "persons",
         "scalar": "unit",
         "decimals": 0
      }]
   }]
}
		

3.2 XML example

<metadata>
   <identifier>b867ca77-ee01-46bc-9ee2-71a0110f13f2</identifier>
   <title>Hospital Case Load</title>
   <creator>Bruno St-Aubin</creator>
   <contributor>Carleton University</contributor>
   <contributor>ARSLab</contributor>
   <type>coupled</type>
   <language>en-ca</language>
   <language>fr-ca</language>
   <description>Geographic areas generate emergency periodically. Emergencies are sent to 3 closest hospitals by road network. 
		If the hospitals have capacity, they are accepted otherwise rejected.</description>
   <subject>network</subject>
   <subject>web</subject>
   <subject>computer systems</subject>
   <spatial_coverage>
      <placename>Ottawa</placename>
      <extent>
         <reference>epsg:4326</reference>
         <x_min>-76.037</x_min>
         <x_max>-75.243</x_max>
         <y_min>45.151</y_min>
         <y_max>45.489</y_max>
      </extent>
   </spatial_coverage>
   <spatial_coverage>
      <placename>Gatineau</placename>
      <extent>
         <reference>epsg:4326</reference>
         <x_min>-76.070</x_min>
         <x_max>-75.306</x_max>
         <y_min>45.402</y_min>
         <y_max>45.685</y_max>
      </extent>
   </spatial_coverage>
   <temporal_coverage>
      <start>2020-01-01</start>
      <end>2022-01-01</end>
      <scheme>ISO 8601</scheme>
   </temporal_coverage>
   <license>MIT License</license>
   <created>2020-05-11</created>
   <modified>2021-02-13</modified>
   <modified>2021-03-28</modified>
   <modified>2021-07-06</modified>
   <time>NDTime</time>
   <behavior>
	Every 24 hours, a random number of emergencies are generated by a geographic area. The number of emergencies 
	is proportional to the population count of the area and uses a random factor for variance. Emergencies are sent to the 
	first closest hospital by driving distance. Hospitals have a capacity and a number of active cases. If a hospital is 
	over capacity, the emergency is rejected and returned to the geographic area. The area then sends it to the second 
	hospital, then third hospital to be procesed. If the emergencies are rejected by all 3 hospitals, they are counted as 
	casualties.
   </behavior>
   <state></state>
   <subcomponent>
      <identifier>generator</identifier>
      <model>773656ca-169c-4858-9a94-1814da118156</model>
   </subcomponent>
   <subcomponent>
      <identifier>receiver</identifier>
      <model>1dbb558d-813d-4b0e-81a2-18f071848fc0</model>
   </subcomponent>
   <subcomponent>
      <identifier>subnet</identifier>
      <model>3c185942-6e91-40c6-9cad-aa02d7d94a50</model>
   </subcomponent>
   <subcomponent>
      <identifier>network</identifier>
      <model>da168216-d2a3-4a6a-ba1d-4685b8e0b893</model>
   </subcomponent>
   <port>
      <type>output</type>
      <name>rejected</name>
      <message>1</message>
   </port>
   <message>
      <identifier>1</identifier>
      <field>
         <name>area</name>
         <description>geographic area id that rejected the emergencies.</description>
         <type>nominal</type>
      </field>
      <field>
         <name>count</name>
         <description>number of emergencies rejected by the geographic area.</description>
         <type>numerical</type>
         <uom>persons</uom>
         <scalar>unit</scalar>
         <decimals>0</decimals>
      </field>
   </message>
</metadata>