Skip to content
tikzfigure

Paths and Shapes

Beyond simple node-to-node connections, tikzfigure lets you draw arbitrary paths from lists of (x, y) coordinates.

  • drawing open and closed coordinate paths
  • filldraw for filled closed shapes
  • rounded corners
  • per-segment styling with segment_options
  • node paths and .center anchors for correct fills
  • custom shapes (heart, star)
  • parametric curves with NumPy (spiral, sun)
  • fill for stroke-free fills and even-odd rule
  • clip for clipping regions
  • path for invisible named paths and mid-path labels
import numpy as np


from tikzfigure import TikzFigure

Open and closed coordinate paths

Section titled “Open and closed coordinate paths”

Pass a list of [x, y] pairs (or (x, y) tuples) to fig.draw(). Set cycle=True to close the path back to the starting point.

fig = TikzFigure()


# Open path - a zigzag
zigzag = [[0, 0], [1, 1], [2, 0], [3, 1], [4, 0]]
fig.draw(zigzag, line_width=2, color="blue")


# Closed path - a triangle
triangle = [[6, 0], [8, 0], [7, 1.5]]
fig.draw(triangle, cycle=True, line_width=2, color="red")


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \draw[color=blue, line width=2] (0, 0) to (1, 1) to (2, 0) to (3, 1) to (4, 0);
    \draw[color=red, line width=2] (6, 0) to (8, 0) to (7, 1.5) -- cycle;
\end{tikzpicture}

Filled shapes with filldraw

Section titled “Filled shapes with filldraw”

fig.filldraw() is shorthand for a closed path that is both drawn (outline) and filled. You can also use fig.draw(..., fill="color") for the same effect.

fig = TikzFigure()


# Pentagon via filldraw
angles = np.linspace(np.pi / 2, np.pi / 2 + 2 * np.pi, 6)[:-1]
pentagon = list(zip(np.cos(angles) * 2 + 2, np.sin(angles) * 2 + 2))
fig.filldraw(pentagon, cycle=True, line_width=2, color="purple", fill="purple!20")


# Same via draw(..., fill=...)
hexagon_angles = np.linspace(0, 2 * np.pi, 7)[:-1]
hexagon = list(zip(np.cos(hexagon_angles) * 2 + 7, np.sin(hexagon_angles) * 2 + 2))
fig.draw(hexagon, cycle=True, line_width=2, color="teal", fill="teal!20")


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \filldraw[color=purple, fill=purple!20, line width=2] (2.0, 4.0) to (0.09788696740969294, 2.618033988749895) to (0.8244294954150535, 0.3819660112501053) to (3.175570504584946, 0.3819660112501049) to (3.9021130325903073, 2.6180339887498945) -- cycle;
    \draw[color=teal, fill=teal!20, line width=2] (9.0, 2.0) to (8.0, 3.732050807568877) to (6.0, 3.7320508075688776) to (5.0, 2.0000000000000004) to (5.999999999999999, 0.26794919243112325) to (7.999999999999998, 0.2679491924311219) -- cycle;
\end{tikzpicture}

Rounded corners

Section titled “Rounded corners”

The rounded_corners parameter (in pt) smooths the corners of any path.

fig = TikzFigure()


# Same square, with increasing corner radius
for i, radius in enumerate([0, 5, 15, 30]):
    x0 = i * 3.5
    square = [[x0, 0], [x0 + 2, 0], [x0 + 2, 2], [x0, 2]]
    fig.draw(
        square,
        cycle=True,
        line_width=2,
        color="black",
        fill="orange!20",
        rounded_corners=f"{radius}pt",
    )
    fig.add_node(x0 + 1, -0.5, content=f"{radius}pt", draw="none")


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \draw[color=black, fill=orange!20, line width=2, rounded corners=0pt] (0.0, 0) to (2.0, 0) to (2.0, 2) to (0.0, 2) -- cycle;
    \node[draw=none] (node0) at ({1.0}, {-0.5}) {0pt};
    \draw[color=black, fill=orange!20, line width=2, rounded corners=5pt] (3.5, 0) to (5.5, 0) to (5.5, 2) to (3.5, 2) -- cycle;
    \node[draw=none] (node1) at ({4.5}, {-0.5}) {5pt};
    \draw[color=black, fill=orange!20, line width=2, rounded corners=15pt] (7.0, 0) to (9.0, 0) to (9.0, 2) to (7.0, 2) -- cycle;
    \node[draw=none] (node2) at ({8.0}, {-0.5}) {15pt};
    \draw[color=black, fill=orange!20, line width=2, rounded corners=30pt] (10.5, 0) to (12.5, 0) to (12.5, 2) to (10.5, 2) -- cycle;
    \node[draw=none] (node3) at ({11.5}, {-0.5}) {30pt};
\end{tikzpicture}

Per-segment styling

Section titled “Per-segment styling”

