Split: Difference between revisions

Jump to navigation Jump to search
108 bytes added ,  10:55, 11 September 2022
m
Text replacement - "<source" to "<syntaxhighlight"
m (Text replacement - "</source>" to "</syntaxhighlight>")
m (Text replacement - "<source" to "<syntaxhighlight")
 
Line 1: Line 1:
{{Built-in|Split|↓}} is a [[monadic]] [[primitive function]] which reduces the [[rank]] of its [[argument]] by converting one of its [[axis|axes]] to one level of [[nested array model|nesting]]. The axis to move defaults to the last axis, but a different axis can be chosen using [[function axis]]. It shares its [[glyph]] <source lang=apl inline>↓</syntaxhighlight> with the dyadic function [[Drop]]. Split is the [[inverse]] of [[Mix]] in the sense that the latter undoes the enclosing that Split introduced.
{{Built-in|Split|↓}} is a [[monadic]] [[primitive function]] which reduces the [[rank]] of its [[argument]] by converting one of its [[axis|axes]] to one level of [[nested array model|nesting]]. The axis to move defaults to the last axis, but a different axis can be chosen using [[function axis]]. It shares its [[glyph]] <syntaxhighlight lang=apl inline>↓</syntaxhighlight> with the dyadic function [[Drop]]. Split is the [[inverse]] of [[Mix]] in the sense that the latter undoes the enclosing that Split introduced.


== Examples ==
== Examples ==


The result of Split on a non-[[scalar]] array is always a [[nested array]] whose elements are [[vector|vectors]]. The [[rank]] of <source lang=apl inline>↓[K]Y</syntaxhighlight> is <source lang=apl inline>¯1+≢⍴Y</syntaxhighlight> (original rank minus 1), its [[shape]] is <source lang=apl inline>(K≠⍳≢⍴Y)/⍴Y</syntaxhighlight> (original shape with K-th axis removed), and the shape of each element is <source lang=apl inline>(⍴Y)[K]</syntaxhighlight>.
The result of Split on a non-[[scalar]] array is always a [[nested array]] whose elements are [[vector|vectors]]. The [[rank]] of <syntaxhighlight lang=apl inline>↓[K]Y</syntaxhighlight> is <syntaxhighlight lang=apl inline>¯1+≢⍴Y</syntaxhighlight> (original rank minus 1), its [[shape]] is <syntaxhighlight lang=apl inline>(K≠⍳≢⍴Y)/⍴Y</syntaxhighlight> (original shape with K-th axis removed), and the shape of each element is <syntaxhighlight lang=apl inline>(⍴Y)[K]</syntaxhighlight>.


<source lang=apl>
<syntaxhighlight lang=apl>
       ⎕←Y←2 3 4⍴⎕A  ⍝ 3D array
       ⎕←Y←2 3 4⍴⎕A  ⍝ 3D array
ABCD
ABCD
Line 41: Line 41:
Split is a no-op to a [[scalar]].
Split is a no-op to a [[scalar]].


<source lang=apl>
<syntaxhighlight lang=apl>
       2≡↓2
       2≡↓2
1
1
Line 47: Line 47:


== Alternatives ==
== Alternatives ==
Most dialects do not have Split. Instead, they can use [[Enclose]] (<source lang=apl inline>⊂</syntaxhighlight>) with [[bracket axis]] or the [[Rank operator]]:
Most dialects do not have Split. Instead, they can use [[Enclose]] (<syntaxhighlight lang=apl inline>⊂</syntaxhighlight>) with [[bracket axis]] or the [[Rank operator]]:
<source lang=apl>
<syntaxhighlight lang=apl>
       ↓Y
       ↓Y
┌────┬────┬────┐
┌────┬────┬────┐
Line 68: Line 68:
└────┴────┴────┘
└────┴────┴────┘
</syntaxhighlight>
</syntaxhighlight>
It is common to split a higher-[[rank]] array into its constituent [[major cell|major cells]]. The behaviour of Split on matrices might mislead to the belief that this is what the primitive does. However, it isn't so for vectors or arrays of higher rank than 2. Instead, the solution is to use or <source lang=apl inline>⊂[1↓⍳≢⍴Y]Y</syntaxhighlight> or <source lang=apl inline>⊂⍤¯1⊢Y</syntaxhighlight>:
It is common to split a higher-[[rank]] array into its constituent [[major cell|major cells]]. The behaviour of Split on matrices might mislead to the belief that this is what the primitive does. However, it isn't so for vectors or arrays of higher rank than 2. Instead, the solution is to use or <syntaxhighlight lang=apl inline>⊂[1↓⍳≢⍴Y]Y</syntaxhighlight> or <syntaxhighlight lang=apl inline>⊂⍤¯1⊢Y</syntaxhighlight>:
<source lang=apl>
<syntaxhighlight lang=apl>
       ⊂[1↓⍳≢⍴Y]Y
       ⊂[1↓⍳≢⍴Y]Y
┌────┬────┐
┌────┬────┐

Navigation menu