diff --git a/docs/source/Constant.md b/docs/source/Constant.md index e69de29b..4e50cd55 100644 --- a/docs/source/Constant.md +++ b/docs/source/Constant.md @@ -0,0 +1,2 @@ +# Chapter. Constant + diff --git a/docs/source/Foreword.md b/docs/source/Foreword.md index 0a5232f9..b9a1c16b 100644 --- a/docs/source/Foreword.md +++ b/docs/source/Foreword.md @@ -1,9 +1,17 @@ -# Foreword 前言 +# Foreword -One of the most nerve-wracking periods when releasing the first version of an open source project occurs when the gitter community is created. You are all alone, eagerly hoping and wishing for the first user to come along. I still vividly remember those days. +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里开放一个聊天社区，而里面只有你一个人，饥渴地期待第一个进入聊天室的用户，我仍然清楚地记得那个时期。 -当我开始写这个项目的时候，我同时也在整理编码过程时候的想法，Tensorflow是个巨大最复杂的工程，很容易超出个人能力范围，所以想尽可能地把当时的思路记录下来，也想趁着记录整理的过程把思路理清。 -When I started writing this project, I was also sorting out the idea of the coding process. Tensorflow is a huge and complicated project, and it is easy to go beyond the scope of personal ability. Therefore, I want to record the thoughts at the time as much as possible. The process of recording and sorting clears the way of thinking. \ No newline at end of file +TensorFlow.NET is my third open source project. BotSharp and NumSharp are the first two. The response is pretty good. I also got a lot of stars on github. Although the first two projects are very difficult, I can't admit that TensorFlow.NET is much more difficult than the previous two, and it is an area I have never been involved with. Mainly related to GPU parallel computing, distributed computing and neural network model. When I started writing this project, I was also sorting out the idea of the coding process. TensorFlow is a huge and complicated project, and it is easy to go beyond the scope of personal ability. Therefore, I want to record the thoughts at the time as much as possible. The process of recording and sorting clears the way of thinking. + +TensorFlow.NET是我写的第3个开源项目，BotSharp和NumSharp是前两个，反应都还不错，在github上也收获了不少星。虽然前两个项目的难度很大，但是我不得承认TensorFlow.NET的难度要比之前两个要大的多，是我从未涉入过的领域。主要涉及GPU并行计算，分布式计算和神经网络模型。当我开始写这个项目的时候，我同时也在整理编码过程时候的想法，TensorFlow是个巨大最复杂的工程，很容易超出个人能力范围，所以想尽可能地把当时的思路记录下来，也想趁着记录整理的过程把思路理清。 + + + +All the examples in this book can be found in the github repository of TensorFlow.NET. When the source code and the code in the book are inconsistent, please refer to the source code. The sample code is typically located in the Example or UnitTest project. + +本书中的所有例子都可以在TensorFlow.NET的github仓库中找到，当源代码和书中的代码不一致时，请以源代码为准。示例代码一般都位于Example或者是UnitTest项目里。 \ No newline at end of file diff --git a/docs/source/FrontCover.md b/docs/source/FrontCover.md index a8567154..1b40566f 100644 --- a/docs/source/FrontCover.md +++ b/docs/source/FrontCover.md @@ -1,5 +1,5 @@ # The Definitive Guide to TensorFlow.NET -# TensorFlow.NET 权威指南 + @@ -23,9 +23,7 @@ #### An Open Source Machine Learning Framework for Everyone -### 谷歌TensorFlow的C#绑定库 - -#### 人人都可用的开源机器学习框架。 +#### @@ -40,8 +38,6 @@

Haiping Chen & Christian Kahr
Christmas, 2018
-陈海平 & 克里斯汀·卡尔
-2018年圣诞节

