Shape

La taille d'un axe inconnu ou la taille totale inconnue pour une forme inconnue.

Renvoie une nouvelle forme, avec une nouvelle dernière dimension ajoutée. Pour que cet appel réussisse, isUnknown() doit être false .

Renvoie une nouvelle forme, avec les dimensions d'une autre forme ajoutées. Pour cette forme et l’autre forme, isUnknown() doit renvoyer false. Par exemple, @code Shape.of(3,4).append(Shape.of(1,2)) => Shape.of(3,4,1,2) }

Renvoie une copie défensive des axes de cette forme. Modifications du tableau renvoyé pour ne pas modifier l'état de cette forme. Renvoie null si isUnknown() est vrai.

Égal à l’implémentation pour les formes. Deux formes sont considérées comme égales si ssi :

• le nombre de dimensions est défini et égal pour les deux
• la taille de chaque dimension est définie et égale pour les deux

Si l'une ou l'autre forme a des dimensions inconnues (même si elles sont identiques dans les deux) ou si l'une ou l'autre forme a un nombre inconnu de dimensions (même si les deux renvoient true pour isUnknown() ), elles ne sont pas considérées comme égales ! Cependant, une forme sera toujours égale à elle-même, même si elle est inconnue ou si elle contient des dimensions inconnues.

Indique si une ou plusieurs dimensions de cette forme ont une taille inconnue.

Renvoie une forme unidimensionnelle dont la première dimension correspond à la première dimension de cette forme.

Testez pour voir si deux dimensions de forme sont compatibles.

Les dimensions sont compatibles si l'une des dimensions est Shape.UNKNOWN_SIZE ou si les deux dimensions sont égales.

Détermine si une autre forme est compatible avec celle-ci.

Deux formes éventuellement partiellement définies sont compatibles s'il existe une forme entièrement définie que les deux formes peuvent représenter. Ainsi, la compatibilité permet au code d’inférence de forme de raisonner sur des formes partiellement définies. Par exemple:

• Shape.unknown() est compatible avec toutes les formes.
• Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) est compatible avec toutes les formes bidimensionnelles, telles que Shape(32, 784) , ainsi que Shape.unknown() . Il n'est pas compatible avec, par exemple, Shape(UNKNOWN_SIZE) ou Shape(UNKNOWN_SIZE, UNKNOWN_SIZE, UNKNOWN_SIZE) .
• Shape(32, UNKNOWN_SIZE) est compatible avec toutes les formes bidimensionnelles de taille 32 dans la 0ème dimension, ainsi que Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) et Shape.unknown() . Il n'est pas compatible avec, par exemple, Shape(32) , Shape(32, UNKNOWN_SIZE, 1) ou Shape(64, UNKNOWN_SIZE) .
• Shape(32, 784) est compatible avec lui-même, ainsi que Shape(32, UNKNOWN_SIZE) , Shape(UNKNOWN_SIZE, 784) , Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) et Shape.unknown() . Il n'est pas compatible avec, par exemple, Shape(32, 1, 784) ou Shape(UNKNOWN_SIZE) .

La relation de compatibilité est réflexive et symétrique, mais pas transitive. Par exemple, Shape(32, 784) est compatible avec Shape.unknown() et Shape.unknown() est compatible avec Shape(4, 4) , mais Shape(32, 784) n'est pas compatible avec Shape(4, 4) .

La compatibilité n'est pas la même chose que la diffusion. Les formes compatibles doivent avoir le même nombre de dimensions et pour chaque paire de dimensions, une dimension doit être égale aux autres dimensions ou au moins une des dimensions de la paire doit être UNKNOWN_SIZE.

La diffusion autorise différentes dimensions, mais les dimensions appariées doivent être égales ou une dimension doit être égale à 1. Si une forme a moins de dimensions qu'une autre forme, la forme la plus petite est « étirée » avec des dimensions de 1.

Indique si cette forme est la forme d'une matrice

Indique si cette forme représente un scalaire.

Indique si le nombre de dimensions de cette forme est inconnu.

Indique si cette forme est la forme d'un vecteur.

Renvoie le nombre de dimensions de cette forme. -1 si inconnu, 0 pour un scalaire, 1 pour un vecteur, 2 pour une matrice etc.

Créez une forme représentant une valeur scalaire ou à N dimensions.

Crée une forme représentant une valeur scalaire ou à N dimensions (N étant au moins 1), avec la taille fournie pour chaque dimension. A -1 indique que la taille de la dimension correspondante est inconnue. Si aucune taille n'est fournie, une forme représentant un scalaire est créée. Par exemple :

// 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()
 

Renvoie une nouvelle forme, avec les dimensions d'une autre forme ajoutées au début. Pour cette forme et l’autre forme, isUnknown() doit renvoyer false. Par exemple Shape.of(3,4).prepend(Shape.of(1,2)) => Shape.of(1,2,3,4)

Renvoie une nouvelle forme, avec une nouvelle première dimension ajoutée. Pour que cet appel réussisse, isUnknown() doit être false .

Crée une forme représentant une valeur scalaire.

La taille de la dimension avec l'index donné.

Si isUnknown() est vrai ou si la taille de la dimension avec l'index donné a une taille inconnue, UNKNOWN_SIZE est renvoyé.

Renvoie le nombre total d'éléments qu'un Tensor avec cette forme aurait.

Si isUnknown() est vrai ou hasUnknownDimension() est vrai, UNKNOWN_SIZE est renvoyé.

Renvoie une forme dimensionnelle end - begin dont les dimensions correspondent à cette forme du begin à end .

Renvoie une nouvelle forme, dont la première dimension est supprimée.

Renvoie une forme à n dimensions dont les dimensions correspondent aux n premières dimensions de cette forme

Renvoie une forme à n dimensions dont les dimensions correspondent aux n dernières dimensions de cette forme.

Description succincte de la forme destinée au débogage.

Crée une forme représentant un nombre inconnu de dimensions.