Debian Codegraph @

texmf-dist/doc/latex/tikz-sections/docs/tikz-sections-doc.tex

raw
1 \documentclass[10pt]{article}
2
3 \usepackage[a4paper,margin=18mm]{geometry}
4 \usepackage{adjustbox}
5 \usepackage{array}
6 \usepackage{booktabs}
7 \usepackage{enumitem}
8 \usepackage{listings}
9 \usepackage{longtable}
10 \usepackage{xcolor}
11 \usepackage{xurl}
12 \usepackage{tikz-sections}
13
14 \title{TikZ-Sections Manual}
15 \author{Parsa Yazdi}
16 \date{Version 0.2.0, 2026-05-25}
17
18 \setlength{\parindent}{0pt}
19 \setlength{\parskip}{5pt}
20 \setlist[itemize]{leftmargin=*,topsep=2pt,itemsep=1pt}
21 \renewcommand{\arraystretch}{1.15}
22 \newcolumntype{L}[1]{>{\raggedright\arraybackslash}p{#1}}
23
24 \definecolor{CodeBack}{RGB}{246,247,249}
25 \definecolor{RuleGray}{RGB}{210,214,220}
26
27 \lstdefinestyle{TikZSectionsCode}{
28 basicstyle=\ttfamily\footnotesize,
29 columns=fullflexible,
30 keepspaces=true,
31 breaklines=true,
32 breakatwhitespace=false,
33 frame=single,
34 rulecolor=\color{RuleGray},
35 backgroundcolor=\color{CodeBack},
36 xleftmargin=2mm,
37 xrightmargin=2mm,
38 aboveskip=5pt,
39 belowskip=5pt
40 }
41
42 \lstset{style=TikZSectionsCode}
43
44 \newcommand{\command}[1]{\texttt{\textbackslash #1}}
45 \newcommand{\smallcommand}[1]{{\scriptsize\texttt{\textbackslash #1}}}
46 \newcommand{\keyname}[1]{\texttt{#1}}
47
48 \newcommand{\CodeInline}[1]{%
49 \begingroup
50 \ttfamily\scriptsize\raggedright\Urlmuskip=0mu plus 1mu\url{#1}%
51 \endgroup
52 }
53
54 \newcommand{\ShapePreview}[1]{%
55 \begin{center}
56 \begin{adjustbox}{max width=26mm,max height=22mm}
57 \begin{tikzpicture}
58 #1
59 \end{tikzpicture}
60 \end{adjustbox}
61 \end{center}
62 }
63
64 \newcommand{\WideShapePreview}[1]{%
65 \begin{center}
66 \begin{adjustbox}{max width=34mm,max height=20mm}
67 \begin{tikzpicture}
68 #1
69 \end{tikzpicture}
70 \end{adjustbox}
71 \end{center}
72 }
73
74 \newcommand{\ReferenceRow}[6]{%
75 \textbf{\command{#1}}\par
76 #2\par
77 \vspace{2pt}
78 \begin{tabular}{@{}p{0.20\linewidth}p{0.34\linewidth}p{0.38\linewidth}@{}}
79 #6 & \footnotesize #3 & \CodeInline{#4}
80 \end{tabular}
81 \par\vspace{4mm}
82 }
83
84 \newcommand{\CommandSummary}[4]{%
85 \smallcommand{#1} & #2 & #3 & #4 \\
86 }
87
88 \begin{document}
89
90 \maketitle
91 \tableofcontents
92 \newpage
93
94 \section{Purpose and Scope}
95
96 TikZ-Sections provides TikZ commands for drawing structural cross-section
97 sketches. The current package covers cold-formed steel (CFS), hot-rolled steel
98 (HRS), and initial reinforced-concrete (RC) cross-sections.
99
100 The package has two command layers:
101
102 \begin{itemize}
103 \item Public key-value commands such as \command{TikZSectionsChannel}. These are
104 recommended for new documents because the options are readable and can be
105 omitted when defaults are acceptable.
106 \item Positional helper commands such as \command{csChannel}. These remain
107 available for lower-level drawings.
108 \end{itemize}
109
110 \section{Installation and Loading}
111
112 Place \texttt{tikz-sections.sty} next to your document or in a directory searched by
113 your LaTeX installation, then load it in the preamble:
114
115 \begin{lstlisting}
116 \usepackage{tikz-sections}
117 \end{lstlisting}
118
119 TikZ-Sections loads TikZ and the TikZ \keyname{calc} library.
120
121 \section{Quick Start}
122
123 The example below draws a lipped cold-formed channel with a label, centerlines,
124 and a basic dimension legend.
125
126 \begin{center}
127 \begin{adjustbox}{max width=45mm,max height=40mm}
128 \begin{tikzpicture}
129 \TikZSectionsChannel[
130 depth=245,
131 flange=75,
132 lip=20,
133 thickness=2.5,
134 radius=5,
135 centerline=true,
136 dimensions=true,
137 label=C245,
138 scale=0.03
139 ]
140 \end{tikzpicture}
141 \end{adjustbox}
142 \end{center}
143
144 \begin{lstlisting}
145 \begin{tikzpicture}
146 \TikZSectionsChannel[
147 depth=245,
148 flange=75,
149 lip=20,
150 thickness=2.5,
151 radius=5,
152 centerline=true,
153 dimensions=true,
154 label=C245,
155 scale=0.03
156 ]
157 \end{tikzpicture}
158 \end{lstlisting}
159
160 \section{Key-Value Model}
161
162 Every public drawing command accepts a single optional key list:
163
164 \begin{lstlisting}
165 \TikZSectionsChannel[depth=180, flange=55, thickness=2, radius=4]
166 \end{lstlisting}
167
168 The keys are reset to package defaults each time a public drawing command is
169 called. Use \keyname{at}, \keyname{x}, \keyname{y}, \keyname{scale}, \keyname{xscale}, \keyname{yscale}, and \keyname{rotate} to
170 position a section inside a larger \texttt{tikzpicture}.
171
172 Public section commands draw into the current \texttt{tikzpicture}; they do not
173 create a \texttt{tikzpicture} internally. They may be used inside ordinary TikZ
174 \texttt{scope} environments and mixed with commands such as \command{draw},
175 \command{fill}, \command{node}, and \command{foreach}.
176
177 \subsection{Default Keys}
178
179 \begin{longtable}{p{0.22\linewidth}p{0.18\linewidth}p{0.50\linewidth}}
180 \toprule
181 Key & Default & Meaning \\
182 \midrule
183 \keyname{depth} & 245 & Section depth or vertical size \\
184 \keyname{width} & 75 & Section width, horizontal size, or circular diameter for RC commands \\
185 \keyname{diameter} & 75 & Alias stored as the circular width/diameter value \\
186 \keyname{flange} & 75 & Common CFS flange width used when top/bottom values are not supplied \\
187 \keyname{top flange}, \keyname{bottom flange} & 75 & Independent CFS flange widths honored in \keyname{detailed} mode \\
188 \keyname{left flange}, \keyname{right flange} & 35 & Hat-section flange widths \\
189 \keyname{lip} & 0 & Common CFS lip length used when top/bottom values are not supplied \\
190 \keyname{top lip}, \keyname{bottom lip} & 0 & Independent CFS lip lengths honored in \keyname{detailed} mode \\
191 \keyname{thickness} & 2.5 & Steel thickness or drawing line width in millimetres \\
192 \keyname{radius}, \keyname{inside radius}, \keyname{bend radius}, \keyname{root radius} & 5 & Bend radius or rolled-section root radius \\
193 \keyname{position}, \keyname{stiffener position} & 0.5 & Relative stiffener position along the web \\
194 \keyname{leg} & 60 & Equal-angle leg length \\
195 \keyname{vertical leg}, \keyname{horizontal leg} & 60, 40 & Unequal-angle leg lengths \\
196 \keyname{web depth}, \keyname{web thickness} & 95, 1 & Welded I-section web dimensions \\
197 \keyname{flange thickness} & 2 & Rolled flange thickness \\
198 \keyname{top flange width}, \keyname{bottom flange width} & 35 & Welded I-section flange widths \\
199 \keyname{top flange thickness}, \keyname{bottom flange thickness} & 2 & Welded I-section flange thicknesses \\
200 \keyname{reference line width} & 0 & Optional plate/bar reference line width \\
201 \keyname{line width} & 1 & Round-bar line width \\
202 \keyname{cover} & 40 & RC cover distance to the longitudinal bar centerline. Stirrups are drawn around the outside edge of the longitudinal bar envelope \\
203 \keyname{bar diameter} & 16 & RC rebar diameter \\
204 \keyname{top bars}, \keyname{bottom bars} & 2 & Rectangular RC bar counts \\
205 \keyname{left bars}, \keyname{right bars} & 0 & Rectangular RC side-bar counts \\
206 \keyname{top layers}, \keyname{bottom layers}, \keyname{side layers} & 1 & RC reinforcement layer counts \\
207 \keyname{layer spacing} & 25 & RC spacing between bar layers \\
208 \keyname{perimeter bars} & 8 & Circular RC perimeter bar count \\
209 \keyname{label}, \keyname{label x}, \keyname{label y} & empty, 0, 0 & Optional text label. Without explicit coordinates, labels are placed above the top-left of the section with the local scale in brackets \\
210 \keyname{mode} & simplified & Input mode. \keyname{simplified} uses nominal symmetric dimensions; \keyname{detailed} honors independent detailed dimensions where available \\
211 \keyname{simplified}, \keyname{detailed} & -- & Convenience styles for \keyname{mode=simplified} and \keyname{mode=detailed} \\
212 \keyname{filled} & false & Fill closed steel/bar shapes before drawing the outline \\
213 \keyname{centerline} & false & Draw horizontal and vertical centerlines \\
214 \keyname{dimensions} & false & Draw dimension assistance. Channel and zee commands use a boxed dimension legend; other families currently use the older guide overlay \\
215 \keyname{monochrome} & false & Draw straight and curved steel segments in black \\
216 \keyname{tie} & true & Draw RC tie/closed stirrup line \\
217 \keyname{at}, \keyname{shift}, \keyname{scale}, \keyname{xscale}, \keyname{yscale}, \keyname{rotate}, \keyname{x}, \keyname{y} & (0,0), (0,0), 1, 1, 1, 0, 0, 0 & Placement and local transform values \\
218 \bottomrule
219 \end{longtable}
220
221 \section{Style Hooks}
222
223 The package routes drawing through TikZ styles. This lets users keep the same
224 geometry while changing color, line style, or fill appearance.
225
226 \begin{longtable}{p{0.28\linewidth}p{0.60\linewidth}}
227 \toprule
228 Style & Purpose \\
229 \midrule
230 \keyname{tikzSections/straight} & Straight steel segments \\
231 \keyname{tikzSections/round} & Curved/radius steel segments \\
232 \keyname{tikzSections/centerline} & Optional centerlines \\
233 \keyname{tikzSections/hidden} & Hidden or reference lines \\
234 \keyname{tikzSections/dimension} & Current dimension overlay lines \\
235 \keyname{tikzSections/callout} & Reserved for future arrow-style annotations \\
236 \keyname{tikzSections/dimension legend} & Box style used by channel and zee dimension legends \\
237 \keyname{tikzSections/label} & Labels drawn with the \keyname{label} key \\
238 \keyname{tikzSections/fill} & Fills for closed steel/bar shapes \\
239 \keyname{tikzSections/concrete} & RC concrete fill \\
240 \keyname{tikzSections/concrete edge} & RC concrete edge. The default line is heavier than reinforcement lines \\
241 \keyname{tikzSections/rebar} & RC longitudinal rebar circles. The default fill is blue \\
242 \keyname{tikzSections/tie} & RC tie/stirrup outline. The default line is red \\
243 \bottomrule
244 \end{longtable}
245
246 \begin{lstlisting}
247 \TikZSectionsSetup{
248 tikzSections/straight/.style={tikzSections/default, black},
249 tikzSections/round/.style={tikzSections/default, gray},
250 tikzSections/fill/.style={fill=gray!15}
251 }
252 \end{lstlisting}
253
254 \section{Input Modes}
255
256 The public key-value API supports two input modes. The default is
257 \keyname{mode=simplified}.
258
259 \keyname{simplified} mode is the nominal engineering-sketch interface. For CFS
260 channel and zee sections, use the main dimensions:
261
262 \begin{lstlisting}
263 \TikZSectionsChannel[
264 depth=180,
265 flange=55,
266 lip=18,
267 thickness=2,
268 radius=4
269 ]
270 \end{lstlisting}
271
272 In simplified mode, \keyname{flange} is used for both top and bottom flanges,
273 and \keyname{lip} is used for both lips. Independent top/bottom keys are not
274 part of the simplified contract.
275
276 \keyname{detailed} mode is the explicit geometry interface. It honors
277 independent dimensions where the section command supports them:
278
279 \begin{lstlisting}
280 \TikZSectionsChannel[
281 detailed=true,
282 depth=180,
283 top flange=55,
284 bottom flange=60,
285 top lip=18,
286 bottom lip=20,
287 thickness=2,
288 radius=4
289 ]
290 \end{lstlisting}
291
292 Detailed mode is intended for asymmetric dimensions and future
293 section-specific options such as independent radii, stiffener geometry, or
294 rolled-shape details.
295
296 \section{Dimension Assistance}
297
298 The \keyname{dimensions=true} key currently provides dimension assistance rather
299 than a full traditional engineering dimensioning system. For
300 \command{TikZSectionsChannel} and \command{TikZSectionsZee}, it draws a compact
301 boxed legend for the web depth, flange, lip, thickness, and bend radius where
302 those values are present. The current notation is \(b_w\) for web depth, \(b_f\)
303 for flange width, \(b_l\) for lip length, \(t\) for thickness, and \(r\) for
304 bend radius. Detailed asymmetric dimensions use \(b_{ft}\), \(b_{fb}\),
305 \(b_{lt}\), and \(b_{lb}\). Other section families still draw the older generic
306 horizontal and vertical dimension guide overlay.
307
308 The legend direction is deliberate: it avoids misleading arrow placement until
309 traditional dimension lines with extension lines, standardized offsets,
310 collision avoidance, and notation presets are implemented. Traditional
311 engineering dimension lines remain future work.
312
313 \section{Cold-Formed Lip Handling}
314
315 Cold-formed channel and zee families use one geometry path for lipped and
316 unlipped forms. Set \keyname{lip=0}, or set both \keyname{top lip=0} and
317 \keyname{bottom lip=0}, to suppress the lips. This is also the default.
318
319 For equal top and bottom geometry, use \keyname{flange} and \keyname{lip}. For
320 asymmetric geometry, use \keyname{detailed=true} with \keyname{top flange},
321 \keyname{bottom flange}, \keyname{top lip}, and \keyname{bottom lip}. The
322 current CFS public API covers single-section primitives; built-up assemblies are
323 intended to be composed with ordinary TikZ scopes and transforms.
324
325 \begin{lstlisting}
326 % Equal flange/lip values
327 \TikZSectionsChannel[depth=180, flange=55, lip=18]
328
329 % Independent top and bottom values
330 \TikZSectionsChannel[
331 detailed=true,
332 depth=180,
333 top flange=55,
334 top lip=18,
335 bottom flange=60,
336 bottom lip=20
337 ]
338
339 % Unlipped form through the same channel family
340 \TikZSectionsChannel[depth=180, flange=55, lip=0]
341 \end{lstlisting}
342
343 \section{Command Summary}
344
345 \begin{footnotesize}
346 \begin{longtable}{@{}L{0.32\linewidth}L{0.19\linewidth}L{0.32\linewidth}L{0.05\linewidth}@{}}
347 \toprule
348 Command & Shape & Main keys & Group \\
349 \midrule
350 \CommandSummary{TikZSectionsChannel}{Channel family}{\keyname{depth}, \keyname{flange}/top/bottom flanges, \keyname{lip}/top/bottom lips, \keyname{thickness}, \keyname{radius}}{CFS}
351 \CommandSummary{TikZSectionsStiffenedChannel}{Intermediate-stiffened channel}{\keyname{top flange}, \keyname{top lip}, \keyname{bottom flange}, \keyname{bottom lip}, \keyname{stiffener position}}{CFS}
352 \CommandSummary{TikZSectionsZee}{Zee family}{\keyname{depth}, \keyname{flange}/top/bottom flanges, \keyname{lip}/top/bottom lips, \keyname{thickness}, \keyname{radius}}{CFS}
353 \CommandSummary{TikZSectionsSigma}{Sigma section}{\keyname{top flange}, \keyname{top lip}, \keyname{bottom flange}, \keyname{bottom lip}}{CFS}
354 \CommandSummary{TikZSectionsHat}{Hat section}{\keyname{depth}, \keyname{width}, \keyname{left flange}, \keyname{right flange}}{CFS}
355 \CommandSummary{TikZSectionsAngle}{Cold-formed angle}{\keyname{vertical leg}, \keyname{horizontal leg}, \keyname{thickness}, \keyname{radius}}{CFS}
356 \CommandSummary{TikZSectionsLippedAngle}{Lipped angle}{\keyname{vertical leg}, \keyname{horizontal leg}, \keyname{lip}}{CFS}
357 \CommandSummary{TikZSectionsRHS}{Rectangular hollow section}{\keyname{depth}, \keyname{width}, \keyname{thickness}, \keyname{radius}}{CFS}
358 \CommandSummary{TikZSectionsSHS}{Square hollow section}{\keyname{width}, \keyname{thickness}, \keyname{radius}}{CFS}
359 \CommandSummary{TikZSectionsCHS}{Circular hollow section}{\keyname{radius}, \keyname{thickness}}{CFS}
360 \CommandSummary{TikZSectionsUniversalBeam}{Universal beam/I-section}{\keyname{depth}, \keyname{width}, \keyname{flange thickness}, \keyname{web thickness}}{HRS}
361 \CommandSummary{TikZSectionsUniversalColumn}{Universal column/I-section}{\keyname{depth}, \keyname{width}, \keyname{flange thickness}, \keyname{web thickness}}{HRS}
362 \CommandSummary{TikZSectionsWeldedI}{Welded I-section}{\keyname{web depth}, \keyname{top flange width}, \keyname{bottom flange width}}{HRS}
363 \CommandSummary{TikZSectionsTee}{Tee section}{\keyname{depth}, \keyname{width}, \keyname{flange thickness}, \keyname{web thickness}}{HRS}
364 \CommandSummary{TikZSectionsHRSChannel}{Hot-rolled channel}{\keyname{depth}, \keyname{width}, \keyname{flange thickness}, \keyname{web thickness}}{HRS}
365 \CommandSummary{TikZSectionsEqualAngle}{Equal angle}{\keyname{leg}, \keyname{thickness}, \keyname{root radius}}{HRS}
366 \CommandSummary{TikZSectionsUnequalAngle}{Unequal angle}{\keyname{vertical leg}, \keyname{horizontal leg}, \keyname{thickness}}{HRS}
367 \CommandSummary{TikZSectionsPlate}{Plate}{\keyname{width}, \keyname{thickness}, \keyname{filled}}{HRS}
368 \CommandSummary{TikZSectionsFlatBar}{Flat bar}{\keyname{width}, \keyname{thickness}, \keyname{filled}}{HRS}
369 \CommandSummary{TikZSectionsRoundBar}{Round bar}{\keyname{radius}, \keyname{line width}, \keyname{filled}}{HRS}
370 \CommandSummary{TikZSectionsHRSCHS}{Hot-rolled circular hollow section}{\keyname{radius}, \keyname{thickness}}{HRS}
371 \CommandSummary{TikZSectionsHRSRHS}{Hot-rolled rectangular hollow section}{\keyname{depth}, \keyname{width}, \keyname{thickness}, \keyname{root radius}}{HRS}
372 \CommandSummary{TikZSectionsHRSSHS}{Hot-rolled square hollow section}{\keyname{width}, \keyname{thickness}, \keyname{root radius}}{HRS}
373 \CommandSummary{TikZRCRectangular}{Rectangular RC section}{\keyname{width}, \keyname{depth}, \keyname{cover}, \keyname{bar diameter}, bar counts}{RC}
374 \CommandSummary{TikZRCCircular}{Circular RC section}{\keyname{diameter}, \keyname{cover}, \keyname{bar diameter}, \keyname{perimeter bars}}{RC}
375 \bottomrule
376 \end{longtable}
377 \end{footnotesize}
378
379 \section{Visual Catalogue}
380
381 The previews in this section are deliberately bounded with maximum width and
382 height limits. The example code can be pasted into any \texttt{tikzpicture}.
383
384 \subsection{Cold-Formed Steel}
385
386 \ReferenceRow
387 {TikZSectionsChannel}
388 {Channel family with the default unlipped form.}
389 {\keyname{depth}, \keyname{flange}, \keyname{lip=0}, \keyname{thickness}, \keyname{radius}}
390 {\TikZSectionsChannel[depth=180, flange=55, thickness=2, radius=4, scale=0.03]}
391 {}
392 {\ShapePreview{\TikZSectionsChannel[depth=180, flange=55, thickness=2, radius=4, scale=0.03]}}
393
394 \ReferenceRow
395 {TikZSectionsChannel}
396 {Channel with equal lips at the flange tips. Use \keyname{flange} and \keyname{lip} for equal top/bottom values.}
397 {\keyname{depth}, \keyname{flange}, \keyname{lip}, \keyname{thickness}, \keyname{radius}}
398 {\TikZSectionsChannel[depth=180, flange=55, lip=18, thickness=2, radius=4, scale=0.03]}
399 {}
400 {\ShapePreview{\TikZSectionsChannel[depth=180, flange=55, lip=18, thickness=2, radius=4, scale=0.03]}}
401
402 \ReferenceRow
403 {TikZSectionsChannel}
404 {Asymmetric lipped channel using independent top and bottom flange/lip dimensions.}
405 {\keyname{detailed}, \keyname{top flange}, \keyname{top lip}, \keyname{bottom flange}, \keyname{bottom lip}}
406 {\TikZSectionsChannel[detailed=true, depth=180, top flange=55, top lip=18, bottom flange=60, bottom lip=20, thickness=2, radius=4, scale=0.03]}
407 {}
408 {\ShapePreview{\TikZSectionsChannel[detailed=true, depth=180, top flange=55, top lip=18, bottom flange=60, bottom lip=20, thickness=2, radius=4, scale=0.03]}}
409
410 \ReferenceRow
411 {TikZSectionsChannel}
412 {Explicit unlipped channel by setting \keyname{lip=0}.}
413 {\keyname{depth}, \keyname{flange}, \keyname{lip=0}, \keyname{thickness}, \keyname{radius}}
414 {\TikZSectionsChannel[depth=180, flange=55, lip=0, thickness=2, radius=4, scale=0.03]}
415 {}
416 {\ShapePreview{\TikZSectionsChannel[depth=180, flange=55, lip=0, thickness=2, radius=4, scale=0.03]}}
417
418 \ReferenceRow
419 {TikZSectionsStiffenedChannel}
420 {Channel with one intermediate web stiffener. Use \keyname{stiffener position} from 0 to 1.}
421 {\keyname{depth}, \keyname{top flange}, \keyname{top lip}, \keyname{bottom flange}, \keyname{bottom lip}, \keyname{stiffener position}}
422 {\TikZSectionsStiffenedChannel[detailed=true, depth=180, top flange=55, top lip=18, bottom flange=60, bottom lip=20, stiffener position=0.55, thickness=2, radius=4, scale=0.03]}
423 {}
424 {\ShapePreview{\TikZSectionsStiffenedChannel[detailed=true, depth=180, top flange=55, top lip=18, bottom flange=60, bottom lip=20, stiffener position=0.55, thickness=2, radius=4, scale=0.03]}}
425
426 \ReferenceRow
427 {TikZSectionsZee}
428 {Zee family with the default unlipped form.}
429 {\keyname{depth}, \keyname{flange}, \keyname{lip=0}, \keyname{thickness}, \keyname{radius}}
430 {\TikZSectionsZee[depth=180, flange=55, thickness=2, radius=4, scale=0.03]}
431 {}
432 {\ShapePreview{\TikZSectionsZee[depth=180, flange=55, thickness=2, radius=4, scale=0.03]}}
433
434 \ReferenceRow
435 {TikZSectionsZee}
436 {Zee section with equal lips. Use independent top/bottom keys for asymmetric geometry.}
437 {\keyname{depth}, \keyname{flange}, \keyname{lip}, \keyname{thickness}, \keyname{radius}}
438 {\TikZSectionsZee[depth=180, flange=55, lip=18, thickness=2, radius=4, scale=0.03]}
439 {}
440 {\ShapePreview{\TikZSectionsZee[depth=180, flange=55, lip=18, thickness=2, radius=4, scale=0.03]}}
441
442 \ReferenceRow
443 {TikZSectionsZee}
444 {Asymmetric lipped zee using independent top and bottom flange/lip dimensions.}
445 {\keyname{detailed}, \keyname{top flange}, \keyname{top lip}, \keyname{bottom flange}, \keyname{bottom lip}}
446 {\TikZSectionsZee[detailed=true, depth=180, top flange=55, top lip=18, bottom flange=60, bottom lip=20, thickness=2, radius=4, scale=0.03]}
447 {}
448 {\ShapePreview{\TikZSectionsZee[detailed=true, depth=180, top flange=55, top lip=18, bottom flange=60, bottom lip=20, thickness=2, radius=4, scale=0.03]}}
449
450 \ReferenceRow
451 {TikZSectionsZee}
452 {Explicit unlipped zee by setting \keyname{lip=0}.}
453 {\keyname{depth}, \keyname{flange}, \keyname{lip=0}, \keyname{thickness}, \keyname{radius}}
454 {\TikZSectionsZee[depth=180, flange=55, lip=0, thickness=2, radius=4, scale=0.03]}
455 {}
456 {\ShapePreview{\TikZSectionsZee[depth=180, flange=55, lip=0, thickness=2, radius=4, scale=0.03]}}
457
458 \ReferenceRow
459 {TikZSectionsSigma}
460 {Sigma-style stiffened section with independent top and bottom flange/lip dimensions.}
461 {\keyname{depth}, \keyname{top flange}, \keyname{top lip}, \keyname{bottom flange}, \keyname{bottom lip}}
462 {\TikZSectionsSigma[detailed=true, depth=180, top flange=55, top lip=18, bottom flange=60, bottom lip=20, thickness=2, radius=4, scale=0.03]}
463 {}
464 {\ShapePreview{\TikZSectionsSigma[detailed=true, depth=180, top flange=55, top lip=18, bottom flange=60, bottom lip=20, thickness=2, radius=4, scale=0.03]}}
465
466 \ReferenceRow
467 {TikZSectionsHat}
468 {Hat section with independent left and right outward flanges.}
469 {\keyname{depth}, \keyname{width}, \keyname{left flange}, \keyname{right flange}, \keyname{thickness}, \keyname{radius}}
470 {\TikZSectionsHat[depth=100, width=45, left flange=25, right flange=25, thickness=2, radius=4, scale=0.04]}
471 {}
472 {\WideShapePreview{\TikZSectionsHat[depth=100, width=45, left flange=25, right flange=25, thickness=2, radius=4, scale=0.04]}}
473
474 \ReferenceRow
475 {TikZSectionsAngle}
476 {Cold-formed angle.}
477 {\keyname{vertical leg}, \keyname{horizontal leg}, \keyname{thickness}, \keyname{radius}}
478 {\TikZSectionsAngle[vertical leg=100, horizontal leg=60, thickness=2, radius=4, scale=0.04]}
479 {}
480 {\ShapePreview{\TikZSectionsAngle[vertical leg=100, horizontal leg=60, thickness=2, radius=4, scale=0.04]}}
481
482 \ReferenceRow
483 {TikZSectionsLippedAngle}
484 {Cold-formed angle with a lip at the horizontal leg tip.}
485 {\keyname{vertical leg}, \keyname{horizontal leg}, \keyname{lip}, \keyname{thickness}, \keyname{radius}}
486 {\TikZSectionsLippedAngle[vertical leg=100, horizontal leg=60, lip=20, thickness=2, radius=4, scale=0.04]}
487 {}
488 {\ShapePreview{\TikZSectionsLippedAngle[vertical leg=100, horizontal leg=60, lip=20, thickness=2, radius=4, scale=0.04]}}
489
490 \ReferenceRow
491 {TikZSectionsRHS}
492 {Rectangular hollow section. Set \keyname{filled=true} for a grey fill behind the outline.}
493 {\keyname{depth}, \keyname{width}, \keyname{thickness}, \keyname{radius}, \keyname{filled}}
494 {\TikZSectionsRHS[depth=120, width=70, thickness=2, radius=4, filled=true, scale=0.04]}
495 {}
496 {\ShapePreview{\TikZSectionsRHS[depth=120, width=70, thickness=2, radius=4, filled=true, scale=0.04]}}
497
498 \ReferenceRow
499 {TikZSectionsSHS}
500 {Square hollow section.}
501 {\keyname{width}, \keyname{thickness}, \keyname{radius}, \keyname{filled}}
502 {\TikZSectionsSHS[width=80, thickness=2, radius=4, filled=true, scale=0.04]}
503 {}
504 {\ShapePreview{\TikZSectionsSHS[width=80, thickness=2, radius=4, filled=true, scale=0.04]}}
505
506 \ReferenceRow
507 {TikZSectionsCHS}
508 {Circular hollow section.}
509 {\keyname{radius}, \keyname{thickness}, \keyname{filled}}
510 {\TikZSectionsCHS[radius=35, thickness=2, filled=true, scale=0.04]}
511 {}
512 {\ShapePreview{\TikZSectionsCHS[radius=35, thickness=2, filled=true, scale=0.04]}}
513
514 \subsection{Hot-Rolled Steel}
515
516 \ReferenceRow
517 {TikZSectionsUniversalBeam}
518 {Rolled I-section/universal beam sketch.}
519 {\keyname{depth}, \keyname{width}, \keyname{flange thickness}, \keyname{web thickness}, \keyname{root radius}}
520 {\TikZSectionsUniversalBeam[depth=61.2, width=22.9, flange thickness=1.96, web thickness=1.19, root radius=1.4, scale=0.16]}
521 {}
522 {\ShapePreview{\TikZSectionsUniversalBeam[depth=61.2, width=22.9, flange thickness=1.96, web thickness=1.19, root radius=1.4, scale=0.16]}}
523
524 \ReferenceRow
525 {TikZSectionsUniversalColumn}
526 {Rolled I-section/universal column sketch.}
527 {\keyname{depth}, \keyname{width}, \keyname{flange thickness}, \keyname{web thickness}, \keyname{root radius}}
528 {\TikZSectionsUniversalColumn[depth=61.2, width=22.9, flange thickness=1.96, web thickness=1.19, root radius=1.4, scale=0.16]}
529 {}
530 {\ShapePreview{\TikZSectionsUniversalColumn[depth=61.2, width=22.9, flange thickness=1.96, web thickness=1.19, root radius=1.4, scale=0.16]}}
531
532 \ReferenceRow
533 {TikZSectionsWeldedI}
534 {Fabricated I-section with independent flange dimensions.}
535 {\keyname{web depth}, \keyname{web thickness}, \keyname{top flange width}, \keyname{top flange thickness}, \keyname{bottom flange width}, \keyname{bottom flange thickness}}
536 {\TikZSectionsWeldedI[web depth=95, web thickness=1, top flange width=35, top flange thickness=2, bottom flange width=35, bottom flange thickness=2, scale=0.1]}
537 {}
538 {\ShapePreview{\TikZSectionsWeldedI[web depth=95, web thickness=1, top flange width=35, top flange thickness=2, bottom flange width=35, bottom flange thickness=2, scale=0.1]}}
539
540 \ReferenceRow
541 {TikZSectionsTee}
542 {Hot-rolled tee section.}
543 {\keyname{depth}, \keyname{width}, \keyname{flange thickness}, \keyname{web thickness}, \keyname{root radius}}
544 {\TikZSectionsTee[depth=30.6, width=22.9, flange thickness=1.96, web thickness=1.19, root radius=1.4, scale=0.2]}
545 {}
546 {\ShapePreview{\TikZSectionsTee[depth=30.6, width=22.9, flange thickness=1.96, web thickness=1.19, root radius=1.4, scale=0.2]}}
547
548 \ReferenceRow
549 {TikZSectionsHRSChannel}
550 {Hot-rolled channel.}
551 {\keyname{depth}, \keyname{width}, \keyname{flange thickness}, \keyname{web thickness}, \keyname{root radius}}
552 {\TikZSectionsHRSChannel[depth=61.2, width=22.9, flange thickness=1.96, web thickness=1.19, root radius=1.4, scale=0.16]}
553 {}
554 {\ShapePreview{\TikZSectionsHRSChannel[depth=61.2, width=22.9, flange thickness=1.96, web thickness=1.19, root radius=1.4, scale=0.16]}}
555
556 \ReferenceRow
557 {TikZSectionsEqualAngle}
558 {Hot-rolled equal angle.}
559 {\keyname{leg}, \keyname{thickness}, \keyname{root radius}}
560 {\TikZSectionsEqualAngle[leg=35, thickness=3, root radius=2, scale=0.18]}
561 {}
562 {\ShapePreview{\TikZSectionsEqualAngle[leg=35, thickness=3, root radius=2, scale=0.18]}}
563
564 \ReferenceRow
565 {TikZSectionsUnequalAngle}
566 {Hot-rolled unequal angle.}
567 {\keyname{vertical leg}, \keyname{horizontal leg}, \keyname{thickness}, \keyname{root radius}}
568 {\TikZSectionsUnequalAngle[vertical leg=45, horizontal leg=30, thickness=3, root radius=2, scale=0.18]}
569 {}
570 {\ShapePreview{\TikZSectionsUnequalAngle[vertical leg=45, horizontal leg=30, thickness=3, root radius=2, scale=0.18]}}
571
572 \ReferenceRow
573 {TikZSectionsPlate}
574 {Plate rectangle.}
575 {\keyname{width}, \keyname{thickness}, \keyname{filled}, \keyname{reference line width}}
576 {\TikZSectionsPlate[width=40, thickness=8, filled=true, scale=0.2]}
577 {}
578 {\WideShapePreview{\TikZSectionsPlate[width=40, thickness=8, filled=true, scale=0.2]}}
579
580 \ReferenceRow
581 {TikZSectionsFlatBar}
582 {Flat bar.}
583 {\keyname{width}, \keyname{thickness}, \keyname{filled}, \keyname{reference line width}}
584 {\TikZSectionsFlatBar[width=40, thickness=8, filled=true, scale=0.2]}
585 {}
586 {\WideShapePreview{\TikZSectionsFlatBar[width=40, thickness=8, filled=true, scale=0.2]}}
587
588 \ReferenceRow
589 {TikZSectionsRoundBar}
590 {Round bar.}
591 {\keyname{radius}, \keyname{line width}, \keyname{filled}}
592 {\TikZSectionsRoundBar[radius=10, line width=1, filled=true, scale=0.2]}
593 {}
594 {\ShapePreview{\TikZSectionsRoundBar[radius=10, line width=1, filled=true, scale=0.2]}}
595
596 \ReferenceRow
597 {TikZSectionsHRSCHS}
598 {Hot-rolled circular hollow section.}
599 {\keyname{radius}, \keyname{thickness}, \keyname{filled}}
600 {\TikZSectionsHRSCHS[radius=20, thickness=3, filled=true, scale=0.18]}
601 {}
602 {\ShapePreview{\TikZSectionsHRSCHS[radius=20, thickness=3, filled=true, scale=0.18]}}
603
604 \ReferenceRow
605 {TikZSectionsHRSRHS}
606 {Hot-rolled rectangular hollow section.}
607 {\keyname{depth}, \keyname{width}, \keyname{thickness}, \keyname{root radius}, \keyname{filled}}
608 {\TikZSectionsHRSRHS[depth=50, width=35, thickness=3, root radius=4, filled=true, scale=0.18]}
609 {}
610 {\ShapePreview{\TikZSectionsHRSRHS[depth=50, width=35, thickness=3, root radius=4, filled=true, scale=0.18]}}
611
612 \ReferenceRow
613 {TikZSectionsHRSSHS}
614 {Hot-rolled square hollow section.}
615 {\keyname{width}, \keyname{thickness}, \keyname{root radius}, \keyname{filled}}
616 {\TikZSectionsHRSSHS[width=40, thickness=3, root radius=4, filled=true, scale=0.18]}
617 {}
618 {\ShapePreview{\TikZSectionsHRSSHS[width=40, thickness=3, root radius=4, filled=true, scale=0.18]}}
619
620 \subsection{Reinforced Concrete}
621
622 \ReferenceRow
623 {TikZRCRectangular}
624 {Rectangular concrete section with top, bottom, and optional side bars.}
625 {\keyname{width}, \keyname{depth}, \keyname{cover}, \keyname{bar diameter}, \keyname{top bars}, \keyname{bottom bars}, \keyname{left bars}, \keyname{right bars}}
626 {\TikZRCRectangular[width=300, depth=500, cover=40, bar diameter=18, top bars=2, bottom bars=3, bottom layers=2, layer spacing=28, scale=0.025]}
627 {}
628 {\ShapePreview{\TikZRCRectangular[width=300, depth=500, cover=40, bar diameter=18, top bars=2, bottom bars=3, bottom layers=2, layer spacing=28, scale=0.025]}}
629
630 \ReferenceRow
631 {TikZRCCircular}
632 {Circular concrete section with perimeter bars.}
633 {\keyname{diameter}, \keyname{cover}, \keyname{bar diameter}, \keyname{perimeter bars}, \keyname{tie}}
634 {\TikZRCCircular[diameter=450, cover=45, bar diameter=20, perimeter bars=10, scale=0.025]}
635 {}
636 {\ShapePreview{\TikZRCCircular[diameter=450, cover=45, bar diameter=20, perimeter bars=10, scale=0.025]}}
637
638 \section{Composing Sections With TikZ}
639
640 TikZ-Sections focuses on single-section primitives. Built-up assemblies should
641 be made with ordinary TikZ scopes and transforms so users can compose any
642 combination without package-specific built-up commands.
643
644 \begin{center}
645 \begin{tabular}{@{}ccc@{}}
646 \begin{adjustbox}{max width=42mm,max height=30mm}
647 \begin{tikzpicture}
648 \TikZSectionsChannel[depth=180, flange=55, lip=18, thickness=2, radius=4, scale=0.03]
649 \begin{scope}[shift={(3.6,0)}, xscale=-1]
650 \TikZSectionsChannel[depth=180, flange=55, lip=18, thickness=2, radius=4, scale=0.03]
651 \end{scope}
652 \node [tikzSections/label] at (1.8,-0.7) {Back-to-back channels};
653 \end{tikzpicture}
654 \end{adjustbox}
655 &
656 \begin{adjustbox}{max width=42mm,max height=30mm}
657 \begin{tikzpicture}
658 \TikZSectionsChannel[depth=180, flange=55, lip=18, thickness=2, radius=4, scale=0.03]
659 \begin{scope}[shift={(6.8,0)}]
660 \TikZSectionsChannel[depth=180, flange=55, lip=18, thickness=2, radius=4, scale=0.03]
661 \end{scope}
662 \draw [tikzSections/hidden] (3.2,0.5) -- (3.6,0.5);
663 \draw [tikzSections/hidden] (3.2,4.9) -- (3.6,4.9);
664 \node [tikzSections/label] at (3.4,-0.7) {Boxed channels};
665 \end{tikzpicture}
666 \end{adjustbox}
667 &
668 \begin{adjustbox}{max width=42mm,max height=30mm}
669 \begin{tikzpicture}
670 \TikZSectionsAngle[vertical leg=90, horizontal leg=55, thickness=2, radius=4, scale=0.04]
671 \begin{scope}[shift={(4.8,0)}, xscale=-1]
672 \TikZSectionsAngle[vertical leg=90, horizontal leg=55, thickness=2, radius=4, scale=0.04]
673 \end{scope}
674 \fill (2.2,1.2) circle [radius=0.08];
675 \fill (2.2,2.4) circle [radius=0.08];
676 \node [tikzSections/label] at (2.4,-0.7) {Double angles};
677 \end{tikzpicture}
678 \end{adjustbox}
679 \end{tabular}
680 \par\vspace{5mm}
681 \begin{tabular}{@{}ccc@{}}
682 \begin{adjustbox}{max width=42mm,max height=30mm}
683 \begin{tikzpicture}
684 \TikZSectionsChannel[depth=180, flange=55, lip=18, thickness=2, radius=4, scale=0.03]
685 \begin{scope}[shift={(3.3,0)}]
686 \TikZSectionsChannel[depth=180, flange=55, lip=18, thickness=2, radius=4, scale=0.03]
687 \end{scope}
688 \fill (3.1,1.1) circle [radius=0.07];
689 \fill (3.1,4.3) circle [radius=0.07];
690 \node [tikzSections/label] at (3.1,-0.7) {Toe-to-toe channels};
691 \end{tikzpicture}
692 \end{adjustbox}
693 &
694 \begin{adjustbox}{max width=42mm,max height=30mm}
695 \begin{tikzpicture}
696 \TikZSectionsChannel[depth=180, flange=65, lip=18, thickness=2, radius=4, scale=0.03]
697 \begin{scope}[shift={(1.1,0.45)}, xscale=-1, scale=0.85]
698 \TikZSectionsChannel[depth=180, flange=50, lip=14, thickness=2, radius=4, scale=0.03]
699 \end{scope}
700 \node [tikzSections/label] at (1.9,-0.7) {Nested channels};
701 \end{tikzpicture}
702 \end{adjustbox}
703 &
704 \begin{adjustbox}{max width=42mm,max height=30mm}
705 \begin{tikzpicture}
706 \TikZSectionsChannel[depth=180, flange=55, lip=18, thickness=2, radius=4, scale=0.03]
707 \begin{scope}[shift={(3.6,0)}, xscale=-1]
708 \TikZSectionsChannel[depth=180, flange=55, lip=18, thickness=2, radius=4, scale=0.03]
709 \end{scope}
710 \draw [tikzSections/hidden, line width=0.35mm] (1.3,1.2) -- (2.3,1.2);
711 \draw [tikzSections/hidden, line width=0.35mm] (1.3,4.2) -- (2.3,4.2);
712 \fill (1.8,1.2) circle [radius=0.08];
713 \fill (1.8,4.2) circle [radius=0.08];
714 \node [tikzSections/label] at (1.8,-0.7) {Channels with bolts};
715 \end{tikzpicture}
716 \end{adjustbox}
717 \end{tabular}
718 \end{center}
719
720 \begin{lstlisting}
721 \begin{tikzpicture}
722 \TikZSectionsChannel[
723 depth=180,
724 flange=55,
725 lip=18,
726 thickness=2,
727 radius=4,
728 scale=0.03
729 ]
730 \begin{scope}[shift={(4,0)}, xscale=-1]
731 \TikZSectionsChannel[
732 depth=180,
733 flange=55,
734 lip=18,
735 thickness=2,
736 radius=4,
737 scale=0.03
738 ]
739 \end{scope}
740 \end{tikzpicture}
741 \end{lstlisting}
742
743 The same composition pattern can be used for toe-to-toe channels, nested
744 channels, bolts, weld marks, or plates. TikZ additions are drawn in the same
745 picture as the section commands, so the package does not need a separate
746 built-up command family for each assembly.
747
748 \section{Positional Helper Commands}
749
750 The following lower-level helper commands use positional
751 arguments and therefore are less self-documenting than the public key-value API.
752
753 \begin{footnotesize}
754 \begin{longtable}{@{}L{0.39\linewidth}L{0.53\linewidth}@{}}
755 \toprule
756 Command & Positional arguments \\
757 \midrule
758 \smallcommand{csCFSChannel} & depth, flange, thickness, radius \\
759 \smallcommand{csCFSLippedChannel} & depth, flange, lip, thickness, radius \\
760 \smallcommand{csCFSChannelGeneral} & depth, top flange, top lip, bottom flange, bottom lip, thickness, radius \\
761 \smallcommand{csCFSEdgeStiffenedChannel} & depth, flange, lip, thickness, radius \\
762 \smallcommand{csCFSChannelWithOneStiffener} & depth, top flange, top lip, bottom flange, bottom lip, thickness, radius, position \\
763 \smallcommand{csCFSChannelWithTwoStiffeners} & depth, top flange, top lip, bottom flange, bottom lip, thickness, radius \\
764 \smallcommand{csCFSChannelWithThreeStiffeners} & depth, top flange, top lip, bottom flange, bottom lip, thickness, radius, position \\
765 \smallcommand{csCFSZee} & depth, flange, thickness, radius \\
766 \smallcommand{csCFSLippedZee} & depth, flange, lip, thickness, radius \\
767 \smallcommand{csCFSZeeGeneral} & depth, top flange, top lip, bottom flange, bottom lip, thickness, radius \\
768 \smallcommand{csCFSSigma} & depth, top flange, top lip, bottom flange, bottom lip, thickness, radius \\
769 \smallcommand{csCFSHat} & depth, left flange, width, right flange, thickness, radius \\
770 \smallcommand{csCFSAngle} & vertical leg, horizontal leg, thickness, radius \\
771 \smallcommand{csCFSLippedAngle} & vertical leg, horizontal leg, thickness, radius, lip \\
772 \smallcommand{csCFSBox}, \smallcommand{csCFSRHS} & depth, width, thickness, radius \\
773 \smallcommand{csCFSSHS} & width, thickness, radius \\
774 \smallcommand{csCFSCHS} & radius, thickness \\
775 \smallcommand{csCFSFoldedPlate} & point list, thickness \\
776 \smallcommand{csHRSUniversalBeam}, \smallcommand{csHRSUniversalColumn}, \smallcommand{csHRSISection} & depth, width, flange thickness, web thickness, root radius \\
777 \smallcommand{csHRSWeldedI} & web depth, web thickness, bottom flange width, bottom flange thickness, top flange width, top flange thickness \\
778 \smallcommand{csHRSTee}, \smallcommand{csHRSChannel} & depth, width, flange thickness, web thickness, root radius \\
779 \smallcommand{csHRSEqualAngle} & leg, thickness, root radius \\
780 \smallcommand{csHRSUnequalAngle} & vertical leg, horizontal leg, thickness, root radius \\
781 \smallcommand{csHRSPlate}, \smallcommand{csHRSFlatBar} & width, thickness, reference line width \\
782 \smallcommand{csHRSRoundBar}, \smallcommand{csHRSCHS} & radius, thickness or line width \\
783 \smallcommand{csHRSRHS} & depth, width, thickness, root radius \\
784 \smallcommand{csHRSSHS} & width, thickness, root radius \\
785 \bottomrule
786 \end{longtable}
787 \end{footnotesize}
788
789 \section{Current Limitations}
790
791 \begin{itemize}
792 \item The \keyname{dimensions=true} feature is currently a mix of
793 section-specific legends for channel and zee commands and the older generic
794 overlay for other families. It is not yet a standard-based engineering
795 dimensioning system.
796 \item RC cross-sections are schematic. Stirrups are drawn around the outside
797 edge of the longitudinal bar envelope, but beam elevations, column elevations,
798 slab/wall detailing, and reinforcement spacing along member length remain
799 future work.
800 \item The \keyname{simplified} and \keyname{detailed} mode contract is defined
801 first for CFS channel, stiffened-channel, zee, and sigma inputs. Detailed
802 rolled-radius behavior is still future work.
803 \item Generated figures are schematic cross-section sketches. They are not
804 section-property calculators and do not validate engineering dimensions.
805 \end{itemize}
806
807 \end{document}