ruby-gr 0.0.20 → 0.0.25
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/LICENSE.txt +2 -2
- data/README.md +44 -36
- data/lib/gr.rb +1022 -843
- data/lib/gr/ffi.rb +5 -2
- data/lib/gr/plot.rb +93 -41
- data/lib/gr3.rb +305 -246
- data/lib/gr3/ffi.rb +1 -1
- data/lib/gr_commons/define_methods.rb +5 -5
- data/lib/gr_commons/fiddley.rb +7 -7
- data/lib/gr_commons/gr_common_utils.rb +4 -4
- data/lib/gr_commons/gr_commons.rb +5 -1
- data/lib/gr_commons/gr_lib.rb +83 -0
- data/lib/gr_commons/gr_logger.rb +106 -0
- data/lib/gr_commons/jupyter_support.rb +5 -5
- data/lib/gr_commons/{extern.rb → try_extern.rb} +1 -1
- data/lib/gr_commons/version.rb +1 -1
- data/lib/grm.rb +34 -17
- data/lib/grm/ffi.rb +28 -14
- metadata +21 -6
- data/lib/gr/plot.rb.md +0 -172
data/lib/gr3/ffi.rb
CHANGED
@@ -5,8 +5,8 @@ module GRCommons
|
|
5
5
|
module DefineMethods
|
6
6
|
private
|
7
7
|
|
8
|
-
def define_ffi_methods(
|
9
|
-
|
8
|
+
def define_ffi_methods(ffi_module, prefix: '', default_type: :double)
|
9
|
+
ffi_module.ffi_methods.each do |method|
|
10
10
|
# Use delete_prefix (Ruby >= 2.5)
|
11
11
|
method_name = method.to_s.sub(/^#{prefix}/, '')
|
12
12
|
|
@@ -16,14 +16,14 @@ module GRCommons
|
|
16
16
|
args.map! do |arg|
|
17
17
|
case arg
|
18
18
|
when Array
|
19
|
-
GRCommons::GRCommonUtils.
|
19
|
+
GRCommons::GRCommonUtils.public_send(default_type, arg)
|
20
20
|
when ->(x) { defined?(Numo::NArray) && x.is_a?(Numo::NArray) }
|
21
|
-
GRCommons::GRCommonUtils.
|
21
|
+
GRCommons::GRCommonUtils.public_send(default_type, arg)
|
22
22
|
else
|
23
23
|
arg
|
24
24
|
end
|
25
25
|
end
|
26
|
-
|
26
|
+
ffi_module.public_send(method, *args)
|
27
27
|
end
|
28
28
|
end
|
29
29
|
end
|
data/lib/gr_commons/fiddley.rb
CHANGED
@@ -13,7 +13,7 @@ module GRCommons
|
|
13
13
|
# NOTE: This module is only part of the original code.
|
14
14
|
# kojix2 adds, deletes, and modifies several methods.
|
15
15
|
module Fiddley
|
16
|
-
# NOTE: GR.rb supports 2.
|
16
|
+
# NOTE: GR.rb supports 2.5 +. Unpack 1 does not work under 2.3.
|
17
17
|
|
18
18
|
module Utils
|
19
19
|
# assumes short = 16bit, int = 32bit, long long = 64bit
|
@@ -210,7 +210,7 @@ module GRCommons
|
|
210
210
|
end
|
211
211
|
|
212
212
|
define_method("put_array_of_int#{bits}") do |offset, ary|
|
213
|
-
put_bytes(offset, ary.pack(form
|
213
|
+
put_bytes(offset, ary.pack("#{form}*"))
|
214
214
|
end
|
215
215
|
|
216
216
|
define_method("write_array_of_int#{bits}") do |ary|
|
@@ -226,7 +226,7 @@ module GRCommons
|
|
226
226
|
end
|
227
227
|
|
228
228
|
define_method("get_array_of_int#{bits}") do |offset, num|
|
229
|
-
@ptr[offset, bytes * num].unpack(form
|
229
|
+
@ptr[offset, bytes * num].unpack("#{form}*")
|
230
230
|
end
|
231
231
|
|
232
232
|
define_method("read_array_of_int#{bits}") do |num|
|
@@ -244,7 +244,7 @@ module GRCommons
|
|
244
244
|
end
|
245
245
|
|
246
246
|
define_method("put_array_of_uint#{bits}") do |offset, ary|
|
247
|
-
put_bytes(offset, ary.pack(form2
|
247
|
+
put_bytes(offset, ary.pack("#{form2}*"))
|
248
248
|
end
|
249
249
|
|
250
250
|
define_method("write_array_of_uint#{bits}") do |ary|
|
@@ -260,7 +260,7 @@ module GRCommons
|
|
260
260
|
end
|
261
261
|
|
262
262
|
define_method("get_array_of_uint#{bits}") do |offset, num|
|
263
|
-
@ptr[offset, bytes * num].unpack(form2
|
263
|
+
@ptr[offset, bytes * num].unpack("#{form2}*")
|
264
264
|
end
|
265
265
|
|
266
266
|
define_method("read_array_of_uint#{bits}") do |num|
|
@@ -330,12 +330,12 @@ module GRCommons
|
|
330
330
|
|
331
331
|
# added
|
332
332
|
define_method('get_array_of_double') do |offset, num|
|
333
|
-
@ptr[offset, 8 * num].unpack('d
|
333
|
+
@ptr[offset, 8 * num].unpack('d*')
|
334
334
|
end
|
335
335
|
|
336
336
|
# added
|
337
337
|
define_method('get_array_of_float') do |offset, num|
|
338
|
-
@ptr[offset, 4 * num].unpack('f
|
338
|
+
@ptr[offset, 4 * num].unpack('f*')
|
339
339
|
end
|
340
340
|
|
341
341
|
# added
|
@@ -1,6 +1,6 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
-
|
3
|
+
require_relative 'fiddley'
|
4
4
|
|
5
5
|
module GRCommons
|
6
6
|
# This module provides functionality common to GR and GR3.
|
@@ -52,7 +52,7 @@ module GRCommons
|
|
52
52
|
if narray?(data)
|
53
53
|
Numo::UInt32.cast(data).to_binary
|
54
54
|
else
|
55
|
-
Fiddley::Utils.array2str(:
|
55
|
+
Fiddley::Utils.array2str(:uint32, data.to_a.flatten)
|
56
56
|
end
|
57
57
|
end
|
58
58
|
|
@@ -117,9 +117,9 @@ module GRCommons
|
|
117
117
|
when Hash
|
118
118
|
typ = type.keys[0]
|
119
119
|
len = type.values[0]
|
120
|
-
pt.
|
120
|
+
pt.public_send("read_array_of_#{typ}", len)
|
121
121
|
else
|
122
|
-
pt.
|
122
|
+
pt.public_send("read_#{type}")
|
123
123
|
end
|
124
124
|
end
|
125
125
|
|
@@ -4,7 +4,11 @@
|
|
4
4
|
module GRCommons
|
5
5
|
end
|
6
6
|
|
7
|
-
|
7
|
+
# Change the default encoding to UTF-8.
|
8
|
+
ENV['GKS_ENCODING'] ||= 'utf8'
|
9
|
+
|
10
|
+
require_relative 'gr_lib'
|
11
|
+
require_relative 'try_extern'
|
8
12
|
require_relative 'define_methods'
|
9
13
|
require_relative 'gr_common_utils'
|
10
14
|
require_relative 'jupyter_support'
|
@@ -0,0 +1,83 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
require 'pkg-config'
|
4
|
+
|
5
|
+
module GRCommons
|
6
|
+
# This module helps GR, GR and GRM to search the shared library.
|
7
|
+
#
|
8
|
+
# The order of priority:
|
9
|
+
# 1. RubyInstaller ( for Windows only )
|
10
|
+
# 2. Environment variable GRDIR
|
11
|
+
# 3. pkg-config : https://github.com/ruby-gnome/pkg-config
|
12
|
+
# The following packages (should) support pkg-config.
|
13
|
+
# - Linux
|
14
|
+
# - Red Data Tools https://github.com/red-data-tools/packages.red-data-tools.org
|
15
|
+
# - libgr-dev
|
16
|
+
# - libgr3-dev
|
17
|
+
# - libgrm-dev
|
18
|
+
# - Mac
|
19
|
+
# - Homebrew https://github.com/Homebrew/homebrew-core
|
20
|
+
# - libgr
|
21
|
+
# - Windows
|
22
|
+
# - MinGW https://github.com/msys2/MINGW-packages
|
23
|
+
# - mingw-w64-gr
|
24
|
+
module GRLib
|
25
|
+
class << self
|
26
|
+
# Search the shared library.
|
27
|
+
# @note This method does not detect the Operating System.
|
28
|
+
#
|
29
|
+
# @param lib_names [Array] The actual file name of the shared library.
|
30
|
+
# @param pkg_name [String] The package name to be used when searching with pkg-configg
|
31
|
+
def search(lib_names, pkg_name)
|
32
|
+
def lib_names.map_find(&block)
|
33
|
+
lazy.map(&block).find { |path| path }
|
34
|
+
end
|
35
|
+
# Windows + RubyInstaller
|
36
|
+
if Object.const_defined?(:RubyInstaller)
|
37
|
+
dir = ENV['GRDIR'] || [
|
38
|
+
RubyInstaller::Runtime.msys2_installation.msys_path,
|
39
|
+
RubyInstaller::Runtime.msys2_installation.mingwarch
|
40
|
+
].join(File::ALT_SEPARATOR)
|
41
|
+
lib_names.lazy.map do |lib_name|
|
42
|
+
recursive_search(lib_name, dir)
|
43
|
+
end.find { |i| i }.tap do |path|
|
44
|
+
RubyInstaller::Runtime.add_dll_directory(File.dirname(path)) if path
|
45
|
+
end
|
46
|
+
# ENV['GRDIR'] (Linux, Mac, Windows)
|
47
|
+
elsif ENV['GRDIR']
|
48
|
+
# Search for XXX.dylib and then XXX.so on macOS
|
49
|
+
lib_names.map_find do |lib_name|
|
50
|
+
recursive_search(lib_name, ENV['GRDIR'])
|
51
|
+
end || lib_names.map_find do |lib_name|
|
52
|
+
pkg_config_search(lib_name, pkg_name)
|
53
|
+
end
|
54
|
+
else
|
55
|
+
lib_names.map_find do |lib_name|
|
56
|
+
pkg_config_search(lib_name, pkg_name)
|
57
|
+
end
|
58
|
+
end
|
59
|
+
end
|
60
|
+
|
61
|
+
# Recursive file search in directories
|
62
|
+
# @param name [String] File to search for
|
63
|
+
# @param base_dir [String] Directory to search
|
64
|
+
# @retrun path [String, NilClass] Returns the first path found.
|
65
|
+
# If not found, nil is returned.
|
66
|
+
def recursive_search(name, base_dir)
|
67
|
+
Dir.chdir(base_dir) do
|
68
|
+
paths = Dir["**/#{name}"].sort
|
69
|
+
warn "More than one file found: #{paths}" if paths.size > 1
|
70
|
+
path = paths.first
|
71
|
+
File.expand_path(path) if path
|
72
|
+
end
|
73
|
+
end
|
74
|
+
|
75
|
+
# Use pkg-config to search for shared libraries
|
76
|
+
def pkg_config_search(lib_name, pkg_name)
|
77
|
+
PKGConfig.variable(pkg_name, 'sopath')
|
78
|
+
rescue PackageConfig::NotFoundError => e
|
79
|
+
warn "#{e.message} Cannot find #{lib_name}. "
|
80
|
+
end
|
81
|
+
end
|
82
|
+
end
|
83
|
+
end
|
@@ -0,0 +1,106 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# This script was created primarily for debugging purposes.
|
4
|
+
# Note: This script should be isolated.
|
5
|
+
# It should not be loaded when gr_commons/gr_commons is loaded.
|
6
|
+
|
7
|
+
require 'logger'
|
8
|
+
require 'rainbow'
|
9
|
+
require 'awesome_print'
|
10
|
+
|
11
|
+
module GRCommons
|
12
|
+
class << self
|
13
|
+
# Create a new GRLogger
|
14
|
+
# @param out [String]
|
15
|
+
# @return [GRLogger]
|
16
|
+
# @example
|
17
|
+
# require 'gr_commons/gr_logger'
|
18
|
+
# GRCommons.gr_log("log.txt")
|
19
|
+
def gr_log(out = $stderr)
|
20
|
+
GRCommons::GRLogger.new(out)
|
21
|
+
end
|
22
|
+
|
23
|
+
# Return the last created GRLogger
|
24
|
+
# @return [GRLogger]
|
25
|
+
def gr_logger
|
26
|
+
GRCommons::GRLogger.logger
|
27
|
+
end
|
28
|
+
end
|
29
|
+
|
30
|
+
# Outputs function calls to GR Framework to a log file.
|
31
|
+
# Mainly used for debugging.
|
32
|
+
# @note This module is for those who want to see low-level function calls in GR.
|
33
|
+
#
|
34
|
+
# = How it works
|
35
|
+
# prepend a module named Inspector to the singular class
|
36
|
+
# of the FFI module. It will inspects the GR function call of the FFI module
|
37
|
+
#
|
38
|
+
# @example
|
39
|
+
# require 'gr_commons/gr_logger'
|
40
|
+
# GRCommons.gr_log("log.txt")
|
41
|
+
class GRLogger < Logger
|
42
|
+
# Return the last created GRLogger
|
43
|
+
def self.logger
|
44
|
+
@@logger ||= GRCommons::GRLogger.new
|
45
|
+
end
|
46
|
+
|
47
|
+
def initialize(out = $stderr)
|
48
|
+
super(out, level: :info)
|
49
|
+
@@logger ||= self
|
50
|
+
end
|
51
|
+
end
|
52
|
+
end
|
53
|
+
|
54
|
+
if Object.const_defined?(:GR)
|
55
|
+
module GR
|
56
|
+
module FFI
|
57
|
+
module Inspector
|
58
|
+
GR::FFI.ffi_methods.each do |s|
|
59
|
+
define_method(s) do |*args|
|
60
|
+
GRCommons.gr_logger.info "GR::FFI.#{s}\n" + args.ai + "\n"
|
61
|
+
super(*args)
|
62
|
+
end
|
63
|
+
end
|
64
|
+
end
|
65
|
+
class << self
|
66
|
+
prepend Inspector
|
67
|
+
end
|
68
|
+
end
|
69
|
+
end
|
70
|
+
end
|
71
|
+
|
72
|
+
if Object.const_defined?(:GR3)
|
73
|
+
module GR3
|
74
|
+
module FFI
|
75
|
+
module Inspector
|
76
|
+
GR3::FFI.ffi_methods.each do |s|
|
77
|
+
define_method(s) do |*args|
|
78
|
+
GRCommons.gr_logger.info "GR3::FFI.#{s}\n" + args.ai + "\n"
|
79
|
+
super(*args)
|
80
|
+
end
|
81
|
+
end
|
82
|
+
end
|
83
|
+
class << self
|
84
|
+
prepend Inspector
|
85
|
+
end
|
86
|
+
end
|
87
|
+
end
|
88
|
+
end
|
89
|
+
|
90
|
+
if Object.const_defined?(:GRM)
|
91
|
+
module GRM
|
92
|
+
module FFI
|
93
|
+
module Inspector
|
94
|
+
GRM::FFI.ffi_methods.each do |s|
|
95
|
+
define_method(s) do |*args|
|
96
|
+
GRCommons.gr_logger.info "GRM::FFI.#{s}\n" + args.ai + "\n"
|
97
|
+
super(*args)
|
98
|
+
end
|
99
|
+
end
|
100
|
+
end
|
101
|
+
class << self
|
102
|
+
prepend Inspector
|
103
|
+
end
|
104
|
+
end
|
105
|
+
end
|
106
|
+
end
|
@@ -19,16 +19,16 @@ module GRCommons
|
|
19
19
|
type = ENV['GKSwstype']
|
20
20
|
case type
|
21
21
|
when 'svg'
|
22
|
-
data = File.read(ENV['GKS_FILEPATH']
|
22
|
+
data = File.read("#{ENV['GKS_FILEPATH']}.svg")
|
23
23
|
IRuby.display(data, mime: 'image/svg+xml') if display
|
24
24
|
when 'png', '322', '140'
|
25
|
-
data = File.read(ENV['GKS_FILEPATH']
|
25
|
+
data = File.read("#{ENV['GKS_FILEPATH']}.png")
|
26
26
|
IRuby.display(data, mime: 'image/png') if display
|
27
27
|
when 'jpg', '321', '144'
|
28
|
-
data = File.read(ENV['GKS_FILEPATH']
|
28
|
+
data = File.read("#{ENV['GKS_FILEPATH']}.jpg")
|
29
29
|
IRuby.display(data, mime: 'image/jpeg') if display
|
30
30
|
when 'gif', '130'
|
31
|
-
data = File.read(ENV['GKS_FILEPATH']
|
31
|
+
data = File.read("#{ENV['GKS_FILEPATH']}.gif")
|
32
32
|
IRuby.display(data, mime: 'image/gif') if display
|
33
33
|
when 'webm', 'ogg', 'mp4', 'mov'
|
34
34
|
require 'base64'
|
@@ -37,7 +37,7 @@ module GRCommons
|
|
37
37
|
else
|
38
38
|
"video/#{type}"
|
39
39
|
end
|
40
|
-
data = File.binread(ENV['GKS_FILEPATH']
|
40
|
+
data = File.binread("#{ENV['GKS_FILEPATH']}.#{type}")
|
41
41
|
if display
|
42
42
|
IRuby.display(
|
43
43
|
"<video autoplay controls><source type=\"#{mimespec}\" " \
|
data/lib/gr_commons/version.rb
CHANGED
data/lib/grm.rb
CHANGED
@@ -1,33 +1,50 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
+
# Check Fiddle version.
|
4
|
+
require 'fiddle'
|
5
|
+
|
6
|
+
# Check if fiddle supports variadic arguments.
|
7
|
+
# Fiddle is a standard Gem and may not have VERSION constant.
|
8
|
+
if !Fiddle.const_defined?(:VERSION) ||
|
9
|
+
(Gem::Version.new(Fiddle::VERSION) <= Gem::Version.new('1.0.0'))
|
10
|
+
raise LoadError, <<~MSG
|
11
|
+
Failed to load GRM module
|
12
|
+
Fiddle 1.0.1 or higher is required to run GRM.
|
13
|
+
See https://github.com/ruby/fiddle
|
14
|
+
MSG
|
15
|
+
end
|
16
|
+
|
3
17
|
module GRM
|
4
18
|
class Error < StandardError; end
|
5
19
|
|
20
|
+
class NotFoundError < Error; end
|
21
|
+
|
6
22
|
class << self
|
7
23
|
attr_accessor :ffi_lib
|
8
24
|
end
|
9
25
|
|
26
|
+
require_relative 'gr_commons/gr_commons'
|
27
|
+
|
10
28
|
# Platforms | path
|
11
29
|
# Windows | bin/libGRM.dll
|
12
|
-
# MacOSX | lib/libGRM.
|
30
|
+
# MacOSX | lib/libGRM.dylib (v0.53.0 .so)
|
13
31
|
# Ubuntu | lib/libGRM.so
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
32
|
+
platform = RbConfig::CONFIG['host_os']
|
33
|
+
lib_names, pkg_name = \
|
34
|
+
case platform
|
35
|
+
when /mswin|msys|mingw|cygwin|bccwin|wince|emc/
|
36
|
+
[['libGRM.dll'], 'grm']
|
37
|
+
when /darwin|mac os/
|
38
|
+
[['libGRM.dylib', 'libGRM.so'], 'grm']
|
39
|
+
else
|
40
|
+
[['libGRM.so'], 'grm']
|
41
|
+
end
|
42
|
+
lib_path = GRCommons::GRLib.search(lib_names, pkg_name)
|
43
|
+
|
44
|
+
raise NotFoundError, "#{lib_names} not found" if lib_path.nil?
|
45
|
+
|
46
|
+
self.ffi_lib = lib_path
|
26
47
|
|
27
|
-
# change the default encoding to UTF-8.
|
28
|
-
ENV['GKS_ENCODING'] ||= 'utf8'
|
29
|
-
|
30
|
-
require_relative 'gr_commons/gr_commons'
|
31
48
|
require_relative 'grm/version'
|
32
49
|
require_relative 'grm/ffi'
|
33
50
|
require_relative 'grm/grmbase'
|