oph_get_subarray3

Description

Behaviour

It extracts a subset of a measure array. If size-i params are defined, then the array is considered multidimensional with i implicit dimensions, each of size-i. The subset can also be applied on multiple dimensions.

Parameters

  • input measure type: Ophidia typing. Supported types are: ‘oph_double’; ‘oph_float’; ‘oph_long’; ‘oph_int’; ‘oph_short’; ‘oph_byte’.
  • output measure type: Ophidia typing. Supported types are: ‘oph_double’; ‘oph_float’; ‘oph_long’; ‘oph_int’; ‘oph_short’; ‘oph_byte’.
  • measure: input measure.
  • subset: enumeration of comma-separated elementary filters (1 series of filters for each dimension). Possible filter forms:
    • start_index: select a single value, specified by its index.
    • start_index:stop_index: select elements from start_index to stop_index.
    • start_index:stride:stop_index: select elements from start_index to stop_index with a step of stride. Indexes are integers from 1 to the dimension size and it can be used “end” to specify the index of the last element.
  • block size: product of slowly changing dimensions.
  • size: size of the dimension on which subsetting is done.

Return type

Binary-array.

Examples

Extract elements 1 and 2 with block size 360 and size 100.

oph_get_subarray3('OPH_DOUBLE','OPH_DOUBLE',measure,'1,2',360,100)

Operation type

Simple.

Arguments

Argument name Type Mandatory Values Default Min/Max-value Min/Max-times
input measure type “oph_type” “yes” “‘oph_double’|’oph_float’ |’oph_int’|’oph_long’|’oph_short’|’oph_byte’”     “1” / “1”
output measure type “oph_type” “yes” “‘oph_double’|’oph_float’ |’oph_int’|’oph_long’|’oph_short’|’oph_byte’”     “1” / “1”
measure “binary-array” “yes”       “1” / “1”
subset “string” “no”   “1:end”   “0” /
block size “long-long” “no”   “1”   “0” /
size “long-long” “no”   “0”   “0” /