segment_options accepts a list of per-connector option dicts, one for each to step in the path. Each dict uses keyword-style TikZ options (underscores become spaces) plus an optional "options" key for flag-style items like "dashed" or `“->”.

Here four segments are given different colors and styles in a single draw call:

fig = TikzFigure()


waypoints = [[0, 0], [2, 2], [4, 0], [6, 2], [8, 0]]


fig.draw(
    waypoints,
    line_width=2,
    segment_options=[
        {"color": "red"},
        {"color": "blue", "options": ["dashed"], "line_width": 1.5},
        {"color": "green!60!black", "line_width": 3},
        {"color": "purple", "options": ["dotted"], "line_width": 2},
    ],
)


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \draw[line width=2] (0, 0) to[color=red] (2, 2) to[dashed, color=blue, line width=1.5] (4, 0) to[color=green!60!black, line width=3] (6, 2) to[dotted, color=purple, line width=2] (8, 0);
\end{tikzpicture}

Per-segment bending works the same way. Here three nodes are connected with arrows where each segment curves in a different direction:

fig = TikzFigure()


specs = [("src", 0, 1, "teal"), ("mid", 4, 3, "orange"), ("dst", 8, 1, "purple")]
for label, x, y, color in specs:
    fig.add_node(
        x=x,
        y=y,
        label=label,
        shape="circle",
        fill=f"{color}!25",
        draw=f"{color}!70",
        minimum_size="1cm",
        content=label.upper(),
    )


fig.draw(
    ["src.center", "mid.center", "dst.center"],
    arrows="->",
    thick=True,
    segment_options=[
        {"bend_left": 30},  # src → mid curves upward-left
        {"bend_right": 25},  # mid → dst curves downward-right
    ],
)


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \node[shape=circle, fill=teal!25, draw=teal!70, minimum size=1cm] (src) at ({0}, {1}) {SRC};
    \node[shape=circle, fill=orange!25, draw=orange!70, minimum size=1cm] (mid) at ({4}, {3}) {MID};
    \node[shape=circle, fill=purple!25, draw=purple!70, minimum size=1cm] (dst) at ({8}, {1}) {DST};
    \draw[thick=True, arrows=->] (src.center) to[bend left=30] (mid.center) to[bend right=25] (dst.center);
\end{tikzpicture}

Fluent node chaining

Section titled “Fluent node chaining”

If you’re connecting named nodes, .to(...) is a concise alternative to building segment_options by hand. Options passed to .to(...) affect only that connector.

fig = TikzFigure()


A = fig.add_node(
    x=0,
    y=1,
    label="A",
    shape="circle",
    fill="teal!25",
    draw="teal!70",
    minimum_size="1cm",
    content="A",
)
B = fig.add_node(
    x=4,
    y=3,
    label="B",
    shape="circle",
    fill="orange!25",
    draw="orange!70",
    minimum_size="1cm",
    content="B",
)
C = fig.add_node(
    x=8,
    y=1,
    label="C",
    shape="circle",
    fill="purple!25",
    draw="purple!70",
    minimum_size="1cm",
    content="C",
)


fig.draw(
    A.to(B).to(C, options=["bend left"]),
    arrows="->",
    thick=True,
    color="teal!70",
)


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \node[shape=circle, fill=teal!25, draw=teal!70, minimum size=1cm] (A) at ({0}, {1}) {A};
    \node[shape=circle, fill=orange!25, draw=orange!70, minimum size=1cm] (B) at ({4}, {3}) {B};
    \node[shape=circle, fill=purple!25, draw=purple!70, minimum size=1cm] (C) at ({8}, {1}) {C};
    \draw[thick=True, color=teal!70, arrows=->] (A) to (B) to[bend left] (C);
\end{tikzpicture}

Use "out" and "in" keys for explicit departure and arrival angles (in degrees). This gives precise control over how each segment enters and leaves its endpoints — useful when bend_left/bend_right doesn’t give you the exact shape you need:

fig = TikzFigure()


for label, x, y, color in [
    ("A", 0, 2, "blue"),
    ("B", 5, 4, "orange"),
    ("C", 10, 2, "purple"),
]:
    fig.add_node(
        x=x,
        y=y,
        label=label,
        shape="circle",
        fill=f"{color}!20",
        draw=f"{color}!70",
        minimum_size="1.2cm",
        content=f"${label}$",
    )


fig.draw(
    ["A.center", "B.center", "C.center"],
    arrows="->",
    thick=True,
    segment_options=[
        {"out": 45, "in": 195},  # A→B: leave at 45°, arrive at 195°
        {"out": -15, "in": 135},  # B→C: leave at -15°, arrive at 135°
    ],
)


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \node[shape=circle, fill=blue!20, draw=blue!70, minimum size=1.2cm] (A) at ({0}, {2}) {$A$};
    \node[shape=circle, fill=orange!20, draw=orange!70, minimum size=1.2cm] (B) at ({5}, {4}) {$B$};
    \node[shape=circle, fill=purple!20, draw=purple!70, minimum size=1.2cm] (C) at ({10}, {2}) {$C$};
    \draw[thick=True, arrows=->] (A.center) to[out=45, in=195] (B.center) to[out=-15, in=135] (C.center);
\end{tikzpicture}

looseness scales how far the control handles extend, making the same bend either tighter (looseness < 1) or more exaggerated (looseness > 1). Here the two segments of the same symmetric path use opposite looseness values:

fig = TikzFigure()


for label, x, y in [("A", 0, 2), ("B", 5, 2), ("C", 10, 2)]:
    fig.add_node(
        x=x,
        y=y,
        label=label,
        shape="circle",
        fill="gray!15",
        draw="gray!60",
        minimum_size="1cm",
        content=f"${label}$",
    )


fig.draw(
    ["A.center", "B.center", "C.center"],
    arrows="->",
    thick=True,
    segment_options=[
        {"bend_left": 50, "looseness": 2.5},  # A→B: wide exaggerated arc
        {"bend_right": 50, "looseness": 0.5},  # B→C: tight compressed arc
    ],
)


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \node[shape=circle, fill=gray!15, draw=gray!60, minimum size=1cm] (A) at ({0}, {2}) {$A$};
    \node[shape=circle, fill=gray!15, draw=gray!60, minimum size=1cm] (B) at ({5}, {2}) {$B$};
    \node[shape=circle, fill=gray!15, draw=gray!60, minimum size=1cm] (C) at ({10}, {2}) {$C$};
    \draw[thick=True, arrows=->] (A.center) to[bend left=50, looseness=2.5] (B.center) to[bend right=50, looseness=0.5] (C.center);
\end{tikzpicture}

All segment options can be combined freely. Here each segment gets its own color, line style, and curve geometry in a single draw call:

fig = TikzFigure()


for label, x, y, color in [
    ("A", 0, 0, "teal"),
    ("B", 4, 3, "red"),
    ("C", 8, 0, "blue"),
]:
    fig.add_node(
        x=x,
        y=y,
        label=label,
        shape="circle",
        fill=f"{color}!20",
        draw=f"{color}!60",
        minimum_size="1.2cm",
        content=f"${label}$",
    )


fig.draw(
    ["A.center", "B.center", "C.center"],
    segment_options=[
        {  # A→B
            "options": ["->"],
            "color": "teal!80",
            "line_width": 2,
            "out": 60,
            "in": 240,
        },
        {  # B→C
            "options": ["->", "dashed"],
            "color": "red!70",
            "line_width": 1.5,
            "out": -60,
            "in": 120,
        },
    ],
)


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \node[shape=circle, fill=teal!20, draw=teal!60, minimum size=1.2cm] (A) at ({0}, {0}) {$A$};
    \node[shape=circle, fill=red!20, draw=red!60, minimum size=1.2cm] (B) at ({4}, {3}) {$B$};
    \node[shape=circle, fill=blue!20, draw=blue!60, minimum size=1.2cm] (C) at ({8}, {0}) {$C$};
    \draw[] (A.center) to[->, color=teal!80, line width=2, out=60, in=240] (B.center) to[->, dashed, color=red!70, line width=1.5, out=-60, in=120] (C.center);
\end{tikzpicture}

Node paths and .center anchors

Section titled “Node paths and .center anchors”

When you fill a closed path that goes through named nodes, TikZ routes to each node’s border by default. For circular nodes this means the filled area has indented corners — it doesn’t look like a triangle.

Appending .center to a node label in the path list routes the segment through the node’s geometric center instead. The path then bounds a proper filled polygon.

fig = TikzFigure()


node_specs = [
    ("top", 3, 4, "blue", r"$v_1$"),
    ("bl", 0, 0, "blue", r"$v_2$"),
    ("br", 6, 0, "blue", r"$v_3$"),
]
for label, x, y, color, text in node_specs:
    fig.add_node(
        x=x,
        y=y,
        label=label,
        shape="circle",
        draw=f"{color}!60",
        fill="white",
        minimum_size="1.4cm",
        content=text,
    )


# Border anchors: the fill "leaks" under the node circles
fig.draw(
    ["top", "bl", "br"],
    cycle=True,
    fill="red!25",
    draw="red!60",
    line_width=1,
    fill_opacity=0.6,
)


# .center anchors: fills the exact triangle spanned by node centres
fig.draw(
    ["top.center", "bl.center", "br.center"],
    cycle=True,
    fill="blue!30",
    draw="blue!70",
    line_width=1.5,
    fill_opacity=0.7,
)


# Labels outside the shapes
fig.add_node(
    x=7.5,
    y=2,
    content=r"\textcolor{red!60}{border anchors}",
    draw="none",
    anchor="west",
    font=r"\small",
)
fig.add_node(
    x=7.5,
    y=1,
    content=r"\textcolor{blue!70}{.center anchors}",
    draw="none",
    anchor="west",
    font=r"\small",
)


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \node[shape=circle, fill=white, draw=blue!60, minimum size=1.4cm] (top) at ({3}, {4}) {$v_1$};
    \node[shape=circle, fill=white, draw=blue!60, minimum size=1.4cm] (bl) at ({0}, {0}) {$v_2$};
    \node[shape=circle, fill=white, draw=blue!60, minimum size=1.4cm] (br) at ({6}, {0}) {$v_3$};
    \draw[fill=red!25, draw=red!60, fill opacity=0.6, line width=1] (top) to (bl) to (br) -- cycle;
    \draw[fill=blue!30, draw=blue!70, fill opacity=0.7, line width=1.5] (top.center) to (bl.center) to (br.center) -- cycle;
    \node[draw=none, font=\small, anchor=west] (node3) at ({7.5}, {2}) {\textcolor{red!60}{border anchors}};
    \node[draw=none, font=\small, anchor=west] (node4) at ({7.5}, {1}) {\textcolor{blue!70}{.center anchors}};
\end{tikzpicture}

You can mix anchors: only the nodes that need a specific anchor require the dot suffix. Any TikZ anchor string works — "north", "south east", "west", etc.

fig = TikzFigure()


fig.add_node(
    x=0,
    y=0,
    label="A",
    shape="rectangle",
    draw="black",
    fill="gray!15",
    minimum_width="2cm",
    minimum_height="1cm",
    content="A",
)
fig.add_node(
    x=5,
    y=2,
    label="B",
    shape="rectangle",
    draw="black",
    fill="gray!15",
    minimum_width="2cm",
    minimum_height="1cm",
    content="B",
)
fig.add_node(
    x=10,
    y=0,
    label="C",
    shape="rectangle",
    draw="black",
    fill="gray!15",
    minimum_width="2cm",
    minimum_height="1cm",
    content="C",
)


# Connect from the east side of A, enter B from the west, leave from east, arrive at C.west
fig.draw(
    ["A.east", "B.west"],
    arrows="->",
    thick=True,
    color="teal",
    segment_options=[{"bend_left": 15}],
)
fig.draw(
    ["B.east", "C.west"],
    arrows="->",
    thick=True,
    color="orange",
    segment_options=[{"bend_right": 15}],
)


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \node[shape=rectangle, fill=gray!15, draw=black, minimum width=2cm, minimum height=1cm] (A) at ({0}, {0}) {A};
    \node[shape=rectangle, fill=gray!15, draw=black, minimum width=2cm, minimum height=1cm] (B) at ({5}, {2}) {B};
    \node[shape=rectangle, fill=gray!15, draw=black, minimum width=2cm, minimum height=1cm] (C) at ({10}, {0}) {C};
    \draw[thick=True, color=teal, arrows=->] (A.east) to[bend left=15] (B.west);
    \draw[thick=True, color=orange, arrows=->] (B.east) to[bend right=15] (C.west);
\end{tikzpicture}

Heart shape

Section titled “Heart shape”

A heart with circular lobes drawn by fig.arc() and a pointed bottom built from a chained path.

width, height = 1.75, 2.0


fig = TikzFigure()


fig.colorlet("lightred", "red!40!white")


A = fig.add_node(-width, height)
B = fig.add_node(0, 0)
C = fig.add_node(width, height)
D = fig.add_node(0, height)


fig.draw(
    A.to(B, options=["out=-90, in=135"])
    .to(C, options=["out=45, in=-90"])
    .to(D, options=["in=80, out=100"])
    .to(A, options=["in=80, out=100"]),
    color="red",
    line_width=4,
    cycle=True,
    center=True,
    fill="lightred",
)


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \colorlet{lightred}{red!40!white}
    \node (node0) at ({-1.75}, {2.0}) {};
    \node (node1) at ({0}, {0}) {};
    \node (node2) at ({1.75}, {2.0}) {};
    \node (node3) at ({0}, {2.0}) {};
    \draw[color=red, fill=lightred, line width=4] (node0.center) to[out=-90, in=135] (node1.center) to[out=45, in=-90] (node2.center) to[in=80, out=100] (node3.center) to[in=80, out=100] (node0.center) -- cycle;
\end{tikzpicture}

Star shape

Section titled “Star shape”

A five-pointed star drawn from six points (the last one closes back to the first).

fig = TikzFigure()


star = [[0, 0], [1, 2.5], [2, 0], [-0.5, 1.5], [2.5, 1.5], [0, 0]]


fig.draw(star, line_width=3, cycle=True, color="gold", fill="yellow!50!white")


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \draw[color=gold, fill=yellow!50!white, line width=3] (0, 0) to (1, 2.5) to (2, 0) to (-0.5, 1.5) to (2.5, 1.5) to (0, 0) -- cycle;
\end{tikzpicture}

Parametric curves with NumPy

Section titled “Parametric curves with NumPy”

Any iterable of (x, y) pairs works as a path, so NumPy arrays plug in naturally for smooth parametric curves.

fig = TikzFigure()


# Spiral
N = 300
theta = np.linspace(0, 8 * np.pi, N)
r = np.linspace(0.1, 3, N)
spiral = list(zip(r * np.cos(theta) + 4, r * np.sin(theta) + 4))
fig.draw(spiral, line_width=2, color="teal")


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \draw[color=teal, line width=2] (4.1, 4.0) to (4.109311690604932, 4.009210003491806) to (4.117714771684789, 4.0199778210498645) to (4.125014140190605, 4.0322102091087375) to (4.1310244108487, 4.0457922445851455) to (4.135572170308709, 4.060588337957058) to (4.138498126494149, 4.076443470909478) to (4.139659131447931, 4.093184647828918) to (4.138930057047688, 4.110622548377246) to (4.136205504238648, 4.1285533664322065) to (4.131401327884473, 4.146760818863925) to (4.1244559609566736, 4.16501830594048) to (4.115331523557323, 4.183091203636362) to (4.1040147041826955, 4.200739266769233) to (4.090517402670937, 4.217719120725341) to (4.074877126417452, 4.233786818563121) to (4.057157133669126, 4.248700439517244) to (4.037446320003529, 4.262222704369247) to (4.015858846442181, 4.274123582811634) to (3.992533510017395, 4.2841828678139935) to (3.9676328599896475, 4.292192692104246) to (3.941342065276122, 4.297959962205803) to (3.9138675409802377, 4.30130868602048) to (3.885435344186258, 4.302082170713749) to (3.8562893513822503, 4.300145068637881) to (3.8266892319792523, 4.295385250212327) to (3.7969082343856337, 4.287715484060199) to (3.7672308029553765, 4.277074906264027) to (3.737950045840418, 4.263430262340699) to (3.7093650753245533, 4.246776907430545) to (3.681778243585305, 4.227139552233507) to (3.6554922980075863, 4.204572744389498) to (3.630807481147599, 4.17916107727256) to (3.608018601207345, 4.151019120530304) to (3.587412099421529, 4.120291069131659) to (3.569263141073152, 4.087150110166676) to (3.553832756937631, 4.051797509150986) to (3.5413650618053008, 4.014461420103296) to (3.5320845763484034, 3.9753954261652082) to (3.5261936779826244, 3.9348768199974473) to (3.52387020552851, 3.893204635593605) to (3.5252652414101338, 3.85069744548097) to (3.530501093844663, 3.8076909395072507) to (3.5396694999861733, 3.764535303522364) to (3.5528300693013968, 3.7215924182369275) to (3.570008984586681, 3.679232900355887) to (3.59119797599886, 3.637833009730027) to (3.6163535812837715, 3.5977714477247242) to (3.64539670306219, 3.559426073260176) to (3.678212471592496, 3.5231705640183164) to (3.7146504188920964, 3.4893710511280034) to (3.75452496748613, 3.4583827562230924) to (3.7976162343836215, 3.4305466601108) to (3.8436711481800505, 3.4061862323852834) to (3.89240487447371, 3.385604251170749) to (3.9435025420838534, 3.3690797417786618) to (3.99662125989433, 3.3568650624159764) to (4.051392411539689, 3.3491831641889314) to (4.107424212624047, 3.3462250515150984) to (4.164304512738048, 3.348147467692402) to (4.2216038222373165, 3.3550708287869453) to (4.278878541587029, 3.367077427202888) to (4.3356743690811115, 3.384209924300377) to (4.391529860928941, 3.4064701492463185) to (4.445980116084311, 3.433818218934088) to (4.4985605567858, 3.466171991309892) to (4.548810774598426, 3.5034068618148217) to (4.596278410805294, 3.545355909913034) to (4.640523039304923, 3.591810399849669) to (4.681120019733238, 3.642520636889409) to (4.717664288354684, 3.6971971773512813) to (4.749774054358706, 3.755512387801085) to (4.777094369557643, 3.8171023458137556) to (4.799300540109522, 3.8815690717983866) to (4.81610134978189, 3.948483078512567) to (4.827242065425743, 4.017386222104297) to (4.832507196735177, 4.087794835832393) to (4.831722984019365, 4.159203125053068) to (4.824759589597898, 4.23108679964319) to (4.8115329705354135, 4.302906917780902) to (4.792006412741653, 4.374113912941549) to (4.766191708962131, 4.444151774109996) to (4.734149965853832, 4.5124623475763475) to (4.695992028160028, 4.57848972728637) to (4.6518785109469265, 4.641684699574141) to (4.6020194339200575, 4.701509207224346) to (4.546673454976266, 4.7574407972049935) to (4.486146703343656, 4.808977016085644) to (4.420791215891436, 4.855639717117026) to (4.351002983428912, 4.896979243198253) to (4.277219617031749, 4.932578450498688) to (4.19991764760824, 4.962056538331326) to (4.11960947502259, 4.985072651989608) to (4.036839986100817, 5.001329226653805) to (3.9521828637325687, 5.010575042138111) to (3.8662366120248435, 5.012607960174699) to (3.779620325037803, 5.007277318103636) to (3.692969229016575, 4.994485955242612) to (3.6069300302050586, 4.974191850831307) to (3.5221561022690473, 4.94640935526309) to (3.439302549048723, 4.911209999311179) to (3.359021179788755, 4.868722869205431) to (3.2819554351440305, 4.819134538696144) to (3.2087353031184613, 4.762688552627862) to (3.139972264653796, 4.699684460013668) to (3.076254308837327, 4.630476398121851) to (3.018141057637055, 4.555471232635357) to (2.9661590396973487, 4.475126262491855) to (2.9207971520374687, 4.389946501530993) to (2.8825023474917533, 4.300481552537282) to (2.851675584418567, 4.207322092644332) to (2.8286680735926204, 4.111095992331384) to (2.813777855291645, 4.012464093369789) to (2.8072467374057073, 3.9121156740388905) to (2.809257622950045, 3.810763632703469) to (2.8199322526667983, 3.7091394234043524) to (2.8393293854759567, 3.6079877794383437) to (2.867443436401962, 3.5080612629724683) to (2.9042035882820656, 3.410114680532287) to (2.949473390079797, 3.3148994057078722) to (3.0030508510074116, 3.223157651619393) to (3.064669035931683, 3.135616736565021) to (3.133997163725941, 3.052983386826855) to (3.210642206366598, 2.9759381208284923) to (3.2941509826840827, 2.9051297587157197) to (3.3840127367960586, 2.841170100967281) to (3.479662187405185, 2.7846288188360426) to (3.5804830303646242, 2.736028598275184) to (3.6858118732319785, 2.695840577524777) to (3.794942576975589, 2.6644801167296674) to (3.907130976595035, 2.642302935840701) to (4.021599949197854, 2.629601654631389) to (4.137544795063551, 2.6266027659570037) to (4.2541388944491745, 2.6334640704108514) to (4.370539600371495, 2.650272597313588) to (4.485894325361342, 2.677043033528258) to (4.599346778245293, 2.713716677950733) to (4.710043305386844, 2.760160935708458) to (4.817139289528663, 2.816169362137587) to (4.9198055584324925, 2.881462262528791) to (5.01723475492435, 2.9556878494654244) to (5.108647619727661, 3.038423955355467) to (5.1932991386108025, 3.129180293512557) to (5.270484505890866, 3.2274012569038333) to (5.3395448572213455, 3.3324692394855493) to (5.39987272584499, 3.443708460924182) to (5.450917178107661, 3.560389271483003) to (5.492188585995968, 3.6817329099736207) to (5.5232629967687625, 3.8069166839595736) to (5.543786062385813, 3.9350795378845262) to (5.553476494379143, 4.065327971509704) to (5.5521290130438405, 4.196742268010697) to (5.5396167633237665, 4.3283829883284) to (5.515893173509349, 4.45929768591584) to (5.48099323682313, 4.58852779389349) to (5.435034200116007, 4.71511563483939) to (5.378215648203249, 4.8381115020136765) to (5.310818976803174, 4.956580759763882) to (5.233206251570355, 5.069610910189143) to (5.145818455305934, 5.176318572866428) to (5.049173130045745, 5.27585632456589) to (4.94386142533792, 5.367419346407922) to (4.83054456859037, 5.4502518268410185) to (4.709949777860205, 5.523653070143674) to (4.582865641837113, 5.5869832618686885) to (4.4501369960068535, 5.639668844744974) to (4.312659328036245, 5.681207461017641) to (4.171372749265032, 5.711172420026433) to (4.027255572792117, 5.729216652977327) to (3.8813175419744845, 5.735076120331373) to (3.734592756189446, 5.728572640995191) to (3.5881323434190353, 5.709616116523242) to (3.442996931576538, 5.678206127804898) to (3.300248972488229, 5.63443288617951) to (3.160944974050698, 5.578477525568268) to (3.0261276972899247, 5.510611726999158) to (2.896818375840332, 5.431196671796082) to (2.774009015730862, 5.34068132466941) to (2.6586548333043396, 5.239600052946015) to (2.5516668886029885, 5.128569593175321) to (2.453904970626774, 5.0082853813062025) to (2.366170789515964, 4.8795172675105825) to (2.289201528931133, 4.743104641495815) to (2.2236638097128614, 4.599950998762937) to (2.1701481133124405, 4.451017982695781) to (2.1291637105101398, 4.297318941572139) to (2.1011341375980677, 4.139912043539319) to (2.0863932585223552, 3.979892996261087) to (2.0851819474790103, 3.8183874212911357) to (2.0976454221666136, 3.656542936232665) to (2.123831253346704, 3.495521000378879) to (2.1636880715810953, 3.336488581772682) to (2.217064987038314, 3.1806097054556997) to (2.2837117331242442, 3.029036944080029) to (2.363279539432164, 2.8829029130167587) to (2.4553227341625026, 2.7433118326029042) to (2.5593010707722916, 2.611331220215308) to (2.6745827682179635, 2.4879837744423665) to (2.800448248793022, 2.374239512741631) to (2.9360945522743838, 2.271008222626178) to (3.0806403999176415, 2.179132284621581) to (3.2331318768215866, 2.099379922988141) to (3.3925486963544533, 2.0324389375228913) to (3.5578110057359242, 1.9789109666593916) to (3.7277866875358185, 1.9393063285901277) to (3.9012991078169086, 1.9140394832693013) to (4.0771352579474, 1.903425153938811) to (4.254054233768909, 1.9076751422856395) to (4.4307959928549225, 1.9268958665161247) to (4.606090328058412, 1.9610866465549486) to (4.7786659934469835, 2.0101387552799874) to (4.947259917078652, 2.073835249225859) to (5.110626433896721, 2.1518515865683385) to (5.267546471330576, 2.243757034479221) to (5.416836619989137, 2.349016862158332) to (5.557358022130611, 2.4669953100484694) to (5.688025011387385, 2.596959319962881) to (5.807813438516423, 2.7380830051463283) to (5.9157686197274435, 2.8894528336924914) to (6.0110128464039665, 3.050073493294648) to (6.0927523977629425, 3.218874400054573) to (6.16028400118028, 3.394716809056412) to (6.213000688522296, 3.5764014796672488) to (6.250397000843073, 3.7626768440903) to (6.272073498208538, 3.9522476236060213) to (6.277740536160172, 4.143783833223001) to (6.26722127540172, 4.335930112154659) to (6.24045389664671, 4.527315314666835) to (6.1974929981649804, 4.716562293429475) to (6.138510159373769, 4.902297805574112) to (6.0637936597917115, 5.083162470225092) to (5.9737473487696375, 5.257820705350955) to (5.86888866758644, 5.42497057138319) to (5.749845831706503, 5.5833534491796755) to (5.617354187192031, 5.731763480572074) to (5.472251761403154, 5.869056700929417) to (5.315474034155895, 5.994159794888779) to (5.148047961397109, 6.106078408639817) to (4.971085289152903, 6.203904954889749) to (4.785775200969006, 6.286825849862867) to (4.593376347246516, 6.354128125383507) to (4.395208309744601, 6.405205363229663) to (4.192642559034788, 6.439562903498765) to (3.987092966814221, 6.456822283667311) to (3.780005938684487, 6.456724870318043) to (3.5728502362484424, 6.439134651116232) to (3.367106560142872, 6.404040160501191) to (3.164256967886319, 6.351555518679143) to (2.96577420215894, 6.281920569815981) to (2.773111006328514, 6.195500111788119) to (2.5876895046812542, 6.092782216410311) to (2.4108907248996347, 5.974375645673798) to (2.2440443398469627, 5.84100637614803) to (2.088418704670728, 5.693513250276495) to (1.9452112636265038, 5.532842779783124) to (1.8155393988602846, 5.360043132752432) to (1.7004317906812538, 5.176257342106588) to (1.600820355625463, 4.982715779129724) to (1.5175328248738253, 4.780727941339094) to (1.451286021369198, 4.571673609331009) to (1.4026798893047498, 4.356993432195811) to (1.372192324560483, 4.138179005661769) to (1.360174849181094, 3.916762511256756) to (1.366849167153882, 3.6943059884358007) to (1.3923046326003976, 3.472390314782422) to (1.4364966550828666, 3.2526039720255535) to (1.4992460600911253, 3.036531677699588) to (1.5802394159649444, 2.8257429637930533) to (1.679030331568638, 2.6217807846680836) to (1.7950417220196457, 2.4261502368764734) to (1.9275690327309571, 2.240307473243073) to (2.0757844050100154, 2.0656488927313963) to (2.2387417595154053, 1.9035006861519488) to (2.4153827670582784, 1.7551088157278287) to (2.604543669598571, 1.6216295039056332) to (2.80496290787612, 1.5041203036082176) to (3.0152895059818836, 1.403531818388963) to (3.234092157361091, 1.3207001366887505) to (3.4598689512925773, 1.2563400396445843) to (3.6910576738488485, 1.2110390366841615) to (3.9260466127487543, 1.1852522774988081) to (4.163185791405042, 1.1792983829565347) to (4.400798553876146, 1.1933562311387504) to (4.637193419383466, 1.2274627280030441) to (4.870676122578959, 1.2815115852367405) to (5.099561753863689, 1.3552531207208278) to (5.3221869127838755, 1.448295089721869) to (5.5369217868798115, 1.5601045475228523) to (5.742182068343344, 1.690010736745803) to (5.9364406214553895, 1.8372089851632132) to (6.118238815025682, 2.000765592396273) to (6.286197435937275, 2.1796236766094577) to (6.439027102398422, 2.372609945187002) to (6.575538098609998, 2.578442346469836) to (6.694649556248553, 2.7957385529931558) to (6.795397912420222, 3.0230252203448638) to (6.876944578531459, 3.2587479598110862) to (6.938582759817475, 3.5012819574330707) to (6.979743371032608, 3.74894316701145) to (7.0, 3.999999999999997);
\end{tikzpicture}

Sun: circle core + radial rays

Section titled “Sun: circle core + radial rays”

A filled circle for the core, plus short line segments for rays at equal angles.

fig = TikzFigure()


cx, cy, R = 4, 4, 1.0  # center and core radius


# Core
theta = np.linspace(0, 2 * np.pi, 60)
core = list(zip(cx + R * np.cos(theta), cy + R * np.sin(theta)))
fig.filldraw(core, cycle=True, line_width=2, color="orange", fill="yellow!60")


# Rays
for angle in np.linspace(0, 2 * np.pi, 12, endpoint=False):
    x0 = cx + R * np.cos(angle)
    y0 = cy + R * np.sin(angle)
    x1 = cx + (R + 0.7) * np.cos(angle)
    y1 = cy + (R + 0.7) * np.sin(angle)
    fig.draw([(x0, y0), (x1, y1)], line_width=2, color="orange")


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \filldraw[color=orange, fill=yellow!60, line width=2] (5.0, 4.0) to (4.994334800210137, 4.106293485647365) to (4.977403389817867, 4.211382623629624) to (4.949397608468381, 4.314076712021949) to (4.910634772854913, 4.413212185768378) to (4.861554081393806, 4.50766580033884) to (4.802711637930964, 4.596367358538501) to (4.734774150863068, 4.678311836269616) to (4.658511379065039, 4.752570769856138) to (4.574787410214407, 4.818302775908169) to (4.48455087033265, 4.874763084531962) to (4.388824175473321, 4.921311977870413) to (4.288691947339621, 4.957422038362005) to (4.185288724087115, 4.982684124592521) to (4.079786105553083, 4.9968120070307505) to (3.9733794785622254, 4.999645611123452) to (3.867274472716278, 4.991152831004007) to (3.7626733001288852, 4.97142989326471) to (3.66076113388197, 4.940700266671033) to (3.5626926795411444, 4.89931213017122) to (3.4695790918802576, 4.847734427889671) to (3.3824753850538083, 4.786551555802642) to (3.3023684788650156, 4.716456740298315) to (3.230166016570094, 4.6382441836448205) to (3.166686080917485, 4.552800065361193) to (3.1126479249434285, 4.461092501449326) to (3.068663822547662, 4.364160575252822) to (3.035232131185484, 4.2631025642275215) to (3.0127316452786554, 4.159063496019072) to (3.001417304323238, 4.053222174842179) to (3.001417304323238, 3.9467778251578216) to (3.0127316452786554, 3.8409365039809282) to (3.035232131185484, 3.736897435772479) to (3.0686638225476615, 3.635839424747178) to (3.1126479249434285, 3.5389074985506745) to (3.1666860809174846, 3.4471999346388067) to (3.2301660165700934, 3.3617558163551804) to (3.3023684788650147, 3.2835432597016854) to (3.382475385053808, 3.2134484441973576) to (3.4695790918802576, 3.152265572110329) to (3.5626926795411444, 3.1006878698287808) to (3.6607611338819694, 3.0592997333289667) to (3.762673300128885, 3.02857010673529) to (3.8672744727162778, 3.008847168995993) to (3.973379478562225, 3.0003543888765476) to (4.079786105553083, 3.0031879929692495) to (4.185288724087114, 3.017315875407479) to (4.28869194733962, 3.042577961637994) to (4.38882417547332, 3.0786880221295867) to (4.48455087033265, 3.1252369154680384) to (4.574787410214406, 3.1816972240918306) to (4.658511379065038, 3.2474292301438608) to (4.734774150863067, 3.3216881637303834) to (4.802711637930964, 3.403632641461498) to (4.861554081393806, 3.49233419966116) to (4.910634772854913, 3.586787814231622) to (4.949397608468381, 3.685923287978051) to (4.977403389817867, 3.7886173763703757) to (4.994334800210137, 3.8937065143526346) to (5.0, 3.9999999999999996) -- cycle;
    \draw[color=orange, line width=2] (5.0, 4.0) to (5.7, 4.0);
    \draw[color=orange, line width=2] (4.866025403784438, 4.5) to (5.472243186433546, 4.85);
    \draw[color=orange, line width=2] (4.5, 4.866025403784438) to (4.8500000000000005, 5.472243186433546);
    \draw[color=orange, line width=2] (4.0, 5.0) to (4.0, 5.7);
    \draw[color=orange, line width=2] (3.5, 4.866025403784438) to (3.1500000000000004, 5.472243186433546);
    \draw[color=orange, line width=2] (3.1339745962155616, 4.5) to (2.5277568135664543, 4.8500000000000005);
    \draw[color=orange, line width=2] (3.0, 4.0) to (2.3, 4.0);
    \draw[color=orange, line width=2] (3.133974596215561, 3.5000000000000004) to (2.5277568135664543, 3.1500000000000004);
    \draw[color=orange, line width=2] (3.4999999999999996, 3.1339745962155616) to (3.1499999999999995, 2.5277568135664548);
    \draw[color=orange, line width=2] (4.0, 3.0) to (3.9999999999999996, 2.3);
    \draw[color=orange, line width=2] (4.499999999999999, 3.1339745962155607) to (4.849999999999999, 2.5277568135664534);
    \draw[color=orange, line width=2] (4.866025403784438, 3.4999999999999996) to (5.472243186433545, 3.1499999999999995);
\end{tikzpicture}

Fill without stroke

Section titled “Fill without stroke”

fig.fill() fills a closed path without drawing any outline — the equivalent of \fill[...] in TikZ. Use it when you want pure flat colour with no border.

fig = TikzFigure()


# Three overlapping filled triangles — no outlines at all
triangles = [
    ([[1, 0], [4, 0], [2.5, 2.5]], "red!60"),
    ([[2, 0], [5, 0], [3.5, 2.5]], "blue!50"),
    ([[3, 0], [6, 0], [4.5, 2.5]], "green!60"),
]
for pts, color in triangles:
    fig.fill(pts, cycle=True, fill=color, fill_opacity=0.6)


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \fill[fill=red!60, fill opacity=0.6] (1, 0) to (4, 0) to (2.5, 2.5) -- cycle;
    \fill[fill=blue!50, fill opacity=0.6] (2, 0) to (5, 0) to (3.5, 2.5) -- cycle;
    \fill[fill=green!60, fill opacity=0.6] (3, 0) to (6, 0) to (4.5, 2.5) -- cycle;
\end{tikzpicture}

The even_odd_rule flag corrects the fill for self-intersecting paths. Without it, TikZ fills the interior using the non-zero winding rule, which fills the overlapping centre region twice — visually it looks like a solid shape. With even_odd_rule=True the centre hole is punched out correctly.

fig = TikzFigure()


# A five-pointed star is self-intersecting
angles = np.linspace(np.pi / 2, np.pi / 2 + 4 * np.pi, 6)[:-1]
star_pts = list(zip(np.cos(angles) * 2 + 2, np.sin(angles) * 2 + 2))


# Default winding rule: centre is filled solid
fig.fill(star_pts, cycle=True, fill="orange!80", fill_opacity=0.9)
fig.add_node(
    2,
    -0.3,
    content="winding rule (default)",
    draw="none",
    font=r"\small",
    anchor="center",
)


# Even-odd rule: centre is hollow
angles2 = np.linspace(np.pi / 2, np.pi / 2 + 4 * np.pi, 6)[:-1]
star_pts2 = list(zip(np.cos(angles2) * 2 + 8, np.sin(angles2) * 2 + 2))
fig.fill(star_pts2, cycle=True, fill="teal!70", fill_opacity=0.9, even_odd_rule=True)
fig.add_node(
    8, -0.3, content="even odd rule", draw="none", font=r"\small", anchor="center"
)


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \fill[fill=orange!80, fill opacity=0.9] (2.0, 4.0) to (0.8244294954150535, 0.3819660112501053) to (3.9021130325903073, 2.6180339887498945) to (0.09788696740969316, 2.618033988749896) to (3.175570504584946, 0.38196601125010465) -- cycle;
    \node[draw=none, font=\small, anchor=center] (node0) at ({2}, {-0.3}) {winding rule (default)};
    \fill[even odd rule, fill=teal!70, fill opacity=0.9] (8.0, 4.0) to (6.824429495415053, 0.3819660112501053) to (9.902113032590307, 2.6180339887498945) to (6.097886967409693, 2.618033988749896) to (9.175570504584945, 0.38196601125010465) -- cycle;
    \node[draw=none, font=\small, anchor=center] (node1) at ({8}, {-0.3}) {even odd rule};
\end{tikzpicture}

Clip

Section titled “Clip”

fig.clip() installs a clipping path — all subsequent drawing is masked to the given boundary. Wrap the clip together with the clipped content inside a \begin{scope}...\end{scope} via fig.add_raw() so the clip doesn’t leak into the rest of the figure.

fig = TikzFigure()


# Draw a full circle for reference (unclipped)
fig.draw(
    list(
        zip(
            np.cos(np.linspace(0, 2 * np.pi, 60)) * 2 + 2,
            np.sin(np.linspace(0, 2 * np.pi, 60)) * 2 + 2,
        )
    ),
    cycle=True,
    color="gray!40",
    line_width=1,
)


# Open a scope, clip to a rectangle, then draw a dense grid inside
fig.add_raw(r"\begin{scope}")
clip_rect = [[0.5, 0.5], [3.5, 0.5], [3.5, 3.5], [0.5, 3.5]]
fig.clip(clip_rect, cycle=True)


for i in np.linspace(0, 4, 20):
    fig.draw([(0, i), (4, i)], color="blue!40", line_width=0.4)
    fig.draw([(i, 0), (i, 4)], color="blue!40", line_width=0.4)


fig.add_raw(r"\end{scope}")


# Anything drawn after the scope is unclipped again
fig.add_node(
    2,
    -0.5,
    content="clipped grid inside circle",
    draw="none",
    font=r"\small",
    anchor="center",
)


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \draw[color=gray!40, line width=1] (4.0, 2.0) to (3.988669600420274, 2.212586971294731) to (3.9548067796357333, 2.4227652472592487) to (3.8987952169367626, 2.6281534240438975) to (3.8212695457098267, 2.8264243715367563) to (3.723108162787612, 3.01533160067768) to (3.605423275861927, 3.192734717077003) to (3.4695483017261344, 3.356623672539232) to (3.3170227581300775, 3.5051415397122767) to (3.149574820428814, 3.636605551816338) to (2.9691017406653004, 3.7495261690639223) to (2.7776483509466416, 3.8426239557408257) to (2.5773838946792424, 3.9148440767240107) to (2.370577448174229, 3.9653682491850417) to (2.159572211106166, 3.9936240140615) to (1.9467589571244506, 3.9992912222469053) to (1.7345489454325562, 3.9823056620080144) to (1.5253466002577707, 3.9428597865294197) to (1.3215222677639398, 3.8814005333420667) to (1.1253853590822893, 3.7986242603424385) to (0.9391581837605152, 3.695468855779342) to (0.7649507701076164, 3.573103111605285) to (0.6047369577300308, 3.4329134805966306) to (0.4603320331401879, 3.2764883672896405) to (0.3333721618349703, 3.1056001307223875) to (0.22529584988685714, 2.9221850028986522) to (0.13732764509532336, 2.728321150505645) to (0.07046426237096814, 2.5262051284550426) to (0.02546329055731089, 2.3181269920381444) to (0.002834608646476111, 2.1064443496843577) to (0.002834608646476111, 1.893555650315643) to (0.02546329055731089, 1.6818730079618562) to (0.07046426237096792, 1.4737948715449578) to (0.13732764509532291, 1.2716788494943563) to (0.22529584988685647, 1.0778149971013489) to (0.33337216183496965, 0.8943998692776138) to (0.460332033140187, 0.7235116327103606) to (0.6047369577300299, 0.5670865194033705) to (0.7649507701076159, 0.42689688839471507) to (0.9391581837605147, 0.3045311442206582) to (1.1253853590822889, 0.20137573965756173) to (1.3215222677639389, 0.11859946665793353) to (1.5253466002577698, 0.05714021347058029) to (1.7345489454325553, 0.01769433799198583) to (1.9467589571244497, 0.000708777753094969) to (2.1595722111061653, 0.006375985938499529) to (2.3705774481742274, 0.03463175081495784) to (2.577383894679241, 0.08515592327598864) to (2.7776483509466403, 0.15737604425917362) to (2.969101740665299, 0.2504738309360768) to (3.1495748204288123, 0.36339444818366107) to (3.317022758130076, 0.49485846028772196) to (3.4695483017261335, 0.6433763274607667) to (3.6054232758619262, 0.8072652829229958) to (3.723108162787612, 0.98466839932232) to (3.8212695457098262, 1.1735756284632437) to (3.8987952169367626, 1.371846575956102) to (3.9548067796357333, 1.577234752740751) to (3.988669600420274, 1.7874130287052687) to (4.0, 1.9999999999999996) -- cycle;
    \begin{scope}
        \clip[] (0.5, 0.5) to (3.5, 0.5) to (3.5, 3.5) to (0.5, 3.5) -- cycle;
        \draw[color=blue!40, line width=0.4] (0, 0.0) to (4, 0.0);
        \draw[color=blue!40, line width=0.4] (0.0, 0) to (0.0, 4);
        \draw[color=blue!40, line width=0.4] (0, 0.21052631578947367) to (4, 0.21052631578947367);
        \draw[color=blue!40, line width=0.4] (0.21052631578947367, 0) to (0.21052631578947367, 4);
        \draw[color=blue!40, line width=0.4] (0, 0.42105263157894735) to (4, 0.42105263157894735);
        \draw[color=blue!40, line width=0.4] (0.42105263157894735, 0) to (0.42105263157894735, 4);
        \draw[color=blue!40, line width=0.4] (0, 0.631578947368421) to (4, 0.631578947368421);
        \draw[color=blue!40, line width=0.4] (0.631578947368421, 0) to (0.631578947368421, 4);
        \draw[color=blue!40, line width=0.4] (0, 0.8421052631578947) to (4, 0.8421052631578947);
        \draw[color=blue!40, line width=0.4] (0.8421052631578947, 0) to (0.8421052631578947, 4);
        \draw[color=blue!40, line width=0.4] (0, 1.0526315789473684) to (4, 1.0526315789473684);
        \draw[color=blue!40, line width=0.4] (1.0526315789473684, 0) to (1.0526315789473684, 4);
        \draw[color=blue!40, line width=0.4] (0, 1.263157894736842) to (4, 1.263157894736842);
        \draw[color=blue!40, line width=0.4] (1.263157894736842, 0) to (1.263157894736842, 4);
        \draw[color=blue!40, line width=0.4] (0, 1.4736842105263157) to (4, 1.4736842105263157);
        \draw[color=blue!40, line width=0.4] (1.4736842105263157, 0) to (1.4736842105263157, 4);
        \draw[color=blue!40, line width=0.4] (0, 1.6842105263157894) to (4, 1.6842105263157894);
        \draw[color=blue!40, line width=0.4] (1.6842105263157894, 0) to (1.6842105263157894, 4);
        \draw[color=blue!40, line width=0.4] (0, 1.894736842105263) to (4, 1.894736842105263);
        \draw[color=blue!40, line width=0.4] (1.894736842105263, 0) to (1.894736842105263, 4);
        \draw[color=blue!40, line width=0.4] (0, 2.1052631578947367) to (4, 2.1052631578947367);
        \draw[color=blue!40, line width=0.4] (2.1052631578947367, 0) to (2.1052631578947367, 4);
        \draw[color=blue!40, line width=0.4] (0, 2.3157894736842106) to (4, 2.3157894736842106);
        \draw[color=blue!40, line width=0.4] (2.3157894736842106, 0) to (2.3157894736842106, 4);
        \draw[color=blue!40, line width=0.4] (0, 2.526315789473684) to (4, 2.526315789473684);
        \draw[color=blue!40, line width=0.4] (2.526315789473684, 0) to (2.526315789473684, 4);
        \draw[color=blue!40, line width=0.4] (0, 2.7368421052631575) to (4, 2.7368421052631575);
        \draw[color=blue!40, line width=0.4] (2.7368421052631575, 0) to (2.7368421052631575, 4);
        \draw[color=blue!40, line width=0.4] (0, 2.9473684210526314) to (4, 2.9473684210526314);
        \draw[color=blue!40, line width=0.4] (2.9473684210526314, 0) to (2.9473684210526314, 4);
        \draw[color=blue!40, line width=0.4] (0, 3.1578947368421053) to (4, 3.1578947368421053);
        \draw[color=blue!40, line width=0.4] (3.1578947368421053, 0) to (3.1578947368421053, 4);
        \draw[color=blue!40, line width=0.4] (0, 3.3684210526315788) to (4, 3.3684210526315788);
        \draw[color=blue!40, line width=0.4] (3.3684210526315788, 0) to (3.3684210526315788, 4);
        \draw[color=blue!40, line width=0.4] (0, 3.578947368421052) to (4, 3.578947368421052);
        \draw[color=blue!40, line width=0.4] (3.578947368421052, 0) to (3.578947368421052, 4);
        \draw[color=blue!40, line width=0.4] (0, 3.789473684210526) to (4, 3.789473684210526);
        \draw[color=blue!40, line width=0.4] (3.789473684210526, 0) to (3.789473684210526, 4);
        \draw[color=blue!40, line width=0.4] (0, 4.0) to (4, 4.0);
        \draw[color=blue!40, line width=0.4] (4.0, 0) to (4.0, 4);
    \end{scope}
    \node[draw=none, font=\small, anchor=center] (node0) at ({2}, {-0.5}) {clipped grid inside circle};
\end{tikzpicture}

Invisible path

Section titled “Invisible path”

fig.path() traces a path without drawing or filling anything. It has two common uses:

Named paths — register a path under a name so the intersections TikZ library can compute where two paths cross.

Mid-path labels — place a text node at a specific position along an invisible connector using segment_options with a "node" key.

fig = TikzFigure()


# Three nodes
for label, x, y, color in [
    ("A", 0, 0, "teal"),
    ("B", 5, 3, "orange"),
    ("C", 10, 0, "purple"),
]:
    fig.add_node(
        x=x,
        y=y,
        label=label,
        shape="circle",
        fill=f"{color}!20",
        draw=f"{color}!70",
        minimum_size="1.2cm",
        content=f"${label}$",
    )


# Visible arrows
fig.draw(
    ["A.center", "B.center"],
    arrows="->",
    thick=True,
    color="teal!70",
    segment_options=[{"bend_left": 20}],
)
fig.draw(
    ["B.center", "C.center"],
    arrows="->",
    thick=True,
    color="orange!80",
    segment_options=[{"bend_right": 20}],
)


# Invisible paths with mid-path labels
fig.path(
    ["A.center", "B.center"],
    segment_options=[
        {
            "node": {
                "content": r"$e_1$",
                "above": True,
                "sloped": True,
                "font": r"\small",
            },
            "bend_left": 20,
        }
    ],
)
fig.path(
    ["B.center", "C.center"],
    segment_options=[
        {
            "node": {
                "content": r"$e_2$",
                "above": True,
                "sloped": True,
                "font": r"\small",
            },
            "bend_right": 20,
        }
    ],
)


fig.show()

Show Tikz code 
print(fig)
% --------------------------------------------- %
% Tikzfigure generated by tikzfigure v0.2.1     %
% https://github.com/max-models/tikzfigure      %
% --------------------------------------------- %
\begin{tikzpicture}
    \node[shape=circle, fill=teal!20, draw=teal!70, minimum size=1.2cm] (A) at ({0}, {0}) {$A$};
    \node[shape=circle, fill=orange!20, draw=orange!70, minimum size=1.2cm] (B) at ({5}, {3}) {$B$};
    \node[shape=circle, fill=purple!20, draw=purple!70, minimum size=1.2cm] (C) at ({10}, {0}) {$C$};
    \draw[thick=True, color=teal!70, arrows=->] (A.center) to[bend left=20] (B.center);
    \draw[thick=True, color=orange!80, arrows=->] (B.center) to[bend right=20] (C.center);
    \path[] (A.center) to[bend left=20] node[above, sloped, font=\small] {$e_1$} (B.center);
    \path[] (B.center) to[bend right=20] node[above, sloped, font=\small] {$e_2$} (C.center);
\end{tikzpicture}