carray 1.4.0 → 1.5.5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (239) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +32 -0
  3. data/LICENSE +22 -0
  4. data/NEWS.md +83 -0
  5. data/README.md +38 -18
  6. data/Rakefile +2 -2
  7. data/TODO.md +17 -0
  8. data/carray.gemspec +13 -18
  9. data/{ca_iter_block.c → ext/ca_iter_block.c} +16 -18
  10. data/{ca_iter_dimension.c → ext/ca_iter_dimension.c} +20 -21
  11. data/{ca_iter_window.c → ext/ca_iter_window.c} +12 -14
  12. data/{ca_obj_array.c → ext/ca_obj_array.c} +451 -176
  13. data/{ca_obj_bitarray.c → ext/ca_obj_bitarray.c} +18 -23
  14. data/{ca_obj_bitfield.c → ext/ca_obj_bitfield.c} +12 -16
  15. data/{ca_obj_block.c → ext/ca_obj_block.c} +47 -54
  16. data/{ca_obj_fake.c → ext/ca_obj_fake.c} +10 -12
  17. data/{ca_obj_farray.c → ext/ca_obj_farray.c} +21 -23
  18. data/{ca_obj_field.c → ext/ca_obj_field.c} +30 -32
  19. data/{ca_obj_grid.c → ext/ca_obj_grid.c} +32 -33
  20. data/{ca_obj_mapping.c → ext/ca_obj_mapping.c} +11 -13
  21. data/{ca_obj_object.c → ext/ca_obj_object.c} +40 -42
  22. data/{ca_obj_reduce.c → ext/ca_obj_reduce.c} +3 -5
  23. data/{ca_obj_refer.c → ext/ca_obj_refer.c} +44 -48
  24. data/{ca_obj_repeat.c → ext/ca_obj_repeat.c} +45 -47
  25. data/{ca_obj_select.c → ext/ca_obj_select.c} +4 -6
  26. data/{ca_obj_shift.c → ext/ca_obj_shift.c} +26 -28
  27. data/{ca_obj_transpose.c → ext/ca_obj_transpose.c} +26 -28
  28. data/{ca_obj_unbound_repeat.c → ext/ca_obj_unbound_repeat.c} +106 -160
  29. data/{ca_obj_window.c → ext/ca_obj_window.c} +33 -35
  30. data/{carray.h → ext/carray.h} +86 -59
  31. data/{carray_access.c → ext/carray_access.c} +194 -101
  32. data/{carray_attribute.c → ext/carray_attribute.c} +161 -207
  33. data/{carray_call_cfunc.c → ext/carray_call_cfunc.c} +1 -3
  34. data/{carray_cast.c → ext/carray_cast.c} +351 -150
  35. data/{carray_cast_func.rb → ext/carray_cast_func.rb} +1 -2
  36. data/{carray_class.c → ext/carray_class.c} +28 -36
  37. data/{carray_conversion.c → ext/carray_conversion.c} +63 -68
  38. data/{carray_copy.c → ext/carray_copy.c} +34 -50
  39. data/{carray_core.c → ext/carray_core.c} +75 -62
  40. data/ext/carray_data_type.c +66 -0
  41. data/{carray_element.c → ext/carray_element.c} +34 -53
  42. data/{carray_generate.c → ext/carray_generate.c} +71 -50
  43. data/{carray_iterator.c → ext/carray_iterator.c} +53 -53
  44. data/{carray_loop.c → ext/carray_loop.c} +77 -106
  45. data/{carray_mask.c → ext/carray_mask.c} +105 -114
  46. data/{carray_math.rb → ext/carray_math.rb} +29 -13
  47. data/ext/{mathfunc/carray_mathfunc.c → carray_mathfunc.c} +1 -3
  48. data/{carray_numeric.c → ext/carray_numeric.c} +43 -46
  49. data/{carray_operator.c → ext/carray_operator.c} +49 -36
  50. data/{carray_order.c → ext/carray_order.c} +232 -217
  51. data/{carray_sort_addr.c → ext/carray_sort_addr.c} +14 -21
  52. data/{carray_stat.c → ext/carray_stat.c} +6 -8
  53. data/{carray_stat_proc.rb → ext/carray_stat_proc.rb} +25 -27
  54. data/{carray_test.c → ext/carray_test.c} +63 -51
  55. data/{carray_undef.c → ext/carray_undef.c} +1 -11
  56. data/{carray_utils.c → ext/carray_utils.c} +12 -4
  57. data/{extconf.rb → ext/extconf.rb} +10 -7
  58. data/{mkmath.rb → ext/mkmath.rb} +2 -2
  59. data/{ruby_carray.c → ext/ruby_carray.c} +20 -8
  60. data/{ruby_ccomplex.c → ext/ruby_ccomplex.c} +2 -4
  61. data/{ruby_float_func.c → ext/ruby_float_func.c} +1 -3
  62. data/ext/version.h +16 -0
  63. data/{version.rb → ext/version.rb} +0 -0
  64. data/lib/carray.rb +51 -40
  65. data/lib/carray/{base/autoload.rb → autoload.rb} +1 -3
  66. data/lib/carray/autoload/autoload_base.rb +1 -1
  67. data/lib/carray/autoload/autoload_gem_numo_narray.rb +7 -6
  68. data/lib/carray/autoload/autoload_gem_random.rb +8 -0
  69. data/lib/carray/basic.rb +191 -0
  70. data/lib/carray/broadcast.rb +101 -0
  71. data/lib/carray/compose.rb +315 -0
  72. data/lib/carray/construct.rb +484 -0
  73. data/lib/carray/convert.rb +115 -0
  74. data/lib/carray/info.rb +1 -3
  75. data/lib/carray/{base/inspect.rb → inspect.rb} +9 -11
  76. data/lib/carray/io/imagemagick.rb +2 -4
  77. data/lib/carray/{base/iterator.rb → iterator.rb} +6 -6
  78. data/lib/carray/mask.rb +102 -0
  79. data/lib/carray/{base/math.rb → math.rb} +20 -52
  80. data/lib/carray/math/histogram.rb +8 -10
  81. data/lib/carray/math/recurrence.rb +1 -3
  82. data/lib/carray/mkmf.rb +9 -3
  83. data/lib/carray/object/ca_obj_iterator.rb +1 -3
  84. data/lib/carray/object/ca_obj_link.rb +1 -3
  85. data/lib/carray/object/ca_obj_pack.rb +9 -11
  86. data/lib/carray/obsolete.rb +256 -0
  87. data/lib/carray/ordering.rb +181 -0
  88. data/lib/carray/{base/serialize.rb → serialize.rb} +60 -76
  89. data/lib/carray/{base/string.rb → string.rb} +10 -64
  90. data/lib/carray/{base/struct.rb → struct.rb} +19 -21
  91. data/lib/carray/{io/table.rb → table.rb} +1 -10
  92. data/lib/carray/testing.rb +51 -0
  93. data/lib/carray/time.rb +76 -0
  94. data/lib/carray/transform.rb +109 -0
  95. data/misc/Methods.ja.md +182 -0
  96. data/{NOTE → misc/NOTE} +16 -38
  97. data/spec/Classes/CABitfield_spec.rb +58 -0
  98. data/spec/Classes/CABlockIterator_spec.rb +114 -0
  99. data/spec/Classes/CABlock_spec.rb +205 -0
  100. data/spec/Classes/CAField_spec.rb +39 -0
  101. data/spec/Classes/CAGrid_spec.rb +75 -0
  102. data/spec/Classes/CAMap_spec.rb +0 -0
  103. data/{test/test_CAMapping.rb → spec/Classes/CAMapping_spec.rb} +35 -36
  104. data/spec/Classes/CAObject_attribute_spec.rb +33 -0
  105. data/spec/Classes/CAObject_spec.rb +33 -0
  106. data/spec/Classes/CARefer_spec.rb +93 -0
  107. data/spec/Classes/CARepeat_spec.rb +65 -0
  108. data/spec/Classes/CASelect_spec.rb +22 -0
  109. data/spec/Classes/CAShift_spec.rb +16 -0
  110. data/spec/Classes/CAStruct_spec.rb +71 -0
  111. data/{test/test_CATranspose.rb → spec/Classes/CATranspose_spec.rb} +20 -21
  112. data/spec/Classes/CAUnboudRepeat_spec.rb +102 -0
  113. data/spec/Classes/CAWindow_spec.rb +54 -0
  114. data/spec/Classes/CAWrap_spec.rb +8 -0
  115. data/{test/test_CArray.rb → spec/Classes/CArray_spec.rb} +48 -92
  116. data/spec/Classes/CScalar_spec.rb +55 -0
  117. data/spec/Features/feature_130_spec.rb +19 -0
  118. data/spec/Features/feature_attributes_spec.rb +280 -0
  119. data/spec/Features/feature_boolean_spec.rb +98 -0
  120. data/spec/Features/feature_broadcast.rb +116 -0
  121. data/spec/Features/feature_cast_function.rb +19 -0
  122. data/spec/Features/feature_cast_spec.rb +33 -0
  123. data/spec/Features/feature_class_spec.rb +84 -0
  124. data/spec/Features/feature_complex_spec.rb +42 -0
  125. data/{test/test_composite.rb → spec/Features/feature_composite_spec.rb} +17 -18
  126. data/spec/Features/feature_convert_spec.rb +46 -0
  127. data/spec/Features/feature_copy_spec.rb +123 -0
  128. data/spec/Features/feature_creation_spec.rb +84 -0
  129. data/spec/Features/feature_element_spec.rb +144 -0
  130. data/spec/Features/feature_extream_spec.rb +54 -0
  131. data/spec/Features/feature_generate_spec.rb +74 -0
  132. data/spec/Features/feature_index_spec.rb +69 -0
  133. data/spec/Features/feature_mask_spec.rb +580 -0
  134. data/spec/Features/feature_math_spec.rb +97 -0
  135. data/spec/Features/feature_order_spec.rb +146 -0
  136. data/spec/Features/feature_ref_store_spec.rb +209 -0
  137. data/spec/Features/feature_serialization_spec.rb +125 -0
  138. data/spec/Features/feature_stat_spec.rb +397 -0
  139. data/spec/Features/feature_virtual_spec.rb +48 -0
  140. data/spec/Features/method_eq_spec.rb +81 -0
  141. data/spec/Features/method_is_nan_spec.rb +12 -0
  142. data/spec/Features/method_map_spec.rb +54 -0
  143. data/spec/Features/method_max_with.rb +20 -0
  144. data/spec/Features/method_min_with.rb +19 -0
  145. data/spec/Features/method_ne_spec.rb +18 -0
  146. data/spec/Features/method_project_spec.rb +188 -0
  147. data/spec/Features/method_ref_spec.rb +27 -0
  148. data/spec/Features/method_round_spec.rb +11 -0
  149. data/spec/Features/method_s_linspace_spec.rb +48 -0
  150. data/spec/Features/method_s_span_spec.rb +14 -0
  151. data/spec/Features/method_seq_spec.rb +47 -0
  152. data/spec/Features/method_sort_with.rb +43 -0
  153. data/spec/Features/method_sorted_with.rb +29 -0
  154. data/spec/Features/method_span_spec.rb +42 -0
  155. data/spec/Features/method_wrap_readonly_spec.rb +43 -0
  156. data/{test → spec/UnitTest}/test_CAVirtual.rb +0 -0
  157. data/spec/spec_all.rb +0 -1
  158. data/utils/convert_test.rb +73 -0
  159. data/utils/{extract_rdoc.rb → extract_yard.rb} +7 -12
  160. data/{devel → utils}/guess_shape.rb +0 -0
  161. data/utils/{diff_method.rb → monkey_patch_methods.rb} +17 -7
  162. metadata +159 -206
  163. data/COPYING +0 -56
  164. data/GPL +0 -340
  165. data/LEGAL +0 -50
  166. data/TODO +0 -5
  167. data/carray_random.c +0 -531
  168. data/devel/im2col.rb +0 -17
  169. data/ext/calculus/carray_calculus.c +0 -931
  170. data/ext/calculus/carray_interp.c +0 -358
  171. data/ext/calculus/extconf.rb +0 -12
  172. data/ext/calculus/lib/math/calculus.rb +0 -119
  173. data/ext/calculus/lib/math/interp/adapter_interp1d.rb +0 -31
  174. data/ext/mathfunc/extconf.rb +0 -18
  175. data/ext/mathfunc/test/test_hypot.rb +0 -5
  176. data/ext/mathfunc/test/test_j0.rb +0 -22
  177. data/ext/mathfunc/test/test_jn.rb +0 -8
  178. data/ext/mathfunc/test/test_sph.rb +0 -9
  179. data/lib/carray/autoload/autoload_io_table.rb +0 -1
  180. data/lib/carray/autoload/autoload_math_interp.rb +0 -4
  181. data/lib/carray/base/basic.rb +0 -1146
  182. data/lib/carray/base/obsolete.rb +0 -131
  183. data/lib/carray/math/interp.rb +0 -57
  184. data/lib/carray/math/interp/adapter_gsl_spline.rb +0 -47
  185. data/mt19937ar.c +0 -182
  186. data/mt19937ar.h +0 -86
  187. data/rdoc_main.rb +0 -27
  188. data/rdoc_math.rb +0 -5
  189. data/rdoc_stat.rb +0 -31
  190. data/spec/CABlockIterator/CABlockIterator_spec.rb +0 -113
  191. data/spec/CArray/bug/store_spec.rb +0 -27
  192. data/spec/CArray/index/repeat_spec.rb +0 -10
  193. data/spec/CArray/method/eq_spec.rb +0 -80
  194. data/spec/CArray/method/is_nan_spec.rb +0 -12
  195. data/spec/CArray/method/ne_spec.rb +0 -18
  196. data/spec/CArray/method/round_spec.rb +0 -11
  197. data/spec/CArray/object/_attribute_spec.rb +0 -32
  198. data/spec/CArray/object/s_new_spec.rb +0 -31
  199. data/spec/CArray/serialize/Serialization_spec.rb +0 -89
  200. data/test/test_130.rb +0 -23
  201. data/test/test_ALL.rb +0 -51
  202. data/test/test_CABitfield.rb +0 -59
  203. data/test/test_CABlock.rb +0 -208
  204. data/test/test_CAField.rb +0 -40
  205. data/test/test_CAGrid.rb +0 -76
  206. data/test/test_CAMmap.rb +0 -11
  207. data/test/test_CARefer.rb +0 -94
  208. data/test/test_CARepeat.rb +0 -66
  209. data/test/test_CASelect.rb +0 -23
  210. data/test/test_CAShift.rb +0 -17
  211. data/test/test_CAWindow.rb +0 -55
  212. data/test/test_CAWrap.rb +0 -9
  213. data/test/test_CComplex.rb +0 -83
  214. data/test/test_CScalar.rb +0 -91
  215. data/test/test_attribute.rb +0 -281
  216. data/test/test_block_iterator.rb +0 -17
  217. data/test/test_boolean.rb +0 -99
  218. data/test/test_cast.rb +0 -33
  219. data/test/test_class.rb +0 -85
  220. data/test/test_complex.rb +0 -43
  221. data/test/test_convert.rb +0 -79
  222. data/test/test_copy.rb +0 -141
  223. data/test/test_creation.rb +0 -85
  224. data/test/test_element.rb +0 -146
  225. data/test/test_extream.rb +0 -55
  226. data/test/test_generate.rb +0 -75
  227. data/test/test_index.rb +0 -71
  228. data/test/test_mask.rb +0 -578
  229. data/test/test_math.rb +0 -98
  230. data/test/test_narray.rb +0 -64
  231. data/test/test_order.rb +0 -147
  232. data/test/test_random.rb +0 -15
  233. data/test/test_ref_store.rb +0 -211
  234. data/test/test_stat.rb +0 -414
  235. data/test/test_struct.rb +0 -72
  236. data/test/test_virtual.rb +0 -49
  237. data/utils/create_rdoc.sh +0 -9
  238. data/utils/make_tgz.sh +0 -3
  239. data/version.h +0 -18
