The Gaudi Framework  v29r0 (ff2e7097)
ForwardSchedulerSimpleTest.py
Go to the documentation of this file.
1 #!/usr/bin/env gaudirun.py
2 
3 '''
4 Reference optionfile which shows in a simple way how to take advantage of the
5 Gaudi components desicated to concurrency.
6 The components are:
7  o HiveWhiteBoard: a convenient way to collect several TES (one per "processing
8  slot"), accessible in a thread safe way, keeps a catalogue of the products
9  written on each processing slot. The number of slots in the whiteboard
10  determines also the number of events processed simultaneously by the scheduler.
11  o ForwardSchedulerSvc: state machine of the algorithms interfaced with the
12  TBB runtime. It is responsible for the submission of the algorithms. An
13  algorithm is marked ready for submission when its needed input is available.
14  It deals the asynchronous termination of algorithms with a "receiver" thread
15  and a thread safe queue.
16  o HiveSlimEventLoopMgr: an event factory. Pushes new events and pops finished
17  events to/from the scheduler. It does not manage algorithms/streams.
18  o AlgResourcePool: Service managing the creation of algorithms (through the
19  algorithm manager), including clones. It also manages the algorithms according
20  to the resources they need (parameter NeededResources - vector of strings - of
21  the Algorithm class).
22  o InertMessageSvc: as the TBBMsgSvc, it manages the printing of the messages in
23  a multithreaded environment.
24 
25 The CPUCruncher is not a component dealing with concurrency, but a useful
26 entity to test it. It's an algorithm that simply wastes cpu.
27 
28 '''
29 from Gaudi.Configuration import *
30 from Configurables import (HiveWhiteBoard, HiveSlimEventLoopMgr,
31  ForwardSchedulerSvc, AlgResourcePool,
32  CPUCruncher,
33  ContextEventCounterPtr,
34  ContextEventCounterData)
35 
36 # metaconfig -------------------------------------------------------------------
37 # It's confortable to collect the relevant parameters at the top of the optionfile
38 evtslots = 23
39 evtMax = 50
40 cardinality = 10
41 algosInFlight = 10
42 #-------------------------------------------------------------------------------
43 
44 # The configuration of the whiteboard ------------------------------------------
45 # It is useful to call it EventDataSvc to replace the usual data service with
46 # the whiteboard transparently.
47 
48 whiteboard = HiveWhiteBoard("EventDataSvc",
49  EventSlots=evtslots)
50 
51 #-------------------------------------------------------------------------------
52 
53 # Event Loop Manager -----------------------------------------------------------
54 # It's called slim since it has less functionalities overall than the good-old
55 # event loop manager. Here we just set its outputlevel to DEBUG.
56 
57 slimeventloopmgr = HiveSlimEventLoopMgr(OutputLevel=DEBUG)
58 
59 #-------------------------------------------------------------------------------
60 
61 # ForwardScheduler -------------------------------------------------------------
62 # We just decide how many algorithms in flight we want to have and how many
63 # threads in the pool. The default value is -1, which is for TBB equivalent
64 # to take over the whole machine.
65 
66 scheduler = ForwardSchedulerSvc(MaxAlgosInFlight=algosInFlight,
67  ThreadPoolSize=algosInFlight,
68  OutputLevel=WARNING)
69 
70 #-------------------------------------------------------------------------------
71 
72 # Algo Resource Pool -----------------------------------------------------------
73 # Nothing special here, we just set the debug level.
74 AlgResourcePool(OutputLevel=DEBUG)
75 
76 #-------------------------------------------------------------------------------
77 
78 # Set up of the crunchers, daily business --------------------------------------
79 
80 a1 = CPUCruncher("A1")
81 a1.outKeys = ['/Event/a1']
82 
83 a2 = CPUCruncher("A2")
84 a2.inpKeys = ['/Event/a1']
85 a2.outKeys = ['/Event/a2']
86 
87 a3 = CPUCruncher("A3")
88 a3.inpKeys = ['/Event/a1']
89 a3.outKeys = ['/Event/a3']
90 
91 a4 = CPUCruncher("A4")
92 a4.inpKeys = ['/Event/a2', '/Event/a3']
93 a4.outKeys = ['/Event/a4']
94 
95 for algo in [a1, a2, a3, a4]:
96  algo.shortCalib = True
97  algo.Cardinality = cardinality
98  algo.OutputLevel = DEBUG
99  algo.varRuntime = .3
100  algo.avgRuntime = .5
101 
102 ctrp = ContextEventCounterPtr("CNT*", Cardinality=0, OutputLevel=INFO)
103 ctrd = ContextEventCounterData("CNT&", Cardinality=0, OutputLevel=INFO)
104 
105 # Application Manager ----------------------------------------------------------
106 # We put everything together and change the type of message service
107 
108 # to show EventContext slot (%s), event (%e), and thread (%X) in
109 # MessageSvc output:
110 msgFmt = "% F%30W%S%4W%s%e%15W%X%7W%R%T %0W%M"
111 
112 msgSvc = InertMessageSvc("MessageSvc", OutputLevel=INFO)
113 msgSvc.Format = msgFmt
114 ApplicationMgr().SvcMapping.append(msgSvc)
115 
116 
117 ApplicationMgr(EvtMax=evtMax,
118  EvtSel='NONE',
119  ExtSvc=[whiteboard],
120  EventLoop=slimeventloopmgr,
121  TopAlg=[a1, a2, a3, a4, ctrp, ctrd],
122  MessageSvcType="InertMessageSvc")
123 
124 #-------------------------------------------------------------------------------
Thread safe extension to the standard MessageSvc.
A class that implements a search for prime numbers.
Definition: CPUCruncher.h:19
The SchedulerSvc implements the IScheduler interface.
The AlgResourcePool is a concrete implementation of the IAlgResourcePool interface.
Data service base class.
The Application Manager class.