JA: add ja/r2/guide/eager.ipynb by chie8842 · Pull Request #752 · tensorflow/docs

chie8842 · 2019-07-05T11:34:37Z

No description provided.

tfdocsbot · 2019-07-05T11:34:42Z

Preview and run these notebook edits with Google Colab:

site/ja/beta/guide/eager.ipynb

Notebook diffs available on ReviewNB.com.

tfdocsbot · 2019-07-05T11:34:43Z

Reviewers added, please take a look.
@ohtaman, @sfujiwara, @masa-ita

When your review is finished, approve the pull request or include "LGTM" in your comment.

lamberta

Thanks.
Please move this into the site/ja/beta/guide directory.
Also, update the buttons to match

Applied

lamberta · 2019-07-10T22:42:50Z

Added commits to update path and fix notebook. Switched to GPU to train faster (#780)

Will keep this pull request open to allow time for translation reviews.

sfujiwara

@chie8842 Sorry for late review and thank you for your translation!
Your translation is almost perfect, but I found some typo and have suggestions.
Check my comments!

sfujiwara · 2019-07-26T16:33:18Z

+      "source": [
+        "\n",
+        "\n",
+        "Tensorflow の Eager Execution は、計算グラフの作成と評価を同時におこなう命令的なプログラミングを行うための環境です：\n",


==> TensorFlow

sfujiwara · 2019-07-26T16:34:27Z

+        "* *より簡単なデバッグ*— ops を直接呼び出すことで、実行中のモデルを調査したり、変更をテストすることができます。 Python 標準のデバッグツールを用いて即座にエラーのレポーティングができます。\n",
+        "* *自然な制御フロー*— TensorFlow のグラフ制御フローの代わりに Python の制御フローを利用するため、動的なモデルのパラメータ変更をシンプルに行うことができます。\n",
+        "  \n",
+        "Eager Execution は Tensorflow のほとんどのオペレーションとGPUアクセラレーションをサポートします。\n",


==> TensorFlow

sfujiwara · 2019-07-26T16:50:49Z

+        "\n",
+        "Eager Execution は研究や実験のための柔軟な機械学習環境として、以下を提供します。\n",
+        "\n",
+        "* *直感的なインタフェース*— Python のデータ構造を使用して、コードをナチュラルに記述することができます。スモールなモデルとデータに対してすばやく実験を繰り返すことができます。\n",


[weak suggestion]

ナチュラルに ==> 自然にスモールな ==> 小規模な

sfujiwara · 2019-07-26T16:56:50Z

+        "\n",
+        "* *直感的なインタフェース*— Python のデータ構造を使用して、コードをナチュラルに記述することができます。スモールなモデルとデータに対してすばやく実験を繰り返すことができます。\n",
+        "* *より簡単なデバッグ*— ops を直接呼び出すことで、実行中のモデルを調査したり、変更をテストすることができます。 Python 標準のデバッグツールを用いて即座にエラーのレポーティングができます。\n",
+        "* *自然な制御フロー*— TensorFlow のグラフ制御フローの代わりに Python の制御フローを利用するため、動的なモデルのパラメータ変更をシンプルに行うことができます。\n",


[discussion]

制御フロー or control flow

Control flow is a technical term for TensorFlow:
https://www.tensorflow.org/api_docs/cc/group/control-flow-ops

So, I think we don't need to translate it.
But 制御フロー is good and natural translation, so I can not tell which is better.
How is your opinion?

[suggestion]

動的なモデルのパラメータ変更 ==> 動的なモデルの作成

制御フロー or control flow

I'd like "制御フロー" because Chinese documents translate it.
And in the another part of documents such as autograph uses "制御フロー", too..

動的なモデルのパラメータ変更 ==> 動的なモデルの作成

specification's direct translation isn't "作成", but it's natural. So I use your suggestion.

sfujiwara · 2019-07-26T17:10:30Z

+        "Eager Execution を有効化することで、 TensorFlow の挙動は変わります—TensorFlowは即座に式を評価して結果をPythonに返すようになります。\n",
+        "`tf.Tensor` オブジェクトは計算グラフのノードへのシンボリックハンドルの代わりに具体的な値を参照します。\n",
+        "セッションの中で構築して実行する計算グラフが存在しないため、`print（）`やデバッガを使って容易に結果を調べることができます。\n",
+        "勾配計算を終了することなくテンソル値を評価、出力、およびチェックすることができます。\n",


[suggestion]
I think 終了することなく ==> 遮ることなく is more natural translation.

sfujiwara · 2019-07-26T17:33:31Z

+      "source": [
+        "## Eager Execution の途中でオブジェクトのステータスを使用する\n",
+        "\n",
+        "TF 1.x の Graph Execution では、プログラムの状態（変数など）は global collection に格納され、それらの存続期間は `tf.Session` オブジェクトによって管理されます。\n",


I commented about Variable above.

Variable and queue are only objects which have "state" (that is, mutabule in session) in TF v1.
They refer to it here.
So, I guess it's better to distinguish Variable (a technical term for TensorFlow) and 変数 (a technical term for general programming or mathematical optimization) explicitly.

the original document in English uses (such as the variables).
variables in this case use lowercase, so I doubt if we should translate or use handle as tf.Variable.
I translated it as (Variableなど).(used capital V)

sfujiwara · 2019-07-26T17:50:07Z

+        "id": "xEL4yJe5qEhD"
+      },
+      "source": [
+        "## 高度な自動分類トピック\n",


自動分類 ==> 自動微分

sfujiwara · 2019-07-26T17:53:40Z

+        "### カスタム勾配\n",
+        "\n",
+        "カスタム勾配は、勾配を上書きする簡単な方法です。 フォワード関数では、\n",
+        "入力、出力、または中間結果に関する勾配を定義します。たとえば、逆方向パスにおいて勾配のノルムを切り取る簡単な方法は次のとおりです："


[weak suggestion]
I guess it's more natural to translate clip to 制限する or 固定する (not 切り取る)

sfujiwara · 2019-07-26T17:55:00Z

+        "colab": {}
+      },
+      "source": [
+        "# 購買計算は x = 0 のときはうまくいく。\n",


typo: 購買 ==> 勾配

sfujiwara · 2019-07-26T18:03:50Z

+        "Eager Execution は開発とデバッグをより対話的にしますが、\n",
+        "TensorFlow 1.x スタイルの Graph Execution は分散学習、パフォーマンスの最適化、そしてプロダクション環境へのデプロイの観点で利点があります。\n",
+        "\n",
+        "2つの手法のギャップを埋めるために、 TensorFlow 2.0 は `ｔｆ．function` API に似た `function` を紹介します。\n",


[suggestion]

TensorFlow 2.0 は `tf.function` API に似た `function` を紹介します。 ==> TensorFlow 2.0 では `tf.function` という機能を導入しています。

lamberta · 2019-07-31T23:25:09Z

Hi @chie8842, can you please apply the reviewer suggestions and then I can merge this pull request. Thank you

lamberta · 2019-09-11T18:09:44Z

Closing this pull requests because of inactivity. Feel free to apply the reviewer suggestions and re-open when ready. Thanks

add ja/r2/guide/eager.ipynb

002d221

googlebot added the cla: yes CLA has been signed label Jul 5, 2019

tfdocsbot added ja translation Community-provided translation for certain languages labels Jul 5, 2019

fixed bugs

6ac776a

chie8842 marked this pull request as ready for review July 5, 2019 11:53

chie8842 requested review from MarkDaoust and lamberta as code owners July 5, 2019 11:53

lamberta previously requested changes Jul 8, 2019

View reviewed changes

lamberta added 2 commits July 10, 2019 15:39

Fix file path

a51fabf

Fix notebook and switch to GPU

f839805

lamberta added the awaiting-translation-review label Jul 10, 2019

sfujiwara suggested changes Jul 26, 2019

View reviewed changes

lamberta added awaiting-contributor-response Indicates a question, draft, or work-in-progress and removed awaiting-translation-review labels Jul 31, 2019

lamberta closed this Sep 11, 2019

chie8842 mentioned this pull request Sep 14, 2019

JA: add ja/guide/eager.ipynb #999

Merged

Conversation

chie8842 commented Jul 5, 2019

Uh oh!

tfdocsbot commented Jul 5, 2019 • edited by lamberta Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tfdocsbot commented Jul 5, 2019

Uh oh!

lamberta left a comment

Choose a reason for hiding this comment

Uh oh!

lamberta commented Jul 10, 2019

Uh oh!

sfujiwara left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sfujiwara Jul 26, 2019 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

lamberta commented Jul 31, 2019

Uh oh!

lamberta commented Sep 11, 2019

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

tfdocsbot commented Jul 5, 2019 •

edited by lamberta

Loading

sfujiwara Jul 26, 2019 •

edited

Loading