Back to FabImage Studio website

You are here: Start » Filter Reference » Array

Array

Array Basics

Icon Name Description / Applications Modules
ArrayIndices

Creates an array of element indices, i.e. {0, 1, 2, ..., N-1}, where N is the length of the input array.

FoundationLite
FindAll

Finds all locations of a given value in the input array.

FoundationLite
FindFirst

Finds first location of a given value in the input array.

FoundationLite
FindLast

Finds last location of a given value in the input array.

FoundationLite
SkipArrayWithNils

If the input array contains no Nil values, then it is copied to the output; otherwise Nil is returned.


Changes an array with conditional elements into a conditional array. Can be useful if some processing should be performed only when all expected objects are correctly detected.

FoundationLite
SkipEmptyArray

If the input array is not empty, then it is copied to the output; otherwise Nil is returned.


Secures against domain errors caused by empty arrays, e.g. just before the GetMaximumElement filter is to be invoked.

FoundationLite
SkipLongArray

If the input array is short enough, then it is copied to the output; otherwise Nil is returned.


Secures against domain errors caused by arrays having too many elements.

FoundationLite
SkipNotSingle

If the input array has exactly one element, then the element is copied to the output; otherwise Nil is returned.


Changes execution mode from array mode to conditional mode.

FoundationLite
SkipShortArray

If the input array has enough elements, then it is copied to the output; otherwise Nil is returned.


Secures against domain errors caused by arrays having too few elements, e.g. just before the FitSegmentToPoints filter is to be invoked.

FoundationLite
SkipUnequalSizeArrays

If the input arrays have equal size, then they are copied to the output; otherwise Nils are returned.

FoundationLite

Array Composition

Icon Name Description / Applications Modules
AccumulateArray

Joins arrays appearing in consecutive iterations.

FoundationLite
JoinArrays_OfLoop

Joins arrays appearing in consecutive iterations.

FoundationLite
FlattenArray

Receives an array of arrays, and creates a single one-dimensional array containing all individual elements.


E.g. when multiple points are detected within multiple regions we receive a Point2DArrayArray. This 2D data structure keeps track of which point comes from which region. We can flatten this structure to 1D array by using this filter.

FoundationLite
RemoveArrayElement

Removes an element at the given index from the input array.

FoundationLite
RemoveMultipleArrayElements

Removes elements at the given indices from the input array.

FoundationLite
RemoveRangeFromArray

Removes elements at the given indices from the input array.

FoundationLite
RemoveValueFromArray

Removes the first or all of the elements of the given value from an array.

FoundationLite
ReplaceInArray

Replaces all matching elements in an array with a new value.

FoundationLite

Array Set Operators

Icon Name Description / Applications Modules
ArrayDifference

Returns an array of elements contained in the first input array, but not contained in the second one (without duplicates).

FoundationLite
ArrayIntersection

Returns an array of elements contained in all of the input arrays (without duplicates).

FoundationLite
ArraySymmetricDifference

Returns an array of elements contained in odd number of the input arrays (without duplicates).

FoundationLite
ArrayUnion

Returns an array of elements contained in at least one of the input arrays (without duplicates).

FoundationLite

Array Statistics

Icon Name Description / Applications Modules
GetMaximumElement

Returns an array element that corresponds to the biggest value in the array of values.


Choosing one object from an array on the basis of some feature, e.g. the blob having the highest area.

FoundationLite
GetMaximumElement_OrNil

Returns an array element that corresponds to the biggest value in the array of values; returns NIL if the arrays are empty.


Choosing one object from an array on the basis of some feature, e.g. the blob having the highest area.

FoundationLite
GetMedianElement

Gets an array element corresponding to the median value from the inValues array.

FoundationLite
GetMedianElement_OrNil

Gets array element corresponding to median value from the inValues array; returns NIL if the arrays are empty.

FoundationLite
GetMinimumElement

Returns an array element that corresponds to the smallest value in the array of values.


Choosing one object from an array on the basis of some feature, e.g. the blob having the smallest convexity.

FoundationLite
GetMinimumElement_OrNil

Returns an array element that corresponds to the smallest value in the array of values; returns NIL if the arrays are empty.


Choosing one object from an array on the basis of some feature, e.g. the blob having the smallest convexity.

FoundationLite
GetNthElement

Returns the array element corresponding to the n-th biggest/smallest value from the inValues array.

FoundationLite
GetNthElement_OrNil

Returns the array element corresponding to the n-th biggest/smallest value from the inValues array; returns NIL if the arrays are empty.

FoundationLite
GetSortedElements

Returns elements corresponding to 8 smallest/biggest values from the array of values.

FoundationLite

Array Transforms

Icon Name Description / Applications Modules
CropArray

Selects a continuous subsequence of array elements.

FoundationLite
CropArraysToEqualSize

Removes some trailing elements from the longer array of the two so that the output arrays have equal size.

FoundationLite
RemoveDuplicates

Removes repeated elements from array.

FoundationLite
RemoveElementsFromArrayEnds

Removes all specified values from one or both ends of an array.

FoundationLite
RemoveNils

Removes all Nil elements from an array.


This filter is useful e.g. when inspecting multiple objects while some of the inspections may fail (Nil result). RemoveNils is used to ignore the failed cases in the final result.

FoundationLite
ReverseArray

Creates an array of the input array elements in reversed order.

FoundationLite
RotateArray

Cyclically shifts the elements of an array.

FoundationLite
SlideArray

Creates two copies of the input array - one with elements removed at the beginning, the other with elements removed at the end.


This filter is useful for computing something on all the pairs of two consecutive elements of an array, e.g. creating a list of segments from an ordered list of points.

FoundationLite
SortArray

Changes the order of the input array elements according to an ascending/descending sequence of the value array.

FoundationLite
SplitArray

Divides an array into two parts at the given index.

FoundationLite
SwapArrayElements

Swaps two elements of an array.

FoundationLite
SynchronizeArrays

Selects as many elements from each of the input arrays as possible, while assuring that the difference between corresponding values is not too big.

FoundationLite
TransposeArrayArray

Transposes a matrix represented as an array of arrays.

FoundationLite