From d20c2c1adfed906babc1447aabecad1607a1fb21 Mon Sep 17 00:00:00 2001 From: Marshall Lochbaum Date: Sat, 2 Jul 2022 22:27:33 -0400 Subject: Diagram for Bins --- doc/order.md | 24 ++++++++++++++++++++++ docs/doc/order.html | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 81 insertions(+) diff --git a/doc/order.md b/doc/order.md index 4adbc0f1..d87cdb54 100644 --- a/doc/order.md +++ b/doc/order.md @@ -121,6 +121,30 @@ To see some of the possibilities of Grade, you might pick apart the following ex ## Bins + + The two Bins functions are written with the same symbols `⍋` and `⍒` as Grade, but take two arguments instead of one. More complicated? A little, but once you understand Bins you'll find that it's a basic concept that shows up in the real world all the time. Bins behaves like a [search function](search.md) with respect to rank: it looks up [cells](array.md#cells) from `𝕩` relative to major cells of `𝕨`. However, there's an extra requirement: the left argument to Bins must already be sorted according to whichever ordering is used. If it isn't, you'll get an error. diff --git a/docs/doc/order.html b/docs/doc/order.html index af62ea0a..22e25663 100644 --- a/docs/doc/order.html +++ b/docs/doc/order.html @@ -189,6 +189,63 @@ "210dcbaEDCBA"

Bins

+ + + + + + + + + + + + + + + + + + + + + 'b' + 'i' + 'n' + 's' + + + 'g' + 'r' + 'a' + 'd' + 'e' + 's' + + + 1 + 3 + 0 + 1 + 1 + 4 + + + + 0 + 1 + 2 + 3 + 4 + + + 𝕨 + 𝕩 + 𝕨⍋𝕩 + + + +

The two Bins functions are written with the same symbols ⍋ and ⍒ as Grade, but take two arguments instead of one. More complicated? A little, but once you understand Bins you'll find that it's a basic concept that shows up in the real world all the time.

Bins behaves like a search function with respect to rank: it looks up cells from 𝕩 relative to major cells of 𝕨. However, there's an extra requirement: the left argument to Bins must already be sorted according to whichever ordering is used. If it isn't, you'll get an error.

↗️
    5‿6‿2‿4‿1 ⍋ 3
-- 
cgit v1.2.3