JA: Add ja/lite/microcontrollers/get_started.md by zinziroge · Pull Request #123 · tensorflow/docs-l10n

zinziroge · 2020-03-15T08:12:29Z

Original Document:
https://github.com/tensorflow/tensorflow/blob/master/tensorflow/lite/g3doc/microcontrollers/get_started.md

…flow/lite/g3doc/microcontrollers

tfdocsbot · 2020-03-15T08:12:34Z

Reviewers added, please take a look.
@ohtaman, @sfujiwara, @masa-ita, @AseiSugiyama, @yukinagae, @nuka137, @chie8842, @kiszk

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

googlebot · 2020-03-15T08:12:37Z

Thanks for your pull request. It looks like this may be your first contribution to a Google open source project (if not, look below for help). Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

📝 Please visit https://cla.developers.google.com/ to sign.

Once you've signed (or fixed any issues), please reply here with @googlebot I signed it! and we'll verify it.

What to do if you already signed the CLA

Individual signers

It's possible we don't have your GitHub username or you're using a different email address on your commit. Check your existing CLA data and verify that your email is set on your git commits.

Corporate signers

Your company has a Point of Contact who decides which employees are authorized to participate. Ask your POC to be added to the group of authorized contributors. If you don't know who your Point of Contact is, direct the Google project maintainer to go/cla#troubleshoot (Public version).
The email used to register you as an authorized contributor must be the email used for the Git commit. Check your existing CLA data and verify that your email is set on your git commits.
The email used to register you as an authorized contributor must also be attached to your GitHub account.

ℹ️ Googlers: Go here for more info.

zinziroge · 2020-03-15T08:16:14Z

@googlebot I signed it!

googlebot · 2020-03-15T08:16:18Z

CLAs look good, thanks!

ℹ️ Googlers: Go here for more info.

kiszk · 2020-03-15T09:18:26Z

