Shapes.reduceDims is difficult to understand

I find the documentation opaque:

  /**
   * Reshapes the operand by reducing the shape to the specified axis.
   *
   * @param <T> the type of Operand
   * @param scope current scope
   * @param operand the operand
   * @param axis the axis
   * @return the reshaped operand
   */
  @Endpoint(name = "reduceDims")
  public static <T extends TType> Operand<T> reduceDims(
      Scope scope, Operand<T> operand, Operand<TInt32> axis) {

I had no success searching for a similar function in Python TensorFlow. So I read the code, but it is fairly complex to follow.

Commencez par la méthode Shapes.reduceDims et lisez sa Javadoc et son implémentation actuelles. Comparez l’opération avec le comportement disponible de TensorFlow, puis mettez à jour la documentation afin que reshape, axis, operand et la shape résultante soient compréhensibles ; c’est terminé lorsqu’un lecteur peut comprendre le comportement de reduceDims sans suivre du code complexe.