Difference between revisions of "Drop"

From APL Wiki
Jump to navigation Jump to search
m (Text replacement - "{{APL built-ins}}" to "{{APL built-ins}}Category:Primitive functions")
m (Text replacement - "http://help.dyalog.com" to "https://help.dyalog.com")
Tags: Mobile web edit, Mobile edit
Line 57: Line 57:
=== Documentation ===
=== Documentation ===
* [http://help.dyalog.com/latest/index.htm#Language/Primitive%20Functions/Drop.htm Dyalog] ([http://help.dyalog.com/latest/index.htm#Language/Primitive%20Functions/Drop%20with%20Axes.htm with axis])
* [https://help.dyalog.com/latest/index.htm#Language/Primitive%20Functions/Drop.htm Dyalog] ([https://help.dyalog.com/latest/index.htm#Language/Primitive%20Functions/Drop%20with%20Axes.htm with axis])
* [http://microapl.com/apl_help/ch_020_020_570.htm APLX]
* [http://microapl.com/apl_help/ch_020_020_570.htm APLX]

Latest revision as of 14:25, 14 July 2020

Drop () is a primitive function which removes part of each axis of an array. The removed portions are exactly those that Take would include in its result. Drop is subject to the same extensions as Take, and a detailed description of those extensions and their history is given in that article rather than this one. Unlike Take, Drop never uses fill elements and the result is always a subarray of the argument.


Use Drop to remove leading or trailing elements from a vector:

      3  5 4 3 2 1
2 1
      ¯3  5 4 3 2 1
5 4

Removing more elements than the length of the axis gives an empty result:

      ¯8  5 4 3 2 1
Works in: Dyalog APL, ngn/apl

When the right argument is a multidimensional array, one element from the left argument is used for each axis. In a language that supports axis specification for Take, or allows a short left argument, you can specify drop amounts for only some axes: other axes will remain unchanged.

      2 3  4 5
3 43 5
4 44 5


The arguments to Drop must be valid arguments to Take, and elements of the left argument are matched to axes of the right in the same way. Like Take, the left argument is subject to scalar rank extension, and in some APLs the right is as well.

Each axis with a matching left argument element d is modified to remove |d indices, or all of them if |d is larger than the length of the axis. Indices are removed starting from the beginning if d is positive and starting from the end if it is negative (if d is 0, then no indices are removed). Equivalently, for an axis of length l, l-l⌊|d axes are retained—not dropped—from the axis starting from the opposite side: the end if d is positive and the beginning otherwise. If |d is greater than or equal to l for any axis, then the result is empty and shares a prototype with the argument.

APL Model

Drop can be modelled using Take with a complementary length:

Drop  {
    s , ((0=≢s)×≢)1          ⍝ Scalar rank extension
    s  ()s                  ⍝ SHARP APL extension
    ((sׯ1*>0) + (-s)s)  

The code works by modifying the left argument using the right argument's shape. First, the shape is used to restrict the left argument's range ((-s)s) so that the maximum number of indices dropped is the length of the axis. Then, the shape is added or subtracted so that the left argument's sign is flipped.

This implementation inherits all argument extensions from Take. The two middle lines are used to support right argument scalar rank extension and the SHARP APL short left argument extension. If Take does not have these extensions then they have no effect and can be removed.

External links



APL built-ins [edit]
Primitive functions
Monadic ConjugateNegateSignumReciprocalMagnitudeExponentialNatural LogarithmFloorCeilingFactorialNotPi TimesRollTypeImaginarySquare Root
Dyadic AddSubtractTimesDivideResiduePowerLogarithmMinimumMaximumBinomialComparison functionsBoolean functions (And, Or, Nand, Nor) ∙ GCDLCMCircularComplexRoot
Structural ShapeReshapeTallyDepthRavelEnlistTableCatenateReverseRotateTransposeRazeMixSplitEncloseNestCut (K)PairLinkPartitioned EnclosePartition
Selection FirstPickTakeDropUniqueIdentitySelectReplicateExpandSet functions (IntersectionUnionWithout) ∙ Bracket indexingIndex
Selector Index generatorGradeIndex OfInterval IndexIndicesDeal
Computational MatchNot MatchMembershipFindNub SieveEncodeDecodeMatrix InverseMatrix DivideFormatExecuteMaterialiseRange
Primitive operators Monadic EachCommuteConstantReplicateExpandReduceWindowed ReduceScanOuter ProductKeyI-beamSpawnFunction axis
Dyadic BindCompositions (Compose, Reverse Compose, Beside, Atop, Over) ∙ Inner ProductPowerAtUnderRankDepthVariantStencilCut (J)
Quad names
Arrays Index originMigration levelAtomic vector
Functions Case convertUnicode convert
Operators SearchReplace