mathgl 0.0.2 → 0.0.3
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +10 -10
- data/TODO +5 -0
- data/ext/mathgl/mathgl.cxx +1 -0
- data/lib/mathgl/libdoc_core_en.rb +3771 -0
- data/lib/mathgl/libdoc_data_en.rb +1645 -0
- data/lib/mathgl/libdoc_other_en.rb +192 -0
- data/lib/mathgl/libdoc_parse_en.rb +151 -0
- data/lib/mathgl/version.rb +1 -1
- data/misc/conv_texi.rb +426 -0
- data/sample/conv_sample.rb +2 -15
- data/sample/prepare.rb +11 -3
- data/sample/sample.rb +141 -153
- metadata +8 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: e8bbe45fbca997087a501520951e10cccf4ed7c5
|
4
|
+
data.tar.gz: 918520daf64104438ff0fac7e63e62c912bc8b46
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 2963f4e8cb36ef58b23951154cac048237f7790f876dc9330504a09ce1d11bf913e04f546ab6a757643a90f51ec61e3a9d8fd3762be2757a015689a416fc7ee0
|
7
|
+
data.tar.gz: 0e15ebf237d03ecfe810534296aa995bbefd6f3b95285b5b651aa13ca4e28121ab392bdcf2bdeee52001f9246709f9bd72888f3f9255f861f5b59b2be143f3a9
|
data/README.md
CHANGED
@@ -1,23 +1,24 @@
|
|
1
1
|
# Ruby/MathGL
|
2
2
|
|
3
|
-
Ruby wrapper of MathGL - library for scientific data visualization
|
4
|
-
http://mathgl.sourceforge.net/
|
3
|
+
Ruby wrapper of [MathGL - library for scientific data visualization](http://mathgl.sourceforge.net/) made using SWIG.
|
5
4
|
|
6
5
|
(This package is under construction.)
|
7
6
|
|
7
|
+
- [Ruby/MathGL Sample Plots](https://github.com/masa16/ruby-mathgl-sample)
|
8
|
+
|
8
9
|
## Installation
|
9
10
|
|
10
11
|
1. Install MathGL2 library: http://mathgl.sourceforge.net/
|
11
12
|
|
12
13
|
2. Install Ruby/MathGL from source:
|
13
14
|
|
14
|
-
|
15
|
-
|
16
|
-
|
15
|
+
$ ruby setup.rb config -- --with-mathgl-dir=/usr/local
|
16
|
+
$ ruby setup.rb setup
|
17
|
+
$ ruby setup.rb install
|
17
18
|
|
18
|
-
Or install with gem:
|
19
|
+
Or install with gem:
|
19
20
|
|
20
|
-
|
21
|
+
$ gem install mathgl -- --with-mathgl-dir=/usr/local
|
21
22
|
|
22
23
|
## Usage
|
23
24
|
|
@@ -26,7 +27,7 @@ Write to PNG
|
|
26
27
|
require 'mathgl'
|
27
28
|
|
28
29
|
prc = proc{
|
29
|
-
x = (
|
30
|
+
x = (0..100).map{|i| i*0.1}
|
30
31
|
y = x.map{|i| Math.sin(i)}
|
31
32
|
set_ranges(0,10,-1,1)
|
32
33
|
box
|
@@ -41,10 +42,9 @@ Write to PNG
|
|
41
42
|
Qt window:
|
42
43
|
|
43
44
|
require 'mathgl'
|
44
|
-
require "mathgl/qt"
|
45
45
|
|
46
46
|
prc = proc{
|
47
|
-
x = (
|
47
|
+
x = (0..100).map{|i| i*0.1}
|
48
48
|
y = x.map{|i| Math.sin(i)}
|
49
49
|
set_ranges(0,10,-1,1)
|
50
50
|
box
|
data/TODO
ADDED
data/ext/mathgl/mathgl.cxx
CHANGED
@@ -0,0 +1,3771 @@
|
|
1
|
+
# This document is converted from core_en.texi.
|
2
|
+
class MglGraph
|
3
|
+
|
4
|
+
# Create and delete objects.
|
5
|
+
# Creates the instance of class mglGraph with specified sizes width and height. Parameter kind may have following values: -- use default plotter, -- use OpenGL plotter.
|
6
|
+
# @overload initialize(kind=0,width=600,height=400)
|
7
|
+
# @param [Integer] kind default=0
|
8
|
+
# @param [Integer] width default=600
|
9
|
+
# @param [Integer] height default=400
|
10
|
+
# @return [MglGraph]
|
11
|
+
# @overload initialize(gr)
|
12
|
+
# @param [MglGraph] gr
|
13
|
+
# @return [MglGraph]
|
14
|
+
def initialize
|
15
|
+
end
|
16
|
+
|
17
|
+
|
18
|
+
# Graphics setup.
|
19
|
+
# Restore initial values for all of parameters.
|
20
|
+
# @overload default_plot_param()
|
21
|
+
# @return [nil]
|
22
|
+
def default_plot_param
|
23
|
+
end
|
24
|
+
|
25
|
+
|
26
|
+
# Transparency.
|
27
|
+
# Sets the transparency on/off and returns previous value of transparency. It is recommended to call this function before any plotting command. Default value is transparency off.
|
28
|
+
# @overload alpha(enable)
|
29
|
+
# @param [bool] enable
|
30
|
+
# @return [nil]
|
31
|
+
def alpha
|
32
|
+
end
|
33
|
+
|
34
|
+
|
35
|
+
# Transparency.
|
36
|
+
# Sets default value of alpha channel (transparency) for all plotting functions. Initial value is 0.5.
|
37
|
+
# @overload set_alpha_def(val)
|
38
|
+
# @param [Float] val
|
39
|
+
# @return [nil]
|
40
|
+
def set_alpha_def
|
41
|
+
end
|
42
|
+
|
43
|
+
|
44
|
+
# Transparency.
|
45
|
+
# Set the type of transparency. Possible values are:
|
46
|
+
# @overload set_transp_type(type)
|
47
|
+
# @param [Integer] type
|
48
|
+
# @return [nil]
|
49
|
+
def set_transp_type
|
50
|
+
end
|
51
|
+
|
52
|
+
|
53
|
+
# Lighting.
|
54
|
+
# Sets the using of light on/off for overall plot. Function returns previous value of lighting. Default value is lightning off.
|
55
|
+
# @overload light(enable)
|
56
|
+
# @param [bool] enable
|
57
|
+
# @return [bool]
|
58
|
+
def light
|
59
|
+
end
|
60
|
+
|
61
|
+
|
62
|
+
# Lighting.
|
63
|
+
# Switch on/off n-th light source separately.
|
64
|
+
# @overload light(n,enable)
|
65
|
+
# @param [Integer] n
|
66
|
+
# @param [bool] enable
|
67
|
+
# @return [nil]
|
68
|
+
def light
|
69
|
+
end
|
70
|
+
|
71
|
+
|
72
|
+
# Lighting.
|
73
|
+
# The function adds a light source with identification n in direction d with color c and with brightness bright (which must be in range [0,1]). If position r is specified and isn't NAN then light source is supposed to be local otherwise light source is supposed to be placed at infinity.
|
74
|
+
# @overload add_light(n,d,c='w',bright=0.5,ap=0)
|
75
|
+
# @param [Integer] n
|
76
|
+
# @param [MglPoint] d
|
77
|
+
# @param [String] c default='w'
|
78
|
+
# @param [Float] bright default=0.5
|
79
|
+
# @param [Float] ap default=0
|
80
|
+
# @return [nil]
|
81
|
+
# @overload add_light(n,r,d,c='w',bright=0.5,ap=0)
|
82
|
+
# @param [Integer] n
|
83
|
+
# @param [MglPoint] r
|
84
|
+
# @param [MglPoint] d
|
85
|
+
# @param [String] c default='w'
|
86
|
+
# @param [Float] bright default=0.5
|
87
|
+
# @param [Float] ap default=0
|
88
|
+
# @return [nil]
|
89
|
+
def add_light
|
90
|
+
end
|
91
|
+
|
92
|
+
|
93
|
+
# Lighting.
|
94
|
+
# Set on/off to use diffusive light (only for local light sources).
|
95
|
+
# @overload set_dif_light(enable)
|
96
|
+
# @param [bool] enable
|
97
|
+
# @return [nil]
|
98
|
+
def set_dif_light
|
99
|
+
end
|
100
|
+
|
101
|
+
|
102
|
+
# Lighting.
|
103
|
+
# Sets the brightness of ambient light. The value should be in range [0,1].
|
104
|
+
# @overload set_ambient(bright=0.5)
|
105
|
+
# @param [Float] bright default=0.5
|
106
|
+
# @return [nil]
|
107
|
+
def set_ambient
|
108
|
+
end
|
109
|
+
|
110
|
+
|
111
|
+
# Fog.
|
112
|
+
# Function imitate a fog in the plot. Fog start from relative distance dz from view point and its density growths exponentially in depth. So that the fog influence is determined by law ~ 1-exp(-*d*z*). Here *z* is normalized to 1 depth of the plot. If value d=0 then the fog is absent. Note, that fog was applied at stage of image creation, not at stage of drawing.
|
113
|
+
# @overload fog(d,dz=0.25)
|
114
|
+
# @param [Float] d
|
115
|
+
# @param [Float] dz default=0.25
|
116
|
+
# @return [nil]
|
117
|
+
def fog
|
118
|
+
end
|
119
|
+
|
120
|
+
|
121
|
+
# Default sizes.
|
122
|
+
# Sets relative width of rectangles in bars, barh, boxplot, candle. Default value is 0.7.
|
123
|
+
# @overload set_bar_width(val)
|
124
|
+
# @param [Float] val
|
125
|
+
# @return [nil]
|
126
|
+
def set_bar_width
|
127
|
+
end
|
128
|
+
|
129
|
+
|
130
|
+
# Default sizes.
|
131
|
+
# Sets size of marks for 1D plotting. Default value is 1.
|
132
|
+
# @overload set_mark_size(val)
|
133
|
+
# @param [Float] val
|
134
|
+
# @return [nil]
|
135
|
+
def set_mark_size
|
136
|
+
end
|
137
|
+
|
138
|
+
|
139
|
+
# Default sizes.
|
140
|
+
# Sets size of arrows for 1D plotting, lines and curves (see Primitives). Default value is 1.
|
141
|
+
# @overload set_arrow_size(val)
|
142
|
+
# @param [Float] val
|
143
|
+
# @return [nil]
|
144
|
+
def set_arrow_size
|
145
|
+
end
|
146
|
+
|
147
|
+
|
148
|
+
# Default sizes.
|
149
|
+
# Sets approximate number of lines in mesh, fall, grid and also the number of hachures in vect, dew and the number of cells in cloud. By default (=0) it draws all lines/hachures/cells.
|
150
|
+
# @overload set_mesh_num(val)
|
151
|
+
# @param [Integer] val
|
152
|
+
# @return [nil]
|
153
|
+
def set_mesh_num
|
154
|
+
end
|
155
|
+
|
156
|
+
|
157
|
+
# Default sizes.
|
158
|
+
# Sets approximate number of visible faces. Can be used for speeding up drawing by cost of lower quality. By default (=0) it draws all of them.
|
159
|
+
# @overload set_face_num(val)
|
160
|
+
# @param [Integer] val
|
161
|
+
# @return [nil]
|
162
|
+
def set_face_num
|
163
|
+
end
|
164
|
+
|
165
|
+
|
166
|
+
# Default sizes.
|
167
|
+
# Sets default name id as filename for saving (in FLTK window for example).
|
168
|
+
# @overload set_plot_id(id)
|
169
|
+
# @param [String] id
|
170
|
+
# @return [nil]
|
171
|
+
def set_plot_id
|
172
|
+
end
|
173
|
+
|
174
|
+
|
175
|
+
# Default sizes.
|
176
|
+
# Gets default name id as filename for saving (in FLTK window for example).
|
177
|
+
# @overload get_plot_id()
|
178
|
+
# @return [String]
|
179
|
+
def get_plot_id
|
180
|
+
end
|
181
|
+
|
182
|
+
|
183
|
+
# Cutting.
|
184
|
+
# Flag which determines how points outside bounding box are drawn. If it is true then points are excluded from plot (it is default) otherwise the points are projected to edges of bounding box.
|
185
|
+
# @overload set_cut(val)
|
186
|
+
# @param [bool] val
|
187
|
+
# @return [nil]
|
188
|
+
def set_cut
|
189
|
+
end
|
190
|
+
|
191
|
+
|
192
|
+
# Cutting.
|
193
|
+
# Lower and upper edge of the box in which never points are drawn. If both edges are the same (the variables are equal) then the cutting box is empty.
|
194
|
+
# @overload set_cut_box(p1,p1)
|
195
|
+
# @param [MglPoint] p1
|
196
|
+
# @param [MglPoint] p1
|
197
|
+
# @return [nil]
|
198
|
+
def set_cut_box
|
199
|
+
end
|
200
|
+
|
201
|
+
|
202
|
+
# Cutting.
|
203
|
+
# Sets the cutting off condition by formula cond. This condition determine will point be plotted or not. If value of formula is nonzero then point is omitted, otherwise it plotted. Set argument as "" to disable cutting off condition.
|
204
|
+
# @overload cut_off(cond)
|
205
|
+
# @param [String] cond
|
206
|
+
# @return [nil]
|
207
|
+
def cut_off
|
208
|
+
end
|
209
|
+
|
210
|
+
|
211
|
+
# Font settings.
|
212
|
+
# Sets to use or not text rotation.
|
213
|
+
# @overload set_rotated_text(val)
|
214
|
+
# @param [bool] val
|
215
|
+
# @return [nil]
|
216
|
+
def set_rotated_text
|
217
|
+
end
|
218
|
+
|
219
|
+
|
220
|
+
# Font settings.
|
221
|
+
# Load font typeface from path/name. Empty name will load default font.
|
222
|
+
# @overload load_font(name,path="")
|
223
|
+
# @param [String] name
|
224
|
+
# @param [String] path default=""
|
225
|
+
# @return [nil]
|
226
|
+
def load_font
|
227
|
+
end
|
228
|
+
|
229
|
+
|
230
|
+
# Font settings.
|
231
|
+
# Sets the font specification (see Text printing). Default is -- Roman font centering.
|
232
|
+
# @overload set_font_def(fnt)
|
233
|
+
# @param [String] fnt
|
234
|
+
# @return [nil]
|
235
|
+
def set_font_def
|
236
|
+
end
|
237
|
+
|
238
|
+
|
239
|
+
# Font settings.
|
240
|
+
# Sets the size of font for tick and axis labels. Default font size of axis labels is 1.4 times large than for tick labels.
|
241
|
+
# @overload set_font_size(val)
|
242
|
+
# @param [Float] val
|
243
|
+
# @return [nil]
|
244
|
+
def set_font_size
|
245
|
+
end
|
246
|
+
|
247
|
+
|
248
|
+
# Font settings.
|
249
|
+
# Set FontSize by size in pt and picture DPI (default is 16 pt for dpi=72).
|
250
|
+
# @overload set_font_size_pt(cm,dpi=72)
|
251
|
+
# @param [Float] cm
|
252
|
+
# @param [Integer] dpi default=72
|
253
|
+
# @return [nil]
|
254
|
+
def set_font_size_pt
|
255
|
+
end
|
256
|
+
|
257
|
+
|
258
|
+
# Font settings.
|
259
|
+
# Set FontSize by size in centimeters and picture DPI (default is 0.56 cm = 16 pt).
|
260
|
+
# @overload set_font_size_cm(cm,dpi=72)
|
261
|
+
# @param [Float] cm
|
262
|
+
# @param [Integer] dpi default=72
|
263
|
+
# @return [nil]
|
264
|
+
def set_font_size_cm
|
265
|
+
end
|
266
|
+
|
267
|
+
|
268
|
+
# Font settings.
|
269
|
+
# Set FontSize by size in inch and picture DPI (default is 0.22 in = 16 pt).
|
270
|
+
# @overload set_font_size_in(cm,dpi=72)
|
271
|
+
# @param [Float] cm
|
272
|
+
# @param [Integer] dpi default=72
|
273
|
+
# @return [nil]
|
274
|
+
def set_font_size_in
|
275
|
+
end
|
276
|
+
|
277
|
+
|
278
|
+
# Font settings.
|
279
|
+
# Load font typeface from path/name.
|
280
|
+
# @overload load_font(name,path="")
|
281
|
+
# @param [String] name
|
282
|
+
# @param [String] path default=""
|
283
|
+
# @return [nil]
|
284
|
+
def load_font
|
285
|
+
end
|
286
|
+
|
287
|
+
|
288
|
+
# Font settings.
|
289
|
+
# Copy font data from another mglGraph object.
|
290
|
+
# @overload copy_font(from)
|
291
|
+
# @param [MglGraph] from
|
292
|
+
# @return [nil]
|
293
|
+
def copy_font
|
294
|
+
end
|
295
|
+
|
296
|
+
|
297
|
+
# Font settings.
|
298
|
+
# Restore font data to default typeface.
|
299
|
+
# @overload restore_font()
|
300
|
+
# @return [nil]
|
301
|
+
def restore_font
|
302
|
+
end
|
303
|
+
|
304
|
+
|
305
|
+
# Palette and colors.
|
306
|
+
# Sets the palette as selected colors. Default value is "Hbgrcmyhlnqeup" that corresponds to colors: dark gray , blue , green , red , cyan , magenta , yellow , gray , blue-green , sky-blue , orange , yellow-green , blue-violet , purple . The palette is used mostly in 1D plots (see 1D plotting) for curves which styles are not specified. Internal color counter will be nullified by any change of palette. This includes even hidden change (for example, by box or axis functions).
|
307
|
+
# @overload set_palette(colors)
|
308
|
+
# @param [String] colors
|
309
|
+
# @return [nil]
|
310
|
+
def set_palette
|
311
|
+
end
|
312
|
+
|
313
|
+
|
314
|
+
# Palette and colors.
|
315
|
+
# Sets the sch as default color scheme. Default value is "BbcyrR".
|
316
|
+
# @overload set_def_scheme(sch)
|
317
|
+
# @param [String] sch
|
318
|
+
# @return [nil]
|
319
|
+
def set_def_scheme
|
320
|
+
end
|
321
|
+
|
322
|
+
|
323
|
+
# Error handling.
|
324
|
+
# Set warning code. Normally you should call this function only for clearing the warning state, i.e. call SetWarn(0);. Text info will be printed as is if code<0.
|
325
|
+
# @overload set_warn(code,info="")
|
326
|
+
# @param [Integer] code
|
327
|
+
# @param [String] info default=""
|
328
|
+
# @return [nil]
|
329
|
+
def set_warn
|
330
|
+
end
|
331
|
+
|
332
|
+
|
333
|
+
# Error handling.
|
334
|
+
# Return messages about matters why some plot are not drawn. If returned string is empty then there are no messages.
|
335
|
+
# @overload message()
|
336
|
+
# @return [String]
|
337
|
+
def message
|
338
|
+
end
|
339
|
+
|
340
|
+
|
341
|
+
# Error handling.
|
342
|
+
# Return the numerical ID of warning about the not drawn plot. Possible values are:
|
343
|
+
# @overload get_warn_code()
|
344
|
+
# @return [Integer]
|
345
|
+
def get_warn_code
|
346
|
+
end
|
347
|
+
|
348
|
+
|
349
|
+
# Ranges (bounding box).
|
350
|
+
# Sets the range for -,-,- coordinate or coloring (). See also ranges.
|
351
|
+
# @overload set_range(dir,v1,v2)
|
352
|
+
# @param [String] dir
|
353
|
+
# @param [Float] v1
|
354
|
+
# @param [Float] v2
|
355
|
+
# @return [nil]
|
356
|
+
def set_range
|
357
|
+
end
|
358
|
+
|
359
|
+
|
360
|
+
# Ranges (bounding box).
|
361
|
+
# Sets the range for -,-,- coordinate or coloring () as minimal and maximal values of data dat. Parameter add=on shows that the new range will be joined to existed one (not replace it).
|
362
|
+
# @overload set_range(dir,dat,add=false)
|
363
|
+
# @param [String] dir
|
364
|
+
# @param [MglData] dat
|
365
|
+
# @param [bool] add default=false
|
366
|
+
# @return [nil]
|
367
|
+
def set_range
|
368
|
+
end
|
369
|
+
|
370
|
+
|
371
|
+
# Ranges (bounding box).
|
372
|
+
# Sets the ranges of coordinates. If minimal and maximal values of the coordinate are the same then they are ignored. Also it sets the range for coloring (analogous to crange z1 z2). This is default color range for 2d plots. Initial ranges are [-1, 1].
|
373
|
+
# @overload set_ranges(p1,p2)
|
374
|
+
# @param [MglPoint] p1
|
375
|
+
# @param [MglPoint] p2
|
376
|
+
# @return [nil]
|
377
|
+
# @overload set_ranges(x1,x2,y1,y2,z1=0,z2=0)
|
378
|
+
# @param [Float] x1
|
379
|
+
# @param [Float] x2
|
380
|
+
# @param [Float] y1
|
381
|
+
# @param [Float] y2
|
382
|
+
# @param [Float] z1 default=0
|
383
|
+
# @param [Float] z2 default=0
|
384
|
+
# @return [nil]
|
385
|
+
def set_ranges
|
386
|
+
end
|
387
|
+
|
388
|
+
|
389
|
+
# Ranges (bounding box).
|
390
|
+
# Sets the ranges of -,-,-coordinates and coloring as minimal and maximal values of data xx, yy, zz, cc correspondingly.
|
391
|
+
# @overload set_ranges(xx,yy)
|
392
|
+
# @param [MglData] xx
|
393
|
+
# @param [MglData] yy
|
394
|
+
# @return [nil]
|
395
|
+
# @overload set_ranges(xx,yy,zz)
|
396
|
+
# @param [MglData] xx
|
397
|
+
# @param [MglData] yy
|
398
|
+
# @param [MglData] zz
|
399
|
+
# @return [nil]
|
400
|
+
# @overload set_ranges(xx,yy,zz,cc)
|
401
|
+
# @param [MglData] xx
|
402
|
+
# @param [MglData] yy
|
403
|
+
# @param [MglData] zz
|
404
|
+
# @param [MglData] cc
|
405
|
+
# @return [nil]
|
406
|
+
def set_ranges
|
407
|
+
end
|
408
|
+
|
409
|
+
|
410
|
+
# Ranges (bounding box).
|
411
|
+
# Sets the ranges for automatic coordinates. If minimal and maximal values of the coordinate are the same then they are ignored.
|
412
|
+
# @overload set_auto_ranges(p1,p2)
|
413
|
+
# @param [MglPoint] p1
|
414
|
+
# @param [MglPoint] p2
|
415
|
+
# @return [nil]
|
416
|
+
# @overload set_auto_ranges(x1,x2,y1,y2,z1=0,z2=0,c1=0,c2=0)
|
417
|
+
# @param [Float] x1
|
418
|
+
# @param [Float] x2
|
419
|
+
# @param [Float] y1
|
420
|
+
# @param [Float] y2
|
421
|
+
# @param [Float] z1 default=0
|
422
|
+
# @param [Float] z2 default=0
|
423
|
+
# @param [Float] c1 default=0
|
424
|
+
# @param [Float] c2 default=0
|
425
|
+
# @return [nil]
|
426
|
+
def set_auto_ranges
|
427
|
+
end
|
428
|
+
|
429
|
+
|
430
|
+
# Ranges (bounding box).
|
431
|
+
# Sets center of axis cross section. If one of values is NAN then MathGL try to select optimal axis position.
|
432
|
+
# @overload set_origin(p0)
|
433
|
+
# @param [MglPoint] p0
|
434
|
+
# @return [nil]
|
435
|
+
# @overload set_origin(x0,y0,z0=NAN)
|
436
|
+
# @param [Float] x0
|
437
|
+
# @param [Float] y0
|
438
|
+
# @param [Float] z0 default=NAN
|
439
|
+
# @return [nil]
|
440
|
+
def set_origin
|
441
|
+
end
|
442
|
+
|
443
|
+
|
444
|
+
# Ranges (bounding box).
|
445
|
+
# Additionally extend axis range for any settings made by SetRange or SetRanges functions according the formula and (or and for log-axis range when or ). Initial ranges are [0, 1]. Attention! this settings can not be overwritten by any other functions, including DefaultPlotParam().
|
446
|
+
# @overload zoom_axis(p1,p2)
|
447
|
+
# @param [MglPoint] p1
|
448
|
+
# @param [MglPoint] p2
|
449
|
+
# @return [nil]
|
450
|
+
def zoom_axis
|
451
|
+
end
|
452
|
+
|
453
|
+
|
454
|
+
# Curved coordinates.
|
455
|
+
# Sets transformation formulas for curvilinear coordinate. Each string should contain mathematical expression for real coordinate depending on internal coordinates , , and or for colorbar. For example, the cylindrical coordinates are introduced as SetFunc("x*cos(y)", "x*sin(y)", "z");. For removing of formulas the corresponding parameter should be empty or NULL. Using transformation formulas will slightly slowing the program. Parameter EqA set the similar transformation formula for color scheme. .
|
456
|
+
# @overload set_func(eqx,eqy,eqz="",eqa="")
|
457
|
+
# @param [String] eqx
|
458
|
+
# @param [String] eqy
|
459
|
+
# @param [String] eqz default=""
|
460
|
+
# @param [String] eqa default=""
|
461
|
+
# @return [nil]
|
462
|
+
def set_func
|
463
|
+
end
|
464
|
+
|
465
|
+
|
466
|
+
# Curved coordinates.
|
467
|
+
# Sets one of the predefined transformation formulas for curvilinear coordinate. Paramater how define the coordinates: mglCartesian=0 -- Cartesian coordinates (no transformation); mglPolar=1 -- Polar coordinates ; mglSpherical=2 -- Sperical coordinates ; mglParabolic=3 -- Parabolic coordinates ; mglParaboloidal=4 -- Paraboloidal coordinates ; mglOblate=5 -- Oblate coordinates ; mglProlate=6 -- Prolate coordinates ; mglElliptic=7 -- Elliptic coordinates ; mglToroidal=8 -- Toroidal coordinates ; mglBispherical=9 -- Bispherical coordinates ; mglBipolar=10 -- Bipolar coordinates ; mglLogLog=11 -- log-log coordinates ; mglLogX=12 -- log-x coordinates ; mglLogY=13 -- log-y coordinates .
|
468
|
+
# @overload set_coor(how)
|
469
|
+
# @param [Integer] how
|
470
|
+
# @return [nil]
|
471
|
+
def set_coor
|
472
|
+
end
|
473
|
+
|
474
|
+
|
475
|
+
# Curved coordinates.
|
476
|
+
# The function sets to draws Ternary (tern=1), Quaternary (tern=2) plot or projections (tern=4,5,6).
|
477
|
+
#
|
478
|
+
# Ternary plot is special plot for 3 dependent coordinates (components) a, b, c so that a+b+c=1. MathGL uses only 2 independent coordinates a=x and b=y since it is enough to plot everything. At this third coordinate z act as another parameter to produce contour lines, surfaces and so on.
|
479
|
+
#
|
480
|
+
# Correspondingly, Quaternary plot is plot for 4 dependent coordinates a, b, c and d so that a+b+c+d=1. MathGL uses only 3 independent coordinates a=x, b=y and d=z since it is enough to plot everything.
|
481
|
+
#
|
482
|
+
# Projections can be obtained by adding value 4 to tern argument. So, that tern=4 will draw projections in Cartesian coordinates, tern=5 will draw projections in Ternary coordinates, tern=6 will draw projections in Quaternary coordinates.
|
483
|
+
#
|
484
|
+
# Use Ternary(0) for returning to usual axis.
|
485
|
+
# @overload ternary(tern)
|
486
|
+
# @param [Integer] tern
|
487
|
+
# @return [nil]
|
488
|
+
def ternary
|
489
|
+
end
|
490
|
+
|
491
|
+
|
492
|
+
# Ticks.
|
493
|
+
# Set the ticks step, number of sub-ticks and initial ticks position to be the most human readable for the axis along direction(s) dir. Also set SetTuneTicks(true). Usually you don't need to call this function except the case of returning to default settings.
|
494
|
+
# @overload adjust(dir="xyzc")
|
495
|
+
# @param [String] dir default="xyzc"
|
496
|
+
# @return [nil]
|
497
|
+
def adjust
|
498
|
+
end
|
499
|
+
|
500
|
+
|
501
|
+
# Ticks.
|
502
|
+
# Set the ticks step d, number of sub-ticks ns (used for positive d) and initial ticks position org for the axis along direction dir (use 'c' for colorbar ticks). Variable d set step for axis ticks (if positive) or it's number on the axis range (if negative). Zero value set automatic ticks. If org value is NAN then axis origin is used.
|
503
|
+
# @overload set_ticks(dir,d=0,ns=0,org=NAN)
|
504
|
+
# @param [String] dir
|
505
|
+
# @param [Float] d default=0
|
506
|
+
# @param [Integer] ns default=0
|
507
|
+
# @param [Float] org default=NAN
|
508
|
+
# @return [nil]
|
509
|
+
def set_ticks
|
510
|
+
end
|
511
|
+
|
512
|
+
|
513
|
+
# Ticks.
|
514
|
+
# Set the manual positions val and its labels lbl for ticks along axis dir. If array val is absent then values equidistantly distributed in interval [Min.x, Max.x] are used. Labels are separated by symbol. Use SetTicks() to restore automatic ticks.
|
515
|
+
# @overload set_ticks_val(dir,lbl,add=false)
|
516
|
+
# @param [String] dir
|
517
|
+
# @param [String] lbl
|
518
|
+
# @param [bool] add default=false
|
519
|
+
# @return [nil]
|
520
|
+
# @overload set_ticks_val(dir,val,lbl,add=false)
|
521
|
+
# @param [String] dir
|
522
|
+
# @param [MglData] val
|
523
|
+
# @param [String] lbl
|
524
|
+
# @param [bool] add default=false
|
525
|
+
# @return [nil]
|
526
|
+
def set_ticks_val
|
527
|
+
end
|
528
|
+
|
529
|
+
|
530
|
+
# Ticks.
|
531
|
+
# Set template templ for x-,y-,z-axis ticks or colorbar ticks. It may contain TeX symbols also. If templ="" then default template is used (in simplest case it is ). Setting on template switch off automatic ticks tuning.
|
532
|
+
# @overload set_tick_templ(dir,templ)
|
533
|
+
# @param [String] dir
|
534
|
+
# @param [String] templ
|
535
|
+
# @return [nil]
|
536
|
+
def set_tick_templ
|
537
|
+
end
|
538
|
+
|
539
|
+
|
540
|
+
# Ticks.
|
541
|
+
# Sets time labels with step val and template templ for x-,y-,z-axis ticks or colorbar ticks. It may contain TeX symbols also. The format of template templ is the same as described in . Most common variants are for national representation of time, for national representation of date, for year with century. If val=0 and/or templ="" then automatic tick step and/or template will be selected. You can use mgl_get_time() function for obtaining number of second for given date/time string. Note, that MS Visual Studio couldn't handle date before 1970.
|
542
|
+
# @overload set_ticks_time(dir,val,templ)
|
543
|
+
# @param [String] dir
|
544
|
+
# @param [Float] val
|
545
|
+
# @param [String] templ
|
546
|
+
# @return [nil]
|
547
|
+
def set_ticks_time
|
548
|
+
end
|
549
|
+
|
550
|
+
|
551
|
+
# Ticks.
|
552
|
+
# Switch on/off ticks enhancing by factoring common multiplier (for small, like from 0.001 to 0.002, or large, like from 1000 to 2000, coordinate values -- enabled if tune&1 is nonzero) or common component (for narrow range, like from 0.999 to 1.000 -- enabled if tune&2 is nonzero). Also set the position pos of common multiplier/component on the axis: =0 at minimal axis value, =1 at maximal axis value. Default value is 1.15.
|
553
|
+
# @overload set_tune_ticks(tune,pos=1.15)
|
554
|
+
# @param [Integer] tune
|
555
|
+
# @param [Float] pos default=1.15
|
556
|
+
# @return [nil]
|
557
|
+
def set_tune_ticks
|
558
|
+
end
|
559
|
+
|
560
|
+
|
561
|
+
# Ticks.
|
562
|
+
# Set value of additional shift for ticks labels.
|
563
|
+
# @overload set_tick_shift(d)
|
564
|
+
# @param [MglPoint] d
|
565
|
+
# @return [nil]
|
566
|
+
def set_tick_shift
|
567
|
+
end
|
568
|
+
|
569
|
+
|
570
|
+
# Ticks.
|
571
|
+
# Enable/disable ticks rotation if there are too many ticks or ticks labels are too long.
|
572
|
+
# @overload set_tick_rotate(val)
|
573
|
+
# @param [bool] val
|
574
|
+
# @return [nil]
|
575
|
+
def set_tick_rotate
|
576
|
+
end
|
577
|
+
|
578
|
+
|
579
|
+
# Ticks.
|
580
|
+
# Enable/disable ticks skipping if there are too many ticks or ticks labels are too long.
|
581
|
+
# @overload set_tick_skip(val)
|
582
|
+
# @param [bool] val
|
583
|
+
# @return [nil]
|
584
|
+
def set_tick_skip
|
585
|
+
end
|
586
|
+
|
587
|
+
|
588
|
+
# Ticks.
|
589
|
+
#
|
590
|
+
# Enable/disable using UTC time for ticks labels. In C/Fortran you can use mgl_set_flag(gr,val, MGL_USE_GMTIME);.
|
591
|
+
# @overload set_time_utc(val)
|
592
|
+
# @param [bool] val
|
593
|
+
# @return [nil]
|
594
|
+
def set_time_utc
|
595
|
+
end
|
596
|
+
|
597
|
+
|
598
|
+
# Ticks.
|
599
|
+
# Enable/disable drawing of ticks labels at axis origin. In C/Fortran you can use mgl_set_flag(gr,val, MGL_NO_ORIGIN);.
|
600
|
+
# @overload set_origin_tick(val=true)
|
601
|
+
# @param [bool] val default=true
|
602
|
+
# @return [nil]
|
603
|
+
def set_origin_tick
|
604
|
+
end
|
605
|
+
|
606
|
+
|
607
|
+
# Ticks.
|
608
|
+
# The relative length of axis ticks. Default value is 0.1. Parameter stt>0 set relative length of subticks which is in sqrt(1+stt) times smaller.
|
609
|
+
# @overload set_tick_len(val,stt=1)
|
610
|
+
# @param [Float] val
|
611
|
+
# @param [Float] stt default=1
|
612
|
+
# @return [nil]
|
613
|
+
def set_tick_len
|
614
|
+
end
|
615
|
+
|
616
|
+
|
617
|
+
# Ticks.
|
618
|
+
# The line style of axis (stl), ticks (tck) and subticks (sub). If stl is empty then default style is used ( or depending on transparency type). If tck or sub is empty then axis style is used (i.e. stl).
|
619
|
+
# @overload set_axis_stl(stl="k",tck=0,sub=0)
|
620
|
+
# @param [String] stl default="k"
|
621
|
+
# @param [String] tck default=0
|
622
|
+
# @param [String] sub default=0
|
623
|
+
# @return [nil]
|
624
|
+
def set_axis_stl
|
625
|
+
end
|
626
|
+
|
627
|
+
|
628
|
+
# Subplots and rotation.
|
629
|
+
# Puts further plotting in a m-th cell of nx*ny grid of the whole frame area. This function set off any aspects or rotations. So it should be used first for creating the subplot. Extra space will be reserved for axis/colorbar if stl contain:
|
630
|
+
# From the aesthetical point of view it is not recommended to use this function with different matrices in the same frame. The position of the cell can be shifted from its default position by relative size dx, dy.
|
631
|
+
# @overload sub_plot(nx,ny,m,stl="<>_^",dx=0,dy=0)
|
632
|
+
# @param [Integer] nx
|
633
|
+
# @param [Integer] ny
|
634
|
+
# @param [Integer] m
|
635
|
+
# @param [String] stl default="<>_^"
|
636
|
+
# @param [Float] dx default=0
|
637
|
+
# @param [Float] dy default=0
|
638
|
+
# @return [nil]
|
639
|
+
def sub_plot
|
640
|
+
end
|
641
|
+
|
642
|
+
|
643
|
+
# Subplots and rotation.
|
644
|
+
# Puts further plotting in a rectangle of dx*dy cells starting from m-th cell of nx*ny grid of the whole frame area. This function set off any aspects or rotations. So it should be used first for creating subplot. Extra space will be reserved for axis/colorbar if stl contain:
|
645
|
+
# @overload multi_plot(nx,ny,m,dx,dy,stl="<>_^")
|
646
|
+
# @param [Integer] nx
|
647
|
+
# @param [Integer] ny
|
648
|
+
# @param [Integer] m
|
649
|
+
# @param [Integer] dx
|
650
|
+
# @param [Integer] dy
|
651
|
+
# @param [String] stl default="<>_^"
|
652
|
+
# @return [nil]
|
653
|
+
def multi_plot
|
654
|
+
end
|
655
|
+
|
656
|
+
|
657
|
+
# Subplots and rotation.
|
658
|
+
# Puts further plotting in some region of the whole frame surface. This function allows one to create a plot in arbitrary place of the screen. The position is defined by rectangular coordinates [x1, x2]*[y1, y2]. The coordinates x1, x2, y1, y2 are normalized to interval [0, 1]. If parameter rel=true then the relative position to current subplot (or inplot with rel=false) is used. This function set off any aspects or rotations. So it should be used first for creating subplot.
|
659
|
+
# @overload in_plot(x1,x2,y1,y2,rel=true)
|
660
|
+
# @param [Float] x1
|
661
|
+
# @param [Float] x2
|
662
|
+
# @param [Float] y1
|
663
|
+
# @param [Float] y2
|
664
|
+
# @param [bool] rel default=true
|
665
|
+
# @return [nil]
|
666
|
+
def in_plot
|
667
|
+
end
|
668
|
+
|
669
|
+
|
670
|
+
# Subplots and rotation.
|
671
|
+
# Puts further plotting in ind-th cell of column with num cells. The position is relative to previous subplot (or inplot with rel=false). Parameter d set extra gap between cells.
|
672
|
+
# @overload column_plot(num,ind,d=0)
|
673
|
+
# @param [Integer] num
|
674
|
+
# @param [Integer] ind
|
675
|
+
# @param [Float] d default=0
|
676
|
+
# @return [nil]
|
677
|
+
def column_plot
|
678
|
+
end
|
679
|
+
|
680
|
+
|
681
|
+
# Subplots and rotation.
|
682
|
+
# Puts further plotting in ind-th cell of nx*ny grid. The position is relative to previous subplot (or inplot with rel=false). Parameter d set extra gap between cells.
|
683
|
+
# @overload grid_plot(nx,ny,ind,d=0)
|
684
|
+
# @param [Integer] nx
|
685
|
+
# @param [Integer] ny
|
686
|
+
# @param [Integer] ind
|
687
|
+
# @param [Float] d default=0
|
688
|
+
# @return [nil]
|
689
|
+
def grid_plot
|
690
|
+
end
|
691
|
+
|
692
|
+
|
693
|
+
# Subplots and rotation.
|
694
|
+
# Puts further plotting in ind-th cell of stick with num cells. At this, stick is rotated on angles tet, phi. The position is relative to previous subplot (or inplot with rel=false).
|
695
|
+
# @overload stick_plot(num,ind,tet,phi)
|
696
|
+
# @param [Integer] num
|
697
|
+
# @param [Integer] ind
|
698
|
+
# @param [Float] tet
|
699
|
+
# @param [Float] phi
|
700
|
+
# @return [nil]
|
701
|
+
def stick_plot
|
702
|
+
end
|
703
|
+
|
704
|
+
|
705
|
+
# Subplots and rotation.
|
706
|
+
# Add text title for current subplot/inplot. Paramater stl can contain:
|
707
|
+
# Parameter size set font size. This function set off any aspects or rotations. So it should be used just after creating subplot.
|
708
|
+
# @overload title(txt,stl="",size=-2)
|
709
|
+
# @param [String] txt
|
710
|
+
# @param [String] stl default=""
|
711
|
+
# @param [Float] size default=-2
|
712
|
+
# @return [nil]
|
713
|
+
def title
|
714
|
+
end
|
715
|
+
|
716
|
+
|
717
|
+
# Subplots and rotation.
|
718
|
+
# Rotates a further plotting relative to each axis (x, z, y) consecutively on angles TetX, TetZ, TetY.
|
719
|
+
# @overload rotate(tetx,tetz,tety=0)
|
720
|
+
# @param [Float] tetx
|
721
|
+
# @param [Float] tetz
|
722
|
+
# @param [Float] tety default=0
|
723
|
+
# @return [nil]
|
724
|
+
def rotate
|
725
|
+
end
|
726
|
+
|
727
|
+
|
728
|
+
# Subplots and rotation.
|
729
|
+
# Rotates a further plotting around vector (x, y, z) on angle Tet.
|
730
|
+
# @overload rotate_n(tet,x,y,z)
|
731
|
+
# @param [Float] tet
|
732
|
+
# @param [Float] x
|
733
|
+
# @param [Float] y
|
734
|
+
# @param [Float] z
|
735
|
+
# @return [nil]
|
736
|
+
def rotate_n
|
737
|
+
end
|
738
|
+
|
739
|
+
|
740
|
+
# Subplots and rotation.
|
741
|
+
# Defines aspect ratio for the plot. The viewable axes will be related one to another as the ratio Ax:Ay:Az. For the best effect it should be used after rotate function. If Ax is NAN then function try to select optimal aspect ratio to keep equal ranges for x-y axis. At this, Ay will specify proportionality factor, or set to use automatic one if Ay=NAN.
|
742
|
+
# @overload aspect(ax,ay,az=1)
|
743
|
+
# @param [Float] ax
|
744
|
+
# @param [Float] ay
|
745
|
+
# @param [Float] az default=1
|
746
|
+
# @return [nil]
|
747
|
+
def aspect
|
748
|
+
end
|
749
|
+
|
750
|
+
|
751
|
+
# Subplots and rotation.
|
752
|
+
# Add (switch on) the perspective to plot. The parameter \in [0,1)}. By default (a=0) the perspective is off.
|
753
|
+
# @overload perspective(a)
|
754
|
+
# @param [Float] a
|
755
|
+
# @return [nil]
|
756
|
+
def perspective
|
757
|
+
end
|
758
|
+
|
759
|
+
|
760
|
+
# Subplots and rotation.
|
761
|
+
# Push transformation matrix into stack. Later you can restore its current state by Pop() function.
|
762
|
+
# @overload push()
|
763
|
+
# @return [nil]
|
764
|
+
def push
|
765
|
+
end
|
766
|
+
|
767
|
+
|
768
|
+
# Subplots and rotation.
|
769
|
+
# Pop (restore last 'pushed') transformation matrix into stack.
|
770
|
+
# @overload pop()
|
771
|
+
# @return [nil]
|
772
|
+
def pop
|
773
|
+
end
|
774
|
+
|
775
|
+
|
776
|
+
# Subplots and rotation.
|
777
|
+
# Sets the factor of plot size. It is not recommended to set it lower then 1.5. This is some analogue of function Zoom() but applied not to overall image but for each InPlot. Use negative value or zero to enable automatic selection.
|
778
|
+
# @overload set_plot_factor(val)
|
779
|
+
# @param [Float] val
|
780
|
+
# @return [nil]
|
781
|
+
def set_plot_factor
|
782
|
+
end
|
783
|
+
|
784
|
+
|
785
|
+
# Subplots and rotation.
|
786
|
+
# Rotates a further plotting relative to each axis (x, z, y) consecutively on angles TetX, TetZ, TetY. Rotation is done independently on rotate. Attention! this settings can not be overwritten by DefaultPlotParam(). Use Zoom(0,0,1,1) to return default view.
|
787
|
+
# @overload view(tetx,tetz,tety=0)
|
788
|
+
# @param [Float] tetx
|
789
|
+
# @param [Float] tetz
|
790
|
+
# @param [Float] tety default=0
|
791
|
+
# @return [nil]
|
792
|
+
def view
|
793
|
+
end
|
794
|
+
|
795
|
+
|
796
|
+
# Subplots and rotation.
|
797
|
+
# The function changes the scale of graphics that correspond to zoom in/out of the picture. After function call the current plot will be cleared and further the picture will contain plotting from its part [x1,x2]*[y1,y2]. Here picture coordinates x1, x2, y1, y2 changes from 0 to 1. Attention! this settings can not be overwritten by any other functions, including DefaultPlotParam(). Use Zoom(0,0,1,1) to return default view.
|
798
|
+
# @overload zoom(x1,y1,x2,y2)
|
799
|
+
# @param [Float] x1
|
800
|
+
# @param [Float] y1
|
801
|
+
# @param [Float] x2
|
802
|
+
# @param [Float] y2
|
803
|
+
# @return [nil]
|
804
|
+
def zoom
|
805
|
+
end
|
806
|
+
|
807
|
+
|
808
|
+
# Export picture.
|
809
|
+
# Sets size of picture in pixels. This function called before any other plotting because it completely remove picture contents.
|
810
|
+
# @overload set_size(width,height)
|
811
|
+
# @param [Integer] width
|
812
|
+
# @param [Integer] height
|
813
|
+
# @return [nil]
|
814
|
+
def set_size
|
815
|
+
end
|
816
|
+
|
817
|
+
|
818
|
+
# Export picture.
|
819
|
+
# Sets quality of the plot depending on value val: MGL_DRAW_WIRE=0 -- no face drawing (fastest), MGL_DRAW_FAST=1 -- no color interpolation (fast), MGL_DRAW_NORM=2 -- high quality (normal), MGL_DRAW_HIGH=3 -- high quality with 3d primitives (arrows and marks). If MGL_DRAW_LMEM=0x4 is set then direct bitmap drawing is used (low memory usage).
|
820
|
+
# @overload set_quality(val=MGL_DRAW_NORM)
|
821
|
+
# @param [Integer] val default=MGL_DRAW_NORM
|
822
|
+
# @return [nil]
|
823
|
+
def set_quality
|
824
|
+
end
|
825
|
+
|
826
|
+
|
827
|
+
# Export picture.
|
828
|
+
# Gets quality of the plot: MGL_DRAW_WIRE=0 -- no face drawing (fastest), MGL_DRAW_FAST=1 -- no color interpolation (fast), MGL_DRAW_NORM=2 -- high quality (normal), MGL_DRAW_HIGH=3 -- high quality with 3d primitives (arrows and marks). If MGL_DRAW_LMEM=0x4 is set then direct bitmap drawing is used (low memory usage).
|
829
|
+
# @overload get_quality()
|
830
|
+
# @return [Integer]
|
831
|
+
def get_quality
|
832
|
+
end
|
833
|
+
|
834
|
+
|
835
|
+
# Export picture.
|
836
|
+
# Starts group definition. Groups contain objects and other groups, they are used to select a part of a model to zoom to or to make invizible or to make semitransparent and so on.
|
837
|
+
# @overload start_group(name)
|
838
|
+
# @param [String] name
|
839
|
+
# @return [nil]
|
840
|
+
def start_group
|
841
|
+
end
|
842
|
+
|
843
|
+
|
844
|
+
# Export picture.
|
845
|
+
# Ends group definition.
|
846
|
+
# @overload end_group()
|
847
|
+
# @return [nil]
|
848
|
+
def end_group
|
849
|
+
end
|
850
|
+
|
851
|
+
|
852
|
+
# Export to file.
|
853
|
+
# Exports current frame to a file fname which type is determined by the extension. Parameter descr adds description to file (can be ""). If fname="" then the file is used, where is current frame id and name is defined by plotid class property.
|
854
|
+
# @overload write_frame(fname="",descr="")
|
855
|
+
# @param [String] fname default=""
|
856
|
+
# @param [String] descr default=""
|
857
|
+
# @return [nil]
|
858
|
+
def write_frame
|
859
|
+
end
|
860
|
+
|
861
|
+
|
862
|
+
# Export to file.
|
863
|
+
# Exports current frame to PNG file. Parameter fname specifies the file name, descr adds description to file, alpha gives the transparency type. By default there are no description added and semitransparent image used. This function does nothing if HAVE_PNG isn't defined during compilation of MathGL library.
|
864
|
+
# @overload write_png(fname,descr="",compr="",alpha=true)
|
865
|
+
# @param [String] fname
|
866
|
+
# @param [String] descr default=""
|
867
|
+
# @param [Integer] compr default=""
|
868
|
+
# @param [bool] alpha default=true
|
869
|
+
# @return [nil]
|
870
|
+
def write_png
|
871
|
+
end
|
872
|
+
|
873
|
+
|
874
|
+
# Export to file.
|
875
|
+
# Exports current frame to JPEG file. Parameter fname specifies the file name, descr adds description to file. By default there is no description added. This function does nothing if HAVE_JPEG isn't defined during compilation of MathGL library.
|
876
|
+
# @overload write_jpeg(fname,descr="")
|
877
|
+
# @param [String] fname
|
878
|
+
# @param [String] descr default=""
|
879
|
+
# @return [nil]
|
880
|
+
def write_jpeg
|
881
|
+
end
|
882
|
+
|
883
|
+
|
884
|
+
# Export to file.
|
885
|
+
# Exports current frame to GIF file. Parameter fname specifies the file name, descr adds description to file. By default there is no description added. This function does nothing if HAVE_GIF isn't defined during compilation of MathGL library.
|
886
|
+
# @overload write_gif(fname,descr="")
|
887
|
+
# @param [String] fname
|
888
|
+
# @param [String] descr default=""
|
889
|
+
# @return [nil]
|
890
|
+
def write_gif
|
891
|
+
end
|
892
|
+
|
893
|
+
|
894
|
+
# Export to file.
|
895
|
+
# Exports current frame to BMP file. Parameter fname specifies the file name, descr adds description to file. There is no compression used.
|
896
|
+
# @overload write_bmp(fname,descr="")
|
897
|
+
# @param [String] fname
|
898
|
+
# @param [String] descr default=""
|
899
|
+
# @return [nil]
|
900
|
+
def write_bmp
|
901
|
+
end
|
902
|
+
|
903
|
+
|
904
|
+
# Export to file.
|
905
|
+
# Exports current frame to TGA file. Parameter fname specifies the file name, descr adds description to file. There is no compression used.
|
906
|
+
# @overload write_tga(fname,descr="")
|
907
|
+
# @param [String] fname
|
908
|
+
# @param [String] descr default=""
|
909
|
+
# @return [nil]
|
910
|
+
def write_tga
|
911
|
+
end
|
912
|
+
|
913
|
+
|
914
|
+
# Export to file.
|
915
|
+
# Exports current frame to EPS file using vector representation. So it is not recommended for the export of large data plot. It is better to use bitmap format (for example PNG or JPEG). However, program has no internal limitations for size of output file. Parameter fname specifies the file name, descr adds description to file. By default there is no description added. If file name is terminated by (for example, ) then file will be compressed in gzip format.
|
916
|
+
# @overload write_eps(fname,descr="")
|
917
|
+
# @param [String] fname
|
918
|
+
# @param [String] descr default=""
|
919
|
+
# @return [nil]
|
920
|
+
def write_eps
|
921
|
+
end
|
922
|
+
|
923
|
+
|
924
|
+
# Export to file.
|
925
|
+
# Exports current frame to EPS file using bitmap representation. Parameter fname specifies the file name, descr adds description to file. By default there is no description added. If file name is terminated by (for example, ) then file will be compressed in gzip format.
|
926
|
+
# @overload write_bps(fname,descr="")
|
927
|
+
# @param [String] fname
|
928
|
+
# @param [String] descr default=""
|
929
|
+
# @return [nil]
|
930
|
+
def write_bps
|
931
|
+
end
|
932
|
+
|
933
|
+
|
934
|
+
# Export to file.
|
935
|
+
# Exports current frame to SVG (Scalable Vector Graphics) file using vector representation. In difference of EPS format, SVG format support transparency that allows to correctly draw semitransparent plot (like surfa, surf3a or cloud). Note, the output file may be too large for graphic of large data array (especially for surfaces). It is better to use bitmap format (for example PNG or JPEG). However, program has no internal limitations for size of output file. Parameter fname specifies the file name, descr adds description to file (default is file name). If file name is terminated by (for example, ) then file will be compressed in gzip format.
|
936
|
+
# @overload write_svg(fname,descr="")
|
937
|
+
# @param [String] fname
|
938
|
+
# @param [String] descr default=""
|
939
|
+
# @return [nil]
|
940
|
+
def write_svg
|
941
|
+
end
|
942
|
+
|
943
|
+
|
944
|
+
# Export to file.
|
945
|
+
# Exports current frame to LaTeX (package Tikz/PGF) file using vector representation. Note, the output file may be too large for graphic of large data array (especially for surfaces). It is better to use bitmap format (for example PNG or JPEG). However, program has no internal limitations for size of output file. Parameter fname specifies the file name, descr adds description to file (default is file name). Note, there is no text scaling now (for example, in subplots), what may produce miss-aligned labels.
|
946
|
+
# @overload write_tex(fname,descr="")
|
947
|
+
# @param [String] fname
|
948
|
+
# @param [String] descr default=""
|
949
|
+
# @return [nil]
|
950
|
+
def write_tex
|
951
|
+
end
|
952
|
+
|
953
|
+
|
954
|
+
# Export to file.
|
955
|
+
# Exports current frame to PRC file using vector representation (see ). Note, the output file may be too large for graphic of large data array (especially for surfaces). It is better to use bitmap format (for example PNG or JPEG). However, program has no internal limitations for size of output file. Parameter fname specifies the file name, descr adds description to file (default is file name). If parameter make_pdf=true and PDF was enabled at MathGL configure then corresponding PDF file with 3D image will be created.
|
956
|
+
# @overload write_prc(fname,descr="",make_pdf=true)
|
957
|
+
# @param [String] fname
|
958
|
+
# @param [String] descr default=""
|
959
|
+
# @param [bool] make_pdf default=true
|
960
|
+
# @return [nil]
|
961
|
+
def write_prc
|
962
|
+
end
|
963
|
+
|
964
|
+
|
965
|
+
# Export to file.
|
966
|
+
# Exports current frame to OBJ/MTL file using vector representation (see for details). Note, the output file may be too large for graphic of large data array (especially for surfaces). It is better to use bitmap format (for example PNG or JPEG). However, program has no internal limitations for size of output file. Parameter fname specifies the file name, descr adds description to file (default is file name).
|
967
|
+
# @overload write_obj(fname,descr="")
|
968
|
+
# @param [String] fname
|
969
|
+
# @param [String] descr default=""
|
970
|
+
# @return [nil]
|
971
|
+
def write_obj
|
972
|
+
end
|
973
|
+
|
974
|
+
|
975
|
+
# Export to file.
|
976
|
+
# Exports current frame to XYZ/XYZL/XYZF files using vector representation (see for details). Note, the output file may be too large for graphic of large data array (especially for surfaces). It is better to use bitmap format (for example PNG or JPEG). However, program has no internal limitations for size of output file. Parameter fname specifies the file name, descr adds description to file (default is file name).
|
977
|
+
# @overload write_xyz(fname,descr="")
|
978
|
+
# @param [String] fname
|
979
|
+
# @param [String] descr default=""
|
980
|
+
# @return [nil]
|
981
|
+
def write_xyz
|
982
|
+
end
|
983
|
+
|
984
|
+
|
985
|
+
# Export to file.
|
986
|
+
# Exports current frame to STL file using vector representation (see for details). Note, the output file may be too large for graphic of large data array (especially for surfaces). It is better to use bitmap format (for example PNG or JPEG). However, program has no internal limitations for size of output file. Parameter fname specifies the file name, descr adds description to file (default is file name.
|
987
|
+
# @overload write_stl(fname,descr="")
|
988
|
+
# @param [String] fname
|
989
|
+
# @param [String] descr default=""
|
990
|
+
# @return [nil]
|
991
|
+
def write_stl
|
992
|
+
end
|
993
|
+
|
994
|
+
|
995
|
+
# Export to file.
|
996
|
+
# Exports current frame to OFF file using vector representation (see for details). Note, the output file may be too large for graphic of large data array (especially for surfaces). It is better to use bitmap format (for example PNG or JPEG). However, program has no internal limitations for size of output file. Parameter fname specifies the file name, descr adds description to file (default is file name).
|
997
|
+
# @overload write_off(fname,descr="",colored=false)
|
998
|
+
# @param [String] fname
|
999
|
+
# @param [String] descr default=""
|
1000
|
+
# @param [bool] colored default=false
|
1001
|
+
# @return [nil]
|
1002
|
+
def write_off
|
1003
|
+
end
|
1004
|
+
|
1005
|
+
|
1006
|
+
# Export to file.
|
1007
|
+
# Displays the current picture using external program viewer for viewing. The function save the picture to temporary file and call viewer to display it. If nowait=true then the function return immediately (it will not wait while window will be closed).
|
1008
|
+
# @overload show_image(viewer,nowait=false)
|
1009
|
+
# @param [String] viewer
|
1010
|
+
# @param [bool] nowait default=false
|
1011
|
+
# @return [nil]
|
1012
|
+
def show_image
|
1013
|
+
end
|
1014
|
+
|
1015
|
+
|
1016
|
+
# Export to file.
|
1017
|
+
# Exports current frame to textual file using JSON format. Later this file can be used for faster loading and viewing by JavaScript script. Parameter fname specifies the file name, descr adds description to file.
|
1018
|
+
# @overload write_json(fname,descr="")
|
1019
|
+
# @param [String] fname
|
1020
|
+
# @param [String] descr default=""
|
1021
|
+
# @return [nil]
|
1022
|
+
def write_json
|
1023
|
+
end
|
1024
|
+
|
1025
|
+
|
1026
|
+
# Export to file.
|
1027
|
+
# Exports points and primitives in file using MGLD format. Later this file can be used for faster loading and viewing by mglview utility. Parameter fname specifies the file name, descr adds description to file (default is file name).
|
1028
|
+
# @overload export_mgld(fname,descr="")
|
1029
|
+
# @param [String] fname
|
1030
|
+
# @param [String] descr default=""
|
1031
|
+
# @return [nil]
|
1032
|
+
def export_mgld
|
1033
|
+
end
|
1034
|
+
|
1035
|
+
|
1036
|
+
# Export to file.
|
1037
|
+
# Imports points and primitives in file using MGLD format. Later this file can be used for faster loading and viewing by mglview utility. Parameter fname specifies the file name, add sets to append or replace primitives to existed ones.
|
1038
|
+
# @overload import_mgld(fname,add=false)
|
1039
|
+
# @param [String] fname
|
1040
|
+
# @param [bool] add default=false
|
1041
|
+
# @return [nil]
|
1042
|
+
def import_mgld
|
1043
|
+
end
|
1044
|
+
|
1045
|
+
|
1046
|
+
# Frames/Animation.
|
1047
|
+
# Creates new frame. Function returns current frame id. This is not thread safe function in OpenGL mode! Use direct list creation in multi-threading drawing. The function EndFrame() be call after the finishing of the frame drawing for each call of this function.
|
1048
|
+
# @overload new_frame()
|
1049
|
+
# @return [nil]
|
1050
|
+
def new_frame
|
1051
|
+
end
|
1052
|
+
|
1053
|
+
|
1054
|
+
# Frames/Animation.
|
1055
|
+
# Finishes the frame drawing.
|
1056
|
+
# @overload end_frame()
|
1057
|
+
# @return [nil]
|
1058
|
+
def end_frame
|
1059
|
+
end
|
1060
|
+
|
1061
|
+
|
1062
|
+
# Frames/Animation.
|
1063
|
+
# Gets the number of created frames.
|
1064
|
+
# @overload get_num_frame()
|
1065
|
+
# @return [Integer]
|
1066
|
+
def get_num_frame
|
1067
|
+
end
|
1068
|
+
|
1069
|
+
|
1070
|
+
# Frames/Animation.
|
1071
|
+
# Finishes the frame drawing and sets drawing data to frame i, which should be in range [0, GetNumFrame()-1]. This function is similar to EndFrame() but don't add frame to the GIF image.
|
1072
|
+
# @overload set_frame(i)
|
1073
|
+
# @param [Integer] i
|
1074
|
+
# @return [nil]
|
1075
|
+
def set_frame
|
1076
|
+
end
|
1077
|
+
|
1078
|
+
|
1079
|
+
# Frames/Animation.
|
1080
|
+
# Replaces drawing data by one from frame i. Function work if MGL_VECT_FRAME is set on (by default).
|
1081
|
+
# @overload get_frame(i)
|
1082
|
+
# @param [Integer] i
|
1083
|
+
# @return [nil]
|
1084
|
+
def get_frame
|
1085
|
+
end
|
1086
|
+
|
1087
|
+
|
1088
|
+
# Frames/Animation.
|
1089
|
+
# Appends drawing data from frame i to current one. Function work if MGL_VECT_FRAME is set on (by default).
|
1090
|
+
# @overload show_frame(i)
|
1091
|
+
# @param [Integer] i
|
1092
|
+
# @return [nil]
|
1093
|
+
def show_frame
|
1094
|
+
end
|
1095
|
+
|
1096
|
+
|
1097
|
+
# Frames/Animation.
|
1098
|
+
# Deletes drawing data for frame i and shift all later frame indexes. Function work if MGL_VECT_FRAME is set on (by default). Do nothing in OpenGL mode.
|
1099
|
+
# @overload del_frame(i)
|
1100
|
+
# @param [Integer] i
|
1101
|
+
# @return [nil]
|
1102
|
+
def del_frame
|
1103
|
+
end
|
1104
|
+
|
1105
|
+
|
1106
|
+
# Frames/Animation.
|
1107
|
+
# Reset frames counter (start it from zero).
|
1108
|
+
# @overload reset_frames()
|
1109
|
+
# @return [nil]
|
1110
|
+
def reset_frames
|
1111
|
+
end
|
1112
|
+
|
1113
|
+
|
1114
|
+
# Frames/Animation.
|
1115
|
+
# Start writing frames into animated GIF file fname. Parameter ms set the delay between frames in milliseconds. You change the picture size during writing the cinema. Use CloseGIF() to finalize writing. Note, that this function is disabled in OpenGL mode.
|
1116
|
+
# @overload start_gif(fname,ms=100)
|
1117
|
+
# @param [String] fname
|
1118
|
+
# @param [Integer] ms default=100
|
1119
|
+
# @return [nil]
|
1120
|
+
def start_gif
|
1121
|
+
end
|
1122
|
+
|
1123
|
+
|
1124
|
+
# Frames/Animation.
|
1125
|
+
# Finish writing animated GIF and close connected pointers.
|
1126
|
+
# @overload close_gif()
|
1127
|
+
# @return [nil]
|
1128
|
+
def close_gif
|
1129
|
+
end
|
1130
|
+
|
1131
|
+
|
1132
|
+
# Bitmap in memory.
|
1133
|
+
# Gets RGB bitmap of the current state of the image. Format of each element of bits is: (red, green, blue). Number of elements is Width*Height. Position of element (i,j) is [3*i + 3*Width*j] (or is [4*i + 4*Width*j] for GetBGRN()). You have to provide the proper size of the buffer, buf, i.e. the code for Python should look like
|
1134
|
+
# @overload get_rgb()
|
1135
|
+
# @return [unsigned char]
|
1136
|
+
# @overload get_rgb(buf,size)
|
1137
|
+
# @param [String] buf
|
1138
|
+
# @param [Integer] size
|
1139
|
+
# @return [nil]
|
1140
|
+
# @overload get_bgrn(buf,size)
|
1141
|
+
# @param [String] buf
|
1142
|
+
# @param [Integer] size
|
1143
|
+
# @return [nil]
|
1144
|
+
def get_bgrn
|
1145
|
+
end
|
1146
|
+
|
1147
|
+
|
1148
|
+
# Bitmap in memory.
|
1149
|
+
# Gets RGBA bitmap of the current state of the image. Format of each element of bits is: (red, green, blue, alpha). Number of elements is Width*Height. Position of element (i,j) is [4*i + 4*Width*j].
|
1150
|
+
# @overload get_rgba()
|
1151
|
+
# @return [unsigned char]
|
1152
|
+
# @overload get_rgba(buf,size)
|
1153
|
+
# @param [String] buf
|
1154
|
+
# @param [Integer] size
|
1155
|
+
# @return [nil]
|
1156
|
+
def get_rgba
|
1157
|
+
end
|
1158
|
+
|
1159
|
+
|
1160
|
+
# Bitmap in memory.
|
1161
|
+
# Gets width and height of the image.
|
1162
|
+
# @overload get_width()
|
1163
|
+
# @return [Integer]
|
1164
|
+
# @overload get_height()
|
1165
|
+
# @return [Integer]
|
1166
|
+
def get_height
|
1167
|
+
end
|
1168
|
+
|
1169
|
+
|
1170
|
+
# Bitmap in memory.
|
1171
|
+
# Calculate 3D coordinate (x,y,z) for screen point (xs,ys). At this moment it ignore perspective and transformation formulas (curvilinear coordinates). The calculation are done for the last used InPlot (see Subplots and rotation).
|
1172
|
+
# @overload calc_xyz(xs,ys)
|
1173
|
+
# @param [Integer] xs
|
1174
|
+
# @param [Integer] ys
|
1175
|
+
# @return [MglPoint]
|
1176
|
+
def calc_xyz
|
1177
|
+
end
|
1178
|
+
|
1179
|
+
|
1180
|
+
# Bitmap in memory.
|
1181
|
+
# Calculate screen point (xs,ys) for 3D coordinate (x,y,z). The calculation are done for the last used InPlot (see Subplots and rotation).
|
1182
|
+
# @overload calc_scr(p)
|
1183
|
+
# @param [MglPoint] p
|
1184
|
+
# @return [MglPoint]
|
1185
|
+
def calc_scr
|
1186
|
+
end
|
1187
|
+
|
1188
|
+
|
1189
|
+
# Bitmap in memory.
|
1190
|
+
# Set the numeric id for object or subplot/inplot.
|
1191
|
+
# @overload set_obj_id(id)
|
1192
|
+
# @param [Integer] id
|
1193
|
+
# @return [nil]
|
1194
|
+
def set_obj_id
|
1195
|
+
end
|
1196
|
+
|
1197
|
+
|
1198
|
+
# Bitmap in memory.
|
1199
|
+
# Get the numeric id for most upper object at pixel (xs, ys) of the picture.
|
1200
|
+
# @overload get_obj_id(xs,ys)
|
1201
|
+
# @param [Integer] xs
|
1202
|
+
# @param [Integer] ys
|
1203
|
+
# @return [Integer]
|
1204
|
+
def get_obj_id
|
1205
|
+
end
|
1206
|
+
|
1207
|
+
|
1208
|
+
# Bitmap in memory.
|
1209
|
+
# Get the numeric id for most subplot/inplot at pixel (xs, ys) of the picture.
|
1210
|
+
# @overload get_spl_id(xs,ys)
|
1211
|
+
# @param [Integer] xs
|
1212
|
+
# @param [Integer] ys
|
1213
|
+
# @return [Integer]
|
1214
|
+
def get_spl_id
|
1215
|
+
end
|
1216
|
+
|
1217
|
+
|
1218
|
+
# Bitmap in memory.
|
1219
|
+
# Highlight the object with given id.
|
1220
|
+
# @overload highlight(id)
|
1221
|
+
# @param [Integer] id
|
1222
|
+
# @return [nil]
|
1223
|
+
def highlight
|
1224
|
+
end
|
1225
|
+
|
1226
|
+
|
1227
|
+
# Bitmap in memory.
|
1228
|
+
# Checks if point (xs, ys) is close to one of active point (i.e. mglBase::Act) with accuracy d and return its index or -1 if not found. Active points are special points which characterize primitives (like edges and so on). This function for advanced users only.
|
1229
|
+
# @overload is_active(xs,ys,d=1)
|
1230
|
+
# @param [Integer] xs
|
1231
|
+
# @param [Integer] ys
|
1232
|
+
# @param [Integer] d default=1
|
1233
|
+
# @return [long]
|
1234
|
+
def is_active
|
1235
|
+
end
|
1236
|
+
|
1237
|
+
|
1238
|
+
# Parallelization.
|
1239
|
+
# Combine drawing from instance g with gr (or with this) taking into account Z-ordering of pixels. The width and height of both instances must be the same.
|
1240
|
+
# @overload combine(g)
|
1241
|
+
# @param [MglGraph] g
|
1242
|
+
# @return [Integer]
|
1243
|
+
def combine
|
1244
|
+
end
|
1245
|
+
|
1246
|
+
|
1247
|
+
# Parallelization.
|
1248
|
+
# Send graphical information from node id using MPI. The width and height in both nodes must be the same.
|
1249
|
+
# @overload mpi_send(id)
|
1250
|
+
# @param [Integer] id
|
1251
|
+
# @return [Integer]
|
1252
|
+
def mpi_send
|
1253
|
+
end
|
1254
|
+
|
1255
|
+
|
1256
|
+
# Parallelization.
|
1257
|
+
# Receive graphical information from node id using MPI. The width and height in both nodes must be the same.
|
1258
|
+
# @overload mpi_recv(id)
|
1259
|
+
# @param [Integer] id
|
1260
|
+
# @return [Integer]
|
1261
|
+
def mpi_recv
|
1262
|
+
end
|
1263
|
+
|
1264
|
+
|
1265
|
+
# Primitives.
|
1266
|
+
# Clear the picture and fill it by color specified color.
|
1267
|
+
# @overload clf()
|
1268
|
+
# @return [nil]
|
1269
|
+
# @overload clf(r,g,b)
|
1270
|
+
# @param [Float] r
|
1271
|
+
# @param [Float] g
|
1272
|
+
# @param [Float] b
|
1273
|
+
# @return [nil]
|
1274
|
+
def clf
|
1275
|
+
end
|
1276
|
+
|
1277
|
+
|
1278
|
+
# Primitives.
|
1279
|
+
# Draws a mark (point by default) at position p=(x, y, z) with color col.
|
1280
|
+
# @overload ball(p,col='r')
|
1281
|
+
# @param [MglPoint] p
|
1282
|
+
# @param [String] col default='r'
|
1283
|
+
# @return [nil]
|
1284
|
+
# @overload mark(p,mark)
|
1285
|
+
# @param [MglPoint] p
|
1286
|
+
# @param [String] mark
|
1287
|
+
# @return [nil]
|
1288
|
+
def mark
|
1289
|
+
end
|
1290
|
+
|
1291
|
+
|
1292
|
+
# Primitives.
|
1293
|
+
# Draws a 3d error box at position p=(x, y, z) with sizes e=(ex, ey, ez) and style stl. Use NAN for component of e to reduce number of drawn elements.
|
1294
|
+
# @overload error(p,e,stl="")
|
1295
|
+
# @param [MglPoint] p
|
1296
|
+
# @param [MglPoint] e
|
1297
|
+
# @param [String] stl default=""
|
1298
|
+
# @return [nil]
|
1299
|
+
def error
|
1300
|
+
end
|
1301
|
+
|
1302
|
+
|
1303
|
+
# Primitives.
|
1304
|
+
# Draws a geodesic line (straight line in Cartesian coordinates) from point p1 to p2 using line style stl. Parameter num define the ``quality'' of the line. If num=2 then the stright line will be drawn in all coordinate system (independently on transformation formulas (see Curved coordinates). Contrary, for large values (for example, =100) the geodesic line will be drawn in corresponding coordinate system (straight line in Cartesian coordinates, circle in polar coordinates and so on). Line will be drawn even if it lies out of bounding box.
|
1305
|
+
# @overload line(p1,p2,stl="B",num=2)
|
1306
|
+
# @param [MglPoint] p1
|
1307
|
+
# @param [MglPoint] p2
|
1308
|
+
# @param [String] stl default="B"
|
1309
|
+
# @param [Integer] num default=2
|
1310
|
+
# @return [nil]
|
1311
|
+
def line
|
1312
|
+
end
|
1313
|
+
|
1314
|
+
|
1315
|
+
# Primitives.
|
1316
|
+
# Draws Bezier-like curve from point p1 to p2 using line style stl. At this tangent is codirected with d1, d2 and proportional to its amplitude. Parameter num define the ``quality'' of the curve. If num=2 then the straight line will be drawn in all coordinate system (independently on transformation formulas, see Curved coordinates). Contrary, for large values (for example, =100) the spline like Bezier curve will be drawn in corresponding coordinate system. Curve will be drawn even if it lies out of bounding box.
|
1317
|
+
# @overload curve(p1,d1,p2,d2,stl="B",num=100)
|
1318
|
+
# @param [MglPoint] p1
|
1319
|
+
# @param [MglPoint] d1
|
1320
|
+
# @param [MglPoint] p2
|
1321
|
+
# @param [MglPoint] d2
|
1322
|
+
# @param [String] stl default="B"
|
1323
|
+
# @param [Integer] num default=100
|
1324
|
+
# @return [nil]
|
1325
|
+
def curve
|
1326
|
+
end
|
1327
|
+
|
1328
|
+
|
1329
|
+
# Primitives.
|
1330
|
+
# Draws the solid quadrangle (face) with vertexes p1, p2, p3, p4 and with color(s) stl. At this colors can be the same for all vertexes or different if all 4 colors are specified for each vertex. Face will be drawn even if it lies out of bounding box.
|
1331
|
+
# @overload face(p1,p2,p3,p4,stl="w")
|
1332
|
+
# @param [MglPoint] p1
|
1333
|
+
# @param [MglPoint] p2
|
1334
|
+
# @param [MglPoint] p3
|
1335
|
+
# @param [MglPoint] p4
|
1336
|
+
# @param [String] stl default="w"
|
1337
|
+
# @return [nil]
|
1338
|
+
def face
|
1339
|
+
end
|
1340
|
+
|
1341
|
+
|
1342
|
+
# Primitives.
|
1343
|
+
# Draws the solid rectangle (face) perpendicular to [x,y,z]-axis correspondingly at position (x0, y0, z0) with color stl and with widths wx, wy, wz along corresponding directions. At this colors can be the same for all vertexes or separately if all 4 colors are specified for each vertex. Parameters d1!=0, d2!=0 set additional shift of the last vertex (i.e. to draw quadrangle). Face will be drawn even if it lies out of bounding box.
|
1344
|
+
# @overload face_x(x0,y0,z0,wy,wz,stl="w",d1=0,d2=0)
|
1345
|
+
# @param [Float] x0
|
1346
|
+
# @param [Float] y0
|
1347
|
+
# @param [Float] z0
|
1348
|
+
# @param [Float] wy
|
1349
|
+
# @param [Float] wz
|
1350
|
+
# @param [String] stl default="w"
|
1351
|
+
# @param [Float] d1 default=0
|
1352
|
+
# @param [Float] d2 default=0
|
1353
|
+
# @return [nil]
|
1354
|
+
# @overload face_y(x0,y0,z0,wx,wz,stl="w",d1=0,d2=0)
|
1355
|
+
# @param [Float] x0
|
1356
|
+
# @param [Float] y0
|
1357
|
+
# @param [Float] z0
|
1358
|
+
# @param [Float] wx
|
1359
|
+
# @param [Float] wz
|
1360
|
+
# @param [String] stl default="w"
|
1361
|
+
# @param [Float] d1 default=0
|
1362
|
+
# @param [Float] d2 default=0
|
1363
|
+
# @return [nil]
|
1364
|
+
# @overload face_z(x0,y0,z0,wx,wy,stl="w",d1=0,d2=0)
|
1365
|
+
# @param [Float] x0
|
1366
|
+
# @param [Float] y0
|
1367
|
+
# @param [Float] z0
|
1368
|
+
# @param [Float] wx
|
1369
|
+
# @param [Float] wy
|
1370
|
+
# @param [String] stl default="w"
|
1371
|
+
# @param [Float] d1 default=0
|
1372
|
+
# @param [Float] d2 default=0
|
1373
|
+
# @return [nil]
|
1374
|
+
def face_z
|
1375
|
+
end
|
1376
|
+
|
1377
|
+
|
1378
|
+
# Primitives.
|
1379
|
+
# Draw the sphere with radius r and center at point p=(x0, y0, z0) and color stl.
|
1380
|
+
# @overload sphere(p,r,stl="r")
|
1381
|
+
# @param [MglPoint] p
|
1382
|
+
# @param [Float] r
|
1383
|
+
# @param [String] stl default="r"
|
1384
|
+
# @return [nil]
|
1385
|
+
def sphere
|
1386
|
+
end
|
1387
|
+
|
1388
|
+
|
1389
|
+
# Primitives.
|
1390
|
+
# Draw the drop with radius r at point p elongated in direction d and with color col. Parameter shift set the degree of drop oblongness: is sphere, is maximally oblongness drop. Parameter ap set relative width of the drop (this is analogue of ``ellipticity'' for the sphere).
|
1391
|
+
# @overload drop(p,d,r,col="r",shift=1,ap=1)
|
1392
|
+
# @param [MglPoint] p
|
1393
|
+
# @param [MglPoint] d
|
1394
|
+
# @param [Float] r
|
1395
|
+
# @param [String] col default="r"
|
1396
|
+
# @param [Float] shift default=1
|
1397
|
+
# @param [Float] ap default=1
|
1398
|
+
# @return [nil]
|
1399
|
+
def drop
|
1400
|
+
end
|
1401
|
+
|
1402
|
+
|
1403
|
+
# Primitives.
|
1404
|
+
# Draw tube (or truncated cone if edge=false) between points p1, p2 with radius at the edges r1, r2. If r2<0 then it is supposed that r2=r1. The cone color is defined by string stl. If style contain then edges will be drawn.
|
1405
|
+
# @overload cone(p1,p2,r1,r2=-1,stl="B")
|
1406
|
+
# @param [MglPoint] p1
|
1407
|
+
# @param [MglPoint] p2
|
1408
|
+
# @param [Float] r1
|
1409
|
+
# @param [Float] r2 default=-1
|
1410
|
+
# @param [String] stl default="B"
|
1411
|
+
# @return [nil]
|
1412
|
+
def cone
|
1413
|
+
end
|
1414
|
+
|
1415
|
+
|
1416
|
+
# Primitives.
|
1417
|
+
# Draw the circle with radius r and center at point p=(x0, y0, z0). Parameter col may contain
|
1418
|
+
# @overload circle(p,r,stl="r")
|
1419
|
+
# @param [MglPoint] p
|
1420
|
+
# @param [Float] r
|
1421
|
+
# @param [String] stl default="r"
|
1422
|
+
# @return [nil]
|
1423
|
+
def circle
|
1424
|
+
end
|
1425
|
+
|
1426
|
+
|
1427
|
+
# Primitives.
|
1428
|
+
# Draw the ellipse with radius r and focal points p1, p2. Parameter col may contain
|
1429
|
+
# @overload ellipse(p1,p2,r,col="r")
|
1430
|
+
# @param [MglPoint] p1
|
1431
|
+
# @param [MglPoint] p2
|
1432
|
+
# @param [Float] r
|
1433
|
+
# @param [String] col default="r"
|
1434
|
+
# @return [nil]
|
1435
|
+
def ellipse
|
1436
|
+
end
|
1437
|
+
|
1438
|
+
|
1439
|
+
# Primitives.
|
1440
|
+
# Draw the rhombus with width r and edge points p1, p2. Parameter col may contain
|
1441
|
+
# @overload rhomb(p1,p2,r,col="r")
|
1442
|
+
# @param [MglPoint] p1
|
1443
|
+
# @param [MglPoint] p2
|
1444
|
+
# @param [Float] r
|
1445
|
+
# @param [String] col default="r"
|
1446
|
+
# @return [nil]
|
1447
|
+
def rhomb
|
1448
|
+
end
|
1449
|
+
|
1450
|
+
|
1451
|
+
# Text printing.
|
1452
|
+
# The function plots the string text at position p with fonts specifying by the criteria fnt. The size of font is set by size parameter (default is -1).
|
1453
|
+
# @overload puts(p,text,fnt=":C",size=-1)
|
1454
|
+
# @param [MglPoint] p
|
1455
|
+
# @param [String] text
|
1456
|
+
# @param [String] fnt default=":C"
|
1457
|
+
# @param [Float] size default=-1
|
1458
|
+
# @return [nil]
|
1459
|
+
# @overload puts(x,y,text,fnt=":AC",size=-1)
|
1460
|
+
# @param [Float] x
|
1461
|
+
# @param [Float] y
|
1462
|
+
# @param [String] text
|
1463
|
+
# @param [String] fnt default=":AC"
|
1464
|
+
# @param [Float] size default=-1
|
1465
|
+
# @return [nil]
|
1466
|
+
def puts
|
1467
|
+
end
|
1468
|
+
|
1469
|
+
|
1470
|
+
# Text printing.
|
1471
|
+
# The function plots the string text at position p along direction d with specified size. Parameter fnt set text style and text position: above () or under () the line.
|
1472
|
+
# @overload puts(p,d,text,fnt=":L",size=-1)
|
1473
|
+
# @param [MglPoint] p
|
1474
|
+
# @param [MglPoint] d
|
1475
|
+
# @param [String] text
|
1476
|
+
# @param [String] fnt default=":L"
|
1477
|
+
# @param [Float] size default=-1
|
1478
|
+
# @return [nil]
|
1479
|
+
def puts
|
1480
|
+
end
|
1481
|
+
|
1482
|
+
|
1483
|
+
# Text printing.
|
1484
|
+
# The function draws text along the curve between points (x[i], y[i], z[i]) by font style fnt. The string fnt may contain symbols for printing the text under the curve (default), or for printing the text above the curve. The sizes of 1st dimension must be equal for all arrays x.nx=y.nx=z.nx. If array x is not specified then its an automatic array is used with values equidistantly distributed in interval [Min.x, Max.x] (see Ranges (bounding box)). If array z is not specified then z[i] = Min.z is used. String opt contain command options (see Command options).
|
1485
|
+
# @overload text(y,text,fnt="",opt="")
|
1486
|
+
# @param [MglData] y
|
1487
|
+
# @param [String] text
|
1488
|
+
# @param [String] fnt default=""
|
1489
|
+
# @param [String] opt default=""
|
1490
|
+
# @return [nil]
|
1491
|
+
# @overload text(x,y,text,fnt="",opt="")
|
1492
|
+
# @param [MglData] x
|
1493
|
+
# @param [MglData] y
|
1494
|
+
# @param [String] text
|
1495
|
+
# @param [String] fnt default=""
|
1496
|
+
# @param [String] opt default=""
|
1497
|
+
# @return [nil]
|
1498
|
+
# @overload text(x,y,z,text,fnt="",opt="")
|
1499
|
+
# @param [MglData] x
|
1500
|
+
# @param [MglData] y
|
1501
|
+
# @param [MglData] z
|
1502
|
+
# @param [String] text
|
1503
|
+
# @param [String] fnt default=""
|
1504
|
+
# @param [String] opt default=""
|
1505
|
+
# @return [nil]
|
1506
|
+
def text
|
1507
|
+
end
|
1508
|
+
|
1509
|
+
|
1510
|
+
# Axis and Colorbar.
|
1511
|
+
# Draws axes with ticks (see Axis settings). Parameter dir may contain:
|
1512
|
+
# Styles of ticks and axis can be overrided by using stl string.
|
1513
|
+
# @overload axis(dir="xyz",stl="",opt="")
|
1514
|
+
# @param [String] dir default="xyz"
|
1515
|
+
# @param [String] stl default=""
|
1516
|
+
# @param [String] opt default=""
|
1517
|
+
# @return [nil]
|
1518
|
+
def axis
|
1519
|
+
end
|
1520
|
+
|
1521
|
+
|
1522
|
+
# Axis and Colorbar.
|
1523
|
+
# Draws colorbar. Parameter sch may contain:
|
1524
|
+
# @overload colorbar(sch="")
|
1525
|
+
# @param [String] sch default=""
|
1526
|
+
# @return [nil]
|
1527
|
+
def colorbar
|
1528
|
+
end
|
1529
|
+
|
1530
|
+
|
1531
|
+
# Axis and Colorbar.
|
1532
|
+
# The same as previous but with sharp colors sch (current palette if sch="") for values v.
|
1533
|
+
# @overload colorbar(v,sch="")
|
1534
|
+
# @param [MglData] v
|
1535
|
+
# @param [String] sch default=""
|
1536
|
+
# @return [nil]
|
1537
|
+
def colorbar
|
1538
|
+
end
|
1539
|
+
|
1540
|
+
|
1541
|
+
# Axis and Colorbar.
|
1542
|
+
# The same as first one but at arbitrary position of subplot (x, y) (supposed to be in range [0,1]). Parameters w, h set the relative width and height of the colorbar.
|
1543
|
+
# @overload colorbar(sch,x,y,w=1,h=1)
|
1544
|
+
# @param [String] sch
|
1545
|
+
# @param [Float] x
|
1546
|
+
# @param [Float] y
|
1547
|
+
# @param [Float] w default=1
|
1548
|
+
# @param [Float] h default=1
|
1549
|
+
# @return [nil]
|
1550
|
+
def colorbar
|
1551
|
+
end
|
1552
|
+
|
1553
|
+
|
1554
|
+
# Axis and Colorbar.
|
1555
|
+
# The same as previous but with sharp colors sch (current palette if sch="") for values v.
|
1556
|
+
# @overload colorbar(v,sch,x,y,w=1,h=1)
|
1557
|
+
# @param [MglData] v
|
1558
|
+
# @param [String] sch
|
1559
|
+
# @param [Float] x
|
1560
|
+
# @param [Float] y
|
1561
|
+
# @param [Float] w default=1
|
1562
|
+
# @param [Float] h default=1
|
1563
|
+
# @return [nil]
|
1564
|
+
def colorbar
|
1565
|
+
end
|
1566
|
+
|
1567
|
+
|
1568
|
+
# Axis and Colorbar.
|
1569
|
+
# Draws grid lines perpendicular to direction determined by string parameter dir. The step of grid lines is the same as tick step for axis. The style of lines is determined by pen parameter (default value is dark blue solid line ).
|
1570
|
+
# @overload grid(dir="xyz",pen="B",opt="")
|
1571
|
+
# @param [String] dir default="xyz"
|
1572
|
+
# @param [String] pen default="B"
|
1573
|
+
# @param [String] opt default=""
|
1574
|
+
# @return [nil]
|
1575
|
+
def grid
|
1576
|
+
end
|
1577
|
+
|
1578
|
+
|
1579
|
+
# Axis and Colorbar.
|
1580
|
+
# Draws bounding box outside the plotting volume with color col. If col contain then filled faces are drawn. At this first color is used for faces (default is light yellow), last one for edges.
|
1581
|
+
# @overload box(col="",ticks=true)
|
1582
|
+
# @param [String] col default=""
|
1583
|
+
# @param [bool] ticks default=true
|
1584
|
+
# @return [nil]
|
1585
|
+
def box
|
1586
|
+
end
|
1587
|
+
|
1588
|
+
|
1589
|
+
# Axis and Colorbar.
|
1590
|
+
# Prints the label text for axis dir=,,, (here is ``ternary'' axis ). The position of label is determined by pos parameter. If pos=0 then label is printed at the center of axis. If pos>0 then label is printed at the maximum of axis. If pos<0 then label is printed at the minimum of axis. Value option set additional shifting of the label. .
|
1591
|
+
# @overload label(dir,text,pos=1,opt="")
|
1592
|
+
# @param [String] dir
|
1593
|
+
# @param [String] text
|
1594
|
+
# @param [Float] pos default=1
|
1595
|
+
# @param [String] opt default=""
|
1596
|
+
# @return [nil]
|
1597
|
+
def label
|
1598
|
+
end
|
1599
|
+
|
1600
|
+
|
1601
|
+
# Legend.
|
1602
|
+
# Draws legend of accumulated legend entries by font fnt with size. Parameter pos sets the position of the legend: is bottom left corner, is bottom right corner, is top left corner, is top right corner (is default). Parameter fnt can contain colors for face (1st one), for border (2nd one) and for text (last one). If less than 3 colors are specified then the color for border is black (for 2 and less colors), and the color for face is white (for 1 or none colors). If string fnt contain then border around the legend is drawn. If string fnt contain then legend entries will arranged horizontally.
|
1603
|
+
# @overload legend(pos=0x3,fnt="#",opt="")
|
1604
|
+
# @param [Integer] pos default=0x3
|
1605
|
+
# @param [String] fnt default="#"
|
1606
|
+
# @param [String] opt default=""
|
1607
|
+
# @return [nil]
|
1608
|
+
def legend
|
1609
|
+
end
|
1610
|
+
|
1611
|
+
|
1612
|
+
# Legend.
|
1613
|
+
# Draws legend of accumulated legend entries by font fnt with size. Position of legend is determined by parameter x, y which supposed to be normalized to interval [0,1].
|
1614
|
+
# @overload legend(x,y,fnt="#",opt="")
|
1615
|
+
# @param [Float] x
|
1616
|
+
# @param [Float] y
|
1617
|
+
# @param [String] fnt default="#"
|
1618
|
+
# @param [String] opt default=""
|
1619
|
+
# @return [nil]
|
1620
|
+
def legend
|
1621
|
+
end
|
1622
|
+
|
1623
|
+
|
1624
|
+
# Legend.
|
1625
|
+
# Adds string text to internal legend accumulator. The style of described line and mark is specified in string style (see Line styles).
|
1626
|
+
# @overload add_legend(text,style)
|
1627
|
+
# @param [String] text
|
1628
|
+
# @param [String] style
|
1629
|
+
# @return [nil]
|
1630
|
+
def add_legend
|
1631
|
+
end
|
1632
|
+
|
1633
|
+
|
1634
|
+
# Legend.
|
1635
|
+
# Clears saved legend strings.
|
1636
|
+
# @overload clear_legend()
|
1637
|
+
# @return [nil]
|
1638
|
+
def clear_legend
|
1639
|
+
end
|
1640
|
+
|
1641
|
+
|
1642
|
+
# Legend.
|
1643
|
+
# Set the number of marks in the legend. By default 1 mark is used.
|
1644
|
+
# @overload set_legend_marks(num)
|
1645
|
+
# @param [Integer] num
|
1646
|
+
# @return [nil]
|
1647
|
+
def set_legend_marks
|
1648
|
+
end
|
1649
|
+
|
1650
|
+
|
1651
|
+
# 1D plotting.
|
1652
|
+
# These functions draw continuous lines between points (x[i], y[i], z[i]). See also area, step, stem, tube, mark, error, belt, tens, tape.
|
1653
|
+
# @overload plot(y,pen="",opt="")
|
1654
|
+
# @param [MglData] y
|
1655
|
+
# @param [String] pen default=""
|
1656
|
+
# @param [String] opt default=""
|
1657
|
+
# @return [nil]
|
1658
|
+
# @overload plot(x,y,pen="",opt="")
|
1659
|
+
# @param [MglData] x
|
1660
|
+
# @param [MglData] y
|
1661
|
+
# @param [String] pen default=""
|
1662
|
+
# @param [String] opt default=""
|
1663
|
+
# @return [nil]
|
1664
|
+
# @overload plot(x,y,z,pen="",opt="")
|
1665
|
+
# @param [MglData] x
|
1666
|
+
# @param [MglData] y
|
1667
|
+
# @param [MglData] z
|
1668
|
+
# @param [String] pen default=""
|
1669
|
+
# @param [String] opt default=""
|
1670
|
+
# @return [nil]
|
1671
|
+
def plot
|
1672
|
+
end
|
1673
|
+
|
1674
|
+
|
1675
|
+
# 1D plotting.
|
1676
|
+
# This functions draws radar chart which is continuous lines between points located on an radial lines (like plot in Polar coordinates). Parameter value in options opt set the additional shift of data (i.e. the data a+value is used instead of a). If value<0 then r=max(0, -min(value). If pen containt symbol then "grid" (radial lines and circle for r) is drawn. See also plot.
|
1677
|
+
# @overload radar(a,pen="",opt="")
|
1678
|
+
# @param [MglData] a
|
1679
|
+
# @param [String] pen default=""
|
1680
|
+
# @param [String] opt default=""
|
1681
|
+
# @return [nil]
|
1682
|
+
def radar
|
1683
|
+
end
|
1684
|
+
|
1685
|
+
|
1686
|
+
# 1D plotting.
|
1687
|
+
# These functions draw continuous stairs for points to axis plane. See also plot, stem, tile, boxs.
|
1688
|
+
# @overload step(y,pen="",opt="")
|
1689
|
+
# @param [MglData] y
|
1690
|
+
# @param [String] pen default=""
|
1691
|
+
# @param [String] opt default=""
|
1692
|
+
# @return [nil]
|
1693
|
+
# @overload step(x,y,pen="",opt="")
|
1694
|
+
# @param [MglData] x
|
1695
|
+
# @param [MglData] y
|
1696
|
+
# @param [String] pen default=""
|
1697
|
+
# @param [String] opt default=""
|
1698
|
+
# @return [nil]
|
1699
|
+
# @overload step(x,y,z,pen="",opt="")
|
1700
|
+
# @param [MglData] x
|
1701
|
+
# @param [MglData] y
|
1702
|
+
# @param [MglData] z
|
1703
|
+
# @param [String] pen default=""
|
1704
|
+
# @param [String] opt default=""
|
1705
|
+
# @return [nil]
|
1706
|
+
def step
|
1707
|
+
end
|
1708
|
+
|
1709
|
+
|
1710
|
+
# 1D plotting.
|
1711
|
+
# These functions draw continuous lines between points (x[i], y[i], z[i]) with color defined by the special array c[i] (look like tension plot). String pen specifies the color scheme (see Color scheme) and style and/or width of line (see Line styles). See also plot, mesh, fall.
|
1712
|
+
# @overload tens(y,c,pen="",opt="")
|
1713
|
+
# @param [MglData] y
|
1714
|
+
# @param [MglData] c
|
1715
|
+
# @param [String] pen default=""
|
1716
|
+
# @param [String] opt default=""
|
1717
|
+
# @return [nil]
|
1718
|
+
# @overload tens(x,y,c,pen="",opt="")
|
1719
|
+
# @param [MglData] x
|
1720
|
+
# @param [MglData] y
|
1721
|
+
# @param [MglData] c
|
1722
|
+
# @param [String] pen default=""
|
1723
|
+
# @param [String] opt default=""
|
1724
|
+
# @return [nil]
|
1725
|
+
# @overload tens(x,y,z,c,pen="",opt="")
|
1726
|
+
# @param [MglData] x
|
1727
|
+
# @param [MglData] y
|
1728
|
+
# @param [MglData] z
|
1729
|
+
# @param [MglData] c
|
1730
|
+
# @param [String] pen default=""
|
1731
|
+
# @param [String] opt default=""
|
1732
|
+
# @return [nil]
|
1733
|
+
def tens
|
1734
|
+
end
|
1735
|
+
|
1736
|
+
|
1737
|
+
# 1D plotting.
|
1738
|
+
# These functions draw tapes of normals for curve between points (x[i], y[i], z[i]). Initial tape(s) was selected in x-y plane (for in pen) and/or y-z plane (for in pen). The width of tape is proportional to barwidth. See also plot, flow, barwidth.
|
1739
|
+
# @overload tape(y,pen="",opt="")
|
1740
|
+
# @param [MglData] y
|
1741
|
+
# @param [String] pen default=""
|
1742
|
+
# @param [String] opt default=""
|
1743
|
+
# @return [nil]
|
1744
|
+
# @overload tape(x,y,pen="",opt="")
|
1745
|
+
# @param [MglData] x
|
1746
|
+
# @param [MglData] y
|
1747
|
+
# @param [String] pen default=""
|
1748
|
+
# @param [String] opt default=""
|
1749
|
+
# @return [nil]
|
1750
|
+
# @overload tape(x,y,z,pen="",opt="")
|
1751
|
+
# @param [MglData] x
|
1752
|
+
# @param [MglData] y
|
1753
|
+
# @param [MglData] z
|
1754
|
+
# @param [String] pen default=""
|
1755
|
+
# @param [String] opt default=""
|
1756
|
+
# @return [nil]
|
1757
|
+
def tape
|
1758
|
+
end
|
1759
|
+
|
1760
|
+
|
1761
|
+
# 1D plotting.
|
1762
|
+
# These functions draw continuous lines between points and fills it to axis plane. Also you can use gradient filling if number of specified colors is equal to 2*number of curves. See also plot, bars, stem, region.
|
1763
|
+
# @overload area(y,pen="",opt="")
|
1764
|
+
# @param [MglData] y
|
1765
|
+
# @param [String] pen default=""
|
1766
|
+
# @param [String] opt default=""
|
1767
|
+
# @return [nil]
|
1768
|
+
# @overload area(x,y,pen="",opt="")
|
1769
|
+
# @param [MglData] x
|
1770
|
+
# @param [MglData] y
|
1771
|
+
# @param [String] pen default=""
|
1772
|
+
# @param [String] opt default=""
|
1773
|
+
# @return [nil]
|
1774
|
+
# @overload area(x,y,z,pen="",opt="")
|
1775
|
+
# @param [MglData] x
|
1776
|
+
# @param [MglData] y
|
1777
|
+
# @param [MglData] z
|
1778
|
+
# @param [String] pen default=""
|
1779
|
+
# @param [String] opt default=""
|
1780
|
+
# @return [nil]
|
1781
|
+
def area
|
1782
|
+
end
|
1783
|
+
|
1784
|
+
|
1785
|
+
# 1D plotting.
|
1786
|
+
# These functions fill area between 2 curves. Dimensions of arrays y1 and y2 must be equal. Also you can use gradient filling if number of specified colors is equal to 2*number of curves. If pen contain symbol then only area with y1<y<y2 will be filled else the area with y2<y<y1 will be filled too. See also area, bars, stem.
|
1787
|
+
# @overload region(y1,y2,pen="",opt="")
|
1788
|
+
# @param [MglData] y1
|
1789
|
+
# @param [MglData] y2
|
1790
|
+
# @param [String] pen default=""
|
1791
|
+
# @param [String] opt default=""
|
1792
|
+
# @return [nil]
|
1793
|
+
# @overload region(x,y1,y2,pen="",opt="")
|
1794
|
+
# @param [MglData] x
|
1795
|
+
# @param [MglData] y1
|
1796
|
+
# @param [MglData] y2
|
1797
|
+
# @param [String] pen default=""
|
1798
|
+
# @param [String] opt default=""
|
1799
|
+
# @return [nil]
|
1800
|
+
def region
|
1801
|
+
end
|
1802
|
+
|
1803
|
+
|
1804
|
+
# 1D plotting.
|
1805
|
+
# These functions draw vertical lines from points to axis plane. See also area, bars, plot, mark.
|
1806
|
+
# @overload stem(y,pen="",opt="")
|
1807
|
+
# @param [MglData] y
|
1808
|
+
# @param [String] pen default=""
|
1809
|
+
# @param [String] opt default=""
|
1810
|
+
# @return [nil]
|
1811
|
+
# @overload stem(x,y,pen="",opt="")
|
1812
|
+
# @param [MglData] x
|
1813
|
+
# @param [MglData] y
|
1814
|
+
# @param [String] pen default=""
|
1815
|
+
# @param [String] opt default=""
|
1816
|
+
# @return [nil]
|
1817
|
+
# @overload stem(x,y,z,pen="",opt="")
|
1818
|
+
# @param [MglData] x
|
1819
|
+
# @param [MglData] y
|
1820
|
+
# @param [MglData] z
|
1821
|
+
# @param [String] pen default=""
|
1822
|
+
# @param [String] opt default=""
|
1823
|
+
# @return [nil]
|
1824
|
+
def stem
|
1825
|
+
end
|
1826
|
+
|
1827
|
+
|
1828
|
+
# 1D plotting.
|
1829
|
+
# These functions draw vertical bars from points to axis plane. If string pen contain symbol then lines are drawn one above another (like summation). If string contain symbol then waterfall chart is drawn for determining the cumulative effect of sequentially introduced positive or negative values. You can give different colors for positive and negative values if number of specified colors is equal to 2*number of curves. See also barh, cones, area, stem, chart, barwidth.
|
1830
|
+
# @overload bars(y,pen="",opt="")
|
1831
|
+
# @param [MglData] y
|
1832
|
+
# @param [String] pen default=""
|
1833
|
+
# @param [String] opt default=""
|
1834
|
+
# @return [nil]
|
1835
|
+
# @overload bars(x,y,pen="",opt="")
|
1836
|
+
# @param [MglData] x
|
1837
|
+
# @param [MglData] y
|
1838
|
+
# @param [String] pen default=""
|
1839
|
+
# @param [String] opt default=""
|
1840
|
+
# @return [nil]
|
1841
|
+
# @overload bars(x,y,z,pen="",opt="")
|
1842
|
+
# @param [MglData] x
|
1843
|
+
# @param [MglData] y
|
1844
|
+
# @param [MglData] z
|
1845
|
+
# @param [String] pen default=""
|
1846
|
+
# @param [String] opt default=""
|
1847
|
+
# @return [nil]
|
1848
|
+
def bars
|
1849
|
+
end
|
1850
|
+
|
1851
|
+
|
1852
|
+
# 1D plotting.
|
1853
|
+
# These functions draw horizontal bars from points to axis plane. If string contain symbol then lines are drawn one above another (like summation). If string contain symbol then waterfall chart is drawn for determining the cumulative effect of sequentially introduced positive or negative values. You can give different colors for positive and negative values if number of specified colors is equal to 2*number of curves. See also bars, barwidth.
|
1854
|
+
# @overload barh(v,pen="",opt="")
|
1855
|
+
# @param [MglData] v
|
1856
|
+
# @param [String] pen default=""
|
1857
|
+
# @param [String] opt default=""
|
1858
|
+
# @return [nil]
|
1859
|
+
# @overload barh(y,v,pen="",opt="")
|
1860
|
+
# @param [MglData] y
|
1861
|
+
# @param [MglData] v
|
1862
|
+
# @param [String] pen default=""
|
1863
|
+
# @param [String] opt default=""
|
1864
|
+
# @return [nil]
|
1865
|
+
def barh
|
1866
|
+
end
|
1867
|
+
|
1868
|
+
|
1869
|
+
# 1D plotting.
|
1870
|
+
# These functions draw cones from points to axis plane. If string contain symbol then cones are drawn one above another (like summation). You can give different colors for positive and negative values if number of specified colors is equal to 2*number of curves. See also bars, barwidth.
|
1871
|
+
# @overload cones(y,pen="",opt="")
|
1872
|
+
# @param [MglData] y
|
1873
|
+
# @param [String] pen default=""
|
1874
|
+
# @param [String] opt default=""
|
1875
|
+
# @return [nil]
|
1876
|
+
# @overload cones(x,y,pen="",opt="")
|
1877
|
+
# @param [MglData] x
|
1878
|
+
# @param [MglData] y
|
1879
|
+
# @param [String] pen default=""
|
1880
|
+
# @param [String] opt default=""
|
1881
|
+
# @return [nil]
|
1882
|
+
# @overload cones(x,y,z,pen="",opt="")
|
1883
|
+
# @param [MglData] x
|
1884
|
+
# @param [MglData] y
|
1885
|
+
# @param [MglData] z
|
1886
|
+
# @param [String] pen default=""
|
1887
|
+
# @param [String] opt default=""
|
1888
|
+
# @return [nil]
|
1889
|
+
def cones
|
1890
|
+
end
|
1891
|
+
|
1892
|
+
|
1893
|
+
# 1D plotting.
|
1894
|
+
# The function draws colored stripes (boxes) for data in array a. The number of stripes is equal to the number of rows in a (equal to a.ny). The color of each next stripe is cyclically changed from colors specified in string col or in palette Pal (see Palette and colors). Spaces in colors denote transparent ``color'' (i.e. corresponding stripe(s) are not drawn). The stripe width is proportional to value of element in a. Chart is plotted only for data with non-negative elements. If string col have symbol then black border lines are drawn. The most nice form the chart have in 3d (after rotation of coordinates) or in cylindrical coordinates (becomes so called Pie chart).
|
1895
|
+
# @overload chart(a,col="",opt="")
|
1896
|
+
# @param [MglData] a
|
1897
|
+
# @param [String] col default=""
|
1898
|
+
# @param [String] opt default=""
|
1899
|
+
# @return [nil]
|
1900
|
+
def chart
|
1901
|
+
end
|
1902
|
+
|
1903
|
+
|
1904
|
+
# 1D plotting.
|
1905
|
+
# These functions draw boxplot (also known as a box-and-whisker diagram) at points x[i]. This is five-number summaries of data a[i,j] (minimum, lower quartile (Q1), median (Q2), upper quartile (Q3) and maximum) along second (j-th) direction. See also plot, error, bars, barwidth.
|
1906
|
+
# @overload box_plot(a,pen="",opt="")
|
1907
|
+
# @param [MglData] a
|
1908
|
+
# @param [String] pen default=""
|
1909
|
+
# @param [String] opt default=""
|
1910
|
+
# @return [nil]
|
1911
|
+
# @overload box_plot(x,a,pen="",opt="")
|
1912
|
+
# @param [MglData] x
|
1913
|
+
# @param [MglData] a
|
1914
|
+
# @param [String] pen default=""
|
1915
|
+
# @param [String] opt default=""
|
1916
|
+
# @return [nil]
|
1917
|
+
def box_plot
|
1918
|
+
end
|
1919
|
+
|
1920
|
+
|
1921
|
+
# 1D plotting.
|
1922
|
+
# These functions draw candlestick chart at points x[i]. This is a combination of a line-chart and a bar-chart, in that each bar represents the range of price movement over a given time interval. Wire (or white) candle correspond to price growth v1[i]<v2[i], opposite case -- solid (or dark) candle. "Shadows" show the minimal y1 and maximal y2 prices. If v2 is absent then it is determined as v2[i]=v1[i+1]. See also plot, bars, barwidth.
|
1923
|
+
# @overload candle(v1,pen="",opt="")
|
1924
|
+
# @param [MglData] v1
|
1925
|
+
# @param [String] pen default=""
|
1926
|
+
# @param [String] opt default=""
|
1927
|
+
# @return [nil]
|
1928
|
+
# @overload candle(v1,v2,pen="",opt="")
|
1929
|
+
# @param [MglData] v1
|
1930
|
+
# @param [MglData] v2
|
1931
|
+
# @param [String] pen default=""
|
1932
|
+
# @param [String] opt default=""
|
1933
|
+
# @return [nil]
|
1934
|
+
# @overload candle(v1,y1,y2,pen="",opt="")
|
1935
|
+
# @param [MglData] v1
|
1936
|
+
# @param [MglData] y1
|
1937
|
+
# @param [MglData] y2
|
1938
|
+
# @param [String] pen default=""
|
1939
|
+
# @param [String] opt default=""
|
1940
|
+
# @return [nil]
|
1941
|
+
# @overload candle(v1,v2,y1,y2,pen="",opt="")
|
1942
|
+
# @param [MglData] v1
|
1943
|
+
# @param [MglData] v2
|
1944
|
+
# @param [MglData] y1
|
1945
|
+
# @param [MglData] y2
|
1946
|
+
# @param [String] pen default=""
|
1947
|
+
# @param [String] opt default=""
|
1948
|
+
# @return [nil]
|
1949
|
+
# @overload candle(x,v1,v2,y1,y2,pen="",opt="")
|
1950
|
+
# @param [MglData] x
|
1951
|
+
# @param [MglData] v1
|
1952
|
+
# @param [MglData] v2
|
1953
|
+
# @param [MglData] y1
|
1954
|
+
# @param [MglData] y2
|
1955
|
+
# @param [String] pen default=""
|
1956
|
+
# @param [String] opt default=""
|
1957
|
+
# @return [nil]
|
1958
|
+
def candle
|
1959
|
+
end
|
1960
|
+
|
1961
|
+
|
1962
|
+
# 1D plotting.
|
1963
|
+
# These functions draw error boxes (ex[i], ey[i]) at points (x[i], y[i]). This can be useful, for example, in experimental points, or to show numeric error or some estimations and so on. If string pen contain symbol than large semitransparent mark is used instead of error box. See also plot, mark.
|
1964
|
+
# @overload error(y,ey,pen="",opt="")
|
1965
|
+
# @param [MglData] y
|
1966
|
+
# @param [MglData] ey
|
1967
|
+
# @param [String] pen default=""
|
1968
|
+
# @param [String] opt default=""
|
1969
|
+
# @return [nil]
|
1970
|
+
# @overload error(x,y,ey,pen="",opt="")
|
1971
|
+
# @param [MglData] x
|
1972
|
+
# @param [MglData] y
|
1973
|
+
# @param [MglData] ey
|
1974
|
+
# @param [String] pen default=""
|
1975
|
+
# @param [String] opt default=""
|
1976
|
+
# @return [nil]
|
1977
|
+
# @overload error(x,y,ex,ey,pen="",opt="")
|
1978
|
+
# @param [MglData] x
|
1979
|
+
# @param [MglData] y
|
1980
|
+
# @param [MglData] ex
|
1981
|
+
# @param [MglData] ey
|
1982
|
+
# @param [String] pen default=""
|
1983
|
+
# @param [String] opt default=""
|
1984
|
+
# @return [nil]
|
1985
|
+
def error
|
1986
|
+
end
|
1987
|
+
|
1988
|
+
|
1989
|
+
# 1D plotting.
|
1990
|
+
# These functions draw marks with size r[i]*marksize at points (x[i], y[i], z[i]). If you need to draw markers of the same size then you can use plot function with empty line style . For markers with size in axis range use error with style . See also plot, textmark, error, stem.
|
1991
|
+
# @overload mark(y,r,pen="",opt="")
|
1992
|
+
# @param [MglData] y
|
1993
|
+
# @param [MglData] r
|
1994
|
+
# @param [String] pen default=""
|
1995
|
+
# @param [String] opt default=""
|
1996
|
+
# @return [nil]
|
1997
|
+
# @overload mark(x,y,r,pen="",opt="")
|
1998
|
+
# @param [MglData] x
|
1999
|
+
# @param [MglData] y
|
2000
|
+
# @param [MglData] r
|
2001
|
+
# @param [String] pen default=""
|
2002
|
+
# @param [String] opt default=""
|
2003
|
+
# @return [nil]
|
2004
|
+
# @overload mark(x,y,z,r,pen="",opt="")
|
2005
|
+
# @param [MglData] x
|
2006
|
+
# @param [MglData] y
|
2007
|
+
# @param [MglData] z
|
2008
|
+
# @param [MglData] r
|
2009
|
+
# @param [String] pen default=""
|
2010
|
+
# @param [String] opt default=""
|
2011
|
+
# @return [nil]
|
2012
|
+
def mark
|
2013
|
+
end
|
2014
|
+
|
2015
|
+
|
2016
|
+
# 1D plotting.
|
2017
|
+
# These functions draw string txt as marks with size proportional to r[i]*marksize at points (x[i], y[i], z[i]). By default (if omitted) r[i]=1. See also plot, mark, stem.
|
2018
|
+
# @overload text_mark(y,txt,fnt="",opt="")
|
2019
|
+
# @param [MglData] y
|
2020
|
+
# @param [String] txt
|
2021
|
+
# @param [String] fnt default=""
|
2022
|
+
# @param [String] opt default=""
|
2023
|
+
# @return [nil]
|
2024
|
+
# @overload text_mark(y,r,txt,fnt="",opt="")
|
2025
|
+
# @param [MglData] y
|
2026
|
+
# @param [MglData] r
|
2027
|
+
# @param [String] txt
|
2028
|
+
# @param [String] fnt default=""
|
2029
|
+
# @param [String] opt default=""
|
2030
|
+
# @return [nil]
|
2031
|
+
# @overload text_mark(x,y,r,txt,fnt="",opt="")
|
2032
|
+
# @param [MglData] x
|
2033
|
+
# @param [MglData] y
|
2034
|
+
# @param [MglData] r
|
2035
|
+
# @param [String] txt
|
2036
|
+
# @param [String] fnt default=""
|
2037
|
+
# @param [String] opt default=""
|
2038
|
+
# @return [nil]
|
2039
|
+
# @overload text_mark(x,y,z,r,txt,fnt="",opt="")
|
2040
|
+
# @param [MglData] x
|
2041
|
+
# @param [MglData] y
|
2042
|
+
# @param [MglData] z
|
2043
|
+
# @param [MglData] r
|
2044
|
+
# @param [String] txt
|
2045
|
+
# @param [String] fnt default=""
|
2046
|
+
# @param [String] opt default=""
|
2047
|
+
# @return [nil]
|
2048
|
+
def text_mark
|
2049
|
+
end
|
2050
|
+
|
2051
|
+
|
2052
|
+
# 1D plotting.
|
2053
|
+
# These functions draw string txt at points (x[i], y[i], z[i]). If string txt contain , , or then it will be replaced by the value of x-,y-,z-coordinate of the point or its index. See also plot, mark, textmark, table.
|
2054
|
+
# @overload label(y,txt,fnt="",opt="")
|
2055
|
+
# @param [MglData] y
|
2056
|
+
# @param [String] txt
|
2057
|
+
# @param [String] fnt default=""
|
2058
|
+
# @param [String] opt default=""
|
2059
|
+
# @return [nil]
|
2060
|
+
# @overload label(x,y,txt,fnt="",opt="")
|
2061
|
+
# @param [MglData] x
|
2062
|
+
# @param [MglData] y
|
2063
|
+
# @param [String] txt
|
2064
|
+
# @param [String] fnt default=""
|
2065
|
+
# @param [String] opt default=""
|
2066
|
+
# @return [nil]
|
2067
|
+
# @overload label(x,y,z,txt,fnt="",opt="")
|
2068
|
+
# @param [MglData] x
|
2069
|
+
# @param [MglData] y
|
2070
|
+
# @param [MglData] z
|
2071
|
+
# @param [String] txt
|
2072
|
+
# @param [String] fnt default=""
|
2073
|
+
# @param [String] opt default=""
|
2074
|
+
# @return [nil]
|
2075
|
+
def label
|
2076
|
+
end
|
2077
|
+
|
2078
|
+
|
2079
|
+
# 1D plotting.
|
2080
|
+
# These functions draw table with values of val and captions from string txt (separated by newline symbol ) at points (x, y) (default at (0,0)) related to current subplot. If string fnt contain then cell border will be drawn. If string fnt contain then table width is limited by subplot width (equivalent option ). If string fnt contain then widths of all cells are the same. Option value set the width of the table (default is 1). See also plot, label.
|
2081
|
+
# @overload table(val,txt,fnt="",opt="")
|
2082
|
+
# @param [MglData] val
|
2083
|
+
# @param [String] txt
|
2084
|
+
# @param [String] fnt default=""
|
2085
|
+
# @param [String] opt default=""
|
2086
|
+
# @return [nil]
|
2087
|
+
# @overload table(x,y,val,txt,fnt="",opt="")
|
2088
|
+
# @param [Float] x
|
2089
|
+
# @param [Float] y
|
2090
|
+
# @param [MglData] val
|
2091
|
+
# @param [String] txt
|
2092
|
+
# @param [String] fnt default=""
|
2093
|
+
# @param [String] opt default=""
|
2094
|
+
# @return [nil]
|
2095
|
+
def table
|
2096
|
+
end
|
2097
|
+
|
2098
|
+
|
2099
|
+
# 1D plotting.
|
2100
|
+
# These functions draw the tube with variable radius r[i] along the curve between points (x[i], y[i], z[i]). See also plot.
|
2101
|
+
# @overload tube(y,r,pen="",opt="")
|
2102
|
+
# @param [MglData] y
|
2103
|
+
# @param [MglData] r
|
2104
|
+
# @param [String] pen default=""
|
2105
|
+
# @param [String] opt default=""
|
2106
|
+
# @return [nil]
|
2107
|
+
# @overload tube(y,r,pen="",opt="")
|
2108
|
+
# @param [MglData] y
|
2109
|
+
# @param [Float] r
|
2110
|
+
# @param [String] pen default=""
|
2111
|
+
# @param [String] opt default=""
|
2112
|
+
# @return [nil]
|
2113
|
+
# @overload tube(x,y,r,pen="",opt="")
|
2114
|
+
# @param [MglData] x
|
2115
|
+
# @param [MglData] y
|
2116
|
+
# @param [MglData] r
|
2117
|
+
# @param [String] pen default=""
|
2118
|
+
# @param [String] opt default=""
|
2119
|
+
# @return [nil]
|
2120
|
+
# @overload tube(x,y,r,pen="",opt="")
|
2121
|
+
# @param [MglData] x
|
2122
|
+
# @param [MglData] y
|
2123
|
+
# @param [Float] r
|
2124
|
+
# @param [String] pen default=""
|
2125
|
+
# @param [String] opt default=""
|
2126
|
+
# @return [nil]
|
2127
|
+
# @overload tube(x,y,z,r,pen="",opt="")
|
2128
|
+
# @param [MglData] x
|
2129
|
+
# @param [MglData] y
|
2130
|
+
# @param [MglData] z
|
2131
|
+
# @param [MglData] r
|
2132
|
+
# @param [String] pen default=""
|
2133
|
+
# @param [String] opt default=""
|
2134
|
+
# @return [nil]
|
2135
|
+
# @overload tube(x,y,z,r,pen="",opt="")
|
2136
|
+
# @param [MglData] x
|
2137
|
+
# @param [MglData] y
|
2138
|
+
# @param [MglData] z
|
2139
|
+
# @param [Float] r
|
2140
|
+
# @param [String] pen default=""
|
2141
|
+
# @param [String] opt default=""
|
2142
|
+
# @return [nil]
|
2143
|
+
def tube
|
2144
|
+
end
|
2145
|
+
|
2146
|
+
|
2147
|
+
# 1D plotting.
|
2148
|
+
# These functions draw surface which is result of curve (r, z) rotation around axis. If string pen contain symbols or then rotation axis will be set to specified direction (default is ). If string pen have symbol then wire plot is produced. If string pen have symbol then plot by dots is produced. See also plot, axial.
|
2149
|
+
# @overload torus(r,z,pen="",opt="")
|
2150
|
+
# @param [MglData] r
|
2151
|
+
# @param [MglData] z
|
2152
|
+
# @param [String] pen default=""
|
2153
|
+
# @param [String] opt default=""
|
2154
|
+
# @return [nil]
|
2155
|
+
def torus
|
2156
|
+
end
|
2157
|
+
|
2158
|
+
|
2159
|
+
# 2D plotting.
|
2160
|
+
# The function draws surface specified parametrically (x[i,j], y[i,j], z[i,j]). If string sch have symbol then grid lines are drawn. If string sch have symbol then plot by dots is produced. See also mesh, dens, belt, tile, boxs, surfc, surfa.
|
2161
|
+
# @overload surf(z,sch="",opt="")
|
2162
|
+
# @param [MglData] z
|
2163
|
+
# @param [String] sch default=""
|
2164
|
+
# @param [String] opt default=""
|
2165
|
+
# @return [nil]
|
2166
|
+
# @overload surf(x,y,z,sch="",opt="")
|
2167
|
+
# @param [MglData] x
|
2168
|
+
# @param [MglData] y
|
2169
|
+
# @param [MglData] z
|
2170
|
+
# @param [String] sch default=""
|
2171
|
+
# @param [String] opt default=""
|
2172
|
+
# @return [nil]
|
2173
|
+
def surf
|
2174
|
+
end
|
2175
|
+
|
2176
|
+
|
2177
|
+
# 2D plotting.
|
2178
|
+
# The function draws mesh lines for surface specified parametrically (x[i,j], y[i,j], z[i,j]). See also surf, fall, meshnum, cont, tens.
|
2179
|
+
# @overload mesh(z,sch="",opt="")
|
2180
|
+
# @param [MglData] z
|
2181
|
+
# @param [String] sch default=""
|
2182
|
+
# @param [String] opt default=""
|
2183
|
+
# @return [nil]
|
2184
|
+
# @overload mesh(x,y,z,sch="",opt="")
|
2185
|
+
# @param [MglData] x
|
2186
|
+
# @param [MglData] y
|
2187
|
+
# @param [MglData] z
|
2188
|
+
# @param [String] sch default=""
|
2189
|
+
# @param [String] opt default=""
|
2190
|
+
# @return [nil]
|
2191
|
+
def mesh
|
2192
|
+
end
|
2193
|
+
|
2194
|
+
|
2195
|
+
# 2D plotting.
|
2196
|
+
# The function draws fall lines for surface specified parametrically (x[i,j], y[i,j], z[i,j]). This plot can be used for plotting several curves shifted in depth one from another. If sch contain then lines are drawn along x-direction else (by default) lines are drawn along y-direction. See also belt, mesh, tens, meshnum.
|
2197
|
+
# @overload fall(z,sch="",opt="")
|
2198
|
+
# @param [MglData] z
|
2199
|
+
# @param [String] sch default=""
|
2200
|
+
# @param [String] opt default=""
|
2201
|
+
# @return [nil]
|
2202
|
+
# @overload fall(x,y,z,sch="",opt="")
|
2203
|
+
# @param [MglData] x
|
2204
|
+
# @param [MglData] y
|
2205
|
+
# @param [MglData] z
|
2206
|
+
# @param [String] sch default=""
|
2207
|
+
# @param [String] opt default=""
|
2208
|
+
# @return [nil]
|
2209
|
+
def fall
|
2210
|
+
end
|
2211
|
+
|
2212
|
+
|
2213
|
+
# 2D plotting.
|
2214
|
+
# The function draws belts for surface specified parametrically (x[i,j], y[i,j], z[i,j]). This plot can be used as 3d generalization of plot). If sch contain then belts are drawn along x-direction else (by default) belts are drawn along y-direction. See also fall, surf, plot, meshnum.
|
2215
|
+
# @overload belt(z,sch="",opt="")
|
2216
|
+
# @param [MglData] z
|
2217
|
+
# @param [String] sch default=""
|
2218
|
+
# @param [String] opt default=""
|
2219
|
+
# @return [nil]
|
2220
|
+
# @overload belt(x,y,z,sch="",opt="")
|
2221
|
+
# @param [MglData] x
|
2222
|
+
# @param [MglData] y
|
2223
|
+
# @param [MglData] z
|
2224
|
+
# @param [String] sch default=""
|
2225
|
+
# @param [String] opt default=""
|
2226
|
+
# @return [nil]
|
2227
|
+
def belt
|
2228
|
+
end
|
2229
|
+
|
2230
|
+
|
2231
|
+
# 2D plotting.
|
2232
|
+
# The function draws vertical boxes for surface specified parametrically (x[i,j], y[i,j], z[i,j]). Symbol in sch set to draw filled boxes. See also surf, dens, tile, step.
|
2233
|
+
# @overload boxs(z,sch="",opt="")
|
2234
|
+
# @param [MglData] z
|
2235
|
+
# @param [String] sch default=""
|
2236
|
+
# @param [String] opt default=""
|
2237
|
+
# @return [nil]
|
2238
|
+
# @overload boxs(x,y,z,sch="",opt="")
|
2239
|
+
# @param [MglData] x
|
2240
|
+
# @param [MglData] y
|
2241
|
+
# @param [MglData] z
|
2242
|
+
# @param [String] sch default=""
|
2243
|
+
# @param [String] opt default=""
|
2244
|
+
# @return [nil]
|
2245
|
+
def boxs
|
2246
|
+
end
|
2247
|
+
|
2248
|
+
|
2249
|
+
# 2D plotting.
|
2250
|
+
# The function draws horizontal tiles for surface specified parametrically (x[i,j], y[i,j], z[i,j]). Such plot can be used as 3d generalization of step. See also surf, boxs, step, tiles.
|
2251
|
+
# @overload tile(z,sch="",opt="")
|
2252
|
+
# @param [MglData] z
|
2253
|
+
# @param [String] sch default=""
|
2254
|
+
# @param [String] opt default=""
|
2255
|
+
# @return [nil]
|
2256
|
+
# @overload tile(x,y,z,sch="",opt="")
|
2257
|
+
# @param [MglData] x
|
2258
|
+
# @param [MglData] y
|
2259
|
+
# @param [MglData] z
|
2260
|
+
# @param [String] sch default=""
|
2261
|
+
# @param [String] opt default=""
|
2262
|
+
# @return [nil]
|
2263
|
+
def tile
|
2264
|
+
end
|
2265
|
+
|
2266
|
+
|
2267
|
+
# 2D plotting.
|
2268
|
+
# The function draws density plot for surface specified parametrically (x[i,j], y[i,j], z[i,j]) at z = Min.z. If string sch have symbol then grid lines are drawn. If string sch have symbol then plot by dots is produced. See also surf, cont, contf, boxs, tile, dens[xyz].
|
2269
|
+
# @overload dens(z,sch="",opt="",zval=NAN)
|
2270
|
+
# @param [MglData] z
|
2271
|
+
# @param [String] sch default=""
|
2272
|
+
# @param [String] opt default=""
|
2273
|
+
# @param [Float] zval default=NAN
|
2274
|
+
# @return [nil]
|
2275
|
+
# @overload dens(x,y,z,sch="",opt="",zval=NAN)
|
2276
|
+
# @param [MglData] x
|
2277
|
+
# @param [MglData] y
|
2278
|
+
# @param [MglData] z
|
2279
|
+
# @param [String] sch default=""
|
2280
|
+
# @param [String] opt default=""
|
2281
|
+
# @param [Float] zval default=NAN
|
2282
|
+
# @return [nil]
|
2283
|
+
def dens
|
2284
|
+
end
|
2285
|
+
|
2286
|
+
|
2287
|
+
# 2D plotting.
|
2288
|
+
# The function draws contour lines for surface specified parametrically (x[i,j], y[i,j], z[i,j]) at z=v[k] or at z = Min.z if sch contain symbol . Contours are plotted for z[i,j]=v[k] where v[k] are values of data array v. If string sch have symbol or then contour labels v[k] will be drawn below (or above) the contours. See also dens, contf, contd, axial, cont[xyz].
|
2289
|
+
# @overload cont(v,z,sch="",opt="")
|
2290
|
+
# @param [MglData] v
|
2291
|
+
# @param [MglData] z
|
2292
|
+
# @param [String] sch default=""
|
2293
|
+
# @param [String] opt default=""
|
2294
|
+
# @return [nil]
|
2295
|
+
# @overload cont(v,x,y,z,sch="",opt="")
|
2296
|
+
# @param [MglData] v
|
2297
|
+
# @param [MglData] x
|
2298
|
+
# @param [MglData] y
|
2299
|
+
# @param [MglData] z
|
2300
|
+
# @param [String] sch default=""
|
2301
|
+
# @param [String] opt default=""
|
2302
|
+
# @return [nil]
|
2303
|
+
def cont
|
2304
|
+
end
|
2305
|
+
|
2306
|
+
|
2307
|
+
# 2D plotting.
|
2308
|
+
# The same as previous with vector v of num-th elements equidistantly distributed in color range. Here num is equal to parameter value in options opt (default is 7).
|
2309
|
+
# @overload cont(z,sch="",opt="")
|
2310
|
+
# @param [MglData] z
|
2311
|
+
# @param [String] sch default=""
|
2312
|
+
# @param [String] opt default=""
|
2313
|
+
# @return [nil]
|
2314
|
+
# @overload cont(x,y,z,sch="",opt="")
|
2315
|
+
# @param [MglData] x
|
2316
|
+
# @param [MglData] y
|
2317
|
+
# @param [MglData] z
|
2318
|
+
# @param [String] sch default=""
|
2319
|
+
# @param [String] opt default=""
|
2320
|
+
# @return [nil]
|
2321
|
+
def cont
|
2322
|
+
end
|
2323
|
+
|
2324
|
+
|
2325
|
+
# 2D plotting.
|
2326
|
+
# The function draws solid (or filled) contour lines for surface specified parametrically (x[i,j], y[i,j], z[i,j]) at z=v[k] or at z = Min.z if sch contain symbol . Contours are plotted for z[i,j]=v[k] where v[k] are values of data array v (must be v.nx>2). See also dens, cont, contd, contf[xyz].
|
2327
|
+
# @overload cont_f(v,z,sch="",opt="")
|
2328
|
+
# @param [MglData] v
|
2329
|
+
# @param [MglData] z
|
2330
|
+
# @param [String] sch default=""
|
2331
|
+
# @param [String] opt default=""
|
2332
|
+
# @return [nil]
|
2333
|
+
# @overload cont_f(v,x,y,z,sch="",opt="")
|
2334
|
+
# @param [MglData] v
|
2335
|
+
# @param [MglData] x
|
2336
|
+
# @param [MglData] y
|
2337
|
+
# @param [MglData] z
|
2338
|
+
# @param [String] sch default=""
|
2339
|
+
# @param [String] opt default=""
|
2340
|
+
# @return [nil]
|
2341
|
+
def cont_f
|
2342
|
+
end
|
2343
|
+
|