ruby-gr 0.73.6.0 → 0.73.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c49cfd6712b94567eebb2ae2b4e2f67c227acc0bce428c15d777419d4b6ba31b
-  data.tar.gz: ecd7816d1e8f9784169ee9b917189361b18f6424958c70498279731c42c985c0
+  metadata.gz: af97f95dda8fbb4c36e6ea785aff4a2e84ff94999b9e231d1915ebe66faa2a9e
+  data.tar.gz: 44b3bb5edd034a4e6fc0763890be330b175c3241ffe460853ae22bd42ac2a053
 SHA512:
-  metadata.gz: 63bcc49377529b51fbf7d8005ee75c6b3af6961fd96ffd5ae769dbf495b75fbe064f6c50a3e180e1e8030dfa97297abdd4442c89e17b0fea49865e045dbfb464
-  data.tar.gz: 40024235f7e6599a5a9555dacac610a74e4abf1ee07332c7a82a834e3b070d9096d79408e453078014f7f59bdc58182f29a39e8e2afbf5d8b8536a3a6b86eabf
+  metadata.gz: 71043c094117d2876355d3a6cda779ba4eedde5a59049796c7ad987d9ba52545fcdf6806cb1f708d5b878d79c8d21e95b557bc3ebfeeeecbffb3939c2bae0ffe
+  data.tar.gz: 5bb3bbd6baed3c1026ed0e4f89adb3acd15d25455b20e5814f2819fcc11d4f60bc7c41cbddf8a99f5bdd5b6b20e03e66f800432faec559b2a8e8389fe149c787

data/README.md

