Shape

Rozmiar nieznanej osi lub całkowity nieznany rozmiar nieznanego kształtu.

Zwraca nowy Shape z dodanym nowym ostatnim wymiarem. Aby to wywołanie zakończyło się sukcesem, isUnknown() musi mieć false .

Zwraca nowy kształt z dołączonymi wymiarami innego kształtu. Zarówno w przypadku tego kształtu, jak i drugiego kształtu funkcja isUnknown() musi zwracać wartość false. Np. @kod Kształt.of(3,4).append(Kształt.of(1,2)) => Kształt.of(3,4,1,2) }

Zwraca kopię obronną osi tego kształtu. Zmiany w zwróconej tablicy, aby nie zmieniać stanu tego kształtu. Zwraca wartość null, jeśli isUnknown() ma wartość true.

Równa się implementacji dla kształtów. Dwa Kształty są uważane za równe, jeśli:

• liczba wymiarów jest zdefiniowana i równa dla obu
• wielkość każdego wymiaru jest zdefiniowana i równa dla obu

Jeśli którykolwiek z kształtów ma nieznane wymiary (nawet jeśli są takie same w obu przypadkach) lub jeśli którykolwiek kształt ma nieznaną liczbę wymiarów (nawet jeśli oba zwrócą true dla funkcji isUnknown() ), nie są one uważane za równe! Jednak kształt zawsze będzie sobie równy, nawet jeśli jest nieznany lub zawiera nieznane wymiary.

Zwraca informację, czy jeden lub więcej wymiarów tego Shape ma nieznany rozmiar.

Zwraca jednowymiarowy Shape, w którym pierwszy wymiar odpowiada pierwszemu wymiarowi tego Shape.

Sprawdź, czy dwa wymiary kształtu są zgodne.

Wymiary są zgodne, jeśli którykolwiek z wymiarów to Shape.UNKNOWN_SIZE lub oba wymiary są równe

Określa, czy inny kształt jest zgodny z tym.

Dwa potencjalnie częściowo zdefiniowane kształty są kompatybilne, jeśli istnieje w pełni zdefiniowany kształt, który oba kształty mogą reprezentować. Zatem zgodność umożliwia kodowi wnioskowania o kształcie wnioskowanie o częściowo zdefiniowanych kształtach. Na przykład:

• Shape.unknown() jest kompatybilna ze wszystkimi kształtami.
• Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) jest kompatybilny ze wszystkimi kształtami dwuwymiarowymi, takimi jak Shape(32, 784) , a także Shape.unknown() . Nie jest kompatybilny na przykład z Shape(UNKNOWN_SIZE) lub Shape(UNKNOWN_SIZE, UNKNOWN_SIZE, UNKNOWN_SIZE) .
• Shape(32, UNKNOWN_SIZE) jest kompatybilny ze wszystkimi dwuwymiarowymi kształtami o rozmiarze 32 w wymiarze 0, a także Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) i Shape.unknown() . Nie jest kompatybilny na przykład z Shape(32) , Shape(32, UNKNOWN_SIZE, 1) lub Shape(64, UNKNOWN_SIZE) .
• Shape(32, 784) jest kompatybilny sam ze sobą, a także Shape(32, UNKNOWN_SIZE) , Shape(UNKNOWN_SIZE, 784) , Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) i Shape.unknown() . Nie jest kompatybilny na przykład z Shape(32, 1, 784) lub Shape(UNKNOWN_SIZE) .

Relacja zgodności jest zwrotna i symetryczna, ale nie przechodnia. Na przykład Shape(32, 784) jest zgodna z Shape.unknown() , a Shape.unknown() jest zgodna z Shape(4, 4) , ale Shape(32, 784) nie jest zgodna z Shape(4, 4) .

Kompatybilność to nie to samo, co nadawanie. Kompatybilne kształty muszą mieć tę samą liczbę wymiarów i dla każdej pary wymiarów jeden wymiar musi być równy pozostałym wymiarom lub co najmniej jeden z wymiarów w parze musi mieć wartość UNKNOWN_SIZE.

Rozgłaszanie umożliwia różne wymiary, ale wymiary w parach muszą być równe lub jeden wymiar musi wynosić 1. Jeśli jeden kształt ma mniejsze wymiary niż inny, mniejszy kształt jest „rozciągany” i ma wymiary 1.

Zwraca czy ten Shape jest kształtem macierzy

Zwraca czy ten Shape reprezentuje skalar.

Zwraca informację, czy liczba wymiarów tego Shape jest nieznana.

Zwraca, czy ten Shape jest kształtem wektora.

Zwraca liczbę wymiarów tego Shape. -1 jeśli nieznane, 0 dla skalara, 1 dla wektora, 2 dla macierzy itd.

Utwórz kształt reprezentujący wartość skalarną lub N-wymiarową.

Tworzy Shape reprezentujący wartość skalarną lub N-wymiarową (N wynosi co najmniej 1) z podanym rozmiarem dla każdego wymiaru. Wartość -1 wskazuje, że rozmiar odpowiedniego wymiaru jest nieznany. Jeśli nie podano żadnych rozmiarów, tworzony jest Shape reprezentujący skalar. Na przykład:

// A 2-element vector.
 Shape vector = Shape.of(2);

 // A 2x3 matrix.
 Shape matrix = Shape.of(2, 3);

 // A matrix with 4 columns but an unknown number of rows.
 // This is typically used to indicate the shape of tensors that represent
 // a variable-sized batch of values. The Shape below might represent a
 // variable-sized batch of 4-element vectors.
 Shape batch = Shape.of(-1, 4);

 // A scalar. For readability, you should prefer calling Shape.scalar()
 Shape scalar = Shape.of()
 

Zwraca nowy Shape z dołączonymi wymiarami innego Shape. Zarówno w przypadku tego kształtu, jak i drugiego kształtu funkcja isUnknown() musi zwracać wartość false. Np. Shape.of(3,4).prepend(Shape.of(1,2)) => Shape.of(1,2,3,4)

Zwraca nowy Shape z dodanym nowym pierwszym wymiarem. Aby to wywołanie zakończyło się sukcesem, isUnknown() musi mieć false .

Tworzy Shape reprezentujący wartość skalarną.

Rozmiar wymiaru o podanym indeksie.

Jeśli isUnknown() ma wartość true lub rozmiar wymiaru o podanym indeksie ma nieznany rozmiar, zwracana jest UNKNOWN_SIZE .

Zwraca całkowitą liczbę elementów, jakie miałby Tensor z tym kształtem.

Jeśli isUnknown() ma wartość true lub hasUnknownDimension() ma wartość true, zwracana jest UNKNOWN_SIZE .

Zwróć kształt wymiarowy end - begin o wymiarach pasujących do tego kształtu od begin do end .

Zwraca nowy Shape z usuniętym pierwszym wymiarem tego Shape.

Zwraca n-wymiarowy Shape o wymiarach odpowiadających pierwszym n wymiarom tego kształtu

Zwraca n-wymiarowy Shape o wymiarach pasujących do ostatnich n wymiarów tego Shape.

Zwięzły opis kształtu przeznaczonego do debugowania.

Tworzy Shape reprezentujący nieznaną liczbę wymiarów.