carray 2.0.1 → 3.0.0

data/lib/carray.rb

@@ -1,72 +1,70 @@
-# ----------------------------------------------------------------------------
-#
-#  lib/carray.rb
-#
-#  This file is part of Ruby/CArray extension library.
-#
-#  Copyright (C) 2005-2025 Hiroki Motoyoshi
-#
-# ----------------------------------------------------------------------------
+# main
 
-major = RbConfig::CONFIG['MAJOR'].to_i
-minor = RbConfig::CONFIG['MINOR'].to_i
-teeny = RbConfig::CONFIG['TEENY'].to_i
-ruby_version_code = major * 100 + minor * 10 + teeny
+require 'carray_ext'
 
-if ruby_version_code < 190
-  require 'complex'
+# Top-level CAMath module -- math namespace for CArrays.
+# `CAMath.sin(ca)` works because module functions inherited
+# from Math (via include) accept any object that responds to
+# the corresponding instance method; CArray defines those in
+# C.
+module CAMath
+  include Math
 end
 
-# main 
-
-require 'carray_ext'
-
-require 'carray/inspect'
-require 'carray/basic'
+# carray/inspect is loaded lazily via autoload_carray (#inspect / #source_code
+# stubs). #inspect fires on the first p / pp / irb display or error-message
+# interpolation, so compute programs that never print a CArray skip it.
 require 'carray/construct'
-require 'carray/mask'
-require 'carray/compose'
-require 'carray/transform'
-require 'carray/convert'
-require 'carray/testing'
-require 'carray/ordering'
-require 'carray/broadcast'
+require 'carray/data_type_extension'
+# carray/stack is loaded lazily via autoload_carray (entry-method stubs).
+# CAStack is C-defined so its constant is always present; only the Ruby
+# composition surface (stack/meld/montage/split/append) needs the file.
+require 'carray/runtime'  # load-bearing Ruby support the core depends on
+require 'carray/basics'   # frequently-used convenience methods kept eager
+require 'carray/conditional'  # then_else / replace_where / conditional
+require 'carray/mask_gap_fill'  # unmask/strip_mask method: keyword (hold / linear gap-fill)
+require 'carray/attribute' # per-instance metadata Hash (#attribute / #has_attribute?)
+require 'carray/boolean_reduce' # all/any/none skip_masked: keyword (Kleene fold)
+require 'carray/meld_reduce'    # CAMeld per-parent reduce fast path (sum/mean/min/max along meld_axis)
+# carray/ordering CIFY (2026-06-21): translated to ext/carray_order.c
 
 require 'carray/math'
+# carray/clip_cast CIFY (2026-06-23): translated to ext/carray_cast.c
+require 'carray/complex' # real / imag accessors; MUST precede carray/lazy
+                         # (lazy aliases real/imag at load time)
+require 'carray/lazy'   # PROPOSAL_LAZY_ELEMENTWISE_VIEW Phase 1 P.1.2
+# carray/face.rb was deleted (the Phase 1 skeleton CArray::Face module
+# became dead weight, replaced by C-layer macro deploy +
+# copy_state/storage_to_scalar convention).
+require 'carray/time'  # CATime / CATimedelta (PROPOSAL_CAFACE_PHASE_2 F.2.4)
+# carray/methods/* (bincount / broadcast / gather_nd+put_nd) are small
+# single-feature method files, loaded lazily via autoload_carray.
 require 'carray/iterator'
-require 'carray/struct'
-require 'carray/table'
-require 'carray/array'
-require 'carray/string'
-require 'carray/time'
+# carray/struct is loaded lazily via autoload_carray (constant + entry-method
+# stubs). Nothing in the eager core references CAStruct/CAUnion, so programs
+# that only use numeric arrays never pay its load cost.
+require 'carray/string_operation_extension'  # shared StringOperationMixin (must precede the Faces)
+require 'carray/const_string'   # PROPOSAL_CATEXT.md T.2 — CAConstString construction surface
+require 'carray/string'         # PROPOSAL_STRING_FACE_TRIO.md P.1 — CAString construction surface
+require 'carray/fixlen_string'  # PROPOSAL_STRING_FACE_TRIO.md P.1 — CAFixlenString construction surface
+# CArray.format lives in carray/methods/string_format.rb, autoloaded on first call
 
