diff --git a/docs/source/Constant.md b/docs/source/Constant.md index 4e50cd55..f6ebf461 100644 --- a/docs/source/Constant.md +++ b/docs/source/Constant.md @@ -1,2 +1,50 @@ # Chapter. Constant +In TensorFlow, a constant is a special Tensor that cannot be modified while the graph is running. Like in a linear model $\tilde{y_i}=\boldsymbol{w}x_i+b$, constant $b$ can be represented as a Constant Tensor. Since the constant is a Tensor, it also has all the data characteristics of Tensor, including: + +* value: scalar value or constant list matching the data type defined in TensorFlow; +* dtype: data type; +* shape: dimensions; +* name: constant's name; + +在TensorFlow中，常量是一种特殊的Tensor，它在计算图运行的时候，不能被修改。比如在线性模型里$\tilde{y_i}=\boldsymbol{w}x_i+b$, 常数$b$就可以用一个常量来表示。既然常量是一种Tensor，那么它也就具有Tensor的所有数据特性，它包括： + +* value: 符合TensorFlow中定义的数据类型的常数值或者常数列表; +* dtype：数据类型; +* shape：常量的形状; +* name：常量的名字; + + + +##### How to create a Constant + +TensorFlow provides a handy function to create a Constant. In TF.NET, you can use the same function name `tf.constant` to create it. TF.NET takes the same name as python binding to the API. Naming, although this will make developers who are used to C# naming habits feel uncomfortable, but after careful consideration, I decided to give up the C# convention naming method. + +TensorFlow提供了一个很方便的函数用来创建一个Constant, 在TF.NET，可以使用同样的函数名`tf.constant`来创建，TF.NET采取尽可能使用和python binding一样的命名方式来对API命名，虽然这样会让习惯C#命名习惯的开发者感到不舒服，但我经过深思熟虑之后还是决定放弃C#的约定命名方式。 + +Initialize a scalar constant: + +```csharp +var c1 = tf.constant(3); // int +var c2 = tf.constant(1.0f); // float +var c3 = tf.constant(2.0); // double +var c4 = tf.constant("Big Tree"); // string +``` + +Initialize a constant through ndarray: + +```csharp +// dtype=int, shape=(2, 3) +var nd = np.array(new int[][] +{ + new int[]{3, 1, 1}, + new int[]{2, 3, 1} +}); +var tensor = tf.constant(nd); +``` + +##### Dive in Constant + +Now let's explore how constant works. + +现在让我探究一下`tf.constant`是怎么工作的。 \ No newline at end of file diff --git a/docs/source/Foreword.md b/docs/source/Foreword.md index b9a1c16b..af8ff8d3 100644 --- a/docs/source/Foreword.md +++ b/docs/source/Foreword.md @@ -2,7 +2,7 @@ One of the most nerve-wracking periods when releasing the first version of an open source project occurs when the [gitter](https://gitter.im/sci-sharp/community) community is created. You are all alone, eagerly hoping and wishing for the first user to come along. I still vividly remember those days. -最让人紧张的时刻是当我为自己的开源项目发布第一个版本并在gitter里开放一个聊天社区，而里面只有你一个人，饥渴地期待第一个进入聊天室的用户，我仍然清楚地记得那个时期。 +最让人紧张的时刻是当我为自己的开源项目发布第一个版本并在gitter里开放一个聊天社区，而里面只有你一个人，饥渴地等待第一个进入聊天室的用户，我仍然清楚地记得那个时期。 diff --git a/docs/source/FrontCover.md b/docs/source/FrontCover.md index 1b40566f..322d431c 100644 --- a/docs/source/FrontCover.md +++ b/docs/source/FrontCover.md @@ -23,8 +23,6 @@ #### An Open Source Machine Learning Framework for Everyone -#### - @@ -36,7 +34,7 @@

-Haiping Chen & Christian Kahr
+Haiping Chen
Christmas, 2018