@@ -1,5 +1,5 @@
1
1
 
2
- module CA
2
+ class CArray
3
3
 
4
4
  module TableMethods
5
5
 
@@ -67,12 +67,3 @@ module CA
67
67
 
68
68
  end
69
69
 
70
- class CArray
71
-
72
- def extend_as_table (column_names)
73
- self.extend CA::TableMethods
74
- self.column_names = column_names
75
- self
76
- end
77
-
78
- end
@@ -0,0 +1,51 @@
1
+ # ----------------------------------------------------------------------------
2
+ #
3
+ # carray/test.rb
4
+ #
5
+ # This file is part of Ruby/CArray extension library.
6
+ #
7
+ # Copyright (C) 2005-2020 Hiroki Motoyoshi
8
+ #
9
+ # ----------------------------------------------------------------------------
10
+
11
+ class CArray
12
+
13
+ def test (&block)
14
+ return convert(:boolean) {|v| yield(v) ? true : false }
15
+ end
16
+
17
+ def contains (*list)
18
+ result = self.false()
19
+ list.each do |item|
20
+ result = result | self.eq(item)
21
+ end
22
+ return result
23
+ end
24
+
25
+ def between (a, b)
26
+ return (self >= a) & (self <= b)
27
+ end
28
+
29
+ def where_range
30
+ w = where
31
+ x = (w - w.shifted(1){-2}).sub!(1).where
32
+ y = (w - w.shifted(-1){-2}).add!(1).where
33
+ list = []
34
+ x.each_addr do |i|
35
+ list.push(w[x[i]]..w[y[i]])
36
+ end
37
+ return list
38
+ end
39
+
40
+ # Returns the array eliminated all the duplicated elements.
41
+ def uniq
42
+ ary = flatten.to_a.uniq
43
+ if has_mask?
44
+ ary.delete(UNDEF)
45
+ end
46
+ out = CArray.new(data_type, [ary.length], :bytes=>bytes) { ary }
47
+ out.data_class = data_class if has_data_class?
48
+ return out
49
+ end
50
+
51
+ end
@@ -0,0 +1,76 @@
1
+ # ----------------------------------------------------------------------------
2
+ #
3
+ # carray/time.rb
4
+ #
5
+ # This file is part of Ruby/CArray extension library.
6
+ #
7
+ # Copyright (C) 2005-2020 Hiroki Motoyoshi
8
+ #
9
+ # ----------------------------------------------------------------------------
10
+
11
+ require "date"
12
+
13
+ class CArray
14
+
15
+ def str_to_datetime (template = nil)
16
+ if template
17
+ return convert() {|v| DateTime.strptime(v, template) }
18
+ else
19
+ return convert() {|v| DateTime.parse(v) }
20
+ end
21
+ end
22
+
23
+ def str_to_time (template = nil)
24
+ if template
25
+ return str_strptime(template)
26
+ else
27
+ return convert() {|v| Time.parse(v) }
28
+ end
29
+ end
30
+
31
+ def time_format (template = nil)
32
+ if template
33
+ return str_strftime(template)
34
+ else
35
+ return convert(&:to_s)
36
+ end
37
+ end
38
+
39
+ def time_year
40
+ return convert(:int, &:year)
41
+ end
42
+
43
+ def time_month
44
+ return convert(:int, &:month)
45
+ end
46
+
47
+ def time_day
48
+ return convert(:int, &:day)
49
+ end
50
+
51
+ def time_hour
52
+ return convert(:int, &:hour)
53
+ end
54
+
55
+ def time_minute
56
+ return convert(:int, &:minute)
57
+ end
58
+
59
+ def time_second
60
+ return convert(:double) {|d| d.second + d.second_fraction }
61
+ end
62
+
63
+ def time_jd
64
+ return convert(:int, &:jd)
65
+ end
66
+
67
+ def time_ajd
68
+ return convert(:double, &:ajd)
69
+ end
70
+
71
+ def time_is_leap
72
+ return test(&:leap?)
73
+ end
74
+
75
+ end
76
+
@@ -0,0 +1,109 @@
1
+ # ----------------------------------------------------------------------------
2
+ #
3
+ # carray/composition.rb
4
+ #
5
+ # This file is part of Ruby/CArray extension library.
6
+ #
7
+ # Copyright (C) 2005-2020 Hiroki Motoyoshi
8
+ #
9
+ # ----------------------------------------------------------------------------
10
+
11
+ class CArray
12
+
13
+ # reshape
14
+
15
+ def reshape (*newdim)
16
+ ifalse = nil
17
+ i = 0
18
+ 0.upto(newdim.size-1) do |i|
19
+ if newdim[i].nil?
20
+ newdim[i] = dim[i]
21
+ elsif newdim[i] == false
22
+ ifalse = i
23
+ break
24
+ end
25
+ end
26
+ k = 0
27
+ (newdim.size-1).downto(i+1) do |j|
28
+ if newdim[j].nil?
29
+ newdim[j] = dim[ndim-1-k]
30
+ end
31
+ k += 1
32
+ end
33
+ if ifalse
34
+ newdim[ifalse] =
35
+ elements/newdim.select{|x| x!=false}.inject(1){|s,x| s*x}
36
+ end
37
+ return refer(data_type, newdim, :bytes=>bytes)
38
+ end
39
+
40
+ # flatten
41
+
42
+ def flattened
43
+ return reshape(elements)
44
+ end
45
+
46
+ def flatten
47
+ return reshape(elements).to_ca
48
+ end
49
+
50
+ def transpose! (*argv)
51
+ self[] = self.transposed(*argv)
52
+ return self
53
+ end
54
+
55
+ def transpose (*argv)
56
+ return self.transposed(*argv).to_ca
57
+ end
58
+
59
+ # Reutrns the reference which ndim is reduced
60
+ # by eliminating the dimensions which size == 1
61
+ def compacted
62
+ if ndim == 1
63
+ return self[]
64
+ else
65
+ newdim = dim.reject{|x| x == 1 }
66
+ return ( ndim != newdim.size ) ? reshape(*newdim) : self[]
67
+ end
68
+ end
69
+
70
+ # Returns the array which ndim is reduced
71
+ # by eliminating the dimensions which size == 1
72
+ def compact
73
+ if ndim == 1
74
+ return self.to_ca
75
+ else
76
+ newdim = dim.reject{|x| x == 1 }
77
+ return ( ndim != newdim.size ) ? reshape(*newdim).to_ca : self.to_ca
78
+ end
79
+ end
80
+
81
+ # Returns (1,n) array from 1-dimensional array
82
+ def to_row
83
+ if ndim != 1
84
+ raise "ndim should be 1"
85
+ end
86
+ return self[1,:%]
87
+ end
88
+
89
+ # Returns (n,1) array from 1-dimensional array
90
+ def to_column
91
+ if ndim != 1
92
+ raise "ndim should be 1"
93
+ end
94
+ return self[:%,1]
95
+ end
96
+
97
+ # pulled
98
+
99
+ def pulled (*args)
100
+ idx = args.map{|s| s.nil? ? :% : s}
101
+ return self[*idx]
102
+ end
103
+
104
+ def pull (*args)
105
+ idx = args.map{|s| s.nil? ? :% : s}
106
+ return self[*idx].to_ca
107
+ end
108
+
109
+ end
@@ -0,0 +1,182 @@
1
+ メソッドドキュメント
2
+ ===================
3
+
4
+ 多次元配列クラスのRuby用ライブラリ
5
+
6
+ 特徴
7
+ ---
8
+
9
+ * 一様なデータを格納するための多次元配列
10
+ * データ要素への多様なアクセス方法
11
+ * 欠測値を扱うための要素別のマスク
12
+ * 要素毎の演算や数学関数
13
+ * 要素に対する統計関数
14
+ * 真の参照配列
15
+ * ユーザー定義配列
16
+ * 他オブジェクトとのメモリ共有(Experimental)
17
+
18
+ マスクに関するメソッド
19
+ -------------------
20
+
21
+ * 一度生成されたマスク配列を取り除く方法は提供されていない。
22
+
23
+ == メソッド
24
+
25
+ === --- CArray#has_mask?
26
+ マスク配列が付加されている場合にtrueを返す。
27
+ 全要素がマスクされていなくても、マスク配列が付加されていればtrueを返す。
28
+
29
+ a = CA_INT(0..2);
30
+ a.has_mask?
31
+ a[1] = UNDEF;
32
+ a.has_mask?
33
+
34
+ === --- CArray#any_masked?
35
+ マスクされた要素が1つ以上ある場合にtrueを返す。
36
+ どの要素もマスクされていない場合やマスク配列自体を持っていない場合にfalseを返す。
37
+
38
+ a = CA_INT(0..2);
39
+ a.mask = 0;
40
+ a.any_masked?
41
+ a[1] = UNDEF;
42
+ a.any_masked?
43
+ a.unmask;
44
+ a.any_masked?
45
+
46
+ === --- CArray#value
47
+ データ配列を参照する配列を返す。
48
+ マスクされているいないに関わらず、要素の値を参照したり、
49
+ 値を変更することができる。
50
+ この配列(もしくはこの配列を参照する配列)に対し、
51
+ マスクを付加しようとすると例外が発生する。
52
+
53
+ a = CA_INT(0..2);
54
+ a[1] = UNDEF;
55
+ a
56
+ a.value
57
+
58
+ === --- CArray#mask
59
+ マスク配列を参照するboolean型配列を返す。
60
+ この配列を変更すると、元の配列のマスク状態を変更することができる。
61
+ この配列(もしくはこの配列を参照する配列)に対し、
62
+ マスクを付加しようとすると例外が発生する。
63
+
64
+ a = CA_INT(0..2);
65
+ a[1] = UNDEF;
66
+ a.mask
67
+ a
68
+ a.mask[] ^= 1;
69
+ a
70
+
71
+ === --- CArray#mask=(new_mask)
72
+ new_maskをマスク配列に代入する。
73
+ new_maskは、<TBD>でなければならない。
74
+ 配列がマスク配列を持っていない場合は、代入前にマスク配列が生成される。
75
+
76
+ a = CA_INT(0..2);
77
+ a.mask
78
+ a.mask = 0;
79
+ a.mask
80
+ a.mask = [0,1,0];
81
+ a.mask
82
+ a.mask ^= 1;
83
+ a.mask
84
+
85
+ === --- CArray#is_masked
86
+ マスク状態を表すboolean型配列を返す。
87
+ この配列はマスクされた要素が1で、マスクされていない要素が0となる。
88
+
89
+ a = CA_INT(0..2);
90
+ a[1] = UNDEF;
91
+ a.is_masked
92
+
93
+ === --- CArray#is_not_masked
94
+ マスク状態を表すboolean型配列を返す。
95
+ この配列はマスクされた要素が0で、マスクされていない要素が1となる。
96
+
97
+ a = CA_INT(0..2);
98
+ a[1] = UNDEF;
99
+ a.is_not_masked
100
+
101
+ === --- CArray#count_masked (*axis)
102
+ マスクされた要素の数を返す。
103
+ axisで与えられた次元で集計し、残りの次元の配列を返す。
104
+ axisが与えられない場合は、整数を返す。
105
+
106
+ a = CA_INT(0..2);
107
+ a[1] = UNDEF;
108
+ a.count_masked
109
+
110
+ === --- CArray#count_not_masked
111
+ マスクされていない要素の数を返す。
112
+ axisで与えられた次元で集計し、残りの次元の配列を返す。
113
+ axisが与えられない場合は、整数を返す。
114
+
115
+ a = CA_INT(0..2);
116
+ a[1] = UNDEF;
117
+ a.count_not_masked
118
+
119
+ === --- CArray#unmask([fill_value])
120
+ すべての要素のマスクを解除する。
121
+ fill_valueが与えられている場合は、マスクされた要素をすべてfill_valueで置き換える。
122
+ このメソッドでは、マスク配列自体を取り除かれることはない。
123
+
124
+ a = CA_INT(0..2);
125
+ # example for fill_value not to be given
126
+ a[1] = UNDEF;
127
+ a
128
+ a.unmask();
129
+ a
130
+
131
+ # example for fill_value to be given
132
+ b = CA_INT(0..2);
133
+ b[1] = UNDEF;
134
+ b.unmask(-9999);
135
+ b
136
+
137
+ === --- CArray#unmask_copy([fill_value])
138
+ すべての要素のマスクが解除された複製を返す。
139
+ fill_valueが与えられている場合は、マスクされた要素をすべてfill_valueで置き換える。
140
+ 返り値の配列はマスク配列を持たない状態で生成される。
141
+
142
+ a = CA_INT(0..2);
143
+ a[1] = UNDEF;
144
+ a
145
+
146
+ b = a.unmask_copy(-9999)
147
+ b.has_mask?
148
+
149
+ === --- CArray#inherit_mask(a1, a2, ...)
150
+ オブジェクトと引数で与えられた配列の集合で(self,a1,a2,...)でマスク状態の論理和をとり、
151
+ 新しいマスク状態として置き換える。
152
+
153
+ a = CA_INT(0..2);
154
+ b = CA_INT(0..2);
155
+ c = CA_INT(0..2);
156
+ a[0] = UNDEF;
157
+ b[1] = UNDEF;
158
+ c[2] = UNDEF;
159
+ a ### => [_,1,2]
160
+ b ### => [0,_,2]
161
+ c ### => [0,1,_]
162
+ a.inherit_mask(b,c);
163
+ a ### => [_,_,_]
164
+
165
+ === --- CArray#inherit_mask_replace(a1, a2, ...)
166
+ 引数で与えられた配列 a1、a2、… のマスク状態の論理和をとり、
167
+ 新しいマスク状態として設定する。
168
+ オブジェクト自身のマスク値は上記の論理和に含まれない点に注意する。
169
+
170
+ a = CA_INT(0..2);
171
+ b = CA_INT(0..2);
172
+ c = CA_INT(0..2);
173
+ a[0] = UNDEF;
174
+ b[1] = UNDEF;
175
+ c[2] = UNDEF;
176
+ a ### => [_,1,2]
177
+ b ### => [0,_,2]
178
+ c ### => [0,1,_]
179
+ a.inherit_mask_replace(b,c);
180
+ a ### => [0,_,_]
181
+
182
+
data/{NOTE → misc/NOTE} RENAMED
@@ -1,42 +1,6 @@
1
1
  Note for developper
