From 4d0e136120a07847562af7693d553ef70eb2dd60 Mon Sep 17 00:00:00 2001 From: maciej orkisz Date: Thu, 19 Mar 2009 18:05:30 +0000 Subject: [PATCH] reorganisation Writing script files + nouvelle illustration --- kernel/doc/bbtkUsersGuide/bbi-simplegraph.png | Bin 634078 -> 12907 bytes .../bbtkUsersGuide/bbi-verysimplegraph.png | Bin 0 -> 7384 bytes kernel/doc/bbtkUsersGuide/bbtkUsersGuide.tex | 270 ++++++++++-------- 3 files changed, 156 insertions(+), 114 deletions(-) create mode 100644 kernel/doc/bbtkUsersGuide/bbi-verysimplegraph.png diff --git a/kernel/doc/bbtkUsersGuide/bbi-simplegraph.png b/kernel/doc/bbtkUsersGuide/bbi-simplegraph.png index 7ef8827f4fc563736e93eb0ec5ce8068623a3b79..c10ee89f615895eeadb231e68317ca2223687d9b 100644 GIT binary patch literal 12907 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 diff --git a/kernel/doc/bbtkUsersGuide/bbi-verysimplegraph.png b/kernel/doc/bbtkUsersGuide/bbi-verysimplegraph.png new file mode 100644 index 0000000000000000000000000000000000000000..2f7305841b4fa10d24dbb262e5e75087243b8549 GIT binary patch literal 7384 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 JM#e1kzX4fhKgj?9 literal 0 HcmV?d00001 diff --git a/kernel/doc/bbtkUsersGuide/bbtkUsersGuide.tex b/kernel/doc/bbtkUsersGuide/bbtkUsersGuide.tex index 6fcda63..60573d1 100644 --- a/kernel/doc/bbtkUsersGuide/bbtkUsersGuide.tex +++ b/kernel/doc/bbtkUsersGuide/bbtkUsersGuide.tex @@ -153,7 +153,7 @@ black boxes (e.g.: dynamic library name of the package `std' is `bbstd.dll', `li % ========================================== % ========================================== -\subsubsection{\bbtk components} +\subsubsection{{\bbtk} components} % ========================================== \BBTK includes: \begin{itemize} @@ -436,7 +436,7 @@ All the guides can be browsed in html version in the \texttt{Help} part of \bbSt Remark that the list of categories is 'auto-extensible': each time a new box is created which belongs to a new category and the boxes list is regenerated, the new category appears in the list, holding the new box. The above list only contains the categories used in the packages provided with current \bbtk release. \item {\bf\emph{ List of adaptors}}: The adaptors are a special type of black boxes that are used internally to perform type conversions. Although they are not end user intended, you may see their list. Adaptors belong to the \texttt{adaptor} category. \end {itemize} - For each box, the html \texttt{Help} provides the informations necessary to use it: its name, its purpose, the descriptions of its inputs/outputs and the name of the package (or script file) that is to be loaded. Additionally, for all boxes but the atomic ones (i.e. for all boxes defined in \bbs script language), the corresponding script is available via [\texttt{source}] link. Actually, by clicking on this link, one loads the script into the \texttt{Files} area where it can be analyzed, edited and executed. + For each box, the html \texttt{Help} provides the informations necessary to use it: its name, its purpose, the descriptions of its inputs/outputs and the name of the package (or script file) that is to be loaded. Note that for a given box only the inputs/outputs listed in white cells are of actual interest. The remaining ones, grouped after them in colored cells, are standard (have the same names and purpose) in all atomic boxes. Additionally, for all boxes but the atomic ones (i.e. for all boxes defined in \bbs script language), the corresponding script is available via [\texttt{source}] link. Actually, by clicking on this link, one loads the script into the \texttt{Files} area where it can be analyzed, edited and executed. % ========================================== \subsubsection{The Package Browser} @@ -1213,13 +1213,11 @@ Let us consider another, more image-oriented, example : > new FileSelector fileDialog > new ImageReader reader -> new Slider slider > new Viewer2D viewer > connect fileDialog.Out reader.In > connect reader.Out viewer.In -> connect slider.Out viewer.Slice -> connect slider.BoxChange viewer.BoxExecute + > exec viewer \end{verbatim} @@ -1228,23 +1226,19 @@ Some explanations: \item The \texttt{include} instructions load the necessary packages. \item \texttt{FileSelector} will pop, at run time, a File Selector dialog box that will output the user-selected file name. \item \texttt{ImageReader} will read any itk readable file, the name of which is passed as a std::string, and return a pointer on an itk image. - \item \texttt{Slider} will pop, at run time, a Slider widget that will output an integer number, used later as a slice number. - \item \texttt{Viewer2D} displays a plane, the number of which is specified by an integer. - \item \texttt{connect fileDialog.Out reader.In} plugs the output of the File Selector (a \texttt{std::string}) to the input of the reader (a \texttt{std::string}, too). - \item \texttt{connect reader.Out viewer.In} plugs the output of the reader \\(a \texttt{bbtk::any} which is a type defined by the + \item \texttt{Viewer2D} will display a two-dimensional image. + \item \texttt{connect fileDialog.Out reader.In} plugs the output of the File Selector (a \texttt{std::string}) to the input of the Image Reader (a \texttt{std::string}, too). + \item \texttt{connect reader.Out viewer.In} plugs the output of the Image Reader \\(a \texttt{bbtk::any} which is a type defined by the itk package, and which can hold any itk image pointer) to the input of the Viewer (a \texttt{vtkImageData *}) -\item \texttt{connect slider.Out viewer.Slice} plugs the output of the slider (an \texttt{int}) to an other output (named Slide) of the viewer. - \item \texttt{connect slider.BoxChange viewer.BoxExecute} says the viewer that it must re process itself any time the slider is modified. -\item \texttt{exec viewer} processes the viewer. + \item \texttt{exec viewer} processes the Viewer. \end{itemize} -This would correspond to the graph in figure \ref{bbi-simplegraph} - +This would correspond to the graph in figure \ref{bbi-verysimplegraph}. \begin{figure}[!ht] -\caption{\label{bbi-simplegraph}(Very) simple Graph of a (very) simple pipeline} +\caption{\label{bbi-verysimplegraph}(Very) simple Graph of a (very) simple pipeline} \begin{center} -\includegraphics[width=0.8\textwidth]{bbi-simplegraph.png} +\includegraphics[width=0.8\textwidth]{bbi-verysimplegraph.png} \end{center} \end{figure} @@ -1257,9 +1251,9 @@ An adaptor is a black box that has at least one input, called \texttt{In}, and at least one output called \texttt{Out} and the role of which is to convert a data of the type of \texttt{In} into a data of the type of \texttt{Out} (other inputs or outputs may serve -to parameter the adaptor or retrieve other useful information). +to parameter the adaptor or retrieve other useful information). In the example above the appropriate adaptor that converts \texttt{bbtk::any} into \texttt{vtkImageData *} is provided in the package \texttt{itkvtk}. -Under \bbStudions, if you type : +Most of the useful standard adaptors are provided in the package \texttt{std}. Under \bbStudions, if you type : \begin{verbatim} > load std > help std all @@ -1344,7 +1338,116 @@ including adaptors. % ========================================== % ========================================== -\subsection{Creating complex black boxes} +\subsection{Writing scripts files} +\label{bbi-writing-scripts} +% ========================================== + +Now that you know how to connect the existing black boxes, you will soon realize that you want to save and reuse some sequences of commands that you are particularly glad of. In the following subsections you will learn how to write ``simple'' pipeline applications and new complex black boxes built of existing black boxes. + +% ========================================== +\subsubsection{Stand-alone pipeline applications} +\label{sec:pipeline-appli} +% ========================================== + +Let us take an example similar to that from section \ref{bbi-connecting-black-boxes}: + +\begin{verbatim} +> include vtk +> include wx +> include itk +> include wxvtk +> include itkvtk + +> new DirectorySelector dirSelect +> new DICOMDirReader reader +> new Slider slider +> new Viewer2D viewer + +> connect dirSelect.Out reader.In +> connect reader.Out viewer.In +> connect slider.Out viewer.Slice +> connect slider.BoxChange viewer.BoxExecute +> set slider.ReactiveOnTrack 1 + +> exec viewer +\end{verbatim} + +This is an elementary DICOM-image slicer (fig.~\ref{fig:simpleslicer}) designed to view 3D medical images slice-by-slice. The image is to be composed of a series of DICOM files contained in a separate directory. The index of the slice to be displayed is selected by means of a slider. The command \texttt{connect slider.BoxChange viewer.BoxExecute} permits the Viewer to update the display every time the output of the Slider changes. The command \texttt{set slider.ReactiveOnTrack 1} on its turn makes that the output of the Slider changes every time its cursor is moved, while the default behavior is to change only when the mouse-button is released after moving the cursor.\\ + +\begin{figure}[!ht] +\caption{ Graph of a (very) simple 3D slicer} +\begin{center} +\includegraphics[width=0.8\textwidth]{bbi-simplegraph.png} +\end{center} +\label{fig:simpleslicer} +\end{figure} + +Despite its simplicity, this application may already be useful. If you want to reuse it, you have to save the \bbs commands in a text file. The conventional (and mandatory) extension for such script files is \texttt{bbs} +(black box script). For example, our elementary 3D DICOM-image slicer +can be defined in the following file: + +\begin{file}{my\_slicer.bbs} +\begin{verbatim} +# my_slicer.bbs: elementary 3D image slicer" +/* + the 3D image has to be stored in a separate directory + as a series of DICOM files representing the 2D slices +*/ + +include vtk +include wx +include itk +include wxvtk +include itkvtk + +new DirectorySelector dirSelect +new DICOMDirReader reader +new Slider slider +new Viewer2D viewer + +connect dirSelect.Out reader.In +connect reader.Out viewer.In +connect slider.Out viewer.Slice +connect slider.BoxChange viewer.BoxExecute +set slider.ReactiveOnTrack 1 + +exec viewer +\end{verbatim} +\end{file} + +Lines starting with a \texttt{\#} character or with double slash (\texttt{\//\//}) are ignored, they +are considered as comments by the interpreter. A longer comment can be placed between the marks \texttt{\//*} and \texttt{*\//}. Each of this mark is to be placed alone in a separate line, like in the example.\par + +To use this file in \bbStudions, click on the \texttt{include} button, and browse your filestore to find the file. You can also type the command: + +\begin{verbatim} +> include my_slicer.bbs +\end{verbatim} + +provided that \bbStudio knows the path to the desired \texttt{bbs} file. +See the section \ref{The_configuration_file} to learn about the configuration file and the way to add a new path to it. Note that, if you modify the configuration file, you will have to close \bbStudio and run it again, so that the new configuration be taken into account. + +Actually, since the file has the \texttt{bbs} extension, you can omit it and just type: +\begin{verbatim} +> include my_slicer +\end{verbatim} + +% ========================================== +\hrule + +\paragraph{Summary} +%\hrule +\begin{itemize} +\item The \texttt{include} command tells the interpreter to include a script file. +\item Lines starting with \texttt{\#} or \texttt{\//\//} are considered as comments by the interpreter. +\item A longer comment can be written between a line marked \texttt{\//*} and a line marked \texttt{*\//}. +\end{itemize} + +\hrule +% ========================================== + +% ========================================== +\subsubsection{Creating complex black boxes} \label{bbi-complex-black-boxes} % ========================================== @@ -1363,22 +1466,28 @@ as shown in figure \ref{bbi-fig-complex-black-box-1}. \end{center} \end{figure} -The \bbs commands to define this complex black box are -the following: +The \bbs script file defining this complex black box will be as follows: \begin{verbatim} -> load std -> define Add3 -> new Add a -> new Add b -> connect a.Out b.In1 -> author "myself" -> description "adds 3 doubles" -> input x a.In1 "first double to add" -> input y a.In2 "second double to add" -> input z b.In2 "third double to add" -> output result b.Out "output" -> endefine +# bbAdd3.bbs: defines the Add3 black box which adds 3 doubles +load std + +define Add3 + author "myself" + description "adds 3 doubles" + + # Pipeline creation + new Add a + new Add b + connect a.Out b.In1 + + # Inputs definition + input x a.In1 "first double to add + input y a.In2 "second double to add + input z b.In2 "third double to add" + # Output definition + output result b.Out "output" +endefine \end{verbatim} Explanations: @@ -1387,7 +1496,7 @@ Explanations: \item The command \texttt{define} then starts the definition of the complex box type that will be called \texttt{Add3}. \item The next three lines define the pipeline, -exactly in the same way as outside a complex box definition. +exactly in the same way as outside of a complex box definition. \item The commands \texttt{author}, \texttt{description}, \texttt{input} and \texttt{output} are specific to complex boxes definition: \begin{itemize} @@ -1416,16 +1525,16 @@ input/output correspondence. new box type. \end{itemize} -After this definition, if you ask for help -on packages, you get: +If you type the command \texttt{include bbAdd3} and then you ask for help +on the contens of the \texttt{user} package, you get: + \begin{verbatim} -> help packages -std - Add - ... -user - Add3 - workspace +> help user + Package user - internal + User defined black boxes + Black boxes : + Add3 : adds three numbers + workspace : User's workspace \end{verbatim} The \texttt{user} package now contains a new black box type, called @@ -1478,76 +1587,9 @@ of internal boxes they correspond. % ========================================== % ========================================== -\subsection{Writing scripts files} -\label{bbi-writing-scripts} -% ========================================== - -Once you have defined a new type of complex box, you -may like to reuse it. To do this, you can simply -write the \bbs commands defining the new box -into a text file and afterwards include that file anywhere you need. -Doing this, you start writing \bbs scripts. -The conventional (and mandatory) extension for such scripts is \texttt{bbs} -(black box script). -For consistency reasons, you are requested to prepend \texttt{bb} to the name. - -For example, the \texttt{Add3} complex box we previously worked on -can be defined in the \texttt{bbAdd3.bbs} file: - -\begin{file}{bbAdd3.bbs} -\begin{verbatim} -# Defines the Add3 black box which adds 3 doubles -load std - -define Add3 - # I am the author - author "myself" - description "adds 3 doubles" - # Pipeline creation - new Add a - new Add b - connect a.Out b.In1 - # Inputs definition - input x a.In1 "first double to add - input y a.In2 "second double to add - input z b.In2 "third double to add" - # Output definition - output result b.Out "output" -endefine -\end{verbatim} -\end{file} - -Lines starting with a \texttt{\#} character or a \texttt{\//\//} character are ignored, they -are considered as comments by the interpreter. -To use this file in \bbStudions, click on the \texttt{include} button, and browse your filestore to find the file. - -\begin{verbatim} -> include bbAdd3.bbs -> help Add3 -Complex Black Box - adds 3 doubles - By : myself - * Inputs : - 'x' [] : first double to add - 'y' [] : second double to add - 'z' [] : third double to add - * Outputs : - 'result' [] : output - * Boxes : - 'a' - 'b' -\end{verbatim} - -If the file has the \texttt{bbs} extension, you can omit it and just type: -\begin{verbatim} -> include bbAdd3 -\end{verbatim} -provided that \bbStudio knows the path to the desired \texttt{bbs} file. -See the section \ref{The_configuration_file} to learn about the configuration file and the way to add a new path to it. Note that, if you modify the configuration file, you will have to close \bbStudio and run it again, so that the new configuration be taken into account. - -\subsection{Creating complex black boxes that use complex black boxes} +\subsubsection{Creating complex black boxes that use complex black boxes} \label{bbi-complex-complex-black-boxes} - +% ========================================== Of course, you can include script files in other script files, like in the following example: @@ -1576,7 +1618,7 @@ Here we kept the \texttt{bbAdd3.bbs} file unchanged, so the inner box of type \t Only the inputs \texttt{x, y, z} of box the \texttt{a} and the input \texttt{In2} of the box \texttt{b} are of interest for the end user, but he/she does not need to care neither about the inner boxes name, nor about the names of their inputs.\\ The author of the complex box has the ability to give these inputs meaningful names (here \texttt{In1, In2, In3, In4}) and to properly document them. -\subsection{Naming Conventions} +\subsubsection{Naming Conventions} \label{bbi-Naming Conventions} @@ -1618,7 +1660,7 @@ For instance, the package \texttt{wx} will be in the library \texttt{bbwx.dll} ( % ========================================== % ========================================== -\subsection{Creating and using command-line applications} +\subsubsection{Creating and using command-line applications} \label{bbi-command-line-app} % ========================================== -- 2.47.1