-# obsolete methods
+# carray/frame is loaded lazily via autoload_carray (CAFrame / GroupedFrame
+# constants). Nothing in the eager core references the frame, so programs that
+# only use arrays never pay its load cost.
 
-require 'carray/obsolete'
+# opt-in refinements (loaded on first reference to the constant)
 
-# autoload
+class CArray
+  autoload :CoreExtensions, 'carray/core_extensions'
+end
 
-unless $CARRAY_NO_AUTOLOAD 
-  
-  require 'carray/autoload'
-  require 'carray/autoload/autoload_base'
-  require 'carray/autoload/autoload_io_imagemagick'
-  require 'carray/autoload/autoload_math_histogram'
-  require 'carray/autoload/autoload_math_recurrence'
-  require 'carray/autoload/autoload_object_iterator'
-  require 'carray/autoload/autoload_object_link'
-  require 'carray/autoload/autoload_object_pack'
+# autoload
 
-  require 'carray/autoload/autoload_gem_random'
-  require 'carray/autoload/autoload_gem_gnuplot'
-  require 'carray/autoload/autoload_gem_narray'
-  require 'carray/autoload/autoload_gem_numo_narray'
-#  require 'carray/autoload/autoload_gem_io_csv'
-#  require 'carray/autoload/autoload_gem_io_sqlite3'
-#  require 'carray/autoload/autoload_gem_rmagick'
-#  require 'carray/autoload/autoload_gem_cairo'
-#  require 'carray/autoload/autoload_gem_opencv'
-#  require 'carray/autoload/autoload_gem_ffi'
+require 'carray/autoload_method_extension'
 
-  undef autoload_method
+class CArray
+  extend AutoloadMethodExtension
 end
+
+require 'carray/autoload_carray'

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: carray
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 3.0.0
 platform: ruby
 authors:
-- Hiroki Motoyoshi
+- himotoyoshi
 bindir: bin
 cert_chain: []
-date: 2025-12-22 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: |2
       Ruby/CArray is an extension library for the multi-dimensional numerical array
@@ -15,194 +15,226 @@ description: |2
       handled by the C language. CArray stores integers or floating-point numbers in
       memory block and treats them collectively to ensure efficient performance.
       Therefore, Ruby/CArray is suitable for numerical computation and data analysis.
-email: ''
+email:
+- himotoyoshi@users.noreply.github.com
 executables: []
 extensions:
 - ext/extconf.rb
 extra_rdoc_files: []
 files:
 - ".yardopts"
+- CHANGELOG.md
 - LICENSE
 - NEWS.md
 - README.md
-- Rakefile
-- TODO.md
 - carray.gemspec
-- ext/ca_iter_block.c
-- ext/ca_iter_dimension.c
-- ext/ca_iter_window.c
+- ext/ca_array_pool.c
+- ext/ca_axis_descriptor.h
+- ext/ca_axis_dispatch.c
+- ext/ca_axis_group.c
+- ext/ca_bincmp_dispatch.c
+- ext/ca_bincmp_dispatch.h
+- ext/ca_binop_dispatch.c
+- ext/ca_binop_dispatch.h
+- ext/ca_categorical_iterator.c
+- ext/ca_compare.c
+- ext/ca_compare.h
+- ext/ca_composite_dispatch.c
+- ext/ca_composite_dispatch.h
+- ext/ca_for_buffer.h
+- ext/ca_for_each_element.h
+- ext/ca_group_iter.c
+- ext/ca_iter_substrate.h
+- ext/ca_kernel_iterator.c
+- ext/ca_kernel_iterator.h
+- ext/ca_moncmp_dispatch.c
+- ext/ca_moncmp_dispatch.h
+- ext/ca_monop_dispatch.c
+- ext/ca_monop_dispatch.h
 - ext/ca_obj_array.c