+    マイクロコントローラ向けTensorFlow Liteの使い方の基本を実演します。
+
+* [Micro speech](https://github.com/tensorflow/tensorflow/tree/master/tensorflow/lite/micro/examples/micro_speech) -
+    マイクロフォンで音声を取り込み、"yes"と"no"という単語を検出します。


[weak suggestion] 音声 -> 音

I used your suggestion.

kiszk · 2020-03-15T09:20:16Z

+[Hello World](https://github.com/tensorflow/tensorflow/tree/master/tensorflow/lite/micro/examples/hello_world)
+アプリケーション例を始めから終わりまで見ていきます。
+
+## Hello World サンプル


[weak suggestion] サンプル -> の例

I used your suggestion.

kiszk · 2020-03-15T09:26:04Z

+## Hello World サンプル
+
+この例はマイクロコントローラ向けTensorFlow Liteの使い方の基本を実演します。
+モデルの訓練、TensorFlow Liteと共に使うためのモデル変換、


[weak suggestion] モデルの訓練 -> モデルの訓練から
The invention is to want to represent that 始めから終わりまでのワークフロー includes 訓練, 変換, and 実行.

I used your suggestion.

kiszk · 2020-03-15T09:33:25Z

+* [`schema_generated.h`](https://github.com/tensorflow/tensorflow/blob/master/tensorflow/lite/schema/schema_generated.h)
+    TensorFlow Lite [`FlatBuffer`](https://google.github.io/flatbuffers/) モデルファイルフォーマットのスキームを含みます。
+* [`version.h`](https://github.com/tensorflow/tensorflow/blob/master/tensorflow/lite/version.h)
+    TensorFlow Lite スキームへのバージョン情報を提供します。


[suggestion] スキーム -> スキーマ

I used your suggestion.

kiszk · 2020-03-15T09:35:29Z

+
+### モデルをインクルードする
+
+マイクロコントローラ向けTensorFlow Lite インタープリタは、モデルがC++配列で提供されることを期待しています。*Hellow World* サンプルでは、モデルは `sine_model_data.h` と `sine_model_data.cc` で定義されています。ヘッダーは以下の行に含まれます。


[weak suggestion] 行に -> 行で

I used your suggestion.

kiszk · 2020-03-15T09:37:24Z

+
+### ログ取得を用意する
+
+ログ取得の準備するために、`tflite::ErrorReporter` ポインタが作成され、ポインタは `tflite::MicroErrorReporter` インスタンスに対して使用されます。


[suggestion] 準備する -> 準備をする

[weak suggestion]

`tflite::ErrorReporter` ポインタが作成され、ポインタは `tflite::MicroErrorReporter` インスタンスに対して使用されます。

->

`tflite::MicroErrorReporter` インスタンスへのポインタを使って、`tflite::ErrorReporter` ポインタが作成されます。

or

`tflite::MicroErrorReporter` インスタンスへのポインタを持つ、`tflite::ErrorReporter` ポインタが作成されます。

I used your 2nd suggestion.

AseiSugiyama

Thank you for your great work! Could you check the followings?

This PR contains untranslated files build_convert.md, index.md, and library.md. Could you remove these files from this PR?
I reviewed your PR. Could you check it, please?

AseiSugiyama · 2020-03-15T09:07:11Z

+
+* [Arduino Nano 33 BLE Sense](https://store.arduino.cc/usa/nano-33-ble-sense-with-headers)
+    (Arduino IDEを使います)
+* [SparkFun Edge](https://www.sparkfun.com/products/15170) (ソースから直接ビルドします)


Nice translation 👍

AseiSugiyama · 2020-03-15T09:08:55Z

+
+## サポートされているデバイスを入手する
+
+この案内書にしたがっていくには、サポートされたハードウェアデバイスが必要です。


[weak suggestion]

Suggested change

この案内書にしたがっていくには、サポートされたハードウェアデバイスが必要です。

このガイドにしたがっていくには、サポートされたハードウェアデバイスが必要です。

I think ガイド is better than 案内書 or 手順書 to be consistent.

I used your suggestion.

AseiSugiyama · 2020-03-15T10:03:40Z

+## サポートされているデバイスを入手する
+
+この案内書にしたがっていくには、サポートされたハードウェアデバイスが必要です。
+使用するアプリケーション例は下記デバイスで検証されています。


[suggestion]

Suggested change

使用するアプリケーション例は下記デバイスで検証されています。

使用するサンプルのアプリケーションは下記デバイスで検証されています。

At the following, examples is translated サンプル. So it seems to be better to use the word サンプル here.

I used your suggestion.

AseiSugiyama · 2020-03-15T10:05:36Z

+
+## サンプルを探索する
+
+マイクロコントローラ向けTensorFlow Liteはいくつかのアプリケーション例が付属しており、


[suggestion]

Suggested change

マイクロコントローラ向けTensorFlow Liteはいくつかのアプリケーション例が付属しており、

マイクロコントローラ向けTensorFlow Liteにはいくつかのサンプルのアプリケーションが付属しており、

Same as above, I guess it is better to translate example into サンプル.

I used your suggestion.

AseiSugiyama · 2020-03-15T10:12:54Z

+## サンプルを探索する
+
+マイクロコントローラ向けTensorFlow Liteはいくつかのアプリケーション例が付属しており、
+それらはさまざまなタスクの使い方を実演します。


[suggestion]

Suggested change

それらはさまざまなタスクの使い方を実演します。

それらはさまざまなタスクへの適用の仕方を実際の例によって示します。

I think the words "its use" means "how to use TensorFlow Lite" not "how to use tasks". How about this?

I think your suggestion is right.

AseiSugiyama · 2020-03-15T11:31:39Z

+```
+
+`AllOpsResolver` は、マイクロコントローラ向けTensorFlow Liteで利用可能なすべての演算を読み込み、それは多くのメモリを使用します。
+与えられたモデルはこれら演算の一部のみを使用するであろうから、現実のアプリケーションは必要な演算のみを読み込むことが推奨されます。


[suggestion]

Suggested change

与えられたモデルはこれら演算の一部のみを使用するであろうから、現実のアプリケーションは必要な演算のみを読み込むことが推奨されます。

通常、モデルが必要とするのはこれらの演算のうちの一部のため、現実世界に適用する際には必要な演算のみを読み込むことが推奨されます。

I think the words real world application means implementation into the real world or deploying it into a production environment (not software). How do you think?

I think your suggestion is right.

AseiSugiyama · 2020-03-15T12:29:30Z

+// それは次元ごとに1つの要素を持つ。我々の入力は2次元のテンソルで1つの要素を含むので、
+// "dims" は2であるべきである。


I'm confused by these two lines 🤔 In this Jupyter notebook , the input of the original model (x_test) has the shape (200, ) and this means x_test is a 1-D array. However, based on this document, the input of this model should have two dimensions.

I cannot find any description supports this claim. Let me check.

I think your translation has no problem and we have nothing to fix on this line. Since English documents are the "single source of truth", it is better to discuss at the tensorflow/tensorflow repo. I'll do that.

tensorflow/tensorflow#37829

Sorry, this comment came from my misunderstanding. What I have to check truly is the input shape of sine_model, not the input of model_2 . Thank you for your suggestion!

AseiSugiyama · 2020-03-15T12:49:12Z

+モデルの出力テンソルは、`tflite::MicroIntepreter` 上で `output(0)` を呼ぶことで取得できます。
+`0` は最初の（そして唯一の）出力テンソルであることを表します。
+
+サンプルでは、モデルの出力は1つの2次元テンソルに含まれる1つの浮動小数点数です。


Same as above, I'm confused by this line too. IMO, the model's output seems to be 1D Tensor contains two elements 🤔

Same as above. tensorflow/tensorflow#37829

Sorry, same as above, this comment came from my misunderstanding.

AseiSugiyama · 2020-03-15T12:56:13Z

+
+コードの残り部分は、モデルの読み込みと推論を実演します。
+
+### ログ取得を用意する


[suggestion]

Suggested change

### ログ取得を用意する

### ログ取得を準備する

I guess this seems to be better to be consistent with the next line.

I used your suggestion.

AseiSugiyama · 2020-03-15T13:03:19Z

+
+### ログ取得を用意する
+
+ログ取得の準備するために、`tflite::ErrorReporter` ポインタが作成され、ポインタは `tflite::MicroErrorReporter` インスタンスに対して使用されます。


[suggeston]

Suggested change

ログ取得の準備するために、`tflite::ErrorReporter` ポインタが作成され、ポインタは `tflite::MicroErrorReporter` インスタンスに対して使用されます。

ログ取得の準備をするために、`tflite::MicroErrorReporter` インスタンスのポインタを用いて `tflite::ErrorReporter` ポインタが作成されます。

I think tflite::ErrorReporter is an abstract class and tflite::MicroErrorReporter is one of implementations of it.

I used your suggestion.

I used this(#123 (comment)) sugession .

kiszk · 2020-03-20T17:32:10Z

+uint8_t tensor_arena[tensor_arena_size];
+```
+
+要求される大きさは使用するモデルに依存し、実験によって決められる必要があるかもしれません。


[weak suggestion]

Suggested change

要求される大きさは使用するモデルに依存し、実験によって決められる必要があるかもしれません。

要求される大きさは使用するモデルに依存し、実験によって決める必要があるかもしれません。

I used your suggestion.

kiszk · 2020-03-20T17:34:40Z

+このテンソルを検証し、形と型が期待したものであることを確認します。
+
+```C++
+// 入力は期待するプロパティを持つこと確認する


[suggestion]

Suggested change

// 入力は期待するプロパティを持つこと確認する

// 入力は期待するプロパティを持つことを確認する

I used your suggestion.

kiszk · 2020-03-20T17:36:31Z

+TF_LITE_MICRO_EXPECT_NE(nullptr, input);
+// プロパティ "dims" はテンソルの形を教えてくれる。
+// それは次元ごとに1つの要素を持つ。我々の入力は2次元のテンソルで1つの要素を含むので、
+// "dims" は2であるべきである。


[weak suggestion]

Suggested change

// "dims" は2であるべきである。

// "dims" の数は2であるべきである。

or "dims" の次元数は2であるべきである。

I used your 2nd suggestion.

kiszk · 2020-03-20T17:40:03Z

+TF_LITE_MICRO_EXPECT_EQ(kTfLiteFloat32, input->type);
+```
+
+enum値 `kTfLiteFloat32` は、TensorFlow Lite のデータ型の一つへの参照であり、


[weak suggestion]

Suggested change

enum値 `kTfLiteFloat32` は、TensorFlow Lite のデータ型の一つへの参照であり、

enum値 `kTfLiteFloat32` は、TensorFlow Lite のデータ型のうちの一つへの参照であり、

I used your suggestion.

kiszk · 2020-03-20T17:45:50Z

+この単体テストを一度ひととおり読み終えたら、
+[`main_functions.cc`](https://github.com/tensorflow/tensorflow/blob/master/tensorflow/lite/micro/examples/hello_world/main_functions.cc)
+にあるサンプルアプリケーションのコードを理解できるはずです。
+


[suggestion] delete this blank line.

I used your suggestion.

kiszk · 2020-03-20T17:47:14Z

+
+ライブラリがさまざまなモデルやアプリケーションと共にどのように利用できるかを知るためには、ほかのサンプルをデプロイし、そのコードを初めから終わりまで見てみることをお薦めします。
+
+<a class="button button-primary" href="https://github.com/tensorflow/tensorflow/tree/master/tensorflow/lite/micro/examples">Githubのサンプルアプリケーション</a>


[Suggestion]

Suggested change

<a class="button button-primary" href="https://github.com/tensorflow/tensorflow/tree/master/tensorflow/lite/micro/examples">Githubのサンプルアプリケーション</a>

<a class="button button-primary" href="https://github.com/tensorflow/tensorflow/tree/master/tensorflow/lite/micro/examples">GitHubのサンプルアプリケーション</a>

I used your suggestion.

* deleted untranslaed files

AseiSugiyama · 2020-04-05T02:16:01Z

@zinziroge Great work! LGTM!

zinziroge · 2020-04-05T03:19:37Z

thank for reviewing, @AseiSugiyama @kiszk !!

lamberta

Thanks for the translation and review! 🚀

zinziroge added 4 commits March 1, 2020 16:27

copy from https://github.com/tensorflow/tensorflow/tree/master/tensor…

bd3cbb8

…flow/lite/g3doc/microcontrollers

translated into Japanese roughly.

0d4fa0e

modify end of sentence, and some expressions.

13b0b29

modify invalid words pointed out by redpen.

d8aa6ba

zinziroge requested a review from lamberta as a code owner March 15, 2020 08:12

tfdocsbot added ja translation labels Mar 15, 2020

googlebot added the cla: no CLA has not been signed label Mar 15, 2020

googlebot added cla: yes CLA has been signed and removed cla: no CLA has not been signed labels Mar 15, 2020

kiszk reviewed Mar 15, 2020

View reviewed changes

AseiSugiyama reviewed Mar 15, 2020

View reviewed changes

kiszk reviewed Mar 20, 2020

View reviewed changes

* fixed sentences pointed out by reviewers.

4a8f476

* deleted untranslaed files

tfdocsbot added the lgtm Community-added approval label Apr 5, 2020

AseiSugiyama approved these changes Apr 5, 2020

View reviewed changes

AseiSugiyama mentioned this pull request Apr 5, 2020

Add one terminology for translation of "guide". tfug/proofreading#47

Open

lamberta approved these changes Apr 6, 2020

View reviewed changes

lamberta merged commit 7b78a6f into tensorflow:master Apr 6, 2020

zinziroge deleted the zinziroge_ja_microcontroller__get_started branch June 4, 2020 07:37


		### モデルをインクルードする

		マイクロコントローラ向けTensorFlow Lite インタープリタは、モデルがC++配列で提供されることを期待しています。Hellow World サンプルでは、モデルは `sine_model_data.h` と `sine_model_data.cc` で定義されています。ヘッダーは以下の行に含まれます。


		### ログ取得を用意する

		ログ取得の準備するために、`tflite::ErrorReporter` ポインタが作成され、ポインタは `tflite::MicroErrorReporter` インスタンスに対して使用されます。


		## サポートされているデバイスを入手する

		この案内書にしたがっていくには、サポートされたハードウェアデバイスが必要です。

	この案内書にしたがっていくには、サポートされたハードウェアデバイスが必要です。
	このガイドにしたがっていくには、サポートされたハードウェアデバイスが必要です。

	使用するアプリケーション例は下記デバイスで検証されています。
	使用するサンプルのアプリケーションは下記デバイスで検証されています。


		## サンプルを探索する

		マイクロコントローラ向けTensorFlow Liteはいくつかのアプリケーション例が付属しており、

	マイクロコントローラ向けTensorFlow Liteはいくつかのアプリケーション例が付属しており、
	マイクロコントローラ向けTensorFlow Liteにはいくつかのサンプルのアプリケーションが付属しており、

	それらはさまざまなタスクの使い方を実演します。
	それらはさまざまなタスクへの適用の仕方を実際の例によって示します。

	与えられたモデルはこれら演算の一部のみを使用するであろうから、現実のアプリケーションは必要な演算のみを読み込むことが推奨されます。
	通常、モデルが必要とするのはこれらの演算のうちの一部のため、現実世界に適用する際には必要な演算のみを読み込むことが推奨されます。

		// それは次元ごとに1つの要素を持つ。我々の入力は2次元のテンソルで1つの要素を含むので、
		// "dims" は2であるべきである。


		コードの残り部分は、モデルの読み込みと推論を実演します。

		### ログ取得を用意する

	### ログ取得を用意する
	### ログ取得を準備する

	ログ取得の準備するために、`tflite::ErrorReporter` ポインタが作成され、ポインタは `tflite::MicroErrorReporter` インスタンスに対して使用されます。
	ログ取得の準備をするために、`tflite::MicroErrorReporter` インスタンスのポインタを用いて `tflite::ErrorReporter` ポインタが作成されます。

	要求される大きさは使用するモデルに依存し、実験によって決められる必要があるかもしれません。
	要求される大きさは使用するモデルに依存し、実験によって決める必要があるかもしれません。

	// 入力は期待するプロパティを持つこと確認する
	// 入力は期待するプロパティを持つことを確認する

	// "dims" は2であるべきである。
	// "dims" の数は2であるべきである。

	enum値 `kTfLiteFloat32` は、TensorFlow Lite のデータ型の一つへの参照であり、
	enum値 `kTfLiteFloat32` は、TensorFlow Lite のデータ型のうちの一つへの参照であり、


		ライブラリがさまざまなモデルやアプリケーションと共にどのように利用できるかを知るためには、ほかのサンプルをデプロイし、そのコードを初めから終わりまで見てみることをお薦めします。

		<a class="button button-primary" href="https://github.com/tensorflow/tensorflow/tree/master/tensorflow/lite/micro/examples">Githubのサンプルアプリケーション</a>

Conversation

zinziroge commented Mar 15, 2020

Uh oh!

tfdocsbot commented Mar 15, 2020

Uh oh!

googlebot commented Mar 15, 2020

What to do if you already signed the CLA

Individual signers

Corporate signers

Uh oh!

zinziroge commented Mar 15, 2020

Uh oh!

googlebot commented Mar 15, 2020

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!

AseiSugiyama 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!

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!

AseiSugiyama Mar 23, 2020 • 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

AseiSugiyama Mar 23, 2020 •

edited

Loading

kiszk Mar 20, 2020 •

edited

Loading