Browse Source

doc update with TaskEnd and TaskEnd commands

Antoine Bertout 9 years ago
parent
commit
4ef6e7aa69
1 changed files with 25 additions and 7 deletions
  1. 25
    7
      rtsched-doc.tex

+ 25
- 7
rtsched-doc.tex View File

18
 package, which can be used to easily draw chronograms (GANTT charts).
18
 package, which can be used to easily draw chronograms (GANTT charts).
19
 These diagrams are quite common in real-time scheduling research.
19
 These diagrams are quite common in real-time scheduling research.
20
 
20
 
21
-The package depends on keyval and TikZ/PGF, both widely
21
+The package depends on keyval and TikZ/PGF (pgf version 2.10 or greater), both widely
22
 available on any \TeX distribution.
22
 available on any \TeX distribution.
23
 
23
 
24
 The drawing capabilities are completely based on TikZ. Thus, you can compile
24
 The drawing capabilities are completely based on TikZ. Thus, you can compile
88
  \verb+\TaskDeadline{i}{t}+ & \verb+\TaskNDeadline{i}{t}{p}{n}+ \\
88
  \verb+\TaskDeadline{i}{t}+ & \verb+\TaskNDeadline{i}{t}{p}{n}+ \\
89
  \verb+\TaskArrDeadl{i}{t}{reld}+ & \verb+\TaskNArrDeadl{i}{t}{reld}{p}{n}+  \\
89
  \verb+\TaskArrDeadl{i}{t}{reld}+ & \verb+\TaskNArrDeadl{i}{t}{reld}{p}{n}+  \\
90
  \verb+\TaskExecDelta{i}{t}{delta}+ & \verb+\TaskNExecDelta{i}{t}{delta}{p}{n}+\\
90
  \verb+\TaskExecDelta{i}{t}{delta}+ & \verb+\TaskNExecDelta{i}{t}{delta}{p}{n}+\\
91
+ \verb+\TaskEnd{i}{t}+ & \verb+\TaskNEnd{i}{t}{p}{n}+\\
92
+
91
   \hline
93
   \hline
92
 \end{tabular}
94
 \end{tabular}
93
 \caption{Table of periodic commands where p stands for the period and n for the number of instances}
95
 \caption{Table of periodic commands where p stands for the period and n for the number of instances}
185
     \TaskNArrDead{1}{0}{4}{4}{5}    % draws the arrivals and deadlines
187
     \TaskNArrDead{1}{0}{4}{4}{5}    % draws the arrivals and deadlines
186
     \TaskNExecDelta{1}{0}{1}{4}{5}  % draws executions (highest priority) 
188
     \TaskNExecDelta{1}{0}{1}{4}{5}  % draws executions (highest priority) 
187
                                     % for 5 instances of period 4 
189
                                     % for 5 instances of period 4 
190
+                                    
191
+    \TaskNEnd{1}{1}{4}{5}	       % draws 5 end of job execution of period 4
192
+
188
 
193
 
189
                                     % draws the arrival and deadline
194
                                     % draws the arrival and deadline
190
     \TaskNArrDead{2}{0}{6}{6}{3}    % for 3 instances of period 6 
195
     \TaskNArrDead{2}{0}{6}{6}{3}    % for 3 instances of period 6 
193
     \TaskExecution{2}{1}{4}
198
     \TaskExecution{2}{1}{4}
194
     \TaskExecution{2}{6}{8}
199
     \TaskExecution{2}{6}{8}
195
     \TaskExecution{2}{9}{10}
200
     \TaskExecution{2}{9}{10}
196
-    \TaskExecution{2}{13}{16}    
201
+    \TaskExecution{2}{13}{16} 
202
+    \TaskEnd{2}{4}
203
+    \TaskEnd{2}{10}
204
+    \TaskEnd{2}{16}   
197
   \end{RTGrid}
205
   \end{RTGrid}
198
 
206
 
199
 \begin{verbatim}
207
 \begin{verbatim}
202
     \TaskNArrDead{1}{0}{4}{4}{5}    % draws the arrivals and deadlines
210
     \TaskNArrDead{1}{0}{4}{4}{5}    % draws the arrivals and deadlines
203
     \TaskNExecDelta{1}{0}{1}{4}{5}  % draws executions (highest priority) 