+- ext/ca_obj_bincmp.c
+- ext/ca_obj_binop.c
 - ext/ca_obj_bitarray.c
 - ext/ca_obj_bitfield.c
 - ext/ca_obj_block.c
+- ext/ca_obj_byte_swap.c
+- ext/ca_obj_const_string.c
+- ext/ca_obj_face.c
+- ext/ca_obj_face.h
 - ext/ca_obj_fake.c
 - ext/ca_obj_farray.c
 - ext/ca_obj_field.c
+- ext/ca_obj_fixlen_string.c
 - ext/ca_obj_grid.c
-- ext/ca_obj_mapping.c
+- ext/ca_obj_meld.c
+- ext/ca_obj_moncmp.c
+- ext/ca_obj_monop.c
 - ext/ca_obj_object.c
+- ext/ca_obj_record.c
 - ext/ca_obj_reduce.c
 - ext/ca_obj_refer.c
+- ext/ca_obj_remap.c
 - ext/ca_obj_repeat.c
+- ext/ca_obj_roll.c
 - ext/ca_obj_select.c
+- ext/ca_obj_select_axis.c
 - ext/ca_obj_shift.c
+- ext/ca_obj_source.c
+- ext/ca_obj_stack.c
+- ext/ca_obj_stride.c
+- ext/ca_obj_string.c
+- ext/ca_obj_tile.c
+- ext/ca_obj_time.c
+- ext/ca_obj_timedelta.c
 - ext/ca_obj_transpose.c
+- ext/ca_obj_triop.c
 - ext/ca_obj_unbound_repeat.c
 - ext/ca_obj_window.c
+- ext/ca_op_byte_swap.c
+- ext/ca_op_ipower.c
+- ext/ca_op_powi.h
+- ext/ca_sort_kernels.h
+- ext/ca_sweep_engine.c
+- ext/ca_sweep_engine.h
+- ext/ca_transform_common.c
+- ext/ca_triop_dispatch.c
+- ext/ca_triop_dispatch.h
 - ext/carray.h
 - ext/carray_access.c
 - ext/carray_attribute.c
+- ext/carray_bincount.c
+- ext/carray_broadcast.c
 - ext/carray_call_cfunc.c
+- ext/carray_call_cfunc.h
 - ext/carray_cast.c
 - ext/carray_cast_func.rb
 - ext/carray_class.c
+- ext/carray_config.h
 - ext/carray_conversion.c
 - ext/carray_copy.c
 - ext/carray_core.c
+- ext/carray_count.c
 - ext/carray_data_type.c
 - ext/carray_element.c
+- ext/carray_factorize.c
 - ext/carray_generate.c
-- ext/carray_iterator.c
+- ext/carray_histogram.c
+- ext/carray_hold.c
+- ext/carray_index_classifier.c
+- ext/carray_index_classifier.h
+- ext/carray_internal.h
+- ext/carray_kernels_bincmp.c
+- ext/carray_kernels_binop.c
+- ext/carray_kernels_init.c
+- ext/carray_kernels_map.c
+- ext/carray_kernels_moncmp.c
+- ext/carray_kernels_monop.c
+- ext/carray_kernels_reduce_aggregate.c
+- ext/carray_kernels_reduce_boolean.c
+- ext/carray_kernels_reduce_cumulative.c
+- ext/carray_kernels_reduce_extreme.c
+- ext/carray_kernels_reduce_variance.c
+- ext/carray_kernels_scan.c
+- ext/carray_kernels_search.c
+- ext/carray_kernels_sort.c
+- ext/carray_kernels_triop.c
+- ext/carray_lazy.c
 - ext/carray_loop.c
 - ext/carray_mask.c
-- ext/carray_math.rb
+- ext/carray_math_kernel.h
 - ext/carray_mathfunc.c
