SCCD_execute.alc 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666
  1. include "primitives.alh"
  2. include "modelling.alh"
  3. include "object_operations.alh"
  4. include "utils.alh"
  5. include "random.alh"
  6. include "library.alh"
  7. Void function print_states(model : Element, data : Element):
  8. Element classes
  9. Element states
  10. Element class
  11. String state
  12. log("Current states:")
  13. classes = set_copy(data["classes"])
  14. while (read_nr_out(classes) > 0):
  15. class = set_pop(classes)
  16. log(string_join(string_join(string_join(" ", class["ID"]), " : "), read_attribute(model, class["type"], "name")))
  17. log(" Attributes: " + dict_to_string(class["attributes"]))
  18. states = set_copy(class["states"])
  19. log(" States:")
  20. while (read_nr_out(states) > 0):
  21. state = set_pop(states)
  22. log(string_join(" ", read_attribute(model, state, "name")))
  23. return!
  24. Element function filter(model : Element, set : Element, attribute_name : String, attribute_value : Element):
  25. Element keys
  26. String key
  27. Element result
  28. result = create_node()
  29. while (read_nr_out(set) > 0):
  30. key = set_pop(set)
  31. if (value_eq(read_attribute(model, key, attribute_name), attribute_value)):
  32. set_add(result, key)
  33. return result!
  34. Element function filter_exists(model : Element, set : Element, attribute_name : String):
  35. Element keys
  36. String key
  37. Element result
  38. result = create_node()
  39. while (read_nr_out(set) > 0):
  40. key = set_pop(set)
  41. if (element_neq(read_attribute(model, key, attribute_name), read_root())):
  42. set_add(result, key)
  43. return result!
  44. Element function expand_current_state(model : Element, state : String, class_data : Element):
  45. // Find the hierarchy of all current states, and select those that contain the currently selected state
  46. Element result
  47. Element current_states
  48. result = create_node()
  49. current_states = set_copy(class_data["states"])
  50. Element hierarchy
  51. String deep_state
  52. while (read_nr_out(current_states) > 0):
  53. deep_state = set_pop(current_states)
  54. hierarchy = find_hierarchy(model, deep_state)
  55. // Got the hierarchy of one of the states
  56. if (set_in(hierarchy, state)):
  57. // This hierarchy contains the root state we are checking for, so add to set
  58. set_add(result, deep_state)
  59. return result!
  60. Element function expand_initial_state(model : Element, state : String, class_data : Element):
  61. String t
  62. t = read_type(model, state)
  63. if (t == "SCCD/CompositeState"):
  64. // Recurse further in the composite
  65. return expand_composite_state(model, state, class_data)!
  66. elif (t == "SCCD/ParallelState"):
  67. // Split up all components
  68. return expand_parallel_state(model, state, class_data)!
  69. elif (t == "SCCD/HistoryState"):
  70. // Reset the history
  71. // This is not really an initial state, but it is called in exactly the same places
  72. return class_data["history"][state]!
  73. else:
  74. // Probably just an atomic, so return this one only
  75. Element result
  76. result = create_node()
  77. set_add(result, state)
  78. return result!
  79. Element function expand_composite_state(model : Element, composite_state : String, class_data : Element):
  80. // Resolve all initial states from a single composite state
  81. String initial
  82. // Fetch the initial state
  83. initial = set_pop(filter(model, allAssociationDestinations(model, composite_state, "SCCD/composite_children"), "isInitial", True))
  84. // Expand the initial state, depending on what it is
  85. return expand_initial_state(model, initial, class_data)!
  86. Element function expand_parallel_state(model : Element, parallel_state : String, class_data : Element):
  87. // Resolve all initial states from a single parallel state
  88. Element children
  89. Element result
  90. Element expanded_children
  91. children = allAssociationDestinations(model, parallel_state, "SCCD/parallel_children")
  92. result = create_node()
  93. while (read_nr_out(children) > 0):
  94. set_merge(result, expand_initial_state(model, set_pop(children), class_data))
  95. return result!
  96. Void function delete_class(model : Element, data : Element, identifier : String):
  97. // Stop a specific class instance, with attached statechart, from executing
  98. dict_delete(data["classes"], identifier)
  99. Void function start_class(model : Element, data : Element, class : String, identifier : String, parameters : Element):
  100. // Start up the class and assign its initial state to it
  101. // Create the data structure for a running class
  102. Element class_handle
  103. class_handle = create_node()
  104. dict_add(class_handle, "type", class)
  105. dict_add(class_handle, "ID", identifier)
  106. dict_add(class_handle, "timers", create_node())
  107. // Add the current state of the class
  108. String initial_state
  109. // Should only be one behaviour linked to it!
  110. initial_state = set_pop(allAssociationDestinations(model, class, "SCCD/behaviour"))
  111. dict_add(class_handle, "states", expand_initial_state(model, initial_state, class_handle))
  112. // Initialize history for all composite states
  113. Element history
  114. Element cstates
  115. String cstate
  116. history = create_node()
  117. dict_add(class_handle, "history", history)
  118. cstates = allInstances(model, "SCCD/CompositeState")
  119. while (read_nr_out(cstates) > 0):
  120. cstate = set_pop(cstates)
  121. dict_add(history, cstate, expand_initial_state(model, cstate, class_handle))
  122. // Add all attributes
  123. Element attributes
  124. attributes = create_node()
  125. Element attrs
  126. attrs = allAssociationDestinations(model, class, "SCCD/class_attributes")
  127. while (read_nr_out(attrs) > 0):
  128. dict_add(attributes, read_attribute(model, set_pop(attrs), "name"), read_root())
  129. dict_add(class_handle, "attributes", attributes)
  130. // Invoke constructor
  131. Element constructor
  132. constructor = read_attribute(model, class, "constructor_body")
  133. if (element_neq(constructor, read_root())):
  134. // Constructor, so execute
  135. constructor = get_func_AL_model(import_node(constructor))
  136. constructor(attributes, parameters)
  137. // Execute all entry actions
  138. Element init
  139. init = create_node()
  140. set_add(init, "")
  141. // Initial state before initialization is the set with an empty hierarchy
  142. // Empty set would not find any difference between the source and target
  143. execute_actions(model, init, set_copy(class_handle["states"]), attributes)
  144. dict_add(data["classes"], class_handle["ID"], class_handle)
  145. return!
  146. Element function get_enabled_transitions(model : Element, state : String, data : Element, class : String):
  147. // Returns all enabled transitions
  148. Element result
  149. Element to_filter
  150. String attr
  151. String transition
  152. Element cond
  153. String evt_name
  154. Element evt
  155. Element events
  156. Element event_names
  157. Element event_parameters
  158. result = create_node()
  159. to_filter = allOutgoingAssociationInstances(model, state, "SCCD/transition")
  160. event_names = create_node()
  161. event_parameters = create_node()
  162. events = set_copy(data["events"])
  163. while (read_nr_out(events) > 0):
  164. evt = set_pop(events)
  165. evt_name = list_read(evt, 0)
  166. if (bool_not(set_in(event_names, evt_name))):
  167. // Not yet registered the event
  168. set_add(event_names, evt_name)
  169. dict_add(event_parameters, evt_name, create_node())
  170. // Add event parameters
  171. set_add(event_parameters[evt_name], list_read(evt, 1))
  172. while (read_nr_out(to_filter) > 0):
  173. transition = set_pop(to_filter)
  174. // Check event
  175. attr = read_attribute(model, transition, "event")
  176. if (bool_not(bool_or(element_eq(attr, read_root()), set_in(event_names, attr)))):
  177. // At least one enabled event is found
  178. continue!
  179. // Check after
  180. // Only an after if there was no event!
  181. if (bool_and(element_eq(attr, read_root()), read_attribute(model, transition, "after"))):
  182. if (dict_in(data["classes"][class]["timers"], transition)):
  183. // Registered timer already, let's check if it has expired
  184. if (float_gt(data["classes"][class]["timers"][transition], time())):
  185. // Not enabled yet
  186. continue!
  187. else:
  188. // Not registered even, so not enabled either
  189. continue!
  190. // Check condition, but depends on whether there was an event or not
  191. cond = read_attribute(model, transition, "cond")
  192. if (element_neq(cond, read_root())):
  193. // Got a condition, so resolve
  194. cond = get_func_AL_model(import_node(cond))
  195. if (element_neq(attr, read_root())):
  196. // We have an event to take into account!
  197. Element params
  198. Element param
  199. params = set_copy(event_parameters[attr])
  200. while (read_nr_out(params) > 0):
  201. param = set_pop(params)
  202. if (element_neq(cond, read_root())):
  203. // Got a condition to check first
  204. if (bool_not(cond(data["classes"][class]["attributes"], param))):
  205. // Condition failed, so skip
  206. continue!
  207. // Fine to add this one with the specified parameters
  208. set_add(result, create_tuple(transition, param))
  209. else:
  210. // No event to think about, just add the transition
  211. if (element_neq(cond, read_root())):
  212. // Check the condition first
  213. if (bool_not(cond(data["classes"][class]["attributes"], read_root()))):
  214. // Condition false, so skip
  215. continue!
  216. // Fine to add this one without event parameters (no event)
  217. set_add(result, create_tuple(transition, read_root()))
  218. return result!
  219. Void function execute_actions(model : Element, source_states : Element, target_states : Element, class_data : Element):
  220. Element actions
  221. actions = get_actions_to_execute(model, source_states, target_states, class_data)
  222. while (read_nr_out(actions) > 0):
  223. Element action
  224. action = list_pop(actions, 0)
  225. action(class_data["attributes"])
  226. return!
  227. Element function execute_transition(model : Element, data : Element, class : String, transition_tuple : Element):
  228. // Execute the script (if any)
  229. Element script
  230. String transition
  231. Element event_parameter
  232. transition = list_read(transition_tuple, 0)
  233. event_parameter = list_read(transition_tuple, 1)
  234. script = read_attribute(model, transition, "script")
  235. if (element_neq(script, read_root())):
  236. script = get_func_AL_model(import_node(script))
  237. script(data["classes"][class]["attributes"], event_parameter)
  238. // Raise events (if any)
  239. Element events
  240. String event
  241. events = allAssociationDestinations(model, transition, "SCCD/transition_raises")
  242. while (read_nr_out(events) > 0):
  243. event = set_pop(events)
  244. Element parameter_action
  245. parameter_action = read_attribute(model, event, "parameter")
  246. if (element_neq(parameter_action, read_root())):
  247. // Got a parameter to evaluate
  248. parameter_action = get_func_AL_model(import_node(parameter_action))
  249. parameter_action = parameter_action(data["classes"][class]["attributes"], event_parameter)
  250. String scope
  251. scope = read_attribute(model, event, "scope")
  252. if (scope == "cd"):
  253. // Is an event for us internally, so don't append
  254. // Instead, we process it directly
  255. String operation
  256. operation = read_attribute(model, event, "event")
  257. if (operation == "create_instance"):
  258. // Start up a new class of the desired type
  259. // Parameters of this call:
  260. // class -- type of the class to instantiate
  261. // identifier -- name of this instance, for future reference
  262. // parameters -- parameters for constructor
  263. String class
  264. String identifier
  265. Element parameters
  266. class = set_pop(filter(model, allInstances(model, "SCCD/Class"), "name", list_read(parameter_action, 0)))
  267. identifier = list_read(parameter_action, 1)
  268. parameters = list_read(parameter_action, 2)
  269. start_class(model, data, class, identifier, parameters)
  270. elif (operation == "delete_instance"):
  271. // Delete the requested class
  272. String identifier
  273. identifier = list_read(parameter_action, 0)
  274. delete_class(model, data, identifier)
  275. else:
  276. set_add(data["events"], create_tuple(read_attribute(model, event, "event"), parameter_action))
  277. // Find new set of states
  278. Element target_states
  279. Element source_states
  280. source_states = expand_current_state(model, readAssociationSource(model, transition), data["classes"][class])
  281. target_states = expand_initial_state(model, readAssociationDestination(model, transition), data["classes"][class])
  282. execute_actions(model, source_states, target_states, data["classes"][class])
  283. return target_states!
  284. Boolean function step_class(model : Element, data : Element, class : String):
  285. // Find enabled transitions in a class and execute it, updating the state
  286. // Iterate over all current states, searching for enabled transitions
  287. // Search for enabled transitions in higher levels as well!
  288. Element states
  289. Element new_states
  290. String state
  291. Element transitions
  292. String transition
  293. Boolean transitioned
  294. Element hierarchy
  295. String current_state
  296. Boolean found
  297. states = set_copy(data["classes"][class]["states"])
  298. new_states = create_node()
  299. transitioned = False
  300. while (read_nr_out(states) > 0):
  301. state = set_pop(states)
  302. found = False
  303. // Loop over the hierarchy of this state and try to apply transitions
  304. hierarchy = find_hierarchy(model, state)
  305. while (read_nr_out(hierarchy) > 0):
  306. current_state = list_pop(hierarchy, 0)
  307. transitions = get_enabled_transitions(model, current_state, data, class)
  308. if (read_nr_out(transitions) > 0):
  309. // Found an enabled transition, so store that one
  310. transition = random_choice(transitions)
  311. // Execute transition
  312. set_merge(new_states, execute_transition(model, data, class, transition))
  313. // When leaving an orthogonal component, we must also pop all related states that might be processed in the future!
  314. Element leaving
  315. leaving = expand_current_state(model, current_state, data["classes"][class])
  316. set_difference(states, leaving)
  317. transitioned = True
  318. found = True
  319. break!
  320. if (bool_not(found)):
  321. // Nothing found, so stay in the current state
  322. set_add(new_states, state)
  323. // Update states
  324. dict_overwrite(data["classes"][class], "states", new_states)
  325. reschedule_timeouts(model, data, class)
  326. return transitioned!
  327. Void function reschedule_timeouts(model : Element, data : Element, class : String):
  328. Element timed_transitions
  329. Element old_timed_transitions
  330. String transition
  331. Element states
  332. String state
  333. timed_transitions = create_node()
  334. states = set_copy(data["classes"][class]["states"])
  335. // Collect all timed transitions that are currently active
  336. while (read_nr_out(states) > 0):
  337. state = set_pop(states)
  338. // NOTE this set_merge does not eliminate duplicates, though this should happen later on when adding the timer (see other NOTE)
  339. set_merge(timed_transitions, filter_exists(model, allOutgoingAssociationInstances(model, state, "SCCD/transition"), "after"))
  340. // Remove timers that no longer exist
  341. old_timed_transitions = dict_keys(data["classes"][class]["timers"])
  342. while (read_nr_out(old_timed_transitions) > 0):
  343. transition = set_pop(old_timed_transitions)
  344. if (bool_not(set_in(timed_transitions, transition))):
  345. // Transition is no longer scheduled for any state, so remove
  346. dict_delete(data["classes"][class]["timers"], transition)
  347. // Schedule timers that are not already scheduled
  348. while (read_nr_out(timed_transitions) > 0):
  349. transition = set_pop(timed_transitions)
  350. // NOTE Normally, a timer will not be added twice here, as the previous occurence will already find it
  351. if (bool_not(dict_in(data["classes"][class]["timers"], transition))):
  352. // Not yet scheduled this transition: do so now
  353. Element after
  354. Float after_duration
  355. after = read_attribute(model, transition, "after")
  356. after = get_func_AL_model(import_node(after))
  357. after_duration = after(data["classes"][class]["attributes"])
  358. dict_add(data["classes"][class]["timers"], transition, float_addition(data["start_time"], after_duration))
  359. return !
  360. String function get_parent(model : Element, state : String):
  361. Element tmp_set
  362. tmp_set = allAssociationOrigins(model, state, "SCCD/composite_children")
  363. set_merge(tmp_set, allAssociationOrigins(model, state, "SCCD/parallel_children"))
  364. if (read_nr_out(tmp_set) > 0):
  365. return set_pop(tmp_set)!
  366. else:
  367. return ""!
  368. Element function find_hierarchy(model : Element, state : String):
  369. if (state == ""):
  370. return create_node()!
  371. else:
  372. Element result
  373. String parent
  374. parent = get_parent(model, state)
  375. // We have a parent, so take the parent list first
  376. result = find_hierarchy(model, parent)
  377. list_append(result, state)
  378. return result!
  379. Element function get_actions_to_execute(model : Element, source_states : Element, target_states : Element, class_data : Element):
  380. Element result
  381. result = create_node()
  382. source_states = set_copy(source_states)
  383. target_states = set_copy(target_states)
  384. // Add all exit and entry actions to the list of actions to execute
  385. // Do this by finding the common parent, and then doing all exit actions up to that node, and all entry actions up to the target_state
  386. // First, find the hierarchy!
  387. Element hierarchy_sources
  388. Element hierarchy_targets
  389. Element all_hierarchies
  390. hierarchy_sources = create_node()
  391. while (read_nr_out(source_states) > 0):
  392. set_add(hierarchy_sources, find_hierarchy(model, set_pop(source_states)))
  393. hierarchy_targets = create_node()
  394. while (read_nr_out(target_states) > 0):
  395. set_add(hierarchy_targets, find_hierarchy(model, set_pop(target_states)))
  396. all_hierarchies = set_copy(hierarchy_sources)
  397. set_merge(all_hierarchies, hierarchy_targets)
  398. // Difference these all lists, finding the first common entry
  399. Element iter_hierarchies
  400. Integer i
  401. String current
  402. Element hierarchy
  403. Boolean finished
  404. i = 0
  405. finished = False
  406. while (bool_not(finished)):
  407. // Check the i-th element in both and see if they are equal
  408. current = ""
  409. iter_hierarchies = set_copy(all_hierarchies)
  410. while (read_nr_out(iter_hierarchies) > 0):
  411. hierarchy = set_pop(iter_hierarchies)
  412. // Exhausted one of the lists
  413. if (i >= list_len(hierarchy)):
  414. finished = True
  415. break!
  416. // First entry, so read out value as reference
  417. if (current == ""):
  418. current = list_read(hierarchy, i)
  419. // Check with reference element
  420. if (bool_not(value_eq(list_read(hierarchy, i), current))):
  421. finished = True
  422. break!
  423. // i-th element equal for all hierarchies, so go to next element
  424. if (bool_not(finished)):
  425. i = i + 1
  426. // Found the first differing element at position i
  427. // All elements remaining in hierarchy_source are to be traversed in REVERSE order for the exit actions
  428. // All elements remaining in hierarchy_target are to be traversed in NORMAL order for the entry actions
  429. // This is not that simple either, as we need to consider that some actions might already have been added to the list...
  430. // Add hierarchy_sources actions
  431. String state
  432. Element visited
  433. Element action
  434. Element spliced_hierarchy
  435. Element hierarchy_source
  436. Element hierarchy_target
  437. visited = create_node()
  438. while (read_nr_out(hierarchy_sources) > 0):
  439. // Get one of these hierarchies
  440. hierarchy_source = set_pop(hierarchy_sources)
  441. spliced_hierarchy = list_splice(hierarchy_source, i, list_len(hierarchy_source))
  442. while (list_len(spliced_hierarchy) > 0):
  443. state = list_pop(spliced_hierarchy, list_len(spliced_hierarchy) - 1)
  444. if (set_in(visited, state)):
  445. // Already added this state, so don't bother
  446. continue!
  447. else:
  448. // New state, so prepend it to the list
  449. // Prepend, instead of append, as we want to do these operations in reverse order!
  450. // First check if there is any exit action at all
  451. action = read_attribute(model, state, "onExitScript")
  452. if (element_neq(action, read_root())):
  453. // An exit action is found!
  454. list_insert(result, get_func_AL_model(import_node(action)), 0)
  455. // Add this state as visited, even though there might not have been an associated action
  456. set_add(visited, state)
  457. // Also update the history of this state, which will be important if we have a history state later on
  458. if (read_type(model, state) == "SCCD/CompositeState"):
  459. dict_overwrite(class_data["history"], state, expand_current_state(model, state, class_data))
  460. // Add hierarchy_targets actions
  461. // Clear visited, just to be safe, though it should not matter
  462. visited = create_node()
  463. while (read_nr_out(hierarchy_targets) > 0):
  464. // Get one of these hierarchies
  465. hierarchy_target = set_pop(hierarchy_targets)
  466. spliced_hierarchy = list_splice(hierarchy_target, i, list_len(hierarchy_target))
  467. while (list_len(spliced_hierarchy) > 0):
  468. state = list_pop(spliced_hierarchy, list_len(spliced_hierarchy) - 1)
  469. if (set_in(visited, state)):
  470. // Already added this state, so don't bother
  471. continue!
  472. else:
  473. // New state, so append it to the list
  474. // Append, instead of prepend, as we want to do these operations in normal order!
  475. // First check if there is any entry action at all
  476. action = read_attribute(model, state, "onEntryScript")
  477. if (element_neq(action, read_root())):
  478. // An entry action is found!
  479. list_append(result, get_func_AL_model(import_node(action)))
  480. // Add this state as visited, even though there might not have been an associated action
  481. set_add(visited, state)
  482. return result!
  483. Float function step(model : Element, data : Element):
  484. // Step through all classes
  485. Element classes
  486. Element class
  487. Float t_min
  488. Float t_current
  489. Boolean transitioned
  490. Element keys
  491. String key
  492. t_min = time() + 99999.0
  493. classes = dict_keys(data["classes"])
  494. // TODO this should use simulated time or something
  495. dict_overwrite(data, "start_time", time())
  496. transitioned = False
  497. while (read_nr_out(classes) > 0):
  498. class = set_pop(classes)
  499. if (step_class(model, data, class)):
  500. transitioned = True
  501. if (bool_not(transitioned)):
  502. // Find minimum timer for this class, and store that
  503. keys = dict_keys(data["classes"][class]["timers"])
  504. while (read_nr_out(keys) > 0):
  505. key = set_pop(keys)
  506. t_current = data["classes"][class]["timers"][key]
  507. if (t_current < t_min):
  508. t_min = t_current
  509. if (transitioned):
  510. // Do another step, as we can transition
  511. return 0.0!
  512. else:
  513. return float_subtraction(t_min, data["start_time"])!
  514. Boolean function main(model : Element):
  515. // Executes the provided SCCD model
  516. Element data
  517. data = create_node()
  518. dict_add(data, "classes", create_node())
  519. // Prepare for input
  520. output("Ready for input!")
  521. // Find initial
  522. String default_class
  523. default_class = set_pop(filter(model, allInstances(model, "SCCD/Class"), "default", True))
  524. // Start up the default class
  525. start_class(model, data, default_class, "main", read_root())
  526. Float timeout
  527. Element interrupt
  528. timeout = 0.0
  529. while (True):
  530. print_states(model, data)
  531. interrupt = input_timeout(timeout)
  532. if (value_eq(interrupt, "#EXIT#")):
  533. // Stop execution
  534. return True!
  535. dict_overwrite(data, "events", create_node())
  536. if (element_neq(interrupt, read_root())):
  537. // Got interrupt
  538. log("Got event: " + cast_v2s(interrupt))
  539. set_add(data["events"], create_tuple(interrupt, read_root()))
  540. output("Processed event, ready for more!")
  541. timeout = step(model, data)
  542. if (read_nr_out(data["classes"]) == 0):
  543. // No more active classes left: terminate!
  544. log("Finished SCCD execution")
  545. break!
  546. log("Pausing for " + cast_v2s(timeout))
  547. // We should never get here!
  548. return False!