2
2
  ===================
3
3
 
4
- Make targets
5
- ------------
6
-
7
- ### create Makefile
8
-
9
- ruby extconf.rb
10
-
11
- ### build extensions
12
-
13
- make all
14
-
15
- ### install via RubyGems
16
-
17
- make build-gem
18
- make install-gem
19
- make uninstall-gem ### for uninstall this version
20
-
21
- ### install via extconf.rb
22
-
23
- ruby extconf.rb
24
- make all
25
- make install
26
-
27
- ### cleaning temporary files
28
-
29
- make clean
30
- make distclean
31
-
32
- ### create gem package
33
-
34
- make package ### -> rake package
35
-
36
- ### run test
37
-
38
- make test ### -> rake test
39
-
40
4
  Utility scripts
41
5
  ---------------
42
6
 
@@ -53,8 +17,11 @@ Check Points for Debug
53
17
 
54
18
  * 'elements' should be checked with double float number
55
19
 
56
- * ca_update_mask/ca_attach/ca_create_mask/ca_has_mask should be called
57
- before ca->mask refered
20
+ * One of the following methods should be called before ca->mask refered
21
+ + ca_attach
22
+ + ca_has_mask
23
+ + ca_update_mask
24
+ + ca_create_mask
58
25
 
59
26
  * Avoid the exposition of raw VALUE data in object array
60
27
 
@@ -71,3 +38,14 @@ OpenMP
71
38
  ------
72
39
 
73
40
  * '--with-cc="gcc -fopenmp"' ... and so on.
41
+
42
+ Range
43
+ -----
44
+
45
+ int rb_arithmetic_sequence_extract(VALUE, VALUE *, VALUE *, VALUE *, int *);
46
+
47
+ /* range.c */
48
+ #define RANGE_BEG(r) (RSTRUCT(r)->as.ary[0])
49
+ #define RANGE_END(r) (RSTRUCT(r)->as.ary[1])
50
+ #define RANGE_EXCL(r) (RSTRUCT(r)->as.ary[2])
51
+