-- ext/carray_numeric.c
+- ext/carray_median_percentile.c
+- ext/carray_memory_view.c
 - ext/carray_operator.c
 - ext/carray_order.c
-- ext/carray_sort_addr.c
-- ext/carray_stat.c
-- ext/carray_stat_proc.rb
+- ext/carray_partition.c
+- ext/carray_random.c
+- ext/carray_scatter.c
+- ext/carray_slab.c
+- ext/carray_slab.h
+- ext/carray_sort.c
+- ext/carray_sort_kernel.c
+- ext/carray_struct.c
 - ext/carray_test.c
 - ext/carray_undef.c
 - ext/carray_utils.c
 - ext/extconf.rb
-- ext/mkmath.rb
+- ext/mk_call_cfunc.rb
+- ext/mkkernel.rb
 - ext/ruby_carray.c
-- ext/ruby_ccomplex.c
-- ext/ruby_float_func.c
 - ext/version.h
 - ext/version.rb
 - lib/carray.rb
-- lib/carray/array.rb
-- lib/carray/autoload.rb
-- lib/carray/autoload/autoload_base.rb
-- lib/carray/autoload/autoload_gem_cairo.rb
-- lib/carray/autoload/autoload_gem_ffi.rb
-- lib/carray/autoload/autoload_gem_gnuplot.rb
-- lib/carray/autoload/autoload_gem_io_csv.rb
-- lib/carray/autoload/autoload_gem_io_pg.rb
-- lib/carray/autoload/autoload_gem_io_sqlite3.rb
-- lib/carray/autoload/autoload_gem_narray.rb
-- lib/carray/autoload/autoload_gem_numo_narray.rb
-- lib/carray/autoload/autoload_gem_opencv.rb
-- lib/carray/autoload/autoload_gem_random.rb
-- lib/carray/autoload/autoload_gem_rmagick.rb
-- lib/carray/autoload/autoload_gem_zimg.rb
-- lib/carray/autoload/autoload_io_imagemagick.rb
-- lib/carray/autoload/autoload_math_histogram.rb
-- lib/carray/autoload/autoload_math_recurrence.rb
-- lib/carray/autoload/autoload_object_iterator.rb
-- lib/carray/autoload/autoload_object_link.rb
-- lib/carray/autoload/autoload_object_pack.rb
-- lib/carray/basic.rb
-- lib/carray/broadcast.rb
-- lib/carray/compose.rb
+- lib/carray/arrow_tensor.rb
+- lib/carray/attribute.rb
+- lib/carray/autoload_carray.rb
+- lib/carray/autoload_method_extension.rb
+- lib/carray/axis_group.rb
+- lib/carray/basics.rb
+- lib/carray/bincount_nd.rb
+- lib/carray/block_iterator.rb
+- lib/carray/boolean_reduce.rb
+- lib/carray/categorical.rb
+- lib/carray/categorical_iterator.rb
+- lib/carray/complex.rb
+- lib/carray/conditional.rb
+- lib/carray/const_string.rb
 - lib/carray/construct.rb
-- lib/carray/convert.rb
-- lib/carray/info.rb
+- lib/carray/core_extensions.rb
+- lib/carray/data_type_extension.rb
+- lib/carray/fixlen_string.rb
+- lib/carray/frame.rb
+- lib/carray/frame/concat.rb
+- lib/carray/frame/convert.rb
+- lib/carray/frame/csv_parser.rb
+- lib/carray/frame/frame.rb
+- lib/carray/frame/group.rb
+- lib/carray/frame/io.rb
+- lib/carray/frame/join.rb
+- lib/carray/frame/records.rb
+- lib/carray/frame/sort.rb
+- lib/carray/frame/verbs.rb
+- lib/carray/histogram.rb
 - lib/carray/inspect.rb
-- lib/carray/io/imagemagick.rb
 - lib/carray/iterator.rb
