Debian Codegraph @

texmf-dist/source/latex/ulqda/ulqda.dtx

raw
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