Module: GR
- Extended by:
- GRCommons::GRCommonUtils, GRCommons::JupyterSupport
- Defined in:
- lib/gr.rb,
lib/gr/ffi.rb,
lib/gr/plot.rb,
lib/gr/grbase.rb,
lib/gr/version.rb,
lib/gr_commons/gr_logger.rb
Overview
OverView of GR.rb
+--------------------+ +--------------------+
| GR module | | GR3 module |
| +----------------+ | | +----------------+ |
| | GR::FFI | | | | GR3::FFI | |
| | + libGR.so | | | | + libGR3.so | |
| +----------------+ | | +----------------+ |
| | define_method | | | define_method |
| +----------------+ | | +----------------+ |
| | | GR::GRBase | | | | | GR3::GR3Base | |
| | v (Pri^ate) | | | | v (Pri^ate) | |
| +++--------------+ | | +++--------------+ |
| | Extend | | | Extend |
| v | | v +-------+ |
| +-----------+ | | | Check | |
| | GR::Plot | | | <--+ Error | |
| +-----------+ | | +-------+ |
+--------------------+ +----------+---------+
^ ^
| +------------------+ |
Extend | | GRCommons module | | Extend
| | +--------------+ | |
| | | Fiddley | | |
| | +--------------+ | |
| | +--------------+ | |
+----+ CommonUtils +----+
| | +--------------+ | |
| | +--------------+ | |
+----+ Version +----+
| | +--------------+ |
| | +--------------+ |
+----+JupyterSupport| |
| +--------------+ |
+------------------+
(You can edit the above AA diagram with asciiflow.com/)
Fiddley is Ruby-FFI compatible API layer for Fiddle.
The GR module works without Numo::Narrray. GR3 and GR::Plot depends on numo-narray.
This is a procedural interface to the GR plotting library, github.com/sciapp/gr
Defined Under Namespace
Modules: FFI Classes: Error, NotFoundError, Plot
Constant Summary collapse
- ASF_BUNDLED =
0
- ASF_INDIVIDUAL =
1
- NOCLIP =
0
- CLIP =
1
- COORDINATES_WC =
0
- COORDINATES_NDC =
1
- INTSTYLE_HOLLOW =
0
- INTSTYLE_SOLID =
1
- INTSTYLE_PATTERN =
2
- INTSTYLE_HATCH =
3
- TEXT_HALIGN_NORMAL =
0
- TEXT_HALIGN_LEFT =
1
- TEXT_HALIGN_CENTER =
2
- TEXT_HALIGN_RIGHT =
3
- TEXT_VALIGN_NORMAL =
0
- TEXT_VALIGN_TOP =
1
- TEXT_VALIGN_CAP =
2
- TEXT_VALIGN_HALF =
3
- TEXT_VALIGN_BASE =
4
- TEXT_VALIGN_BOTTOM =
5
- TEXT_PATH_RIGHT =
0
- TEXT_PATH_LEFT =
1
- TEXT_PATH_UP =
2
- TEXT_PATH_DOWN =
3
- TEXT_PRECISION_STRING =
0
- TEXT_PRECISION_CHAR =
1
- TEXT_PRECISION_STROKE =
2
- LINETYPE_SOLID =
1
- LINETYPE_DASHED =
2
- LINETYPE_DOTTED =
3
- LINETYPE_DASHED_DOTTED =
4
- LINETYPE_DASH_2_DOT =
-1
- LINETYPE_DASH_3_DOT =
-2
- LINETYPE_LONG_DASH =
-3
- LINETYPE_LONG_SHORT_DASH =
-4
- LINETYPE_SPACED_DASH =
-5
- LINETYPE_SPACED_DOT =
-6
- LINETYPE_DOUBLE_DOT =
-7
- LINETYPE_TRIPLE_DOT =
-8
- MARKERTYPE_DOT =
1
- MARKERTYPE_PLUS =
2
- MARKERTYPE_ASTERISK =
3
- MARKERTYPE_CIRCLE =
4
- MARKERTYPE_DIAGONAL_CROSS =
5
- MARKERTYPE_SOLID_CIRCLE =
-1
- MARKERTYPE_TRIANGLE_UP =
-2
- MARKERTYPE_SOLID_TRI_UP =
-3
- MARKERTYPE_TRIANGLE_DOWN =
-4
- MARKERTYPE_SOLID_TRI_DOWN =
-5
- MARKERTYPE_SQUARE =
-6
- MARKERTYPE_SOLID_SQUARE =
-7
- MARKERTYPE_BOWTIE =
-8
- MARKERTYPE_SOLID_BOWTIE =
-9
- MARKERTYPE_HOURGLASS =
-10
- MARKERTYPE_SOLID_HGLASS =
-11
- MARKERTYPE_DIAMOND =
-12
- MARKERTYPE_SOLID_DIAMOND =
-13
- MARKERTYPE_STAR =
-14
- MARKERTYPE_SOLID_STAR =
-15
- MARKERTYPE_TRI_UP_DOWN =
-16
- MARKERTYPE_SOLID_TRI_RIGHT =
-17
- MARKERTYPE_SOLID_TRI_LEFT =
-18
- MARKERTYPE_HOLLOW_PLUS =
-19
- MARKERTYPE_SOLID_PLUS =
-20
- MARKERTYPE_PENTAGON =
-21
- MARKERTYPE_HEXAGON =
-22
- MARKERTYPE_HEPTAGON =
-23
- MARKERTYPE_OCTAGON =
-24
- MARKERTYPE_STAR_4 =
-25
- MARKERTYPE_STAR_5 =
-26
- MARKERTYPE_STAR_6 =
-27
- MARKERTYPE_STAR_7 =
-28
- MARKERTYPE_STAR_8 =
-29
- MARKERTYPE_VLINE =
-30
- MARKERTYPE_HLINE =
-31
- MARKERTYPE_OMARK =
-32
- OPTION_X_LOG =
1
- OPTION_Y_LOG =
2
- OPTION_Z_LOG =
4
- OPTION_FLIP_X =
8
- OPTION_FLIP_Y =
16
- OPTION_FLIP_Z =
32
- OPTION_LINES =
0
- OPTION_MESH =
1
- OPTION_FILLED_MESH =
2
- OPTION_Z_SHADED_MESH =
3
- OPTION_COLORED_MESH =
4
- OPTION_CELL_ARRAY =
5
- OPTION_SHADED_MESH =
6
- MODEL_RGB =
0
- MODEL_HSV =
1
- COLORMAP_UNIFORM =
0
- COLORMAP_TEMPERATURE =
1
- COLORMAP_GRAYSCALE =
2
- COLORMAP_GLOWING =
3
- COLORMAP_RAINBOWLIKE =
4
- COLORMAP_GEOLOGIC =
5
- COLORMAP_GREENSCALE =
6
- COLORMAP_CYANSCALE =
7
- COLORMAP_BLUESCALE =
8
- COLORMAP_MAGENTASCALE =
9
- COLORMAP_REDSCALE =
10
- COLORMAP_FLAME =
11
- COLORMAP_BROWNSCALE =
12
- COLORMAP_PILATUS =
13
- COLORMAP_AUTUMN =
14
- COLORMAP_BONE =
15
- COLORMAP_COOL =
16
- COLORMAP_COPPER =
17
- COLORMAP_GRAY =
18
- COLORMAP_HOT =
19
- COLORMAP_HSV =
20
- COLORMAP_JET =
21
- COLORMAP_PINK =
22
- COLORMAP_SPECTRAL =
23
- COLORMAP_SPRING =
24
- COLORMAP_SUMMER =
25
- COLORMAP_WINTER =
26
- COLORMAP_GIST_EARTH =
27
- COLORMAP_GIST_HEAT =
28
- COLORMAP_GIST_NCAR =
29
- COLORMAP_GIST_RAINBOW =
30
- COLORMAP_GIST_STERN =
31
- COLORMAP_AFMHOT =
32
- COLORMAP_BRG =
33
- COLORMAP_BWR =
34
- COLORMAP_COOLWARM =
35
- COLORMAP_CMRMAP =
36
- COLORMAP_CUBEHELIX =
37
- COLORMAP_GNUPLOT =
38
- COLORMAP_GNUPLOT2 =
39
- COLORMAP_OCEAN =
40
- COLORMAP_RAINBOW =
41
- COLORMAP_SEISMIC =
42
- COLORMAP_TERRAIN =
43
- COLORMAP_VIRIDIS =
44
- COLORMAP_INFERNO =
45
- COLORMAP_PLASMA =
46
- COLORMAP_MAGMA =
47
- FONT_TIMES_ROMAN =
101
- FONT_TIMES_ITALIC =
102
- FONT_TIMES_BOLD =
103
- FONT_TIMES_BOLDITALIC =
104
- FONT_HELVETICA =
105
- FONT_HELVETICA_OBLIQUE =
106
- FONT_HELVETICA_BOLD =
107
- FONT_HELVETICA_BOLDOBLIQUE =
108
- FONT_COURIER =
109
- FONT_COURIER_OBLIQUE =
110
- FONT_COURIER_BOLD =
111
- FONT_COURIER_BOLDOBLIQUE =
112
- FONT_SYMBOL =
113
- FONT_BOOKMAN_LIGHT =
114
- FONT_BOOKMAN_LIGHTITALIC =
115
- FONT_BOOKMAN_DEMI =
116
- FONT_BOOKMAN_DEMIITALIC =
117
- FONT_NEWCENTURYSCHLBK_ROMAN =
118
- FONT_NEWCENTURYSCHLBK_ITALIC =
119
- FONT_NEWCENTURYSCHLBK_BOLD =
120
- FONT_NEWCENTURYSCHLBK_BOLDITALIC =
121
- FONT_AVANTGARDE_BOOK =
122
- FONT_AVANTGARDE_BOOKOBLIQUE =
123
- FONT_AVANTGARDE_DEMI =
124
- FONT_AVANTGARDE_DEMIOBLIQUE =
125
- FONT_PALATINO_ROMAN =
126
- FONT_PALATINO_ITALIC =
127
- FONT_PALATINO_BOLD =
128
- FONT_PALATINO_BOLDITALIC =
129
- FONT_ZAPFCHANCERY_MEDIUMITALIC =
130
- FONT_ZAPFDINGBATS =
131
- PRINT_PS =
GR.beginprint types
'ps'
- PRINT_EPS =
'eps'
- PRINT_PDF =
'pdf'
- PRINT_PGF =
'pgf'
- PRINT_BMP =
'bmp'
- PRINT_JPEG =
'jpeg'
- PRINT_JPG =
'jpg'
- PRINT_PNG =
'png'
- PRINT_TIFF =
'tiff'
- PRINT_TIF =
'tif'
- PRINT_FIG =
'fig'
- PRINT_SVG =
'svg'
- PRINT_WMF =
'wmf'
- PATH_STOP =
0x00
- PATH_MOVETO =
0x01
- PATH_LINETO =
0x02
- PATH_CURVE3 =
0x03
- PATH_CURVE4 =
0x04
- PATH_CLOSEPOLY =
0x4f
- GDP_DRAW_PATH =
1
- GDP_DRAW_LINES =
2
- GDP_DRAW_MARKERS =
3
- MPL_SUPPRESS_CLEAR =
1
- MPL_POSTPONE_UPDATE =
2
- XFORM_BOOLEAN =
0
- XFORM_LINEAR =
1
- XFORM_LOG =
2
- XFORM_LOGLOG =
3
- XFORM_CUBIC =
4
- XFORM_EQUALIZED =
5
- ENCODING_LATIN1 =
300
- ENCODING_UTF8 =
301
- UPSAMPLE_VERTICAL_DEFAULT =
0x00000000
- UPSAMPLE_HORIZONTAL_DEFAULT =
0x00000000
- DOWNSAMPLE_VERTICAL_DEFAULT =
0x00000000
- DOWNSAMPLE_HORIZONTAL_DEFAULT =
0x00000000
- UPSAMPLE_VERTICAL_NEAREST =
0x00000001
- UPSAMPLE_HORIZONTAL_NEAREST =
0x00000100
- DOWNSAMPLE_VERTICAL_NEAREST =
0x00010000
- DOWNSAMPLE_HORIZONTAL_NEAREST =
0x01000000
- UPSAMPLE_VERTICAL_LINEAR =
0x00000002
- UPSAMPLE_HORIZONTAL_LINEAR =
0x00000200
- DOWNSAMPLE_VERTICAL_LINEAR =
0x00020000
- DOWNSAMPLE_HORIZONTAL_LINEAR =
0x02000000
- UPSAMPLE_VERTICAL_LANCZOS =
0x00000003
- UPSAMPLE_HORIZONTAL_LANCZOS =
0x00000300
- DOWNSAMPLE_VERTICAL_LANCZOS =
0x00030000
- DOWNSAMPLE_HORIZONTAL_LANCZOS =
0x03000000
- RESAMPLE_DEFAULT =
(UPSAMPLE_VERTICAL_DEFAULT | UPSAMPLE_HORIZONTAL_DEFAULT | DOWNSAMPLE_VERTICAL_DEFAULT | DOWNSAMPLE_HORIZONTAL_DEFAULT)
- RESAMPLE_NEAREST =
(UPSAMPLE_VERTICAL_NEAREST | UPSAMPLE_HORIZONTAL_NEAREST | DOWNSAMPLE_VERTICAL_NEAREST | DOWNSAMPLE_HORIZONTAL_NEAREST)
- RESAMPLE_LINEAR =
(UPSAMPLE_VERTICAL_LINEAR | UPSAMPLE_HORIZONTAL_LINEAR | DOWNSAMPLE_VERTICAL_LINEAR | DOWNSAMPLE_HORIZONTAL_LINEAR)
- RESAMPLE_LANCZOS =
(UPSAMPLE_VERTICAL_LANCZOS | UPSAMPLE_HORIZONTAL_LANCZOS | DOWNSAMPLE_VERTICAL_LANCZOS | DOWNSAMPLE_HORIZONTAL_LANCZOS)
- PROJECTION_DEFAULT =
0
- PROJECTION_ORTHOGRAPHIC =
1
- PROJECTION_PERSPECTIVE =
2
- VERSION =
GRCommons::VERSION
Constants included from GRCommons::GRCommonUtils
GRCommons::GRCommonUtils::SUPPORTED_TYPES
Class Attribute Summary collapse
-
.ffi_lib ⇒ Object
Returns the value of attribute ffi_lib.
Class Method Summary collapse
-
._contour_ ⇒ Object
Draw contours of a three-dimensional data set whose values are specified over a rectangular mesh.
-
._contourf_ ⇒ Object
Draw filled contours of a three-dimensional data set whose values are specified over a rectangular mesh.
- ._hexbin_ ⇒ Integer
- ._shade_ ⇒ Object
-
._surface_ ⇒ Object
Draw a three-dimensional surface plot for the given data points.
-
.activatews ⇒ Object
Activate the specified workstation.
- .adjustlimits(amin, amax) ⇒ Integer
- .adjustrange(amin, amax) ⇒ Object
-
.axes ⇒ Object
(also: axes2d)
Draw X and Y coordinate axes with linearly and/or logarithmically spaced tick marks.
-
.axes3d ⇒ Object
Draw X, Y and Z coordinate axes with linearly and/or logarithmically spaced tick marks.
-
.axeslbl ⇒ Object
Create axes in the current workspace and supply a custom function for changing the behaviour of the tick labels.
-
.barplot(labels, heights, kv = {}) ⇒ Object
(Plot) Draw a bar plot.
-
.begingraphics ⇒ Object
Open a file for graphics output.
-
.beginprint(file_path) ⇒ Object
Open and activate a print device.
-
.beginprintext ⇒ Object
Open and activate a print device with the given layout attributes.
- .beginselection ⇒ Object
-
.camerainteraction ⇒ Object
Rotate the current scene according to a virtual arcball.
-
.cellarray(xmin, xmax, ymin, ymax, dimx, dimy, color) ⇒ Object
Display rasterlike images in a device-independent manner.
-
.clearws ⇒ Object
Clear the specified workstation.
- .closegks ⇒ Object
- .closeseg ⇒ Object
-
.closews ⇒ Object
Close the specified workstation.
- .colorbar ⇒ Object
-
.configurews ⇒ Object
Configure the specified workstation.
-
.contour(*args) ⇒ Object
(Plot) Draw a contour plot.
-
.contourf(*args) ⇒ Object
(Plot) Draw a filled contour plot.
- .copysegws ⇒ Object
- .createseg ⇒ Object
-
.deactivatews ⇒ Object
Deactivate the specified workstation.
- .delaunay(x, y) ⇒ Integer
- .destroycontext ⇒ Object
-
.drawarc ⇒ Object
Draw a circular or elliptical arc covering the specified rectangle.
-
.drawarrow ⇒ Object
Draw an arrow between two points.
- .drawgraphics ⇒ Integer
-
.drawimage(xmin, xmax, ymin, ymax, width, height, data, model = 0) ⇒ Object
Draw an image into a given rectangular area.
-
.drawpath(points, codes, fill) ⇒ Object
Draw simple and compound outlines consisting of line segments and bezier curves.
-
.drawrect ⇒ Object
Draw a rectangle using the current line attributes.
- .emergencyclosegks ⇒ Object
- .endgraphics ⇒ Object
- .endprint ⇒ Object
- .endselection ⇒ Object
-
.fillarc ⇒ Object
Fill a circular or elliptical arc covering the specified rectangle.
-
.fillarea(x, y) ⇒ Object
Allows you to specify a polygonal shape of an area to be filled.
-
.fillrect ⇒ Object
Draw a filled rectangle using the current fill attributes.
- .findboundary ⇒ Object
-
.gdp(x, y, primid, datrec) ⇒ Object
Generates a generalized drawing primitive (GDP) of the type you specify, using specified points and any additional information contained in a data record.
- .getgraphics ⇒ String
- .gradient(x, y, z) ⇒ Object deprecated Deprecated.
-
.grid ⇒ Object
Draw a linear and/or logarithmic grid.
-
.grid3d ⇒ Object
Draw a linear and/or logarithmic grid.
-
.gridit(xd, yd, zd, nx, ny) ⇒ Object
Interpolate data from arbitrary points at points on a rectangular grid.
-
.heatmap(*args) ⇒ Object
(Plot) Draw a heatmap.
-
.herrorbars(x, y, e1, e2) ⇒ Object
Draw a standard horizontal error bar graph.
-
.hexbin(*args) ⇒ Object
(Plot) Draw a hexagon binning plot.
-
.histogram(series, kv = {}) ⇒ Object
(Plot) Draw a histogram.
- .hold(flag = true) ⇒ Object
- .hsvtorgb(h, s, v) ⇒ Integer
- .importgraphics ⇒ Integer
-
.imshow(img, kv = {}) ⇒ Object
(Plot) Draw an image.
- .initgr ⇒ Object
- .inqbbox ⇒ Object
-
.inqbordercolorind ⇒ Object
Define the color of subsequent path output primitives.
-
.inqborderwidth ⇒ Object
Define the border width of subsequent path output primitives.
-
.inqcharheight ⇒ Numeric
Gets the current character height.
- .inqclipxform ⇒ Object
- .inqcolor(color) ⇒ Object
- .inqcolorfromrgb ⇒ Integer
-
.inqcolormap ⇒ Object
inqcolormap.
-
.inqcolormapinds ⇒ Array
Inquire the color index range of the current colormap.
-
.inqdspsize ⇒ Array
Get the current display size.
-
.inqfillcolorind ⇒ Integer
Returns the current fill area color index.
-
.inqfillintstyle ⇒ Integer
Returns the fill area interior style to be used for fill areas.
-
.inqfillstyle ⇒ Integer
Returns the current fill area color index.
-
.inqlinecolorind ⇒ Object
Define the color of subsequent polyline output primitives.
-
.inqlinetype ⇒ Object
Specify the line style for polylines.
-
.inqlinewidth ⇒ Object
Define the line width of subsequent polyline output primitives.
-
.inqmarkercolorind ⇒ Object
Define the color of subsequent polymarker output primitives.
-
.inqmarkersize ⇒ Numeric
Inquire the marker size for polymarkers.
-
.inqmarkertype ⇒ Object
Specifiy the marker type for polymarkers.
-
.inqmathtex(x, y, string) ⇒ Object
inqmathtex.
-
.inqorthographicprojection ⇒ Object
Return the camera position, up vector and focus point.
-
.inqperspectiveprojection ⇒ Object
Return the parameters for the perspective projection.
-
.inqprojectiontype ⇒ Object
Return the projection type.
- .inqregenflags ⇒ Integer
-
.inqresamplemethod ⇒ Integer
Inquire the resample method used for ‘drawimage`.
-
.inqscale ⇒ Object
inqscale.
-
.inqscalefactors3d ⇒ Object
Returns the scale factors for each axis.
-
.inqspace ⇒ Integer
Set the abstract Z-space used for mapping three-dimensional output primitives into the current world coordinate space.
-
.inqtext(x, y, string) ⇒ Object
Draw a text at position ‘x`, `y` using the current text attributes.
- .inqtext3d(x, y, z, string, axis) ⇒ Object
-
.inqtextcolorind ⇒ Integer
Gets the current text color index.
- .inqtextencoding ⇒ Object
-
.inqtextext(x, y, string) ⇒ Object
inqtextext.
-
.inqtransformationparameters ⇒ Object
Return the camera position, up vector and focus point.
-
.inqviewport ⇒ Object
inqviewport.
-
.inqwindow ⇒ Object
inqwindow.
-
.inqwindow3d ⇒ Object
Return the three dimensional window.
-
.interp2(x, y, z, xq, yq, method, extrapval) ⇒ Object
Interpolation in two dimensions using one of four different methods.
-
.isosurface(v, kv = {}) ⇒ Object
(Plot) Draw an isosurface.
-
.loadfont(str) ⇒ Object
Load a font file from a given filename.
-
.mathtex ⇒ Object
Generate a character string starting at the given location.
- .moveselection ⇒ Object
- .ndctowc(x, y) ⇒ Object
-
.nonuniformcellarray(x, y, dimx, dimy, color) ⇒ Object
Display a two dimensional color index array with nonuniform cell sizes.
-
.nonuniformpolarcellarray(phi, r, ncol, nrow, color) ⇒ Object
Display a two dimensional color index array mapped to a disk using polar coordinates with nonuniform cell sizes.
-
.nonuniformpolarheatmap(*args) ⇒ Object
(Plot) Draw a nonuniformpolarheatmap.
- .opengks ⇒ Object
-
.openws ⇒ Object
Open a graphical workstation.
-
.panzoom(x, y, zoom) ⇒ Object
panzoom.
-
.path(x, y, codes) ⇒ Object
Draw paths using the given vertices and path codes.
-
.plot(*args) ⇒ Object
(Plot) Draw one or more line plots.
-
.plot3(*args) ⇒ Object
(Plot) Draw one or more three-dimensional line plots.
-
.polar(*args) ⇒ Object
(Plot).
-
.polarcellarray(x_org, y_org, phimin, phimax, rmin, rmax, dimphi, dimr, color) ⇒ Object
Display a two dimensional color index array mapped to a disk using polar coordinates.
-
.polarheatmap(*args) ⇒ Object
(Plot) Draw a polarheatmap.
-
.polarhistogram(x, kv = {}) ⇒ Object
(Plot).
-
.polyline(x, y, linewidth = nil, line_z = nil) ⇒ Object
Draw a polyline using the current line attributes, starting from the first data point and ending at the last data point.
-
.polyline3d(x, y, z) ⇒ Object
Draw a 3D curve using the current line attributes, starting from the first data point and ending at the last data point.
-
.polymarker(x, y, markersize = nil, marker_z = nil) ⇒ Object
Draw marker symbols centered at the given data points.
-
.polymarker3d(x, y, z) ⇒ Object
Draw marker symbols centered at the given 3D data points.
- .precision ⇒ Numeric
-
.quiver(x, y, u, v, color) ⇒ Object
Draw a quiver plot on a grid of nx*ny points.
- .readimage(path) ⇒ Integer
- .redrawsegws ⇒ Object
-
.reducepoints(xd, yd, n) ⇒ Object
Reduces the number of points of the x and y array.
- .resizeselection ⇒ Object
- .restorestate ⇒ Object
-
.savefig(filename, kv = {}) ⇒ Object
(Plot) Save the current figure to a file.
- .savestate ⇒ Object
-
.scatter(*args) ⇒ Object
(Plot) Draw one or more scatter plots.
-
.scatter3(*args) ⇒ Object
(Plot) Draw one or more three-dimensional scatter plots.
- .selectclipxform ⇒ Object
- .selectcontext ⇒ Object
-
.selntran ⇒ Object
‘selntran` selects a predefined transformation from world coordinates to normalized device coordinates.
-
.setarrowsize ⇒ Object
Set the arrow size to be used for subsequent arrow commands.
-
.setarrowstyle ⇒ Object
Set the arrow style to be used for subsequent arrow commands.
-
.setbordercolorind ⇒ Object
Define the color of subsequent path output primitives.
-
.setborderwidth ⇒ Object
Define the border width of subsequent path output primitives.
-
.setcharexpan ⇒ Object
Set the current character expansion factor (width to height ratio).
-
.setcharheight ⇒ Object
Set the current character height.
- .setcharspace ⇒ Object
-
.setcharup ⇒ Object
Set the current character text angle up vector.
-
.setclip ⇒ Object
Set the clipping indicator.
-
.setcolormap ⇒ Object
Set the currently used colormap.
-
.setcolormapfromrgb(r, g, b, positions: nil) ⇒ Object
Define a colormap by a list of RGB colors.
-
.setcolorrep ⇒ Object
Redefine an existing color index representation by specifying an RGB color triplet.
-
.setcoordxform(mat) ⇒ Object
Change the coordinate transformation according to the given matrix.
-
.setfillcolorind ⇒ Object
Sets the current fill area color index.
-
.setfillintstyle ⇒ Object
Set the fill area interior style to be used for fill areas.
-
.setfillstyle ⇒ Object
Sets the fill style to be used for subsequent fill areas.
-
.setlinecolorind ⇒ Object
Define the color of subsequent polyline output primitives.
-
.setlinetype ⇒ Object
Specify the line style for polylines.
-
.setlinewidth ⇒ Object
Define the line width of subsequent polyline output primitives.
-
.setmarkercolorind ⇒ Object
Define the color of subsequent polymarker output primitives.
-
.setmarkersize ⇒ Object
Specify the marker size for polymarkers.
-
.setmarkertype ⇒ Object
Specifiy the marker type for polymarkers.
-
.setorthographicprojection ⇒ Object
Set parameters for orthographic transformation.
-
.setperspectiveprojection ⇒ Object
Set the far and near clipping plane for perspective projection and the vertical field ov view.
-
.setprojectiontype ⇒ Object
Set the projection type with this flag.
- .setregenflags ⇒ Object
-
.setresamplemethod ⇒ Object
Set the resample method used for ‘drawimage`.
-
.setscale ⇒ Integer
‘setscale` sets the type of transformation to be used for subsequent GR output primitives.
-
.setscalefactors3d ⇒ Object
Set the scale factor for each axis.
- .setsegtran ⇒ Object
-
.setshadow ⇒ Object
‘setshadow` allows drawing of shadows, realized by images painted underneath, and offset from, graphics objects such that the shadow mimics the effect of a light source cast on the graphics objects.
-
.setspace ⇒ Integer
Set the abstract Z-space used for mapping three-dimensional output primitives into the current world coordinate space.
-
.setspace3d ⇒ Object
Set the camera for orthographic or perspective projection.
-
.settextalign ⇒ Object
-
1 : TEXT_HALIGN_LEFT - Left justify * 2 : TEXT_HALIGN_CENTER - Center justify * 3 : TEXT_HALIGN_RIGHT - Right justify.
-
-
.settextcolorind ⇒ Object
Sets the current text color index.
- .settextencoding ⇒ Object
-
.settextfontprec ⇒ Object
Specify the text font and precision for subsequent text output primitives.
-
.settextpath ⇒ Object
Define the current direction in which subsequent text will be drawn.
-
.settransformationparameters ⇒ Object
Method to set the camera position, the upward facing direction and the focus point of the shown volume.
-
.settransparency ⇒ Object
Set the value of the alpha component associated with GR colors.
-
.setviewport ⇒ Object
‘setviewport` establishes a rectangular subspace of normalized device coordinates.
-
.setwindow ⇒ Object
‘setwindow` establishes a window, or rectangular subspace, of world coordinates to be plotted.
-
.setwindow3d ⇒ Object
Set the three dimensional window.
-
.setwsviewport ⇒ Object
Define the size of the workstation graphics window in meters.
-
.setwswindow ⇒ Object
Set the area of the NDC viewport that is to be drawn in the workstation window.
-
.shade(*args) ⇒ Object
(Plot).
-
.shadelines(x, y, dims: [1200, 1200], xform: 1) ⇒ Object
Display a line set as an aggregated and rasterized image.
-
.shadepoints(x, y, dims: [1200, 1200], xform: 1) ⇒ Object
Display a point set as a aggregated and rasterized image.
-
.spline(x, y, m, method) ⇒ Object
Generate a cubic spline-fit, starting from the first data point and ending at the last data point.
-
.stem(*args) ⇒ Object
(Plot) Draw a stem plot.
-
.step(*args) ⇒ Object
(Plot) Draw one or more step or staircase plots.
-
.subplot(nr, nc, p, kv = {}) ⇒ Object
Set current subplot index.
-
.surface(*args) ⇒ Object
Draw a three-dimensional surface plot for the given data points.
-
.text ⇒ Object
Draw a text at position ‘x`, `y` using the current text attributes.
- .text3d ⇒ Object
-
.textext ⇒ Integer
Draw a text at position ‘x`, `y` using the current text attributes.
- .tick ⇒ Numeric
-
.titles3d ⇒ Object
Display axis titles just outside of their respective axes.
- .to_rgb_color(z) ⇒ Array, NArray
-
.tricont(*args) ⇒ Object
(Plot) Draw a triangular contour plot.
-
.tricontour(x, y, z, levels) ⇒ Object
Draw a contour plot for the given triangle mesh.
-
.trisurf(*args) ⇒ Object
(Plot) Draw a triangular surface plot.
-
.trisurface(x, y, z) ⇒ Object
Draw a triangular surface plot for the given data points.
- .updategks ⇒ Object
-
.updatews ⇒ Object
Update the specified workstation.
- .uselinespec ⇒ Integer
- .validaterange ⇒ Integer
-
.verrorbars(x, y, e1, e2) ⇒ Object
Draw a standard vertical error bar graph.
-
.version ⇒ String
Returns the combined version strings of the GR runtime.
-
.volume(v, kv = {}) ⇒ Object
(Plot).
- .wc3towc(x, y, z) ⇒ Object
- .wctondc(x, y) ⇒ Object
-
.wireframe(*args) ⇒ Object
(Plot) Draw a three-dimensional wireframe plot.
Methods included from GRCommons::GRCommonUtils
create_ffi_pointer, double, equal_length, float, inquiry, inquiry_double, inquiry_int, inquiry_uint, int, narray?, read_ffi_pointer, uint, uint16, uint8
Methods included from GRCommons::JupyterSupport
Class Attribute Details
.ffi_lib ⇒ Object
Returns the value of attribute ffi_lib.
54 55 56 |
# File 'lib/gr.rb', line 54 def ffi_lib @ffi_lib end |
Class Method Details
._contour_ ⇒ Object
‘contour` is overwritten by `require gr/plot`. The original method is moved to the underscored name. The yard document will show the method name after evacuation.
Draw contours of a three-dimensional data set whose values are specified over a rectangular mesh. Contour lines may optionally be labeled.
1334 1335 1336 1337 1338 1339 1340 |
# File 'lib/gr/plot.rb', line 1334 def contour(x, y, h, z, major_h) # TODO: check: Arrays have incorrect length or dimension. nx = x.length ny = y.length nh = h.length super(nx, ny, nh, x, y, h, z, major_h) end |
._contourf_ ⇒ Object
‘contourf` is overwritten by `require gr/plot`. The original method is moved to the underscored name. The yard document will show the method name after evacuation.
Draw filled contours of a three-dimensional data set whose values are specified over a rectangular mesh.
1340 1341 1342 1343 1344 1345 1346 |
# File 'lib/gr/plot.rb', line 1340 def contourf(x, y, h, z, major_h) # TODO: check: Arrays have incorrect length or dimension. nx = x.length ny = y.length nh = h.length super(nx, ny, nh, x, y, h, z, major_h) end |
._hexbin_ ⇒ Integer
‘hexbin` is overwritten by `require gr/plot`. The original method is moved to the underscored name. The yard document will show the method name after evacuation.
1346 1347 1348 1349 |
# File 'lib/gr/plot.rb', line 1346 def hexbin(x, y, nbins) n = x.length super(n, x, y, nbins) end |
._shade_ ⇒ Object
‘hexbin` is overwritten by `require gr/plot`. The original method is moved to the underscored name. The yard document will show the method name after evacuation.
|
# File 'lib/gr/plot.rb', line 1388
|
._surface_ ⇒ Object
‘surface` is overwritten by `require gr/plot`. The original method is moved to the underscored name. The yard document will show the method name after evacuation.
Draw a three-dimensional surface plot for the given data points.
‘x` and `y` define a grid. `z` is a singly dimensioned array containing at least `nx` * `ny` data points. Z describes the surface height at each point on the grid. Data is ordered as shown in the table: (Plot) Draw a three-dimensional surface plot.
1363 1364 1365 1366 1367 1368 |
# File 'lib/gr/plot.rb', line 1363 def surface(x, y, z, option) # TODO: check: Arrays have incorrect length or dimension. nx = x.length ny = y.length super(nx, ny, x, y, z, option) end |
.activatews ⇒ Object
Activate the specified workstation.
|
# File 'lib/gr.rb', line 154
|
.adjustlimits(amin, amax) ⇒ Integer
1475 1476 1477 1478 1479 1480 1481 |
# File 'lib/gr.rb', line 1475 def adjustlimits(amin, amax) inquiry %i[double double] do |pamin, pamax| pamin.write_double amin pamax.write_double amax super(pamin, pamax) end end |
.adjustrange(amin, amax) ⇒ Object
1483 1484 1485 1486 1487 1488 1489 |
# File 'lib/gr.rb', line 1483 def adjustrange(amin, amax) inquiry %i[double double] do |pamin, pamax| pamin.write_double amin pamax.write_double amax super(pamin, pamax) end end |
.axes ⇒ Object Also known as: axes2d
Draw X and Y coordinate axes with linearly and/or logarithmically spaced tick marks.
Tick marks are positioned along each axis so that major tick marks fall on the axes origin (whether visible or not). Major tick marks are labeled with the corresponding data values. Axes are drawn according to the scale of the window. Axes and tick marks are drawn using solid lines; line color and width can be modified using the gr_setlinetype and gr_setlinewidth functions. Axes are drawn according to the linear or logarithmic transformation established by the gr_setscale function.
1084 |
# File 'lib/gr.rb', line 1084 alias axes2d axes |
.axes3d ⇒ Object
Draw X, Y and Z coordinate axes with linearly and/or logarithmically spaced tick marks.
Tick marks are positioned along each axis so that major tick marks fall on the axes origin (whether visible or not). Major tick marks are labeled with the corresponding data values. Axes are drawn according to the scale of the window. Axes and tick marks are drawn using solid lines; line color and width can be modified using the ‘setlinetype` and `setlinewidth` functions. Axes are drawn according to the linear or logarithmic transformation established by the `setscale` function.
|
# File 'lib/gr.rb', line 1245
|
.axeslbl ⇒ Object
This method uses GRCommons::Fiddley::Function as a callback function. Please read the source code If you have to use it. There are some examples of the use of this function in the Plot class..
Create axes in the current workspace and supply a custom function for changing the behaviour of the tick labels.
Similar to gr_axes() but allows more fine-grained control over tick labels and text positioning by supplying callback functions. Within the callback function you can use normal GR text primitives for performing any manipulations on the label text. See gr_axes() for more details on drawing axes.
-
fpx/fpy
-
param x [Numeric] NDC of the label in X direction.
-
param y [Numeric] NDC of the label in Y direction.
-
param svalue [String] Internal string representation of the text drawn by GR at (x,y).
-
param value [Numeric] Floating point representation of the label drawn at (x,y).
-
|
# File 'lib/gr.rb', line 1086
|
.barplot(labels, heights, kv = {}) ⇒ Object
(Plot) Draw a bar plot.
1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 |
# File 'lib/gr/plot.rb', line 1402 def (labels, heights, kv = {}) labels = labels.map(&:to_s) wc, hc = (heights) create_plot(:bar, labels, heights, kv) do |plt| if kv[:horizontal] plt.args = [[hc, wc, nil, nil, '']] plt.kvs[:yticks] = [1, 1] plt.kvs[:yticklabels] = labels else plt.args = [[wc, hc, nil, nil, '']] plt.kvs[:xticks] = [1, 1] plt.kvs[:xticklabels] = labels end end end |
.begingraphics ⇒ Object
Open a file for graphics output.
‘begingraphics` allows to write all graphics output into a XML-formatted file until the `endgraphics` functions is called. The resulting file may later be imported with the `importgraphics` function.
|
# File 'lib/gr.rb', line 1772
|
.beginprint(file_path) ⇒ Object
Ruby feature - you can use block to call endprint automatically.
Open and activate a print device.
‘beginprint` opens an additional graphics output device. The device type is obtained from the given file extension
1512 1513 1514 1515 1516 1517 1518 |
# File 'lib/gr.rb', line 1512 def beginprint(file_path) super(file_path) if block_given? yield endprint end end |
.beginprintext ⇒ Object
Open and activate a print device with the given layout attributes.
|
# File 'lib/gr.rb', line 1520
|
.beginselection ⇒ Object
|
# File 'lib/gr.rb', line 1807
|
.camerainteraction ⇒ Object
Rotate the current scene according to a virtual arcball.
This function requires values between 0 (left side or bottom of the drawing area) and 1 (right side or top of the drawing area).
|
# File 'lib/gr.rb', line 2223
|
.cellarray(xmin, xmax, ymin, ymax, dimx, dimy, color) ⇒ Object
Display rasterlike images in a device-independent manner. The cell array function partitions a rectangle given by two corner points into DIMX X DIMY cells, each of them colored individually by the corresponding color index of the given cell array.
The values for ‘xmin`, `xmax`, `ymin` and `ymax` are in world coordinates.
304 305 306 |
# File 'lib/gr.rb', line 304 def cellarray(xmin, xmax, ymin, ymax, dimx, dimy, color) super(xmin, xmax, ymin, ymax, dimx, dimy, 1, 1, dimx, dimy, int(color)) end |
.clearws ⇒ Object
Clear the specified workstation.
|
# File 'lib/gr.rb', line 170
|
.closegks ⇒ Object
|
# File 'lib/gr.rb', line 102
|
.closeseg ⇒ Object
|
# File 'lib/gr.rb', line 924
|
.closews ⇒ Object
Close the specified workstation.
|
# File 'lib/gr.rb', line 148
|
.colorbar ⇒ Object
1454 1455 1456 1457 1458 |
# File 'lib/gr.rb', line 1454 def inqcolor(color) inquiry_int do |rgb| super(color, rgb) end end |
.configurews ⇒ Object
Configure the specified workstation.
|
# File 'lib/gr.rb', line 166
|
.contour(*args) ⇒ Object
(Plot) Draw a contour plot.
1345 1346 1347 1348 1349 1350 1351 |
# File 'lib/gr.rb', line 1345 def contour(x, y, h, z, major_h) # TODO: check: Arrays have incorrect length or dimension. nx = x.length ny = y.length nh = h.length super(nx, ny, nh, x, y, h, z, major_h) end |
.contourf(*args) ⇒ Object
(Plot) Draw a filled contour plot.
1370 1371 1372 1373 1374 1375 1376 |
# File 'lib/gr.rb', line 1370 def contourf(x, y, h, z, major_h) # TODO: check: Arrays have incorrect length or dimension. nx = x.length ny = y.length nh = h.length super(nx, ny, nh, x, y, h, z, major_h) end |
.copysegws ⇒ Object
|
# File 'lib/gr.rb', line 918
|
.createseg ⇒ Object
|
# File 'lib/gr.rb', line 916
|
.deactivatews ⇒ Object
Deactivate the specified workstation.
|
# File 'lib/gr.rb', line 160
|
.delaunay(x, y) ⇒ Integer
1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 1856 1857 1858 |
# File 'lib/gr.rb', line 1840 def delaunay(x, y) # Feel free to make a pull request if you catch a mistake # or you have an idea to improve it. npoints = equal_length(x, y) triangles = Fiddle::Pointer.malloc(Fiddle::SIZEOF_INTPTR_T) dim = 3 n_tri = inquiry_int do |ntri| super(npoints, x, y, ntri, triangles.ref) end if n_tri > 0 tri = triangles.to_str(dim * n_tri * Fiddle::SIZEOF_INT).unpack('l*') # Int32 # Ruby : 0-based indexing # Julia : 1-based indexing tri = tri.each_slice(dim).to_a [n_tri, tri] else 0 end end |
.destroycontext ⇒ Object
|
# File 'lib/gr.rb', line 1835
|
.drawarc ⇒ Object
Draw a circular or elliptical arc covering the specified rectangle.
The resulting arc begins at ‘a1` and ends at `a2` degrees. Angles are interpreted such that 0 degrees is at the 3 o’clock position. The center of the arc is the center of the given rectangle.
|
# File 'lib/gr.rb', line 1605
|
.drawarrow ⇒ Object
Draw an arrow between two points.
Different arrow styles (angles between arrow tail and wing, optionally filled heads, double headed arrows) are available and can be set with the ‘setarrowstyle` function.
|
# File 'lib/gr.rb', line 1689
|
.drawgraphics ⇒ Integer
|
# File 'lib/gr.rb', line 1788
|
.drawimage(xmin, xmax, ymin, ymax, width, height, data, model = 0) ⇒ Object
Draw an image into a given rectangular area.
The points (‘xmin`, `ymin`) and (`xmax`, `ymax`) are world coordinates defining diagonally opposite corner points of a rectangle. This rectangle is divided into `width` by `height` cells. The two-dimensional array `data` specifies colors for each cell.
1734 1735 1736 |
# File 'lib/gr.rb', line 1734 def drawimage(xmin, xmax, ymin, ymax, width, height, data, model = 0) super(xmin, xmax, ymin, ymax, width, height, uint(data), model) end |
.drawpath(points, codes, fill) ⇒ Object
Draw simple and compound outlines consisting of line segments and bezier curves.
1649 1650 1651 1652 |
# File 'lib/gr.rb', line 1649 def drawpath(points, codes, fill) len = codes.length super(len, points, uint8(codes), fill) end |
.drawrect ⇒ Object
Draw a rectangle using the current line attributes.
|
# File 'lib/gr.rb', line 1587
|
.emergencyclosegks ⇒ Object
|
# File 'lib/gr.rb', line 926
|
.endgraphics ⇒ Object
|
# File 'lib/gr.rb', line 1781
|
.endprint ⇒ Object
1562 1563 1564 1565 1566 1567 1568 |
# File 'lib/gr.rb', line 1562 def ndctowc(x, y) inquiry %i[double double] do |px, py| px.write_double x py.write_double y super(px, py) end end |
.endselection ⇒ Object
|
# File 'lib/gr.rb', line 1809
|
.fillarc ⇒ Object
Fill a circular or elliptical arc covering the specified rectangle.
The resulting arc begins at ‘a1` and ends at `a2` degrees. Angles are interpreted such that 0 degrees is at the 3 o’clock position. The center of the arc is the center of the given rectangle.
|
# File 'lib/gr.rb', line 1620
|
.fillarea(x, y) ⇒ Object
Allows you to specify a polygonal shape of an area to be filled.
The attributes that control the appearance of fill areas are fill area interior style, fill area style index and fill area color index.
284 285 286 287 |
# File 'lib/gr.rb', line 284 def fillarea(x, y) n = equal_length(x, y) super(n, x, y) end |
.fillrect ⇒ Object
Draw a filled rectangle using the current fill attributes.
|
# File 'lib/gr.rb', line 1596
|
.findboundary ⇒ Object
This method uses GRCommons::Fiddley::Function as a callback function. Please read the source code If you have to use it. This method is not sure if it works properly.
|
# File 'lib/gr.rb', line 2004
|
.gdp(x, y, primid, datrec) ⇒ Object
Generates a generalized drawing primitive (GDP) of the type you specify, using specified points and any additional information contained in a data record.
404 405 406 407 408 |
# File 'lib/gr.rb', line 404 def gdp(x, y, primid, datrec) n = equal_length(x, y) ldr = datrec.length super(n, x, y, primid, ldr, int(datrec)) end |
.getgraphics ⇒ String
1784 1785 1786 |
# File 'lib/gr.rb', line 1784 def getgraphics(*) super.to_s end |
.gradient(x, y, z) ⇒ Object
1886 1887 1888 1889 1890 1891 1892 1893 |
# File 'lib/gr.rb', line 1886 def gradient(x, y, z) # TODO: check: Arrays have incorrect length or dimension. nx = x.length ny = y.length inquiry [{ double: nx * ny }, { double: nx * ny }] do |pu, pv| super(nx, ny, x, y, z, pu, pv) end end |
.grid ⇒ Object
Draw a linear and/or logarithmic grid.
Major grid lines correspond to the axes origin and major tick marks whether visible or not. Minor grid lines are drawn at points equal to minor tick marks. Major grid lines are drawn using black lines and minor grid lines are drawn using gray lines.
|
# File 'lib/gr.rb', line 1135
|
.grid3d ⇒ Object
Draw a linear and/or logarithmic grid.
Major grid lines correspond to the axes origin and major tick marks whether visible or not. Minor grid lines are drawn at points equal to minor tick marks. Major grid lines are drawn using black lines and minor grid lines are drawn using gray lines.
|
# File 'lib/gr.rb', line 1159
|
.gridit(xd, yd, zd, nx, ny) ⇒ Object
Interpolate data from arbitrary points at points on a rectangular grid.
441 442 443 444 445 446 |
# File 'lib/gr.rb', line 441 def gridit(xd, yd, zd, nx, ny) nd = equal_length(xd, yd, zd) inquiry [{ double: nx }, { double: ny }, { double: nx * ny }] do |px, py, pz| super(nd, xd, yd, zd, nx, ny, px, py, pz) end end |
.heatmap(*args) ⇒ Object
(Plot) Draw a heatmap.
1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 |
# File 'lib/gr/plot.rb', line 1292 def heatmap(*args) # FIXME args, kv = format_xyzc(*args) _x, _y, z = args ysize, xsize = z.shape z = z.reshape(xsize, ysize) create_plot(:heatmap, kv) do |plt| plt.kvs[:xlim] ||= [0.5, xsize + 0.5] plt.kvs[:ylim] ||= [0.5, ysize + 0.5] plt.args = [[(1..xsize).to_a, (1..ysize).to_a, z, nil, '']] end end |
.herrorbars(x, y, e1, e2) ⇒ Object
Draw a standard horizontal error bar graph.
1209 1210 1211 1212 |
# File 'lib/gr.rb', line 1209 def (x, y, e1, e2) n = equal_length(x, y, e1, e2) super(n, x, y, e1, e2) end |
.hexbin(*args) ⇒ Object
(Plot) Draw a hexagon binning plot.
1396 1397 1398 1399 |
# File 'lib/gr.rb', line 1396 def hexbin(x, y, nbins) n = x.length super(n, x, y, nbins) end |
.histogram(series, kv = {}) ⇒ Object
(Plot) Draw a histogram.
1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429 |
# File 'lib/gr/plot.rb', line 1419 def histogram(series, kv = {}) create_plot(:hist, series, kv) do |plt| nbins = plt.kvs[:nbins] || 0 x, y = hist(series, nbins) plt.args = if kv[:horizontal] [[y, x, nil, nil, '']] else [[x, y, nil, nil, '']] end end end |
.hold(flag = true) ⇒ Object
1447 1448 1449 1450 |
# File 'lib/gr/plot.rb', line 1447 def hold(flag = true) plt = GR::Plot.last_plot plt.kvs.slice(:window, :scale, :xaxis, :yaxis, :zaxis).merge({ ax: flag, clear: !flag }) end |
.hsvtorgb(h, s, v) ⇒ Integer
1463 1464 1465 1466 1467 |
# File 'lib/gr.rb', line 1463 def hsvtorgb(h, s, v) inquiry %i[double double double] do |r, g, b| super(h, s, v, r, g, b) end end |
.importgraphics ⇒ Integer
|
# File 'lib/gr.rb', line 1738
|
.imshow(img, kv = {}) ⇒ Object
(Plot) Draw an image.
1432 1433 1434 1435 1436 1437 |
# File 'lib/gr/plot.rb', line 1432 def imshow(img, kv = {}) img = Numo::DFloat.cast(img) # Umm... create_plot(:imshow, img, kv) do |plt| plt.args = [[nil, nil, img, nil, '']] end end |
.initgr ⇒ Object
|
# File 'lib/gr.rb', line 98
|
.inqbbox ⇒ Object
1815 1816 1817 1818 1819 |
# File 'lib/gr.rb', line 1815 def inqbbox inquiry %i[double double double double] do |*pts| super(*pts) end end |
.inqbordercolorind ⇒ Object
Define the color of subsequent path output primitives.
2137 2138 2139 |
# File 'lib/gr.rb', line 2137 def inqbordercolorind inquiry_int { |pt| super(pt) } end |
.inqborderwidth ⇒ Object
Define the border width of subsequent path output primitives.
2127 2128 2129 |
# File 'lib/gr.rb', line 2127 def inqborderwidth inquiry_double { |pt| super(pt) } end |
.inqcharheight ⇒ Numeric
Gets the current character height.
This function gets the height of text output primitives. Text height is defined as a percentage of the default window. GR uses the default text height of 0.027 (2.7% of the height of the default window).
673 674 675 |
# File 'lib/gr.rb', line 673 def inqcharheight inquiry_double { |pt| super(pt) } end |
.inqclipxform ⇒ Object
2143 2144 2145 |
# File 'lib/gr.rb', line 2143 def inqclipxform inquiry_int { |pt| super(pt) } end |
.inqcolor(color) ⇒ Object
1454 1455 1456 1457 1458 |
# File 'lib/gr.rb', line 1454 def inqcolor(color) inquiry_int do |rgb| super(color, rgb) end end |
.inqcolorfromrgb ⇒ Integer
1463 1464 1465 1466 1467 |
# File 'lib/gr.rb', line 1463 def hsvtorgb(h, s, v) inquiry %i[double double double] do |r, g, b| super(h, s, v, r, g, b) end end |
.inqcolormap ⇒ Object
inqcolormap
1411 1412 1413 |
# File 'lib/gr.rb', line 1411 def inqcolormap inquiry_int { |pt| super(pt) } end |
.inqcolormapinds ⇒ Array
Inquire the color index range of the current colormap.
1446 1447 1448 1449 1450 |
# File 'lib/gr.rb', line 1446 def inqcolormapinds inquiry %i[int int] do |first_color_ind, last_color_ind| super(first_color_ind, last_color_ind) end end |
.inqdspsize ⇒ Array
Get the current display size.
Depending on the current workstation type, the current display might be the primary screen (e.g. when using gksqt or GKSTerm) or a purely virtual display (e.g. when using Cairo). When a high DPI screen is used as the current display, width and height will be in logical pixels.
112 113 114 115 116 |
# File 'lib/gr.rb', line 112 def inqdspsize inquiry %i[double double int int] do |*pts| super(*pts) end end |
.inqfillcolorind ⇒ Integer
Returns the current fill area color index.
This function gets the color of fill area output primitives.
781 782 783 |
# File 'lib/gr.rb', line 781 def inqfillcolorind inquiry_int { |pt| super(pt) } end |
.inqfillintstyle ⇒ Integer
Returns the fill area interior style to be used for fill areas.
This function gets the currently set fill style.
740 741 742 |
# File 'lib/gr.rb', line 740 def inqfillintstyle inquiry_int { |pt| super(pt) } end |
.inqfillstyle ⇒ Integer
Returns the current fill area color index.
This function gets the color index for PATTERN and HATCH fills.
762 763 764 |
# File 'lib/gr.rb', line 762 def inqfillstyle inquiry_int { |pt| super(pt) } end |
.inqlinecolorind ⇒ Object
Define the color of subsequent polyline output primitives.
491 492 493 |
# File 'lib/gr.rb', line 491 def inqlinecolorind inquiry_int { |pt| super(pt) } end |
.inqlinetype ⇒ Object
Specify the line style for polylines.
466 467 468 |
# File 'lib/gr.rb', line 466 def inqlinetype inquiry_int { |pt| super(pt) } end |
.inqlinewidth ⇒ Object
Define the line width of subsequent polyline output primitives.
The line width is calculated as the nominal line width generated on the workstation multiplied by the line width scale factor. This value is mapped by the workstation to the nearest available line width. The default line width is 1.0, or 1 times the line width generated on the graphics device.
481 482 483 |
# File 'lib/gr.rb', line 481 def inqlinewidth inquiry_double { |pt| super(pt) } end |
.inqmarkercolorind ⇒ Object
Define the color of subsequent polymarker output primitives.
567 568 569 |
# File 'lib/gr.rb', line 567 def inqmarkercolorind inquiry_int { |pt| super(pt) } end |
.inqmarkersize ⇒ Numeric
Inquire the marker size for polymarkers.
557 558 559 |
# File 'lib/gr.rb', line 557 def inqmarkersize inquiry_double { |pt| super(pt) } end |
.inqmarkertype ⇒ Object
Specifiy the marker type for polymarkers.
Polymarkers appear centered over their specified coordinates.
540 541 542 |
# File 'lib/gr.rb', line 540 def inqmarkertype inquiry_int { |pt| super(pt) } end |
.inqmathtex(x, y, string) ⇒ Object
inqmathtex
1801 1802 1803 1804 1805 |
# File 'lib/gr.rb', line 1801 def inqmathtex(x, y, string) inquiry [{ double: 4 }, { double: 4 }] do |tbx, tby| super(x, y, string, tbx, tby) end end |
.inqorthographicprojection ⇒ Object
Return the camera position, up vector and focus point.
2217 2218 2219 2220 2221 |
# File 'lib/gr.rb', line 2217 def inqorthographicprojection inquiry([:double] * 6) do |*pts| super(*pts) end end |
.inqperspectiveprojection ⇒ Object
Return the parameters for the perspective projection.
2174 2175 2176 2177 2178 |
# File 'lib/gr.rb', line 2174 def inqperspectiveprojection inquiry %i[double double double] do |*pts| super(*pts) end end |
.inqprojectiontype ⇒ Object
Return the projection type.
2158 2159 2160 |
# File 'lib/gr.rb', line 2158 def inqprojectiontype inquiry_int { |pt| super(pt) } end |
.inqregenflags ⇒ Integer
|
# File 'lib/gr.rb', line 1826
|
.inqresamplemethod ⇒ Integer
Inquire the resample method used for ‘drawimage`
2069 2070 2071 2072 2073 |
# File 'lib/gr.rb', line 2069 def inqresamplemethod inquiry_uint do |resample_method| super(resample_method) end end |
.inqscale ⇒ Object
inqscale
981 982 983 |
# File 'lib/gr.rb', line 981 def inqscale inquiry_int { |pt| super(pt) } end |
.inqscalefactors3d ⇒ Object
Returns the scale factors for each axis.
2265 2266 2267 2268 2269 |
# File 'lib/gr.rb', line 2265 def inqscalefactors3d inquiry %i[double double double] do |*opts| super(*opts) end end |
.inqspace ⇒ Integer
Set the abstract Z-space used for mapping three-dimensional output primitives into the current world coordinate space.
‘setspace` establishes the limits of an abstract Z-axis and defines the angles for rotation and for the viewing angle (tilt) of a simulated three-dimensional graph, used for mapping corresponding output primitives into the current window. These settings are used for all subsequent three-dimensional output primitives until other values are specified. Angles of rotation and viewing angle must be specified between 0° and 90°.
949 950 951 952 953 |
# File 'lib/gr.rb', line 949 def inqspace inquiry %i[double double int int] do |*pts| super(*pts) end end |
.inqtext(x, y, string) ⇒ Object
Draw a text at position ‘x`, `y` using the current text attributes.
The values for ‘x` and `y` are in normalized device coordinates. The attributes that control the appearance of text are text font and precision, character expansion factor, character spacing, text color index, character height, character up vector, text path and text alignment.
270 271 272 273 274 |
# File 'lib/gr.rb', line 270 def inqtext(x, y, string) inquiry [{ double: 4 }, { double: 4 }] do |tbx, tby| super(x, y, string, tbx, tby) end end |
.inqtext3d(x, y, z, string, axis) ⇒ Object
2290 2291 2292 2293 2294 |
# File 'lib/gr.rb', line 2290 def inqtext3d(x, y, z, string, axis) inquiry [{ double: 16 }, { double: 16 }] do |tbx, tby| super(x, y, z, string, axis, tbx, tby) end end |
.inqtextcolorind ⇒ Integer
Gets the current text color index.
This function gets the color of text output primitives.
652 653 654 |
# File 'lib/gr.rb', line 652 def inqtextcolorind inquiry_int { |pt| super(pt) } end |
.inqtextencoding ⇒ Object
2298 2299 2300 2301 2302 |
# File 'lib/gr.rb', line 2298 def inqtextencoding inquiry_int do |encoding| super(encoding) end end |
.inqtextext(x, y, string) ⇒ Object
inqtextext
1043 1044 1045 1046 1047 |
# File 'lib/gr.rb', line 1043 def inqtextext(x, y, string) inquiry [{ double: 4 }, { double: 4 }] do |tbx, tby| super(x, y, string, tbx, tby) end end |
.inqtransformationparameters ⇒ Object
Return the camera position, up vector and focus point.
2197 2198 2199 2200 2201 |
# File 'lib/gr.rb', line 2197 def inqtransformationparameters inquiry([:double] * 9) do |*pts| super(*pts) end end |
.inqviewport ⇒ Object
inqviewport
845 846 847 848 849 |
# File 'lib/gr.rb', line 845 def inquiry %i[double double double double] do |*pts| super(*pts) end end |
.inqwindow ⇒ Object
inqwindow
818 819 820 821 822 |
# File 'lib/gr.rb', line 818 def inqwindow inquiry %i[double double double double] do |*pts| super(*pts) end end |
.inqwindow3d ⇒ Object
Return the three dimensional window.
2248 2249 2250 2251 2252 |
# File 'lib/gr.rb', line 2248 def inqwindow3d inquiry([:double] * 6) do |*pts| super(*pts) end end |
.interp2(x, y, z, xq, yq, method, extrapval) ⇒ Object
Interpolation in two dimensions using one of four different methods. The input points are located on a grid, described by ‘x`, `y` and `z`. The target grid ist described by `xq` and `yq`. Returns an array containing the resulting z-values.
flatten
1935 1936 1937 1938 1939 1940 1941 1942 1943 1944 |
# File 'lib/gr.rb', line 1935 def interp2(x, y, z, xq, yq, method, extrapval) nx = x.length ny = y.length # nz = z.length nxq = xq.length nyq = yq.length inquiry(double: nxq * nyq) do |zq| super(nx, ny, x, y, z, nxq, nyq, xq, yq, zq, method, extrapval) end end |
.isosurface(v, kv = {}) ⇒ Object
(Plot) Draw an isosurface.
1440 1441 1442 1443 1444 1445 |
# File 'lib/gr/plot.rb', line 1440 def isosurface(v, kv = {}) v = Numo::DFloat.cast(v) # Umm... create_plot(:isosurface, v, kv) do |plt| plt.args = [[nil, nil, v, nil, '']] end end |
.loadfont(str) ⇒ Object
Load a font file from a given filename.
This function loads a font from a given absolute filename and assigns a font index to it. To use the loaded font call ‘gr_settextfontprec` using the resulting font index and precision 3.
2312 2313 2314 2315 2316 |
# File 'lib/gr.rb', line 2312 def loadfont(str) inquiry_int do |font| super(str, font) end end |
.mathtex ⇒ Object
Generate a character string starting at the given location. Strings can be defined to create mathematical symbols and Greek letters using LaTeX syntax.
|
# File 'lib/gr.rb', line 1791
|
.moveselection ⇒ Object
|
# File 'lib/gr.rb', line 1811
|
.ndctowc(x, y) ⇒ Object
1562 1563 1564 1565 1566 1567 1568 |
# File 'lib/gr.rb', line 1562 def ndctowc(x, y) inquiry %i[double double] do |px, py| px.write_double x py.write_double y super(px, py) end end |
.nonuniformcellarray(x, y, dimx, dimy, color) ⇒ Object
Display a two dimensional color index array with nonuniform cell sizes.
The values for ‘x` and `y` are in world coordinates. `x` must contain `dimx` + 1 elements and `y` must contain `dimy` + 1 elements. The elements i and i+1 are respectively the edges of the i-th cell in X and Y direction.
320 321 322 323 324 325 326 |
# File 'lib/gr.rb', line 320 def nonuniformcellarray(x, y, dimx, dimy, color) raise ArgumentError unless x.length == dimx + 1 && y.length == dimy + 1 nx = dimx == x.length ? -dimx : dimx ny = dimy == y.length ? -dimy : dimy super(x, y, nx, ny, 1, 1, dimx, dimy, int(color)) end |
.nonuniformpolarcellarray(phi, r, ncol, nrow, color) ⇒ Object
Display a two dimensional color index array mapped to a disk using polar coordinates with nonuniform cell sizes.
The mapping of the polar coordinates and the drawing is performed simialr to ‘gr_polarcellarray` with the difference that the individual cell sizes are specified allowing nonuniform sized cells.
387 388 389 390 391 392 393 |
# File 'lib/gr.rb', line 387 def nonuniformpolarcellarray(phi, r, ncol, nrow, color) raise ArgumentError unless (ncol..(ncol + 1)).include?(phi.length) && (nrow..(nrow + 1)).include?(r.length) dimphi = ncol == phi.length ? -ncol : ncol dimr = nrow == r.length ? -nrow : nrow super(0, 0, phi, r, dimphi, dimr, 1, 1, ncol, nrow, int(color)) end |
.nonuniformpolarheatmap(*args) ⇒ Object
(Plot) Draw a nonuniformpolarheatmap.
1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 |
# File 'lib/gr/plot.rb', line 1321 def nonuniformpolarheatmap(*args) # FIXME args, kv = format_xyzc(*args) _x, _y, z = args ysize, xsize = z.shape z = z.reshape(xsize, ysize) create_plot(:nonuniformpolarheatmap, kv) do |plt| plt.kvs[:xlim] ||= [0.5, xsize + 0.5] plt.kvs[:ylim] ||= [0.5, ysize + 0.5] plt.args = [[(1..xsize).to_a, (1..ysize).to_a, z, nil, '']] end end |
.opengks ⇒ Object
|
# File 'lib/gr.rb', line 100
|
.openws ⇒ Object
Open a graphical workstation.
|
# File 'lib/gr.rb', line 118
|
.panzoom(x, y, zoom) ⇒ Object
panzoom
2011 2012 2013 2014 2015 |
# File 'lib/gr.rb', line 2011 def panzoom(x, y, zoom) inquiry %i[double double double double] do |xmin, xmax, ymin, ymax| super(x, y, zoom, zoom, xmin, xmax, ymin, ymax) end end |
.path(x, y, codes) ⇒ Object
Draw paths using the given vertices and path codes.
See gr-framework.org/python-gr.html#gr.path for more details.
2104 2105 2106 2107 |
# File 'lib/gr.rb', line 2104 def path(x, y, codes) n = equal_length(x, y) super(n, x, y, codes) end |
.plot(*args) ⇒ Object
(Plot) Draw one or more line plots.
1262 1263 1264 |
# File 'lib/gr/plot.rb', line 1262 def plot(*args) create_plot(:line, *args) end |
.plot3(*args) ⇒ Object
(Plot) Draw one or more three-dimensional line plots.
1379 1380 1381 |
# File 'lib/gr/plot.rb', line 1379 def plot3(*args) create_plot(:plot3, *args) end |
.polar(*args) ⇒ Object
(Plot)
1369 1370 1371 |
# File 'lib/gr/plot.rb', line 1369 def polar(*args) create_plot(:polar, *args) end |
.polarcellarray(x_org, y_org, phimin, phimax, rmin, rmax, dimphi, dimr, color) ⇒ Object
Display a two dimensional color index array mapped to a disk using polar coordinates.
The two dimensional color index array is mapped to the resulting image by interpreting the X-axis of the array as the angle and the Y-axis as the raidus. The center point of the resulting disk is located at ‘xorg`, `yorg` and the radius of the disk is `rmax`.
The additional parameters to the function can be used to further control the mapping from polar to cartesian coordinates.
If ‘rmin` is greater than 0 the input data is mapped to a punctured disk (or annulus) with an inner radius of `rmin` and an outer radius `rmax`. If `rmin` is greater than `rmax` the Y-axis of the array is reversed.
The parameter ‘phimin` and `phimax` can be used to map the data to a sector of the (punctured) disk starting at `phimin` and ending at `phimax`. If `phimin` is greater than `phimax` the X-axis is reversed. The visible sector is the one starting in mathematically positive direction (counterclockwise) at the smaller angle and ending at the larger angle. An example of the four possible options can be found below:
-
phimin phimax Result
-
90 270 Left half visible, mapped counterclockwise
-
270 90 Left half visible, mapped clockwise
-
-90 90 Right half visible, mapped counterclockwise
-
90 -90 Right half visible, mapped clockwise
370 371 372 |
# File 'lib/gr.rb', line 370 def polarcellarray(x_org, y_org, phimin, phimax, rmin, rmax, dimphi, dimr, color) super(x_org, y_org, phimin, phimax, rmin, rmax, dimphi, dimr, 1, 1, dimphi, dimr, int(color)) end |
.polarheatmap(*args) ⇒ Object
(Plot) Draw a polarheatmap.
1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 |
# File 'lib/gr/plot.rb', line 1306 def polarheatmap(*args) d = args.shift # FIXME z = Numo::DFloat.cast(d) raise 'expected 2-D array' unless z.ndim == 2 create_plot(:polarheatmap, z, *args) do |plt| width, height = z.shape plt.kvs[:xlim] ||= [0.5, width + 0.5] plt.kvs[:ylim] ||= [0.5, height + 0.5] plt.args = [[(1..width).to_a, (1..height).to_a, z, nil, '']] end end |
.polarhistogram(x, kv = {}) ⇒ Object
(Plot)
1282 1283 1284 1285 1286 1287 1288 1289 |
# File 'lib/gr/plot.rb', line 1282 def polarhistogram(x, kv = {}) plt = GR::Plot.new(x, kv) plt.kvs[:kind] = :polarhist nbins = plt.kvs[:nbins] || 0 x, y = hist(x, nbins) plt.args = [[x, y, nil, nil, '']] plt.plot_data end |
.polyline(x, y, linewidth = nil, line_z = nil) ⇒ Object
Draw a polyline using the current line attributes, starting from the first data point and ending at the last data point.
The values for x and y are in world coordinates. The attributes that control the appearance of a polyline are linetype, linewidth and color index.
190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 |
# File 'lib/gr.rb', line 190 def polyline(x, y, linewidth = nil, line_z = nil) # GR.jl - Multiple dispatch n = equal_length(x, y) if linewidth.nil? && line_z.nil? super(n, x, y) else linewidth ||= GR.inqlinewidth linewidth = if linewidth.is_a?(Numeric) Array.new(n, linewidth * 100) else raise ArgumentError if n != linewidth.length linewidth.map { |i| (100 * i).round } end line_z ||= GR.inqcolor(989) # FIXME color = if line_z.is_a?(Numeric) Array.new(n, line_z) else raise ArgumentError if n != line_z.length to_rgb_color(line_z) end z = linewidth.to_a.zip(color).flatten # to_a : NArray gdp(x, y, GDP_DRAW_LINES, z) end end |
.polyline3d(x, y, z) ⇒ Object
Draw a 3D curve using the current line attributes, starting from the first data point and ending at the last data point.
The values for ‘x`, `y` and `z` are in world coordinates. The attributes that control the appearance of a polyline are linetype, linewidth and color index.
1225 1226 1227 1228 |
# File 'lib/gr.rb', line 1225 def polyline3d(x, y, z) n = equal_length(x, y, z) super(n, x, y, z) end |
.polymarker(x, y, markersize = nil, marker_z = nil) ⇒ Object
Draw marker symbols centered at the given data points.
The values for x and y are in world coordinates. The attributes that control the appearance of a polymarker are marker type, marker size scale factor and color index.
228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 |
# File 'lib/gr.rb', line 228 def polymarker(x, y, markersize = nil, marker_z = nil) # GR.jl - Multiple dispatch n = equal_length(x, y) if markersize.nil? && marker_z.nil? super(n, x, y) else markersize ||= GR.inqmarkersize markersize = if markersize.is_a?(Numeric) Array.new(n, markersize * 100) else raise ArgumentError if n != markersize.length markersize.map { |i| (100 * i).round } end marker_z ||= GR.inqcolor(989) # FIXME color = if marker_z.is_a?(Numeric) Array.new(n, marker_z) else raise ArgumentError if n != marker_z.length to_rgb_color(marker_z) end z = markersize.to_a.zip(color).flatten # to_a : NArray gdp(x, y, GDP_DRAW_MARKERS, z) end end |
.polymarker3d(x, y, z) ⇒ Object
Draw marker symbols centered at the given 3D data points.
The values for ‘x`, `y` and `z` are in world coordinates. The attributes that control the appearance of a polymarker are marker type, marker size scale factor and color index.
1240 1241 1242 1243 |
# File 'lib/gr.rb', line 1240 def polymarker3d(x, y, z) n = equal_length(x, y, z) super(n, x, y, z) end |
.precision ⇒ Numeric
|
# File 'lib/gr.rb', line 1821
|
.quiver(x, y, u, v, color) ⇒ Object
Draw a quiver plot on a grid of nx*ny points.
The values for ‘x` and `y` are in world coordinates.
1909 1910 1911 1912 1913 1914 |
# File 'lib/gr.rb', line 1909 def quiver(x, y, u, v, color) # TODO: check: Arrays have incorrect length or dimension. nx = x.length ny = y.length super(nx, ny, x, y, u, v, (color ? 1 : 0)) end |
.readimage(path) ⇒ Integer
1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 |
# File 'lib/gr.rb', line 1703 def readimage(path) # Feel free to make a pull request if you catch a mistake # or you have an idea to improve it. data = Fiddle::Pointer.malloc(Fiddle::SIZEOF_INTPTR_T) w, h = inquiry [:int, :int] do |width, height| # data is a pointer of a pointer super(path, width, height, data.ref) end d = data.to_str(w * h * Fiddle::SIZEOF_INT).unpack('L*') # UInt32 [w, h, d] end |
.redrawsegws ⇒ Object
|
# File 'lib/gr.rb', line 920
|
.reducepoints(xd, yd, n) ⇒ Object
Reduces the number of points of the x and y array.
1866 1867 1868 1869 1870 1871 1872 |
# File 'lib/gr.rb', line 1866 def reducepoints(xd, yd, n) nd = equal_length(xd, yd) inquiry [{ double: n }, { double: n }] do |x, y| # Different from Julia. x, y are initialized zero. super(nd, xd, yd, n, x, y) end end |
.resizeselection ⇒ Object
1815 1816 1817 1818 1819 |
# File 'lib/gr.rb', line 1815 def inqbbox inquiry %i[double double double double] do |*pts| super(*pts) end end |
.restorestate ⇒ Object
|
# File 'lib/gr.rb', line 1831
|
.savefig(filename, kv = {}) ⇒ Object
(Plot) Save the current figure to a file.
1476 1477 1478 1479 1480 1481 1482 |
# File 'lib/gr/plot.rb', line 1476 def savefig(filename, kv = {}) GR.beginprint(filename) plt = GR::Plot.last_plot plt.kvs.merge!(kv) plt.plot_data(false) GR.endprint end |
.savestate ⇒ Object
|
# File 'lib/gr.rb', line 1829
|
.scatter(*args) ⇒ Object
(Plot) Draw one or more scatter plots.
1272 1273 1274 |
# File 'lib/gr/plot.rb', line 1272 def scatter(*args) create_plot(:scatter, *args) end |
.scatter3(*args) ⇒ Object
(Plot) Draw one or more three-dimensional scatter plots.
1384 1385 1386 |
# File 'lib/gr/plot.rb', line 1384 def scatter3(*args) create_plot(:scatter3, *args) end |
.selectclipxform ⇒ Object
2143 2144 2145 |
# File 'lib/gr.rb', line 2143 def inqclipxform inquiry_int { |pt| super(pt) } end |
.selectcontext ⇒ Object
|
# File 'lib/gr.rb', line 1833
|
.selntran ⇒ Object
‘selntran` selects a predefined transformation from world coordinates to normalized device coordinates.
|
# File 'lib/gr.rb', line 851
|
.setarrowsize ⇒ Object
Set the arrow size to be used for subsequent arrow commands.
‘setarrowsize` defines the arrow size for subsequent arrow primitives. The default arrow size is 1.
|
# File 'lib/gr.rb', line 1680
|
.setarrowstyle ⇒ Object
Set the arrow style to be used for subsequent arrow commands.
‘setarrowstyle` defines the arrow style for subsequent arrow primitives.
|
# File 'lib/gr.rb', line 1654
|
.setbordercolorind ⇒ Object
Define the color of subsequent path output primitives.
2137 2138 2139 |
# File 'lib/gr.rb', line 2137 def inqbordercolorind inquiry_int { |pt| super(pt) } end |
.setborderwidth ⇒ Object
Define the border width of subsequent path output primitives.
2127 2128 2129 |
# File 'lib/gr.rb', line 2127 def inqborderwidth inquiry_double { |pt| super(pt) } end |
.setcharexpan ⇒ Object
Set the current character expansion factor (width to height ratio).
‘setcharexpan` defines the width of subsequent text output primitives. The expansion factor alters the width of the generated characters, but not their height. The default text expansion factor is 1, or one times the normal width-to-height ratio of the text.
|
# File 'lib/gr.rb', line 623
|
.setcharheight ⇒ Object
Set the current character height.
‘setcharheight` defines the height of subsequent text output primitives. Text height is defined as a percentage of the default window. GR uses the default text height of 0.027 (2.7% of the height of the default window).
|
# File 'lib/gr.rb', line 656
|
.setcharspace ⇒ Object
|
# File 'lib/gr.rb', line 635
|
.setcharup ⇒ Object
Set the current character text angle up vector.
‘setcharup` defines the vertical rotation of subsequent text output primitives. The text up vector is initially set to (0, 1), horizontal to the baseline.
|
# File 'lib/gr.rb', line 677
|
.setclip ⇒ Object
Set the clipping indicator.
-
0 : Clipping is off. Data outside of the window will be drawn.
-
1 : Clipping is on. Data outside of the window will not be drawn.
‘setclip` enables or disables clipping of the image drawn in the current window. Clipping is defined as the removal of those portions of the graph that lie outside of the defined viewport. If clipping is on, GR does not draw generated output primitives past the viewport boundaries. If clipping is off, primitives may exceed the viewport boundaries, and they will be drawn to the edge of the workstation window. By default, clipping is on.
|
# File 'lib/gr.rb', line 862
|
.setcolormap ⇒ Object
Set the currently used colormap.
-
A list of colormaps can be found at: gr-framework.org/colormaps.html
Using a negative index will use the reverse of the selected colormap.
|
# File 'lib/gr.rb', line 1401
|
.setcolormapfromrgb(r, g, b, positions: nil) ⇒ Object
GR.jl and python-gr have different APIsI
Define a colormap by a list of RGB colors. This function defines a colormap using the n given color intensities. If less than 256 colors are provided the colors intensities are linear interpolated. If x is NULL the given color values are evenly distributed in the colormap. Otherwise the normalized value of x defines the position of the color in the colormap.
1432 1433 1434 1435 1436 1437 1438 1439 1440 |
# File 'lib/gr.rb', line 1432 def setcolormapfromrgb(r, g, b, positions: nil) n = equal_length(r, g, b) if positions.nil? positions = Fiddle::NULL elsif positions.length != n raise end super(n, r, g, b, positions) end |
.setcolorrep ⇒ Object
Redefine an existing color index representation by specifying an RGB color triplet.
|
# File 'lib/gr.rb', line 785
|
.setcoordxform(mat) ⇒ Object
Change the coordinate transformation according to the given matrix.
1766 1767 1768 1769 1770 |
# File 'lib/gr.rb', line 1766 def setcoordxform(mat) raise if mat.size != 6 super(mat) end |
.setfillcolorind ⇒ Object
Sets the current fill area color index.
‘setfillcolorind` defines the color of subsequent fill area output primitives. GR uses the default foreground color (black=1) for the default fill area color index.
|
# File 'lib/gr.rb', line 766
|
.setfillintstyle ⇒ Object
Set the fill area interior style to be used for fill areas.
‘setfillintstyle` defines the interior style for subsequent fill area output primitives. The default interior style is HOLLOW.
|
# File 'lib/gr.rb', line 721
|
.setfillstyle ⇒ Object
Sets the fill style to be used for subsequent fill areas.
‘setfillstyle` specifies an index when PATTERN fill or HATCH fill is requested by the`setfillintstyle` function. If the interior style is set to PATTERN, the fill style index points to a device-independent pattern table. If interior style is set to HATCH the fill style index indicates different hatch styles. If HOLLOW or SOLID is specified for the interior style, the fill style index is unused.
|
# File 'lib/gr.rb', line 744
|
.setlinecolorind ⇒ Object
Define the color of subsequent polyline output primitives.
491 492 493 |
# File 'lib/gr.rb', line 491 def inqlinecolorind inquiry_int { |pt| super(pt) } end |
.setlinetype ⇒ Object
Specify the line style for polylines.
466 467 468 |
# File 'lib/gr.rb', line 466 def inqlinetype inquiry_int { |pt| super(pt) } end |
.setlinewidth ⇒ Object
Define the line width of subsequent polyline output primitives.
The line width is calculated as the nominal line width generated on the workstation multiplied by the line width scale factor. This value is mapped by the workstation to the nearest available line width. The default line width is 1.0, or 1 times the line width generated on the graphics device.
481 482 483 |
# File 'lib/gr.rb', line 481 def inqlinewidth inquiry_double { |pt| super(pt) } end |
.setmarkercolorind ⇒ Object
Define the color of subsequent polymarker output primitives.
567 568 569 |
# File 'lib/gr.rb', line 567 def inqmarkercolorind inquiry_int { |pt| super(pt) } end |
.setmarkersize ⇒ Object
Specify the marker size for polymarkers.
The polymarker size is calculated as the nominal size generated on the graphics device multiplied by the marker size scale factor.
|
# File 'lib/gr.rb', line 544
|
.setmarkertype ⇒ Object
Specifiy the marker type for polymarkers.
Polymarkers appear centered over their specified coordinates.
540 541 542 |
# File 'lib/gr.rb', line 540 def inqmarkertype inquiry_int { |pt| super(pt) } end |
.setorthographicprojection ⇒ Object
Set parameters for orthographic transformation. Switches projection type to orthographic.
|
# File 'lib/gr.rb', line 2203
|
.setperspectiveprojection ⇒ Object
Set the far and near clipping plane for perspective projection and the vertical field ov view. Switches projection type to perspective.
|
# File 'lib/gr.rb', line 2162
|
.setprojectiontype ⇒ Object
Set the projection type with this flag.
|
# File 'lib/gr.rb', line 2147
|
.setregenflags ⇒ Object
|
# File 'lib/gr.rb', line 1824
|
.setresamplemethod ⇒ Object
Set the resample method used for ‘drawimage`.
|
# File 'lib/gr.rb', line 2017
|
.setscale ⇒ Integer
‘setscale` sets the type of transformation to be used for subsequent GR output primitives.
‘setscale` defines the current transformation according to the given scale specification which may be or’ed together using any of the above options. GR uses these options for all subsequent output primitives until another value is provided. The scale options are used to transform points from an abstract logarithmic or semi-logarithmic coordinate system, which may be flipped along each axis, into the world coordinate system.
Note: When applying a logarithmic transformation to a specific axis, the system assumes that the axes limits are greater than zero.
|
# File 'lib/gr.rb', line 955
|
.setscalefactors3d ⇒ Object
Set the scale factor for each axis. A one means no scale. The scaling factors must not be zero. .
|
# File 'lib/gr.rb', line 2254
|
.setsegtran ⇒ Object
|
# File 'lib/gr.rb', line 922
|
.setshadow ⇒ Object
‘setshadow` allows drawing of shadows, realized by images painted underneath, and offset from, graphics objects such that the shadow mimics the effect of a light source cast on the graphics objects.
|
# File 'lib/gr.rb', line 1741
|
.setspace ⇒ Integer
Set the abstract Z-space used for mapping three-dimensional output primitives into the current world coordinate space.
‘setspace` establishes the limits of an abstract Z-axis and defines the angles for rotation and for the viewing angle (tilt) of a simulated three-dimensional graph, used for mapping corresponding output primitives into the current window. These settings are used for all subsequent three-dimensional output primitives until other values are specified. Angles of rotation and viewing angle must be specified between 0° and 90°.
949 950 951 952 953 |
# File 'lib/gr.rb', line 949 def inqspace inquiry %i[double double int int] do |*pts| super(*pts) end end |
.setspace3d ⇒ Object
Set the camera for orthographic or perspective projection.
The center of the 3d window is used as the focus point and the camera is positioned relative to it, using camera distance, rotation and tilt similar to ‘setspace`. This function can be used if the user prefers spherical coordinates to setting the camera position directly, but has reduced functionality in comparison to GR.settransformationparameters, GR.setperspectiveprojection and GR.setorthographicprojection.
|
# File 'lib/gr.rb', line 2271
|
.settextalign ⇒ Object
-
1 : TEXT_HALIGN_LEFT - Left justify
-
2 : TEXT_HALIGN_CENTER - Center justify
-
3 : TEXT_HALIGN_RIGHT - Right justify
‘settextalign` specifies how the characters in a text primitive will be aligned in horizontal and vertical space. The default text alignment indicates horizontal left alignment and vertical baseline alignment.
|
# File 'lib/gr.rb', line 703
|
.settextcolorind ⇒ Object
Sets the current text color index.
‘settextcolorind` defines the color of subsequent text output primitives. GR uses the default foreground color (black=1) for the default text color index.
|
# File 'lib/gr.rb', line 637
|
.settextencoding ⇒ Object
2298 2299 2300 2301 2302 |
# File 'lib/gr.rb', line 2298 def inqtextencoding inquiry_int do |encoding| super(encoding) end end |
.settextfontprec ⇒ Object
Specify the text font and precision for subsequent text output primitives.
The appearance of a font depends on the text precision value specified. STRING, CHARACTER or STROKE precision allows for a greater or lesser realization of the text primitives, for efficiency. STRING is the default precision for GR and produces the highest quality output using either native font rendering or FreeType. OUTLINE uses the GR path rendering functions to draw individual glyphs and produces the highest quality output.
|
# File 'lib/gr.rb', line 571
|
.settextpath ⇒ Object
Define the current direction in which subsequent text will be drawn.
|
# File 'lib/gr.rb', line 688
|
.settransformationparameters ⇒ Object
Method to set the camera position, the upward facing direction and the focus point of the shown volume.
|
# File 'lib/gr.rb', line 2180
|
.settransparency ⇒ Object
Set the value of the alpha component associated with GR colors.
|
# File 'lib/gr.rb', line 1756
|
.setviewport ⇒ Object
‘setviewport` establishes a rectangular subspace of normalized device coordinates.
‘setviewport` defines the rectangular portion of the Normalized Device Coordinate (NDC) space to be associated with the specified normalization transformation. The NDC viewport and World Coordinate (WC) window define the normalization transformation through which all output primitives pass. The WC window is mapped onto the rectangular NDC viewport which is, in turn, mapped onto the display surface of the open and active workstation, in device coordinates.
|
# File 'lib/gr.rb', line 824
|
.setwindow ⇒ Object
‘setwindow` establishes a window, or rectangular subspace, of world coordinates to be plotted. If you desire log scaling or mirror-imaging of axes, use the SETSCALE function.
‘setwindow` defines the rectangular portion of the World Coordinate space (WC) to be associated with the specified normalization transformation. The WC window and the Normalized Device Coordinates (NDC) viewport define the normalization transformation through which all output primitives are mapped. The WC window is mapped onto the rectangular NDC viewport which is, in turn, mapped onto the display surface of the open and active workstation, in device coordinates. By default, GR uses the range [0,1] x [0,1], in world coordinates, as the normalization transformation window.
|
# File 'lib/gr.rb', line 795
|
.setwindow3d ⇒ Object
Set the three dimensional window. Only used for perspective and orthographic projection.
|
# File 'lib/gr.rb', line 2235
|
.setwsviewport ⇒ Object
Define the size of the workstation graphics window in meters.
‘setwsviewport` places a workstation window on the display of the specified size in meters. This command allows the workstation window to be accurately sized for a display or hardcopy device, and is often useful for sizing graphs for desktop publishing applications.
|
# File 'lib/gr.rb', line 898
|
.setwswindow ⇒ Object
Set the area of the NDC viewport that is to be drawn in the workstation window.
‘setwswindow` defines the rectangular area of the Normalized Device Coordinate space to be output to the device. By default, the workstation transformation will map the range [0,1] x [0,1] in NDC onto the largest square on the workstation’s display surface. The aspect ratio of the workstation window is maintained at 1 to 1.
|
# File 'lib/gr.rb', line 878
|
.shade(*args) ⇒ Object
(Plot)
|
# File 'lib/gr.rb', line 1953
|
.shadelines(x, y, dims: [1200, 1200], xform: 1) ⇒ Object
Display a line set as an aggregated and rasterized image.
The values for ‘x` and `y` are in world coordinates. NaN values can be used to separate the point set into line segments.
1998 1999 2000 2001 2002 |
# File 'lib/gr.rb', line 1998 def shadelines(x, y, dims: [1200, 1200], xform: 1) n = x.length w, h = dims super(n, x, y, xform, w, h) end |
.shadepoints(x, y, dims: [1200, 1200], xform: 1) ⇒ Object
Display a point set as a aggregated and rasterized image.
The values for ‘x` and `y` are in world coordinates.
1975 1976 1977 1978 1979 |
# File 'lib/gr.rb', line 1975 def shadepoints(x, y, dims: [1200, 1200], xform: 1) n = x.length w, h = dims super(n, x, y, xform, w, h) end |
.spline(x, y, m, method) ⇒ Object
Generate a cubic spline-fit, starting from the first data point and ending at the last data point.
The values for ‘x` and `y` are in world coordinates. The attributes that control the appearance of a spline-fit are linetype, linewidth and color index.
426 427 428 429 |
# File 'lib/gr.rb', line 426 def spline(x, y, m, method) n = equal_length(x, y) super(n, x, y, m, method) end |
.stem(*args) ⇒ Object
(Plot) Draw a stem plot.
1277 1278 1279 |
# File 'lib/gr/plot.rb', line 1277 def stem(*args) create_plot(:stem, *args) end |
.step(*args) ⇒ Object
(Plot) Draw one or more step or staircase plots.
1267 1268 1269 |
# File 'lib/gr/plot.rb', line 1267 def step(*args) create_plot(:step, *args) end |
.subplot(nr, nc, p, kv = {}) ⇒ Object
Set current subplot index.
1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467 1468 1469 1470 1471 1472 1473 |
# File 'lib/gr/plot.rb', line 1453 def subplot(nr, nc, p, kv = {}) xmin = 1 xmax = 0 ymin = 1 ymax = 0 p = [p] if p.is_a? Integer p.each do |i| r = (nr - (i - 1) / nc).to_f c = ((i - 1) % nc + 1).to_f xmin = [xmin, (c - 1) / nc].min xmax = [xmax, c / nc].max ymin = [ymin, (r - 1) / nr].min ymax = [ymax, r / nr].max end { subplot: [xmin, xmax, ymin, ymax], # The policy of clearing when p[0]==1 is controversial clear: p[0] == 1, update: p[-1] == nr * nc }.merge kv end |
.surface(*args) ⇒ Object
‘surface` is overwritten by `require gr/plot`. The original method is moved to the underscored name. The yard document will show the method name after evacuation.
Draw a three-dimensional surface plot for the given data points.
‘x` and `y` define a grid. `z` is a singly dimensioned array containing at least `nx` * `ny` data points. Z describes the surface height at each point on the grid. Data is ordered as shown in the table:
1317 1318 1319 1320 1321 1322 |
# File 'lib/gr.rb', line 1317 def surface(x, y, z, option) # TODO: check: Arrays have incorrect length or dimension. nx = x.length ny = y.length super(nx, ny, x, y, z, option) end |
.text ⇒ Object
Draw a text at position ‘x`, `y` using the current text attributes.
The values for ‘x` and `y` are in normalized device coordinates. The attributes that control the appearance of text are text font and precision, character expansion factor, character spacing, text color index, character height, character up vector, text path and text alignment.
270 271 272 273 274 |
# File 'lib/gr.rb', line 270 def inqtext(x, y, string) inquiry [{ double: 4 }, { double: 4 }] do |tbx, tby| super(x, y, string, tbx, tby) end end |
.text3d ⇒ Object
2290 2291 2292 2293 2294 |
# File 'lib/gr.rb', line 2290 def inqtext3d(x, y, z, string, axis) inquiry [{ double: 16 }, { double: 16 }] do |tbx, tby| super(x, y, z, string, axis, tbx, tby) end end |
.textext ⇒ Integer
Draw a text at position ‘x`, `y` using the current text attributes. Strings can be defined to create basic mathematical expressions and Greek letters.
The values for X and Y are in normalized device coordinates. The attributes that control the appearance of text are text font and precision, character expansion factor, character spacing, text color index, character height, character up vector, text path and text alignment.
The character string is interpreted to be a simple mathematical formula. The following notations apply:
Subscripts and superscripts: These are indicated by carets (‘^’) and underscores (‘_’). If the sub/superscript contains more than one character, it must be enclosed in curly braces (‘{}’).
Fractions are typeset with A ‘/’ B, where A stands for the numerator and B for the denominator.
To include a Greek letter you must specify the corresponding keyword after a backslash (‘') character. The text translator produces uppercase or lowercase Greek letters depending on the case of the keyword.
* Α α - alpha
* Β β - beta
* Γ γ - gamma
* Δ δ - delta
* Ε ε - epsilon
* Ζ ζ - zeta
* Η η - eta
* Θ θ - theta
* Ι ι - iota
* Κ κ - kappa
* Λ λ - lambda
* Μ μ - mu
* Ν ν - Nu / v
* Ξ ξ - xi
* Ο ο - omicron
* Π π - pi
* Ρ ρ - rho
* Σ σ - sigma
* Τ τ - tau
* Υ υ - upsilon
* Φ φ - phi
* Χ χ - chi
* Ψ ψ - psi
* Ω ω - omega
Note: ‘v` is a replacement for `nu` which would conflict with `n` (newline) For more sophisticated mathematical formulas, you should use the `mathtex` function.
|
# File 'lib/gr.rb', line 985
|
.tick ⇒ Numeric
|
# File 'lib/gr.rb', line 1469
|
.titles3d ⇒ Object
Display axis titles just outside of their respective axes.
|
# File 'lib/gr.rb', line 1285
|
.to_rgb_color(z) ⇒ Array, NArray
2111 2112 2113 2114 2115 2116 2117 2118 2119 |
# File 'lib/gr.rb', line 2111 def to_rgb_color(z) zmin, zmax = z.minmax return Array.new(z.length, 0) if zmax == zmin z.map do |i| zi = (i - zmin) / (zmax - zmin).to_f inqcolor(1000 + (zi * 255).round) end end |
.tricont(*args) ⇒ Object
(Plot) Draw a triangular contour plot.
1353 1354 1355 |
# File 'lib/gr/plot.rb', line 1353 def tricont(*args) create_plot(:tricont, *format_xyzc(*args)) end |
.tricontour(x, y, z, levels) ⇒ Object
Draw a contour plot for the given triangle mesh.
1385 1386 1387 1388 1389 |
# File 'lib/gr.rb', line 1385 def tricontour(x, y, z, levels) npoints = x.length # equal_length ? nlevels = levels.length super(npoints, x, y, z, nlevels, levels) end |
.trisurf(*args) ⇒ Object
(Plot) Draw a triangular surface plot.
1374 1375 1376 |
# File 'lib/gr/plot.rb', line 1374 def trisurf(*args) create_plot(:trisurf, *format_xyzc(*args)) end |
.trisurface(x, y, z) ⇒ Object
Draw a triangular surface plot for the given data points.
1880 1881 1882 1883 |
# File 'lib/gr.rb', line 1880 def trisurface(x, y, z) n = [x, y, z].map(&:length).min super(n, x, y, z) end |
.updategks ⇒ Object
|
# File 'lib/gr.rb', line 928
|
.updatews ⇒ Object
Update the specified workstation.
|
# File 'lib/gr.rb', line 174
|
.uselinespec ⇒ Integer
1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 1856 1857 1858 |
# File 'lib/gr.rb', line 1840 def delaunay(x, y) # Feel free to make a pull request if you catch a mistake # or you have an idea to improve it. npoints = equal_length(x, y) triangles = Fiddle::Pointer.malloc(Fiddle::SIZEOF_INTPTR_T) dim = 3 n_tri = inquiry_int do |ntri| super(npoints, x, y, ntri, triangles.ref) end if n_tri > 0 tri = triangles.to_str(dim * n_tri * Fiddle::SIZEOF_INT).unpack('l*') # Int32 # Ruby : 0-based indexing # Julia : 1-based indexing tri = tri.each_slice(dim).to_a [n_tri, tri] else 0 end end |
.validaterange ⇒ Integer
1475 1476 1477 1478 1479 1480 1481 |
# File 'lib/gr.rb', line 1475 def adjustlimits(amin, amax) inquiry %i[double double] do |pamin, pamax| pamin.write_double amin pamax.write_double amax super(pamin, pamax) end end |
.verrorbars(x, y, e1, e2) ⇒ Object
Draw a standard vertical error bar graph.
1197 1198 1199 1200 |
# File 'lib/gr.rb', line 1197 def (x, y, e1, e2) n = equal_length(x, y, e1, e2) super(n, x, y, e1, e2) end |
.version ⇒ String
Returns the combined version strings of the GR runtime.
1949 1950 1951 |
# File 'lib/gr.rb', line 1949 def version super.to_s end |
.volume(v, kv = {}) ⇒ Object
(Plot)
1395 1396 1397 1398 1399 |
# File 'lib/gr/plot.rb', line 1395 def volume(v, kv = {}) create_plot(:volume, v, kv) do |plt| plt.args = [[nil, nil, v, nil, '']] end end |
.wc3towc(x, y, z) ⇒ Object
1578 1579 1580 1581 1582 1583 1584 1585 |
# File 'lib/gr.rb', line 1578 def wc3towc(x, y, z) inquiry %i[double double double] do |px, py, pz| px.write_double x py.write_double y pz.write_double z super(px, py, pz) end end |
.wctondc(x, y) ⇒ Object
1570 1571 1572 1573 1574 1575 1576 |
# File 'lib/gr.rb', line 1570 def wctondc(x, y) inquiry %i[double double] do |px, py| px.write_double x py.write_double y super(px, py) end end |
.wireframe(*args) ⇒ Object
(Plot) Draw a three-dimensional wireframe plot.
1358 1359 1360 |
# File 'lib/gr/plot.rb', line 1358 def wireframe(*args) create_plot(:wireframe, *format_xyzc(*args)) end |