Array Manipulation
Introduction to Array Manipulation
Arrays/Sets/Matrices are fundamental data structures in z^3. Manipulation of such data structures are often done using custom code in most languages. However, z^3 offers a ton of Array member functions that make it a breeze to handle and manipulate such data structures.
For example, take .chunks().
a=1..100;
This creates a list of 100 numbers. Now, let us make them into chunks of 10 each.
a.chunks(10)
gives
| 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 |
| 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 |
| 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 |
| 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 |
| 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 |
| 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 |
| 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 |
| 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 |
| 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 |
| 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100 |
Simple, isn't it?
The result gives a 10x10 matrix filled with the sequence of numbers from 1 to 100.
Let us say we want to calculate the sum of each row in this 10x10 matrix. The $$ row wise mapping function comes to the rescue.
b=a.chunks(10) b.$$(SUM)
| 55 |
| 155 |
| 255 |
| 355 |
| 455 |
| 555 |
| 655 |
| 755 |
| 855 |
| 955 |
ARRAY FUNCTIONS
A listing of the Array functions are given below:
Function name Parameter
| Function Name | Parameters |
|---|---|
| [$ .$()] | |
| $$ | |
| $$$ | |
| $$F | |
| $A | Parameter |
| $C | |
| $CELLS | |
| $R | |
| $X | |
| $_ | |
| $d | |
| $diag | |
| $dth | |
| $x | |
| X$ | |
| ZJSON | |
| __$ | |
| ac | |
| accumulate | Total |
| accumulatewith | CumulateFunction,CurrentResult |
| across | OtherArray, Function |
| add | Thing |
| addcolumn | NumberOfColumns |
| addrow | NumberOfRows |
| addsequence | InFront,StartFrom,OptionalSequenceArray |
| adjoint | Array |
| aggregate | Columns,Function, Params |
| any | Count |
| appendfunction | Function |
| ar | |
| async | Iterator, CallBack |
| atindex | |
| atnode | Function,SubtractByArray,ScaleByArray,DoNotShowIndices |
| backward | Function, StartValue |
| bindcolumn | |
| branch | |
| branchvalues | |
| c | |
| calci | |
| car | |
| cartesianproduct | IsWithoutFlatten |
| cdr | |
| cell | Row, Column, Width, Height |
| cells | |
| checktype | TypeArray,ForceCheckOnVariables |
| chunks | ChunkSize |
| ci | |
| clean | Expression, ReplaceWith |
| clear | FillWith |
| clearcopy | FillWith |
| clearrepeats | |
| clone | |
| colconcat | |
| colcount | |
| collect | |
| collectasvector | |
| collectwhile | |
| collectwhileasvector | |
| column | |
| columnconcat | |
| columns | |
| compare | |
| concatall | LimitArray, IncludeEdges |
| converge | Function, NumberOfIterations, Accuracy, Converge |
| copy | |
| core | |
| count | FirstLevelOnly |
| crosstab | RowSet, ColSet,PageSet,DataSet |
| cube | |
| cumcolumn | |
| cumcolumns | |
| cumcolumnswith | |
| cumcolumnwith | |
| cumrow | |
| cumrows | |
| cumrowswith | |
| cumrowwith | |
| cumulate | |
| data | |
| dc | |
| deal | Within, ManyInEach |
| deepcopy | |
| deletecolumn | Where |
| deleterow | Where |
| det | Array |
| determinant | |
| dim | |
| div | |
| divide | |
| dr | |
| drop | |
| dropwhile | |
| dropwhileasvector | |
| eighteenth | |
| eighth | |
| eleventh | |
| equal | Array, CheckLength, StartFrom |
| equalvalues | Array, CheckLength, StartFrom |
| eval | |
| except | |
| exec | |
| explode | StartIndex, By, RecurseTillLevel |
| extract | |
| few | |
| fifteenth | Function |
| fifth | |
| fillwith | |
| filtermatches | MatchIdenticalMatrix, OnlyMatches |
| filteroncolumn | Condition, ExtractColumns, FilterOnColumn |
| filteroncondition | TakeDropOrAllFlag, Function, Parameter |
| filteronrow | Condition, ExtractColumns, FilterOnColumn |
| findcellref | Values |
| first | Count |
| firstelement | Count |
| firsthalf | |
| fixat | Index,Fix |
| fjoin | HeadLength, JoinString |
| flatten | |
| flip | |
| flipparts | |
| fold | AtFoldValue, AtReverseFoldValue |
| foldl | Function, StartSeed |
| foldr | Function, StartSeed |
| forward | Function, StartValue |
| fourteenth | |
| fourth | |
| fourths | |
| funcjoin | HeadLength, FindString, FirstString, MidString, LastString |
| gettype | |
| graph | Mode |
| graphin | |
| half | |
| halves | |
| hderef | Array |
| head | |
| headings | |
| hindex | |
| hundredth | |
| i | PreviousArray |
| ic | |
| ids | |
| implode | RecurseTillLevel |
| inc | |
| include | |
| indices | Function,SubtractByArray,ScaleByArray,DoNotShowIndices,RowArray |
| injoin | JoinWith |
| insert | Value, AfterLastFlag |
| insertcolumn | Index, NumberOfColumns |
| insertrow | Index, NumberOfRows |
| inverse | Array |
| ir | |
| is | Thing, IsNot |
| is1d | |
| is2d | |
| isFalse | |
| isTrue | |
| islikelytype | |
| isnotnull | |
| isnull | |
| istype | |
| j | |
| joincolumnswith | ArrayOfJoinCharacters,IsRepeat |
| joinrowswith | ArrayOfJoinCharacters,IsRepeat |
| joinwith | |
| jq | |
| keep | |
| last | Count |
| lastelement | Count |
| list | |
| lookup | |
| make | |
| make1to2d | ReplaceOriginal |
| makecore | |
| makekeyarray | Recursive |
| maplist | fun |
| mapper | Function |
| maprow | Function |
| mask | |
| match | Expression |
| matchcolumn | Expression, Column |
| matchindex | Expression, IndexThenFromMatch |
| matchrow | Expression, Row |
| matchvalue | Expression, IndexThenFromMatch |
| merge | OtherArray, Function |
| mergecolumns | OtherArray |
| mergeio | |
| mergerows | |
| mid | From,Count |
| millionth | |
| multiply | |
| nicejoin | JoinString, EndString, SubArrayString |
| nineteenth | |
| nineth | |
| nodeindex | |
| notinclude | Item |
| notwithinlimits | LimitArray, IncludeEdges |
| nth | Nth, Count |
| ntimes | Function, NumberOfIterations, Accuracy, Converge |
| nullifyobjects | Recursive |
| numbers | ForceCheckOnVariables |
| o | |
| objects | |
| of | |
| otherthan | ArrayWithElementsToExclude |
| pack | |
| pad | Length, PadString |
| pair | Value, OnRight |
| pairmatch | AtFoldValue, AtReverseFoldValue, StartFrom |
| partitiononcondition | TakeDropOrAllFlag, Function, Parameter |
| parts | NumberOfParts, SpecificPart |
| pastefolds | MidOnly |
| pick | StyleString, JoinString |
| pieces | Width, Function |
| pip | |
| pipall | |
| pipallwithslice | |
| plot | |
| prefix | |
| primitives | |
| printf | |
| r | |
| rand | |
| random | Base,Numbers |
| remove | |
| removeByVal | Value |
| removeindices | |
| removewith | |
| repeatntimes | Function, NumberOfIterations, Accuracy, Converge |
| replace | ExpressionArrayOrValues, ReplaceWith |
| replicate | Count |
| rest | Start, Count |
| result | |
| reverselevel | Level |
| reversepip | |
| reversesort | Function |
| ri | |
| rotate | NumberOfSteps |
| rotatecolumns | NumberOfSteps |
| rotaterows | NumberOfSteps |
| row | |
| rowconcat | OtherArray |
| rowcount | |
| rowlengths | Function |
| rowpush | OtherArray |
| rows | |
| rslice | |
| second | |
| secondhalf | |
| seq | StartIndex, By |
| set | |
| setHeadings | |
| setaxis | Axis, ColumnValues |
| setcolumn | Column, ColumnValues |
| setrow | Row, Array |
| setunit | |
| seventeenth | |
| seventh | |
| shiftlevel | Level, NumberOfTimes |
| shuffle | |
| sixteenth | |
| sixth | |
| size | |
| size2d | |
| slices | SliceExpression |
| slides | |
| sortrecursively | |
| sortwith | |
| specialprint | Trimmed,TabLevel |
| spliteach | SplitExpression, RetainSplitterAlsoInResult |
| splitwhile | |
| splitwhileasvector | |
| stringlist | |
| subtract | |
| suchthat | |
| suchthatasvector | |
| suffix | |
| t | |
| table | |
| tablelookup | RowValueMatch, ColumnValueMatch |
| tail | |
| takewhile | |
| takewhileasvector | |
| tenth | |
| third | |
| thirds | |
| thirteenth | |
| thousandth | |
| tofunctions | |
| toobjectformat | |
| totree | |
| transpose | IncludeHeader |
| truefalse | IsCheckTrueFunctionList,IsCheckFalseFunctionList,DoFlattenFirst |
| twelfth | |
| twentieth | |
| twod | |
| type | |
| uncrosstab | UptoColumn |
| unimplode | RecurseTillLevel |
| unimplodeleaf | |
| unitsof | |
| unwrapleaf | |
| unzip | |
| value | Function |
| where | Term |
| withinlimits | LimitArray, IncludeEdges |
| withouttail | |
| x$ | FunctionArray, OffsetArray, ScaleArray, GiveIndicesAlso,DoCentering |
| xy | |
| xypanel | FunctionArray, OffsetArray, ScaleArray, GiveIndicesAlso |
| z3 | |
| zero | ValueInstead, PreserveStructure |
| zip | OtherArray |
| zoompip | |
| 㪭㭲 |