> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/fi/kuvat-ja-taulukot/05-tikz-package.md). # TikZ-paketti ## Johdanto [Ti*k*Z](https://en.wikipedia.org/wiki/PGF/TikZ) on luultavasti monimutkaisin ja tehokkain työkalu graafisten elementtien luomiseen LaTeXissa. Aloittaen yksinkertaisesta esimerkistä tämä artikkeli esittelee joitakin peruskäsitteitä: viivojen, pisteiden, käyrien, ympyröiden, suorakulmioiden jne. piirtämistä. Ensiksi lataa `tikziin` paketti lisäämällä rivi `\usepackage{tikz}` asiakirjasi johdannossa, ja piirrä sitten grafiikka käyttäen `tikzpicture` ympäristössä. ```latex \documentclass{article} \usepackage{tikz} \begin{document} \begin{tikzpicture} \draw[gray, thick] (-1,2) -- (2,-4); \draw[gray, thick] (-1,-1) -- (2,2); \filldraw[black] (0,0) circle (2pt) node[anchor=west]{Intersection point}; \end{tikzpicture} \end{document} ``` [Avaa tämä esimerkki Overleafissa](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=First+TikZ+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Btikz%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btikzpicture%7D%0A%5Cdraw%5Bgray%2C+thick%5D+%28-1%2C2%29+--+%282%2C-4%29%3B%0A%5Cdraw%5Bgray%2C+thick%5D+%28-1%2C-1%29+--+%282%2C2%29%3B%0A%5Cfilldraw%5Bblack%5D+%280%2C0%29+circle+%282pt%29+node%5Banchor%3Dwest%5D%7BIntersection+point%7D%3B%0A%5Cend%7Btikzpicture%7D%0A%5Cend%7Bdocument%7D) Tämä esimerkki tuottaa seuraavan tulosteen: ![OLV2tikz1.png](/files/af29b0a6a2fa764e683d7273bb3fb99af224bc5d) Tässä esimerkissä piirretään kaksi viivaa ja yksi piste. Lisää viiva komennolla `\draw[gray, thick]` määrittää graafisen elementin, jonka *väri* on `harmaa` ja `paksu` viiva. Viiva määritellään itse asiassa sen kahdella päätepisteellä, `(-1,2)` ja `(2,-4)`, jotka yhdistää `--`. Se *piste* on itse asiassa `ympyrä` piirretty komennolla `\filldraw[black]`, tämä komento ei ainoastaan piirrä ympyrää vaan täyttää sen mustalla. Tässä komennossa keskipiste `(0,0)` ja säde `(2pt)` määritellään. Pisteen vieressä on `solmu`, joka on itse asiassa laatikko, joka sisältää tekstin `leikkauspiste`, ja ankkuroitu `länteen` pisteen. On tärkeää huomata puolipiste `;` joka käytetään kunkin `piirtokomennon` komento. Huomaa: `tikzfigure` ympäristö voidaan sijoittaa figure- tai vastaavan ympäristön sisään. Katso [Kuvien lisääminen](/latex/fi/lisaa-aiheita/27-inserting-images.md) artikkelia saadaksesi lisätietoja tästä aiheesta. ## Peruselementit: pisteet, viivat ja polut Tässä osiossa annamme muutamia esimerkkejä, jotka näyttävät, kuinka luodaan joitakin perusgraafisia elementtejä, joita voidaan yhdistää näyttävämpien kuvioiden luomiseksi. ```latex \documentclass{article} \usepackage{tikz} \begin{document} \begin{tikzpicture} \draw (-2,0) -- (2,0); \filldraw [gray] (0,0) circle (2pt); \draw (-2,-2) .. controls (0,0) .. (2,-2); \draw (-2,2) .. controls (-1,0) and (1,0) .. (2,2); \end{tikzpicture} \end{document} ``` [Avaa tämä esimerkki Overleafissa](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Second+TikZ+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Btikz%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btikzpicture%7D%0A%0A%5Cdraw+%28-2%2C0%29+--+%282%2C0%29%3B%0A%5Cfilldraw+%5Bgray%5D+%280%2C0%29+circle+%282pt%29%3B%0A%5Cdraw+%28-2%2C-2%29+..+controls+%280%2C0%29+..+%282%2C-2%29%3B%0A%5Cdraw+%28-2%2C2%29+..+controls+%28-1%2C0%29+and+%281%2C0%29+..+%282%2C2%29%3B%0A%0A%5Cend%7Btikzpicture%7D%0A%5Cend%7Bdocument%7D) Tämä esimerkki tuottaa seuraavan tulosteen: ![OLV2tikz2.png](/files/30ebfe6671ec19dc881a0d8a20fa7d2051384d03) Tässä esimerkissä on kolme peruskomentoa: * **`\draw (-2,0) -- (2,0);`**: Tämä määrittää viivan, jonka päätepisteet ovat `(-2,0)` ja `(2,0)`. * **`\filldraw [gray] (0,0) circle (2pt);`**: Piste luodaan hyvin pienenä `harmaa` `ympyrä` keskitettynä `(0,0)` ja jonka säde on `(2pt)`. Se `\filldraw` komentoa käytetään elementtien piirtämiseen ja niiden täyttämiseen tietyllä värillä. Katso seuraava osio saadaksesi lisää esimerkkejä. * **`\draw (-2,2) .. controls (-1,0) and (1,0) .. (2,2);`**: Piirtää [Bézier-käyrän](https://en.wikipedia.org/wiki/B%C3%A9zier_curve). Sen määrittää 4 pistettä: `(-2,2)` ja `(2,2)` ovat sen päätepisteet, `(-1,0)` ja `(1,0)` olet [*ohjauspisteet*](https://en.wikipedia.org/wiki/Control_point_\(mathematics\)) jotka määrittävät, kuinka "kaareva" se on. Voit ajatella näitä kahta pistettä "vetopisteinä". ## Perusgeometriset muodot: ympyrät, ellipsit ja monikulmiot Geometriset kuviot voidaan rakentaa yksinkertaisemmista elementeistä, joten aloitetaan ympyröistä, ellipsistä ja kaarista. ```latex \documentclass{article} \usepackage{tikz} \begin{document} \begin{tikzpicture} \filldraw[color=red!60, fill=red!5, very thick](-1,0) circle (1.5); \fill[blue!50] (2.5,0) ellipse (1.5 and 0.5); \draw[ultra thick, ->] (6.5,0) arc (0:220:1); \end{tikzpicture} \end{document} ``` [Avaa tämä esimerkki Overleafissa](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Third+TikZ+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Btikz%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btikzpicture%7D%0A%5Cfilldraw%5Bcolor%3Dred%2160%2C+fill%3Dred%215%2C+very+thick%5D%28-1%2C0%29+circle+%281.5%29%3B%0A%5Cfill%5Bblue%2150%5D+%282.5%2C0%29+ellipse+%281.5+and+0.5%29%3B%0A%5Cdraw%5Bultra+thick%2C+-%3E%5D+%286.5%2C0%29+arc+%280%3A220%3A1%29%3B%0A%5Cend%7Btikzpicture%7D%0A%5Cend%7Bdocument%7D) Tämä esimerkki tuottaa seuraavan tulosteen: ![TikzEx3.png](/files/a103323726d66c39721b0476dd165c53cfdbd972) * **`\filldraw[color=red!60, fill=red!5, very thick](-1,0) circle (1.5);`**: Tätä komentoa käytettiin edellisessä osiossa piirtämään *piste*, mutta tässä tapauksessa hakasulkeissa on joitakin lisäparametreja. Ne selitetään alla: * **`color=red!60`**: Ympyrää ympäröivän renkaan väri asetetaan 60-prosenttiseen punaiseen (vaaleampi kuin "puhdas" punainen). Katso [viiteopas](#reference-guide) luettelo LaTeXissa käytettävissä olevista oletusväreistä; katso myös [Värien käyttäminen LaTeXissa](/latex/fi/muotoilu/13-using-colors-in-latex.md) oppiaksesi luomaan omia värejäsi. * **`fill=red!5`**: Ympyrä täytetään vieläkin vaaleammalla punaisen sävyllä. * **`erittäin paksu`**: Tämä parametri määrittää viivan paksuuden. Katso [viiteopas](#reference-guide) täydellinen luettelo arvoista. * **`\fill[blue!50] (2.5,0) ellipse (1.5 and 0.5);`**: Ellipsin luomiseksi annat keskipisteen `(2.5,0)`, ja kaksi sädettä: vaaka- ja pystysuunnassa (`1.5` ja `0.5` vastaavasti). Huomaa myös komento `fill` sen sijaan että `piirtokomennon` tai filldraw, koska tässä tapauksessa ei ole tarpeen säätää ulko- ja sisävärejä. * **`\draw[ultra thick, ->] (6.5,0) arc (0:220:1);`**: Tämä komento piirtää kaaren, joka alkaa kohdasta `(6.5,0)`. Lisäparametri `->` osoittaa, että kaaressa on nuoli päässä. Aloituspisteen lisäksi sinun on annettava kolme lisäarvoa: alku- ja loppukulmat sekä säde; tässä nämä kolme parametria on annettu muodossa `(0:220:1)`. Kaarevien geometristen muotojen lisäksi voit luoda myös elementtejä, jotka käyttävät suoria viivoja, vastaavaa syntaksia käyttäen: ```latex \documentclass{article} \usepackage{tikz} \begin{document} \begin{tikzpicture} \draw[blue, very thick] (0,0) rectangle (3,2); \draw[orange, ultra thick] (4,0) -- (6,0) -- (5.7,2) -- cycle; \end{tikzpicture} \end{document} ``` [Avaa tämä esimerkki Overleafissa](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Fourth+TikZ+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Btikz%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btikzpicture%7D%0A%5Cdraw%5Bblue%2C+very+thick%5D+%280%2C0%29+rectangle+%283%2C2%29%3B%0A%5Cdraw%5Borange%2C+ultra+thick%5D+%284%2C0%29+--+%286%2C0%29+--+%285.7%2C2%29+--+cycle%3B%0A%5Cend%7Btikzpicture%7D%0A%5Cend%7Bdocument%7D) Tämä esimerkki tuottaa seuraavan tulosteen: ![OLV2tikz4.png](/files/e4ec3e0ef89d3a95ed011c2c9d9dede15e71b296) * **`\draw[blue, very thick] (0,0) rectangle (3,2);`**: Suorakulmiot luodaan erityiskomennolla `rectangle`. Sinun on annettava kaksi pistettä; ensimmäinen on kohta, jossa "kynä" alkaa piirtää suorakulmiota, ja toinen on diagonaalisesti vastakkainen kulmapiste. * **`\draw[orange, ultra thick] (4,0) -- (6,0) -- (5.7,2) -- cycle;`**: Monikulmion piirtämiseksi piirrämme *suljetun* suorista viivoista koostuvan polun: viiva kohdasta `(4,0)` kohteeseen `(6,0)` ja viiva kohdasta `(6,0)` kohteeseen `(5.7,2)`. Se `cycle` komento tarkoittaa, että alku- ja loppupisteiden tulee yhtyä, jotta muodostuu "suljettu" polku (muoto), mikä johtaa viimeisen viivasegmentin muodostumiseen. ## Kaaviot Solmut ovat luultavasti monipuolisimpia elementtejä TikZissä. Olemme jo käyttäneet yhtä solmua johdannossa—lisätäksemme hieman tekstiä kuvaan. Seuraava esimerkki käyttää solmuja kaavion luomiseen. ```latex \documentclass{article} \usepackage{tikz} \usetikzlibrary{positioning} \begin{document} \begin{tikzpicture}[ roundnode/.style={circle, draw=green!60, fill=green!5, very thick, minimum size=7mm}, squarednode/.style={rectangle, draw=red!60, fill=red!5, very thick, minimum size=5mm}, ] %Solmut \node[squarednode] (maintopic) {2}; \node[roundnode] (uppercircle) [above=of maintopic] {1}; \node[squarednode] (rightsquare) [right=of maintopic] {3}; \node[roundnode] (lowercircle) [below=of maintopic] {4}; %Viivat \draw[->] (uppercircle.south) -- (maintopic.north); \draw[->] (maintopic.east) -- (rightsquare.west); \draw[->] (rightsquare.south) .. controls +(down:7mm) and +(right:7mm) .. (lowercircle.east); \end{tikzpicture} \end{document} ``` [Avaa tämä esimerkki Overleafissa](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=More+advanced+TikZ+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Btikz%7D%0A%5Cusetikzlibrary%7Bpositioning%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btikzpicture%7D%5B%0Aroundnode%2F.style%3D%7Bcircle%2C+draw%3Dgreen%2160%2C+fill%3Dgreen%215%2C+very+thick%2C+minimum+size%3D7mm%7D%2C%0Asquarednode%2F.style%3D%7Brectangle%2C+draw%3Dred%2160%2C+fill%3Dred%215%2C+very+thick%2C+minimum+size%3D5mm%7D%2C%0A%5D%0A%25Nodes%0A%5Cnode%5Bsquarednode%5D++++++%28maintopic%29++++++++++++++++++++++++++++++%7B2%7D%3B%0A%5Cnode%5Broundnode%5D++++++++%28uppercircle%29+++++++%5Babove%3Dof+maintopic%5D+%7B1%7D%3B%0A%5Cnode%5Bsquarednode%5D++++++%28rightsquare%29+++++++%5Bright%3Dof+maintopic%5D+%7B3%7D%3B%0A%5Cnode%5Broundnode%5D++++++++%28lowercircle%29+++++++%5Bbelow%3Dof+maintopic%5D+%7B4%7D%3B%0A%0A%25Lines%0A%5Cdraw%5B-%3E%5D+%28uppercircle.south%29+--+%28maintopic.north%29%3B%0A%5Cdraw%5B-%3E%5D+%28maintopic.east%29+--+%28rightsquare.west%29%3B%0A%5Cdraw%5B-%3E%5D+%28rightsquare.south%29+..+controls+%2B%28down%3A7mm%29+and+%2B%28right%3A7mm%29+..+%28lowercircle.east%29%3B%0A%5Cend%7Btikzpicture%7D%0A%5Cend%7Bdocument%7D) Tämä esimerkki tuottaa seuraavan tulosteen: ![OLV2tikz5.png](/files/bb9251a4d1510399c63a56ad0fbf2df9512799c8) Tässä kuvassa on käytännössä kolme komentoa: solmun määrittely, solmun julistus ja viivat, jotka yhdistävät kaksi solmua. * **`roundnode/.style={circle, draw=green!60, fill=green!5, very thick, minimum size=7mm}`**: Annetaan parametrina `tikzpicture` ympäristöön. Se määrittää solmun, johon viitataan nimellä `roundnode`: tästä solmusta tulee ympyrä, jonka ulkokehys piirretään värillä `green!60` ja täytetään värillä `green!5`. Viiva on `erittäin paksu` ja sen `vähimmäiskoko` on `7mm`. Alla oleva rivi määrittää toisen suorakulmion muotoisen solmun nimeltä `squarednode`, käyttäen samanlaisia parametreja. * **`\node[squarednode] (maintopic) {2};`**: Tämä luo `squarednode`, kuten edellisessä komennossa määriteltiin. Tämän solmun tunniste on `maintopic` ja sisältää numeron `2`. Jos jätät aaltosulkeiden sisään tyhjän tilan, tekstiä ei näytetä. * **`[above=of maintopic]`**: Huomaa, että kaikilla solmuilla ensimmäistä lukuun ottamatta on lisäparametri, joka määrittää niiden sijainnin suhteessa muihin solmuihin. Esimerkiksi, `[above=of maintopic]` tarkoittaa, että tämän solmun pitäisi näkyä solmun nimeltä `maintopic`. Jotta tämä sijoittelujärjestelmä toimisi, sinun täytyy lisätä `\usetikzlibrary{positioning}` asiakirjasi johdantoon. Ilman `positioning` kirjastoa voit käyttää syntaksia `above of=maintopic` sen sijaan, mutta `positioning` syntaksi on joustavampi ja tehokkaampi: sitä voidaan laajentaa niin, että voidaan kirjoittaa `above=**3cm** of maintopic` eli säädellä todellista etäisyyttä kohteesta `maintopic`. * **`\draw[->] (uppercircle.south) -- (maintopic.north);`**: Piirretään nuolen kaltainen suora viiva. Syntaksi on jo selitetty [peruselementit](#basic-elements-points-lines-and-paths) osiossa. Ainoa ero on tapa, jolla kirjoitamme viivan päätepisteet: viittaamalla solmuun (siksi annoimme niille nimet) ja solmuun suhteellisella sijainnilla. ## Viiteopas Mahdolliset väri- ja paksuusparametrit `tikziin` pakettia: | parametri | arvot | picture | | --------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------- | | värin | valkoinen, musta, punainen, vihreä, sininen, syaani, magenta, keltainen | ![BasicColours.png](/files/9541b1a79d1a9c5bb99fbd111a7f2686b3182313) | | paksuus | erittäin ohut, hyvin ohut, ohut, paksu, erittäin paksu, äärimmäisen paksu | ![Thickness.png](/files/9c588eaa442b2f8f97c272088187d9704b963939) | Lisävärejä voi olla saatavilla LaTeX-jakelussasi. Katso [Värien käyttäminen LaTeXissa](/latex/fi/muotoilu/13-using-colors-in-latex.md) ## Lisälukemista Lisätietoja löydät: * [Värien käyttäminen LaTeXissa](/latex/fi/muotoilu/13-using-colors-in-latex.md) * [Pgfplots-paketti](/latex/fi/alakohtaiset/08-pgfplots-package.md) * [Kuvien lisääminen](/latex/fi/lisaa-aiheita/27-inserting-images.md) * [Taulukkojen ja kuvioiden luettelot](/latex/fi/kuvat-ja-taulukot/03-lists-of-tables-and-figures.md) * [Kuvien ja taulukoiden sijoittelu](/latex/fi/kuvat-ja-taulukot/02-positioning-images-and-tables.md) * [Kaavioiden piirtäminen suoraan LaTeXissä](/latex/fi/kuvat-ja-taulukot/04-picture-environment.md) * [TikZ- ja PGF-pakettien opas](http://mirrors.ctan.org/graphics/pgf/base/doc/pgfmanual.pdf) * [TikZ- ja PGF-esimerkkejä TeXample.netissä](http://www.texample.net/tikz/examples/all/) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/fi/kuvat-ja-taulukot/05-tikz-package.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.