tensorflow / tensorflow/java

Shapes.reduceDims is difficult to understand

未关闭
#254 3 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

主要语言
Java
星标
928
派生
227
PR 合并指标
30 天内没有已合并 PR

描述

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.

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

调研方向

从 Shapes.reduceDims 方法开始,阅读其当前的 Javadoc 和实现。将该操作与可用的 TensorFlow 行为进行比较,然后更新文档,使 reshape、axis、operand 以及结果 shape 都易于理解;当读者无需跟踪复杂代码即可弄清 reduceDims 的行为时,即可完成。

由索引模型根据 Issue 内容生成。

评估

技术栈
java
领域
documentation
Issue 类型
文档
难度
3/5
预计耗时
1-2 天
活跃度
停滞
描述清晰度
需要澄清
新手友好度
35/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。