From 2ad30f189763cc4e7b896bce161b3ba5b3de279d Mon Sep 17 00:00:00 2001 From: p-wysocki Date: Tue, 17 Dec 2024 16:03:02 +0100 Subject: [PATCH 01/12] Add spec Signed-off-by: p-wysocki --- .../arithmetic/segment-max-16.rst | 102 ++++++++++++++++++ 1 file changed, 102 insertions(+) create mode 100644 docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst diff --git a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst new file mode 100644 index 00000000000000..4be0f12c341afd --- /dev/null +++ b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst @@ -0,0 +1,102 @@ +SegmentMax +=================== + + +.. meta:: + :description: Learn about SegmentMax-16 - an arithmetic operation which computes the maximum values along segments of a tensor. + +**Versioned name**: *SegmentMax-16* + +**Category**: *Arithmetic* + +**Short description**: *SegmentMax-16* operation finds the maximum value in each specified segment of the ``input`` tensor. + +**Detailed description** + +For each index in ``segment_ids`` the operator gets values from ``data`` input tensor and calculates the maximum value for each segment. + +For example ``segments_ids`` with value ``[0,0,0,1,1,3,5,5]`` define 4 non empty segments other segments are empty. When coupled with a 1D data tensor ``data``, the segments are as follows: + +* Segment_0: ``[data[0], data[1], data[2]]`` +* Segment_1: ``[data[3], data[4]]`` +* Segment_2: ``[]`` +* Segment_3: ``[data[5]]`` +* Segment_4: ``[]`` +* Segment_5: ``[data[6], data[7]]`` + +When there are no values in a segment, ``output[segment]`` is set to 0. + +In that case, the output would be ``[max(Segment_0), max(Segment_1), 0, max(Segment_3), 0, max(Segment_5)]``. + +**Attributes**: + +SegmentMax-16 has no attributes. + +**Inputs** + +* **1**: *data* + + * **Description**: The numerical data on which SegmentMax operation will be performed. **Required.** + * **Range of values**: An ND tensor of type *T*. + * **Type**: *T* + +* **2**: *segment_ids* + + * **Description**: controls the data is divided into segments. **Required.** + * **Range of values**: 1D tensor of non-negative, sorted integer numbers. Its size is equal to the size of the first dimension of the input tensor. + * **Type**: *T_IDX* + +**Outputs** + +* **1**: The output tensor of type *T* and the same shape as the ``input`` tensor with the exception for the first dimension, which is equal to the count of unique segment IDs. + +**Types** + +* *T*: any supported numerical data type. +* *T_IDX*: ``int64`` or ``int32``. + +**Examples** + +*Example 1: 1D input data* + +.. code-block:: xml + :force: + + + + + 8 + + + 8 + + + + + 4 + + + + +*Example 2: 2D input data* + +.. code-block:: xml + :force: + + + + + 3 + 4 + + + 3 + + + + + 2 + 4 + + + From fd26731576a4e8b46ffd08c67102ba9fb57bff0d Mon Sep 17 00:00:00 2001 From: p-wysocki Date: Tue, 17 Dec 2024 16:06:07 +0100 Subject: [PATCH 02/12] Minor changes Signed-off-by: p-wysocki --- .../operation-specs/arithmetic/segment-max-16.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst index 4be0f12c341afd..60db39c9d287ac 100644 --- a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst +++ b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst @@ -15,7 +15,7 @@ SegmentMax For each index in ``segment_ids`` the operator gets values from ``data`` input tensor and calculates the maximum value for each segment. -For example ``segments_ids`` with value ``[0,0,0,1,1,3,5,5]`` define 4 non empty segments other segments are empty. When coupled with a 1D data tensor ``data``, the segments are as follows: +For example ``segments_ids`` with value ``[0,0,0,1,1,3,5,5]`` defines 4 non-empty segments. The other segments are empty. When coupled with a 1D data tensor ``data``, the segments are as follows: * Segment_0: ``[data[0], data[1], data[2]]`` * Segment_1: ``[data[3], data[4]]`` From 5dea3279edefc1527f9935fa55ef36a921212e02 Mon Sep 17 00:00:00 2001 From: p-wysocki Date: Wed, 18 Dec 2024 13:36:41 +0100 Subject: [PATCH 03/12] Typos Signed-off-by: p-wysocki --- .../operation-specs/arithmetic/segment-max-16.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst index 60db39c9d287ac..1d75ae6de6d73d 100644 --- a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst +++ b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst @@ -42,7 +42,7 @@ SegmentMax-16 has no attributes. * **2**: *segment_ids* - * **Description**: controls the data is divided into segments. **Required.** + * **Description**: Controls how the data is divided into segments. **Required.** * **Range of values**: 1D tensor of non-negative, sorted integer numbers. Its size is equal to the size of the first dimension of the input tensor. * **Type**: *T_IDX* From a5b4c0190d0f822ce7bed72d98904712d9b014a8 Mon Sep 17 00:00:00 2001 From: Przemyslaw Wysocki Date: Wed, 22 Jan 2025 16:08:21 +0100 Subject: [PATCH 04/12] Update docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst Co-authored-by: Katarzyna Mitrus --- .../operation-specs/arithmetic/segment-max-16.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst index 1d75ae6de6d73d..c09ad415313c5f 100644 --- a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst +++ b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst @@ -48,7 +48,7 @@ SegmentMax-16 has no attributes. **Outputs** -* **1**: The output tensor of type *T* and the same shape as the ``input`` tensor with the exception for the first dimension, which is equal to the count of unique segment IDs. +* **1**: The output tensor of type *T* and almost the same shape as the ``data`` input tensor with the exception for the first dimension, which is equal to the count of unique segment IDs (calculated as ``max(segment_ids) + 1``). **Types** From ceb3d153b19235d7f5807b7bfa0aecfc8c79bfa8 Mon Sep 17 00:00:00 2001 From: p-wysocki Date: Thu, 23 Jan 2025 11:48:34 +0100 Subject: [PATCH 05/12] Apply CR Signed-off-by: p-wysocki --- .../arithmetic/segment-max-16.rst | 32 ++++++++++--------- 1 file changed, 17 insertions(+), 15 deletions(-) diff --git a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst index c09ad415313c5f..e29dcf73d7e23a 100644 --- a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst +++ b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst @@ -1,5 +1,5 @@ SegmentMax -=================== +========== .. meta:: @@ -24,32 +24,29 @@ For example ``segments_ids`` with value ``[0,0,0,1,1,3,5,5]`` defines 4 non-empt * Segment_4: ``[]`` * Segment_5: ``[data[6], data[7]]`` -When there are no values in a segment, ``output[segment]`` is set to 0. +When there are no values in a segment, ``output[segment]`` is defined by ``empty_segment_value`` input. In that case, the output would be ``[max(Segment_0), max(Segment_1), 0, max(Segment_3), 0, max(Segment_5)]``. **Attributes**: -SegmentMax-16 has no attributes. +* **1**: *empty_segment_value* -**Inputs** + * **Description**: The value assigned to segments which are empty. **Required.** + * **Range of values**: A scalar. + * **Type**: *T* -* **1**: *data* +**Inputs** - * **Description**: The numerical data on which SegmentMax operation will be performed. **Required.** - * **Range of values**: An ND tensor of type *T*. - * **Type**: *T* +* **1**: ``data`` - ND tensor of type *T*, the numerical data on which SegmentMax operation will be performed. **Required.** -* **2**: *segment_ids* +* **2**: ``segment_ids`` - 1D Tensor of sorted non-negative numbers of type *T_IDX*. Its size is equal to the size of the first dimension of the ``data`` input tensor. The values must be smaller than ``num_segments``. **Required.** - * **Description**: Controls how the data is divided into segments. **Required.** - * **Range of values**: 1D tensor of non-negative, sorted integer numbers. Its size is equal to the size of the first dimension of the input tensor. - * **Type**: *T_IDX* +* **4**: ``num_segments`` - A scalar value of type *T_IDX* representing the segments count, used for shape inference. **Optional.** **Outputs** -* **1**: The output tensor of type *T* and almost the same shape as the ``data`` input tensor with the exception for the first dimension, which is equal to the count of unique segment IDs (calculated as ``max(segment_ids) + 1``). - +* **1**: The output tensor has same rank and dimensions as the ``data`` input tensor except for the first dimension which is calculated as ``max(segment_ids) + 1`` **Types** * *T*: any supported numerical data type. @@ -63,6 +60,7 @@ SegmentMax-16 has no attributes. :force: + 8 @@ -70,9 +68,12 @@ SegmentMax-16 has no attributes. 8 + + 0 + - + 4 @@ -84,6 +85,7 @@ SegmentMax-16 has no attributes. :force: + 3 From a7431941f90ceb2d1a6289c0834b900699881c02 Mon Sep 17 00:00:00 2001 From: Przemyslaw Wysocki Date: Thu, 23 Jan 2025 13:05:18 +0100 Subject: [PATCH 06/12] Update docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst --- .../operation-specs/arithmetic/segment-max-16.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst index e29dcf73d7e23a..15553bc9d0c413 100644 --- a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst +++ b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst @@ -26,7 +26,7 @@ For example ``segments_ids`` with value ``[0,0,0,1,1,3,5,5]`` defines 4 non-empt When there are no values in a segment, ``output[segment]`` is defined by ``empty_segment_value`` input. -In that case, the output would be ``[max(Segment_0), max(Segment_1), 0, max(Segment_3), 0, max(Segment_5)]``. +For ``empty_segment_value`` equal to 0, the operator output would be ``[max(Segment_0), max(Segment_1), 0, max(Segment_3), 0, max(Segment_5)]``. **Attributes**: From 5b4cd5d68aad5c55e5b0d3b26d3cdee96424746e Mon Sep 17 00:00:00 2001 From: Przemyslaw Wysocki Date: Thu, 23 Jan 2025 13:07:48 +0100 Subject: [PATCH 07/12] Update docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst --- .../operation-specs/arithmetic/segment-max-16.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst index 15553bc9d0c413..a34def33e0cbb5 100644 --- a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst +++ b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst @@ -42,7 +42,7 @@ For ``empty_segment_value`` equal to 0, the operator output would be ``[max(Segm * **2**: ``segment_ids`` - 1D Tensor of sorted non-negative numbers of type *T_IDX*. Its size is equal to the size of the first dimension of the ``data`` input tensor. The values must be smaller than ``num_segments``. **Required.** -* **4**: ``num_segments`` - A scalar value of type *T_IDX* representing the segments count, used for shape inference. **Optional.** +* **3**: ``num_segments`` - A scalar value of type *T_IDX* representing the segments count, used for shape inference. **Optional.** **Outputs** From be85e94ce7209abdd7a23586b3ecb1fbe2341242 Mon Sep 17 00:00:00 2001 From: Przemyslaw Wysocki Date: Wed, 29 Jan 2025 08:08:54 +0100 Subject: [PATCH 08/12] Update docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst Co-authored-by: Roman Kazantsev --- .../operation-specs/arithmetic/segment-max-16.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst index a34def33e0cbb5..cb4c64e8bf47be 100644 --- a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst +++ b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst @@ -40,9 +40,9 @@ For ``empty_segment_value`` equal to 0, the operator output would be ``[max(Segm * **1**: ``data`` - ND tensor of type *T*, the numerical data on which SegmentMax operation will be performed. **Required.** -* **2**: ``segment_ids`` - 1D Tensor of sorted non-negative numbers of type *T_IDX*. Its size is equal to the size of the first dimension of the ``data`` input tensor. The values must be smaller than ``num_segments``. **Required.** +* **2**: ``segment_ids`` - 1D Tensor of sorted non-negative numbers of type *T_IDX1*. Its size is equal to the size of the first dimension of the ``data`` input tensor. The values must be smaller than ``num_segments``. **Required.** -* **3**: ``num_segments`` - A scalar value of type *T_IDX* representing the segments count, used for shape inference. **Optional.** +* **3**: ``num_segments`` - A scalar value of type *T_IDX2* representing the segments count, used for shape inference. **Optional.** **Outputs** From f6bcb9593c1cf786ee3972fe80010e3002c39bdc Mon Sep 17 00:00:00 2001 From: Przemyslaw Wysocki Date: Wed, 29 Jan 2025 08:09:02 +0100 Subject: [PATCH 09/12] Update docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst Co-authored-by: Roman Kazantsev --- .../operation-specs/arithmetic/segment-max-16.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst index cb4c64e8bf47be..b11a78a5792226 100644 --- a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst +++ b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst @@ -50,7 +50,7 @@ For ``empty_segment_value`` equal to 0, the operator output would be ``[max(Segm **Types** * *T*: any supported numerical data type. -* *T_IDX*: ``int64`` or ``int32``. +* *T_IDX1*, *T_IDX2*: ``int64`` or ``int32``. **Examples** From 2142a199928f6d8f0201972a2db208889359fb44 Mon Sep 17 00:00:00 2001 From: p-wysocki Date: Wed, 29 Jan 2025 08:49:47 +0100 Subject: [PATCH 10/12] Apply CR Signed-off-by: p-wysocki --- .../arithmetic/segment-max-16.rst | 26 +++++++++++-------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst index b11a78a5792226..e9ee64b423017a 100644 --- a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst +++ b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst @@ -15,7 +15,7 @@ SegmentMax For each index in ``segment_ids`` the operator gets values from ``data`` input tensor and calculates the maximum value for each segment. -For example ``segments_ids`` with value ``[0,0,0,1,1,3,5,5]`` defines 4 non-empty segments. The other segments are empty. When coupled with a 1D data tensor ``data``, the segments are as follows: +For example ``segments_ids`` with value ``[0,0,0,1,1,3,5,5]`` defines 4 non-empty segments. When coupled with a 1D data tensor ``data``, the segments are as follows: * Segment_0: ``[data[0], data[1], data[2]]`` * Segment_1: ``[data[3], data[4]]`` @@ -24,17 +24,20 @@ For example ``segments_ids`` with value ``[0,0,0,1,1,3,5,5]`` defines 4 non-empt * Segment_4: ``[]`` * Segment_5: ``[data[6], data[7]]`` -When there are no values in a segment, ``output[segment]`` is defined by ``empty_segment_value`` input. +When there are no values in a segment, ``output[segment]`` is defined by ``fill_mode`` attribute. -For ``empty_segment_value`` equal to 0, the operator output would be ``[max(Segment_0), max(Segment_1), 0, max(Segment_3), 0, max(Segment_5)]``. +For ``fill_mode`` equal to ``ZERO`` , the operation output would be ``[max(Segment_0), max(Segment_1), 0, max(Segment_3), 0, max(Segment_5)]``. **Attributes**: * **1**: *empty_segment_value* * **Description**: The value assigned to segments which are empty. **Required.** - * **Range of values**: A scalar. - * **Type**: *T* + * **Range of values**: Name of the mode in string format: + + * ``ZERO`` - the empty segments are filled with zeros. + * ``LOWEST`` - the empty segments are filled with the lowest value of the data type *T*. + * **Type**: ``string`` **Inputs** @@ -47,6 +50,7 @@ For ``empty_segment_value`` equal to 0, the operator output would be ``[max(Segm **Outputs** * **1**: The output tensor has same rank and dimensions as the ``data`` input tensor except for the first dimension which is calculated as ``max(segment_ids) + 1`` + **Types** * *T*: any supported numerical data type. @@ -60,15 +64,15 @@ For ``empty_segment_value`` equal to 0, the operator output would be ``[max(Segm :force: - + 8 - - 8 + + 5 - + 0 @@ -85,13 +89,13 @@ For ``empty_segment_value`` equal to 0, the operator output would be ``[max(Segm :force: - + 3 4 - + 3 From 242a7158ec9625c6430f47606d0e57bbc840dfe2 Mon Sep 17 00:00:00 2001 From: p-wysocki Date: Wed, 29 Jan 2025 09:20:43 +0100 Subject: [PATCH 11/12] CR Signed-off-by: p-wysocki --- .../operation-specs/arithmetic/segment-max-16.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst index e9ee64b423017a..19fae06b6ad776 100644 --- a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst +++ b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst @@ -45,11 +45,11 @@ For ``fill_mode`` equal to ``ZERO`` , the operation output would be ``[max(Segme * **2**: ``segment_ids`` - 1D Tensor of sorted non-negative numbers of type *T_IDX1*. Its size is equal to the size of the first dimension of the ``data`` input tensor. The values must be smaller than ``num_segments``. **Required.** -* **3**: ``num_segments`` - A scalar value of type *T_IDX2* representing the segments count, used for shape inference. **Optional.** +* **3**: ``num_segments`` - A scalar value of type *T_IDX2* representing the segments count, used for shape inference. Defaults to ``max(segment_ids) + 1``. If ``num_segments < max(segment_ids) + 1`` then the extra segments defined in ``segment_ids`` are not included in the output. **Optional.** **Outputs** -* **1**: The output tensor has same rank and dimensions as the ``data`` input tensor except for the first dimension which is calculated as ``max(segment_ids) + 1`` +* **1**: The output tensor has same rank and dimensions as the ``data`` input tensor except for the first dimension which is equal to the value of ``num_segments``. **Types** @@ -72,13 +72,13 @@ For ``fill_mode`` equal to ``ZERO`` , the operation output would be ``[max(Segme 5 - + 0 - 4 + 8 From cdb78cbec0c5ee94e3bf862e865b3b2c2c10d8ad Mon Sep 17 00:00:00 2001 From: Przemyslaw Wysocki Date: Fri, 31 Jan 2025 12:23:50 +0100 Subject: [PATCH 12/12] Update docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst Co-authored-by: Katarzyna Mitrus --- .../operation-specs/arithmetic/segment-max-16.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst index 19fae06b6ad776..69222d47eaba08 100644 --- a/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst +++ b/docs/articles_en/documentation/openvino-ir-format/operation-sets/operation-specs/arithmetic/segment-max-16.rst @@ -30,7 +30,7 @@ For ``fill_mode`` equal to ``ZERO`` , the operation output would be ``[max(Segme **Attributes**: -* **1**: *empty_segment_value* +* **1**: *fill_mode* * **Description**: The value assigned to segments which are empty. **Required.** * **Range of values**: Name of the mode in string format: