cunumeric.concatenate#

cunumeric.concatenate(inputs: Sequence[ndarray], axis: int | None = 0, out: ndarray | None = None, dtype: npt.DTypeLike | None = None, casting: CastingKind = 'same_kind') ndarray#

concatenate((a1, a2, …), axis=0, out=None, dtype=None, casting=”same_kind”)

Join a sequence of arrays along an existing axis.

Parameters:
  • a1 (Sequence[array_like]) – The arrays must have the same shape, except in the dimension corresponding to axis (the first, by default).

  • a2 (Sequence[array_like]) – The arrays must have the same shape, except in the dimension corresponding to axis (the first, by default).

  • ... (Sequence[array_like]) – The arrays must have the same shape, except in the dimension corresponding to axis (the first, by default).

  • axis (int, optional) – The axis along which the arrays will be joined. If axis is None, arrays are flattened before use. Default is 0.

  • out (ndarray, optional) – If provided, the destination to place the result. The shape must be correct, matching that of what concatenate would have returned if no out argument were specified.

  • dtype (str or data-type) – If provided, the destination array will have this dtype. Cannot be provided together with out.

  • casting ({'no', 'equiv', 'safe', 'same_kind', 'unsafe'}, optional) – Controls what kind of data casting may occur. Defaults to ‘same_kind’.

Returns:

res – The concatenated array.

Return type:

ndarray

Availability:

Multiple GPUs, Multiple CPUs