@@ -2,8 +2,8 @@
 
 [![Gem Version](https://img.shields.io/gem/v/ruby-gr?color=brightgreen)](https://rubygems.org/gems/ruby-gr)
 [![CI](https://github.com/red-data-tools/GR.rb/workflows/CI/badge.svg)](https://github.com/red-data-tools/GR.rb/actions)
-[![Gitter Chat](https://badges.gitter.im/red-data-tools/en.svg)](https://gitter.im/red-data-tools/en)
 [![Docs Latest](https://img.shields.io/badge/docs-latest-blue.svg)](https://red-data-tools.github.io/GR.rb/)
+[![Lines of Code](https://img.shields.io/endpoint?url=https%3A%2F%2Ftokei.kojix2.net%2Fbadge%2Fgithub%2Fred-data-tools%2FGR.rb%2Flines)](https://tokei.kojix2.net/github/red-data-tools/GR.rb)
 
 [![rdatasets-1](https://i.imgur.com/XEQ6wKs.png)](examples/rdatasets.rb)
 [![stem](https://i.imgur.com/3w0Ejrm.png)](examples/fast_plots.rb)
@@ -21,7 +21,7 @@
 [![face](https://i.imgur.com/uLCKi2r.png)](examples/face.rb)
 [![shade](https://i.imgur.com/VJmS3EQ.png)](examples/shade_ex.rb)
 
-:bar_chart:  [GR framework](https://github.com/sciapp/gr) - powerful visualization library - for Ruby
+:bar_chart: [GR framework](https://github.com/sciapp/gr) - powerful visualization library - for Ruby
 
 ## Installation
 
@@ -31,7 +31,7 @@ First, [install GR](#gr-installation). Then install [`gr-plot`](https://github.c
 gem install gr-plot
 ```
 
-[pkg-config](https://github.com/ruby-gnome/pkg-config) will detect the location of the shared library. Otherwise, you need to specify the environment variable. 
+[pkg-config](https://github.com/ruby-gnome/pkg-config) will detect the location of the shared library. Otherwise, you need to specify the environment variable.
 
 ```sh
 export GRDIR="/your/path/to/gr"
@@ -69,7 +69,7 @@ require 'gr/plot'
 GR.plot(x, y)
 ```
 
-List of available functions. 
+List of available functions.
 
 [`plot`](../../wiki/Plotting-functions#plot)
 [`step`](../../wiki/Plotting-functions#step)
@@ -151,7 +151,7 @@ macOS : See ["How to open apps from un-notarized or unidentified developers"](ht
 
 ### Using package managers
 
-The third party GR packages for Mac, Linux and Windows are available for advanced users. However, these packages are provided by OSS volunteers and may not be the latest version or support some features (such as video output). If you find any problem, please report the issue [here](https://github.com/red-data-tools/GR.rb/issues). 
+The third party GR packages for Mac, Linux and Windows are available for advanced users. However, these packages are provided by OSS volunteers and may not be the latest version or support some features (such as video output). If you find any problem, please report the issue [here](https://github.com/red-data-tools/GR.rb/issues).
 
 #### Mac - Homebrew
 
@@ -183,12 +183,12 @@ If you are using Rubyinstaller, pacman will automatically install [mingw-w64-gr]
 GR.rb is a library under development, so even small improvements like fixing typos are welcome!
 Please feel free to send us your PR.
 
-* [Report bugs](https://github.com/red-data-tools/GR.rb/issues)
-* Fix bugs and [submit pull requests](https://github.com/red-data-tools/GR.rb/pulls)
-* Write, clarify, or fix documentation
-* Suggest or add new features
-* Update GR packages ( Homebrew, MinGW, red-data-tools )
-* Create visualization tools based on GR.rb
+- [Report bugs](https://github.com/red-data-tools/GR.rb/issues)
+- Fix bugs and [submit pull requests](https://github.com/red-data-tools/GR.rb/pulls)
+- Write, clarify, or fix documentation
+- Suggest or add new features
+- Update GR packages ( Homebrew, MinGW, red-data-tools )
+- Create visualization tools based on GR.rb
 
 If you are not familiar with Ruby gem development, please see
 [I'm new to Ruby](https://github.com/red-data-tools/GR.rb/wiki/I%27m-new-to-Ruby)

data/lib/gr/ffi.rb

@@ -65,6 +65,39 @@ module GR
       'hexbin_2pass_priv_t *priv'
     ]
 
+    Tick = struct [
+      'double value',
+      'int is_major'
+    ]
+
+    TickLabel = struct [
+      'double tick',
+      'char *label',
+      'double width'
+    ]
+
+    Axis = struct [
+      'double min',
+      'double max',
+      'double tick',
+      'double org',
+      'double position',
+      'int major_count',
+      'int num_ticks',
+      'void *ticks',
+      'double tick_size',
+      'int num_tick_labels',
+      'void *tick_labels',
+      'double label_position',
+      'int draw_axis_line',
+      'int label_orientation'
+    ]
+
+    FormatReference = struct [
+      'char *format',
+      'int length'
+    ]
+
     try_extern 'void gr_initgr(void)'
     try_extern 'int gr_debug(void)'
     try_extern 'void gr_opengks(void)'
@@ -125,8 +158,8 @@ module GR
     try_extern 'void gr_inqfillstyle(int *)'
     try_extern 'void gr_setfillcolorind(int)'
     try_extern 'void gr_inqfillcolorind(int *)'
-    try_extern 'void gr_setresizebehaviour(int)'
-    try_extern 'void gr_inqresizebehaviour(int *)'
+    try_extern 'void gr_setnominalsize(double)'
+    try_extern 'void gr_inqnominalsize(double *)'
     try_extern 'void gr_setcolorrep(int, double, double, double)'
     try_extern 'void gr_setwindow(double, double, double, double)'
     try_extern 'void gr_inqwindow(double *, double *, double *, double *)'
@@ -212,6 +245,8 @@ module GR
     try_extern 'char *gr_getgraphics(void)'
     try_extern 'int gr_drawgraphics(char *)'
     try_extern 'int gr_startlistener(void)'
+    try_extern 'int gr_inqgrplotport(void)'
+    try_extern 'int gr_setgrplotport(int)'
     try_extern 'void gr_mathtex(double, double, char *)'
     try_extern 'void gr_inqmathtex(double, double, char *, double *, double *)'
     try_extern 'void gr_mathtex3d(double, double, double, char *, int)'
@@ -223,6 +258,8 @@ module GR
     try_extern 'void gr_moveselection(double, double)'
     try_extern 'void gr_resizeselection(int, double, double)'
     try_extern 'void gr_inqbbox(double *, double *, double *, double *)'
+    try_extern 'void gr_setbackground(void)'
+    try_extern 'void gr_clearbackground(void)'
     try_extern 'double gr_precision(void)'
     try_extern 'int gr_text_maxsize(void)'
     try_extern 'void gr_setregenflags(int)'
@@ -239,6 +276,7 @@ module GR
     try_extern 'void gr_trisurface(int, double *, double *, double *)'
     try_extern 'void gr_gradient(int, int, double *, double *, double *, double *, double *)'
     try_extern 'void gr_quiver(int, int, double *, double *, double *, double *, int)'
+    typealias 'interp2_method_t', 'int'
     try_extern 'void gr_interp2(int nx, int ny, const double *x, const double *y, const double *z,' \
                ' int nxq, int nyq, const double *xq, const double *yq, double *zq,' \
                ' interp2_method_t method, double extrapval)'
@@ -257,6 +295,7 @@ module GR
     try_extern 'void gr_inqbordercolorind(int *)'
     try_extern 'void gr_selectclipxform(int)'
     try_extern 'void gr_inqclipxform(int *)'
+    try_extern 'void gr_inqclip(int *, double *)'
     try_extern 'void gr_setprojectiontype(int)'
     try_extern 'void gr_inqprojectiontype(int *)'
     try_extern 'void gr_setperspectiveprojection(double, double, double)'
@@ -303,6 +342,8 @@ module GR
     try_extern 'void gr_inqmathfont(int *font)'
     try_extern 'void gr_setclipregion(int region)'
     try_extern 'void gr_inqclipregion(int *region)'
+    try_extern 'void gr_setclipsector(double start_angle, double end_angle)'
+    try_extern 'void gr_inqclipsector(double *start_angle, double *end_angle)'
     try_extern 'void gr_settextoffset(double xoff, double yoff)'
     try_extern 'char *gr_ftoa(char *string, double value, format_reference_t *reference)'
     try_extern 'void gr_getformat(format_reference_t *result, double origin, double min, double max, double tick_width, int major)'

data/lib/gr.rb

@@ -137,7 +137,7 @@ module GR
     #  * 371       : Gtk
     #  * 380       : wxWidgets
     #  * 381       : Qt4
-    #  * 382       : Scaleable Vector Graphics (SVG)
+    #  * 382       : Scalable Vector Graphics (SVG)
     #  * 390       : Windows Metafile
     #  * 400       : Quartz
     #  * 410       : Socket driver
@@ -519,7 +519,7 @@ module GR
       inquiry_int { |pt| super(pt) }
     end
 
-    # Specifiy the marker type for polymarkers.
+    # Specify the marker type for polymarkers.
     #
     # @param style [Integer] The polymarker marker type
     #  * 1   : MARKERTYPE_DOT             - Smallest displayable dot
@@ -732,7 +732,7 @@ module GR
     #  * 3 : TEXT_HALIGN_RIGHT  - Right justify
     #
     # @param vertical [Integer] Vertical text alignment
-    #  * 0 : TEXT_VALIGN_NORMAL   
+    #  * 0 : TEXT_VALIGN_NORMAL
     #  * 1 : TEXT_VALIGN_TOP    - Align with the top of the characters
     #  * 2 : TEXT_VALIGN_CAP    - Aligned with the cap of the characters
     #  * 3 : TEXT_VALIGN_HALF   - Aligned with the half line of the characters
@@ -1116,6 +1116,52 @@ module GR
 
     alias axes2d axes
 
+    def axis(option, min: Float::NAN, max: Float::NAN, tick: Float::NAN, org: Float::NAN, position: Float::NAN, major_count: 1,
+             tick_size: Float::NAN, label_position: Float::NAN, draw_axis_line: 1, label_orientation: 0)
+      ax = FFI::Axis.malloc
+      ax.min = min
+      ax.max = max
+      ax.tick = tick
+      ax.org = org
+      ax.position = position
+      ax.major_count = major_count
+      ax.tick_size = tick_size
+      ax.label_position = label_position
+      ax.draw_axis_line = draw_axis_line
+      ax.label_orientation = label_orientation
+      ax.ticks = FFI::Pointer::NULL
+      ax.num_ticks = 0
+      ax.tick_labels = FFI::Pointer::NULL
+      ax.num_tick_labels = 0
+      super(option, ax)
+      ax
+    end
+
+    def drawaxis(option, min: Float::NAN, max: Float::NAN, tick: Float::NAN, org: Float::NAN, position: Float::NAN,
+                 major_count: 1, tick_size: Float::NAN, label_position: Float::NAN, draw_axis_line: 1, label_orientation: 0)
+      ax = FFI::Axis.malloc
+      ax.min = min
+      ax.max = max
+      ax.tick = tick
+      ax.org = org
+      ax.position = position
+      ax.major_count = major_count
+      ax.tick_size = tick_size
+      ax.label_position = label_position
+      ax.draw_axis_line = draw_axis_line
+      ax.label_orientation = label_orientation
+      ax.ticks = FFI::Pointer::NULL
+      ax.num_ticks = 0
+      ax.tick_labels = FFI::Pointer::NULL
+      ax.num_tick_labels = 0
+      super(option, ax)
+      ax
+    end
+
+    def drawaxes(x_axis, y_axis, option = 1)
+      super(x_axis, y_axis, option)
+    end
+
     # Create axes in the current workspace and supply a custom function for
     # changing the behaviour of the tick labels.
     #
@@ -1348,9 +1394,10 @@ module GR
     #  * 6 SHADED_MESH   - Applies light source shading to the 3-D surface
     #
     def surface(x, y, z, option)
-      # TODO: check: Arrays have incorrect length or dimension.
       nx = x.length
       ny = y.length
+      raise ArgumentError, "z must have length nx * ny (expected #{nx * ny}, got #{z.length})" if z.length != nx * ny
+
       super(nx, ny, x, y, z, option)
     end
 
@@ -1376,10 +1423,11 @@ module GR
     #   of 1000 to `major_h`.
     #
     def contour(x, y, h, z, major_h)
-      # TODO: check: Arrays have incorrect length or dimension.
       nx = x.length
       ny = y.length
       nh = h.length
+      raise ArgumentError, "z must have length nx * ny (expected #{nx * ny}, got #{z.length})" if z.length != nx * ny
+
       super(nx, ny, nh, x, y, h, z, major_h)
     end
 
@@ -1401,10 +1449,11 @@ module GR
     #   array containing the Z coordinates
     #
     def contourf(x, y, h, z, major_h)
-      # TODO: check: Arrays have incorrect length or dimension.
       nx = x.length
       ny = y.length
       nh = h.length
+      raise ArgumentError, "z must have length nx * ny (expected #{nx * ny}, got #{z.length})" if z.length != nx * ny
+
       super(nx, ny, nh, x, y, h, z, major_h)
     end
 
@@ -1416,7 +1465,7 @@ module GR
     # @param levels [Array, NArray] A list of contour levels
     #
     def tricontour(x, y, z, levels)
-      npoints = x.length # equal_length ?
+      npoints = equal_length(x, y, z)
       nlevels = levels.length
       super(npoints, x, y, z, nlevels, levels)
     end
@@ -1919,9 +1968,10 @@ module GR
 
     # @deprecated
     def gradient(x, y, z)
-      # TODO: check: Arrays have incorrect length or dimension.
       nx = x.length
       ny = y.length
+      raise ArgumentError, "z must have length nx * ny (expected #{nx * ny}, got #{z.length})" if z.length != nx * ny
+
       inquiry [{ double: nx * ny }, { double: nx * ny }] do |pu, pv|
         super(nx, ny, x, y, z, pu, pv)
       end
@@ -1942,9 +1992,12 @@ module GR
     # The values for `x` and `y` are in world coordinates.
     #
     def quiver(x, y, u, v, color)
-      # TODO: check: Arrays have incorrect length or dimension.
       nx = x.length
       ny = y.length
+      if u.length != nx * ny || v.length != nx * ny
+        raise ArgumentError, "u and v must have length nx * ny (expected #{nx * ny}, got u: #{u.length}, v: #{v.length})"
+      end
+
       super(nx, ny, x, y, u, v, (color ? 1 : 0))
     end
 
@@ -2419,6 +2472,45 @@ module GR
       n_connections = colors.length
       super(n_points, px, py, pz, n_connections, int(connections), int(colors))
     end
+
+    # @return [Integer]
+    def startlistener
+      inquiry_int do |ret|
+        super(ret)
+      end
+    end
+
+    # @!method setmathfont
+
+    def inqmathfont
+      inquiry_int { |pt| super(pt) }
+    end
+
+    # @!method setclipregion
+
+    def inqclipregion
+      inquiry_int { |pt| super(pt) }
+    end
+
+    # @!method setclipsector
+
+    def inqclipsector
+      inquiry %i[double double] do |*pts|
+        super(*pts)
+      end
+    end
+
+    def getformat(origin, min, max, tick_width, major)
+      ref = FFI::FormatReference.malloc
+      super(ref, origin, min, max, tick_width, major)
+      ref
+    end
+
+    def ftoa(value, format_ref)
+      string = Fiddle::Pointer.malloc(256)
+      super(string, value, format_ref)
+      string.to_s
+    end
   end
 
   ASF_BUNDLED    = 0
@@ -2506,12 +2598,29 @@ module GR
   MARKERTYPE_HLINE           = -31
   MARKERTYPE_OMARK           = -32
 
+  AXES_SIMPLE_AXES = 1
+  AXES_TWIN_AXES   = 2
+  AXES_WITH_GRID   = 4
+
+  REGION_RECTANGLE = 0
+  REGION_ELLIPSE   = 1
+
   OPTION_X_LOG  =  1
   OPTION_Y_LOG  =  2
   OPTION_Z_LOG  =  4
   OPTION_FLIP_X =  8
   OPTION_FLIP_Y = 16
   OPTION_FLIP_Z = 32
+  OPTION_X_LOG2 = 64
+  OPTION_Y_LOG2 = 128
+  OPTION_Z_LOG2 = 256
+  OPTION_X_LN   = 512
+  OPTION_Y_LN   = 1024
+  OPTION_Z_LN   = 2048
+
+  SPEC_LINE   = 1
+  SPEC_MARKER = 2
+  SPEC_COLOR  = 4
 
   OPTION_LINES         = 0
   OPTION_MESH          = 1
@@ -2520,6 +2629,7 @@ module GR
   OPTION_COLORED_MESH  = 4
   OPTION_CELL_ARRAY    = 5
   OPTION_SHADED_MESH   = 6
+  OPTION_3D_MESH       = 7
 
   MODEL_RGB = 0
   MODEL_HSV = 1

data/lib/gr3.rb

@@ -288,7 +288,7 @@ module GR3
     #
     # This function does not return an error code, because of its asynchronous
     # nature. If gr3_getpixmap_() returns a GR3_ERROR_OPENGL_ERR, this might be
-    # caused by this function saving unuseable data into the draw list.
+    # caused by this function saving unusable data into the draw list.
     #
     # @param mesh       [Integer]       The mesh to be drawn
     # @param n          [Integer]       The number of meshes to be drawn
@@ -593,6 +593,70 @@ module GR3
       drawspins(positions, spins, colors)
     end
 
+    # @!method setalphamode
+
+    # @return [Integer]
+    def getalphamode
+      inquiry_int do |mode|
+        super(mode)
+      end
+    end
+
+    # @!method setlightsources
+
+    # @return [Integer]
+    def getlightsources(max_num_lights = 16)
+      positions = GRCommons::Fiddley::MemoryPointer.new(:float, max_num_lights * 3)
+      colors = GRCommons::Fiddley::MemoryPointer.new(:float, max_num_lights * 3)
+      num_lights = super(max_num_lights, positions, colors)
+      # TODO: Return arrays instead of pointers?
+      # For now, returning pointers as they might be large?
+      # But usually we want ruby objects.
+      # Let's convert them to arrays if num_lights > 0
+      pos_arr = positions.read_array_of_float(num_lights * 3).each_slice(3).to_a
+      col_arr = colors.read_array_of_float(num_lights * 3).each_slice(3).to_a
+      [num_lights, pos_arr, col_arr]
+    end
+
+    # @!method setlightparameters
+
+    # @return [Array<Float>]
+    def getlightparameters
+      inquiry %i[float float float float] do |ambient, diffuse, specular, specular_power|
+        super(ambient, diffuse, specular, specular_power)
+      end
+    end
+
+    # @!method setdefaultlightparameters
+
+    # @!method setclipping
+
+    # @return [Array<Float>]
+    def getclipping
+      inquiry %i[float float float float float float] do |xmin, xmax, ymin, ymax, zmin, zmax|
+        super(xmin, xmax, ymin, ymax, zmin, zmax)
+      end
+    end
+
+    # @!method setsurfaceoption
+
+    # @return [Integer]
+    def getsurfaceoption
+      super
+    end
+
+    # @param data [NArray] 3D narray array containing the voxel data
+    # @param isovalue [Float] isovalue at which the surface will be created
+    # @param color [Array, NArray] the color of the surface
+    # @param strides [Array, NArray] the strides in each direction
+    def isosurface(data, isovalue = 0.5, color = nil, strides = nil)
+      nx, ny, nz = data.shape
+      color ||= [1.0, 1.0, 1.0]
+      strides ||= [1, 1, 1]
+      strides = GRCommons::GRCommonUtils.int(strides)
+      super(nx, ny, nz, data, isovalue, color, strides)
+    end
+
     # Creates meshes for slices through the given data, using the current GR
     # colormap. Use the parameters x, y or z to specify what slices should be
     # drawn and at which positions they should go through the data. If neither

data/lib/gr_commons/gr_logger.rb

@@ -34,7 +34,7 @@ module GRCommons
   #
   # @note Mainly used by developers for debugging.
   #
-  # = How it works　
+  # = How it works
   # It prepend a module named Inspector to the singular class of the FFI module.
   # It will inspects the GR function call of the FFI module
   #

data/lib/gr_commons/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GRCommons
-  VERSION = '0.73.6.0'
+  VERSION = '0.73.19.0'
 end

data/lib/grm/ffi.rb

@@ -21,7 +21,7 @@ module GRM
     # header files.
 
     # https://github.com/sciapp/gr/blob/master/lib/grm/include/grm/args.h
-    try_extern 'grm_args_value_iterator_t *grm_arg_value_iter(const arg_t *arg)'
+    try_extern 'grm_args_value_iterator_t *grm_arg_value_iter(const grm_arg_t *arg)'
     try_extern 'grm_args_t *grm_args_new(void)'
     try_extern 'void grm_args_delete(grm_args_t *args)'
     try_extern 'int grm_args_push(grm_args_t *args, const char *key, const char *value_format, ...)'
@@ -39,6 +39,9 @@ module GRM
     try_extern 'void grm_dump(const grm_args_t *args, FILE *f)'
     try_extern 'void grm_dump_json(const grm_args_t *args, FILE *f)'
     try_extern 'char *grm_dump_json_str(void)'
+    try_extern 'char *grm_dump_html(char *plot_id)'
+    try_extern 'char *grm_dump_html_args(char *plot_id, grm_args_t *args)'
+    try_extern 'void grm_dump_bson(const grm_args_t *args, FILE *f)'
 
     # https://github.com/sciapp/gr/blob/master/lib/grm/include/grm/event.h
     typealias 'grm_event_type_t', 'int' # enum
@@ -71,7 +74,7 @@ module GRM
     try_extern 'int grm_clear(void)'
     try_extern 'void grm_dump_graphics_tree(FILE *f)'
     try_extern 'char *grm_dump_graphics_tree_str(void)'
-    try_extern 'unsigned int grm_max_plotid(void)'
+    try_extern 'unsigned int grm_max_plot_id(void)'
     try_extern 'int grm_merge(const grm_args_t *args)'
     try_extern 'int grm_merge_extended(const grm_args_t *args, int hold, const char *identificator)'
     try_extern 'int grm_merge_hold(const grm_args_t *args)'
@@ -81,6 +84,19 @@ module GRM
     try_extern 'int grm_process_tree(void)'
     try_extern 'int grm_export(const char *file_path)'
     try_extern 'int grm_switch(unsigned int id)'
+    try_extern 'int grm_get_error_code()'
     try_extern 'int grm_load_graphics_tree(FILE *file)'
+    try_extern 'int grm_validate(void)'
+    # The following functions use C++ types that cannot be parsed by Fiddle
+    # try_extern 'std::shared_ptr<GRM::Element> grm_get_document_root(void)'
+    # try_extern 'std::shared_ptr<GRM::Render> grm_get_render(void)'
+    # try_extern 'int grm_iterate_grid(GRM::Grid *grid, const std::shared_ptr<GRM::Element> &parent_dom_element, int plot_id)'
+    # try_extern 'int grm_plot_helper(GRM::GridElement *grid_element, GRM::Slice *slice, const std::shared_ptr<GRM::Element> &parent_dom_element, int plot_id)'
+    # try_extern 'std::shared_ptr<GRM::Element> grm_get_subplot_from_ndc_point_using_dom(double x, double y)'
+    # try_extern 'std::shared_ptr<GRM::Element> grm_get_subplot_from_ndc_points_using_dom(unsigned int n, const double *x, const double *y)'
+    # try_extern 'void grm_set_attribute_on_all_subplots(std::string attribute, int value)'
+    # try_extern 'int grm_get_focus_and_factor_from_dom(const int x1, const int y1, const int x2, const int y2, const int keep_aspect_ratio, double *factor_x, double *factor_y, double *focus_x, double *focus_y, std::shared_ptr<GRM::Element> &subplot_element)'
+    # try_extern 'std::map<std::string, std::list<std::string>> grm_get_context_data()'
+    # try_extern 'std::shared_ptr<GRM::Document> grm_load_graphics_tree_schema(bool with_private_attributes = false)'
   end
 end

data/lib/grm.rb

@@ -67,15 +67,13 @@ module GRM
         case value
         when Hash
           new(**value)
-        else
-          nil
         end
       end
     end
 
     def initialize(**args)
       @args = GRM.args_new
-      @args.free = FFI["grm_args_delete"]
+      @args.free = FFI['grm_args_delete']
       @references = []
       args.each do |key, value|
         push(key, value)
@@ -84,44 +82,86 @@ module GRM
 
     def push(key, value)
       key = key.to_s if key.is_a?(Symbol)
+
+      # Support Numo::NArray transparently when available
+      if defined?(Numo::NArray) && value.is_a?(Numo::NArray)
+        shape = value.shape
+        case shape.length
+        when 1
+          # 1D NArray: delegate to existing Array handling
+          return push(key, value.to_a)
+        when 2
+          # 2D NArray: convert to nested Array and reuse 2D Array path
+          rows, cols = shape
+          nested = Array.new(rows) do |r|
+            Array.new(cols) do |c|
+              value[r, c]
+            end
+          end
+          return push(key, nested)
+        else
+          raise ArgumentError, "Numo::NArray with dimension > 2 is not supported for key '#{key}'"
+        end
+      end
+
       case value
       when String
-        GRM.args_push(@args, key, "s", :const_string, value)
+        GRM.args_push(@args, key, 's', :const_string, value)
       when Integer
-        GRM.args_push(@args, key, "i", :int, value)
+        GRM.args_push(@args, key, 'i', :int, value)
       when Float
-        GRM.args_push(@args, key, "d", :double, value)
+        GRM.args_push(@args, key, 'd', :double, value)
       when Args
-        GRM.args_push(@args, key, "a", :voidp, value.address)
+        GRM.args_push(@args, key, 'a', :voidp, value.address)
         value.to_gr.free = nil
       when Array
+        raise ArgumentError, "Array value for key '#{key}' cannot be empty" if value.empty?
+
+        # Handle 2D Array (Matrix): flatten and add dimensions
+        if value[0].is_a?(Array)
+          rows = value.size
+          cols = value[0].size
+          # Validate that all rows have the same length
+          unless value.all? { |row| row.size == cols }
+            raise ArgumentError, "All rows in 2D array for key '#{key}' must have the same length"
+          end
+
+          # Flatten in row-major order
+          flattened = value.flatten
+
+          push(key, flattened)
+          # GRM expects dims in [width, height] order (columns, rows)
+          push("#{key}_dims", [cols, rows])
+          return
+        end
+
         case value[0]
         when String
-          addresses = value.collect {|v| Fiddle::Pointer[v].to_i}
-          GRM.args_push(@args, key, "nS",
+          addresses = value.collect { |v| Fiddle::Pointer[v].to_i }
+          GRM.args_push(@args, key, 'nS',
                         :int, value.size,
-                        :voidp, addresses.pack("J*"))
+                        :voidp, addresses.pack('J*'))
         when Integer
-          GRM.args_push(@args, key, "nI",
+          GRM.args_push(@args, key, 'nI',
                         :int, value.size,
-                        :voidp, value.pack("i*"))
+                        :voidp, value.pack('i*'))
         when Float
-          GRM.args_push(@args, key, "nD",
+          GRM.args_push(@args, key, 'nD',
                         :int, value.size,
-                        :voidp, value.pack("d*"))
+                        :voidp, value.pack('d*'))
         when Args
-          GRM.args_push(@args, key, "nA",
+          GRM.args_push(@args, key, 'nA',
                         :int, value.size,
-                        :voidp, value.collect(&:address).pack("J*"))
+                        :voidp, value.collect(&:address).pack('J*'))
           value.each do |v|
             v.to_gr.free = nil
           end
         else
-          vs = value.collect {|v| Args.new(**v)}
+          vs = value.collect { |v| Args.new(**v) }
           @references.concat(vs)
-          GRM.args_push(@args, key, "nA",
+          GRM.args_push(@args, key, 'nA',
                         :int, value.size,
-                        :voidp, vs.collect(&:address).pack("J*"))
+                        :voidp, vs.collect(&:address).pack('J*'))
           vs.each do |v|
             v.to_gr.free = nil
           end
@@ -129,7 +169,7 @@ module GRM
       else
         v = Args.new(**value)
         @references << v
-        GRM.args_push(@args, key, "a", :voidp, v.address)
+        GRM.args_push(@args, key, 'a', :voidp, v.address)
         v.to_gr.free = nil
       end
     end
@@ -149,24 +189,29 @@ module GRM
   end
 
   class << self
-    def merge(args=nil)
-      super(Args.try_convert(args) || args)
+    def merge(args = nil)
+      args = Args.try_convert(args) || args
+      super(args)
     end
 
-    def merge_extended(args=nil, hold=0, identifiator=nil)
-      super(Args.try_convert(args) || args, hold, identificator)
+    def merge_extended(args = nil, hold = 0, identificator = nil)
+      args = Args.try_convert(args) || args
+      super(args, hold, identificator)
     end
 
-    def merge_hold(args=nil)
-      super(Args.try_convert(args) || args)
+    def merge_hold(args = nil)
+      args = Args.try_convert(args) || args
+      super(args)
     end
 
-    def merge_named(args=nil, identifiator=nil)
-      super(Args.try_convert(args) || args, identificator)
+    def merge_named(args = nil, identificator = nil)
+      args = Args.try_convert(args) || args
+      super(args, identificator)
     end
 
-    def plot(args=nil)
-      super(Args.try_convert(args) || args)
+    def plot(args = nil)
+      args = Args.try_convert(args) || args
+      super(args)
     end
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ruby-gr
 version: !ruby/object:Gem::Version
-  version: 0.73.6.0
+  version: 0.73.19.0
 platform: ruby
 authors:
 - kojix2
 bindir: bin
 cert_chain: []
-date: 2024-08-06 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fiddle
@@ -24,7 +24,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 1.1.0
 - !ruby/object:Gem::Dependency
-  name: numo-narray
+  name: numo-narray-alt
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -99,7 +99,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.0.dev
+rubygems_version: 3.7.2
 specification_version: 4
 summary: GR for Ruby
 test_files: []