-- lib/carray/mask.rb
+- lib/carray/lazy.rb
+- lib/carray/mask_gap_fill.rb
 - lib/carray/math.rb
-- lib/carray/math/histogram.rb
-- lib/carray/math/recurrence.rb
+- lib/carray/meld_reduce.rb
+- lib/carray/methods/align_addr.rb
+- lib/carray/methods/bin.rb
+- lib/carray/methods/bincount.rb
+- lib/carray/methods/bit_string.rb
+- lib/carray/methods/broadcast.rb
+- lib/carray/methods/choose.rb
+- lib/carray/methods/composition.rb
+- lib/carray/methods/gather_nd.rb
+- lib/carray/methods/index.rb
+- lib/carray/methods/insert_block.rb
+- lib/carray/methods/is_in.rb
+- lib/carray/methods/join.rb
+- lib/carray/methods/locate_addr.rb
+- lib/carray/methods/mask_duplicates.rb
+- lib/carray/methods/meshgrid.rb
+- lib/carray/methods/mode.rb
+- lib/carray/methods/nunique.rb
+- lib/carray/methods/resize.rb
+- lib/carray/methods/snap.rb
+- lib/carray/methods/string_format.rb
+- lib/carray/methods/unique.rb
+- lib/carray/methods/value_counts.rb
 - lib/carray/mkmf.rb
-- lib/carray/object/ca_obj_iterator.rb
-- lib/carray/object/ca_obj_link.rb
-- lib/carray/object/ca_obj_pack.rb
-- lib/carray/obsolete.rb
-- lib/carray/ordering.rb
+- lib/carray/runtime.rb
 - lib/carray/serialize.rb
+- lib/carray/slab_iterator.rb
+- lib/carray/stack.rb
 - lib/carray/string.rb
+- lib/carray/string_operation_extension.rb
 - lib/carray/struct.rb
+- lib/carray/struct_builder.rb
 - lib/carray/table.rb
-- lib/carray/testing.rb
 - lib/carray/time.rb
-- lib/carray/transform.rb
-- mailmap
-- misc/Methods.ja.md
-- misc/NOTE
-- spec/Classes/CABitfield_spec.rb
-- spec/Classes/CABlockIterator_spec.rb
-- spec/Classes/CABlock_spec.rb
-- spec/Classes/CAField_spec.rb
-- spec/Classes/CAGrid_spec.rb
-- spec/Classes/CAMap_spec.rb
-- spec/Classes/CAMapping_spec.rb
-- spec/Classes/CAObject_attribute_spec.rb
-- spec/Classes/CAObject_spec.rb
-- spec/Classes/CARefer_spec.rb
-- spec/Classes/CARepeat_spec.rb
-- spec/Classes/CASelect_spec.rb
-- spec/Classes/CAShift_spec.rb
-- spec/Classes/CAStruct_spec.rb
-- spec/Classes/CATranspose_spec.rb
-- spec/Classes/CAUnboudRepeat_spec.rb
-- spec/Classes/CAWindow_spec.rb
-- spec/Classes/CAWrap_spec.rb
-- spec/Classes/CArray_spec.rb
-- spec/Classes/CScalar_spec.rb
-- spec/Features/feature_130_spec.rb
-- spec/Features/feature_attributes_spec.rb
-- spec/Features/feature_boolean_spec.rb
-- spec/Features/feature_broadcast.rb
-- spec/Features/feature_cast_function.rb
-- spec/Features/feature_cast_spec.rb
-- spec/Features/feature_class_spec.rb
-- spec/Features/feature_complex_spec.rb
-- spec/Features/feature_composite_spec.rb
-- spec/Features/feature_convert_spec.rb
-- spec/Features/feature_copy_spec.rb
-- spec/Features/feature_creation_spec.rb
-- spec/Features/feature_element_spec.rb
-- spec/Features/feature_extream_spec.rb
-- spec/Features/feature_generate_spec.rb
-- spec/Features/feature_index_spec.rb
-- spec/Features/feature_mask_spec.rb
-- spec/Features/feature_math_spec.rb
-- spec/Features/feature_order_spec.rb
-- spec/Features/feature_ref_store_spec.rb
-- spec/Features/feature_serialization_spec.rb
-- spec/Features/feature_stat_spec.rb
-- spec/Features/feature_virtual_spec.rb
-- spec/Features/method_eq_spec.rb
-- spec/Features/method_is_nan_spec.rb
-- spec/Features/method_map_spec.rb
-- spec/Features/method_max_with.rb
-- spec/Features/method_min_with.rb
-- spec/Features/method_ne_spec.rb
-- spec/Features/method_project_spec.rb
-- spec/Features/method_ref_spec.rb
-- spec/Features/method_round_spec.rb
-- spec/Features/method_s_linspace_spec.rb
-- spec/Features/method_s_span_spec.rb
-- spec/Features/method_seq_spec.rb
-- spec/Features/method_sort_with.rb
-- spec/Features/method_sorted_with.rb
-- spec/Features/method_span_spec.rb
-- spec/Features/method_wrap_readonly_spec.rb
-- spec/UnitTest/test_CAVirtual.rb
-- spec/spec_all.rb
-- utils/ca_ase.rb
-- utils/ca_methods.rb
-- utils/cast_checker.rb
-- utils/convert_test.rb
-- utils/extract_yard.rb
-- utils/guess_shape.rb
-- utils/monkey_patch_methods.rb
-- utils/remove_resource_fork.sh
+- lib/carray/window_iterator.rb
 homepage: https://github.com/himotoyoshi/carray
 licenses:
 - MIT
