From 59ab5338d4e23eb108a43f876aa979238ae2490e Mon Sep 17 00:00:00 2001 From: Marshall Lochbaum Date: Fri, 12 Nov 2021 22:15:44 -0500 Subject: Slightly less APL-centric documentation --- docs/doc/transpose.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/doc/transpose.html') diff --git a/docs/doc/transpose.html b/docs/doc/transpose.html index 1cf882dc..fca1d637 100644 --- a/docs/doc/transpose.html +++ b/docs/doc/transpose.html @@ -5,7 +5,7 @@
(github) / BQN / doc

Transpose

-

Transpose (⍉) is a tool for rearranging the axes of an array. BQN's version is tweaked relative to APL to align better with the leading axis model and make common operations easier.

+

Transpose (⍉) is a tool for rearranging the axes of an array 𝕩. Without a left argument, it moves the first axis to the end, while a left argument can specify an arbitrary rearrangement. Both cases are tweaked relative to APL to align better with the leading axis model and make common operations easier.

Transpose basics

The name for the primitive ⍉ comes from the Transpose operation on matrices. Given a matrix as an array of rank 2, ⍉ will transpose it:

↗️
    ⊢ mat ← 2‿3 ⥊ ↕6
@@ -100,7 +100,7 @@
 ↗️
    ≢ 1‿3‿2‿0‿4 ⍉⁼ a23456
 ⟨ 3 5 4 2 6 ⟩
 

-
So far, all like APL. BQN makes one little extension, which is to allow only some axes to be specified. Then 𝕨 will be matched up with leading axes of 𝕩. Those axes are moved according to 𝕨, and remaining axes are placed in order into the gaps between them.

+
BQN makes one further extension, which is to allow only some axes to be specified (this is the only difference in dyadic ⍉ relative to APL). Then 𝕨 will be matched up with leading axes of 𝕩. Those axes are moved according to 𝕨, and remaining axes are placed in order into the gaps between them.

 ↗️
    ≢ 0‿2‿4 ⍉ a23456
 ⟨ 2 5 3 6 4 ⟩
 

-- 
cgit v1.2.3