> 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/el/eidiko-pedio/08-pgfplots-package.md). # Πακέτο Pgfplots ## Εισαγωγή Η `pgfplots` πακέτο, το οποίο βασίζεται στο [`TikZ`](/latex/el/sximata-kai-pinakes/05-tikz-package.md), είναι ένα ισχυρό εργαλείο οπτικοποίησης και ιδανικό για τη δημιουργία επιστημονικών/τεχνικών γραφικών. Η βασική ιδέα είναι ότι παρέχετε τα δεδομένα/τον τύπο εισόδου και `pgfplots` κάνει τα υπόλοιπα. ### Το προοίμιο του εγγράφου Για να χρησιμοποιήσετε το `pgfplots` για να προσθέσετε το πακέτο στο έγγραφό σας, προσθέστε την ακόλουθη γραμμή στο προοίμιό σας: `\usepackage{pgfplots}` Μπορείτε επίσης να ρυθμίσετε τη συμπεριφορά του `pgfplots` στο προοίμιο του εγγράφου. Για παράδειγμα, για να αλλάξετε το μέγεθος κάθε γραφήματος και να εξασφαλίσετε συμβατότητα προς τα πίσω (συνιστάται), προσθέστε την επόμενη γραμμή: `\pgfplotsset{width=10cm,compat=1.9}` Αυτό αλλάζει το μέγεθος κάθε `pgfplot` σχήματος σε 10 εκατοστά, κάτι που είναι τεράστιο· μπορείτε να χρησιμοποιήσετε διαφορετικές μονάδες (pt, mm, in). Η *compat* παράμετρος είναι για να λειτουργεί ο κώδικας με την έκδοση 1.9 του πακέτου ή νεότερη. ### Χρόνος μεταγλώττισης (σύντομο υπόβαθρο) Όταν σχεδιάστηκε/γράφτηκε η αρχική μηχανή TeX, πριν από περισσότερα από 40 χρόνια, δεν είχε σχεδιαστεί για *άμεση* παραγωγή γραφικών—αυτά επρόκειτο να είναι αρχεία που δημιουργούνται από εξωτερικά προγράμματα (π.χ., MetaPost) και εισάγονται στο στοιχειοθετημένο έγγραφο. Η εμφάνιση του pdfTeX—το οποίο βασίζεται στενά στο αρχικό λογισμικό TeX—έφερε τη δυνατότητα δημιουργίας γραφικών *άμεσα* χρησιμοποιώντας τις νέες ενσωματωμένες εντολές της γλώσσας TeX του pdfTeX (που ονομάζονται *πρωταρχικές εντολές*) οι οποίες μπορούν να εξάγουν τους τελεστές/τα δεδομένα PDF που απαιτούνται για την παραγωγή γραφικών. Η δημιουργία του pdfTeX οδήγησε στην ανάπτυξη εξελιγμένων πακέτων γραφικών LaTeX, όπως `TikZ`, `pgfplots` κ.λπ., ικανά να παράγουν γραφικά κωδικοποιημένα με χρήση εντολών υψηλού επιπέδου LaTeX. Ωστόσο, στο παρασκήνιο, και βαθιά μέσα στη μηχανή pdfTeX (και σε άλλες μηχανές), αυτές οι εντολές γραφικών υψηλού επιπέδου LaTeX πρέπει να επεξεργαστούν με τη «μετατροπή» τους πίσω σε εντολές χαμηλού επιπέδου της μηχανής pdfTeX (primitive), οι οποίες στην πραγματικότητα παράγουν (εξάγουν) τους τελεστές PDF που απαιτούνται για την παραγωγή του τελικού σχήματος/των τελικών σχημάτων. Αυτή η επεξεργασία των γραφικών εντολών LaTeX—επέκταση και εκτέλεση των primitives—μπορεί να πάρει μη αμελητέο χρόνο. Ακόμη και μία μόνο εντολή γραφικών υψηλού επιπέδου LaTeX, μαζί με τα αντίστοιχα δεδομένα της, μπορεί να απαιτεί επαναλαμβανόμενη εκτέλεση *πολλές* εντολών χαμηλού επιπέδου της μηχανής TeX (primitive). Από την οπτική του τελικού χρήστη, έγγραφα που περιέχουν πολλαπλά `pgfplots` σχήματα ή/και πολύ σύνθετα γραφικά, μπορεί να χρειαστούν σημαντικό χρόνο για να αποδοθούν (να μεταγλωττιστούν). ### Μείωση του χρόνου μεταγλώττισης Για να αυξήσετε την ταχύτητα μεταγλώττισης του εγγράφου μπορείτε να ρυθμίσετε το `pgfplots` πακέτο ώστε να εξάγει τα σχήματα σε ξεχωριστά αρχεία PDF και στη συνέχεια να τα εισάγει στο έγγραφο: μεταγλωττίστε μία φορά, έπειτα επαναχρησιμοποιήστε τα σχήματα. Για να το κάνετε αυτό, προσθέστε τον κώδικα που φαίνεται παρακάτω στο προοίμιο: ``` \usepgfplotslibrary{external} \tikzexternalize ``` Δείτε [αυτό το άρθρο βοήθειας](/latex/el/erotiseis-and-apantiseis/60-i-have-a-lot-of-tikz-matlab2tikz-or-pgfplots-figures-so-i-m-getting-a-compilation-timeout.-can-i.md) για περισσότερες λεπτομέρειες σχετικά με το πώς να ρυθμίσετε την tikz-externalization στο έργο σας στο Overleaf. ## Βασικό παράδειγμα (επίσης με εξωτερικοποίηση των σχημάτων) ```latex \documentclass{article} \usepackage[margin=0.25in]{geometry} \usepackage{pgfplots} \pgfplotsset{width=10cm,compat=1.9} % Θα εξωτερικοποιήσουμε τα σχήματα \usepgfplotslibrary{external} \tikzexternalize \begin{document} Το πρώτο παράδειγμα είναι μαθηματικές παραστάσεις 2D και 3D σχεδιασμένες δίπλα δίπλα. %Εδώ ξεκινά το 2D γράφημα \begin{tikzpicture} \begin{axis} \addplot[color=red]{exp(x)}; \end{axis} \end{tikzpicture} %Εδώ τελειώνει το 2D γράφημα \hskip 5pt %Εδώ ξεκινά το 3D γράφημα \begin{tikzpicture} \begin{axis} \addplot3[ surf, ] {exp(-x^2-y^2)*x}; \end{axis} \end{tikzpicture} %Εδώ τελειώνει το 3D γράφημα \end{document} ``` [Ανοίξτε αυτό το `pgfplots` παράδειγμα στο Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=pgfplots+example+1\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bmargin%3D0.25in%5D%7Bgeometry%7D%0A%5Cusepackage%7Bpgfplots%7D%0A%5Cpgfplotsset%7Bwidth%3D10cm%2Ccompat%3D1.9%7D%0A%0A%25+We+will+externalize+the+figures%0A%5Cusepgfplotslibrary%7Bexternal%7D%0A%5Ctikzexternalize%0A%0A%5Cbegin%7Bdocument%7D%0A%0AFirst+example+is+2D+and+3D+math+expressions+plotted+side-by-side.%0A%0A%25Here+begins+the+2D+plot%0A%5Cbegin%7Btikzpicture%7D%0A%5Cbegin%7Baxis%7D%0A%5Caddplot%5Bcolor%3Dred%5D%7Bexp%28x%29%7D%3B%0A%5Cend%7Baxis%7D%0A%5Cend%7Btikzpicture%7D%0A%25Here+ends+the+2D+plot%0A%5Chskip+5pt%0A%25Here+begins+the+3D+plot%0A%5Cbegin%7Btikzpicture%7D%0A%5Cbegin%7Baxis%7D%0A%5Caddplot3%5B%0A++++surf%2C%0A%5D%0A%7Bexp%28-x%5E2-y%5E2%29%2Ax%7D%3B%0A%5Cend%7Baxis%7D%0A%5Cend%7Btikzpicture%7D%0A%25Here+ends+the+3D+plot%0A%0A%5Cend%7Bdocument%7D) Η ακόλουθη εικόνα δείχνει το αποτέλεσμα που παράγεται από τον παραπάνω κώδικα: ![Plgplotsex1OLV2.png](/files/ee07dfa238b4a6f224ff0fd97a1d2a43ffdd5acb) ### Επεξήγηση του κώδικα Επειδή `pgfplots` βασίζεται στο `tikz` το γράφημα πρέπει να βρίσκεται μέσα σε ένα `tikzpicture` περιβάλλον. Στη συνέχεια, η δήλωση του περιβάλλοντος `\begin{axis}`, `\end{axis}` θα ορίσει τη σωστή κλίμακα για το γράφημα—ελέγξτε το [Οδηγός αναφοράς](#reference-guide) για άλλα περιβάλλοντα αξόνων. Για να προσθέσετε ένα πραγματικό γράφημα, η εντολή `\addplot[color=red]{log(x)};` χρησιμοποιείται. Μέσα στις αγκύλες, `[...]`, μπορούν να δοθούν ορισμένες επιλογές· εδώ, ορίζουμε το `χρώμα` του γραφήματος σε `red`. Οι αγκύλες είναι υποχρεωτικές· αν δεν δοθούν επιλογές, αφήστε ένα κενό ανάμεσά τους. Μέσα στις άγκυλες {} βάζετε τη συνάρτηση που θα σχεδιαστεί. Είναι σημαντικό να θυμάστε ότι αυτή η εντολή πρέπει να τελειώνει με άνω τελεία (;). Για να τοποθετήσετε ένα δεύτερο γράφημα δίπλα στο πρώτο, δηλώστε ένα νέο `tikzpicture` περιβάλλον. Μην εισαγάγετε νέα γραμμή, αλλά ένα μικρό κενό διάστημα· σε αυτήν την περίπτωση `hskip 10pt` θα εισαγάγει ένα κενό πλάτους 10pt. Η υπόλοιπη σύνταξη είναι η ίδια, εκτός από την `\addplot3 [surf,]{exp(-x^2-y^2)*x};`. Αυτό θα προσθέσει ένα 3D γράφημα, και η επιλογή `surf` μέσα στις τετράγωνες αγκύλες δηλώνει ότι πρόκειται για γράφημα επιφάνειας. Η συνάρτηση που θα σχεδιαστεί πρέπει να τοποθετηθεί μέσα σε άγκυλες {}. Και πάλι, μην ξεχάσετε να βάλετε άνω τελεία (;) στο τέλος της εντολής. **Σημείωση**: Συνιστάται ως καλή πρακτική να γίνεται εσοχή στον κώδικα—δείτε το δεύτερο γράφημα στο παραπάνω παράδειγμα—και να προστίθεται ένα κόμμα (,) στο τέλος κάθε επιλογής που δίνεται στο `\addplot`. Με αυτόν τον τρόπο ο κώδικας είναι πιο ευανάγνωστος και είναι ευκολότερο να προστεθούν επιπλέον επιλογές αν χρειαστεί. ## Γραφήματα 2D `pgfplots`Οι δυνατότητες σχεδίασης 2D γραφημάτων είναι τεράστιες—και μπορείτε να εξατομικεύσετε τα γραφήματά σας ώστε να ταιριάζουν στις απαιτήσεις σας. Παρ' όλα αυτά, οι προεπιλεγμένες επιλογές συνήθως δίνουν πολύ καλά αποτελέσματα, οπότε το μόνο που χρειάζεται είναι να δώσετε τα δεδομένα και το LaTeX θα κάνει τα υπόλοιπα. ### Σχεδίαση μαθηματικών παραστάσεων Ορίστε ένα παράδειγμα: ```latex \begin{tikzpicture} \begin{axis}[ axis lines = left, xlabel = \(x\), ylabel = {\(f(x)\)}, ] %Παρακάτω ορίζεται η κόκκινη παραβολή \addplot [ domain=-10:10, samples=100, color=red, ] {x^2 - 2*x - 1}; \addlegendentry{\(x^2 - 2x - 1\)} %Εδώ ορίζεται η μπλε παραβολή \addplot [ domain=-10:10, samples=100, color=blue, ] {x^2 + 2*x + 1}; \addlegendentry{\(x^2 + 2x + 1\)} \end{axis} \end{tikzpicture} ``` [Ανοίξτε αυτό το `pgfplots` παράδειγμα στο Overleaf.](https://www.overleaf.com/docs?engine=\&snip_name=pgfplots+example+2\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bmargin%3D0.25in%5D%7Bgeometry%7D%0A%5Cusepackage%7Bpgfplots%7D%0A%5Cpgfplotsset%7Bwidth%3D10cm%2Ccompat%3D1.9%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btikzpicture%7D%0A%5Cbegin%7Baxis%7D%5B%0A++++axis+lines+%3D+left%2C%0A++++xlabel+%3D+%5C%28x%5C%29%2C%0A++++ylabel+%3D+%7B%5C%28f%28x%29%5C%29%7D%2C%0A%5D%0A%25Below+the+red+parabola+is+defined%0A%5Caddplot+%5B%0A++++domain%3D-10%3A10%2C+%0A++++samples%3D100%2C+%0A++++color%3Dred%2C%0A%5D%0A%7Bx%5E2+-+2%2Ax+-+1%7D%3B%0A%5Caddlegendentry%7B%5C%28x%5E2+-+2x+-+1%5C%29%7D%0A%25Here+the+blue+parabola+is+defined%0A%5Caddplot+%5B%0A++++domain%3D-10%3A10%2C+%0A++++samples%3D100%2C+%0A++++color%3Dblue%2C%0A++++%5D%0A++++%7Bx%5E2+%2B+2%2Ax+%2B+1%7D%3B%0A%5Caddlegendentry%7B%5C%28x%5E2+%2B+2x+%2B+1%5C%29%7D%0A%0A%5Cend%7Baxis%7D%0A%5Cend%7Btikzpicture%7D%0A%5Cend%7Bdocument%7D) Το αποτέλεσμα αυτού του κώδικα φαίνεται στην παρακάτω εικόνα—το προοίμιο του εγγράφου LaTeX προστίθεται αυτόματα όταν ανοίξετε τον σύνδεσμο: ![Plgplotsex2.png](/files/1663a3a8aaff7d0fac03f944a08c9ce69c02b0d9) #### Επεξήγηση του κώδικα Ας αναλύσουμε τις νέες εντολές γραμμή προς γραμμή: **axis lines = left.** Αυτό θα τοποθετήσει τους άξονες μόνο στην αριστερή και κάτω πλευρά του γραφήματος, αντί για το προεπιλεγμένο πλαίσιο. Περισσότερες επιλογές προσαρμογής στον οδηγό αναφοράς. **xlabel = (x) και ylabel = {(f(x))}.** Αυτοεπεξηγηματικά ονόματα παραμέτρων, αυτά θα σας επιτρέψουν να βάλετε ετικέτα στον οριζόντιο και κατακόρυφο άξονα. Προσέξτε την τιμή του ylabel μέσα στις άγκυλες {}, αυτές οι αγκύλες λένε στο pgfplots πώς να ομαδοποιήσει το κείμενο. Το xlabel θα μπορούσε επίσης να είχε αγκύλες. Αυτό είναι χρήσιμο για περίπλοκες ετικέτες που μπορεί να μπερδέψουν το pgfplots. **\addplot.** Αυτό θα προσθέσει ένα γράφημα στους άξονες· η γενική χρήση περιγράφηκε στην εισαγωγή. Υπάρχουν δύο νέες παράμετροι σε αυτό το παράδειγμα. **domain=-10:10.** Αυτό ορίζει το εύρος των τιμών του x. **samples=100.** Καθορίζει τον αριθμό των σημείων στο διάστημα που ορίζεται από το domain. Όσο μεγαλύτερη είναι η τιμή του samples, τόσο πιο κοφτερό είναι το γράφημα που θα πάρετε, αλλά θα χρειαστεί περισσότερος χρόνος για την απόδοση. **\addlegendentry{\\(x^2 - 2x - 1\\)}.** Αυτό προσθέτει το υπόμνημα για την αναγνώριση της συνάρτησης x^2 - 2x - 1. Για να προσθέσετε ένα ακόμη γράφημα στο σχέδιο, απλώς γράψτε μια νέα `\addplot` καταχώριση. ### Σχεδίαση από δεδομένα Η επιστημονική έρευνα συχνά παράγει δεδομένα που πρέπει να αναλυθούν. Το επόμενο παράδειγμα δείχνει πώς να σχεδιάσετε δεδομένα με *pgfplots*: ```latex Σχεδίαση από δεδομένα: \begin{tikzpicture} \begin{axis}[ title={Εξάρτηση της διαλυτότητας του CuSO\(_4\cdot\)5H\(_2\)O από τη θερμοκρασία}, xlabel={Θερμοκρασία [\textcelsius]}, ylabel={Διαλυτότητα [g ανά 100 g νερού]}, xmin=0, xmax=100, ymin=0, ymax=120, xtick={0,20,40,60,80,100}, ytick={0,20,40,60,80,100,120}, legend pos=north west, ymajorgrids=true, grid style=dashed, ] \addplot[ color=blue, mark=square, ] coordinates { (0,23.1)(10,27.5)(20,32)(30,37.8)(40,44.6)(60,61.8)(80,83.8)(100,114) }; \legend{CuSO\(_4\cdot\)5H\(_2\)O} \end{axis} \end{tikzpicture} ``` [Ανοίξτε αυτό το `pgfplots` παράδειγμα στο Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=pgfplots+example+3\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bmargin%3D0.5in%5D%7Bgeometry%7D%0A%5Cusepackage%7Btextcomp%7D%0A%5Cusepackage%7Bpgfplots%7D%0A%5Cpgfplotsset%7Bwidth%3D10cm%2Ccompat%3D1.9%7D%0A%25%5Cusepgfplotslibrary%7Bexternal%7D%0A%25%5Ctikzexternalize%0A%5Cbegin%7Bdocument%7D%0APlotting+from+data%3A%0A%0A%5Cbegin%7Btikzpicture%7D%0A%5Cbegin%7Baxis%7D%5B%0A++++title%3D%7BTemperature+dependence+of+CuSO%5C%28_4%5Ccdot%5C%295H%5C%28_2%5C%29O+solubility%7D%2C%0A++++xlabel%3D%7BTemperature+%5B%5Ctextcelsius%5D%7D%2C%0A++++ylabel%3D%7BSolubility+%5Bg+per+100+g+water%5D%7D%2C%0A++++xmin%3D0%2C+xmax%3D100%2C%0A++++ymin%3D0%2C+ymax%3D120%2C%0A++++xtick%3D%7B0%2C20%2C40%2C60%2C80%2C100%7D%2C%0A++++ytick%3D%7B0%2C20%2C40%2C60%2C80%2C100%2C120%7D%2C%0A++++legend+pos%3Dnorth+west%2C%0A++++ymajorgrids%3Dtrue%2C%0A++++grid+style%3Ddashed%2C%0A%5D%0A%0A%5Caddplot%5B%0A++++color%3Dblue%2C%0A++++mark%3Dsquare%2C%0A++++%5D%0A++++coordinates+%7B%0A++++%280%2C23.1%29%2810%2C27.5%29%2820%2C32%29%2830%2C37.8%29%2840%2C44.6%29%2860%2C61.8%29%2880%2C83.8%29%28100%2C114%29%0A++++%7D%3B%0A++++%5Clegend%7BCuSO%5C%28_4%5Ccdot%5C%295H%5C%28_2%5C%29O%7D%0A++++%0A%5Cend%7Baxis%7D%0A%5Cend%7Btikzpicture%7D%0A%5Cend%7Bdocument%7D) Το αποτέλεσμα αυτού του κώδικα φαίνεται στην παρακάτω εικόνα—το προοίμιο του εγγράφου LaTeX προστίθεται αυτόματα όταν ανοίξετε τον σύνδεσμο: ![Plgplotsex3.png](/files/98b79769bef680fa887a11f5d57aaa44cc13b5d5) #### Επεξήγηση του κώδικα Υπάρχουν εδώ μερικές νέες εντολές και παράμετροι: **title={Εξάρτηση της διαλυτότητας του CuSO(\_4\cdot)5H(\_2)O από τη θερμοκρασία}.** Όπως θα περιμένατε, αποδίδει έναν τίτλο στο σχήμα. Ο τίτλος θα εμφανίζεται πάνω από το γράφημα. **xmin=0, xmax=100, ymin=0, ymax=120.** Τα ελάχιστα και μέγιστα όρια των αξόνων x και y. **xtick={0,20,40,60,80,100}, ytick={0,20,40,60,80,100,120}.** Τα σημεία όπου τοποθετούνται οι δείκτες. Αν είναι κενό, οι διαβαθμίσεις ορίζονται αυτόματα. **Θέση του πλαισίου υπομνήματος. Ελέγξτε τον οδηγό αναφοράς για περισσότερες επιλογές.** Θέση του πλαισίου υπομνήματος. Ελέγξτε τον οδηγό αναφοράς για περισσότερες επιλογές. **ymajorgrids=true.** Αυτό ενεργοποιεί/απενεργοποιεί τις γραμμές πλέγματος στις θέσεις των διαβαθμίσεων στον άξονα y. Χρησιμοποιήστε xmajorgrids για να ενεργοποιήσετε γραμμές πλέγματος στον άξονα x. **grid style=dashed.** Αυτονόητο. Για την εμφάνιση διακεκομμένων γραμμών πλέγματος. **mark=square.** Αυτό σχεδιάζει ένα τετράγωνο σημάδι σε κάθε σημείο στον πίνακα συντεταγμένων. Κάθε σημάδι θα συνδεθεί με το επόμενο με ευθεία γραμμή. **coordinates {(0,23.1)(10,27.5)(20,32)...}** Συντεταγμένες των σημείων που θα σχεδιαστούν. Αυτά είναι τα δεδομένα που θέλετε να αναλύσετε γραφικά. Αν τα δεδομένα βρίσκονται σε αρχείο, όπως συμβαίνει τις περισσότερες φορές, αντί για τις εντολές `\addplot` και `coordinates` θα πρέπει να χρησιμοποιήσετε `\addplot table {file_with_the_data.dat}`, οι υπόλοιπες επιλογές ισχύουν σε αυτό το περιβάλλον. ### Διαγράμματα διασποράς Τα διαγράμματα διασποράς χρησιμοποιούνται για την αναπαράσταση πληροφοριών με τη χρήση κάποιου είδους σημάνσεων και χρησιμοποιούνται συνήθως κατά τον υπολογισμό στατιστικής παλινδρόμησης. Σε αυτό το παράδειγμα θα δημιουργήσουμε ένα διάγραμμα διασποράς χρησιμοποιώντας δεδομένα που περιέχονται σε ένα αρχείο με όνομα `scattered_example.dat`, στο οποίο τα δεδομένα μοιάζουν ως εξής: ``` GPA ma ve co un 3.45 643 589 3.76 3.52 2.78 558 512 2.87 2.91 2.52 583 503 2.54 2.4 3.67 685 602 3.83 3.47 3.24 592 538 3.29 3.47 2.1 562 486 2.64 2.37 ... ``` Το διάγραμμα διασποράς μας χρησιμοποιεί τις δύο πρώτες στήλες των δεδομένων: ```latex \begin{tikzpicture} \begin{axis}[ enlargelimits=false, ] \addplot+[ only marks, scatter, mark=halfcircle*, mark size=2.9pt] table[meta=ma] {scattered_example.dat}; \end{axis} \end{tikzpicture} ``` ![Scattered.png](/files/ec3b33feba77d82bb99fe19162682be8f5106169) [Ανοίξτε ένα παράδειγμα έργου διαγράμματος διασποράς στο Overleaf (περιέχει το αρχείο δεδομένων `scattered_example.dat`).](https://www.overleaf.com/project/new/template/20099?id=68399290\&templateName=Scatter+plot+example\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=) #### Επεξήγηση του κώδικα Οι παράμετροι που δίνονται στα `axis` και `addplot` περιβάλλοντα μπορούν επίσης να χρησιμοποιηθούν σε ένα διάγραμμα δεδομένων, εκτός από το `scatter`. Παρακάτω η περιγραφή του κώδικα: **enlarge limits=false** Αυτό θα συρρικνώσει τους άξονες έτσι ώστε το σημείο με τις μέγιστες και ελάχιστες τιμές να βρίσκεται στο άκρο του γραφήματος. **μόνο σημάδια** Πολύ ρητό· θα τοποθετήσει ένα σημάδι σε κάθε σημείο. **scatter** Όταν χρησιμοποιείται το scatter, τα σημεία χρωματίζονται ανάλογα με μια τιμή, το χρώμα δίνεται από την παράμετρο meta που εξηγείται παρακάτω. **mark=halfcircle**\* Το είδος του σημείου που θα χρησιμοποιηθεί σε κάθε σημείο, ελέγξτε τον οδηγό αναφοράς για μια λίστα πιθανών τιμών. **mark size=2.9pt** Το μέγεθος κάθε σημείου· μπορούν να χρησιμοποιηθούν διαφορετικές μονάδες. **table\[meta=ma]{scattered\_example.dat};** Η εντολή table λέει στο LaTeX ότι τα δεδομένα που θα σχεδιαστούν βρίσκονται σε ένα αρχείο. Η παράμετρος meta=ma δίνεται για να επιλεγεί η στήλη που καθορίζει το χρώμα κάθε σημείου. Μέσα στις άγκυλες βρίσκεται το όνομα του αρχείου δεδομένων. ### Ραβδογράμματα Τα ραβδογράμματα (γνωστά επίσης ως bar charts και bar plots) χρησιμοποιούνται για την απεικόνιση συγκεντρωμένων δεδομένων, κυρίως στατιστικών δεδομένων για έναν πληθυσμό κάποιου είδους. Τα bar plots στο `pgfplots` είναι ιδιαίτερα παραμετροποιήσιμα, αλλά εδώ θα δείξουμε ένα απλό παράδειγμα: ```latex \begin{tikzpicture} \begin{axis}[ x tick label style={ /pgf/number format/1000 sep=}, ylabel=Έτος, enlargelimits=0.05, legend style={at={(0.5,-0.1)}, anchor=north,legend columns=-1}, ybar interval=0.7, ] \addplot coordinates {(2012,408184) (2011,408348) (2010,414870) (2009,412156)}; \addplot coordinates {(2012,388950) (2011,393007) (2010,398449) (2009,395972)}; \legend{Άνδρες,Γυναίκες} \end{axis} \end{tikzpicture} ``` [Ανοίξτε αυτό το `pgfplots` παράδειγμα κώδικα bar στο Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=pgfplots+bar+chart+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bmargin%3D0.5in%5D%7Bgeometry%7D%0A%5Cusepackage%7Btextcomp%7D%0A%5Cusepackage%7Bpgfplots%7D%0A%5Cpgfplotsset%7Bwidth%3D10cm%2Ccompat%3D1.9%7D%0A%25%5Cusepgfplotslibrary%7Bexternal%7D%0A%25%5Ctikzexternalize%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btikzpicture%7D%0A%5Cbegin%7Baxis%7D%5B%0A%09x+tick+label+style%3D%7B%0A%09%09%2Fpgf%2Fnumber+format%2F1000+sep%3D%7D%2C%0A%09ylabel%3DYear%2C%0A%09enlargelimits%3D0.05%2C%0A%09legend+style%3D%7Bat%3D%7B%280.5%2C-0.1%29%7D%2C%0A%09anchor%3Dnorth%2Clegend+columns%3D-1%7D%2C%0A%09ybar+interval%3D0.7%2C%0A%5D%0A%5Caddplot+%0A%09coordinates+%7B%282012%2C408184%29+%282011%2C408348%29%0A%09%09+%282010%2C414870%29+%282009%2C412156%29%7D%3B%0A%5Caddplot+%0A%09coordinates+%7B%282012%2C388950%29+%282011%2C393007%29+%0A%09%09%282010%2C398449%29+%282009%2C395972%29%7D%3B%0A%5Clegend%7BMen%2CWomen%7D%0A%5Cend%7Baxis%7D%0A%5Cend%7Btikzpicture%7D%0A%5Cend%7Bdocument%7D) Το αποτέλεσμα αυτού του κώδικα φαίνεται στην παρακάτω εικόνα—το προοίμιο του εγγράφου LaTeX προστίθεται αυτόματα όταν ανοίξετε τον σύνδεσμο: ![Barchartsexample.png](/files/18a2b15c53c20b2fcc722325a9e70b2a7a8cde7f) #### Επεξήγηση του κώδικα Το σχήμα ξεκινά με τη ([προηγουμένως εξηγημένη](#introduction)) δήλωση των `tikzpicture` και `axis` περιβαλλόντων, αλλά η `axis` δήλωση έχει έναν αριθμό νέων παραμέτρων: **x tick label style={/pgf/number format/1000 sep=}** Αυτό το κομμάτι κώδικα ορίζει ένα πλήρες στυλ για το γράφημα. Με αυτό το στυλ μπορείτε να συμπεριλάβετε πολλές εντολές \addplot μέσα σε αυτό το περιβάλλον axis· θα ταιριάξουν και θα φαίνονται ωραία μαζί χωρίς περαιτέρω ρυθμίσεις (η παράμετρος ybar που περιγράφεται παρακάτω είναι υποχρεωτική για να λειτουργήσει αυτό). **enlargelimits=0.05.** Η μεγέθυνση των ορίων σε ένα ραβδόγραμμα είναι απαραίτητη επειδή αυτού του είδους τα γραφήματα συχνά απαιτούν λίγο επιπλέον χώρο πάνω από τη ράβδο για να φαίνονται καλύτερα ή/και για να προστεθεί μια ετικέτα. Τότε ο αριθμός 0.05 είναι σχετικός με το συνολικό ύψος του γραφήματος. **legend style={at={(0.5,-0.2)}, anchor=north,legend columns=-1}** Και πάλι, αυτό θα λειτουργήσει μια χαρά τις περισσότερες φορές. Αν χρειαστεί, αλλάξτε την τιμή του -0.2 για να τοποθετήσετε το υπόμνημα πιο κοντά/πιο μακριά από τον άξονα x. **ybar interval=0.7,** Πάχος κάθε ράβδου. Το 1 σημαίνει ότι οι ράβδοι θα βρίσκονται η μία δίπλα στην άλλη χωρίς κενά και το 0 σημαίνει ότι δεν θα υπάρχουν ράβδοι, αλλά μόνο κάθετες γραμμές. Η `coordinates` σε αυτό το είδος γραφήματος καθορίζουν το σημείο βάσης της ράβδου και το ύψος της. Οι ετικέτες στον άξονα y θα εμφανίζονται έως και με 4 ψηφία. Αν οι αριθμοί με τους οποίους εργάζεστε είναι μεγαλύτεροι από 9999 `pgfplots` θα χρησιμοποιηθεί η ίδια σημειογραφία όπως στο παράδειγμα. ## 3D Γραφήματα `pgfplots` έχει τις δυνατότητες σχεδίασης 3D που θα περιμένατε σε ένα λογισμικό σχεδίασης. ### Σχεδίαση μαθηματικών παραστάσεων Υπάρχει ένα απλό παράδειγμα γι' αυτό στο [εισαγωγή](#introduction), ας δουλέψουμε σε κάτι ελαφρώς πιο σύνθετο: ```latex \begin{tikzpicture} \begin{axis}[ title={Παράδειγμα με χρήση της παραμέτρου mesh}, hide axis, colormap/cool, ] \addplot3[ mesh, samples=50, domain=-8:8, ] {sin(deg(sqrt(x^2+y^2)))/sqrt(x^2+y^2)}; \addlegendentry{\(\frac{sin(r)}{r}\)} \end{axis} \end{tikzpicture} ``` [Ανοίξτε αυτό το `pgfplots` 3D παράδειγμα στο Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=pgfplots+3D+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bmargin%3D0.5in%5D%7Bgeometry%7D%0A%5Cusepackage%7Bpgfplots%7D%0A%5Cpgfplotsset%7Bwidth%3D10cm%2Ccompat%3D1.9%7D%0A%25%5Cusepgfplotslibrary%7Bexternal%7D%0A%25%5Ctikzexternalize%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btikzpicture%7D%0A%5Cbegin%7Baxis%7D%5B%0A++++title%3DExample+using+the+mesh+parameter%2C%0A++++hide+axis%2C%0A++++colormap%2Fcool%2C%0A%5D%0A%5Caddplot3%5B%0A++++mesh%2C%0A++++samples%3D50%2C%0A++++domain%3D-8%3A8%2C%0A%5D%0A%7Bsin%28deg%28sqrt%28x%5E2%2By%5E2%29%29%29%2Fsqrt%28x%5E2%2By%5E2%29%7D%3B%0A%5Caddlegendentry%7B%5C%28%5Cfrac%7Bsin%28r%29%7D%7Br%7D%5C%29%7D%0A%5Cend%7Baxis%7D%0A%5Cend%7Btikzpicture%7D%0A%5Cend%7Bdocument%7D) Το αποτέλεσμα αυτού του κώδικα φαίνεται στην παρακάτω εικόνα—το προοίμιο του εγγράφου LaTeX προστίθεται αυτόματα όταν ανοίξετε τον σύνδεσμο: ![Pgfplots3dexample.png](/files/0e2c761b5695681e076e9afd9bcf4a8646e0d467) #### Επεξήγηση του κώδικα Οι περισσότερες εντολές εδώ έχουν ήδη εξηγηθεί, αλλά υπάρχουν 3 νέα πράγματα: **hide axis** Αυτή η επιλογή στο περιβάλλον axis είναι αυτονόητη, οι άξονες δεν θα εμφανιστούν. **colormap/cool** Είναι το χρωματικό σχήμα που θα χρησιμοποιηθεί στο γράφημα. Ελέγξτε τον οδηγό αναφοράς για περισσότερα χρωματικά σχήματα. **mesh** Αυτή η επιλογή είναι επίσης αυτονόητη· ελέγξτε επίσης την παράμετρο surf στο εισαγωγικό παράδειγμα. **Σημείωση**: Όταν εργάζεστε με τριγωνομετρικές συναρτήσεις `pgfplots` χρησιμοποιεί μοίρες ως προεπιλεγμένες μονάδες· αν η γωνία είναι σε ακτίνια (όπως σε αυτό το παράδειγμα) πρέπει να χρησιμοποιήσετε τη `deg` συνάρτηση για μετατροπή σε μοίρες. ### Γραφήματα ισοϋψών Στο `pgfplots` είναι δυνατό να σχεδιαστούν γραφήματα ισοϋψών, αλλά τα δεδομένα πρέπει να έχουν προϋπολογιστεί από εξωτερικό πρόγραμμα. Ας δούμε ένα παράδειγμα: ```latex \begin{tikzpicture} \begin{axis} [ title={Γράφημα ισοϋψών, προβολή από πάνω}, view={0}{90} ] \addplot3[ contour gnuplot={levels={0.8, 0.4, 0.2, -0.2}} ] {sin(deg(sqrt(x^2+y^2)))/sqrt(x^2+y^2)}; \end{axis} \end{tikzpicture} ``` [Ανοίξτε αυτό το `pgfplots` παράδειγμα γραφήματος ισοϋψών στο Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=pgfplots+contour+plot+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bmargin%3D0.5in%5D%7Bgeometry%7D%0A%5Cusepackage%7Bpgfplots%7D%0A%5Cpgfplotsset%7Bwidth%3D10cm%2Ccompat%3D1.9%7D%0A%25%5Cusepgfplotslibrary%7Bexternal%7D%0A%25%5Ctikzexternalize%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btikzpicture%7D%0A%5Cbegin%7Baxis%7D%0A%5B%0A++++title%3D%7BContour+plot%2C+view+from+top%7D%2C%0A++++view%3D%7B0%7D%7B90%7D%0A%5D%0A%5Caddplot3%5B%0A++++contour+gnuplot%3D%7Blevels%3D%7B0.8%2C+0.4%2C+0.2%2C+-0.2%7D%7D%0A%5D%0A%7Bsin%28deg%28sqrt%28x%5E2%2By%5E2%29%29%29%2Fsqrt%28x%5E2%2By%5E2%29%7D%3B%0A%5Cend%7Baxis%7D%0A%5Cend%7Btikzpicture%7D%0A%0A%5Cend%7Bdocument%7D) Το αποτέλεσμα αυτού του κώδικα φαίνεται στην παρακάτω εικόνα—το προοίμιο του εγγράφου LaTeX προστίθεται αυτόματα όταν ανοίξετε τον σύνδεσμο: ![Contourplotexample.png](/files/4d9562175bfc2e9b456064cee1d28fcbee99c109) #### Επεξήγηση του κώδικα Αυτό είναι ένα γράφημα με μερικές γραμμές ισοϋψών για την ίδια εξίσωση που χρησιμοποιήθηκε στην προηγούμενη ενότητα. Η τιμή της `τίτλο` παραμέτρου βρίσκεται μέσα σε άγκυλες {} επειδή περιέχει κόμμα, οπότε χρησιμοποιούμε τις αγκύλες ομαδοποίησης για να αποφύγουμε οποιαδήποτε σύγχυση με τις άλλες παραμέτρους που δίνονται στη `\begin{axis}` δήλωση. Υπάρχουν δύο νέες εντολές: **view={0}{90}** Αυτό αλλάζει την προβολή του γραφήματος. Η παράμετρος δίνεται στο περιβάλλον axis, πράγμα που σημαίνει ότι μπορεί να χρησιμοποιηθεί σε οποιονδήποτε άλλο τύπο 3D γραφήματος. Η πρώτη τιμή είναι μια περιστροφή, σε μοίρες, γύρω από τον άξονα z· η δεύτερη τιμή είναι η περιστροφή της προβολής γύρω από τον άξονα x. Σε αυτό το παράδειγμα, όταν συνδυάζουμε μια περιστροφή 0° γύρω από τον άξονα z και μια περιστροφή 90° γύρω από τον άξονα x, καταλήγουμε σε προβολή του γραφήματος από πάνω. **contour gnuplot={levels={0.8, 0.4, 0.2, -0.2}}** Αυτή η γραμμή κώδικα κάνει δύο πράγματα: Πρώτον, λέει στο LaTeX να χρησιμοποιήσει το εξωτερικό λογισμικό gnuplot για να υπολογίσει τις γραμμές ισοϋψών· αυτό λειτουργεί καλά στο Overleaf, αλλά αν θέλετε να χρησιμοποιήσετε αυτή την εντολή στην τοπική σας εγκατάσταση LaTeX πρέπει πρώτα να εγκαταστήσετε το gnuplot (το matlab θα λειτουργήσει επίσης, σε αυτή την περίπτωση γράψτε matlab αντί για gnuplot στην εντολή). Δεύτερον, η υποπαράμετρος levels είναι μια λίστα τιμών υψομέτρων όπου πρόκειται να υπολογιστούν οι γραμμές ισοϋψών. ### Σχεδίαση επιφάνειας από δεδομένα Για να σχεδιάσουμε ένα σύνολο δεδομένων ως 3D επιφάνεια, το μόνο που χρειαζόμαστε είναι οι συντεταγμένες κάθε σημείου. Αυτές οι συντεταγμένες μπορεί να είναι ένα μη ταξινομημένο σύνολο ή, σε αυτή την περίπτωση, ένας πίνακας: ```latex \begin{tikzpicture} \begin{axis} \addplot3[ surf, ] coordinates { (0,0,0) (0,1,0) (0,2,0) (1,0,0) (1,1,0.6) (1,2,0.7) (2,0,0) (2,1,0.7) (2,2,1.8) }; \end{axis} \end{tikzpicture} ``` [Ανοίξτε αυτό το `pgfplots` Παράδειγμα 3D επιφάνειας στο Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=plotting+a+surface+from+data+with+pgfplots\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bmargin%3D0.5in%5D%7Bgeometry%7D%0A%5Cusepackage%7Bpgfplots%7D%0A%5Cpgfplotsset%7Bwidth%3D10cm%2Ccompat%3D1.9%7D%0A%25%5Cusepgfplotslibrary%7Bexternal%7D%0A%25%5Ctikzexternalize%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btikzpicture%7D%0A%5Cbegin%7Baxis%7D%0A%5Caddplot3%5B%0A++++surf%2C%0A%5D+%0Acoordinates+%7B%0A%280%2C0%2C0%29+%280%2C1%2C0%29+%280%2C2%2C0%29%0A%0A%281%2C0%2C0%29+%281%2C1%2C0.6%29+%281%2C2%2C0.7%29%0A%0A%282%2C0%2C0%29+%282%2C1%2C0.7%29+%282%2C2%2C1.8%29%0A%7D%3B%0A%5Cend%7Baxis%7D%0A%5Cend%7Btikzpicture%7D%0A%0A%5Cend%7Bdocument%7D) Το αποτέλεσμα αυτού του κώδικα φαίνεται στην παρακάτω εικόνα—το προοίμιο του εγγράφου LaTeX προστίθεται αυτόματα όταν ανοίξετε τον σύνδεσμο: ![3dsurfacedata.png](/files/b29cd4c15d060acd5527a2eccc71eb3e8266f73c) #### Επεξήγηση των δεδομένων Τα σημεία που δίνονται στην `coordinates` παράμετρο αντιμετωπίζονται ως να περιέχονται σε έναν πίνακα 3 × 3, χρησιμοποιώντας μια κενή γραμμή ως διαχωριστικό για κάθε γραμμή του πίνακα. Όλες οι επιλογές για 3D γραφήματα σε αυτό το άρθρο ισχύουν και για επιφάνειες δεδομένων. ### Παραμετρικό γράφημα Η σύνταξη για τα παραμετρικά γραφήματα είναι ελαφρώς διαφορετική. Ας δούμε ένα παράδειγμα: ```latex \begin{tikzpicture} \begin{axis} [ view={60}{30}, ] \addplot3[ domain=0:5*pi, samples = 60, samples y=0, ] ({sin(deg(x))}, {cos(deg(x))}, {x}); \end{axis} \end{tikzpicture} ``` [Ανοίξτε αυτό το `pgfplots` παράδειγμα παραμετρικού γραφήματος στο Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=pgfplots+parametric+plot+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bmargin%3D0.5in%5D%7Bgeometry%7D%0A%5Cusepackage%7Bpgfplots%7D%0A%5Cpgfplotsset%7Bwidth%3D10cm%2Ccompat%3D1.9%7D%0A%25%5Cusepgfplotslibrary%7Bexternal%7D%0A%25%5Ctikzexternalize%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btikzpicture%7D%0A%5Cbegin%7Baxis%7D%0A++++%5B%0A++++view%3D%7B60%7D%7B30%7D%2C%0A++++%5D%0A%5Caddplot3%5B%0A++++domain%3D0%3A5%2Api%2C%0A++++samples+%3D+60%2C%0A++++samples+y%3D0%2C%0A%5D%0A%28%7Bsin%28deg%28x%29%29%7D%2C%0A%7Bcos%28deg%28x%29%29%7D%2C%0A%7Bx%7D%29%3B%0A%5Cend%7Baxis%7D%0A%5Cend%7Btikzpicture%7D%0A%5Cend%7Bdocument%7D) Το αποτέλεσμα αυτού του κώδικα φαίνεται στην παρακάτω εικόνα—το προοίμιο του εγγράφου LaTeX προστίθεται αυτόματα όταν ανοίξετε τον σύνδεσμο: ![Parametricplot.png](/files/f3a3a2aa65e319bd758d62b1c8932d8439ce1014) #### Επεξήγηση του κώδικα Υπάρχουν μόνο δύο νέα πράγματα σε αυτό το παράδειγμα: πρώτον, το `samples y=0` για να αποτραπεί `pgfplots` το να ενωθούν τα ακραία σημεία της σπείρας και· δεύτερον, ο τρόπος με τον οποίο η συνάρτηση που θα σχεδιαστεί δίνεται στο `addplot3` περιβάλλον. Κάθε συνάρτηση παραμέτρου ομαδοποιείται μέσα σε άγκυλες {} και οι τρεις παράμετροι οριοθετούνται με παρένθεση. ## Οδηγός αναφοράς | Εντολή/Επιλογή/Περιβάλλον | Περιγραφή | Πιθανές τιμές | | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **axis** | Κανονικά γραφήματα με γραμμική κλίμακα | | | **semilogxaxis** | λογαριθμική κλίμακα του x και κανονική κλίμακα για το y | | | **semilogyaxis** | λογαριθμική κλίμακα για το y και κανονική κλίμακα για το x | | | **loglogaxis** | λογαριθμική κλίμακα για τους άξονες x και y | | | **axis lines** | αλλάζει τον τρόπο με τον οποίο σχεδιάζονται οι άξονες. Η προεπιλογή είναι '*κουτί* | box, left, middle, center, right, none | | **legend pos** | θέση του πλαισίου υπομνήματος | south west, south east, north west, north east, outer north east | | **mark** | τύπος σημάνσεων που χρησιμοποιούνται στη σχεδίαση δεδομένων. Όταν χρησιμοποιείται ένας μονοχαρακτήρας, η εμφάνιση του χαρακτήρα είναι πολύ παρόμοια με το πραγματικό σημάδι. | \*, x , +, \|, o, asterisk, star, 10-pointed star, oplus, oplus\*, otimes, otimes\*, square, square\*, triangle, triangle\*, diamond, halfdiamond\*, halfsquare\*, right\*, left\*, Mercedes star, Mercedes star flipped, halfcircle, halfcircle\*, pentagon, pentagon\*, cubes. (τα cubes λειτουργούν μόνο σε 3D γραφήματα). | | **colormap** | χρωματικό σχήμα που θα χρησιμοποιηθεί σε ένα γράφημα, μπορεί να εξατομικευτεί, αλλά υπάρχουν ορισμένα προκαθορισμένα colormaps | hot, hot2, jet, blackwhite, bluered, cool, greenyellow, redyellow, violet. | ## Περαιτέρω ανάγνωση Για περισσότερες πληροφορίες δείτε: * [Χρήση χρωμάτων στο LaTeX](/latex/el/morfopoiisi/13-using-colors-in-latex.md) * [Πακέτο TikZ](/latex/el/sximata-kai-pinakes/05-tikz-package.md) * [Εξωτερίκευση των pgfplots και των tikzpictures](/latex/el/erotiseis-and-apantiseis/60-i-have-a-lot-of-tikz-matlab2tikz-or-pgfplots-figures-so-i-m-getting-a-compilation-timeout.-can-i.md) * [Εισαγωγή εικόνων](/latex/el/perissotera-themata/27-inserting-images.md) * [Κατάλογοι πινάκων και σχημάτων](/latex/el/sximata-kai-pinakes/03-lists-of-tables-and-figures.md) * [Τοποθέτηση εικόνων και πινάκων](/latex/el/sximata-kai-pinakes/02-positioning-images-and-tables.md) * [Σχεδίαση διαγραμμάτων απευθείας στο LaTeX](/latex/el/sximata-kai-pinakes/04-picture-environment.md) * [Η **pgfplots** τεκμηρίωση πακέτου](http://mirrors.ctan.org/graphics/pgf/contrib/pgfplots/doc/pgfplots.pdf). * [Τα πακέτα TikZ και PGF: Εγχειρίδιο για την έκδοση 3.0.0](http://mirror.utexas.edu/ctan/graphics/pgf/base/doc/pgfmanual.pdf) * [Παραδείγματα TikZ και PGF στο TeXample.net](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/el/eidiko-pedio/08-pgfplots-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.