Initial commit
This commit is contained in:
commit
66a6860316
407 changed files with 1254365 additions and 0 deletions
73
examples/trafficlight_dynamic_structure/experiment.py
Normal file
73
examples/trafficlight_dynamic_structure/experiment.py
Normal file
|
|
@ -0,0 +1,73 @@
|
|||
# Copyright 2014 Modelling, Simulation and Design Lab (MSDL) at
|
||||
# McGill University and the University of Antwerp (http://msdl.cs.mcgill.ca/)
|
||||
#
|
||||
# Licensed under the Apache License, Version 2.0 (the "License");
|
||||
# you may not use this file except in compliance with the License.
|
||||
# You may obtain a copy of the License at
|
||||
#
|
||||
# http://www.apache.org/licenses/LICENSE-2.0
|
||||
#
|
||||
# Unless required by applicable law or agreed to in writing, software
|
||||
# distributed under the License is distributed on an "AS IS" BASIS,
|
||||
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
# See the License for the specific language governing permissions and
|
||||
# limitations under the License.
|
||||
|
||||
# Import code for model simulation:
|
||||
from pypdevs.simulator import Simulator
|
||||
|
||||
# Import the model to be simulated
|
||||
from model import TrafficSystem
|
||||
|
||||
# ======================================================================
|
||||
|
||||
# 1. Instantiate the (Coupled or Atomic) DEVS at the root of the
|
||||
# hierarchical model. This effectively instantiates the whole model
|
||||
# thanks to the recursion in the DEVS model constructors (__init__).
|
||||
#
|
||||
trafficSystem = TrafficSystem(name="trafficSystem")
|
||||
|
||||
# ======================================================================
|
||||
|
||||
# 2. Link the model to a DEVS Simulator:
|
||||
# i.e., create an instance of the 'Simulator' class,
|
||||
# using the model as a parameter.
|
||||
sim = Simulator(trafficSystem)
|
||||
|
||||
# ======================================================================
|
||||
|
||||
# 3. Perform all necessary configurations, the most commonly used are:
|
||||
|
||||
# A. Termination time (or termination condition)
|
||||
# Using a termination condition will execute a provided function at
|
||||
# every simulation step, making it possible to check for certain states
|
||||
# being reached.
|
||||
# It should return True to stop simulation, or Falso to continue.
|
||||
def terminate_whenStateIsReached(clock, model):
|
||||
return model.trafficLight.state.get() == "manual"
|
||||
sim.setTerminationCondition(terminate_whenStateIsReached)
|
||||
|
||||
# A termination time is prefered over a termination condition,
|
||||
# as it is much simpler to use.
|
||||
# e.g. to simulate until simulation time 400.0 is reached
|
||||
sim.setTerminationTime(500.0)
|
||||
|
||||
# B. Set the use of a tracer to show what happened during the simulation run
|
||||
# Both writing to stdout or file is possible:
|
||||
# pass None for stdout, or a filename for writing to that file
|
||||
sim.setVerbose(None)
|
||||
|
||||
# C. Set the use of Dynamic Structure DEVS, to make sure that the modelTransition
|
||||
# methods are invoked and changes are performed correctly.
|
||||
sim.setDSDEVS(True)
|
||||
|
||||
# ======================================================================
|
||||
|
||||
# 4. Simulate the model
|
||||
sim.simulate()
|
||||
|
||||
# ======================================================================
|
||||
|
||||
# 5. (optional) Extract data from the simulated model
|
||||
print("Simulation terminated with traffic light 1 in state %s" % (trafficSystem.trafficLight1.state.get()))
|
||||
print("Simulation terminated with traffic light 2 in state %s" % (trafficSystem.trafficLight2.state.get()))
|
||||
311
examples/trafficlight_dynamic_structure/model.py
Normal file
311
examples/trafficlight_dynamic_structure/model.py
Normal file
|
|
@ -0,0 +1,311 @@
|
|||
# Copyright 2014 Modelling, Simulation and Design Lab (MSDL) at
|
||||
# McGill University and the University of Antwerp (http://msdl.cs.mcgill.ca/)
|
||||
#
|
||||
# Licensed under the Apache License, Version 2.0 (the "License");
|
||||
# you may not use this file except in compliance with the License.
|
||||
# You may obtain a copy of the License at
|
||||
#
|
||||
# http://www.apache.org/licenses/LICENSE-2.0
|
||||
#
|
||||
# Unless required by applicable law or agreed to in writing, software
|
||||
# distributed under the License is distributed on an "AS IS" BASIS,
|
||||
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
# See the License for the specific language governing permissions and
|
||||
# limitations under the License.
|
||||
|
||||
import sys
|
||||
|
||||
# Import code for DEVS model representation:
|
||||
from pypdevs.DEVS import *
|
||||
from pypdevs.infinity import INFINITY
|
||||
|
||||
class TrafficLightMode:
|
||||
"""
|
||||
Encapsulates the system's state
|
||||
"""
|
||||
|
||||
def __init__(self, current="red"):
|
||||
"""
|
||||
Constructor (parameterizable).
|
||||
"""
|
||||
self.set(current)
|
||||
|
||||
def set(self, value="red"):
|
||||
self.__colour=value
|
||||
|
||||
def get(self):
|
||||
return self.__colour
|
||||
|
||||
def __str__(self):
|
||||
return self.get()
|
||||
|
||||
class TrafficLight(AtomicDEVS):
|
||||
"""
|
||||
A traffic light
|
||||
"""
|
||||
|
||||
def __init__(self, name=None):
|
||||
"""
|
||||
Constructor (parameterizable).
|
||||
"""
|
||||
# Always call parent class' constructor FIRST:
|
||||
AtomicDEVS.__init__(self, name)
|
||||
|
||||
# STATE:
|
||||
# Define 'state' attribute (initial sate):
|
||||
self.state = TrafficLightMode("red")
|
||||
|
||||
# ELAPSED TIME:
|
||||
# Initialize 'elapsed time' attribute if required
|
||||
# (by default, value is 0.0):
|
||||
self.elapsed = 1.5
|
||||
# with elapsed time initially 1.5 and initially in
|
||||
# state "red", which has a time advance of 60,
|
||||
# there are 60-1.5 = 58.5time-units remaining until the first
|
||||
# internal transition
|
||||
|
||||
# PORTS:
|
||||
# Declare as many input and output ports as desired
|
||||
# (usually store returned references in local variables):
|
||||
self.INTERRUPT = self.addInPort(name="INTERRUPT")
|
||||
self.OBSERVED = self.addOutPort(name="OBSERVED")
|
||||
|
||||
def extTransition(self, inputs):
|
||||
"""
|
||||
External Transition Function.
|
||||
"""
|
||||
# Compute the new state 'Snew' based (typically) on current
|
||||
# State, Elapsed time parameters and calls to 'self.peek(self.IN)'.
|
||||
input = inputs.get(self.INTERRUPT)[0]
|
||||
|
||||
state = self.state.get()
|
||||
|
||||
if input == "toManual":
|
||||
if state == "manual":
|
||||
# staying in manual mode
|
||||
return TrafficLightMode("manual")
|
||||
elif state in ("red", "green", "yellow"):
|
||||
return TrafficLightMode("manual")
|
||||
elif input == "toAutonomous":
|
||||
if state == "manual":
|
||||
return TrafficLightMode("red")
|
||||
elif state in ("red", "green", "yellow"):
|
||||
# If toAutonomous is given while still autonomous, just stay in this state
|
||||
return self.state
|
||||
raise DEVSException(\
|
||||
"unknown state <%s> in TrafficLight external transition function"\
|
||||
% state)
|
||||
|
||||
def intTransition(self):
|
||||
"""
|
||||
Internal Transition Function.
|
||||
"""
|
||||
|
||||
state = self.state.get()
|
||||
|
||||
if state == "red":
|
||||
return TrafficLightMode("green")
|
||||
elif state == "green":
|
||||
return TrafficLightMode("yellow")
|
||||
elif state == "yellow":
|
||||
return TrafficLightMode("red")
|
||||
else:
|
||||
raise DEVSException(\
|
||||
"unknown state <%s> in TrafficLight internal transition function"\
|
||||
% state)
|
||||
|
||||
def outputFnc(self):
|
||||
"""
|
||||
Output Funtion.
|
||||
"""
|
||||
|
||||
# A colourblind observer sees "grey" instead of "red" or "green".
|
||||
|
||||
# BEWARE: ouput is based on the OLD state
|
||||
# and is produced BEFORE making the transition.
|
||||
# We'll encode an "observation" of the state the
|
||||
# system will transition to !
|
||||
|
||||
# Send messages (events) to a subset of the atomic-DEVS'
|
||||
# output ports by means of the 'poke' method, i.e.:
|
||||
# The content of the messages is based (typically) on current State.
|
||||
|
||||
state = self.state.get()
|
||||
|
||||
if state == "red":
|
||||
return {self.OBSERVED: ["grey"]}
|
||||
elif state == "green":
|
||||
return {self.OBSERVED: ["yellow"]}
|
||||
elif state == "yellow":
|
||||
return {self.OBSERVED: ["grey"]}
|
||||
else:
|
||||
raise DEVSException(\
|
||||
"unknown state <%s> in TrafficLight external transition function"\
|
||||
% state)
|
||||
|
||||
def timeAdvance(self):
|
||||
"""
|
||||
Time-Advance Function.
|
||||
"""
|
||||
# Compute 'ta', the time to the next scheduled internal transition,
|
||||
# based (typically) on current State.
|
||||
state = self.state.get()
|
||||
if state == "red":
|
||||
return 60
|
||||
elif state == "green":
|
||||
return 50
|
||||
elif state == "yellow":
|
||||
return 10
|
||||
elif state == "manual":
|
||||
return INFINITY
|
||||
else:
|
||||
raise DEVSException(\
|
||||
"unknown state <%s> in TrafficLight time advance transition function"\
|
||||
% state)
|
||||
|
||||
class Policeman(AtomicDEVS):
|
||||
"""
|
||||
A policeman producing "toManual" and "toAutonomous" events:
|
||||
"toManual" when going from "idle" to "working" mode
|
||||
"toAutonomous" when going from "working" to "idle" mode
|
||||
"""
|
||||
def __init__(self, name=None):
|
||||
"""
|
||||
Constructor (parameterizable).
|
||||
"""
|
||||
|
||||
# Always call parent class' constructor FIRST:
|
||||
AtomicDEVS.__init__(self, name)
|
||||
|
||||
# STATE:
|
||||
# Define 'state' attribute (initial sate):
|
||||
self.state = "idle_at_1"
|
||||
|
||||
# ELAPSED TIME:
|
||||
# Initialize 'elapsed time' attribute if required
|
||||
# (by default, value is 0.0):
|
||||
self.elapsed = 0
|
||||
|
||||
# PORTS:
|
||||
# Declare as many input and output ports as desired
|
||||
# (usually store returned references in local variables):
|
||||
self.OUT = self.addOutPort(name="OUT")
|
||||
|
||||
def intTransition(self):
|
||||
"""
|
||||
Internal Transition Function.
|
||||
The policeman works forever, so only one mode.
|
||||
"""
|
||||
|
||||
state = self.state
|
||||
|
||||
if state == "idle_at_1":
|
||||
return "working_at_1"
|
||||
elif state == "working_at_1":
|
||||
return "moving_from_1_to_2"
|
||||
elif state == "moving_from_1_to_2":
|
||||
return "idle_at_2"
|
||||
elif state == "idle_at_2":
|
||||
return "working_at_2"
|
||||
elif state == "working_at_2":
|
||||
return "moving_from_2_to_1"
|
||||
elif state == "moving_from_2_to_1":
|
||||
return "idle_at_1"
|
||||
else:
|
||||
raise DEVSException(\
|
||||
"unknown state <%s> in Policeman internal transition function"\
|
||||
% state)
|
||||
|
||||
def outputFnc(self):
|
||||
"""
|
||||
Output Funtion.
|
||||
"""
|
||||
# Send messages (events) to a subset of the atomic-DEVS'
|
||||
# output ports by means of the 'poke' method, i.e.:
|
||||
# The content of the messages is based (typically) on current State.
|
||||
state = self.state
|
||||
if state == "idle_at_1":
|
||||
# Will start working
|
||||
return {self.OUT: ["toManual"]}
|
||||
elif state == "working_at_1":
|
||||
# Will have to put it in autonomous mode again
|
||||
return {self.OUT: ["toAutonomous"]}
|
||||
elif state == "moving_from_1_to_2":
|
||||
# Will simply stand idle while waiting
|
||||
return {}
|
||||
elif state == "idle_at_2":
|
||||
return {self.OUT: ["toManual"]}
|
||||
elif state == "working_at_2":
|
||||
return {self.OUT: ["toAutonomous"]}
|
||||
elif state == "moving_from_2_to_1":
|
||||
return {}
|
||||
else:
|
||||
raise DEVSException(\
|
||||
"unknown state <%s> in Policeman internal transition function"\
|
||||
% state)
|
||||
|
||||
|
||||
def timeAdvance(self):
|
||||
"""
|
||||
Time-Advance Function.
|
||||
"""
|
||||
# Compute 'ta', the time to the next scheduled internal transition,
|
||||
# based (typically) on current State.
|
||||
|
||||
state = self.state
|
||||
|
||||
if "idle" in state:
|
||||
return 50
|
||||
elif "working" in state:
|
||||
return 100
|
||||
elif "moving" in state:
|
||||
return 150
|
||||
else:
|
||||
raise DEVSException(\
|
||||
"unknown state <%s> in Policeman time advance function"\
|
||||
% state)
|
||||
|
||||
def modelTransition(self, state):
|
||||
if self.state == "moving_from_1_to_2":
|
||||
state["destination"] = "2"
|
||||
return True
|
||||
elif self.state == "moving_from_2_to_1":
|
||||
state["destination"] = "1"
|
||||
return True
|
||||
else:
|
||||
return False
|
||||
|
||||
class TrafficSystem(CoupledDEVS):
|
||||
def __init__(self, name=None):
|
||||
"""
|
||||
A simple traffic system consisting of a Policeman and a TrafficLight.
|
||||
"""
|
||||
# Always call parent class' constructor FIRST:
|
||||
CoupledDEVS.__init__(self, name)
|
||||
|
||||
# Declare the coupled model's output ports:
|
||||
# Autonomous, so no output ports
|
||||
|
||||
# Declare the coupled model's sub-models:
|
||||
|
||||
# The Policeman generating interrupts
|
||||
self.policeman = self.addSubModel(Policeman(name="policeman"))
|
||||
|
||||
# Two TrafficLights
|
||||
self.trafficLight1 = self.addSubModel(TrafficLight(name="trafficLight1"))
|
||||
self.trafficLight2 = self.addSubModel(TrafficLight(name="trafficLight2"))
|
||||
|
||||
# Only connect to the first traffic light
|
||||
self.connectPorts(self.policeman.OUT, self.trafficLight1.INTERRUPT)
|
||||
|
||||
def modelTransition(self, state):
|
||||
# Policeman triggered a mode, so switch the connection
|
||||
if state["destination"] == "1":
|
||||
self.disconnectPorts(self.policeman.OUT, self.trafficLight2.INTERRUPT)
|
||||
self.connectPorts(self.policeman.OUT, self.trafficLight1.INTERRUPT)
|
||||
elif state["destination"] == "2":
|
||||
self.disconnectPorts(self.policeman.OUT, self.trafficLight1.INTERRUPT)
|
||||
self.connectPorts(self.policeman.OUT, self.trafficLight2.INTERRUPT)
|
||||
|
||||
# Don't propagate
|
||||
return False
|
||||
Loading…
Add table
Add a link
Reference in a new issue