namo 0.32.12 → 0.32.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2dce502d2be2c6d9a083f5edaad6bdbd87b4b5e2c5d937ebed96f0ae67107d0
-  data.tar.gz: c1d52e9d64db09c77c3e64bcd2a4ef720e27a78594125e97fd65c84153d0643b
+  metadata.gz: b3727f5e87d90c759f2423093d4deee86b6179f50cf156828560297f925ff4d0
+  data.tar.gz: 8e26c16a0bbe24597732bfd21b2912944b3d684eab00626c3239c2ce25e6d9a4
 SHA512:
-  metadata.gz: b0acdef51d367e39b52851b4ecb62c10c4514271e3612466b62d044bd27fbd5d06e55f4c4a252401f03635abc78aaf5b4d94bb5cc0c274372fb02c2dbf670b5e
-  data.tar.gz: eb76074465a47978d35d7b4423b1b9c869a4043ef6b505010f47c37ab66605d8e024e8cf637a13c82aa5cf67b605a0c67ccb224bf8b1e302b5fb404d103ae303
+  metadata.gz: '08ae91c58efd9cd91084f384c43b0399f6acde45b73e21c53077d91851cf5e20cdef343bd598f4c435f01eec485e1aac5bfe46bf1bb14f390e08a6224ff98f6f'
+  data.tar.gz: 2c8f96dbdbc81268789b480a16b1dac618e38f94960959314bf459b7a0bad6eb55d5658f1db490f70153b3686e40f5fe878dfbbd1c60a20cc10d9ea8eddde93a

data/CHANGELOG

@@ -2,6 +2,19 @@
 
 ## 20261109
 
+0.32.13: ~ README.md: A new section shows a Namo passed to statistics.rb, terminal-table, vega, and Polars-ruby.
+
+1. ~ README.md: A section, "Using Namo with other libraries", after "Inspection output", passes a Namo to statistics.rb for statistics, terminal-table for a table, vega for a chart, and Polars-ruby for a pivot.
+2. ~ README.md: The note on summary's reducer: points to statistics.rb.
+3. + comparison/readme_claims.rb: Runs every snippet in "Using Namo with other libraries", in order, then the probe behind its caveat.
+4. ~ comparison/setup: The ruby environment gains statistics.rb 0.11.0, terminal-table 4.0.0, and vega 0.6.0.
+5. ~ comparison/README.md: The new script is described.
+6. ~ comparison/ruby_claims.rb: Polars, Rover, and RedAmber frames are built from a Namo's to_h.
+7. ~ RUBY_COMPARISON.md: Display is left to other libraries, where the others had been said to do it better, and the libraries are said to compose, a Namo's values and to_h being what the three columnar ones are built from.
+8. ~ ROADMAP.md: In "Composition with surrounding systems", Namo leaves tables, charts, statistics, and pivots to other libraries, as 0.24.0 did pivoting.
+9. ~ ROADMAP.md: In 3.x, a Namo switches between row and column storage to suit the operations asked of it. Columnar storage's third step is rewritten, and a "Dynamic layout" section covers which operations suit which layout, a ColumnStore of native buffers, three options for deciding when to switch, how switching interacts with freezing, and what data returns when columns are stored. The second layout kept as a cache and invalidated on mutation is dropped, since the data back door means that not every mutation can be detected.
+10. ~ Namo::VERSION: /0.32.12/0.32.13/
+
 0.32.12: + RUBY_COMPARISON.md: Namo is compared with Daru, Rover, Polars-ruby, and RedAmber.
 
 1. + RUBY_COMPARISON.md: Namo is compared with Daru 0.3, Rover 1.1.0, Polars-ruby 0.27.1, and RedAmber 0.5.2 on Ruby 4.0.7, feature by feature and in measured timings.

data/README.md