@@ -210,18 +242,19 @@ metadata: {}
 rdoc_options: []
 require_paths:
 - lib
+- ext
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.0
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 4.0.8
 specification_version: 4
 summary: Multi-dimesional array class for Ruby
 test_files: []

data/Rakefile

@@ -1,51 +0,0 @@
-#
-#
-#
-
-GEMSPEC = "carray.gemspec"
-
-task :install do
-  spec = eval File.read(GEMSPEC)
-  version_h = `ruby ext/version.rb`.chomp
-  if spec.version.to_s != version_h
-    STDERR.puts "Mismatch in version between carray.gemspec and version.h"
-    STDERR.puts "  carray.gemspec - #{spec.version.to_s }"
-    STDERR.puts "  version.h      - #{version_h}"
-    STDERR.puts "Please check!"
-    exit(1)
-  end
-  system %{
-    gem build #{GEMSPEC}; gem install #{spec.full_name}.gem --no-document
-  }
-end
-
-require 'rspec/core/rake_task'
-RSpec::Core::RakeTask.new
-
-
-__END__
-require 'rake'
-require 'rake/testtask'
-require 'rspec/core/rake_task'
-
-task :default => :test
-
-GEMSPEC = "carray.gemspec"
-
-task :install do
-  spec = eval File.read(GEMSPEC)
-  system %{
-    gem build #{GEMSPEC}; gem install #{spec.full_name}.gem
-  }
-end
-
-desc "Run the tests"
-Rake::TestTask::new(:test) do |t|
-  t.test_files = FileList['test/test_ALL.rb']
-  t.verbose = true
-end
-
-RSpec::Core::RakeTask.new(:spec) do |t|
-  t.pattern = "spec/**/*_spec.rb"
-  t.rspec_opts = ["-c", "-fs"]
-end

data/TODO.md

@@ -1,18 +0,0 @@
-ToDo List
-=========
-
-ToDo
--------
- * Implement CArray.broadcast in C
- * Implement Integer#{|,&,^,<<,>>} with Refinement (remove monkey patch)
- * Remove RSTRUCT hack in carray_access.c for handling of Range object.
- * Solve abs probrems
- * Create spec
-   - str_format (cyclic format)
-   - CA_SIZE
-   - serialization of carray which has data_class
-
-Done
--------
- * Data -> TypedData
-