Debian Codegraph @

texmf-dist/doc/latex/istgame/istgame-doc.tex

raw
1 %!TEX program = arara
2 % arara: xelatex: {synctex: yes} until !found('log','Rerun to get')
3 % arara: makeindex: {style: './istgame'}
4 % arara: xelatex: {synctex: yes} until !found('log','Rerun to get')
5
6
7 %%%!TEX program = SpiX
8 %%%$ xelatex -synctex=1 $texname
9 %%%$ if grep -q "Rerun to get" $basename.log; then
10 %%%$ xelatex -synctex=1 $texname
11 %%%$ fi
12 %%%$ makeindex -s ./istgame.ist $basename.idx
13 %%%$ xelatex -synctex=1 $texname
14 %%%$ if grep -q "Rerun to get" $basename.log; then
15 %%%$ xelatex -synctex=1 $texname
16 %%%$ fi
17
18 \def\tmpdate{May 26, 2026}
19 %\def\tmpdate{\today}
20 \def\tmpversion{2.1.1}
21
22 \def\printtikztreetest{}
23 \def\printtest{}
24 \def\printteststar{}
25 \def\printdoc{}
26 %\renewcommand\printtikztreetest{\input{istgame_test_tree}}
27 %\renewcommand\printtest{\clearpage\input{istgame_test}}
28 %\renewcommand\printteststar{\clearpage\input{istgame_test-star}}
29 \renewcommand\printdoc{\include{istgame-doc-v\tmpversion}}
30
31 %% ======================================================
32 \documentclass[a4paper,amsmath]{oblivoir}
33 %% ======================================================
34 %\documentclass[a4paper,article]{memoir}
35 %\renewcommand\thesection{\arabic{section}}
36
37 %\usepackage{istgame-v\tmpversion}
38 \usepackage{istgame}
39
40 \usepackage{fapapersize}
41 \usefapapersize{*,*,30mm,*,28mm,*}
42 \setsecnumdepth{subsubsection}
43 \settocdepth{subsubsection}
44 \setlength\cftsubsubsectionindent{4.5em}
45
46 %% us date
47 \usepackage{datetime}
48 \usdate \let\mytoday\today
49 \AtBeginDocument{\let\today\mytoday}
50
51 \AtBeginDocument{%
52 \renewcommand\contentsname{Table of Contents}
53 \renewcommand\figurename{Figure}
54 \renewcommand\tablename{Table}
55 \renewcommand\abstractname{Abstract}
56 \renewcommand\indexname{Index}
57 \renewcommand\pagerefname{\kern-4pt}%
58 }
59
60
61 %\usepackage[hidelinks]{hyperref} % (memoir)
62 \hypersetup{pdfborder={0 0 0}} % to suppress the hyperlink red box
63
64 %\usepackage{amsmath,mathtools}
65 %\usepackage{xparse} %% oblivoir loads xparse
66 %\usepackage{tikz} %% istgame loads tikz
67 \usepackage{makecell}
68 \usepackage{capt-of}
69 \usepackage{multido}
70 \usepackage[normalem]{ulem} % [normalem] to correct the pdf bookmark broken characters
71 \usepackage{idxlayout}
72 %\usepackage{url}
73
74 %\setistdefaultnodedrawcolor{red} % test
75 %\setistdefaultnodefillcolor{black!16} % (try for MacOS mohave dark mode, TeXShop background color)
76
77 \usepackage{tcolorbox}
78 \tcbuselibrary{minted,xparse,listings,breakable}
79 \tcbset{%
80 listing engine=minted,breakable,
81 after={\par\vspace{.5\baselineskip}\noindent}
82 }
83 \tcbset{%
84 colback=yellow!5!white,
85 colframe=blue!30,
86 listing outside text,
87 righthand width=.3\linewidth,
88 center upper,
89 center lower,
90 sidebyside gap=5pt,
91 minted style=igor, %tango, **igor, xcode, ***manni, *autumn, colorful,
92 listing options={%
93 style=tcblatex,
94 % keywordstyle={\color{blue}},
95 commentstyle=\color{black!20!green},
96 % morekeywords={
97 % istgamefontsize,setistgamefontsize,setistgamearrowendshorten,
98 % istgame,istroot,istrooto,istb,endist,xtdistance,istbm,
99 % istbt,istB,istBt,istbA,cntmAInfoset,cntmAInfosetO,
100 % istrootcntm,istrootcntmA,istrootocntm,istrootocntmA,
101 % setistgrowdirection,istgrowdirection,
102 % setistmathTF,istownerlmathtrue,istownermathfalse,istactioinlabelmathtrue,
103 % istactionlabelmathfalse,istpayoffmathtrue,istpayoffmathfalse,
104 % cntmdistance,cntmlevdist,cntmsibdist,
105 % cntmApreset,cntmistb,cntmAistb,cntmAexpostShowEndPoints,
106 % xtInfoset,xtInfosetO,xtActionLabel,
107 % xtSubgame,xtSubgameBox,xtSubgameOval,
108 % xtgrow,setxtgrowkey,xtInfosetOwner,xtOwner,xtPayoff,xtNode,
109 % xtALPush,xtALShift,
110 % xtShowEndPoints,xtHideEndPoints,
111 % xtShowTerminalNodes,xtHideTerminalNodes,
112 % xtTimeLineH,xtTimeLineV,xtCommentTo,xtCommentFrom,xtShowArrows,xtHideArrows,
113 % xtlevdist,xtsibdist,
114 % xtShowArrows,xtHideArrows,xtShowMidArrows,xtHideMidArrows,
115 % setxtshowarrows,setxtmidarrows,setxtshowmidarrows,
116 % setxtinfosetlayer,setxtsubgamelayer,
117 % setistNewNodeStyle,
118 % setistDecisionNodeStyle,setistOvalNodeStyle,
119 % setistSolidNodeStyle,setistHollowNodeStyle,
120 % setistEllipseNodeStyle,setistNullNodeStyle,setistRectangleNodeStyle,
121 % xtALpush,xtALshift,
122 % xtdefaultsubrootshiftoval,
123 % tikzstyle,draw,coordinate,foreach,setlength,
124 % NewDocumentCommand,NewDocumentEnvironment,IfBooleanTF,tikzset,
125 % xtCInfoset,xtCInfosetO,xtCInfosetOTurnX,
126 % cntmpreset,cntmApreset,cntmAlayerpreset
127 % setxtinfosetstyle,setxtarrowtips,setxtinfosetstyle
128 % },
129 }, % end of listing options
130 }
131
132 \DeclareTCBListing{docstx}{ !O{} }
133 {colback=blue!5!white,listing only,#1}
134 \DeclareTCBListing{docsty}{ !O{} }
135 {colback=red!5!white,listing only,#1}
136 \DeclareTCBListing{docplain}{ !O{} }
137 {colback=white,colframe=gray!15,listing only,#1}
138 \DeclareTCBListing{doccode}{ !G{1} !O{} }
139 {righthand width=\expandafter#1\linewidth,#2}
140
141
142 %\usepackage{tikz-qtree} %%% DO NOT USE
143 % or, add the following in the option
144 % [ edge from parent path={(\tikzparentnode) -- (\tikzchildnode)} ]
145
146
147 \linespread{1}
148
149 \newcommand*\Tikz{Ti\textit{k}Z}
150 \let\TikZ\Tikz
151
152 \newenvironment{keywords}{%
153 \par\vskip2pt
154 \noindent\hangfrom{\textsc{Keywords: }}%
155 }
156
157 \NewExpandableDocumentCommand\xcol{mO{c|}m}
158 {\multicolumn{#1}{#2}{\ensuremath{#3}}}
159
160 %% more lazy macros
161 \newcommand\xbigskip[1]{\multido{}{#1}\bigskip}
162 \newcommand\xmedskip[1]{\multido{}{#1}\bigskip}
163 \newcommand\xsmallskip[1]{\multido{}{#1}\bigskip}
164 \def\hpara{\hangpara{1.52em}{1}}
165 \def\listdivider{\leavevmode\smallskip\hrule width 1.5em\smallskip}
166
167 \NewDocumentCommand\remark{ O{1} }
168 {\xmedskip{#1}\noindent \textbf{Remark: }}
169 \NewDocumentCommand\warning{ O{1} }
170 {\xmedskip{#1}\noindent \textbf{Warning: }}
171 %
172 \newcommand\sourcelink[1]{\ttfamily\color{blue}\uline{#1}}
173 %
174 %%% index
175 %\renewcommand\cmd[1]{\cmdprint{#1}}
176 \ExplSyntaxOn
177 \renewcommand \cmd [1]
178 {
179 \texorpdfstring
180 { \cmdprint {#1} }
181 { \textbackslash \cs_to_str:N #1 }
182 }
183 \let\CMD\cmd
184 \ExplSyntaxOff
185
186 \newcommand\xw[1]{\cmd{#1}}
187 \newcommand\xttw[1]{\texttt{#1}}
188 \newcommand\pkg[1]{\textsf{#1}}
189 \newcommand\env[1]{\textsf{#1}}
190 \newcommand\isw[1]{#1\index{#1}} % simple word in text/index
191 \newcommand\ixsw[1]{\cmd{#1}\index{#1}} % texttt in text, simple word in index
192 \newcommand\ixw[1]{\textsf{#1}\index{#1@\textsf{#1}}} % textsf in text/index
193 \newcommand\ixttw[1]{\texttt{#1}\index{#1@\texttt{#1}}} % texttt in text/index
194 \newcommand\ipkg[1]{\textsf{#1}\index{#1@\textsf{#1}}}
195 \newcommand\ienv[1]{\textsf{#1}\index{#1@\textsf{#1}}}
196
197
198 \makeatletter
199 \newcommand{\icmd}[1]{\cmdprint{#1}%
200 \index{\expandafter\@gobble\string#1(@\string\cmdprint{\string#1}}}
201 \makeatother
202
203 \makeindex
204
205 \title{\texttt{istgame.sty} \\
206 Draw Game Trees with \Tikz}
207 \author{In-Sung Cho \\ \texttt{ischo <at> ktug.org}}
208 %\date{Economics, Kongju National University\\[3pt] \tmpdate\quad version \tmpversion}
209 \date{\tmpdate\quad version \tmpversion}
210
211 \def\tmpclearpage{\clearpage}
212
213 \AtBeginDocument{\MakeShortVerb{\|}}
214
215 %%=======================================================================
216 \begin{document}
217
218 \frontmatter
219 \maketitle
220
221 \renewcommand{\abstracttextfont}{\normalfont\small\noindent\ignorespaces}
222 \begin{abstract}
223 This is a \LaTeX{} package that provides \Tikz-based macros to draw game trees. The main idea underlying the core macros here is the completion of a whole tree by using a sequence of simple `parent-child' tree structures, with no longer nested relations involved like the use of grandchildren or great-grandchildren.
224 With the \ipkg{istgame} package, you can draw game trees as easily as drawing game trees with pen and paper.
225 \begin{keywords}
226 game trees, nodes, branches, information sets, continuum of branches, subgames
227 \end{keywords}
228 \end{abstract}
229
230 \tableofcontents*
231
232 \mainmatter
233
234
235 \printtikztreetest
236 \printtest
237 \printteststar
238 \printdoc
239
240
241 %\clearpage
242 \setsecnumdepth{chapter}
243 \section{Version history}
244 \label{version-history}
245
246 \begin{itemize}
247 %\item v\tmpversion (\tmpdate) to be uploaded to CTAN
248 % \begin{itemize}
249 % \item
250 % \end{itemize}
251 \item v2.1.1(2026/05/26) uploaded to CTAN
252 \begin{itemize}
253 \item corrected typos: |\setistrectangelnodesize| and some more in text
254 \item code refinement
255 \end{itemize}
256 \item v2.1 (2022/03/22) uploaded to CTAN
257 \begin{itemize}
258 \item document done!
259 \end{itemize}
260 \item v2.092 (2022/03/21)
261 \begin{itemize}
262 \item working on the documentation
263 \item added |arrows.meta| and |bending| to the list of preloaded |tikz| libraries
264 \begin{itemize}
265 \item applied |arrows.meta| arrow tips to the related examples
266 \end{itemize}
267 \end{itemize}
268 \item v2.091 (2022/03/16)
269 \begin{itemize}
270 \item modified |istgame| environment to add its starred version
271 \begin{itemize}
272 \item |\begin{istgame}*| is essentially the same as |\begin{tikzpicture}|
273 \item but loses some feature of the \pkg{istgame} package
274 \end{itemize}
275 \item fixed all macros related to information sets to remove arrow tips
276 \item touched |\AtBeginDocument{\setxtarrowtips}|
277 \item rewrote |\setistmathTF(*)| and related macros to avoid a possible conflict
278 \end{itemize}
279 \item v2.09 (2021/04/05)
280 \begin{itemize}
281 \item removed |\pgfextra| from |\istrootcntm| and |\istrootcntmA| (debugging)
282 \item resolved the null font problem in |\cntmistb| and |\cntmAistb| using |\l_nullfont_tl| (debugging)
283 \item added |\setist<...>nodesize| for |solid|, |hollow|, |ellipse|, and |rectangle| (for global setting in the preamble)
284 \end{itemize}
285 \item v2.0 (2019/01/27) uploaded to CTAN
286 \begin{itemize}
287 \item changed the title of the package to ``Draw Game Trees with \Tikz"
288 \item package document done
289 \end{itemize}
290 \item v2.0rc (2019/01/27)
291 \begin{itemize}
292 \item introduced |\setxtinfosetstyle|
293 \begin{itemize}
294 \item introduced |infoset style|, a new style for information sets
295 \item modified all definitions of information sets, accordingly
296 \end{itemize}
297 \item redefined macros related to layer, to easily restore default values
298 \item modified the cross arrow tip options
299 \item modified defaults of |\setxtarrowtips| not to depend on branch styles initially
300 \item code refinement
301 \end{itemize}
302 \item v2.0beta1 (2019/01/26)
303 \begin{itemize}
304 % \item beta test
305 \item introduced |\xtshowXpoints| and |\xtshowXcircles| (for developer only, not documented)
306 \end{itemize}
307 %%%\item v1.99x (2019/01/24)
308 %%% \begin{itemize}
309 %%% \item changed |expl3| macros
310 %%% \begin{itemize}
311 %%% \item \verb+\str_case_x:nnTF+ to \verb+\str_case_e:nnTF+ and then to \verb+\str_case:nnTF+
312 %%% \item \verb+\str_if_eq_x:nnTF+ to \verb+\str_if_eq:eeTF+ and then to \verb+\str_if_eq:nnTF+
313 %%% \end{itemize}
314 %%% \item modified macros on arrows and middle arrows
315 %%% \item redefined |\xtTimeLineH| and |\xtTimeLineV| to deal with swap of branches
316 %%% \item modified |\xtCommentTo| and |\xtCommentFrom| for the last option delimiters
317 %%% \end{itemize}
318 %%%\item v1.99w (2019/01/21)
319 %%% \begin{itemize}
320 %%% \item fixed bug in |\xtInfosetO| regarding |\xtinfosetheihtvar| for |rounded corner|
321 %%% \item corrected |\cntmistb| and |\cntmAistb|
322 %%% \begin{itemize}
323 %%% \item separated options for |\cntmAistb| from those for |\cntmistb|
324 %%% \item those two are independent to each other (except the way to deal with endpoints)
325 %%% \end{itemize}
326 %%% \item redefined |\endist| to restore initial values after each execution of the \verb+cntm(A)istb+
327 %%% \begin{itemize}
328 %%% \item but not for the effect of printing endpoints
329 %%% \item (internally introduced) |\cntmistbVariablesRestore|
330 %%% \item (internally introduced) |\cntmAistbVariablesRestore|
331 %%% \end{itemize}
332 %%% \item introduced |\xtHideEndPoints*| for extra work for continuum endpoints
333 %%% \item introduced |\cntmAlayerpreset|, with |behind| as default
334 %%% \item redefined |\xtShowArrows| to add an option for a node style
335 %%% \item changed the order of options for |\setxtshowarrows|
336 %%% \item changed the order of options for |\setxtarrowtips|
337 %%% \item renamed |\setxtmidarrows| to |\setxtarrowtips|
338 %%% \end{itemize}
339 %%%\item v1.99v (2018/01/17)
340 %%% \begin{itemize}
341 %%% \item redefined the \env{istgame} environment and |\istgameScaleCallTestAndAdjust|
342 %%% to take care of simultaneous use of |xscale| and |yscale|.
343 %%% \item modified macros to make singleton information sets scaled accordingly when needed
344 %%% \begin{itemize}
345 %%% \item |\xtInfosetO|, |\xtCInfosetO|, |\cntmAInfosetO|, |\istgameScaleCallTestAndAdjust|
346 %%% \item (internally) added |\xtinfosetheightvar| and |\cntminfosetheightvar|
347 %%% \end{itemize}
348 %%% \end{itemize}
349 %%%\item v1.99u (2019/01/15)
350 %%% \begin{itemize}
351 %%% \item redefined macros to deal with local change of sibling distances
352 %%% \begin{itemize}
353 %%% \item redefined |\istrootcntm|, |\istrootcntmA|, |\istrootocntm|, |\istrootocntmA|,
354 %%% \item redefined |\istbA|, |\istbAt|
355 %%% \item redefined |\cntmpreset|, |\cntmApreset| -- NEED TO GO BACK (no need call test)
356 %%% \end{itemize}
357 %%% \item redefined |\xtCInfoset| to add abbreviations for the position of owners
358 %%% \item redefined |\xtCInfoset| to print a singleton information set
359 %%% \item modified |\xtCInfoset| to change the way of input for its position (|add to \textbackslash cntmApos|)
360 %%% \end{itemize}\
361 %%%\item v1.99t (2019/01/13)
362 %%% \begin{itemize}
363 %%% \item redefined macros to deal with local change of level and sibling distances for |\istbA|
364 %%% \begin{itemize}
365 %%% \item code complication, inevitable to take care of too many cases
366 %%% \item redefined |\istroot| and |\istrooto|
367 %%% \item redefined |\istrootcntm| and its variants
368 %%% \item redefined |\istbA| and |\istbAt|
369 %%% \end{itemize}
370 %%% \end{itemize}
371 %%%\item v1.99s (2019/01/10)
372 %%% \begin{itemize}
373 %%% \item modified |\xtCInfosetO| for better results when swapped with \xw{plotfactor} less than 1
374 %%% \item modified |\istrootcntm| and its variants for better results of shrunken continua
375 %%% \item redefined |\xtTimeLineH| (for a horizontal time-line)
376 %%% \item introduced |\xtTimeLineH(')| for a vertical time-line
377 %%% \item introduced |\xtCInfosetOTurnX| for turning X circles to use it just in case
378 %%% \end{itemize}
379 %%%\item v1.99r (2019/01/07)
380 %%% \begin{itemize}
381 %%% \item redefined |\istrootcntm| and |\istrootocntm| for smaller triangle continua of branches
382 %%% \item introduced |\cntmpreset| and |\cntmpreset*|
383 %%% \item put `call test' for cases of how to change level distance with |\istbA|
384 %%% \item modified |\xtCInfosetO| and |\cntmAInfosetO| for coloring
385 %%% \end{itemize}
386 %%%\item v1.99q (2019/01/05)
387 %%% \begin{itemize}
388 %%% \item modified |\xtInfosetO| to print a singleton information set by a circle.
389 %%% \item finished fine-tuning |\cntmAInfosetO| (for tuning base circles)
390 %%% \end{itemize}
391 %%%\item v1.99p (2019/01/02)
392 %%% \begin{itemize}
393 %%% \item redefined |\xtInfoset| and |\xtInfosetO| in accordance with new |\xtCInfosetO|
394 %%% \item redefined completely |\cntmAInfoset| and |\cntmAInfsetO| in the way of |\xtCInfosetO|
395 %%% \item redefined |\cntmAInfoset|, |\cntmAInfosetO|, |\istrootcntmA|, and |\istrootocntmA|
396 %%% \begin{itemize}
397 %%% \item to compensate the dependency of arcs on the ratio of |\cntmlevdist| to |\cntmsibdist|
398 %%% \end{itemize}
399 %%% \end{itemize}
400 %%%\item v1.99o (2018/12/31)
401 %%% \begin{itemize}
402 %%% \item redefined completely |\xtCInfosetO| and |\xtCInfoset| for enhancement
403 %%% \begin{itemize}
404 %%% \item (internally) added |\setxtCIAngleAccordingtoGrowswapCallForCI|
405 %%% \item to make it possible for the control points to turn accordingly along the base circles
406 %%% for sides of curved information sets
407 %%% \end{itemize}
408 %%% \end{itemize}
409 %%%\item v1.99n (2018/12/27)
410 %%% \begin{itemize}
411 %%% \item redefined |\setistmathTF*| to make it work with basic text font styles
412 %%% \begin{itemize}
413 %%% \item |\istownertextfont|, |\istactionlabeltextfont|, |\istpayofftextfont|
414 %%% \item all working only in text mode
415 %%% \end{itemize}
416 %%% \item introduced |\xtcureslopedlabelsNS| and |\xtcureslopedlabelsEW| to resolve a \Tikz\ conflict to sloped labels
417 %%% \begin{itemize}
418 %%% \item (internally) added |\xtlevdistadj| and |\xtsibdistadj|
419 %%% \end{itemize}
420 %%% \end{itemize}
421 %%%\item v1.99m (2018/12/21)
422 %%% \begin{itemize}
423 %%% \item added starred versions that work with |\setistmathTF|
424 %%% \begin{itemize}
425 %%% \item |\xtInfoset*|, |\xtInfosetO*|, |\xtCInfoset|, |\xtCInfosetO|
426 %%% \item |\xtOwner*|, |\xtActionLabel*|, |\xtPayoff*|, |\xtInfosetOwner*|
427 %%% \end{itemize}
428 %%% \end{itemize}
429 %%%\item v1.99l (2018/12/18)
430 %%% \begin{itemize}
431 %%% \item changed the order and the type of argument delimiters for input consistency
432 %%% \begin{itemize}
433 %%% \item |\xtCInfosetO|, |\cmtmAinfosetO|, and their related macros
434 %%% \item effective from \xw{v.1.99l}
435 %%% \begin{itemize}
436 %%% \item not consistent with the earlier versions of update
437 %%% \item but intact with the \xw{version 1}
438 %%% \end{itemize}
439 %%% \end{itemize}
440 %%% \end{itemize}
441 %%%\item v1.99k (2018/12/15)
442 %%% \begin{itemize}
443 %%% \item introduced |\xtCInfosetO| for bubble type curved information sets
444 %%% \begin{itemize}
445 %%% \item (internally) added |\xtPrototypeForCInfosetO| -- only for |\xtCInfosetO|
446 %%% \end{itemize}
447 %%% \end{itemize}
448 %%%\item v1.99j (2018/12/11)
449 %%% \begin{itemize}
450 %%% \item introduced |\xtCInfoset| for curved information sets
451 %%% \begin{itemize}
452 %%% \item (internally) added |\istgameScaleCallTestAndAdjust| (must be used in a group)
453 %%% \item (internally) added |\setxtCIAngleAccordingtoGrowswapCall|
454 %%% \end{itemize}
455 %%% \end{itemize}
456 %%%\item v1.99i (2018/12/08)
457 %%% \begin{itemize}
458 %%% \item (macro name change, effective from \xw{v1.99i}) all `\xw{cntmarc}' changed to `\xw{cntmA}'
459 %%% \item introduced |\cntmAInfosetO|
460 %%% \item introduced |\cntmAexpostShowEndPoints|
461 %%% \item introduced |\istbA(*)| and |\istbAt(*)|
462 %%% \end{itemize}
463 %%%\item v1.99h (2018/11/07)
464 %%% \begin{itemize}
465 %%% \item changed the default position of a continuum arc from \xw{.5} to \xw{1}
466 %%% \item introduced |\cntmarcInfoset|
467 %%% \end{itemize}
468 %%%\item v1.99g (2018/09/30)
469 %%% \begin{itemize}
470 %%% \item put |\xtShowArrows| and |\xtShowMidArrows| into |\istB|
471 %%% \item found issues with |\xtShowArrows| and |\xtShowMidArrows| related to \xw{postaction}
472 %%% \item added the arrow end shorten option to |\xtCommentTo| and |\xtCommentFrom|.
473 %%% \item (internal) minor changes
474 %%% \begin{itemize}
475 %%% \item redefined |\setistSolidNodeStyle| to keep consistency with other node styles
476 %%% \item redefined |\setistNullNodeStyle| to keep consistency with other node styles
477 %%% \end{itemize}
478 %%% \end{itemize}
479 %%%\item v1.99f (2018/09/19)
480 %%% \begin{itemize}
481 %%% \item (internally) redefined |\cntmistb| and |\cntmarcistb| to resolve endpoints problems
482 %%% \begin{itemize}
483 %%% \item (internally) added |\cntmOUTERistb| and |\cntmarcOUTERistb|
484 %%% \item (internally) removed |\cntmendpointsShow| and |\cntmendpointsPrint|
485 %%% \item (internally) redefined |\istrootcntm| and its variants accordingly
486 %%% \end{itemize}
487 %%% \end{itemize}
488 %%%\item v1.99e (2018/09/15)
489 %%% \begin{itemize}
490 %%% \item introduced |\xtShowArrows| and |\xtHideArrows(*)|
491 %%% \item introduced |\setxtshowarrows|
492 %%% \item introduced |\xtShowMidArrows| and |\xtHideMidArrows|
493 %%% \end{itemize}
494 %%%\item v1.99d (2018/09/13)
495 %%% \begin{itemize}
496 %%% \item introduced |\setxtarrowtips| with a tikzstyle \xw{->-}
497 %%% \item introduced new arrow styles: \xw{->>-}, \xw{->>>-}, \xw{-o-}, and \xw{-x-}
498 %%% \end{itemize}
499 %%%\item v1.99c (2018/09/09)
500 %%% \begin{itemize}
501 %%% \item introduced |\cntmistb| and |\cntmarcistb|
502 %%% \item redefined |\cntmdistance| to check if |\cntmactsibdist| is called or not
503 %%% \item (internally) added |\cntmendpointsShow|
504 %%% \begin{itemize}
505 %%% \item redefined |\xtShowEndPoints| and |\xtHideEndPoints| accordingly
506 %%% \item introduced |\xtShowEndPoints*| (for outermost branches of a continuum)
507 %%% \end{itemize}
508 %%% \item (internally) added |\cntmendpointsPrint|
509 %%% \begin{itemize}
510 %%% \item redefined |\istrootcntm| and its variants accordingly
511 %%% \end{itemize}
512 %%% \end{itemize}
513 %%%\item v1.99b (2018/09/07)
514 %%% \begin{itemize}
515 %%% \item redesigned |\istrootcntm| and its variants
516 %%% \begin{itemize}
517 %%% \item removed |\ISTCntm(')| and |\ISTCntmArc(')|
518 %%% \end{itemize}
519 %%% \item introduced |\cntmdraw|, |\cntmdrawset| and related macros
520 %%% \item redfined |\cntmdistance| to check if |\cntmactsibdist| is called or not
521 %%% \end{itemize}
522 %%%\item v1.99a (2018/09/05)
523 %%% \begin{itemize}
524 %%% \item introduced |\setistgameshorten| (for \env{istgame} environment option)
525 %%% \end{itemize}
526 %%%\item v1.98 (2018/09/03)
527 %%% \begin{itemize}
528 %%% \item redefined |\istrootcntm(arc)| to make it work with |\setistmathTF(*)|
529 %%% \item redefined |\istrootocntm(arc)| to make it work with |\setistmathTF(*)|
530 %%% \end{itemize}
531 %%%\item v1.97 (2018/09/02)
532 %%% \begin{itemize}
533 %%% \item redefined |\istroot(o)| to resolve tex expansion problems
534 %%% \item redefined |\istrootcntm(arc)| to resolve tex expansion problems
535 %%% \item redefined |\istrootocntm(arc)| to resolve tex expansion problems
536 %%% \item redefined the \env{istgame} environment to add \xw{[shorten >=0pt]} if \xw{[->]} exists
537 %%% \end{itemize}
538 %%%\item 1.96 (2018/08/30)
539 %%% \begin{itemize}
540 %%% \item minor changes
541 %%% \begin{itemize}
542 %%% \item altered the default sibling distance of |\xtdistance| from \xw{15mm} to \xw{\levdist}
543 %%% \item altered initial options for \xw{null}, \xw{solid}, and \xw{hollow} nodes (added \xw{thin}, \xw{solid})
544 %%% \item added \xw{text depth=.25ex} for some definitions
545 %%% \end{itemize}
546 %%% \end{itemize}
547 %%%\item v1.95 (2018/08/27)
548 %%% \begin{itemize}
549 %%% \item resolved dimension issues for |\cntmdistance|
550 %%% \item added |\xtOwner*|, |\xtActionLabel*|, |\xtPayoff*| (working with |\setistmathTF(*)|)
551 %%% \end{itemize}
552 %%%\item v1.94 (2018/08/22)
553 %%% \begin{itemize}
554 %%% \item resolved tex expansion issues in the macros for a continuum of branches
555 %%% \end{itemize}
556 %%%\item v1.93 (2018/08/19)
557 %%% \begin{itemize}
558 %%% \item introduced |\setistmath| to set input mode for owners, action labels, and payoffs
559 %%% \item introduced |\setistmath*| to print action labels in italics, in case of text mode
560 %%% \item (internally) added |\istownerstyle|, |\istactionlabelstyle|, and |\istpayoffstyle|
561 %%% \end{itemize}
562 %%%\item v1.92 (2018/08/17)
563 %%% \begin{itemize}
564 %%% \item redesigned the \env{istgame} environment
565 %%% \begin{itemize}
566 %%% \item to extract the number input from \xw{scale}, \xw{xscale}, or \xw{yscale}
567 %%% \item added |\xtscale|, |\xtxscale|, and |\xtyscale| to save scale option values
568 %%% \end{itemize}
569 %%% \item tested to apply scale values to improve the result of |\xtInfosetO|
570 %%% \end{itemize}
571 %%%\item v1.91 (2018/08/16)
572 %%% \begin{itemize}
573 %%% \item many changes to resolve expansion problems
574 %%% \begin{itemize}
575 %%% \item redefined |\cntmset|, |\cntmarcset|, and related macors
576 %%% \item redifined |\cntmlevdist| and |\cntmsibdist| as lengths
577 %%% \end{itemize}
578 %%% \end{itemize}
579 %%%\item v1.9 (2018/08/11)
580 %%% \begin{itemize}
581 %%% \item introduced |\cntmarcplotfactorset|
582 %%% \end{itemize}
583 %%%\item v1.8 (2018/08/09)
584 %%% \begin{itemize}
585 %%% \item made possible to use the directional abbreviations with |\xtInfoset|
586 %%% \item introduced |\istrootocntm| and |\istrootocntmarc| (oval versions)
587 %%% \end{itemize}
588 %%%\item v1.7 (2018/08/04)
589 %%% \begin{itemize}
590 %%% \item introduced |\istbm|
591 %%% \item introduced |\setistNewNodeStyle|
592 %%% \end{itemize}
593 %%%\item v1.6 (2018/08/01)
594 %%% \begin{itemize}
595 %%% \item resigned |\cntmdistance| (now ready for users)
596 %%% \begin{itemize}
597 %%% \item added |\cntmactsibdist| to distinguish it from |\cntmsibdist|
598 %%% \end{itemize}
599 %%% \item added |\cntmdistance*| to incorporate with |\xtdistance|
600 %%% \item introduced |\istrootcntmA(')|
601 %%% \begin{itemize}
602 %%% \item added (internally) |\ISTCntmArc(')|
603 %%% \item added |\cntmarcset|
604 %%% \end{itemize}
605 %%% \item introduced |\istrootcntm(')|
606 %%% \begin{itemize}
607 %%% \item added (internally) |\ISTCntm(')|
608 %%% \end{itemize}
609 %%% \item (internally) renamed |\istCntmRoot(Arc)| to |\obsoleteISTCntm(Arc)|
610 %%% \end{itemize}
611 %%%\item v1.5 (2018/07/26)
612 %%% \begin{itemize}
613 %%% \item introduced |\setxtinfosetlayer|
614 %%% \item introduced |\setxtsubgamelayer|
615 %%% \end{itemize}
616 %%%\item v1.4 (2018/07/12)
617 %%% \begin{itemize}
618 %%% \item completely rewrote |\xtInfosetO| to deal with sloped information sets
619 %%% \begin{itemize}
620 %%% \item removed |\xtInfosetO'| and |\xtInfoset'| (critical change for users!)
621 %%% \end{itemize}
622 %%% \end{itemize}
623 %%%\item v1.3 (2018/07/06)
624 %%% \begin{itemize}
625 %%% \item (internally) renamed some macros (such as |\xt@...|)
626 %%% \item (internally) renamed |\xtaction| to |\istaction|
627 %%% \item (internally) renamed |\xtpayoff| to |\istpayoff|
628 %%% \item (internally) renamed |\istRoot(O)| to |\ISTRoot(O)|
629 %%% \end{itemize}
630 %%%\item v1.2 (2017/12/11)
631 %%% \begin{itemize}
632 %%% \item replaced |\istb.| by |\istbt| (critical change for users!)
633 %%% \begin{itemize}
634 %%% \item |\istb| redefined accordingly
635 %%% \item this is the cost of introducing |\istB(*)|
636 %%% \end{itemize}
637 %%% \item introduced |\istB(*)| to deal with dual action labels
638 %%% \item added |\istbt(*)| and |\istBt(*)|
639 %%% \item added \xw{text depth=.25ex} as an option to |\istroot| and |\istrooto|
640 %%% \end{itemize}
641 %%%\item v1.1 (2017/10/02)
642 %%% \begin{itemize}
643 %%% \item introduced |\xtCommentTo| and |\xtCommentFrom|
644 %%% \item introduced |\xtTimeLineH(')|
645 %%% \item redefined |\xtActionLabel| to deal with sloped labels
646 %%% \item replaced |\tikzstyle| by |\tikzset|
647 %%% \end{itemize}
648 \item v1.0 (2017/09/04)
649 \begin{itemize}
650 \item introduced |\cntmlevdist| and |\cntmsibdist|
651 \item introduced |\cntmdistance|
652 \item redefined related marcos
653 \item package document done
654 \end{itemize}
655 %%%\item v1.0 (2017/09/04) ready to submit to CTAN
656 %%% \begin{itemize}
657 %%% \item introduced |\cntmlevdist| and |\cntmsibdist|
658 %%% \item introduced |\cntmdistance| (for internal use)
659 %%% \item redefined related marcos.
660 %%% \item package document done
661 %%% \end{itemize}
662 %%%\item v0.99g (2017/08/21)
663 %%% \begin{itemize}
664 %%% \item redefined the \env{istgame} environment to add \xw{>=stealth} as default
665 %%% \item added \xw{text depth=.25ex} as an option to |\istb| to get better alignment of action labels
666 %%% \end{itemize}
667 %%%\item v0.99f (2017/08/02)
668 %%% \begin{itemize}
669 %%% \item redefined |\xtInfosetO(')|
670 %%% \begin{itemize}
671 %%% \item added \verb+\begin{scope}[on background layer]...\end{scope}+
672 %%% \end{itemize}
673 %%% \end{itemize}
674 %%%\item v0.99e (2017/08/01)
675 %%% \begin{itemize}
676 %%% \item introduced the prime(\xw{'}) versions to deal with \xw{grow'} (this is the swap version in \TikZ)
677 %%% \item redefined |\istroot(')|
678 %%% \item defined |\istrooto(')| to replace |\istroot*|
679 %%% \begin{itemize}
680 %%% \item |\istroot*| completely replaced by |\istrooto|
681 %%% \end{itemize}
682 %%% \item redefinde |\istcntm|
683 %%% \item defined |\istcntmarc|
684 %%% \begin{itemize}
685 %%% \item |\istcntm*| completely replaced by |\istcntmarc|
686 %%% \end{itemize}
687 %%% \item redefined |\xtInfoset(')| and |\xtInfosetOwner(')|
688 %%% \item introduced |\xtInfosetO(')|
689 %%% \begin{itemize}
690 %%% \item |\xtInfoset*| completely replaced by |\xtInfosetO|
691 %%% \end{itemize}
692 %%% \item introduced |\xt@growswap| introduced
693 %%% \item redefined |\xtNode| accordingly
694 %%% \end{itemize}
695 %%%\item v0.99d (2017/07/27)
696 %%% \begin{itemize}
697 %%% \item defined |\xtSubgameBox(*)| and |\xtSubgameOval(*)| to express a subgame
698 %%% \end{itemize}
699 %%%\item v0.99c (2017/07/20)
700 %%% \begin{itemize}
701 %%% \item defined |\xtgrow| to deal with going `clockwise' of branch arrangement
702 %%% \item defined |\setxtgrowkey| to change between \xw{grow} and \xw{grow'}
703 %%% \item introduced |\setistgrowdirection'| by redefining |\setistgrowdirection|
704 %%% \item updated `related macros' accordingly
705 %%% \end{itemize}
706 %%%\item v0.99b (2017/07/16)
707 %%% \begin{itemize}
708 %%% \item renamed \xw{zero node} as \xw{plain node}
709 %%% \item added |\setistPlainNodeStyle|
710 %%% \item defined |\xtNode*| (for a terminal node text with a plain node)
711 %%% \item redefined |\xt<...>NodeStyle| (now all arguments are optional)
712 %%% \item renamed |\isthorizontallabelshift| as |\istactionlabelxshift|, with default \xw{1pt}
713 %%% \item renamed |\istverticallabelshift| as |\istactionlabelyshift|, with default \xw{2pt}
714 %%% \end{itemize}
715 %%%\item v0.99a (2017/03/10)
716 %%% \begin{itemize}
717 %%% \item started rewriting package manual
718 %%% \item introduced |\istb.|\ (for terminal nodes)
719 %%% \item redefined |\xtShowTerminalNodes|
720 %%% \item introduced |\xtShowEndPoints| and |\xtHideEndPoints|
721 %%% \item redefined |\xtInfoset*|, with |\xtdefaultinfosep| added
722 %%% \end{itemize}
723 %%%\item v0.9 (2017/02/13)
724 %%% \begin{itemize}
725 %%% \item some internal macro names changed (|\xtnode|, |\xttnode|,|\xtshowtnode|)
726 %%%% \item conflict with \pkg{tikz-qtree} resolved. (\env{istgame} differs from \env{tikzpicture} with \pkg{tikz-qtree})
727 %%%% \item |\setistbranchanchors| added
728 %%% \item added \xw{zero node}
729 %%% \end{itemize}
730 %%%\item v0.8 (2017/01/17)
731 %%% \begin{itemize}
732 %%% \item macro names changed
733 %%% \begin{itemize}
734 %%% \item |\xtdistance|: prefix `\xw{x}' changed to `\xw{xt}' meaning `extensive tree'
735 %%% \item |\xtInfoset(*)|, |\xtInfosetOwner|, |\xtActionLabel|, |xtOwner|, |\xtPayoff|, |\xtNode|
736 %%% \item |\xtShowTerminalNodes|, |\xtHideTerminalNodes|
737 %%% \item |\xtlevdist|, |\xtsibdist|
738 %%% \end{itemize}
739 %%% \item |\xtNode| redefined
740 %%% \item some internal macro names changed (including |\xtpayff|, |\xtmove|)
741 %%% \item node styles redefined
742 %%% \item |\setist<Solid>NodeStyle| added for <Various> node styles
743 %%% \item |\setistdefaultnodecolor|, |setistdefaultnodebgcolor| added
744 %%% \end{itemize}
745 \end{itemize}
746
747
748 \section{Acknowledgement}
749
750 The basic idea of the \pkg{istgame} package came from Osborne's \pkg{egameps} package and Chen (2013).
751 The update of the package \pkg{istgame} to \xw{version 2.0} is partly motivated by the questions and discussions on the \xw{game tree} topic at \url{https://tex.stackexchange.com/}.
752 Special thanks go to Kangsoo Kim of KTUG for his great help in using \pkg{expl3} to simplify the appearance and the usage of the macros, and to resolve the issues on \TeX's expansion.
753
754
755 \section{References}
756 \hpara{}Chen, H.~K.~(2013), ``Drawing Game Trees with \TikZ,'' \url{http://www.sfu.ca/~haiyunc/notes/Game_Trees_with_TikZ.pdf}.
757
758 \hpara{}Cho, I-S.~(2017), ``\pkg{istgame}: Drawing Game Trees with \TikZ,'' in Korean TeX Society, \emph{\TeX, Beyond the World of Typesetting}, Seoul: Kyungmoonsa, 203--237.
759
760 \hpara{}Osborne, M.~J.~(2004a), ``Manual for \pkg{egameps.sty},'' Version 1.1, \url{http://texdoc.net/texmf-dist/doc/latex/egameps/egameps.pdf}
761
762 \hpara{}\uline{\hphantom{Osborne, M.~J}}~(2004b), \emph{An Introduction to Game Theory}, New York: Oxford.
763
764 \hpara{}Tantau, T.~(2021), ``\TikZ\ and PGF: Manual for version 3.1.9a,'' \url{http://sourceforge.net/projects/pgf}.
765
766 %\section*{Discussions (in Korean) on KTUG board}
767 %
768 %\begin{itemize}
769 %\item Drawing Game Trees 1: \url{http://www.ktug.org/xe/index.php?document_srl=207287}
770 %
771 %\item Drawing Game Trees 1-1: \url{http://www.ktug.org/xe/index.php?document_srl=207513}
772 %
773 %\item Drawing Game Trees 1-2:
774 %\url{http://www.ktug.org/xe/index.php?document_srl=208286}
775 %
776 %\item Drawing Game Trees 2: \url{http://www.ktug.org/xe/index.php?document_srl=212043}
777 %
778 %\item Drawing Game Trees 2-1:
779 %\url{http://www.ktug.org/xe/index.php?document_srl=212225}
780 %
781 %\item Drawing Game Trees 2-2:
782 %\url{http://www.ktug.org/xe/index.php?document_srl=212319}
783 %\end{itemize}
784
785 \clearpage
786 \printindex
787
788 \end{document}