Wykres (gplot)

MetodaDeklaracja metodyPrzykład wywołaniaOpis działania
Deklaracja obiektu wykresgplot()gplot gpDeklarowana jest zmienna typu wykres
Deklaracja obiektu wykres i otworzenie pliku wykresu do edycjigplot(Text name,Text path=Text())gplot gp("sample")Deklarowana jest zmienna typu wykres i otwierany jest plik o podanej nazwie do edycji (rysowania). Opcjonalnie można podać ścieżkę do katalogu, w którym wykres będzie zapisany. Domyślnie wybierany jest bieżący katalog.
Po tej instrukcji można rozpocząć rysowanie.
Otworzenie pliku wykresu do edycjivoid open(Text name,Text path=Text())gp.open("sample2")Otwierany jest plik wykresu.
Po tej instrukcji można rozpocząć rysowanie.
Zamknięcie pliku wykresuvoid close()gp.close()Zamykany jest plik wykresu.
Ta instrukcja kończy rysowanie.
Nazwa pliku wykresuText getname()gp.getname()Zwracana jest nazwa pliku wykresu
Sprawdzenie czy plik jest otwarty do edycjiint isopen()gp.isopen()Zwracana jest wartość 1 (true), jeśli otwarto plik do edycji. Albo 0 (false) - w przeciwnym przypadku.
Wykres wielokrotnyvoid multiplot(int set=1,int rows=1,int cols=2)gp.multiplot(1,2,2)Włączenie/wyłączenie trybu wielu wykresów (‘set’ równe 1 oznacza włączenie, a równe 0 wyłączenie). Można wybrać liczbę wykresów w pionie (rows) i poziomie (cols).
W podanym przykładzie włączony zostaje tryb z czterema wykresami na jednej ilustracji (2x2).
Tytułvoid title(Text t)gp.title("Tytuł wykresu")Wykres jest tytułowany
Stylvoid style(Text t)gp.style("fill solid border -1")Ustawienie stylu rysowania
Szerokość słupkavoid boxwidth(double d)gp.boxwidth(5)Ustawienie szerokości słupków dla wykresów, które zawierają ten element.
Zakresy osivoid xrange(double d1,double d2)
void yrange(double d1,double d2)
void zrange(double d1,double d2)
gp.xrange(-10,10)Wybór zakresu dla osi X, Y i Z
Tytuły osivoid xlabel(Text t)
void ylabel(Text t)
void zlabel(Text t)
gp.xlabel("Oś X")Dodawanie podpisów osi X, Y i Z
Legendavoid key(Text t)gp.key("bot right")Włączenie legendy i wybór jej położenia
Próbkowanievoid samples(double d)gp.samples(100)Liczba próbek rysowanej funkcji
Próbkowanie ISOvoid isosamples(double d)gp.isosamples(10)Gęstość siatki dla wykresów 3D
Tryb parametrycznyvoid parametric(int set)gp.parametric(1)Włączenie/wyłączenie rysowania funkcji parametrycznych (‘set’ równe 1 oznacza włączenie, a równe 0 wyłączenie)
Kąt widzeniavoid view(double d1,double d2)gp.view(65,55)Wybór kąta widzenia dla wykresów 3D
Pojedyncza etykietavoid label(int i,Text t,double d1,double d2)gp.label(1,"Jakiś napis”,200,100)Dodaje dowolny napis w miejscu o współrzędnych (d1,d2). Parametr ‘i’ umożliwia numerowanie etykiet.
Obiektvoid object(Text t)gp.object("polygon from 10,10 to 20,20 fc rgb 'orange'")Umożliwia rysowanie obiektów (prostokątów, kół, elips, wielokątów)
Typ znaczników osivoid xtics(Text t)
void ytics(Text t)
void ztics(Text t)
gp.xtics("rotate by -90")Umożliwia ustawienie sposobu wyświetlania znaczników osi X, Y i Z.
Marginesvoid bmargin(double d)gp.bmargin(10)Ustawienie szerokości dolnego marginesu
Resetvoid reset()gp.reset()Zresetowanie wykresu. Przywracane są wszystkie standardowe ustawienia.
Wykres danych z pliku lub funkcji zdefiniowanej napisemvoid plot(Text data1,Text modif1=Text(),Text title1=Text(),Text style1=Text(),…)gp.plot("dane_wykresu.txt","1:2","Zmienna 1","boxes", "~","1:3","Zmienna 2","boxes")

gp.plot("2.5*sin(x)+x/10.0","","Wykres funkcji")
Rysowanie wykresu 2D ma podstawie danych z pliku tekstowego lub funkcji zdefiniowanej napisem. Parametry:
- data1 – nazwa pliku lub funkcja
- modif1 – wybór zakresu kolumn
- title1 – tytuł krzywej
- style1 – styl rysowania krzywej

Można zdefiniować do pięciu niezależnych źródeł danych lub funkcji, posiadających identyczny zestaw parametrów jak opisane wyżej. Istnieje również funkcja ‘splot’, mająca identyczne parametry, służąca do rysowania powierzchni (wykres 3D).

W pierwszym przykładzie rysunek korzysta z pliku „dane_wykresu.txt”. Rysowany jest wykres pudełkowy dla danych x z kolumny 1 i danych y z kolumny 2. Krzywa otrzymuje opis „Zmienna 1”. Rysowana jest także druga krzywa na podstawie danych z tego samego pliku (znak ~ oznacza powtórzenie źródła danych). Dane x są brane z kolumny 1, a dane y z kolumny 3. Krzywa otrzymuje opis „Zmienna 2”.

W drugim przykładzie rysowana jest funkcja 2.5*sin(x)+x/10. Krzywa otrzymuje opis „Wykres funkcji”.
Wykres danych z tabelivoid plot(table tab1,Text modif1=Text(),Text title1=Text(),Text style1=Text(),…)gp.plot(tabela,"1:2","Zmienna 1","boxes", "~","1:3","Zmienna 2","boxes")Rysowanie wykresu 2D na podstawie danych z podanej tabeli.
Funkcjonalność identyczna jak funkcji ‘plot’ rysującej na podstawie danych z pliku tekstowego.

‘Splot’ tworzy wykres 3D.
Wykres danych z macierzyvoid plot(matrix mat1,Text modif1=Text(),Text title1=Text(),Text style1=Text(),…)gp.plot(macierz,"1:2","Zmienna 1","boxes", "~","1:3","Zmienna 2","boxes")Rysowanie wykresu 2D na podstawie danych z podanej macierzy.
Funkcjonalność identyczna jak funkcji ‘plot’ rysującej na podstawie danych z pliku tekstowego.

‘Splot’ tworzy wykres 3D.
Ustawienievoid set(Text t)gp.set("key bot right\n")
Umożliwa ustawienie dowolnego parametru wykresu
Definicjavoid define(Text t)gp.define ("min(a,b)=(a<=b)*a+(a>b)*b")Umożliwia zdefiniowanie funkcji, wykorzystywanej na wykresie.
Instrukcjavoid inst(Text t)gp.inst("set xdata time")Wywołanie dowolnej instrukcji gnuplot.
Instrukcja otwartavoid instc(Text t)gp.instc("plot ‘dane_wykresu.txt’ 1:2,")Wywołanie dowolnej instrukcji gnuplot bez kończenia wiersza. Instrukcja otwarta umożliwia kontynuowanie instrukcji gnuplot w następnej linii programu.
Odstępvoid sep(char c='-',int l=70)gp.sep(‘*’,30)Dodanie separatora do kodu skryptu
Koniec liniivoid endl(int n=1)gp.endl()Znak końca wiersza
Komentarzvoid comment(Text t)gp.comment("Jakiś komentarz")Komentarz skryptu gnuplot
Komentarz specjalnyvoid speccom(Text t,char c='-',int l=70)gp.speccom("Jakiś komentarz")Komentarz skryptu wyróżniony liniami separującymi
Pauzavoid pause(int time=-1,Text info="Hit return to continue")gp.pause()Zatrzymuje skrypt gnuplot po wyświetleniu wykresu. Można wybrać czas (-1 oznacza oczekiwanie na kliknięcie myszką). W okienku informacyjnym wyświetlany jest komunikat zdefiniowany przez parametr ‘info’.