211
     \TaskNExecDelta{1}{0}{1}{4}{5}  % draws executions (highest priority) 
204
                                     % for 5 instances of period 4 
212
                                     % for 5 instances of period 4 
213
+                                    
214
+    \TaskNEnd{1}{1}{4}{5}           % draws 5 end of job execution of period 4
205
 
215
 
206
    	\TaskNArrDead{2}{0}{6}{6}{3}    % draws the arrival and deadline
216
    	\TaskNArrDead{2}{0}{6}{6}{3}    % draws the arrival and deadline
207
                                     % for 3 instances of period 6 
217
                                     % for 3 instances of period 6 
218
+	    
208
     
219
     
209
     % no simple formula for lowest priority, sorry!
220
     % no simple formula for lowest priority, sorry!
210
     \TaskExecution{2}{1}{4}
221
     \TaskExecution{2}{1}{4}
211
     \TaskExecution{2}{6}{8}
222
     \TaskExecution{2}{6}{8}
212
     \TaskExecution{2}{9}{10}
223
     \TaskExecution{2}{9}{10}
213
-    \TaskExecution{2}{13}{16}    
224
+    \TaskExecution{2}{13}{16} 
225
+    \TaskEnd{2}{4}
226
+    \TaskEnd{2}{10}
227
+    \TaskEnd{2}{16}  
214
   \end{RTGrid}
228
   \end{RTGrid}
215
 \end{verbatim}
229
 \end{verbatim}
216
   \caption{Using periodic commands to avoid repetitions}
230
   \caption{Using periodic commands to avoid repetitions}
288
 style. An example is in Figure~\ref{fig:resp-time} that uses command
302
 style. An example is in Figure~\ref{fig:resp-time} that uses command
289
 \texttt{TaskRespTime}. 
303
 \texttt{TaskRespTime}. 
290
 
304
 
291
-\begin{figure}
305
+\begin{figure}[!htbp]
292
   \centering
306
   \centering
293
   \begin{RTGrid}{2}{20}
307
   \begin{RTGrid}{2}{20}
294
   
308
   
332
   \label{fig:resp-time}
346
   \label{fig:resp-time}
333
 \end{figure}
347
 \end{figure}
334
 
348
 
349
+It is sometimes usefull to represent the end of a job execution, especially when jobs are preempted. In that case, you can use the \verb+\TaskEnd{i}{t}+ command and its periodic version detailed in Table~\ref{tab:periodic_versions} that draw little circle(s) at the specified date(s). It works in the same way as \verb+\TaskArrival+ command and it is used in Figure~\ref{fig:ex1a}.
350
+
351
+
352
+
335
 
353
 
336
 \subsection{Controlling visualization}
354
 \subsection{Controlling visualization}
337
 
355
 
535
 
553
 
536
 Notice that the order with which the objects are drawn is exactly the
554
 Notice that the order with which the objects are drawn is exactly the
537
 same as the order in which they are specified in the code, excepted 
555
 same as the order in which they are specified in the code, excepted 
538
-for horizontal axes, arrivals and deadlines that are always drawn on the foreground.
539
- For example, in Figure \ref{fig:ex3a}, the executions of all the tasks are
556
+for horizontal axes, arrivals, deadlines and end of job execution that are always drawn on the foreground. 
557
+For example, in Figure \ref{fig:ex3a}, the executions of all the tasks are
540
 drawn on top of the box. You can try to move the \texttt{RTBox}
558
 drawn on top of the box. You can try to move the \texttt{RTBox}
541
 command at the end to see what happens.
559
 command at the end to see what happens.
542
 
560
 
568
 \TaskExecution[color=white,execlabel=S]{3}{4}{5}
586
 \TaskExecution[color=white,execlabel=S]{3}{4}{5}
569
 \end{verbatim}
587
 \end{verbatim}
570
 
588
 
571
-\begin{figure}
589
+\begin{figure}[!htbp]
572
   \centering
590
   \centering
573
   \begin{RTGrid}[width=12cm]{3}{25}
591
   \begin{RTGrid}[width=12cm]{3}{25}
574
     \TaskArrDead{3}{0}{20}
592
     \TaskArrDead{3}{0}{20}

Loading…
Cancel
Save