분산형

공개 최종 클래스 ScatterNd

'인덱스'에 따라 '업데이트'를 새 텐서로 분산시킵니다.

인덱스에 따라 주어진 '모양'의 텐서(처음에는 숫자의 경우 0, 문자열의 경우 비어 있음) 내의 개별 값이나 조각에 희소한 '업데이트'를 적용하여 새 텐서를 생성합니다. 이 연산자는 주어진 텐서에서 값이나 조각을 추출하는 `tf.gather_nd` 연산자의 반대입니다.

이 작업은 텐서가 0으로 초기화된다는 점을 제외하면 tensor_scatter_add와 유사합니다. `tf.scatter_nd(indices,values,shape)`를 호출하는 것은`tensor_scatter_add(tf.zeros(shape,values.dtype),indices,value)`와 동일합니다.

'인덱스'에 중복 항목이 포함된 경우 해당 업데이트가 누적됩니다(합계).

경고 : 업데이트가 적용되는 순서는 비결정적이므로 `indices`에 중복 항목이 포함된 경우 출력은 비결정적입니다. 일부 수치 근사 문제로 인해 숫자를 다른 순서로 합산하면 다른 결과가 나올 수 있습니다.

`indices`는 `shape` 형태의 새로운 텐서에 대한 인덱스를 포함하는 정수 텐서입니다. `indices`의 마지막 차원은 기껏해야 `shape`의 순위일 수 있습니다.

indices.shape[-1] <= 모양.순위

`indices`의 마지막 차원은 `indices.shape[-1] = shape.rank`인 경우 요소 또는 `indices.shape[-1] < Shape.rank`인 경우 차원 `indices'에 따른 조각의 인덱스에 해당합니다. .shape[-1]` '모양'. 'updates'는 모양이 있는 텐서입니다.

indices.shape[:-1] + 모양[indices.shape[-1]:]

분산의 가장 간단한 형태는 인덱스를 기준으로 텐서에 개별 요소를 삽입하는 것입니다. 예를 들어, 8개의 요소가 있는 랭크 1 텐서에 4개의 분산된 요소를 삽입한다고 가정해 보겠습니다.

Python에서 이 분산 연산은 다음과 같습니다:

indices = tf.constant([[4], [3], [1], [7]])
     updates = tf.constant([9, 10, 11, 12])
     shape = tf.constant([8])
     scatter = tf.scatter_nd(indices, updates, shape)
     print(scatter)
 
결과 텐서는 다음과 같습니다.

[0, 11, 0, 10, 9, 0, 0, 12]

또한, 더 높은 순위의 텐서 전체 조각을 한 번에 삽입할 수도 있습니다. 예를 들어, 새 값의 행렬 두 개가 있는 랭크 3 텐서의 첫 번째 차원에 두 개의 슬라이스를 삽입하려는 경우입니다.

Python에서 이 분산 연산은 다음과 같습니다:

indices = tf.constant([[0], [2]])
     updates = tf.constant([[[5, 5, 5, 5], [6, 6, 6, 6],
                             [7, 7, 7, 7], [8, 8, 8, 8]],
                            [[5, 5, 5, 5], [6, 6, 6, 6],
                             [7, 7, 7, 7], [8, 8, 8, 8]]])
     shape = tf.constant([4, 4, 4])
     scatter = tf.scatter_nd(indices, updates, shape)
     print(scatter)
 
결과 텐서는 다음과 같습니다.

[[[5, 5, 5, 5], [6, 6, 6, 6], [7, 7, 7, 7], [8, 8, 8, 8]], [[0, 0, 0 , 0], [0, 0, 0, 0], [0, 0, 0, 0], [0, 0, 0, 0]], [[5, 5, 5, 5], [6, 6 , 6, 6], [7, 7, 7, 7], [8, 8, 8, 8]], [[0, 0, 0, 0], [0, 0, 0, 0], [0 , 0, 0, 0], [0, 0, 0, 0]]]

CPU에서 범위를 벗어난 인덱스가 발견되면 오류가 반환됩니다. GPU에서는 범위를 벗어난 인덱스가 발견되면 해당 인덱스가 무시됩니다.

공개 방법

출력 <U>
출력 ()
텐서의 기호 핸들을 반환합니다.
static <U, T 확장 숫자> ScatterNd <U>
생성 ( 범위 범위, 피연산자 <T> 인덱스, 피연산자 <U> 업데이트, 피연산자 <T> 모양)
새로운 ScatterNd 작업을 래핑하는 클래스를 생성하는 팩토리 메서드입니다.
출력 <U>
출력 ()
주어진 모양과 인덱스에 따라 업데이트가 적용된 새로운 텐서.

상속된 메서드

공개 방법

공개 출력 <U> asOutput ()

텐서의 기호 핸들을 반환합니다.

TensorFlow 작업에 대한 입력은 다른 TensorFlow 작업의 출력입니다. 이 메서드는 입력 계산을 나타내는 기호 핸들을 얻는 데 사용됩니다.

public static ScatterNd <U> create ( 범위 범위 , 피연산자 <T> 인덱스, 피연산자 <U> 업데이트, 피연산자 <T> 모양)

새로운 ScatterNd 작업을 래핑하는 클래스를 생성하는 팩토리 메서드입니다.

매개변수
범위 현재 범위
지수 인덱스 텐서.
업데이트 출력에 분산되도록 업데이트합니다.
모양 1-D. 결과 텐서의 모양입니다.
보고
  • ScatterNd의 새 인스턴스

공개 출력 <U> 출력 ()

주어진 모양과 인덱스에 따라 업데이트가 적용된 새로운 텐서.