@@ -49,3 +45,4 @@ + diff --git a/docs/source/HelloWorld.md b/docs/source/HelloWorld.md index 9d7c818b..5375ec15 100644 --- a/docs/source/HelloWorld.md +++ b/docs/source/HelloWorld.md @@ -1,10 +1,16 @@ # Get started with TensorFlow.NET -让我们先运行一个经典的HelloWorld程序，看看TensorFlow在.NET上面运行的效果，我想不出有比做个HelloWorld更简单的方式了。 +I would describe TensorFlow as an open source machine learning framework developed by Google which can be used to build neural networks and perform a variety of machine learning tasks. it works on data flow graph where nodes are the mathematical operations and the edges are the data in the form of tensor, hence the name Tensor-Flow. + +按照我的理解，TensorFlow是Google公司开发的一个开源机器学习框架，可以用来搭建神经网络模型和其它传统机器学习模型，它采用了图计算模型，图的节点和边分别代表了操作和数据输入或输出，数据在图的单个方向传递，因此这个过程形象地取名叫做TensorFlow。 Let's run a classic HelloWorld program first and see if TensorFlow is running on .NET. I can't think of a simpler way to be a HelloWorld. -### Install the TensorFlow.NET SDK 安装开发环境 +让我们先运行一个经典的HelloWorld程序，看看TensorFlow在.NET上面运行的效果，我想不出有比做个HelloWorld更简单的方式了。 + + + +### Install the TensorFlow.NET SDK TensorFlow.NET uses the .NET Standard 2.0 standard, so your new project Target Framework can be .NET Framework or .NET Core. All the examples in this book are using .NET Core 2.2 and Microsoft Visual Studio Community 2017. To start building TensorFlow program you just need to download and install the .NET SDK (Software Development Kit). You have to download the latest .NET Core SDK from offical website: https://dotnet.microsoft.com/download. @@ -24,7 +30,7 @@ TensorFlow.NET采用.NET标准库2.0版本，因此你的新建工程可以是.N PM> Install-Package TensorFlow.NET ``` -### Start coding Hello World 开始编写Hello World +### Start coding Hello World After installing the TensorFlow.NET package, you can use the `using Tensorflow` to introduce the TensorFlow library. @@ -68,3 +74,7 @@ Hello, TensorFlow! Press any key to continue . . . ``` +This sample code can be found at [here](https://github.com/SciSharp/TensorFlow.NET/blob/master/test/TensorFlowNET.Examples/HelloWorld.cs). + +此示例代码可以在[这里](https://github.com/SciSharp/TensorFlow.NET/blob/master/test/TensorFlowNET.Examples/HelloWorld.cs)找到。 + diff --git a/docs/source/Preface.md b/docs/source/Preface.md index 6cb29357..175ff817 100644 --- a/docs/source/Preface.md +++ b/docs/source/Preface.md @@ -1,6 +1,6 @@ -# Preface 序 +# Preface @@ -32,4 +32,4 @@ TensorFlow is an open source project for machine learning especially for deep le TF: Google TensorFlow -TF.NET: Tensorflow.NET \ No newline at end of file +TF.NET: TensorFlow.NET \ No newline at end of file diff --git a/docs/source/Tensor.md b/docs/source/Tensor.md index b0b14f33..b460bede 100644 --- a/docs/source/Tensor.md +++ b/docs/source/Tensor.md @@ -1,37 +1,53 @@ -# Chapter 1. Tensor 第一章: Tensor +# Chapter. Tensor ### Represents one of the outputs of an Operation -### 表示一个操作的输出 - ##### What is Tensor? -##### Tensor 是什么? - -Tensor holds a multi-dimensional array of elements of a single data type which is very similar with numpy's ndarray. +Tensor holds a multi-dimensional array of elements of a single data type which is very similar with numpy's ndarray. When the dimension is zero, it can be called a scalar. When the dimension is 2, it can be called a matrix. When the dimension is greater than 2, it is usually called a tensor. If you are very familiar with numpy, then understanding Tensor will be quite easy. -Tensor是一个具有单一数据类型的多维数组容器，非常类似于numpy里的ndarray。如果你对numpy非常熟悉的话，那么对Tensor的理解会相当容易。 +Tensor是一个具有单一数据类型的多维数组容器，当维度为零时，可以称之为标量，当维度为2时，可以称之为矩阵，当维度大于2时，通常称之为张量。Tensor的数据结构非常类似于numpy里的ndarray。如果你对numpy非常熟悉的话，那么对Tensor的理解会相当容易。 ##### How to create a Tensor? -##### 如何创建一个Tensor? +There are many ways to initialize a Tensor object in TF.NET. It can be initialized from a scalar, string, matrix or tensor. + +在TF.NET中有很多种方式可以初始化一个Tensor对象。它可以从一个标量，字符串，矩阵或张量来初始化。 + +```csharp +// Create a tensor holds a scalar value +var t1 = new Tensor(3); + +// Init from a string +var t2 = new Tensor("Hello! TensorFlow.NET"); + +// Tensor holds a ndarray +var nd = new NDArray(new int[]{3, 1, 1, 2}); +var t3 = new Tensor(nd); + +Console.WriteLine($"t1: {t1}, t2: {t2}, t3: {t3}"); +``` + + + +##### Data Structure of Tensor -TF uses column major order. +TF uses column major order. If we use NumSharp to generate a 2 x 3 matrix, if we access the data from 0 to 5 in order, we won't get a number of 1-6, but we get the order of 1, 4, 2, 5, 3, 6. a set of numbers. TF 采用的是按列存储模式，如果我们用NumSharp产生一个2 X 3的矩阵，如果按顺序从0到5访问数据的话，是不会得到1-6的数字的，而是得到1，4， 2， 5， 3， 6这个顺序的一组数字。 ```cs -// generate a matrix:[[1, 2, 3], [4, 5, 6]] +// Generate a matrix:[[1, 2, 3], [4, 5, 6]] var nd = np.array(1f, 2f, 3f, 4f, 5f, 6f).reshape(2, 3); -// the index will be 0 2 4 1 3 5, it's column-major order. +// The index will be 0 2 4 1 3 5, it's column-major order. ``` diff --git a/docs/source/index.rst b/docs/source/index.rst index f818bb77..69afde2f 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -27,4 +27,9 @@ Indices and tables Foreword Preface HelloWorld - Tensor \ No newline at end of file + Tensor + Constant + Variable + Operation + Graph + Session \ No newline at end of file diff --git a/src/TensorFlowNET.Core/TensorFlowNET.Core.csproj b/src/TensorFlowNET.Core/TensorFlowNET.Core.csproj index 92012ac8..2efeb120 100644 --- a/src/TensorFlowNET.Core/TensorFlowNET.Core.csproj +++ b/src/TensorFlowNET.Core/TensorFlowNET.Core.csproj @@ -4,7 +4,7 @@ netstandard2.0 TensorFlow.NET Tensorflow - 0.0.3 + 0.1.0 Haiping Chen SciSharp STACK true @@ -16,8 +16,9 @@ TensorFlow, NumSharp, SciSharp, MachineLearning, TensorFlow.NET Google's TensorFlow binding in .NET Standard. Docs: https://tensorflownet.readthedocs.io - 0.0.3.0 - API updated + 0.1.0.0 + Implemented the tf.Variable(). +TensorFlow 1.13 RC. 7.2 diff --git a/test/TensorFlowNET.Examples/TensorFlowNET.Examples.csproj b/test/TensorFlowNET.Examples/TensorFlowNET.Examples.csproj index d919ac36..db80b4bd 100644 --- a/test/TensorFlowNET.Examples/TensorFlowNET.Examples.csproj +++ b/test/TensorFlowNET.Examples/TensorFlowNET.Examples.csproj @@ -7,7 +7,7 @@ - + diff --git a/test/TensorFlowNET.UnitTest/TensorFlowNET.UnitTest.csproj b/test/TensorFlowNET.UnitTest/TensorFlowNET.UnitTest.csproj index 07f8d132..43dfb82d 100644 --- a/test/TensorFlowNET.UnitTest/TensorFlowNET.UnitTest.csproj +++ b/test/TensorFlowNET.UnitTest/TensorFlowNET.UnitTest.csproj @@ -20,7 +20,7 @@ - +