@@ -46,3 +44,4 @@ + diff --git a/docs/source/Graph.md b/docs/source/Graph.md index e69de29b..10c54857 100644 --- a/docs/source/Graph.md +++ b/docs/source/Graph.md @@ -0,0 +1,2 @@ +# Chapter. Graph + diff --git a/docs/source/Operation.md b/docs/source/Operation.md index e69de29b..651cf10f 100644 --- a/docs/source/Operation.md +++ b/docs/source/Operation.md @@ -0,0 +1,2 @@ +# Chapter. Operation + diff --git a/docs/source/Placeholder.md b/docs/source/Placeholder.md new file mode 100644 index 00000000..469c1c9e --- /dev/null +++ b/docs/source/Placeholder.md @@ -0,0 +1,2 @@ +# Chapter. Placeholder + diff --git a/docs/source/Preface.md b/docs/source/Preface.md index 175ff817..991af373 100644 --- a/docs/source/Preface.md +++ b/docs/source/Preface.md @@ -2,33 +2,27 @@ # Preface +Why do I start the TensorFlow.NET project? +In a few days, it was Christmas in 2018. I watched my children grow up and be sensible every day, and I felt that time passed too fast. IT technology updates are faster than ever, and a variety of front-end technologies are emerging. Big data, Artificial Intelligence and Blockchain, Container technology and Microservices, Distributed Computing and Serverless technology are dazzling. The Amazon AI service interface claims that engineers who don't need any machine learning experience can use it, so that the idea of just calming down for two years and planning to switch to an AI architecture in the future is a splash of cold water. +再过几天就是2018年圣诞节，看着孩子一天天长大并懂事，感慨时间过得太快。IT技术更新换代比以往任何时候都更快，各种前后端技术纷纷涌现。大数据，人工智能和区块链，容器技术和微服务，分布式计算和无服务器技术，让人眼花缭乱。Amazon AI服务接口宣称不需要具有任何机器学习经验的工程师就能使用，让像我这样刚静下心来学习了两年并打算将来转行做AI架构的想法泼了一桶凉水。 +TensorFlow is an open source project for machine learning especially for deep learning. It's used for both research and production at Google company. It's designed according to dataflow programming pattern across a range of tasks. TensorFlow is not just a deep learning library. As long as you can represent your calculation process as a data flow diagram, you can use TensorFlow for distributed computing. TensorFlow uses a computational graph to build a computing network while operating on the graph. Users can write their own upper-level models in Python based on TensorFlow, or extend the underlying C++ custom action code to TensorFlow. +TensorFlow是一个用于机器学习的开源项目，尤其适用于深度学习。 它最初是谷歌公司的用于内部研究和生产的工具，后来开源出来给社区使用。TensorFlow并不仅仅是一个深度学习库，只要可以把你的计算过程表示称一个数据流图的过程，就可以使用TensorFlow来进行分布式计算。TensorFlow用计算图的方式建立计算网络，同时对图进行操作。用户可以基于TensorFlow的基础上用python编写自己的上层模型，也可以扩展底层的C++自定义操作代码添加到TensorFlow中。 - - - -Why do I start the TensorFlow.NET project? - -我为什么会写TensorFlow.NET? - -再过几天就是2018年圣诞节，看着孩子一天天长大并懂事，感慨时间过得太快。IT技术更新换代比以往任何时候都更快，各种前后端技术纷纷涌现。大数据，人工智能和区块链，容器技术和微服务，分布式计算和无服务器技术，让人眼花缭乱。Amazon AI服务接口宣称不需要具有任何机器学习经验的工程师就能使用，让像我这样刚静下心来学习了两年并打算将来转行做AI架构的想法泼了一桶凉水。 - -TensorFlow is an open source project for machine learning especially for deep learning. It's used for both research and production at Google company. It's designed according to dataflow programming pattern across a range of tasks. - - +In order to avoid confusion, the unique classes defined in TensorFlow are not translated in this book. For example, Tensor, Graph, Shape will retain the English name. 为了避免混淆，本书中对TensorFlow中定义的特有类不进行翻译，比如Tensor, Graph, Shape这些词都会保留英文名称。 -术语简称： +Terminology: TF: Google TensorFlow diff --git a/docs/source/Session.md b/docs/source/Session.md index e69de29b..a14816f4 100644 --- a/docs/source/Session.md +++ b/docs/source/Session.md @@ -0,0 +1,2 @@ +# Chapter. Session + diff --git a/docs/source/Variable.md b/docs/source/Variable.md index e69de29b..f98fbaf7 100644 --- a/docs/source/Variable.md +++ b/docs/source/Variable.md @@ -0,0 +1,2 @@ +# Chapter. Variable + diff --git a/docs/source/index.rst b/docs/source/index.rst index 69afde2f..e17c0d9e 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -6,22 +6,10 @@ Welcome to TensorFlow.NET's documentation! ========================================== -.. toctree:: - :maxdepth: 2 - :caption: Contents: - - - -Indices and tables -================== - -* :ref:`Front Cover ` - -.. _front-cover: .. toctree:: :maxdepth: 3 - :caption: Get Started with TensorFlow.NET: + :caption: The Definitive Guide to TensorFlow.NET FrontCover Foreword @@ -29,6 +17,7 @@ Indices and tables HelloWorld Tensor Constant + Placeholder Variable Operation Graph