| 1 |
% \iffalse meta-comment |
| 2 |
%<*batchfile> |
| 3 |
%% |
| 4 |
%% ulQda |
| 5 |
%% A LaTeX package supporting Qualitative Data Analysis |
| 6 |
%% |
| 7 |
%% Copyright (C) 2009 by Ivan Griffin |
| 8 |
%% |
| 9 |
%% This file may be distributed and/or modified under the |
| 10 |
%% conditions of the LaTeX Project Public License, either |
| 11 |
%% version 1.2 of this license or (at your option) any later |
| 12 |
%% version. The latest version of this license is in: |
| 13 |
%% |
| 14 |
%% http://www.latex-project.org/lppl.txt |
| 15 |
%% |
| 16 |
%% and version 1.2 or later is part of all distributions of |
| 17 |
%% LaTeX version 1999/12/01 or later. |
| 18 |
\begingroup |
| 19 |
\input docstrip.tex |
| 20 |
\keepsilent |
| 21 |
\usedir{tex/latex/ulqda} |
| 22 |
\preamble |
| 23 |
|
| 24 |
This is a generated file. |
| 25 |
|
| 26 |
Copyright (C) 2009 by Ivan Griffin |
| 27 |
|
| 28 |
This file may be distributed and/or modified under the |
| 29 |
conditions of the LaTeX Project Public License, either |
| 30 |
version 1.2 of this license or (at your option) any later |
| 31 |
version. The latest version of this license is in: |
| 32 |
|
| 33 |
http://www.latex-project.org/lppl.txt |
| 34 |
|
| 35 |
and version 1.2 or later is part of all distributions of |
| 36 |
LaTeX version 1999/12/01 or later. |
| 37 |
|
| 38 |
\endpreamble |
| 39 |
\askforoverwritefalse |
| 40 |
\generate{\file{ulqda.sty}{\from{ulqda.dtx}{package}}} |
| 41 |
\generate{\usepreamble\empty \usepostamble\empty \file{ulqda.pl}{\from{ulqda.dtx}{perl}}} |
| 42 |
\endgroup |
| 43 |
%</batchfile> |
| 44 |
%<*package> |
| 45 |
% |
| 46 |
% |
| 47 |
\NeedsTeXFormat{LaTeX2e}[1995/12/01] |
| 48 |
\ProvidesPackage{ulqda} |
| 49 |
[2009/06/11 v1.1 Qualitative Data Analysis package] |
| 50 |
% |
| 51 |
%</package> |
| 52 |
%<*driver> |
| 53 |
\documentclass{ltxdoc} |
| 54 |
\usepackage{color} |
| 55 |
\usepackage{soul} |
| 56 |
\usepackage{tikz} |
| 57 |
\usetikzlibrary{backgrounds,shapes,arrows,positioning} |
| 58 |
\definecolor[named]{UlQda@lightblue}{rgb}{0.80,0.85,1} |
| 59 |
\usepackage{alltt} |
| 60 |
\usepackage{ulqda} |
| 61 |
\usepackage{hyperref} |
| 62 |
\usepackage{subfigure} |
| 63 |
\definecolor{linkcolour}{rgb}{0,0.2,0.6} |
| 64 |
\hypersetup{colorlinks,breaklinks, |
| 65 |
linkcolor=linkcolour,citecolor=linkcolour, |
| 66 |
filecolor=linkcolour, urlcolor=linkcolour} |
| 67 |
\GetFileInfo{ulqda.sty} |
| 68 |
\EnableCrossrefs |
| 69 |
\CodelineIndex |
| 70 |
\RecordChanges |
| 71 |
\newenvironment{UsageEnv} |
| 72 |
{ |
| 73 |
% Begin Code |
| 74 |
\vspace*{0.12em} |
| 75 |
\textsc{Usage}: |
| 76 |
} |
| 77 |
{ |
| 78 |
% End Code |
| 79 |
\\ \vspace*{0.25em} |
| 80 |
} |
| 81 |
\def\TikZ{Ti{\em k}Z} |
| 82 |
\begin{document} |
| 83 |
\DocInput{ulqda.dtx} |
| 84 |
\end{document} |
| 85 |
%</driver> |
| 86 |
% \fi |
| 87 |
% |
| 88 |
% \CheckSum{0} |
| 89 |
% \changes{v1.0}{2009/05/15}{Initial Version.} |
| 90 |
% \changes{v1.1}{2009/06/11}{Changes to support xcolor, multicol, and to fix some typos and bugs. dot2texi.sty in CTAN doesn't currently support cache option. Also added |\ulqdaCloud| macro.} |
| 91 |
% \GetFileInfo{ulqda.sty} |
| 92 |
% |
| 93 |
% \title{\ulQda: A \LaTeX\ package supporting Qualitative Data Analysis} |
| 94 |
% \author{Ivan Griffin |
| 95 |
% \\% |
| 96 |
% \texttt{[email protected]}} |
| 97 |
% \date{\filedate} |
| 98 |
% \maketitle |
| 99 |
% |
| 100 |
% ^^A The following were copied verbatim from source2e.tex. |
| 101 |
% \DoNotIndex{\def,\long,\edef,\xdef,\gdef,\let,\global} |
| 102 |
% \DoNotIndex{\if,\ifnum,\ifdim,\ifcat,\ifmmode,\ifvmode,\ifhmode,% |
| 103 |
% \iftrue,\iffalse,\ifvoid,\ifx,\ifeof,\ifcase,\else,\or,\fi} |
| 104 |
% \DoNotIndex{\box,\copy,\setbox,\unvbox,\unhbox,\hbox,% |
| 105 |
% \vbox,\vtop,\vcenter} |
| 106 |
% \DoNotIndex{\@empty,\immediate,\write} |
| 107 |
% \DoNotIndex{\egroup,\bgroup,\expandafter,\begingroup,\endgroup} |
| 108 |
% \DoNotIndex{\divide,\advance,\multiply,\count,\dimen} |
| 109 |
% \DoNotIndex{\relax,\space,\string} |
| 110 |
% \DoNotIndex{\csname,\endcsname,\@spaces,\openin,\openout,% |
| 111 |
% \closein,\closeout} |
| 112 |
% \DoNotIndex{\catcode,\endinput} |
| 113 |
% \DoNotIndex{\jobname,\message,\read,\the,\m@ne,\noexpand} |
| 114 |
% \DoNotIndex{\hsize,\vsize,\hskip,\vskip,\kern,\hfil,\hfill,\hss} |
| 115 |
% \DoNotIndex{\m@ne,\z@,\z@skip,\@ne,\tw@,\p@} |
| 116 |
% \DoNotIndex{\dp,\wd,\ht,\vss,\unskip,} |
| 117 |
% |
| 118 |
% ^^A The following are for this package. |
| 119 |
% \DoNotIndex{\begin,\day,\time,\year,\month,\par,\hl,\hbadness,\typeout} |
| 120 |
% \DoNotIndex{\input,\lower,\index,\emph,\RequirePackage} |
| 121 |
% \DoNotIndex{\it,\protect,\sethlcolor,\setkeys,\stepcounter,\thepage,\thesection,\tiny,\ul,\verb,\tmpfile} |
| 122 |
% |
| 123 |
% \begin{abstract} |
| 124 |
% \ulQda\ is a \LaTeX\ package for use in Qualitative Data Analysis research. |
| 125 |
% It assists in the analysis of textual data such as interview transcripts |
| 126 |
% and field notes. This document corresponds to \ulQda~\fileversion, |
| 127 |
% dated~\filedate. |
| 128 |
% \end{abstract} |
| 129 |
% |
| 130 |
% \tableofcontents |
| 131 |
% |
| 132 |
% \section{Introduction} |
| 133 |
% This document describes \ulQda, a \LaTeX\ package which supports |
| 134 |
% the integration of Qualitative Data Analysis (QDA) research tasks, |
| 135 |
% specifically for Grounded Theory, into the |
| 136 |
% \LaTeX\ work flow. For a quick start example, see |
| 137 |
% section~\ref{sect:example}. |
| 138 |
% |
| 139 |
% \subsection{What is Qualitative Data Analysis?} |
| 140 |
% Qualitative Data Analysis is a field of inquiry that is popular in |
| 141 |
% social science research~\cite{miles_and_huberman}. |
| 142 |
% Scientific methods within QDA aim to gain |
| 143 |
% comprehensive and holistic understandings of the motivations for |
| 144 |
% human behaviour in many different situations. |
| 145 |
% |
| 146 |
% Grounded Theory is a qualitative methodology that emphasises the |
| 147 |
% generation of new theory from its natural emergency through the |
| 148 |
% process of continual collection, compaction and analysis~\cite{glaser_strauss,strauss_corbin}. |
| 149 |
% |
| 150 |
% \subsection{What does this package do?} |
| 151 |
% |
| 152 |
% The \ulQda\ package provides the \LaTeX\ user with macros which |
| 153 |
% are used to markup textual information - for example, in-depth |
| 154 |
% interviews - in order to facilitate the distillation of emerging |
| 155 |
% themes from the data in a consistent and reliably manner, and to |
| 156 |
% support visualisation of these themes. |
| 157 |
% |
| 158 |
% In other words, this package lets the computer do the grunt work, and |
| 159 |
% the researcher focus on recognising and comprehending the |
| 160 |
% emerging theories from the work. |
| 161 |
% |
| 162 |
% The package works by creating a comma-separate values (CSV) cache file |
| 163 |
% of the codes and associated text it finds in your \LaTeX\ source. |
| 164 |
% It then post-processes this CSV file to |
| 165 |
% \href{http://www.graphviz.org}{GraphViz} Dot language, and |
| 166 |
% uses \texttt{dot2texi.sty} to optionally render this data as graphs. |
| 167 |
% The filename for the CSV file is generated automatically from the |
| 168 |
% \LaTeX\ current jobname. |
| 169 |
% |
| 170 |
% \subsection{Why is this package named \ulQda?} |
| 171 |
% The name \ulQda\ is simply the initials of my \emph{alma mater}, the |
| 172 |
% \href{http://www.ul.ie/}{University of Limerick}, prepended onto the |
| 173 |
% abbreviation QDA to generate a unique name. The \ulQda\ prefix is used |
| 174 |
% within the package on macro names and conditionals to prevent naming |
| 175 |
% clashes. |
| 176 |
% |
| 177 |
% \subsection{Acknowledgements} |
| 178 |
% Special thanks to Marc van Dongen and Peter Flynn of the |
| 179 |
% \href{https://listserv.heanet.ie/cgi-bin/wa?A0=ITALIC-L}% |
| 180 |
% {Irish \TeX{} and \LaTeX{} In-Print Community} |
| 181 |
% for their assistance in creating the \LaTeX\ macro to perform the coding. |
| 182 |
% |
| 183 |
% Thanks to Kjell Magne Fauskes for the excellent \texttt{dot2tex} and |
| 184 |
% \texttt{dot2texi.sty} packages. |
| 185 |
% |
| 186 |
% And finally, a special shout out to Matthias Noe for pointing out |
| 187 |
% some issues with an earlier version of this package. |
| 188 |
% |
| 189 |
% \subsection{Legal Mumbo-Jumbo} |
| 190 |
% |
| 191 |
% This document and the \ulQda\ package are copyright \copyright~2009 |
| 192 |
% Ivan Griffin. |
| 193 |
% |
| 194 |
% The \ulQda\ package may be distributed under the |
| 195 |
% conditions of the \LaTeX\ Project Public License, either |
| 196 |
% version 1.2 of this license or (at your option) any later |
| 197 |
% version. The latest version of this license is in: |
| 198 |
% \begin{quote} |
| 199 |
% \url{http://www.latex-project.org/lppl.txt} |
| 200 |
% \end{quote} |
| 201 |
% and version 1.2 or later is part of all distributions of |
| 202 |
% \LaTeX\ version 1999/12/01 or later. |
| 203 |
% |
| 204 |
% \section{Prerequisites} |
| 205 |
% \ulQda\ requires the use of pdfe\TeX. The following \LaTeX\ packages, |
| 206 |
% available on \href{http://www.ctan.org/}{CTAN}, are needed by the \ulQda\ |
| 207 |
% package: |
| 208 |
% \begin{itemize} |
| 209 |
% \item color.sty - provides \LaTeX\ support for colour; |
| 210 |
% \item soul.sty - provides support for highlighting text; |
| 211 |
% \item multicol.sty - defines an environment for typesetting text in |
| 212 |
% multiple columns; |
| 213 |
% \item \href{http://sourceforge.net/projects/pgf/}{PGF/\TikZ} - macro |
| 214 |
% package for the creation of graphics in \TeX; |
| 215 |
% \item \href{http://www.fauskes.net/nb/introducing-dot2texi/}{dot2texi.sty} - allows the embedding of GraphViz graphs (described in Dot language) in \LaTeX\ documents. |
| 216 |
% \end{itemize} |
| 217 |
% |
| 218 |
% In addition, the following external tools are required for processing |
| 219 |
% and graph/list generation: |
| 220 |
% \begin{itemize} |
| 221 |
% \item \href{http://www.graphviz.org/}{GraphViz} is a tool to automate |
| 222 |
% graph visualisation~\cite{graphviz}, a means of graphically |
| 223 |
% `representing structural information as diagrams of abstract graphs |
| 224 |
% and networks'; |
| 225 |
% \item \href{http://www.fauskes.net/code/dot2tex/}{dot2tex} is a tool |
| 226 |
% for converting graphs generated by GraphViz to PGF/\TikZ\ that can |
| 227 |
% be rendered with \LaTeX~\cite{dot2tex}; |
| 228 |
% \item \href{http://www.perl.org/}{Perl} and the Digest::SHA1 Perl Module |
| 229 |
% are used to automate the conversion of coded output to Dot language. |
| 230 |
% \end{itemize} |
| 231 |
% |
| 232 |
% \section{Known Limitations and Issues} |
| 233 |
% |
| 234 |
% For some reason, the underlining trick provided by soul.sty and used by |
| 235 |
% this package fails to work when a color model option is passed to |
| 236 |
% xcolor.sty. The trouble seems to be with soul.sty's |\texthl{}| macro. |
| 237 |
% |
| 238 |
% A rather unsatisfactory workaround is to redefine |\ulqdaHighlight| to |
| 239 |
% something % like the following, somewhere in your own document after you |
| 240 |
% have used |
| 241 |
% |\usepackage[cmyk]{xcolor}| and |\usepackage{ulqda}|: |
| 242 |
% \\ |
| 243 |
% |\renewcommand{\ulqdaHighlight}[2]{%| \\ |
| 244 |
% | \colorbox{UlQda@lightblue}{\mbox{#2}}| \\ |
| 245 |
% | \marginpar%| \\ |
| 246 |
% | {\raggedright\hbadness=10000\tiny\it\colorbox{UlQda@lightblue}{#1}\par}%| \\ |
| 247 |
% |}| |
| 248 |
% |
| 249 |
% Note however that this is not without its own typesetting abberations. |
| 250 |
% |
| 251 |
% \subsection{docstrip woes - in this very document!} |
| 252 |
% |
| 253 |
% As I am using a single |.dtx| file to produce both |ulqda.sty| and |ulqda.pl|, |
| 254 |
% I used mechanisms to separate each - notably |<package>| and |<perl>| filters established |
| 255 |
% with the docstrip |\generate| macro. However, for some reason these filters are |
| 256 |
% being output in the typeset source listings for the \LaTeX\ macros in this document. |
| 257 |
% Unfortunately, the docstrip documentation is suitable terse and has not as of yet |
| 258 |
% enlightened me as to how to fix this issue. Please ignore them - or better, suggest |
| 259 |
% the fix! |
| 260 |
% |
| 261 |
% \section{Why use \LaTeX\ for QDA Automation?} |
| 262 |
% |
| 263 |
% An obvious question at this point is why use \LaTeX\ for QDA work flow |
| 264 |
% automation? Surely there are plenty of commercial offerings on the |
| 265 |
% market that can perform the same or similar task? |
| 266 |
% |
| 267 |
% In my opinion, incorporating the coding markup into the \LaTeX\ |
| 268 |
% typesetting flow has a number of benefits: |
| 269 |
% |
| 270 |
% \begin{itemize} |
| 271 |
% \item it helps keep coding near the data - developer Brad Appleton |
| 272 |
% describes this well~\cite{locality_of_ref}: |
| 273 |
% \begin{quote} |
| 274 |
% `\emph{The likelihood of keeping all or part of a software |
| 275 |
% artifact consistent with any corresponding text that describes it, |
| 276 |
% is inversely proportional to the square of the cognitive distance |
| 277 |
% between them.}' |
| 278 |
% \end{quote} |
| 279 |
% Appleton also expands on the concept of cognitive |
| 280 |
% distance~\cite{locality_of_ref}: |
| 281 |
% \begin{quote} |
| 282 |
% `\emph{The phrase ``out of sight, out of mind'' gives a vague |
| 283 |
% indication of what is meant by ``cognitive distance'' \ldots |
| 284 |
% it relates to the interruption of ``flow'' |
| 285 |
% of the developers' thoughts between the time they first thought of |
| 286 |
% what they needed to do, and the time and effort expended before |
| 287 |
% they were actually able to begin doing it. }' |
| 288 |
% \end{quote} |
| 289 |
% \item coding can easily be output as a recorded high-quality typeset |
| 290 |
% deliverable - this is possible with other commercial tools, although |
| 291 |
% the output is not as aesthetic as using \LaTeX\ - it is certainly more |
| 292 |
% difficult to do this with pen, paper and scissors techniques; |
| 293 |
% \begin{itemize} |
| 294 |
% \item in addition, typesetting the coded data is very valuable - |
| 295 |
% it allows others to check the validity of the output (theme |
| 296 |
% emergence and theory building) of your work, and provides a resource |
| 297 |
% for subsequent (perhaps affiliated) researchers to use (subject to |
| 298 |
% confidentiality and disclosure agreements, etc.) |
| 299 |
% \item Using \LaTeX\ allows you to easily keep the interviews |
| 300 |
% typographically consistent with the styles and notations used in |
| 301 |
% the main dissertation; |
| 302 |
% \end{itemize} |
| 303 |
% \item it allows for a significant degree of flexible in the work flow, |
| 304 |
% limited primarily by your imagination, and not by the functionality |
| 305 |
% of a commercial package. A \LaTeX\ based scheme can `fit naturally |
| 306 |
% into a work flow where there are many tools, each good at its own |
| 307 |
% job'\cite{LaTeX_goes_with_the_flow}. |
| 308 |
% As the \LaTeX\ typesetting run itself is generating the coded |
| 309 |
% output data in an easily accessible format (comma-separated values), |
| 310 |
% it is possible to post-process this and visualize the data in a |
| 311 |
% number of different ways: |
| 312 |
% \begin{itemize} |
| 313 |
% \item coupled with an appropriate version control system, the |
| 314 |
% \LaTeX\ QDA work flow can provide full traceability of a theme from |
| 315 |
% the collection of source interview data, condensation into codes, |
| 316 |
% iterative refinement of these codes into orthogonal and related |
| 317 |
% sets, and presentation/visualisation of the generated ontologies; |
| 318 |
% \item it is possible to generate `heatmaps', mixing qualitative |
| 319 |
% analysis with some element of quantitative analysis, and to |
| 320 |
% use color coding or font/size scaling based on frequency of |
| 321 |
% occurrence of certain codes or themes; |
| 322 |
% \item it is also possible to visually recognize saturation |
| 323 |
% occurring in emerging themes - again through the use of |
| 324 |
% appropriate color coding of new themes on a per-interview |
| 325 |
% basis - the output format includes the document section |
| 326 |
% information per code to facilitate this post-processing; |
| 327 |
% \end{itemize} |
| 328 |
% \item this package and the \LaTeX\ typesetting system are freely |
| 329 |
% available - you may be unwilling or unable to pay for commercial |
| 330 |
% software; |
| 331 |
% \end{itemize} |
| 332 |
% |
| 333 |
% \section{Installation} |
| 334 |
% The package \ulQda\ is distributed as \texttt{dtx} archive together |
| 335 |
% with a corresponding \texttt{Makefile}. |
| 336 |
% \texttt{dtx} files are text files which combines a \LaTeX\ package with |
| 337 |
% other helper files and documentation for its own code. |
| 338 |
% |
| 339 |
% In order to install this package, you must: |
| 340 |
% \begin{enumerate} |
| 341 |
% \item Run \texttt{make} to use the supplied \texttt{Makefile}. This will |
| 342 |
% extract the macro and script files from the \texttt{dtx} |
| 343 |
% archive, and it will also generate documentation for the packages |
| 344 |
% user interfaced and code: |
| 345 |
% When built with \texttt{make}, the following files are generated: |
| 346 |
% \begin{itemize} |
| 347 |
% \item \texttt{ulqda.pdf} - contains this documentation; |
| 348 |
% \item \texttt{ulqda.sty} - contains the actual macro implementations; |
| 349 |
% \item \texttt{ulqda.pl} - a helper script to parse the CSV output. |
| 350 |
% \end{itemize} |
| 351 |
% \item Copy \texttt{ulqda.sty} to either the working directory of your |
| 352 |
% current \LaTeX\ project, or to your personal \TeX\ tree. |
| 353 |
% For Unix users, the procedure to copy to your personal tree is:\\ |
| 354 |
%\verb+$ make+\\ |
| 355 |
%\verb+$ mkdir -p ~/texmf/tex/latex/ulqda+\\ |
| 356 |
%\verb+$ cp ulqda.sty ~/texmf/tex/latex/ulqda+ |
| 357 |
% \item Tell \TeX\ to re-index its directories to enable it to recognize |
| 358 |
% the new package:\\ |
| 359 |
%\verb+$ texhash ~/texmf+ |
| 360 |
% \item Copy \texttt{ulqda.pl} to a directory in your path. Again, for |
| 361 |
% Unix users, the procedure to do this is as follows:\\ |
| 362 |
%\verb+$ cp ulqda.pl ~/bin+ |
| 363 |
% \end{enumerate} |
| 364 |
% |
| 365 |
% \section{Usage} |
| 366 |
% |
| 367 |
% We will now look at how the package is used - how to set |
| 368 |
% its various options, the macros it provides, and an example of its |
| 369 |
% operation. |
| 370 |
% |
| 371 |
% \subsection{Options} |
| 372 |
% |
| 373 |
% To use the package in your \LaTeX\ document, insert |\usepackage[...]{foo}| |
| 374 |
% in the preamble. There are a number of options which can be passed to the |
| 375 |
% package: |
| 376 |
% \begin{itemize} |
| 377 |
% \item \texttt{active}: The default is inactive. If this option is not |
| 378 |
% specified, the \ulQda\ package will be inactive and the document |
| 379 |
% will be typeset as if the \ulQda\ package were not loaded, except |
| 380 |
% that all macros defined by the package are still legal but only |
| 381 |
% the |\ulqdaHighlight| macro has an effect. |
| 382 |
% |
| 383 |
% This allows final typesetting of the document and for page numbering to |
| 384 |
% stabilize before running through for a coding pass. |
| 385 |
% The recommendation is to activate for the last two \LaTeX\ passes |
| 386 |
% through the document - that way the CSV file is generated once page |
| 387 |
% numbering is allowed to settle. To activate |
| 388 |
% subsequently, it is possible to invoke \LaTeX\ as follows:\\ |
| 389 |
% \verb+$ pdflatex --shell-escape "\PassOptionsToPackage{active}{ulqda}+\\ |
| 390 |
% \verb+ \input{filename.tex}"+ |
| 391 |
% \item \texttt{cache}/\texttt{nocache}: This is an advanced option |
| 392 |
% which controls whether the CSV file is generated or not. |
| 393 |
% \item \texttt{debug}: This option enables verbose debug output from |
| 394 |
% \ulQda. |
| 395 |
% \item \texttt{MiKTeX}: This determines whether |
| 396 |
% \href{http://www.miktex.org/}{MiK\TeX} is supported or not. MiK\TeX\ is |
| 397 |
% a version of \TeX\ that runs on Microsoft Windows platforms. |
| 398 |
% \item \texttt{shell}/\texttt{noshell}: These options control whether an |
| 399 |
% attempt will be made to process the coding output file via spawning |
| 400 |
% the \texttt{ulqda.pl} script directly, or whether it needs to be run |
| 401 |
% explicitly by the user. \texttt{shell} is the default, but it requires |
| 402 |
% \texttt{--shell-escape} (\TeX{} Live) or \texttt{--enable-write18} |
| 403 |
% (MiK\TeX) as a command line argument to \texttt{latex} to enable it. |
| 404 |
% \item \texttt{counts}: This option determines whether code output will |
| 405 |
% include occurence counts or not. The default is to not output the counts. |
| 406 |
% \end{itemize} |
| 407 |
% |
| 408 |
% In summary, to ensure correct section/page numbers, set the |
| 409 |
% \texttt{active} and leave the cache setting at its default |
| 410 |
% (\texttt{nocache}) for each run. It is possible to tweak both of these |
| 411 |
% to reduce the processing time, being aware of potential side-effects! |
| 412 |
% |
| 413 |
% \subsubsection{Advanced Options Usage} |
| 414 |
% |
| 415 |
% The use of the \texttt{active} and \texttt{cache} options are |
| 416 |
% primarily to speed up the process of performing QDA code extraction |
| 417 |
% through the \LaTeX\ typesetting flow. Some care is needed with their |
| 418 |
% use, and it makes sense to select \texttt{active,nocache} as default |
| 419 |
% options until comfortable with the typesetting flow for a particular |
| 420 |
% document -- otherwise section numbering/page numbering in the generated |
| 421 |
% CSV file may be incorrect. |
| 422 |
% |
| 423 |
% If this isn't a concern (i.e.~traceability and per-section filtering |
| 424 |
% for graph visualisation isn't required), then setting \texttt{active,cache} |
| 425 |
% on one pass through \LaTeX\ will give best performance. |
| 426 |
% |
| 427 |
% If page numbers / section numbers are required, then the appropriate |
| 428 |
% use of these options will need to be made as required by the specific |
| 429 |
% \LaTeX\ flow being used -- i.e.~enable as appropriate. |
| 430 |
% It will need to run like this at least 3 times (once to generate the |
| 431 |
% CSV file, once to generate the~.Dot output, and once to import any |
| 432 |
% generated figures or tables. |
| 433 |
% I suggest integrating something like the following for the last 3 \LaTeX\ |
| 434 |
% passes through the source: |
| 435 |
% \verb+$ pdflatex --shell-escape "\PassOptionsToPackage{active,nocache}{ulqda}+\\ |
| 436 |
% \verb+ \input{filename.tex}"+\\ |
| 437 |
% \verb+$ pdflatex --shell-escape "\PassOptionsToPackage{active,cache}{ulqda}+\\ |
| 438 |
% \verb+ \input{filename.tex}"+\\ |
| 439 |
% \verb+$ pdflatex --shell-escape "\PassOptionsToPackage{active,cache}{ulqda}+\\ |
| 440 |
% \verb+ \input{filename.tex}"+\\ |
| 441 |
% |
| 442 |
% \subsection{Macros} |
| 443 |
% \DescribeMacro{\ulqdaCode} |
| 444 |
% |\ulqdaCode| is used to assign a code a particular sentence or |
| 445 |
% passage of text. Coding is a form of data condensing, where the |
| 446 |
% words of the passage are compacted and distilled into as few |
| 447 |
% succinct words as possible with the aim of capturing |
| 448 |
% the essence or theme of the passage. |
| 449 |
% |
| 450 |
% |\ulqdaCode| takes a list of codes as a first parameter, and the raw |
| 451 |
% text as its second. It invokes |\ulqdaHighlight| in order to |
| 452 |
% format the passage for typesetting purposes, and outputs the |
| 453 |
% code, page number, section number, and raw text to the CSV file - |
| 454 |
% one line per code. |
| 455 |
% |
| 456 |
% The list of codes is a comma separated list; code hierarchies and |
| 457 |
% connections can be expressed by chaining codes together using the |
| 458 |
% exclamation mark - for example, `\texttt{geographical!urgency}' |
| 459 |
% would indicate a relationship between the code `\texttt{geographical}' |
| 460 |
% and the code `\texttt{urgency}'. \\ |
| 461 |
% \begin{UsageEnv} |
| 462 |
% \verb+\ulqdaCode{code1,code2,code3}{Common Text}+ |
| 463 |
% \end{UsageEnv} |
| 464 |
% |
| 465 |
% \DescribeMacro{\ulqdaHighlight} |
| 466 |
% |\ulqdaHighlight| is used to format coded text for typesetting |
| 467 |
% purposes. By default, it highlights the coded text in a light |
| 468 |
% blue color, and it also lists the associated codes in the margin. |
| 469 |
% It can be redefined to whatever formatting codes the package user |
| 470 |
% requires. \\ |
| 471 |
% \begin{UsageEnv} |
| 472 |
% \verb+\ulqdaHighlight{code1,code2,code3}{Common Text}+ |
| 473 |
% \end{UsageEnv} |
| 474 |
% |
| 475 |
% \DescribeMacro{\ulqdaGraph} |
| 476 |
% |\ulqdaGraph| is a macro which invokes processing of the |
| 477 |
% generated CSV file to allow the visualisation of a coded ontology as a |
| 478 |
% GraphViz diagram. It take two arguments: |
| 479 |
% \begin{itemize} |
| 480 |
% \item graph type - this can be either `\texttt{flat}' which is |
| 481 |
% an unstructured graph (see figure~\ref{figure:viz:flat}), or |
| 482 |
% `\texttt{net}' (see figure~\ref{figure:viz:net}), where the ontology |
| 483 |
% relationships are shown as a connected graph; |
| 484 |
% \item dot2texi options - this is a list of options that would typically |
| 485 |
% be used in a dot2tex environment. Listing these is outside the |
| 486 |
% scope of this document, but the following set of options is used |
| 487 |
% in the diagrams in this document: |
| 488 |
% \verb+neato,mathmode,options={--graphstyle "scale=0.5,transform shape"+. |
| 489 |
% \end{itemize} |
| 490 |
% \begin{UsageEnv} |
| 491 |
% \verb+\ulqdaGraph{+\emph{graph type}\verb+}{+\emph{dot2texi options}\verb+}+ |
| 492 |
% \end{UsageEnv} |
| 493 |
% |
| 494 |
% \DescribeMacro{\ulqdaTable} |
| 495 |
% |\ulqdaTable| is a macro which invokes processing of the |
| 496 |
% generated CSV file to create a \LaTeX\ table |
| 497 |
% (see table~\ref{table:qda_codes}). \\ |
| 498 |
% \begin{UsageEnv} |
| 499 |
% \verb+\ulqdaTable+ |
| 500 |
% \end{UsageEnv} |
| 501 |
% |
| 502 |
% \DescribeMacro{\ulqdaCloud} |
| 503 |
% |\ulqdaCloud| is a macro which invokes processing of the |
| 504 |
% generated CSV file to create a \LaTeX\ cloud |
| 505 |
% (see table~\ref{table:cloud}). \\ |
| 506 |
% \begin{UsageEnv} |
| 507 |
% \verb+\ulqdaCloud+ |
| 508 |
% \end{UsageEnv} |
| 509 |
% |
| 510 |
% \DescribeMacro{\ulqdaSetSectFilter} |
| 511 |
% |\ulqdaSetSectFilter| establishes a filter for the next |\ulqdaGraph| |
| 512 |
% or |\ulqdaTable| macro. If interviews are logically structured in a |
| 513 |
% document with each in its own section (or sub-section etc.) then this |
| 514 |
% command can be used to establish a filter restricting the graphing or |
| 515 |
% table generation to a single interview. \\ |
| 516 |
% \begin{UsageEnv} |
| 517 |
% \verb+\ulqdaSetSectFilter{+\emph{section label}\verb+}+ |
| 518 |
% \end{UsageEnv} |
| 519 |
% |
| 520 |
% \DescribeMacro{\ulqdaClearSectFilter} |
| 521 |
% |\ulqdaClearSectFilter| clears a section filter establihed by |
| 522 |
% |\ulqdaSetSectFilter| so that a subsequent |\ulqdaGraph| or a |
| 523 |
% |\ulqdaTable| macro will process all sections from the CSV file. \\ |
| 524 |
% \begin{UsageEnv} |
| 525 |
% \verb+\ulqdaClearSectFilter+ |
| 526 |
% \end{UsageEnv} |
| 527 |
% |
| 528 |
% \subsection{Example}\label{sect:example} |
| 529 |
% What follows is an interview excerpt that has been taken through |
| 530 |
% the entire flow, i.e.: |
| 531 |
% \begin{itemize} |
| 532 |
% \item coded; |
| 533 |
% \item typeset; and |
| 534 |
% \item visualized as a tabular list of codes and also as graphs. |
| 535 |
% \end{itemize} |
| 536 |
% |
| 537 |
% \subsubsection{Coding Example} |
| 538 |
% |
| 539 |
% First, here is the raw \LaTeX\ source: |
| 540 |
% \\ |
| 541 |
% \begin{center} |
| 542 |
% \framebox{ |
| 543 |
% \begin{minipage}{0.95\textwidth} |
| 544 |
% \small |
| 545 |
% \texttt{$\backslash$textbf\{IG:\} Do you think the social aspect of face}\\ |
| 546 |
% \texttt{to face is important for the project? {\ldots}}\\ |
| 547 |
% \\ |
| 548 |
% \texttt{$\backslash$textbf\{Interviewee\~{}XYZ:\} \ldots{} A cup of coffee is really}\\ |
| 549 |
% \texttt{important because then what happens is that you get a}\\ |
| 550 |
% \texttt{real perspective. My general experience of having a}\\ |
| 551 |
% \texttt{functional group in one site, while I was in the other}\\ |
| 552 |
% \texttt{one, working for me and using video conferencing,}\\ |
| 553 |
% \texttt{$\backslash$ulqdaCode\{geographical!urgency, geographical!face-eo-face\}\{if you}\\ |
| 554 |
% \texttt{really wanted to get things done you had to jump on}\\ |
| 555 |
% \texttt{a plane and fly over, there was nothing that could make}\\ |
| 556 |
% \texttt{up for sitting in a room with people to both get across}\\ |
| 557 |
% \texttt{the urgency and to ensure that communication among}\\ |
| 558 |
% \texttt{the team took place to address any of the issues\ldots{}\}} |
| 559 |
% \end{minipage} |
| 560 |
% }\\ |
| 561 |
% \end{center} |
| 562 |
% |
| 563 |
% |
| 564 |
% \subsubsection{Typeset Example} |
| 565 |
% Next, we will see what happens when this source is typeset. |
| 566 |
% The mainbody text is itself highlighted so that it stands out from |
| 567 |
% surrounding text, and the codes are present in the margin. |
| 568 |
% \\ |
| 569 |
% \begin{center} |
| 570 |
% \framebox{ |
| 571 |
% \begin{minipage}{0.75\textwidth} |
| 572 |
% \textbf{IG:} Do you think the social aspect of face to face is important |
| 573 |
% for the project? {\ldots} |
| 574 |
% |
| 575 |
% \textbf{Interviewee~XYZ:} \ldots{} A cup of coffee is |
| 576 |
% really important because then what happens is that you get a real |
| 577 |
% perspective. My general experience of having a functional group in one |
| 578 |
% site, while I was in the other one, working for me and using video |
| 579 |
% conferencing, \hl{\protect\ul{ |
| 580 |
% if you really wanted to get things done you had to jump on a |
| 581 |
% plane and fly over, there was nothing that could make up for sitting in a |
| 582 |
% room with people to both get across the urgency and to ensure that |
| 583 |
% communication among the team took place to address any of the |
| 584 |
% issues.\ldots{}}} |
| 585 |
% \end{minipage} |
| 586 |
% \begin{minipage}{0.05\textwidth} |
| 587 |
% \end{minipage} |
| 588 |
% \begin{minipage}{0.15\textwidth} |
| 589 |
% \vfill |
| 590 |
% { |
| 591 |
% \tiny |
| 592 |
% \hl{geographical!urgency, geographical!face-to-face} |
| 593 |
% } |
| 594 |
% \vfill |
| 595 |
% \end{minipage} |
| 596 |
% }\\ |
| 597 |
% \end{center} |
| 598 |
% |
| 599 |
% \subsubsection{CSV Cache File} |
| 600 |
% The following shows an example of the comma-separated value cache file |
| 601 |
% generated for the coded text above. The first line of this file is a |
| 602 |
% header and is ignored in processing by the \texttt{ulqda.pl} script. |
| 603 |
% \\ |
| 604 |
% \begin{center} |
| 605 |
% \framebox{ |
| 606 |
% \begin{minipage}{0.95\textwidth} |
| 607 |
% \small |
| 608 |
% \texttt{Page Number, Section, Code, Text\\ |
| 609 |
% 2, 0, geographical!urgency, "if you really wanted to get things done you had to jump on a plane and fly over, there was nothing that could make up for sitting in a room with people to both get across the urgency and to ensure that communication among the team took place to address any of the issues\ldots{}"\\ |
| 610 |
% 2, 0, geographical!face-to-face, "if you really wanted to get things done you had to jump on a plane and fly over, there was nothing that could make up for sitting in a room with people to both get across the urgency and to ensure that communication among the team took place to address any of the issues\ldots{}"\\ |
| 611 |
% } |
| 612 |
% \end{minipage} |
| 613 |
% }\\ |
| 614 |
% \end{center} |
| 615 |
% |
| 616 |
% \subsubsection{Visualisation as a Table} |
| 617 |
% |
| 618 |
% Table~\ref{table:qda_codes} illustrates the output from |\ulqdaTable|. |
| 619 |
% |
| 620 |
% \begin{table}[h] |
| 621 |
% \centering |
| 622 |
% \caption{List of QDA Codes} |
| 623 |
% { |
| 624 |
% \vspace{0.1in} |
| 625 |
% \hrule |
| 626 |
% |
| 627 |
% \begin{multicols}{3} |
| 628 |
% \label{table:qda_codes} |
| 629 |
% geographical\\ |
| 630 |
% urgency\\ |
| 631 |
% face-to-face |
| 632 |
% \end{multicols} |
| 633 |
% \hrule |
| 634 |
% } |
| 635 |
% \end{table} |
| 636 |
% |
| 637 |
% \subsubsection{Visualisation as a Cloud} |
| 638 |
% |
| 639 |
% Table~\ref{table:qda_codes} illustrates the output from |\ulqdaCloud|. |
| 640 |
% |
| 641 |
% \begin{table}[h] |
| 642 |
% \centering |
| 643 |
% \caption{List of QDA Codes} |
| 644 |
% { |
| 645 |
% \vspace{0.1in} |
| 646 |
% \hrule |
| 647 |
% |
| 648 |
% \label{table:cloud} |
| 649 |
% { |
| 650 |
% \begin{center} |
| 651 |
% \noindent% |
| 652 |
% {\fontsize{7}{10}\selectfont FPGA} |
| 653 |
% {\fontsize{7}{10}\selectfont HW} |
| 654 |
% {\fontsize{7}{10}\selectfont HW attitude to risk} |
| 655 |
% {\fontsize{7}{10}\selectfont HW bias} |
| 656 |
% \raisebox{-1pt}{\fontsize{12}{15}\selectfont HW fear of risk} |
| 657 |
% {\fontsize{7}{10}\selectfont HW focus} |
| 658 |
% {\fontsize{7}{10}\selectfont HW is fixed} |
| 659 |
% {\fontsize{7}{10}\selectfont HW reluctance to design change} |
| 660 |
% \raisebox{-4pt}{\fontsize{24}{27}\selectfont HW vs SW} |
| 661 |
% {\fontsize{7}{10}\selectfont IM} |
| 662 |
% {\fontsize{9}{12}\selectfont IP} |
| 663 |
% {\fontsize{8}{11}\selectfont SQA} |
| 664 |
% {\fontsize{7}{10}\selectfont SW focus} |
| 665 |
% {\fontsize{7}{10}\selectfont SW influence on System Arch} |
| 666 |
% {\fontsize{7}{10}\selectfont SW is changeable} |
| 667 |
% {\fontsize{7}{10}\selectfont SW models} |
| 668 |
% {\fontsize{8}{11}\selectfont SW workarounds} |
| 669 |
% {\fontsize{7}{10}\selectfont adherence to process} |
| 670 |
% {\fontsize{7}{10}\selectfont adverse} |
| 671 |
% {\fontsize{8}{11}\selectfont aggressive schedules} |
| 672 |
% {\fontsize{7}{10}\selectfont agile methods} |
| 673 |
% {\fontsize{7}{10}\selectfont algorithmic software} |
| 674 |
% {\fontsize{7}{10}\selectfont ambition} |
| 675 |
% {\fontsize{7}{10}\selectfont approach to test} |
| 676 |
% {\fontsize{7}{10}\selectfont bring in software expertise early} |
| 677 |
% \raisebox{-5pt}{\fontsize{29}{32}\selectfont business model} |
| 678 |
% \raisebox{-1pt}{\fontsize{11}{14}\selectfont changeability of SW} |
| 679 |
% {\fontsize{8}{11}\selectfont changing market requirements} |
| 680 |
% {\fontsize{8}{11}\selectfont co-location} |
| 681 |
% \raisebox{-1pt}{\fontsize{11}{14}\selectfont communication} |
| 682 |
% {\fontsize{7}{10}\selectfont communications difficulties} |
| 683 |
% {\fontsize{7}{10}\selectfont competitive analysis} |
| 684 |
% \raisebox{-1pt}{\fontsize{12}{15}\selectfont competitiveness} |
| 685 |
% \raisebox{-2pt}{\fontsize{16}{19}\selectfont complexity} |
| 686 |
% {\fontsize{7}{10}\selectfont complexity in SW control code} |
| 687 |
% {\fontsize{8}{11}\selectfont complexity risk} |
| 688 |
% {\fontsize{7}{10}\selectfont confidence} |
| 689 |
% {\fontsize{7}{10}\selectfont constraints} |
| 690 |
% {\fontsize{7}{10}\selectfont consumer electronics} |
| 691 |
% {\fontsize{7}{10}\selectfont control software} |
| 692 |
% {\fontsize{9}{12}\selectfont cost of changing HW} |
| 693 |
% {\fontsize{8}{11}\selectfont cost of test} |
| 694 |
% {\fontsize{8}{11}\selectfont cost of wrong HW} |
| 695 |
% {\fontsize{8}{11}\selectfont cost-benefit of process} |
| 696 |
% {\fontsize{7}{10}\selectfont cross-functional} |
| 697 |
% \raisebox{-5pt}{\fontsize{28}{31}\selectfont culture} |
| 698 |
% {\fontsize{7}{10}\selectfont design modelling} |
| 699 |
% {\fontsize{7}{10}\selectfont dimensioning HW} |
| 700 |
% {\fontsize{7}{10}\selectfont early prototype} |
| 701 |
% {\fontsize{7}{10}\selectfont engineers over-simplify} |
| 702 |
% {\fontsize{9}{12}\selectfont experience} |
| 703 |
% {\fontsize{9}{12}\selectfont fabless} |
| 704 |
% {\fontsize{7}{10}\selectfont face to face} |
| 705 |
% {\fontsize{7}{10}\selectfont false perception} |
| 706 |
% {\fontsize{7}{10}\selectfont fluid specifications} |
| 707 |
% {\fontsize{7}{10}\selectfont focus} |
| 708 |
% {\fontsize{7}{10}\selectfont freedom to innovate} |
| 709 |
% {\fontsize{8}{11}\selectfont friction} |
| 710 |
% \raisebox{-4pt}{\fontsize{23}{26}\selectfont geographical} |
| 711 |
% {\fontsize{9}{12}\selectfont geographical mitigation} |
| 712 |
% {\fontsize{7}{10}\selectfont geographical more impact than technical} |
| 713 |
% {\fontsize{7}{10}\selectfont greatest impact} |
| 714 |
% {\fontsize{8}{11}\selectfont gsd} |
| 715 |
% {\fontsize{7}{10}\selectfont gsd mitigation} |
| 716 |
% {\fontsize{9}{12}\selectfont hardware} |
| 717 |
% {\fontsize{7}{10}\selectfont implementation} |
| 718 |
% {\fontsize{7}{10}\selectfont importance of cross-functional skills} |
| 719 |
% {\fontsize{10}{13}\selectfont importance of face to face} |
| 720 |
% {\fontsize{7}{10}\selectfont inadequate testing} |
| 721 |
% {\fontsize{7}{10}\selectfont incidental is most important} |
| 722 |
% {\fontsize{7}{10}\selectfont incidental knowledge} |
| 723 |
% {\fontsize{7}{10}\selectfont informal chats} |
| 724 |
% {\fontsize{9}{12}\selectfont information sharing} |
| 725 |
% {\fontsize{7}{10}\selectfont internalising} |
| 726 |
% {\fontsize{7}{10}\selectfont keep SW model in sync with HW} |
| 727 |
% {\fontsize{8}{11}\selectfont lack of mixed design skills} |
| 728 |
% {\fontsize{7}{10}\selectfont learning curve} |
| 729 |
% {\fontsize{7}{10}\selectfont limitations of SW models} |
| 730 |
% {\fontsize{7}{10}\selectfont management} |
| 731 |
% {\fontsize{7}{10}\selectfont market analysis} |
| 732 |
% {\fontsize{7}{10}\selectfont market change} |
| 733 |
% {\fontsize{7}{10}\selectfont market risk} |
| 734 |
% \raisebox{-1pt}{\fontsize{11}{14}\selectfont market window} |
| 735 |
% {\fontsize{8}{11}\selectfont methodology} |
| 736 |
% \raisebox{-1pt}{\fontsize{13}{16}\selectfont mindset gap} |
| 737 |
% {\fontsize{9}{12}\selectfont mitigation} |
| 738 |
% {\fontsize{7}{10}\selectfont moving SW into HW} |
| 739 |
% {\fontsize{7}{10}\selectfont moving schedule} |
| 740 |
% {\fontsize{7}{10}\selectfont moving software into hardware} |
| 741 |
% {\fontsize{7}{10}\selectfont multi-disciplinary} |
| 742 |
% {\fontsize{7}{10}\selectfont new platform} |
| 743 |
% {\fontsize{7}{10}\selectfont opportunity for HW change} |
| 744 |
% {\fontsize{7}{10}\selectfont opportunity to change} |
| 745 |
% {\fontsize{7}{10}\selectfont organisation} |
| 746 |
% {\fontsize{7}{10}\selectfont overconfidence} |
| 747 |
% {\fontsize{7}{10}\selectfont perception of other discipline} |
| 748 |
% {\fontsize{9}{12}\selectfont process} |
| 749 |
% {\fontsize{9}{12}\selectfont product specification} |
| 750 |
% {\fontsize{9}{12}\selectfont project inception} |
| 751 |
% {\fontsize{7}{10}\selectfont realtime missing from SW model} |
| 752 |
% {\fontsize{7}{10}\selectfont reluctance to change} |
| 753 |
% {\fontsize{7}{10}\selectfont requires hardware focus} |
| 754 |
% {\fontsize{7}{10}\selectfont resource requirements} |
| 755 |
% {\fontsize{7}{10}\selectfont resource usage analysis} |
| 756 |
% \raisebox{-10pt}{\fontsize{48}{51}\selectfont risk} |
| 757 |
% \raisebox{-1pt}{\fontsize{12}{15}\selectfont risk mitigation} |
| 758 |
% {\fontsize{9}{12}\selectfont schedule} |
| 759 |
% {\fontsize{7}{10}\selectfont schedule impact} |
| 760 |
% \raisebox{-2pt}{\fontsize{17}{20}\selectfont social} |
| 761 |
% {\fontsize{8}{11}\selectfont social familiarity} |
| 762 |
% {\fontsize{7}{10}\selectfont social risk} |
| 763 |
% {\fontsize{8}{11}\selectfont social tools} |
| 764 |
% {\fontsize{10}{13}\selectfont software} |
| 765 |
% {\fontsize{8}{11}\selectfont specialisation} |
| 766 |
% {\fontsize{7}{10}\selectfont specifying HW resources} |
| 767 |
% {\fontsize{7}{10}\selectfont system resources} |
| 768 |
% {\fontsize{8}{11}\selectfont system understanding} |
| 769 |
% {\fontsize{7}{10}\selectfont tapeout set by hardware} |
| 770 |
% {\fontsize{7}{10}\selectfont team building} |
| 771 |
% \raisebox{-2pt}{\fontsize{16}{19}\selectfont technical} |
| 772 |
% {\fontsize{8}{11}\selectfont technical determinism} |
| 773 |
% {\fontsize{8}{11}\selectfont technical language barrier} |
| 774 |
% {\fontsize{8}{11}\selectfont techno-geographical split} |
| 775 |
% {\fontsize{8}{11}\selectfont telecoms} |
| 776 |
% {\fontsize{7}{10}\selectfont test code sharing} |
| 777 |
% {\fontsize{7}{10}\selectfont testing HW without final SW} |
| 778 |
% {\fontsize{7}{10}\selectfont time to market} |
| 779 |
% {\fontsize{7}{10}\selectfont tool problems} |
| 780 |
% {\fontsize{7}{10}\selectfont tools} |
| 781 |
% {\fontsize{7}{10}\selectfont underestimate learning curve} |
| 782 |
% {\fontsize{7}{10}\selectfont unedited} |
| 783 |
% {\fontsize{8}{11}\selectfont validation} |
| 784 |
% {\fontsize{7}{10}\selectfont value in test bench} |
| 785 |
% {\fontsize{7}{10}\selectfont value of SW models} |
| 786 |
% {\fontsize{7}{10}\selectfont value of reference platforms} |
| 787 |
% \raisebox{-1pt}{\fontsize{14}{17}\selectfont verification} |
| 788 |
% {\fontsize{7}{10}\selectfont verification risk} |
| 789 |
% {\fontsize{7}{10}\selectfont verify SW without HW} |
| 790 |
% {\fontsize{7}{10}\selectfont visibility} |
| 791 |
% {\fontsize{7}{10}\selectfont weight of HW risk} |
| 792 |
% {\fontsize{7}{10}\selectfont workaround} |
| 793 |
% \end{center} |
| 794 |
% |
| 795 |
% } |
| 796 |
% \hrule |
| 797 |
% } |
| 798 |
% \end{table} |
| 799 |
% |
| 800 |
% |
| 801 |
% \subsubsection{Visualisation as Graphs} |
| 802 |
% Figure~\ref{figure:viz} shows the visualisation output possible from \ulQda: |
| 803 |
% \begin{itemize} |
| 804 |
% \item figure~\ref{figure:viz:flat} shows the image created using\\ |
| 805 |
% |\ulqdaGraph{flat}{neato,mathmode,|\\ |
| 806 |
% | options={--graphstyle "scale=0.5,transform shape"}}| |
| 807 |
% \item figure~\ref{figure:viz:net} shows the image created using\\ |
| 808 |
% |\ulqdaGraph{net}{neato,mathmode,|\\ |
| 809 |
% | options={--graphstyle "scale=0.5,transform shape"}}|. |
| 810 |
% \end{itemize} |
| 811 |
% |
| 812 |
% \newsavebox{\tikzPicSaveBoxA} |
| 813 |
% \begin{lrbox}{\tikzPicSaveBoxA} |
| 814 |
% \begin{tikzpicture}[>=latex,join=bevel,scale=0.475] |
| 815 |
% |
| 816 |
% \definecolor{strokecolor}{rgb}{1.0,0.87,0.0}; |
| 817 |
% \definecolor{fillcolor}{rgb}{1.0,0.87,0.0}; |
| 818 |
% \node (Nodeda9c4808fb21d754e6a31daf84d13bbf43182dc5) at (384bp,42bp) [draw=strokecolor,fill=fillcolor,ellipse] {$urgency$}; |
| 819 |
% \definecolor{strokecolor}{rgb}{0.54,0.67,0.83}; |
| 820 |
% \definecolor{fillcolor}{rgb}{0.54,0.67,0.83}; |
| 821 |
% \node (Node794199e201fec00805136c03a2f6517444e1d073) at (491bp,282bp) [draw=strokecolor,fill=fillcolor,ellipse] {$face-to-face$}; |
| 822 |
% \definecolor{strokecolor}{rgb}{0.83,0.0,0.0}; |
| 823 |
% \definecolor{fillcolor}{rgb}{0.83,0.0,0.0}; |
| 824 |
% \node (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83) at (266bp,162bp) [draw=strokecolor,fill=fillcolor,ellipse] {$geographical$}; |
| 825 |
% |
| 826 |
% \end{tikzpicture} |
| 827 |
% \end{lrbox} |
| 828 |
% |
| 829 |
% \newsavebox{\tikzPicSaveBoxB} |
| 830 |
% \begin{lrbox}{\tikzPicSaveBoxB} |
| 831 |
% \begin{tikzpicture}[>=latex,join=bevel,scale=0.475] |
| 832 |
% |
| 833 |
% \definecolor{strokecolor}{rgb}{1.0,0.87,0.0}; |
| 834 |
% \definecolor{fillcolor}{rgb}{1.0,0.87,0.0}; |
| 835 |
% \node (Nodeda9c4808fb21d754e6a31daf84d13bbf43182dc5) at (356bp,299bp) [draw=strokecolor,fill=fillcolor,ellipse] {$urgency$}; |
| 836 |
% \definecolor{strokecolor}{rgb}{0.54,0.67,0.83}; |
| 837 |
% \definecolor{fillcolor}{rgb}{0.54,0.67,0.83}; |
| 838 |
% \node (Node794199e201fec00805136c03a2f6517444e1d073) at (217bp,42bp) [draw=strokecolor,fill=fillcolor,ellipse] {$face-to-face$}; |
| 839 |
% \definecolor{strokecolor}{rgb}{0.83,0.0,0.0}; |
| 840 |
% \definecolor{fillcolor}{rgb}{0.83,0.0,0.0}; |
| 841 |
% \node (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83) at (266bp,181bp) [draw=strokecolor,fill=fillcolor,ellipse] {$geographical$}; |
| 842 |
% \draw [->] (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83) ..controls (240bp,108bp) and (238bp,101bp) .. (Node794199e201fec00805136c03a2f6517444e1d073); |
| 843 |
% \draw [->] (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83) ..controls (317bp,247bp) and (318bp,249bp) .. (Nodeda9c4808fb21d754e6a31daf84d13bbf43182dc5); |
| 844 |
% |
| 845 |
% \end{tikzpicture} |
| 846 |
% \end{lrbox} |
| 847 |
% |
| 848 |
% \begin{figure}[h] |
| 849 |
% \centering |
| 850 |
% \subfigure[Flat Graph] |
| 851 |
% { |
| 852 |
% \fbox{\usebox{\tikzPicSaveBoxA}} |
| 853 |
% \label{figure:viz:flat} |
| 854 |
% } |
| 855 |
% \hspace{0.5cm} |
| 856 |
% \subfigure[Hierarchical Graph with Connections] |
| 857 |
% { |
| 858 |
% \fbox{\usebox{\tikzPicSaveBoxB}} |
| 859 |
% \label{figure:viz:net} |
| 860 |
% } |
| 861 |
% \caption{Visualisation through GraphViz} |
| 862 |
% \label{figure:viz} |
| 863 |
% \end{figure} |
| 864 |
% |
| 865 |
% Figure~\ref{figure:complex} shows a more complex visualisation generated from |
| 866 |
% a more comprehensive set of coding. |
| 867 |
% |
| 868 |
% |
| 869 |
% \newsavebox{\tikzPicSaveBoxComplex} |
| 870 |
% \begin{lrbox}{\tikzPicSaveBoxComplex} |
| 871 |
% \begin{tikzpicture}[>=latex,join=bevel,scale=0.11,transform shape] |
| 872 |
% \definecolor{strokecolor}{rgb}{0.64,0.73,0.88}; |
| 873 |
% \definecolor{fillcolor}{rgb}{0.64,0.73,0.88}; |
| 874 |
% \node (Node11907eb81526a671b74e000ef5abaffc932081ec) at (2584bp,1925bp) [draw=strokecolor,fill=fillcolor,ellipse] {$new platform$}; |
| 875 |
% \definecolor{strokecolor}{rgb}{0.54,0.67,0.83}; |
| 876 |
% \definecolor{fillcolor}{rgb}{0.54,0.67,0.83}; |
| 877 |
% \node (Node24da2349705267e0db51531c0958413a9556e1a4) at (3277bp,2001bp) [draw=strokecolor,fill=fillcolor,ellipse] {$SW influence on System Arch$}; |
| 878 |
% \definecolor{strokecolor}{rgb}{0.83,0.0,0.0}; |
| 879 |
% \definecolor{fillcolor}{rgb}{0.83,0.0,0.0}; |
| 880 |
% \node (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83) at (2540bp,875bp) [draw=strokecolor,fill=fillcolor,ellipse] {$geographical$}; |
| 881 |
% \definecolor{strokecolor}{rgb}{0.45,0.6,0.78}; |
| 882 |
% \definecolor{fillcolor}{rgb}{0.45,0.6,0.78}; |
| 883 |
% \node (Node0284c6ac58cb47bb52e427007beee58e0132bf71) at (2255bp,2459bp) [draw=strokecolor,fill=fillcolor,ellipse] {$tools$}; |
| 884 |
% \definecolor{strokecolor}{rgb}{0.38,0.86,0.41}; |
| 885 |
% \definecolor{fillcolor}{rgb}{0.38,0.86,0.41}; |
| 886 |
% \node (Nodeffddae94a489d364c14bfa0bc20509be9bbd52cd) at (2192bp,1739bp) [draw=strokecolor,fill=fillcolor,ellipse] {$resource requirements$}; |
| 887 |
% \definecolor{strokecolor}{rgb}{0.73,0.8,0.93}; |
| 888 |
% \definecolor{fillcolor}{rgb}{0.73,0.8,0.93}; |
| 889 |
% \node (Node857a3f01adebeadc2e3233e182485ad98fa4808b) at (2992bp,817bp) [draw=strokecolor,fill=fillcolor,ellipse] {$telecoms$}; |
| 890 |
% \definecolor{strokecolor}{rgb}{0.73,0.8,0.93}; |
| 891 |
% \definecolor{fillcolor}{rgb}{0.73,0.8,0.93}; |
| 892 |
% \node (Nodee5ddf0cf596bc85b1d76e20d573522ab30c52dde) at (2696bp,3435bp) [draw=strokecolor,fill=fillcolor,ellipse] {$ambition$}; |
| 893 |
% \definecolor{strokecolor}{rgb}{0.18,0.19,0.57}; |
| 894 |
% \definecolor{fillcolor}{rgb}{0.18,0.19,0.57}; |
| 895 |
% \node (Node6c912f1b9ece5fbfec963302cf1a6fcc1f72b641) at (2224bp,2906bp) [draw=strokecolor,fill=fillcolor,ellipse] {$early prototype$}; |
| 896 |
% \definecolor{strokecolor}{rgb}{1.0,0.87,0.0}; |
| 897 |
% \definecolor{fillcolor}{rgb}{1.0,0.87,0.0}; |
| 898 |
% \node (Node6bee1484bea1868299e58f40683ab3093d319d44) at (94bp,1678bp) [draw=strokecolor,fill=fillcolor,ellipse] {$fluid specifications$}; |
| 899 |
% \definecolor{strokecolor}{rgb}{0.54,0.67,0.83}; |
| 900 |
% \definecolor{fillcolor}{rgb}{0.54,0.67,0.83}; |
| 901 |
% \node (Node13308f22bf33c24028a7196eaf01645c5dc63056) at (3361bp,2311bp) [draw=strokecolor,fill=fillcolor,ellipse] {$moving SW into HW$}; |
| 902 |
% \definecolor{strokecolor}{rgb}{0.96,0.49,0.0}; |
| 903 |
% \definecolor{fillcolor}{rgb}{0.96,0.49,0.0}; |
| 904 |
% \node (Node0c18da7ce026bae350e071f9c9892f47854755f8) at (2269bp,3106bp) [draw=strokecolor,fill=fillcolor,ellipse] {$market window$}; |
| 905 |
% \definecolor{strokecolor}{rgb}{0.98,0.66,0.0}; |
| 906 |
% \definecolor{fillcolor}{rgb}{0.98,0.66,0.0}; |
| 907 |
% \node (Node0dbe529c4dfad996667815f32902cb3a2b94c94f) at (2922bp,1310bp) [draw=strokecolor,fill=fillcolor,ellipse] {$social$}; |
| 908 |
% \definecolor{strokecolor}{rgb}{0.18,0.19,0.57}; |
| 909 |
% \definecolor{fillcolor}{rgb}{0.18,0.19,0.57}; |
| 910 |
% \node (Noded1c21a4e5a354fe40e70739ba19c1ffda65b3e90) at (1884bp,3479bp) [draw=strokecolor,fill=fillcolor,ellipse] {$consumer electronics$}; |
| 911 |
% \definecolor{strokecolor}{rgb}{0.34,0.46,0.71}; |
| 912 |
% \definecolor{fillcolor}{rgb}{0.34,0.46,0.71}; |
| 913 |
% \node (Node7febc4b16f23adf0fbe705a72b1e920a5f79d8e4) at (2485bp,20bp) [draw=strokecolor,fill=fillcolor,ellipse] {$team building$}; |
| 914 |
% \definecolor{strokecolor}{rgb}{0.67,0.91,0.0}; |
| 915 |
% \definecolor{fillcolor}{rgb}{0.67,0.91,0.0}; |
| 916 |
% \node (Node12f73a5a4f409d241325ddb50d658c993327e9d7) at (2183bp,1175bp) [draw=strokecolor,fill=fillcolor,ellipse] {$overconfidence$}; |
| 917 |
% \definecolor{strokecolor}{rgb}{1.0,0.87,0.0}; |
| 918 |
% \definecolor{fillcolor}{rgb}{1.0,0.87,0.0}; |
| 919 |
% \node (Node546a0042646239cb2b8f5a48ede17044a7ef1890) at (2236bp,3563bp) [draw=strokecolor,fill=fillcolor,ellipse] {$changing market requirements$}; |
| 920 |
% \definecolor{strokecolor}{rgb}{1.0,0.75,0.0}; |
| 921 |
% \definecolor{fillcolor}{rgb}{1.0,0.75,0.0}; |
| 922 |
% \node (Node11e9ba26c91a2db7452a5ef9ff7051e19b6b377a) at (2614bp,2520bp) [draw=strokecolor,fill=fillcolor,ellipse] {$schedule$}; |
| 923 |
% \definecolor{strokecolor}{rgb}{0.45,0.6,0.78}; |
| 924 |
% \definecolor{fillcolor}{rgb}{0.45,0.6,0.78}; |
| 925 |
% \node (Node957782c35eec7c1b95eaa3e080b7aa97d7d641d9) at (2317bp,3716bp) [draw=strokecolor,fill=fillcolor,ellipse] {$competitive analysis$}; |
| 926 |
% \definecolor{strokecolor}{rgb}{0.73,0.8,0.93}; |
| 927 |
% \definecolor{fillcolor}{rgb}{0.73,0.8,0.93}; |
| 928 |
% \node (Nodeccabe2fccfc9d7d6adf8e0c37a8f794e0f70b66e) at (879bp,1144bp) [draw=strokecolor,fill=fillcolor,ellipse] {$cost of changing HW$}; |
| 929 |
% \definecolor{strokecolor}{rgb}{1.0,0.87,0.0}; |
| 930 |
% \definecolor{fillcolor}{rgb}{1.0,0.87,0.0}; |
| 931 |
% \node (Node1e7fceb82d739fd04658161f3e37ad7f866b317f) at (284bp,1371bp) [draw=strokecolor,fill=fillcolor,ellipse] {$fluid requirements$}; |
| 932 |
% \definecolor{strokecolor}{rgb}{0.45,0.6,0.78}; |
| 933 |
% \definecolor{fillcolor}{rgb}{0.45,0.6,0.78}; |
| 934 |
% \node (Node797efd83f8c15deef7f4d4762a8c92d8b5a9305f) at (2242bp,1365bp) [draw=strokecolor,fill=fillcolor,ellipse] {$implementation$}; |
| 935 |
% \definecolor{strokecolor}{rgb}{0.96,0.49,0.0}; |
| 936 |
% \definecolor{fillcolor}{rgb}{0.96,0.49,0.0}; |
| 937 |
% \node (Node2d5665952d74d765d3aad8ab414f96fe4dc51db9) at (2544bp,320bp) [draw=strokecolor,fill=fillcolor,ellipse] {$importance of face to face$}; |
| 938 |
% \definecolor{strokecolor}{rgb}{0.89,0.35,0.14}; |
| 939 |
% \definecolor{fillcolor}{rgb}{0.89,0.35,0.14}; |
| 940 |
% \node (Node9fa7f61fda21f51c481ba3721c0f072e33d2abc0) at (2103bp,3328bp) [draw=strokecolor,fill=fillcolor,ellipse] {$business model$}; |
| 941 |
% \definecolor{strokecolor}{rgb}{0.98,0.66,0.0}; |
| 942 |
% \definecolor{fillcolor}{rgb}{0.98,0.66,0.0}; |
| 943 |
% \node (Node925b4271c1d7533eb2d3cb2154cfec4eb06734cf) at (730bp,1710bp) [draw=strokecolor,fill=fillcolor,ellipse] {$changeability of SW$}; |
| 944 |
% \definecolor{strokecolor}{rgb}{1.0,0.87,0.0}; |
| 945 |
% \definecolor{fillcolor}{rgb}{1.0,0.87,0.0}; |
| 946 |
% \node (Nodec339980f75d565d568bed4943192f865402a85e2) at (3032bp,574bp) [draw=strokecolor,fill=fillcolor,ellipse] {$techno-geographical split$}; |
| 947 |
% \definecolor{strokecolor}{rgb}{0.64,0.73,0.88}; |
| 948 |
% \definecolor{fillcolor}{rgb}{0.64,0.73,0.88}; |
| 949 |
% \node (Node70ef4adb6243a8757f5ac77a5cae9a726f406b98) at (2771bp,549bp) [draw=strokecolor,fill=fillcolor,ellipse] {$visibility$}; |
| 950 |
% \definecolor{strokecolor}{rgb}{0.83,0.0,0.0}; |
| 951 |
% \definecolor{fillcolor}{rgb}{0.83,0.0,0.0}; |
| 952 |
% \node (Node60944e5702bdafb74ec9614120a88bdfa7084da0) at (2909bp,2152bp) [draw=strokecolor,fill=fillcolor,ellipse] {$technical$}; |
| 953 |
% \definecolor{strokecolor}{rgb}{0.18,0.19,0.57}; |
| 954 |
% \definecolor{fillcolor}{rgb}{0.18,0.19,0.57}; |
| 955 |
% \node (Noded69683190ac95b492b7f1c19873463ff73c222fd) at (3372bp,1536bp) [draw=strokecolor,fill=fillcolor,ellipse] {$web tools$}; |
| 956 |
% \definecolor{strokecolor}{rgb}{0.38,0.86,0.41}; |
| 957 |
% \definecolor{fillcolor}{rgb}{0.38,0.86,0.41}; |
| 958 |
% \node (Nodeb99f24955c90296fabf855bb4d54929a3fef70e1) at (1384bp,3260bp) [draw=strokecolor,fill=fillcolor,ellipse] {$HW fear of risk$}; |
| 959 |
% \definecolor{strokecolor}{rgb}{0.0,0.02,0.45}; |
| 960 |
% \definecolor{fillcolor}{rgb}{0.0,0.02,0.45}; |
| 961 |
% \node (Node74d940dd3e717faa542bf612d28ec2542b71e963) at (3409bp,2124bp) [draw=strokecolor,fill=fillcolor,ellipse] {$communiction$}; |
| 962 |
% \definecolor{strokecolor}{rgb}{0.98,0.66,0.0}; |
| 963 |
% \definecolor{fillcolor}{rgb}{0.98,0.66,0.0}; |
| 964 |
% \node (Node0172079aee21a5d804c9c2bd1ddb9261cfebb67e) at (739bp,2387bp) [draw=strokecolor,fill=fillcolor,ellipse] {$lack of mixed design skills$}; |
| 965 |
% \definecolor{strokecolor}{rgb}{0.83,0.0,0.0}; |
| 966 |
% \definecolor{fillcolor}{rgb}{0.83,0.0,0.0}; |
| 967 |
% \node (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) at (1533bp,2059bp) [draw=strokecolor,fill=fillcolor,ellipse] {$risk$}; |
| 968 |
% \definecolor{strokecolor}{rgb}{0.83,0.0,0.0}; |
| 969 |
% \definecolor{fillcolor}{rgb}{0.83,0.0,0.0}; |
| 970 |
% \node (Node4ab18acd3552592a0877a68a8e1c3494f03de7e5) at (2853bp,2659bp) [draw=strokecolor,fill=fillcolor,ellipse] {$HW vs SW$}; |
| 971 |
% \definecolor{strokecolor}{rgb}{0.27,0.33,0.64}; |
| 972 |
% \definecolor{fillcolor}{rgb}{0.27,0.33,0.64}; |
| 973 |
% \node (Node9dc7651df0059af282ea6decf914838ca28b8d42) at (948bp,2914bp) [draw=strokecolor,fill=fillcolor,ellipse] {$multi-disciplinary$}; |
| 974 |
% \definecolor{strokecolor}{rgb}{0.27,0.33,0.64}; |
| 975 |
% \definecolor{fillcolor}{rgb}{0.27,0.33,0.64}; |
| 976 |
% \node (Nodef90836d07f1e94806617725784c78e4e89824127) at (3314bp,2923bp) [draw=strokecolor,fill=fillcolor,ellipse] {$mindset gap$}; |
| 977 |
% \definecolor{strokecolor}{rgb}{0.89,0.35,0.14}; |
| 978 |
% \definecolor{fillcolor}{rgb}{0.89,0.35,0.14}; |
| 979 |
% \node (Node8d08946e603eb0277964f9dffb00266975512736) at (2369bp,2085bp) [draw=strokecolor,fill=fillcolor,ellipse] {$complexity$}; |
| 980 |
% \definecolor{strokecolor}{rgb}{0.45,0.6,0.78}; |
| 981 |
% \definecolor{fillcolor}{rgb}{0.45,0.6,0.78}; |
| 982 |
% \node (Node31aa07dda877d5f74de19f680f75d754866e74c6) at (2388bp,490bp) [draw=strokecolor,fill=fillcolor,ellipse] {$perception of other discipline$}; |
| 983 |
% \definecolor{strokecolor}{rgb}{0.54,0.67,0.83}; |
| 984 |
% \definecolor{fillcolor}{rgb}{0.54,0.67,0.83}; |
| 985 |
% \node (Nodea9c032d95328db0ae1261c3c14d81e3a192f41c8) at (3214bp,2421bp) [draw=strokecolor,fill=fillcolor,ellipse] {$project inception$}; |
| 986 |
% \definecolor{strokecolor}{rgb}{0.38,0.86,0.41}; |
| 987 |
% \definecolor{fillcolor}{rgb}{0.38,0.86,0.41}; |
| 988 |
% \node (Node7220917c7baf0d5b494b0211e77b5fd59fb11dd7) at (1148bp,3106bp) [draw=strokecolor,fill=fillcolor,ellipse] {$SW is changeable$}; |
| 989 |
% \definecolor{strokecolor}{rgb}{0.89,0.35,0.14}; |
| 990 |
% \definecolor{fillcolor}{rgb}{0.89,0.35,0.14}; |
| 991 |
% \node (Node8f2e7cd784967d6a79abd59093146fb1f82e336d) at (2836bp,3076bp) [draw=strokecolor,fill=fillcolor,ellipse] {$culture$}; |
| 992 |
% \definecolor{strokecolor}{rgb}{1.0,0.75,0.0}; |
| 993 |
% \definecolor{fillcolor}{rgb}{1.0,0.75,0.0}; |
| 994 |
% \node (Node60c58ad2ef34d96fae028f1039fab03dec9eb9a2) at (3052bp,1616bp) [draw=strokecolor,fill=fillcolor,ellipse] {$communication$}; |
| 995 |
% \definecolor{strokecolor}{rgb}{0.38,0.86,0.41}; |
| 996 |
% \definecolor{fillcolor}{rgb}{0.38,0.86,0.41}; |
| 997 |
% \node (Node94fe47c6f608bbd655277e4abb947276a838f03f) at (2501bp,2809bp) [draw=strokecolor,fill=fillcolor,ellipse] {$greatest impact$}; |
| 998 |
% \definecolor{strokecolor}{rgb}{1.0,0.75,0.0}; |
| 999 |
% \definecolor{fillcolor}{rgb}{1.0,0.75,0.0}; |
| 1000 |
% \node (Node608cb271bb7fb52c99a1a8e003e0f80f57fb41e1) at (2083bp,1468bp) [draw=strokecolor,fill=fillcolor,ellipse] {$hardware$}; |
| 1001 |
% \definecolor{strokecolor}{rgb}{0.67,0.91,0.0}; |
| 1002 |
% \definecolor{fillcolor}{rgb}{0.67,0.91,0.0}; |
| 1003 |
% \node (Node179d813443470b5b4f03fae7eb20a074374b8749) at (3245bp,381bp) [draw=strokecolor,fill=fillcolor,ellipse] {$importance of cross-functional skills$}; |
| 1004 |
% \definecolor{strokecolor}{rgb}{0.27,0.33,0.64}; |
| 1005 |
% \definecolor{fillcolor}{rgb}{0.27,0.33,0.64}; |
| 1006 |
% \node (Node982d46d22d9597c30d79d368dc9197f5f1fe5956) at (2049bp,2167bp) [draw=strokecolor,fill=fillcolor,ellipse] {$management$}; |
| 1007 |
% \definecolor{strokecolor}{rgb}{0.73,0.8,0.93}; |
| 1008 |
% \definecolor{fillcolor}{rgb}{0.73,0.8,0.93}; |
| 1009 |
% \node (Node5e705951b3b2e85110d0d9edbca689b733f70893) at (1520bp,1353bp) [draw=strokecolor,fill=fillcolor,ellipse] {$methodology$}; |
| 1010 |
% \definecolor{strokecolor}{rgb}{0.27,0.33,0.64}; |
| 1011 |
% \definecolor{fillcolor}{rgb}{0.27,0.33,0.64}; |
| 1012 |
% \node (Nodea8488a1ffe30feefab69c6c99b92d74d6c36cf8d) at (2496bp,2311bp) [draw=strokecolor,fill=fillcolor,ellipse] {$underestimate learning curve$}; |
| 1013 |
% \definecolor{strokecolor}{rgb}{0.96,0.49,0.0}; |
| 1014 |
% \definecolor{fillcolor}{rgb}{0.96,0.49,0.0}; |
| 1015 |
% \node (Node0998cfed6ab699469c4465f74e75ec25367429d2) at (1865bp,3201bp) [draw=strokecolor,fill=fillcolor,ellipse] {$specialisation$}; |
| 1016 |
% \definecolor{strokecolor}{rgb}{0.18,0.19,0.57}; |
| 1017 |
% \definecolor{fillcolor}{rgb}{0.18,0.19,0.57}; |
| 1018 |
% \node (Nodedf14d801e4a359538f6a17654a1214fbc660c5ea) at (2153bp,490bp) [draw=strokecolor,fill=fillcolor,ellipse] {$informal communication$}; |
| 1019 |
% \definecolor{strokecolor}{rgb}{0.34,0.46,0.71}; |
| 1020 |
% \definecolor{fillcolor}{rgb}{0.34,0.46,0.71}; |
| 1021 |
% \node (Node65279e1ecf00d0d1177a5b3b458fd187a1d6135e) at (784bp,2685bp) [draw=strokecolor,fill=fillcolor,ellipse] {$verification$}; |
| 1022 |
% \definecolor{strokecolor}{rgb}{0.96,0.49,0.0}; |
| 1023 |
% \definecolor{fillcolor}{rgb}{0.96,0.49,0.0}; |
| 1024 |
% \node (Noded13b43f47c02e2d62f12116b4d6f2da47c8b0604) at (2184bp,866bp) [draw=strokecolor,fill=fillcolor,ellipse] {$mitigation$}; |
| 1025 |
% \definecolor{strokecolor}{rgb}{0.0,0.02,0.45}; |
| 1026 |
% \definecolor{fillcolor}{rgb}{0.0,0.02,0.45}; |
| 1027 |
% \node (Nodeb6e2fb5d60ebce8f644ef0eda9117caf6060247e) at (199bp,2027bp) [draw=strokecolor,fill=fillcolor,ellipse] {$inadequate testing$}; |
| 1028 |
% \definecolor{strokecolor}{rgb}{0.67,0.91,0.0}; |
| 1029 |
% \definecolor{fillcolor}{rgb}{0.67,0.91,0.0}; |
| 1030 |
% \node (Nodec2e2d6621334dc890bbd8a69430012c45a83bf65) at (1384bp,1373bp) [draw=strokecolor,fill=fillcolor,ellipse] {$process$}; |
| 1031 |
% \definecolor{strokecolor}{rgb}{0.34,0.46,0.71}; |
| 1032 |
% \definecolor{fillcolor}{rgb}{0.34,0.46,0.71}; |
| 1033 |
% \node (Node0165688353ca81071fdec1551c4ab96a2db65e88) at (3094bp,3367bp) [draw=strokecolor,fill=fillcolor,ellipse] {$confidence$}; |
| 1034 |
% \definecolor{strokecolor}{rgb}{0.54,0.67,0.83}; |
| 1035 |
% \definecolor{fillcolor}{rgb}{0.54,0.67,0.83}; |
| 1036 |
% \node (Nodeb93db90c74e59cca2710bbedbc56911482d72d3d) at (1923bp,1750bp) [draw=strokecolor,fill=fillcolor,ellipse] {$constraints$}; |
| 1037 |
% \definecolor{strokecolor}{rgb}{0.89,0.35,0.14}; |
| 1038 |
% \definecolor{fillcolor}{rgb}{0.89,0.35,0.14}; |
| 1039 |
% \node (Nodec981d125d1a564c9f5738faff51d59d98711f145) at (447bp,1733bp) [draw=strokecolor,fill=fillcolor,ellipse] {$software$}; |
| 1040 |
% \definecolor{strokecolor}{rgb}{0.64,0.73,0.88}; |
| 1041 |
% \definecolor{fillcolor}{rgb}{0.64,0.73,0.88}; |
| 1042 |
% \node (Node4d673c70f72c7f14606e048e062febb769b26b24) at (2081bp,2375bp) [draw=strokecolor,fill=fillcolor,ellipse] {$engineers over-simplify$}; |
| 1043 |
% \definecolor{strokecolor}{rgb}{1.0,0.75,0.0}; |
| 1044 |
% \definecolor{fillcolor}{rgb}{1.0,0.75,0.0}; |
| 1045 |
% \node (Nodedec8c6d379be0cb7cedbbe003f1b1f3671310f5c) at (1870bp,696bp) [draw=strokecolor,fill=fillcolor,ellipse] {$geographical mitigation$}; |
| 1046 |
% \definecolor{strokecolor}{rgb}{0.0,0.02,0.45}; |
| 1047 |
% \definecolor{fillcolor}{rgb}{0.0,0.02,0.45}; |
| 1048 |
% \node (Noded269766c1379693221ae73919ceb24643aab8e13) at (2472bp,3077bp) [draw=strokecolor,fill=fillcolor,ellipse] {$aggressive schedules$}; |
| 1049 |
% \draw [->] (Node608cb271bb7fb52c99a1a8e003e0f80f57fb41e1) ..controls (2139bp,1432bp) and (2178bp,1407bp) .. (Node797efd83f8c15deef7f4d4762a8c92d8b5a9305f); |
| 1050 |
% \draw [->] (Node0c18da7ce026bae350e071f9c9892f47854755f8) ..controls (2256bp,3045bp) and (2240bp,2975bp) .. (Node6c912f1b9ece5fbfec963302cf1a6fcc1f72b641); |
| 1051 |
% \draw [->] (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) ..controls (1256bp,1939bp) and (920bp,1792bp) .. (Node925b4271c1d7533eb2d3cb2154cfec4eb06734cf); |
| 1052 |
% \draw [->] (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83) ..controls (2497bp,767bp) and (2427bp,589bp) .. (Node31aa07dda877d5f74de19f680f75d754866e74c6); |
| 1053 |
% \draw [->] (Node8f2e7cd784967d6a79abd59093146fb1f82e336d) ..controls (2800bp,3169bp) and (2734bp,3338bp) .. (Nodee5ddf0cf596bc85b1d76e20d573522ab30c52dde); |
| 1054 |
% \draw [->] (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83) ..controls (2689bp,784bp) and (2898bp,656bp) .. (Nodec339980f75d565d568bed4943192f865402a85e2); |
| 1055 |
% \draw [->] (Node60944e5702bdafb74ec9614120a88bdfa7084da0) ..controls (2829bp,2251bp) and (2692bp,2422bp) .. (Node11e9ba26c91a2db7452a5ef9ff7051e19b6b377a); |
| 1056 |
% \draw [->] (Node8d08946e603eb0277964f9dffb00266975512736) ..controls (2323bp,1994bp) and (2240bp,1834bp) .. (Nodeffddae94a489d364c14bfa0bc20509be9bbd52cd); |
| 1057 |
% \draw [->] (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) ..controls (1306bp,2249bp) and (922bp,2569bp) .. (Node65279e1ecf00d0d1177a5b3b458fd187a1d6135e); |
| 1058 |
% \draw [->] (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) ..controls (1868bp,2202bp) and (2404bp,2430bp) .. (Node11e9ba26c91a2db7452a5ef9ff7051e19b6b377a); |
| 1059 |
% \draw [->] (Node9fa7f61fda21f51c481ba3721c0f072e33d2abc0) ..controls (2145bp,3402bp) and (2192bp,3486bp) .. (Node546a0042646239cb2b8f5a48ede17044a7ef1890); |
| 1060 |
% \draw [->] (Nodec981d125d1a564c9f5738faff51d59d98711f145) ..controls (550bp,1724bp) and (583bp,1722bp) .. (Node925b4271c1d7533eb2d3cb2154cfec4eb06734cf); |
| 1061 |
% \draw [->] (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) ..controls (1372bp,2294bp) and (1049bp,2767bp) .. (Node9dc7651df0059af282ea6decf914838ca28b8d42); |
| 1062 |
% \draw [->] (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) ..controls (1498bp,2347bp) and (1407bp,3072bp) .. (Nodeb99f24955c90296fabf855bb4d54929a3fef70e1); |
| 1063 |
% \draw [->] (Nodec339980f75d565d568bed4943192f865402a85e2) ..controls (3096bp,517bp) and (3173bp,446bp) .. (Node179d813443470b5b4f03fae7eb20a074374b8749); |
| 1064 |
% \draw [->] (Node9fa7f61fda21f51c481ba3721c0f072e33d2abc0) ..controls (2156bp,3257bp) and (2213bp,3180bp) .. (Node0c18da7ce026bae350e071f9c9892f47854755f8); |
| 1065 |
% \draw [->] (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83) ..controls (2751bp,849bp) and (2861bp,834bp) .. (Node857a3f01adebeadc2e3233e182485ad98fa4808b); |
| 1066 |
% \draw [->] (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) ..controls (1818bp,2193bp) and (2224bp,2383bp) .. (2570bp,2537bp) .. controls (2639bp,2568bp) and (2717bp,2601bp) .. (Node4ab18acd3552592a0877a68a8e1c3494f03de7e5); |
| 1067 |
% \draw [->] (Node8d08946e603eb0277964f9dffb00266975512736) ..controls (2444bp,2029bp) and (2512bp,1979bp) .. (Node11907eb81526a671b74e000ef5abaffc932081ec); |
| 1068 |
% \draw [->] (Node8f2e7cd784967d6a79abd59093146fb1f82e336d) ..controls (2908bp,3157bp) and (3022bp,3286bp) .. (Node0165688353ca81071fdec1551c4ab96a2db65e88); |
| 1069 |
% \draw [->] (Node546a0042646239cb2b8f5a48ede17044a7ef1890) ..controls (2262bp,3612bp) and (2287bp,3658bp) .. (Node957782c35eec7c1b95eaa3e080b7aa97d7d641d9); |
| 1070 |
% \draw [->] (Nodec981d125d1a564c9f5738faff51d59d98711f145) ..controls (378bp,1814bp) and (269bp,1944bp) .. (Nodeb6e2fb5d60ebce8f644ef0eda9117caf6060247e); |
| 1071 |
% \draw [->] (Node8d08946e603eb0277964f9dffb00266975512736) ..controls (2340bp,2181bp) and (2285bp,2360bp) .. (Node0284c6ac58cb47bb52e427007beee58e0132bf71); |
| 1072 |
% \draw [->] (Node60944e5702bdafb74ec9614120a88bdfa7084da0) ..controls (2942bp,2026bp) and (3017bp,1745bp) .. (Node60c58ad2ef34d96fae028f1039fab03dec9eb9a2); |
| 1073 |
% \draw [->] (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83) ..controls (2429bp,968bp) and (2279bp,1094bp) .. (Node12f73a5a4f409d241325ddb50d658c993327e9d7); |
| 1074 |
% \draw [->] (Node8d08946e603eb0277964f9dffb00266975512736) ..controls (2289bp,2165bp) and (2162bp,2294bp) .. (Node4d673c70f72c7f14606e048e062febb769b26b24); |
| 1075 |
% \draw [->] (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83) ..controls (2642bp,991bp) and (2828bp,1203bp) .. (Node0dbe529c4dfad996667815f32902cb3a2b94c94f); |
| 1076 |
% \draw [->] (Nodeffddae94a489d364c14bfa0bc20509be9bbd52cd) ..controls (2056bp,1744bp) and (2019bp,1746bp) .. (Nodeb93db90c74e59cca2710bbedbc56911482d72d3d); |
| 1077 |
% \draw [->] (Node60944e5702bdafb74ec9614120a88bdfa7084da0) ..controls (3002bp,2234bp) and (3129bp,2346bp) .. (Nodea9c032d95328db0ae1261c3c14d81e3a192f41c8); |
| 1078 |
% \draw [->] (Node0c18da7ce026bae350e071f9c9892f47854755f8) ..controls (2364bp,3092bp) and (2376bp,3091bp) .. (Noded269766c1379693221ae73919ceb24643aab8e13); |
| 1079 |
% \draw [->] (Node60944e5702bdafb74ec9614120a88bdfa7084da0) ..controls (3064bp,2207bp) and (3221bp,2262bp) .. (Node13308f22bf33c24028a7196eaf01645c5dc63056); |
| 1080 |
% \draw [->] (Node8d08946e603eb0277964f9dffb00266975512736) ..controls (2408bp,2155bp) and (2456bp,2239bp) .. (Nodea8488a1ffe30feefab69c6c99b92d74d6c36cf8d); |
| 1081 |
% \draw [->] (Node8f2e7cd784967d6a79abd59093146fb1f82e336d) ..controls (2840bp,2979bp) and (2847bp,2791bp) .. (Node4ab18acd3552592a0877a68a8e1c3494f03de7e5); |
| 1082 |
% \draw [->] (Node60944e5702bdafb74ec9614120a88bdfa7084da0) ..controls (3041bp,2097bp) and (3156bp,2051bp) .. (Node24da2349705267e0db51531c0958413a9556e1a4); |
| 1083 |
% \draw [->] (Node60944e5702bdafb74ec9614120a88bdfa7084da0) ..controls (3104bp,2141bp) and (3246bp,2133bp) .. (Node74d940dd3e717faa542bf612d28ec2542b71e963); |
| 1084 |
% \draw [->] (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) ..controls (1359bp,1817bp) and (990bp,1299bp) .. (Nodeccabe2fccfc9d7d6adf8e0c37a8f794e0f70b66e); |
| 1085 |
% \draw [->] (Node2d5665952d74d765d3aad8ab414f96fe4dc51db9) ..controls (2530bp,244bp) and (2502bp,109bp) .. (Node7febc4b16f23adf0fbe705a72b1e920a5f79d8e4); |
| 1086 |
% \draw [->] (Node9fa7f61fda21f51c481ba3721c0f072e33d2abc0) ..controls (2011bp,3279bp) and (1954bp,3249bp) .. (Node0998cfed6ab699469c4465f74e75ec25367429d2); |
| 1087 |
% \draw [->] (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) ..controls (1183bp,1954bp) and (695bp,1807bp) .. (Nodec981d125d1a564c9f5738faff51d59d98711f145); |
| 1088 |
% \draw [->] (Node608cb271bb7fb52c99a1a8e003e0f80f57fb41e1) ..controls (2109bp,1394bp) and (2153bp,1263bp) .. (Node12f73a5a4f409d241325ddb50d658c993327e9d7); |
| 1089 |
% \draw [->] (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83) ..controls (2431bp,766bp) and (2248bp,584bp) .. (Nodedf14d801e4a359538f6a17654a1214fbc660c5ea); |
| 1090 |
% \draw [->] (Noded13b43f47c02e2d62f12116b4d6f2da47c8b0604) ..controls (2090bp,816bp) and (1981bp,756bp) .. (Nodedec8c6d379be0cb7cedbbe003f1b1f3671310f5c); |
| 1091 |
% \draw [->] (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) ..controls (1687bp,1777bp) and (2078bp,1060bp) .. (Noded13b43f47c02e2d62f12116b4d6f2da47c8b0604); |
| 1092 |
% \draw [->] (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) ..controls (1706bp,1873bp) and (1972bp,1587bp) .. (Node608cb271bb7fb52c99a1a8e003e0f80f57fb41e1); |
| 1093 |
% \draw [->] (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) ..controls (1848bp,2069bp) and (2123bp,2078bp) .. (Node8d08946e603eb0277964f9dffb00266975512736); |
| 1094 |
% \draw [->] (Nodec2e2d6621334dc890bbd8a69430012c45a83bf65) ..controls (1437bp,1365bp) and (1441bp,1365bp) .. (Node5e705951b3b2e85110d0d9edbca689b733f70893); |
| 1095 |
% \draw [->] (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) ..controls (1257bp,2173bp) and (934bp,2307bp) .. (Node0172079aee21a5d804c9c2bd1ddb9261cfebb67e); |
| 1096 |
% \draw [->] (Node60c58ad2ef34d96fae028f1039fab03dec9eb9a2) ..controls (3176bp,1585bp) and (3263bp,1563bp) .. (Noded69683190ac95b492b7f1c19873463ff73c222fd); |
| 1097 |
% \draw [->] (Node60944e5702bdafb74ec9614120a88bdfa7084da0) ..controls (2716bp,2127bp) and (2562bp,2108bp) .. (Node8d08946e603eb0277964f9dffb00266975512736); |
| 1098 |
% \draw [->] (Node0dbe529c4dfad996667815f32902cb3a2b94c94f) ..controls (2955bp,1386bp) and (3012bp,1522bp) .. (Node60c58ad2ef34d96fae028f1039fab03dec9eb9a2); |
| 1099 |
% \draw [->] (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83) ..controls (2541bp,741bp) and (2543bp,451bp) .. (Node2d5665952d74d765d3aad8ab414f96fe4dc51db9); |
| 1100 |
% \draw [->] (Node11a110bbef1bcc07ee6b72c48ab5c5b21afbab91) ..controls (1436bp,2324bp) and (1211bp,2934bp) .. (Node7220917c7baf0d5b494b0211e77b5fd59fb11dd7); |
| 1101 |
% \draw [->] (Node8d08946e603eb0277964f9dffb00266975512736) ..controls (2243bp,2118bp) and (2161bp,2138bp) .. (Node982d46d22d9597c30d79d368dc9197f5f1fe5956); |
| 1102 |
% \draw [->] (Nodec981d125d1a564c9f5738faff51d59d98711f145) ..controls (405bp,1639bp) and (329bp,1469bp) .. (Node1e7fceb82d739fd04658161f3e37ad7f866b317f); |
| 1103 |
% \draw [->] (Node60944e5702bdafb74ec9614120a88bdfa7084da0) ..controls (2895bp,2270bp) and (2869bp,2513bp) .. (Node4ab18acd3552592a0877a68a8e1c3494f03de7e5); |
| 1104 |
% \draw [->] (Node9fa7f61fda21f51c481ba3721c0f072e33d2abc0) ..controls (2021bp,3385bp) and (1958bp,3428bp) .. (Noded1c21a4e5a354fe40e70739ba19c1ffda65b3e90); |
| 1105 |
% \draw [->] (Node11e9ba26c91a2db7452a5ef9ff7051e19b6b377a) ..controls (2585bp,2594bp) and (2535bp,2721bp) .. (Node94fe47c6f608bbd655277e4abb947276a838f03f); |
| 1106 |
% \draw [->] (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83) ..controls (2610bp,776bp) and (2710bp,636bp) .. (Node70ef4adb6243a8757f5ac77a5cae9a726f406b98); |
| 1107 |
% \draw [->] (Noded13b43f47c02e2d62f12116b4d6f2da47c8b0604) ..controls (2294bp,869bp) and (2343bp,870bp) .. (Node19a6c32cd6543441c9f5a7d4539e0435a4465c83); |
| 1108 |
% \draw [->] (Nodec981d125d1a564c9f5738faff51d59d98711f145) ..controls (319bp,1713bp) and (240bp,1701bp) .. (Node6bee1484bea1868299e58f40683ab3093d319d44); |
| 1109 |
% \draw [->] (Node608cb271bb7fb52c99a1a8e003e0f80f57fb41e1) ..controls (2112bp,1539bp) and (2158bp,1654bp) .. (Nodeffddae94a489d364c14bfa0bc20509be9bbd52cd); |
| 1110 |
% \draw [->] (Node4ab18acd3552592a0877a68a8e1c3494f03de7e5) ..controls (3002bp,2744bp) and (3194bp,2854bp) .. (Nodef90836d07f1e94806617725784c78e4e89824127); |
| 1111 |
% % |
| 1112 |
% \end{tikzpicture} |
| 1113 |
% \end{lrbox} |
| 1114 |
% |
| 1115 |
% \begin{figure} |
| 1116 |
% \centering |
| 1117 |
% \fbox{\usebox{\tikzPicSaveBoxComplex}} |
| 1118 |
% \caption{Complex Visualisation of Axial Coding Ontology} |
| 1119 |
% \label{figure:complex} |
| 1120 |
% \end{figure} |
| 1121 |
% |
| 1122 |
% \pagebreak\clearpage |
| 1123 |
% \StopEventually{\PrintIndex\PrintChanges} |
| 1124 |
% |
| 1125 |
% \section{Implementation} |
| 1126 |
% \subsection{Dependencies} |
| 1127 |
% We start be ensuring that the required packages are loaded when this |
| 1128 |
% file is loaded as a package by \LaTeX{}. |
| 1129 |
% |
| 1130 |
% \begin{macrocode} |
| 1131 |
%<*package> |
| 1132 |
\RequirePackage{multicol} |
| 1133 |
\RequirePackage{tikz} |
| 1134 |
% \iffalse |
| 1135 |
%% dot2texi.sty in CTAN doesn't support the cache option yet |
| 1136 |
%% The SVN version does. |
| 1137 |
% \RequirePackage[cache]{dot2texi} |
| 1138 |
% \fi |
| 1139 |
\RequirePackage{dot2texi} |
| 1140 |
\usetikzlibrary{backgrounds,shapes,arrows,positioning} |
| 1141 |
|
| 1142 |
%</package> |
| 1143 |
% \end{macrocode} |
| 1144 |
% |
| 1145 |
% \subsection{Highlighting Style} |
| 1146 |
% We next setup some default highlighting formatting defines. The user is |
| 1147 |
% free to change the highlighting formatting through redefining |
| 1148 |
% |\ulqdaHighlight|. |
| 1149 |
% \begin{macrocode} |
| 1150 |
%<*package> |
| 1151 |
|
| 1152 |
\definecolor[named]{UlQda@lightblue}{rgb}{0.80,0.85,1} |
| 1153 |
\RequirePackage{soul} |
| 1154 |
\sethlcolor{UlQda@lightblue} |
| 1155 |
|
| 1156 |
%</package> |
| 1157 |
% \end{macrocode} |
| 1158 |
% |
| 1159 |
% \subsection{Package Options} |
| 1160 |
% \begin{macrocode} |
| 1161 |
%<*package> |
| 1162 |
\newif\ifUlQda@debug \UlQda@debugfalse |
| 1163 |
\newif\ifUlQda@cache \UlQda@cachefalse |
| 1164 |
\newif\ifUlQda@cachepresent \UlQda@cachepresentfalse |
| 1165 |
\newif\ifUlQda@shellescape \UlQda@shellescapetrue |
| 1166 |
\newif\ifUlQda@MiKTeX \UlQda@MiKTeXfalse |
| 1167 |
\newif\ifUlQda@active \UlQda@activefalse |
| 1168 |
\newif\ifUlQda@counts \UlQda@countsfalse |
| 1169 |
|
| 1170 |
\DeclareOption{active}{\UlQda@activetrue} |
| 1171 |
\DeclareOption{debug}{\UlQda@debugtrue} |
| 1172 |
\DeclareOption{cache}{\UlQda@cachetrue} |
| 1173 |
\DeclareOption{nocache}{\UlQda@cachefalse} |
| 1174 |
\DeclareOption{shell}{\UlQda@shellescapetrue} |
| 1175 |
\DeclareOption{noshell}{\UlQda@shellescapefalse} |
| 1176 |
\DeclareOption{MiKTeX}{\global\UlQda@MiKTeXtrue} |
| 1177 |
\DeclareOption{counts}{\global\UlQda@countstrue} |
| 1178 |
|
| 1179 |
\DeclareOption*{% |
| 1180 |
\PackageWarning{ulqda}{Unknown option `\CurrentOption'}% |
| 1181 |
} |
| 1182 |
|
| 1183 |
\ExecuteOptions{shell} |
| 1184 |
\ProcessOptions\relax |
| 1185 |
|
| 1186 |
\ifUlQda@counts |
| 1187 |
\def\UlQda@counts{--number } |
| 1188 |
\else |
| 1189 |
\def\UlQda@counts{ } |
| 1190 |
\fi |
| 1191 |
|
| 1192 |
%</package> |
| 1193 |
% \end{macrocode} |
| 1194 |
% |
| 1195 |
% \subsection{Testing the Shell Escape Mechanism} |
| 1196 |
% Needs to work on both Unix-type platforms and on MiK\TeX{} on Microsoft Windows. |
| 1197 |
% \begin{macrocode} |
| 1198 |
%<*package> |
| 1199 |
%% test if shell escape really works |
| 1200 |
\ifUlQda@shellescape |
| 1201 |
\def\tmpfile{/tmp/shellEscapeTest-\the\year\the\month\the\day-\the\time} |
| 1202 |
\immediate\write18{\ifUlQda@MiKTeX rem >"\tmpfile" \else touch \tmpfile \fi} |
| 1203 |
\IfFileExists{\tmpfile}{ |
| 1204 |
\UlQda@shellescapetrue |
| 1205 |
\immediate\write18{\ifUlQda@MiKTeX del "\tmpfile" \else rm -f \tmpfile \fi} |
| 1206 |
}{\UlQda@shellescapefalse} |
| 1207 |
\fi |
| 1208 |
|
| 1209 |
\ifUlQda@shellescape |
| 1210 |
\ifUlQda@debug |
| 1211 |
\PackageInfo{ulqda}{TeX Shell escape enabled.} |
| 1212 |
\fi |
| 1213 |
\else |
| 1214 |
\PackageWarningNoLine{ulqda} {TeX Shell escape not enabled.\MessageBreak% |
| 1215 |
Manually process the CSV output with ulqda.pl} |
| 1216 |
\fi |
| 1217 |
|
| 1218 |
%</package> |
| 1219 |
% \end{macrocode} |
| 1220 |
% |
| 1221 |
% \subsection{Active Macro Implementation} |
| 1222 |
% \begin{macro}{\ulqdaHighlight} |
| 1223 |
% The most basic macro is a style macro - to format the typeset text, |
| 1224 |
% indicating that it has been coded, and also to place the codes themselves |
| 1225 |
% in the margin. |
| 1226 |
% \begin{macrocode} |
| 1227 |
%<*package> |
| 1228 |
\newcommand{\ulqdaHighlight}[2]{% |
| 1229 |
\hl{\protect\ul{#2}}% |
| 1230 |
\marginpar% |
| 1231 |
{\raggedright\hbadness=10000\tiny\it% |
| 1232 |
\hl{#1} |
| 1233 |
\par}% |
| 1234 |
%\par% |
| 1235 |
} |
| 1236 |
|
| 1237 |
%</package> |
| 1238 |
% \end{macrocode} |
| 1239 |
% \end{macro} |
| 1240 |
% |
| 1241 |
% We'll also create |\ulQda|, a vanity macro to typeset the \ulQda\ package name, in |
| 1242 |
% the \TeX\ tradition. |
| 1243 |
% |
| 1244 |
% \begin{macro}{\ulQda} |
| 1245 |
% \begin{macrocode} |
| 1246 |
%<*package> |
| 1247 |
\newcommand{\ulQda}{\textsf{ul\kern -.075em\lower .3ex\hbox {\protect\emph{q}}da}} |
| 1248 |
|
| 1249 |
%</package> |
| 1250 |
% \end{macrocode} |
| 1251 |
% \end{macro} |
| 1252 |
% |
| 1253 |
% Next, we need to determine if the package is intended to be active for |
| 1254 |
% this \LaTeX\ processing run or not. This is essentially a big switch |
| 1255 |
% around the majority of the package definitions. |
| 1256 |
% \begin{macrocode} |
| 1257 |
%<*package> |
| 1258 |
\ifUlQda@active |
| 1259 |
%</package> |
| 1260 |
% \end{macrocode} |
| 1261 |
% |
| 1262 |
% \begin{macro}{\ulqdaCode} |
| 1263 |
% We now create a macro, |\ulqdaCode| to perform the actual coding of the |
| 1264 |
% raw text. % This macro, when invoked, will invoke the highlighting |
| 1265 |
% macro |\ulqdaHighlight| and also conditionally invoke the package private |
| 1266 |
% macro |\UlQda@ListIt| to output coded text to a comma separate values |
| 1267 |
% (.csv) cache file. |
| 1268 |
% |
| 1269 |
% This is hooked (presently) to \verb+\begin{document}+, and contains some |
| 1270 |
% conditional code to decide if caching is enabled, and if so, if the cache is |
| 1271 |
% present or not. |
| 1272 |
% \begin{macrocode} |
| 1273 |
%<*package> |
| 1274 |
% |
| 1275 |
% |
| 1276 |
\AtBeginDocument{% |
| 1277 |
\typeout{ulqda: Loaded - 2009/06/11 v1.1 Qualitative Data Analysis package} |
| 1278 |
% \end{macrocode} |
| 1279 |
%</package> |
| 1280 |
% |
| 1281 |
% If caching is enabled, the~.csv file will only be generated if necessary. |
| 1282 |
% This is because the .csv generation can be quick slow - particularly when |
| 1283 |
% dealing with a number of large portions of text, each having multiple codes. |
| 1284 |
% \begin{macrocode} |
| 1285 |
% |
| 1286 |
%<*package> |
| 1287 |
\ifUlQda@cache |
| 1288 |
\IfFileExists{\jobname.csv} % |
| 1289 |
{ |
| 1290 |
\ifUlQda@debug |
| 1291 |
\typeout{ulqda: QDA cache file \jobname.csv found} |
| 1292 |
\fi |
| 1293 |
\UlQda@cachepresenttrue |
| 1294 |
} |
| 1295 |
{ |
| 1296 |
\ifUlQda@debug |
| 1297 |
\typeout{ulqda: QDA cache file \jobname.csv not found} |
| 1298 |
\fi |
| 1299 |
\UlQda@cachepresentfalse |
| 1300 |
} |
| 1301 |
\else |
| 1302 |
\ifUlQda@debug |
| 1303 |
\typeout{ulqda: caching disabled} |
| 1304 |
\fi |
| 1305 |
\UlQda@cachepresentfalse |
| 1306 |
\fi |
| 1307 |
%</package> |
| 1308 |
% \end{macrocode} |
| 1309 |
% |
| 1310 |
% Without caching enabled, the~.csv file will be generated every run. |
| 1311 |
% |
| 1312 |
% If a cache file is detected and shell escape is enabled, the~.csv cache |
| 1313 |
% will be processed on demand: by |\ulqdaGraph| to generate GraphViz~.dot |
| 1314 |
% file outputs, by |\ulqdaCloud| to generate tag cloud style maps, |
| 1315 |
% and by |\ulqdaTable| to generate a multicolumn list of codes. |
| 1316 |
% |
| 1317 |
% In this case, the |\ulqdaCode| macro will not cause the cache file to |
| 1318 |
% update, but instead will only perform a typesetting function. |
| 1319 |
% |
| 1320 |
% \begin{macrocode} |
| 1321 |
%<*package> |
| 1322 |
|
| 1323 |
% Code macro |
| 1324 |
\ifUlQda@cachepresent |
| 1325 |
\newcommand{\ulqdaCode}[2]{\ulqdaHighlight{#1}{#2}} |
| 1326 |
%</package> |
| 1327 |
% \end{macrocode} |
| 1328 |
% |
| 1329 |
% Otherwise, any occurrence of the |\ulqdaCode| macro will update the cache |
| 1330 |
% file for the run. |
| 1331 |
% |
| 1332 |
% \begin{macrocode} |
| 1333 |
%<*package> |
| 1334 |
\else |
| 1335 |
\ifUlQda@debug |
| 1336 |
\typeout{ulqda: Creating QDA cache file \jobname.csv} % |
| 1337 |
\fi |
| 1338 |
\newwrite\ulqdaCodeFile % |
| 1339 |
\immediate\openout\ulqdaCodeFile=\jobname.csv % |
| 1340 |
\immediate\write\ulqdaCodeFile{Page Number, Section, Code, Text} % |
| 1341 |
|
| 1342 |
%</package> |
| 1343 |
% \end{macrocode} |
| 1344 |
% |
| 1345 |
% The following macro outputs the coding to the code file. |
| 1346 |
% |
| 1347 |
% \begin{macrocode} |
| 1348 |
%<*package> |
| 1349 |
\def\UlQda@ListIt#1[#2,{% |
| 1350 |
\ifUlQda@debug % |
| 1351 |
\typeout{ulqda: Coding "#2" as "#1" on page \thepage, section \thesection} |
| 1352 |
\fi % |
| 1353 |
\immediate\write\ulqdaCodeFile{\thepage, \thesection, #2, "#1"} |
| 1354 |
%</package> |
| 1355 |
% \end{macrocode} |
| 1356 |
% |
| 1357 |
% It also causes the code to be added to the index for the document, which is useful. |
| 1358 |
% |
| 1359 |
% \begin{macrocode} |
| 1360 |
%<*package> |
| 1361 |
\index{#2} % |
| 1362 |
\@ifnextchar]% Look ahead one token. |
| 1363 |
{\eatthesquarebracket}% End of list. |
| 1364 |
{\UlQda@ListIt{#1}[}% Process rest of list. |
| 1365 |
} |
| 1366 |
\def\eatthesquarebracket]{} % Gobble the square bracket. |
| 1367 |
% |
| 1368 |
% Coding macro |
| 1369 |
\newcommand{\ulqdaCode}[2]{\ulqdaHighlight{#1}{#2}\UlQda@ListIt{#2}[#1,]} % |
| 1370 |
\fi |
| 1371 |
} % end of \AtBeginDocument |
| 1372 |
|
| 1373 |
%</package> |
| 1374 |
% \end{macrocode} |
| 1375 |
% \end{macro} |
| 1376 |
% |
| 1377 |
% |
| 1378 |
% \begin{macro}{\ulqdaSetSectFilter} |
| 1379 |
% |\ulqdaSetSectFilter| enables filtering of CSV processing by |
| 1380 |
% section label. |
| 1381 |
% \begin{macrocode} |
| 1382 |
%<*package> |
| 1383 |
\newcommand{\UlQda@FirstOfTwo}[1]{ |
| 1384 |
\ifx#1\UlQda@MyUndefinedMacro |
| 1385 |
?\typeout{ulqda: undefined reference, please re-run} |
| 1386 |
\else |
| 1387 |
\expandafter\@firstoftwo#1 |
| 1388 |
\fi} |
| 1389 |
\newcommand{\UlQda@RefToSectNum}[1]{ |
| 1390 |
\expandafter \ifx\csname r@#1\endcsname\relax |
| 1391 |
?\typeout{ulqda: undefined reference, please re-run} |
| 1392 |
\else |
| 1393 |
\expandafter\UlQda@FirstOfTwo\csname r@#1\endcsname |
| 1394 |
\fi} |
| 1395 |
%</package> |
| 1396 |
% \end{macrocode} |
| 1397 |
% |
| 1398 |
% Now we start the actual filtering work. First, we delete any old files from |
| 1399 |
% previous builds. Next, we create a macro which will be used to pass a |
| 1400 |
% command line argument selecting the appropriate filtering to |
| 1401 |
% \texttt{ulqda.pl}. |
| 1402 |
% |
| 1403 |
% \begin{macrocode} |
| 1404 |
%<*package> |
| 1405 |
\def\UlQda@filter{} |
| 1406 |
\newcommand{\ulqdaSetSectFilter}[1]{ |
| 1407 |
\ifUlQda@shellescape |
| 1408 |
\immediate\write18{\ifUlQda@MiKTeX del \else rm -f -- \fi \jobname_net.dot} |
| 1409 |
\immediate\write18{\ifUlQda@MiKTeX del \else rm -f -- \fi \jobname_flat.dot} |
| 1410 |
\immediate\write18{\ifUlQda@MiKTeX del \else rm -f -- \fi \jobname_table.tex} |
| 1411 |
\fi |
| 1412 |
\def\UlQda@filter{--filter \UlQda@RefToSectNum{#1}} |
| 1413 |
} |
| 1414 |
%</package> |
| 1415 |
% \end{macrocode} |
| 1416 |
% \end{macro} |
| 1417 |
% |
| 1418 |
% \begin{macro}{\ulqdaClearSectFilter} |
| 1419 |
% |
| 1420 |
% We also need to be able to clear any previously configured filter, and |
| 1421 |
% this is what the following macro does for us. |
| 1422 |
% |
| 1423 |
% \begin{macrocode} |
| 1424 |
%<*package> |
| 1425 |
\newcommand{\ulqdaClearSectFilter}{\def\UlQda@filter{}} |
| 1426 |
%</package> |
| 1427 |
% \end{macrocode} |
| 1428 |
% \end{macro} |
| 1429 |
% |
| 1430 |
% \begin{macro}{\ulqdaGraph} |
| 1431 |
% It is typical to want to present your coded data visually in a number of |
| 1432 |
% different ways, perhaps focusing on a particular sub-theme if the entire |
| 1433 |
% ontology is too cumbersome. However, I have provided a sample macro, |
| 1434 |
% |\ulqdaGraph|, which will support the generation of an overall ontology |
| 1435 |
% graph through the use of \verb+dot2texi.sty+. |
| 1436 |
% |
| 1437 |
% |\ulqdaGraph| uses the power of |\csname| to expand to either |
| 1438 |
% |\UlQda@GraphNet| or |\UlQda@GraphFlat|, depending on its first argument. |
| 1439 |
% \begin{macrocode} |
| 1440 |
%<*package> |
| 1441 |
\newcommand{\ulqdaGraph}[2]{\expandafter\csname UlQda@Graph#1\endcsname{#2}} |
| 1442 |
\newcommand\UlQda@Graphflat[1]{\UlQda@GraphFlat{#1}} |
| 1443 |
\newcommand\UlQda@Graphnet[1]{\UlQda@GraphNet{#1}} |
| 1444 |
\newcommand{\UlQda@GraphVizFileName}{} |
| 1445 |
\newsavebox{\UlQda@GraphSaveBox} |
| 1446 |
\newcommand{\UlQda@GraphNet}[1]{% |
| 1447 |
\renewcommand{\UlQda@GraphVizFileName}{\jobname_net.dot}% |
| 1448 |
%</package> |
| 1449 |
% \end{macrocode} |
| 1450 |
% |
| 1451 |
% If a cache file is detected and shell escape is enabled, the~.csv cache |
| 1452 |
% will be processed on demand by |\UlQda@GraphNet| to generate |
| 1453 |
% GraphViz~.dot file output. |
| 1454 |
% |
| 1455 |
% \begin{macrocode} |
| 1456 |
%<*package> |
| 1457 |
\ifUlQda@cachepresent |
| 1458 |
\ifUlQda@shellescape |
| 1459 |
\ifUlQda@debug |
| 1460 |
\typeout{ulqda: Converting .csv to hierarchical GraphViz dot file} |
| 1461 |
\fi |
| 1462 |
\immediate\write18{ulqda.pl --graphnet \UlQda@filter \UlQda@counts |
| 1463 |
-- \jobname.csv \jobname_net.dot} |
| 1464 |
\fi |
| 1465 |
\fi |
| 1466 |
|
| 1467 |
\UlQda@DoGraph{#1}% |
| 1468 |
} |
| 1469 |
\newcommand{\UlQda@GraphFlat}[1]{% |
| 1470 |
\renewcommand{\UlQda@GraphVizFileName}{\jobname_flat.dot}% |
| 1471 |
%</package> |
| 1472 |
% \end{macrocode} |
| 1473 |
% |
| 1474 |
% If a cache file is detected and shell escape is enabled, the~.csv cache |
| 1475 |
% will be processed on demand by |\UlQda@GraphFlat| to generate |
| 1476 |
% GraphViz~.dot file output. |
| 1477 |
% |
| 1478 |
% \begin{macrocode} |
| 1479 |
%<*package> |
| 1480 |
\ifUlQda@cachepresent |
| 1481 |
\ifUlQda@shellescape |
| 1482 |
\ifUlQda@debug |
| 1483 |
\typeout{ulqda: Converting .csv to flat GraphViz dot file} |
| 1484 |
\fi |
| 1485 |
\immediate\write18{ulqda.pl --graphflat \UlQda@filter \UlQda@counts |
| 1486 |
-- \jobname.csv \jobname_flat.dot} |
| 1487 |
\fi |
| 1488 |
\fi |
| 1489 |
|
| 1490 |
\UlQda@DoGraph{#1}% |
| 1491 |
} |
| 1492 |
|
| 1493 |
%</package> |
| 1494 |
% \end{macrocode} |
| 1495 |
% |
| 1496 |
% The following package internal macro, |\UlQda@DoGraph|, actually enacts |
| 1497 |
% the graph generation. |
| 1498 |
% |
| 1499 |
% \begin{macrocode} |
| 1500 |
%<*package> |
| 1501 |
\newcommand{\UlQda@DoGraph}[1]{ |
| 1502 |
\IfFileExists{\UlQda@GraphVizFileName}{ |
| 1503 |
\ifUlQda@shellescape |
| 1504 |
\begin{lrbox}{\UlQda@GraphSaveBox} |
| 1505 |
%</package> |
| 1506 |
% \end{macrocode} |
| 1507 |
% |
| 1508 |
% The next few lines are a hack to enable \texttt{dot2texi.sty} to work with |
| 1509 |
% an external .dot file\footnote{I have suggested this to Kjell Magne Fauskes, |
| 1510 |
% the \texttt{dot2texi.sty} author, and he intends to include such a feature |
| 1511 |
% natively in a future version.}. |
| 1512 |
% |
| 1513 |
% \begin{macrocode} |
| 1514 |
%<*package> |
| 1515 |
\stepcounter{dtt@fignum} |
| 1516 |
\setkeys{dtt}{#1} |
| 1517 |
\immediate\write18{cp "\UlQda@GraphVizFileName" "\[email protected]"} |
| 1518 |
\dottotexgraphicsinclude |
| 1519 |
%</package> |
| 1520 |
% \end{macrocode} |
| 1521 |
% |
| 1522 |
% Now we finish the |\ulqdaGraph| command. |
| 1523 |
% |
| 1524 |
% \begin{macrocode} |
| 1525 |
%<*package> |
| 1526 |
\end{lrbox} |
| 1527 |
\framebox{\usebox{\UlQda@GraphSaveBox}} \par |
| 1528 |
\else |
| 1529 |
\typeout{ulqda: shell escape not enabled} |
| 1530 |
\typeout{ulqda: unable to process \UlQda@GraphVizFileName} |
| 1531 |
\fi |
| 1532 |
} |
| 1533 |
} |
| 1534 |
%</package> |
| 1535 |
% \end{macrocode} |
| 1536 |
% \end{macro} |
| 1537 |
% |
| 1538 |
% We now create a |\ulqdaTable| macro -- a command to process the table of |
| 1539 |
% codes. It doesn't do terribly much, but it is there because it is useful |
| 1540 |
% and conceptually consistent with the graph macros. |
| 1541 |
% |
| 1542 |
% \begin{macro}{\ulqdaTable} |
| 1543 |
% \begin{macrocode} |
| 1544 |
%<*package> |
| 1545 |
\newcommand{\ulqdaTable}{ |
| 1546 |
\IfFileExists{\jobname_table.tex}{ |
| 1547 |
\input{\jobname_table.tex} |
| 1548 |
}{ |
| 1549 |
%</package> |
| 1550 |
% \end{macrocode} |
| 1551 |
% If a cache file is detected and shell escape is enabled, the~.csv cache |
| 1552 |
% will be processed on demand by |\ulqdaTable| to generate |
| 1553 |
% a multicolumn list of codes. |
| 1554 |
% \begin{macrocode} |
| 1555 |
%<*package> |
| 1556 |
\ifUlQda@cachepresent |
| 1557 |
\ifUlQda@shellescape |
| 1558 |
\ifUlQda@debug |
| 1559 |
\typeout{ulqda: Converting .csv to TeX table} |
| 1560 |
\fi |
| 1561 |
\immediate\write18{ulqda.pl --list \UlQda@filter \UlQda@counts |
| 1562 |
-- \jobname.csv \jobname_table.tex} |
| 1563 |
\fi |
| 1564 |
\fi |
| 1565 |
\IfFileExists{\jobname_table.tex}{ |
| 1566 |
\input{\jobname_table.tex} |
| 1567 |
} |
| 1568 |
} |
| 1569 |
} |
| 1570 |
%</package> |
| 1571 |
% \end{macrocode} |
| 1572 |
% \end{macro} |
| 1573 |
% |
| 1574 |
% |
| 1575 |
% Next, we create a |\ulqdaCloud| macro -- a command to process the table of |
| 1576 |
% codes and create a tag cloud style visualisation. |
| 1577 |
% |
| 1578 |
% \begin{macro}{\ulqdaCloud} |
| 1579 |
% \begin{macrocode} |
| 1580 |
%<*package> |
| 1581 |
\newcommand{\ulqdaCloud}{ |
| 1582 |
\IfFileExists{\jobname_cloud.tex}{ |
| 1583 |
\input{\jobname_cloud.tex} |
| 1584 |
}{ |
| 1585 |
%</package> |
| 1586 |
% \end{macrocode} |
| 1587 |
% If a cache file is detected and shell escape is enabled, the~.csv cache |
| 1588 |
% will be processed on demand by |\ulqdaCloud| to generate the cloud. |
| 1589 |
% \begin{macrocode} |
| 1590 |
%<*package> |
| 1591 |
\ifUlQda@cachepresent |
| 1592 |
\ifUlQda@shellescape |
| 1593 |
\ifUlQda@debug |
| 1594 |
\typeout{ulqda: Converting .csv to TeX cloud} |
| 1595 |
\fi |
| 1596 |
\immediate\write18{ulqda.pl --cloud \UlQda@filter \UlQda@counts |
| 1597 |
-- \jobname.csv \jobname_cloud.tex} |
| 1598 |
\fi |
| 1599 |
\fi |
| 1600 |
\IfFileExists{\jobname_cloud.tex}{ |
| 1601 |
\input{\jobname_cloud.tex} |
| 1602 |
} |
| 1603 |
} |
| 1604 |
} |
| 1605 |
%</package> |
| 1606 |
% \end{macrocode} |
| 1607 |
% \end{macro} |
| 1608 |
% |
| 1609 |
% |
| 1610 |
% \subsection{Inactive Macro Stubs} |
| 1611 |
% If the package is not intended to be active, we need to create |
| 1612 |
% stub definitions for the macros that the package provides, so that |
| 1613 |
% document runs where the package is not active will succeed. |
| 1614 |
% |
| 1615 |
% \begin{macrocode} |
| 1616 |
%<*package> |
| 1617 |
\else % UlQda@activefalse |
| 1618 |
%</package> |
| 1619 |
% \end{macrocode} |
| 1620 |
% \begin{macro}{\ulqdaTable} |
| 1621 |
% \begin{macrocode} |
| 1622 |
%<*package> |
| 1623 |
\newcommand{\ulqdaTable}{} |
| 1624 |
%</package> |
| 1625 |
% \end{macrocode} |
| 1626 |
% \end{macro} |
| 1627 |
% \begin{macro}{\ulqdaCloud} |
| 1628 |
% \begin{macrocode} |
| 1629 |
%<*package> |
| 1630 |
\newcommand{\ulqdaCloud}{} |
| 1631 |
%</package> |
| 1632 |
% \end{macrocode} |
| 1633 |
% \end{macro} |
| 1634 |
% \begin{macro}{\ulqdaGraph} |
| 1635 |
% \begin{macrocode} |
| 1636 |
%<*package> |
| 1637 |
\newcommand{\ulqdaGraph}[2]{} |
| 1638 |
%</package> |
| 1639 |
% \end{macrocode} |
| 1640 |
% \end{macro} |
| 1641 |
% \begin{macro}{\ulqdaCode} |
| 1642 |
% \begin{macrocode} |
| 1643 |
%<*package> |
| 1644 |
\newcommand{\ulqdaCode}[2]{#2} |
| 1645 |
%</package> |
| 1646 |
% \end{macrocode} |
| 1647 |
% \end{macro} |
| 1648 |
% \begin{macro}{\ulqdaSetSectFilter} |
| 1649 |
% \begin{macrocode} |
| 1650 |
%<*package> |
| 1651 |
\newcommand{\ulqdaSetSectFilter}[1]{} |
| 1652 |
%</package> |
| 1653 |
% \end{macrocode} |
| 1654 |
% \end{macro} |
| 1655 |
% \begin{macro}{\ulqdaSetSectFilter} |
| 1656 |
% \begin{macrocode} |
| 1657 |
%<*package> |
| 1658 |
\newcommand{\ulqdaClearSectFilter}{} |
| 1659 |
%</package> |
| 1660 |
% \end{macrocode} |
| 1661 |
% \end{macro} |
| 1662 |
% And finally close the conditional switch on whether active or not. |
| 1663 |
% \begin{macrocode} |
| 1664 |
%<*package> |
| 1665 |
\fi |
| 1666 |
%</package> |
| 1667 |
% \end{macrocode} |
| 1668 |
% |
| 1669 |
%\pagebreak |
| 1670 |
% |
| 1671 |
%\begin{thebibliography}{1} |
| 1672 |
% |
| 1673 |
%\bibitem{miles_and_huberman} |
| 1674 |
%M.~B. Miles and A.~M. Huberman, {\em {Qualitative Data Analysis: An Expanded |
| 1675 |
% Sourcebook}}. |
| 1676 |
%\newblock {2455 Teller Road, Thousand Oaks, California 91320, USA}: {Sage |
| 1677 |
% Publications, Inc.}, {1994}. |
| 1678 |
%\newblock {ISBN-10: 0-8039-5540-5}. |
| 1679 |
% |
| 1680 |
%\bibitem{glaser_strauss} |
| 1681 |
%B.~G. Glaser and A.~L. Strauss, {\em {The Discovery of Grounded Theory: |
| 1682 |
% Strategies for Qualitative Research}}. |
| 1683 |
%\newblock {200 Saw Mill River Road, Hawthorne, New York 10532, USA}: {Aldine De |
| 1684 |
% Gruyter}, {1967}. |
| 1685 |
%\newblock {ISBN-10: 0-202-30260-1}. |
| 1686 |
% |
| 1687 |
%\bibitem{strauss_corbin} |
| 1688 |
%A.~Strauss and J.~Corbin, eds., {\em {Grounded Theory in Practice}}. |
| 1689 |
%\newblock {2455 Teller Road, Thousand Oaks, California 91320, USA}: {Sage |
| 1690 |
% Publications}, {1997}. |
| 1691 |
%\newblock {ISBN-10: 0-7619-0748-3}. |
| 1692 |
% |
| 1693 |
%\bibitem{graphviz} |
| 1694 |
%E.~R. Gansner and S.~C. North, ``{An open graph visualization system and its |
| 1695 |
% applications to software engineering},'' {\em {Software - Practice and |
| 1696 |
% Experience}}, vol.~{30}, pp.~1203--1233, {1999}. |
| 1697 |
% |
| 1698 |
%\bibitem{dot2tex} |
| 1699 |
%K.~M. Fauske, ``{dot2text -- A GraphViz to \LaTeX\ converter},'' 2006. |
| 1700 |
%\newblock {available: \url{http://www.fauskes.net/code/dot2tex/} [accessed |
| 1701 |
% 2009-03-02 17h31}. |
| 1702 |
% |
| 1703 |
%\bibitem{locality_of_ref} |
| 1704 |
%B.~Appleton, ``The LoRD Principle -- Locality breeds Maintainability,'' {\em |
| 1705 |
% \href{http://c2.com/ppr/}{Portland Patterns Repository} |
| 1706 |
% \href{http://c2.com/cgi-bin/wiki?WelcomeVisitors}{wiki}}, 1997. |
| 1707 |
%\newblock {available: |
| 1708 |
% \url{http://c2.com/cgi/wiki?LocalityOfReferenceDocumentation} [accessed |
| 1709 |
% 2009-05-14 10h03]}. |
| 1710 |
% |
| 1711 |
%\bibitem{LaTeX_goes_with_the_flow} |
| 1712 |
%J.~Hefferon, ``{\LaTeX\ goes with the flow},'' {\em {The Prac\TeX\ Journal}}, |
| 1713 |
% no.~1, 2008. |
| 1714 |
%\newblock {available \url{http://www.tug.org/pracjourn/2008-1/hefferon/} |
| 1715 |
% [accessed 2009-03-02 17h51]}. |
| 1716 |
% |
| 1717 |
%\end{thebibliography}\clearpage |
| 1718 |
% |
| 1719 |
% \iffalse |
| 1720 |
%<*perl> |
| 1721 |
#!/usr/bin/perl |
| 1722 |
# |
| 1723 |
# Helper Perl script for ulqda |
| 1724 |
# A LaTeX package supporting Qualitative Data Analysis |
| 1725 |
# |
| 1726 |
# Copyright (C) 2009 by Ivan Griffin |
| 1727 |
# |
| 1728 |
# This file may be distributed and/or modified under the |
| 1729 |
# conditions of the LaTeX Project Public License, either |
| 1730 |
# version 1.2 of this license or (at your option) any later |
| 1731 |
# version. The latest version of this license is in: |
| 1732 |
# |
| 1733 |
# http://www.latex-project.org/lppl.txt |
| 1734 |
# |
| 1735 |
# and version 1.2 or later is part of all distributions of |
| 1736 |
# LaTeX version 1999/12/01 or later. |
| 1737 |
# |
| 1738 |
|
| 1739 |
use Getopt::Long; |
| 1740 |
use Digest::SHA1 qw(sha1 sha1_hex sha1_base64); |
| 1741 |
|
| 1742 |
sub Display_Version() |
| 1743 |
{ |
| 1744 |
print "Version: ulqda.pl [2009/06/11 v1.1 Qualitative Data Analysis package]\n\n"; |
| 1745 |
exit; |
| 1746 |
} |
| 1747 |
|
| 1748 |
sub Display_Usage() |
| 1749 |
{ |
| 1750 |
print<<"EOF"; |
| 1751 |
Usage: $0 \\ |
| 1752 |
<--list>|<--graphflat>|<--graphnet>|<--cloud>|<--help>|<--version> \\ |
| 1753 |
[<--filter section>] [<--number-->] infile.csv outfile |
| 1754 |
|
| 1755 |
--filter: filter based on document section label |
| 1756 |
--graphflat: Generate GraphViz .dot output of codes (unconnected) |
| 1757 |
--graphnet: Generate GraphViz .dot output of codes (connected) |
| 1758 |
--cloud: Generate Cloud output of codes |
| 1759 |
--help: Print this help and exit |
| 1760 |
--list: Generate LaTeX table of codes (labelled as table:qda_codes) |
| 1761 |
--number: Output quantity details |
| 1762 |
--version: Dispaly version information |
| 1763 |
EOF |
| 1764 |
exit; |
| 1765 |
} |
| 1766 |
|
| 1767 |
sub sort_codes_hashvalue_descending { |
| 1768 |
$codes{$b} <=> $codes{$a}; |
| 1769 |
} |
| 1770 |
|
| 1771 |
sub sort_codes_alphabetic { |
| 1772 |
$a cmp $b; |
| 1773 |
} |
| 1774 |
|
| 1775 |
@colors = ("#d40000", "#e35a24", "#f67c00", "#faa800", "#ffc000", "#ffde00", "#aae900", "#62dc68", "#bbcced", "#a3bbe0", "#8aaad4", "#7299c7", "#5676b5", "#4554a3", "#2e3191", "#000472"); |
| 1776 |
|
| 1777 |
$result = GetOptions("number" => \$options{'n'}, |
| 1778 |
"list" => \$options{'l'}, |
| 1779 |
"cloud" => \$options{'c'}, |
| 1780 |
"graphflat" => \$options{'g'}, |
| 1781 |
"filter=s" => \$options{'f'}, |
| 1782 |
"graphnet" => \$options{'G'}, |
| 1783 |
"version" => \$options{'v'}, |
| 1784 |
"help" => \$options{'h'}); |
| 1785 |
|
| 1786 |
&Display_Usage() if !$result; |
| 1787 |
&Display_Usage() if $options{'h'}; |
| 1788 |
|
| 1789 |
&Display_Version() if $options{'v'}; |
| 1790 |
|
| 1791 |
if (!($options{'c'} || $options{'l'} || $options{'g'} || $options{'G'})) |
| 1792 |
{ |
| 1793 |
print "Requires one of --cloud, --list, --graphflat, --graphnet, --version or --help\n\n"; |
| 1794 |
&Display_Usage() |
| 1795 |
} |
| 1796 |
|
| 1797 |
|
| 1798 |
if (($ARGV[0]) && ($ARGV[1])) |
| 1799 |
{ |
| 1800 |
open(FILEIN, "<$ARGV[0]") or die "Could not open input file $ARGV[0]\n"; |
| 1801 |
open(FILEOUT, ">$ARGV[1]") or die "Could not open output file $ARGV[1]\n"; |
| 1802 |
} |
| 1803 |
else |
| 1804 |
{ |
| 1805 |
&Display_Usage(); |
| 1806 |
} |
| 1807 |
|
| 1808 |
|
| 1809 |
if ($options{'l'}) |
| 1810 |
{ |
| 1811 |
print FILEOUT << "EOF"; |
| 1812 |
{ |
| 1813 |
\\vspace{0.1in} |
| 1814 |
\\hrule |
| 1815 |
|
| 1816 |
\\begin{multicols}{3} |
| 1817 |
\\label{table:qda_codes} |
| 1818 |
EOF |
| 1819 |
} |
| 1820 |
elsif ($options{'c'}) |
| 1821 |
{ |
| 1822 |
# |
| 1823 |
print FILEOUT << "EOF"; |
| 1824 |
{ |
| 1825 |
\\begin{center} |
| 1826 |
\\noindent% |
| 1827 |
EOF |
| 1828 |
} |
| 1829 |
elsif ($options{'g'} || $options{'G'}) |
| 1830 |
{ |
| 1831 |
print FILEOUT << "EOF"; |
| 1832 |
digraph codes { |
| 1833 |
overlap=scale |
| 1834 |
ratio=compress |
| 1835 |
smoothType=spring |
| 1836 |
repulsiveforce=1.2 |
| 1837 |
splines=true |
| 1838 |
|
| 1839 |
# |
| 1840 |
# Nodes |
| 1841 |
# |
| 1842 |
EOF |
| 1843 |
} |
| 1844 |
|
| 1845 |
|
| 1846 |
<FILEIN>; # gobble first line (it is just header) |
| 1847 |
|
| 1848 |
# now, for each line, parse into comma separated values |
| 1849 |
# codes are further split based on the '!' separator character |
| 1850 |
# e.g. risk!business becomes two codes, risk and business, with a |
| 1851 |
# connection between risk->business |
| 1852 |
GOBBLE_LOOP: while (<FILEIN>) |
| 1853 |
{ |
| 1854 |
chomp; |
| 1855 |
($page, $section, $code_list, $text) = split(/\,/, $_, 4); |
| 1856 |
#print"DEBUG: >>$code_list<< $_ \n"; |
| 1857 |
|
| 1858 |
if (($options{'f'}) && ($options{'f'} != $section)) |
| 1859 |
{ |
| 1860 |
# filtering selected so if no match, then skip |
| 1861 |
next GOBBLE_LOOP; |
| 1862 |
} |
| 1863 |
|
| 1864 |
|
| 1865 |
foreach $code ( split(/\!/, $code_list) ) |
| 1866 |
{ |
| 1867 |
$code =~ s/^ //g; |
| 1868 |
$codes{$code} += 1; |
| 1869 |
} |
| 1870 |
|
| 1871 |
@connections = (@connections, $code_list); |
| 1872 |
} |
| 1873 |
close(FILEIN); |
| 1874 |
|
| 1875 |
# |
| 1876 |
# Find the maximum number of connections and the minimum number of connections |
| 1877 |
# This will be used for scaling subsequently |
| 1878 |
# |
| 1879 |
$iterationCount = 0; $nodeCount = 0; |
| 1880 |
$maxConnections = 0; $minConnections=65535; |
| 1881 |
|
| 1882 |
if ($options{'c'}) |
| 1883 |
{ |
| 1884 |
@key_list = (sort sort_codes_alphabetic keys %codes); |
| 1885 |
} |
| 1886 |
else |
| 1887 |
{ |
| 1888 |
@key_list = (sort sort_codes_hashvalue_descending keys %codes); |
| 1889 |
} |
| 1890 |
|
| 1891 |
LOOP: foreach $i (sort sort_codes_hashvalue_descending keys %codes) |
| 1892 |
{ |
| 1893 |
if ($codes{$i} > $maxConnections) { $maxConnections = $codes{$i} } |
| 1894 |
if ($codes{$i} < $minConnections) { $minConnections = $codes{$i} } |
| 1895 |
} |
| 1896 |
|
| 1897 |
# |
| 1898 |
# For each code, output it as requested |
| 1899 |
# |
| 1900 |
foreach $i (@key_list) |
| 1901 |
{ |
| 1902 |
$digest = sha1_hex($i); |
| 1903 |
|
| 1904 |
if ($options{'l'} && ($iterationCount)) |
| 1905 |
{ |
| 1906 |
print FILEOUT "\\\\\n"; |
| 1907 |
} |
| 1908 |
elsif ($options{'c'}) |
| 1909 |
{ |
| 1910 |
my $base = int(7 + ($codes{$i}/3)); |
| 1911 |
my $lead = $base + 3; |
| 1912 |
my $raisept = int(($base - 7)/4); |
| 1913 |
|
| 1914 |
if ($raisept) { print FILEOUT "\\raisebox{-${raisept}pt}";} |
| 1915 |
print FILEOUT "{\\fontsize{$base}{$lead}\\selectfont "; |
| 1916 |
} |
| 1917 |
elsif ($options{'g'} || $options{'G'}) |
| 1918 |
{ |
| 1919 |
$nodeCount++; |
| 1920 |
print FILEOUT "Node$digest [label=\""; |
| 1921 |
} |
| 1922 |
|
| 1923 |
$i =~ s/!/:/g; |
| 1924 |
print FILEOUT "$i"; |
| 1925 |
|
| 1926 |
if ($options{'c'}) |
| 1927 |
{ |
| 1928 |
print FILEOUT "}\n"; |
| 1929 |
} |
| 1930 |
elsif ($options{'n'}) |
| 1931 |
{ |
| 1932 |
print FILEOUT "{\\textcolor{red}{" if ($options{'l'}); |
| 1933 |
print FILEOUT "($codes{$i})"; |
| 1934 |
print FILEOUT "}}" if ($options{'l'}); |
| 1935 |
} |
| 1936 |
|
| 1937 |
if ($options{'g'} || $options{'G'}) |
| 1938 |
{ |
| 1939 |
$fontSize = 15 + ((60 * $codes{$i})/$maxConnections); |
| 1940 |
print FILEOUT "\", fontsize=$fontSize"; |
| 1941 |
#if ($iterationCount <= 5) |
| 1942 |
{ |
| 1943 |
# heatmap based colors |
| 1944 |
# $colorIndex = 6 - int((6*($codes{$i} - $minConnections))/($maxConnections - $minConnections)); |
| 1945 |
# index based colors |
| 1946 |
$colorIndex = int(($iterationCount*16)/(keys %codes)); |
| 1947 |
print FILEOUT ",color=\"$colors[$colorIndex]\",style=filled"; |
| 1948 |
} |
| 1949 |
print FILEOUT "]\n"; |
| 1950 |
} |
| 1951 |
elsif (! ($options{'l'} || $options{'c'}) ) |
| 1952 |
{ |
| 1953 |
print FILEOUT "\n"; |
| 1954 |
} |
| 1955 |
$iterationCount++; |
| 1956 |
} |
| 1957 |
|
| 1958 |
# |
| 1959 |
# For connection graphs, process each connection between points |
| 1960 |
# |
| 1961 |
if ($options{'G'}) |
| 1962 |
{ |
| 1963 |
print FILEOUT <<"EOF"; |
| 1964 |
|
| 1965 |
# |
| 1966 |
# Connections |
| 1967 |
# |
| 1968 |
EOF |
| 1969 |
|
| 1970 |
for $code_list (@connections) |
| 1971 |
{ |
| 1972 |
print FILEOUT "// $code_list\n"; |
| 1973 |
@code_list_array = split(/\!/, $code_list); |
| 1974 |
$previous_code = shift(@code_list_array); |
| 1975 |
$previous_code =~ s/^ //g; |
| 1976 |
|
| 1977 |
if (defined($previous_code)) |
| 1978 |
{ |
| 1979 |
foreach $code ( @code_list_array ) |
| 1980 |
{ |
| 1981 |
$code =~ s/^ //g; |
| 1982 |
$previous_digest = sha1_hex($previous_code); |
| 1983 |
$digest = sha1_hex($code); |
| 1984 |
|
| 1985 |
# ensure only 1 connection between points |
| 1986 |
if (!defined($connection{"$previous_digest-$digest"})) |
| 1987 |
{ |
| 1988 |
$connection{"$previous_digest-$digest"} = 1; |
| 1989 |
$len=0.25+(0.75*$codes{$previous_code}/$maxConnections); |
| 1990 |
$w=0.25+(0.75*$codes{$previous_code}/$maxConnections); |
| 1991 |
print FILEOUT "Node$previous_digest->Node$digest [label=\"\", w=$w, len=$len]\n"; |
| 1992 |
} |
| 1993 |
|
| 1994 |
$previous_code = $code; |
| 1995 |
} |
| 1996 |
} |
| 1997 |
} |
| 1998 |
} |
| 1999 |
|
| 2000 |
# |
| 2001 |
# Tidy up |
| 2002 |
# |
| 2003 |
if ($options{'l'}) |
| 2004 |
{ |
| 2005 |
print FILEOUT << "EOF"; |
| 2006 |
\\end{multicols} |
| 2007 |
\\hrule |
| 2008 |
EOF |
| 2009 |
} |
| 2010 |
elsif ($options{'c'}) |
| 2011 |
{ |
| 2012 |
print FILEOUT << "EOF"; |
| 2013 |
\\end{center} |
| 2014 |
EOF |
| 2015 |
} |
| 2016 |
|
| 2017 |
print FILEOUT "\n}\n"; |
| 2018 |
|
| 2019 |
close(FILEOUT); |
| 2020 |
%</perl> |
| 2021 |
% \fi |
| 2022 |
% \Finale |
| 2023 |
% |
| 2024 |
% \typeout{*********************************************************} |
| 2025 |
% \typeout{*} |
| 2026 |
% \typeout{* To finish the installation you have to move the} |
| 2027 |
% \typeout{* following file into a directory searched by TeX:} |
| 2028 |
% \typeout{*} |
| 2029 |
% \typeout{* \space\space ulqda.sty} |
| 2030 |
% \typeout{*} |
| 2031 |
% \typeout{* and move the following file into your path:} |
| 2032 |
% \typeout{*} |
| 2033 |
% \typeout{* \space\space ulqda.pl} |
| 2034 |
% \typeout{*} |
| 2035 |
% \typeout{* To produce the documentation run the file ulqda.dtx} |
| 2036 |
% \typeout{* through pdflatex.} |
| 2037 |
% \typeout{*} |
| 2038 |
% \typeout{*********************************************************} |
| 2039 |
% |
| 2040 |
\endinput |