@@ -1063,6 +1063,74 @@ sales.group_by(:quarter)
 # ] 4 rows>
 ```
 
+### Using Namo with other libraries
+
+Namo holds data and computes over it. It leaves tables, charts, statistics, and pivots to libraries made for them. `values`, `to_h`, and `to_a` produce the shapes those libraries take, an Array per column, a Hash of those Arrays, or an Array of Hashes, so passing a Namo to one is usually a single call. Below is one library for each.
+
+Statistics, with statistics.rb, whose opt-in patch gives every Enumerable `mean`, `median`, `standard_deviation`, and more:
+
+```ruby
+require 'statistics-enumerable'
+
+sales.values(:revenue).mean                  # => 1250.0
+sales.values(:revenue).standard_deviation    # => 250.0
+
+sales[:revenue_z] = proc{|row, namo| (row[:revenue] - namo.values(:revenue).mean) / namo.values(:revenue).standard_deviation}
+sales.values(:revenue_z)                     # => [-1.0, 1.0, -1.0, 1.0]
+
+sales.group_by(:product).summary(:revenue, reducer: :mean).to_a
+# => [{member: "Widget", revenue: 1250.0}, {member: "Gadget", revenue: 1250.0}]
+```
+
+Since Namo is Enumerable, the patch applies to it too, but a Namo iterates over Rows, so `sales.mean` raises an error. Call these methods on a column instead.
+
+A table in the terminal, with terminal-table:
+
+```ruby
+require 'terminal-table'
+
+columns = sales.values(:product, :quarter, :revenue)
+puts Terminal::Table.new(headings: columns.keys, rows: columns.values.transpose)
+# +---------+---------+---------+
+# | product | quarter | revenue |
+# +---------+---------+---------+
+# | Widget  | Q1      | 1000.0  |
+# | Widget  | Q2      | 1500.0  |
+# | Gadget  | Q1      | 1000.0  |
+# | Gadget  | Q2      | 1500.0  |
+# +---------+---------+---------+
+```
+
+A chart, with vega, which renders in IRuby or on a web page. Vega-Lite takes the rows as they are:
+
+```ruby
+require 'vega'
+
+Vega.lite
+  .data(sales.to_a)
+  .mark(type: 'bar')
+  .encoding(x: {field: 'quarter'}, y: {field: 'revenue', type: 'quantitative'}, color: {field: 'product'})
+```
+
+A pivot, with Polars, since Namo does not pivot. Polars takes the columnar form:
+
+```ruby
+require 'polars-df'
+
+Polars::DataFrame.new(sales.values(:product, :quarter, :revenue)).pivot('quarter', index: 'product', values: 'revenue')
+# shape: (2, 3)
+# ┌─────────┬────────┬────────┐
+# │ product ┆ Q1     ┆ Q2     │
+# │ ---     ┆ ---    ┆ ---    │
+# │ str     ┆ f64    ┆ f64    │
+# ╞═════════╪════════╪════════╡
+# │ Widget  ┆ 1000.0 ┆ 1500.0 │
+# │ Gadget  ┆ 1000.0 ┆ 1500.0 │
+# └─────────┴────────┴────────┘
+```
+
+These examples use `values` with several dimensions rather than a projection, because a projection also carries every formula it does not name, still live, so `:revenue_z` would be included too. `comparison/readme_claims.rb` runs these examples.
+
 ### Named Namos
 
 A Namo can carry a name, passed by the `name:` keyword and read or set through the `name` accessor:
@@ -1180,7 +1248,7 @@ gt.as_summary(:weight)                     # gt's data becomes the summary; retu
 gt.as_detail(:assembly)                    # gt's data becomes the detail; returns gt
 ```
 
-`reducer:` is any method the member's column responds to — `:sum` (the default) and `:mean` are typical (`:mean` via a statistics gem that adds `Array#mean`).
+`reducer:` is any method the member's column responds to — `:sum` (the default) and `:mean` are typical (`:mean` via a statistics gem that adds `Array#mean`, as statistics.rb does: see [Using Namo with other libraries](#using-namo-with-other-libraries)).
 
 #### A block for per-member reductions
 

data/lib/Namo/VERSION.rb

@@ -2,5 +2,5 @@
 # Namo::VERSION
 
 class Namo
-  VERSION = '0.32.12'
+  VERSION = '0.32.13'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: namo
 version: !ruby/object:Gem::Version
-  version: 0.32.12
+  version: 0.32.13
 platform: ruby
 authors:
 - thoran