blob: 16d3b76502981bc7eb07f81ab475dcfe6e73bb2a [file] [log] [blame] [view]
A. Unique TensorFlower79228c72016-10-19 16:25:46 -08001# Changes since the last release
2
3## Breaking Changes to the API
4
Andrew Sellefcc39232016-11-22 10:04:37 -08005* Division and modulus operators (/, //, %) now match Python (flooring)
Andrew Sellef0a6d1e2016-12-13 16:01:12 -08006 semantics. This applies to `tf.div` and `tf.mod` as well. To obtain forced
7 integer truncation based behaviors you can use `tf.truncatediv`
8 and `tf.truncatemod`.
9* `tf.divide()` is now the recommended division function. `tf.div()` will
10 remain, but its semantics do not respond to Python 3 or `from future`
11 mechanisms.
12* tf.reverse() now takes indices of axes to be reversed. E.g.
13 `tf.reverse(a, [True, False, True])` must now be written as
14 `tf.reverse(a, [0, 2])`. `tf.reverse_v2()` will remain until 1.0 final.
15* `tf.mul`, `tf.sub` and `tf.neg` are deprecated in favor of `tf.multiply`,
16 `tf.subtract` and `tf.negative`.
17* The following Python functions have had their arguments changed to use `axis`
18 when referring to specific dimensions. We have kept the old keyword arguments
19 for compatibility currently, but we will be removing them well before the
20 final 1.0.
21 * `tf.argmax`: `dimension` becomes `axis`
22 * `tf.argmin`: `dimension` becomes `axis`
23 * `tf.count_nonzero`: `reduction_indices` becomes `axis`
24 * `tf.expand_dims`: `dim` becomes `axis`
25 * `tf.reduce_all`: `reduction_indices` becomes `axis`
26 * `tf.reduce_any`: `reduction_indices` becomes `axis`
27 * `tf.reduce_join`: `reduction_indices` becomes `axis`
28 * `tf.reduce_logsumexp`: `reduction_indices` becomes `axis`
29 * `tf.reduce_max`: `reduction_indices` becomes `axis`
30 * `tf.reduce_mean`: `reduction_indices` becomes `axis`
31 * `tf.reduce_min`: `reduction_indices` becomes `axis`
32 * `tf.reduce_prod`: `reduction_indices` becomes `axis`
33 * `tf.reduce_sum`: `reduction_indices` becomes `axis`
34 * `tf.reverse_sequence`: `batch_dim` becomes `batch_axis`, `seq_dim` becomes `seq_axis`
35 * `tf.sparse_concat`: `concat_dim` becomes `axis`
36 * `tf.sparse_reduce_sum`: `reduction_axes` becomes `axis`
37 * `tf.sparse_reduce_sum_sparse`: `reduction_axes` becomes `axis`
38 * `tf.sparse_split`: `split_dim` becomes `axis`
39* `tf.listdiff` has been renamed to `tf.setdiff1d` to match NumPy naming.
40* `tf.inv` has been renamed to be `tf.reciprocal` (component-wise reciprocal)
41 to avoid confusion with `np.inv` which is matrix inversion
42* tf.round now uses banker's rounding (round to even) semantics to match NumPy.
43* `tf.split` now takes arguments in a reversed order and with different
44 keywords. In particular, we now match NumPy order as
45 `tf.split(value, num_or_size_splits, axis)`.
46* `tf.sparse_split` now takes arguments in reversed order and with different
47 keywords. In particular we now match NumPy order as
48 `tf.sparse_split(sp_input, num_split, axis)`. NOTE: we have temporarily
49 made `tf.sparse_split` require keyword arguments.
A. Unique TensorFlowerbfff0a52016-12-13 23:01:32 -080050* Deprecated `tf.concat` operator. Please switch to use `tf.concat_v2` for now.
51 In the Beta release, we will update `tf.concat` to match argument order of
52 `tf.concat_v2.
Andrew Harp1cb96892016-12-08 20:05:49 -080053
54# Release 0.12.0
55
56## Major Features and Improvements
57
58* TensorFlow now builds and runs on Microsoft Windows (tested on Windows 10,
59 Windows 7, and Windows Server 2016). Supported languages include Python (via a
60 pip package) and C++. CUDA 8.0 and cuDNN 5.1 are supported for GPU
61 acceleration. Known limitations include: It is not currently possible to load
62 a custom op library. The GCS and HDFS file systems are not currently
63 supported. The following ops are not currently implemented:
64 DepthwiseConv2dNative, DepthwiseConv2dNativeBackpropFilter,
65 DepthwiseConv2dNativeBackpropInput, Dequantize, Digamma, Erf, Erfc, Igamma,
66 Igammac, Lgamma, Polygamma, QuantizeAndDequantize, QuantizedAvgPool,
67 QuantizedBatchNomWithGlobalNormalization, QuantizedBiasAdd, QuantizedConcat,
68 QuantizedConv2D, QuantizedMatmul, QuantizedMaxPool,
69 QuantizeDownAndShrinkRange, QuantizedRelu, QuantizedRelu6, QuantizedReshape,
70 QuantizeV2, RequantizationRange, and Requantize.
71* Go: Experimental API in Go to create and execute graphs
72 (https://godoc.org/github.com/tensorflow/tensorflow/tensorflow/go)
73* New checkpoint format becomes the default in `tf.train.Saver`. Old V1
74 checkpoints continue to be readable; controlled by the `write_version`
75 argument, `tf.train.Saver` now by default writes out in the new V2
76 format. It significantly reduces the peak memory required and latency
77 incurred during restore.
78* Added a new library for library of matrix-free (iterative) solvers for linear
79 equations, linear least-squares, eigenvalues and singular values in
80 tensorflow/contrib/solvers. Initial version has lanczos bidiagonalization,
81 conjugate gradients and CGLS.
82* Added gradients for `matrix_solve_ls` and `self_adjoint_eig`.
83* Large cleanup to add second order gradient for ops with C++ gradients and
84 improve existing gradients such that most ops can now be differentiated
85 multiple times.
86* Added a solver for ordinary differential equations,
87 `tf.contrib.integrate.odeint`.
88* New contrib module for tensors with named axes, `tf.contrib.labeled_tensor`.
89* Visualization of embeddings in TensorBoard.
90
91## Breaking Changes to the API
92
A. Unique TensorFlower79228c72016-10-19 16:25:46 -080093* `BusAdjacency` enum replaced with a protocol buffer `DeviceLocality`. PCI bus
Andrew Harp1cb96892016-12-08 20:05:49 -080094 indexing now starts from 1 instead of 0, and bus_id==0 is used where
95 previously BUS_ANY was used.
Jonathan Hseu879e0ac2016-11-04 11:53:50 -080096* `Env::FileExists` and `FileSystem::FileExists` now return a tensorflow::Status
97 intead of a bool. Any callers to this function can be converted to a bool
98 by adding .ok() to the call.
Asim Shankare580e722016-11-09 08:21:50 -080099* The C API type `TF_SessionWithGraph` has been renamed to `TF_Session`,
100 indicating its preferred use in language bindings for TensorFlow.
101 What was previously `TF_Session` has been renamed to `TF_DeprecatedSession`.
Jonathan Hseu8f6cb222016-11-16 14:11:44 -0800102* Renamed TF_Port to TF_Output in the C API.
Andrew Harp1cb96892016-12-08 20:05:49 -0800103* Removes RegisterShape from public API. Use C++ shape function registration instead.
104 indexing now starts from 1 instead of 0, and `bus_id==0` is used where
105 previously `BUS_ANY` was used.
Eugene Brevdo7a7c1eb2016-11-29 09:38:37 -0800106* Most RNN cells and RNN functions now use different variable scopes to be
107 consistent with layers (`tf.contrib.layers`). This means old checkpoints
108 written using this code will not load after this change without providing
109 `Saver` a list of variable renames. Examples of variable scope changes
110 include `RNN` -> `rnn` in `tf.nn.rnn`, `tf.nn.dynamic_rnn` and moving from
111 `Linear/Matrix` -> `weights` and `Linear/Bias` -> `biases` in most RNN cells.
A. Unique TensorFlowerfe558b02016-11-30 11:51:57 -0800112* Deprecated tf.select op. tf.where should be used instead.
Martin Wickea7cd5f62016-12-14 15:22:55 -0800113* `SparseTensor.shape` has been renamed to `SparseTensor.dense_shape`. Same for
114 `SparseTensorValue.shape`.
Andrew Harp1cb96892016-12-08 20:05:49 -0800115* `Env::FileExists` and `FileSystem::FileExists` now return a
116 `tensorflow::Status` intead of a bool. Any callers to this function can be
117 converted to a bool by adding `.ok()` to the call.
118* C API: Type `TF_SessionWithGraph` has been renamed to `TF_Session`, indicating
119 its preferred use in language bindings for TensorFlow. What was previously
120 `TF_Session` has been renamed to `TF_DeprecatedSession`.
121* C API: Renamed `TF_Port` to `TF_Output`.
122* C API: The caller retains ownership of `TF_Tensor` objects provided to
123 `TF_Run`, `TF_SessionRun`, `TF_SetAttrTensor` etc.
124* Renamed `tf.image.per_image_whitening()` to
125 `tf.image.per_image_standardization()`
126* Move Summary protobuf constructors to `tf.summary` submodule.
127* Deprecate `histogram_summary`, `audio_summary`, `scalar_summary`,
128 `image_summary`, `merge_summary`, and `merge_all_summaries`.
129* Combined `batch_*` and regular version of linear algebra and FFT ops. The
130 regular op now handles batches as well. All `batch_*` Python interfaces were
131 removed.
132* `tf.all_variables`, `tf.VARIABLES` and `tf.initialize_all_variables` renamed
133 to `tf.global_variables`, `tf.GLOBAL_VARIABLES` and
134 `tf.global_variables_initializer` respectively.
135
136## Bug Fixes and Other Changes
137
138* Use threadsafe version of `lgamma` function.
139* Fix `tf.sqrt` handling of negative arguments.
140* Fixed bug causing incorrect number of threads to be used for multi-threaded
141 benchmarks.
142* Performance optimizations for `batch_matmul` on multi-core CPUs.
143* Improve trace, `matrix_set_diag`, `matrix_diag_part` and their gradients to
144 work for rectangular matrices.
145* Support for SVD of complex valued matrices.
146
147
148## Thanks to our Contributors
149
150This release contains contributions from many people at Google, as well as:
151
152@a7744hsc, Abhi Agg, @admcrae, Adriano Carmezim, Aki Sukegawa, Alex Kendall,
153Alexander Rosenberg Johansen, @amcrae, Amlan Kar, Andre Simpelo, Andreas Eberle,
154Andrew Hundt, Arnaud Lenglet, @b0noI, Balachander Ramachandran, Ben Barsdell,
155Ben Guidarelli, Benjamin Mularczyk, Burness Duan, @c0g, Changming Sun,
156@chanis, Corey Wharton, Dan J, Daniel Trebbien, Darren Garvey, David Brailovsky,
157David Jones, Di Zeng, @DjangoPeng, Dr. Kashif Rasul, @drag0, Fabrizio (Misto)
158Milo, FabríCio Ceschin, @fp, @Ghedeon, @guschmue, Gökçen Eraslan, Haosdent
159Huang, Haroen Viaene, Harold Cooper, Henrik Holst, @hoangmit, Ivan Ukhov, Javier
160Dehesa, Jingtian Peng, Jithin Odattu, Joan Pastor, Johan Mathe, Johannes Mayer,
161Jongwook Choi, Justus Schwabedal, Kai Wolf, Kamil Hryniewicz, Kamran Amini,
162Karen Brems, Karl Lattimer, @kborer, Ken Shirriff, Kevin Rose, Larissa Laich,
163Laurent Mazare, Leonard Lee, Liang-Chi Hsieh, Liangliang He, Luke Iwanski,
164Marek Kolodziej, Moustafa Alzantot, @MrQianjinsi, @nagachika, Neil Han, Nick
165Meehan, Niels Ole Salscheider, Nikhil Mishra, @nschuc, Ondrej Skopek, OndřEj
166Filip, @OscarDPan, Pablo Moyano, Przemyslaw Tredak, @qitaishui, @Quarazy,
167@raix852, Philipp Helo, Sam Abrahams, @SriramRamesh, Till Hoffmann, Tushar Soni,
168@tvn, @tyfkda, Uwe Schmidt, Victor Villas, Vit Stepanovs, Vladislav Gubarev,
169@wujingyue, Xuesong Yang, Yi Liu, Yilei Yang, @youyou3, Yuan (Terry) Tang,
170Yuming Wang, Zafar Takhirov, @zhongyuk, Ziming Dong, @guotong1988
171
172We are also grateful to all who filed issues or helped resolve them, asked and
173answered questions, and were part of inspiring discussions.
A. Unique TensorFlower79228c72016-10-19 16:25:46 -0800174
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800175# Release 0.11.0
Vijay Vasudevan2d0d1262016-08-08 14:06:20 -0800176
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800177## Major Features and Improvements
Vijay Vasudevan2d0d1262016-08-08 14:06:20 -0800178
Vijay Vasudevan818993c2016-11-03 17:07:01 -0800179* CUDA 8 support.
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800180* cuDNN 5 support.
181* HDFS Support.
182* Adds Fused LSTM support via cuDNN 5 in `tensorflow/contrib/cudnn_rnn`.
183* Improved support for NumPy style basic slicing including non-1 strides,
184 ellipses, newaxis, and negative indices. For example complicated expressions
185 like `foo[1, 2:4, tf.newaxis, ..., :-3:-1, :]` are now supported. In addition
186 we have preliminary (non-broadcasting) support for sliced assignment to
187 variables. In particular one can write `var[1:3].assign([1,11,111])`.
188* Deprecated `tf.op_scope` and `tf.variable_op_scope` in favor of a unified `tf.name_scope` and `tf.variable_scope`. The new argument order of `tf.variable_scope` is incompatible with previous versions.
189* Introducing `core/util/tensor_bundle` module: a module to efficiently
190 serialize/deserialize tensors to disk. Will be used in TF's new checkpoint
191 format.
192* Added tf.svd for computing the singular value decomposition (SVD) of dense
193 matrices or batches of matrices (CPU only).
194* Added gradients for eigenvalues and eigenvectors computed using
195 `self_adjoint_eig` or `self_adjoint_eigvals`.
196* Eliminated `batch_*` methods for most linear algebra and FFT ops and promoted
197 the non-batch version of the ops to handle batches of matrices.
198* Tracing/timeline support for distributed runtime (no GPU profiler yet).
199* C API gives access to inferred shapes with `TF_GraphGetTensorNumDims` and
200 `TF_GraphGetTensorShape`.
201* Shape functions for core ops have moved to C++ via
202 `REGISTER_OP(...).SetShapeFn(...)`. Python shape inference RegisterShape calls
203 use the C++ shape functions with `common_shapes.call_cpp_shape_fn`. A future
204 release will remove `RegisterShape` from python.
205
206
207## Bug Fixes and Other Changes
208
209* Documentation now includes operator overloads on Tensor and Variable.
210* `tensorflow.__git_version__` now allows users to identify the version of the
211 code that TensorFlow was compiled with. We also have
212 `tensorflow.__git_compiler__` which identifies the compiler used to compile
213 TensorFlow's core.
214* Improved multi-threaded performance of `batch_matmul`.
Eugene Brevdo21e1cc72016-08-11 21:45:39 -0800215* LSTMCell, BasicLSTMCell, and MultiRNNCell constructors now default to
216 `state_is_tuple=True`. For a quick fix while transitioning to the new
217 default, simply pass the argument `state_is_tuple=False`.
Vijay Vasudevan2d0d1262016-08-08 14:06:20 -0800218* DeviceFactory's AddDevices and CreateDevices functions now return
219 a Status instead of void.
A. Unique TensorFlower84cefad2016-08-12 07:06:13 -0800220* Int32 elements of list(type) arguments are no longer placed in host memory by
221 default. If necessary, a list(type) argument to a kernel can be placed in host
222 memory using a HostMemory annotation.
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800223* `uniform_unit_scaling_initializer()` no longer takes a `full_shape` arg,
224 instead relying on the partition info passed to the initializer function when
225 it's called.
226* The NodeDef protocol message is now defined in its own file `node_def.proto`
227 `instead of graph.proto`.
228* `ops.NoGradient` was renamed `ops.NotDifferentiable`. `ops.NoGradient` will
Vijay Vasudevan612bae72016-09-09 11:03:09 -0800229 be removed soon.
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800230* `dot.h` / DotGraph was removed (it was an early analysis tool prior
Vijay Vasudevan269bfee2016-09-21 21:41:19 -0800231 to TensorBoard, no longer that useful). It remains in history
232 should someone find the code useful.
Vijay Vasudevan914625a2016-09-23 13:51:34 -0800233* re2 / regexp.h was removed from being a public interface of TF.
234 Should users need regular expressions, they should depend on the RE2
235 library directly rather than via TensorFlow.
Dan Manée5bcf542016-05-16 13:39:34 -0800236
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800237## Thanks to our Contributors
238
239This release contains contributions from many people at Google, as well as:
240
241Abid K, @afshinrahimi, @AidanGG, Ajay Rao, Aki Sukegawa, Alex Rothberg,
242Alexander Rosenberg Johansen, Andrew Gibiansky, Andrew Thomas, @Appleholic,
243Bastiaan Quast, Ben Dilday, Bofu Chen, Brandon Amos, Bryon Gloden, Cissp®,
244@chanis, Chenyang Liu, Corey Wharton, Daeyun Shin, Daniel Julius Lasiman, Daniel
245Waterworth, Danijar Hafner, Darren Garvey, Denis Gorbachev, @DjangoPeng,
246Egor-Krivov, Elia Palme, Eric Platon, Fabrizio Milo, Gaetan Semet,
247Georg Nebehay, Gu Wang, Gustav Larsson, @haosdent, Harold Cooper, Hw-Zz,
248@ichuang, Igor Babuschkin, Igor Macedo Quintanilha, Ilya Edrenkin, @ironhead,
249Jakub Kolodziejczyk, Jennifer Guo, Jihun Choi, Jonas Rauber, Josh Bleecher
250Snyder, @jpangburn, Jules Gagnon-Marchand, Karen Brems, @kborer, Kirill Bobyrev,
251Laurent Mazare, Longqi Yang, Malith Yapa, Maniteja Nandana, Martin Englund,
252Matthias Winkelmann, @mecab, Mu-Ik Jeon, Nand Dalal, Niels Ole Salscheider,
253Nikhil Mishra, Park Jiin, Pieter De Rijk, @raix852, Ritwik Gupta, Sahil Sharma,
Patrick Nguyenc5ab3dd2016-10-20 12:09:18 -0800254Sangheum Hwang, @SergejsRk, Shinichiro Hamaji, Simon Denel, @Steve, @suiyuan2009,
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800255Tiago Jorge, Tijmen Tieleman, @tvn, @tyfkda, Wang Yang, Wei-Ting Kuo, Wenjian
256Huang, Yan Chen, @YenChenLin, Yuan (Terry) Tang, Yuncheng Li, Yunfeng Wang, Zack
257Polizzi, @zhongzyd, Ziming Dong, @perhapszzy
258
259We are also grateful to all who filed issues or helped resolve them, asked and
260answered questions, and were part of inspiring discussions.
261
A. Unique TensorFlowerabe9ab32016-07-31 22:07:30 -0800262# Release 0.10.0
A. Unique TensorFlower533d8912016-06-30 12:10:50 -0800263
A. Unique TensorFlowerabe9ab32016-07-31 22:07:30 -0800264## Major Features and Improvements
265
266* Added support for C++ shape inference
267* Added graph-construction C API
268* Major revision to the graph-construction C++ API
269* Support makefile build for iOS
270* Added Mac GPU support
271* Full version of TF-Slim available as `tf.contrib.slim`
272* Added k-Means clustering and WALS matrix factorization
273
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800274## Bug Fixes and Other Changes
A. Unique TensorFlowerabe9ab32016-07-31 22:07:30 -0800275
276* Allow gradient computation for scalar values.
277* Performance improvements for gRPC
278* Improved support for fp16
279* New high-level ops in tf.contrib.{layers,metrics}
280* New features for TensorBoard, such as shape display, exponential smoothing
281* Faster and more stable Google Cloud Storage (GCS) filesystem support
282* Support for zlib compression and decompression for TFRecordReader and TFRecordWriter
283* Support for reading (animated) GIFs
284* Improved support for SparseTensor
285* Added support for more probability distributions (Dirichlet, Beta, Bernoulli, etc.)
286* Added Python interfaces to reset resource containers.
287* Many bugfixes and performance improvements
288* Many documentation fixes
289
290## Thanks to our Contributors
291
292This release contains contributions from many people at Google, as well as:
293
294Alex Rothberg, Andrew Royer, Austin Marshall, @BlackCoal, Bob Adolf, Brian Diesel, Charles-Emmanuel Dias, @chemelnucfin, Chris Lesniewski, Daeyun Shin, Daniel Rodriguez, Danijar Hafner, Darcy Liu, Kristinn R. Thórisson, Daniel Castro, Dmitry Savintsev, Kashif Rasul, Dylan Paiton, Emmanuel T. Odeke, Ernest Grzybowski, Gavin Sherry, Gideon Dresdner, Gregory King, Harold Cooper, @heinzbeinz, Henry Saputra, Huarong Huo, Huazuo Gao, Igor Babuschkin, Igor Macedo Quintanilha, Ivan Ukhov, James Fysh, Jan Wilken Dörrie, Jihun Choi, Johnny Lim, Jonathan Raiman, Justin Francis, @lilac, Li Yi, Marc Khoury, Marco Marchesi, Max Melnick, Micael Carvalho, @mikowals, Mostafa Gazar, Nico Galoppo, Nishant Agrawal, Petr Janda, Yuncheng Li, @raix852, Robert Rose, @Robin-des-Bois, Rohit Girdhar, Sam Abrahams, satok16, Sergey Kishchenko, Sharkd Tu, @shotat, Siddharth Agrawal, Simon Denel, @sono-bfio, SunYeop Lee, Thijs Vogels, @tobegit3hub, @Undo1, Wang Yang, Wenjian Huang, Yaroslav Bulatov, Yuan Tang, Yunfeng Wang, Ziming Dong
295
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800296We are also grateful to all who filed issues or helped resolve them, asked and
297answered questions, and were part of inspiring discussions.
Vijay Vasudevan490afa92016-06-21 09:18:06 -0800298
299# Release 0.9.0
300
301## Major Features and Improvements
302
303* Python 3.5 support and binaries
304* Added iOS support
305* Added support for processing on GPUs on MacOS
306* Added makefile for better cross-platform build support (C API only)
307* fp16 support and improved complex128 support for many ops
308* Higher level functionality in contrib.{layers,losses,metrics,learn}
309* More features to Tensorboard
310* Improved support for string embedding and sparse features
311* The RNN api is finally "official" (see, e.g., `tf.nn.dynamic_rnn`,
312 `tf.nn.rnn`, and the classes in `tf.nn.rnn_cell`).
313* TensorBoard now has an Audio Dashboard, with associated audio summaries.
314
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800315## Bug Fixes and Other Changes
Vijay Vasudevan490afa92016-06-21 09:18:06 -0800316
317* Turned on CuDNN Autotune.
318* Added support for using third-party Python optimization algorithms (contrib.opt).
319* Google Cloud Storage filesystem support.
320* HDF5 support
321* Add support for 3d convolutions and pooling.
322* Update gRPC release to 0.14.
323* Eigen version upgrade.
324* Switch to eigen thread pool
325* `tf.nn.moments()` now accepts a `shift` argument. Shifting by a good estimate
326 of the mean improves numerical stability. Also changes the behavior of the
327 `shift` argument to `tf.nn.sufficient_statistics()`.
328* Performance improvements
329* Many bugfixes
330* Many documentation fixes
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800331* TensorBoard fixes: graphs with only one data point, Nan values,
332 reload button and auto-reload, tooltips in scalar charts, run
Vijay Vasudevan490afa92016-06-21 09:18:06 -0800333 filtering, stable colors
334* Tensorboard graph visualizer now supports run metadata. Clicking on nodes
335 while viewing a stats for a particular run will show runtime statistics, such
336 as memory or compute usage. Unused nodes will be faded out.
337
338## Thanks to our Contributors
339
340This release contains contributions from many people at Google, as well as:
341
A. Unique TensorFlowerabe9ab32016-07-31 22:07:30 -0800342Aaron Schumacher, Aidan Dang, Akihiko ITOH, Aki Sukegawa, Arbit Chen, Aziz Alto, Danijar Hafner, Erik Erwitt, Fabrizio Milo, Felix Maximilian Möller, Henry Saputra, Sung Kim, Igor Babuschkin, Jan Zikes, Jeremy Barnes, Jesper Steen Møller, Johannes Mayer, Justin Harris, Kashif Rasul, Kevin Robinson, Loo Rong Jie, Lucas Moura, Łukasz Bieniasz-Krzywiec, Mario Cho, Maxim Grechkin, Michael Heilman, Mostafa Rahmani, Mourad Mourafiq, @ninotoshi, Orion Reblitz-Richardson, Yuncheng Li, @raoqiyu, Robert DiPietro, Sam Abrahams, Sebastian Raschka, Siddharth Agrawal, @snakecharmer1024, Stephen Roller, Sung Kim, SunYeop Lee, Thijs Vogels, Till Hoffmann, Victor Melo, Ville Kallioniemi, Waleed Abdulla, Wenjian Huang, Yaroslav Bulatov, Yeison Rodriguez, Yuan Tang, Yuxin Wu, @zhongzyd, Ziming Dong, Zohar Jackson
Vijay Vasudevan490afa92016-06-21 09:18:06 -0800343
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800344We are also grateful to all who filed issues or helped resolve them, asked and
345answered questions, and were part of inspiring discussions.
Vijay Vasudevan490afa92016-06-21 09:18:06 -0800346
Illia Polosukhin5c9bc512016-04-18 17:56:51 -0800347# Release 0.8.0
348
349## Major Features and Improvements
350
351* Added a distributed runtime using GRPC
352* Move skflow to `contrib/learn`
353* Better linear optimizer in `contrib/linear_optimizer`
354* Random forest implementation in `contrib/tensor_forest`
355* CTC loss and decoders in `contrib/ctc`
356* Basic support for `half` data type
357* Better support for loading user ops (see examples in `contrib/`)
358* Allow use of (non-blocking) Eigen threadpool with `TENSORFLOW_USE_EIGEN_THREADPOOL` define
359* Add an extension mechanism for adding network file system support
360* TensorBoard displays metadata stats (running time, memory usage and device used) and tensor shapes
361
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800362## Bug Fixes and Other Changes
Illia Polosukhin5c9bc512016-04-18 17:56:51 -0800363
364* Utility for inspecting checkpoints
365* Basic tracing and timeline support
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800366* Allow building against cuDNN 5 (not incl. RNN/LSTM support)
Illia Polosukhin5c9bc512016-04-18 17:56:51 -0800367* Added instructions and binaries for ProtoBuf library with fast serialization and without 64MB limit
368* Added special functions
Dan Mané54a71782016-09-09 16:07:46 -0800369* `bool`-strictness: Tensors have to be explicitly compared to `None`
Illia Polosukhin5c9bc512016-04-18 17:56:51 -0800370* Shape strictness: all fed values must have a shape that is compatible with the tensor they are replacing
371* Exposed `tf.while_loop` (deprecated `control_flow_ops.While`)
372* run() now takes RunOptions and RunMetadata, which enable timing stats
373* Fixed lots of potential overflow problems in op kernels
374* Various performance improvements, especially for RNNs and convolutions
375* Many bugfixes
376* Nightly builds, tutorial tests, many test improvements
377* New examples: transfer learning and deepdream ipython notebook
378* Added tutorials, many documentation fixes.
379
380## Thanks to our Contributors
381
382This release contains contributions from many people at Google, as well as:
383
A. Unique TensorFlowerabe9ab32016-07-31 22:07:30 -0800384Abhinav Upadhyay, Aggelos Avgerinos, Alan Wu, Alexander G. de G. Matthews, Aleksandr Yahnev, @amchercashin, Andy Kitchen, Aurelien Geron, Awni Hannun, @BanditCat, Bas Veeling, Cameron Chen, @cg31, Cheng-Lung Sung, Christopher Bonnett, Dan Becker, Dan Van Boxel, Daniel Golden, Danijar Hafner, Danny Goodman, Dave Decker, David Dao, David Kretch, Dongjoon Hyun, Dustin Dorroh, @e-lin, Eurico Doirado, Erik Erwitt, Fabrizio Milo, @gaohuazuo, Iblis Lin, Igor Babuschkin, Isaac Hodes, Isaac Turner, Iván Vallés, J Yegerlehner, Jack Zhang, James Wexler, Jan Zikes, Jay Young, Jeff Hodges, @jmtatsch, Johnny Lim, Jonas Meinertz Hansen, Kanit Wongsuphasawat, Kashif Rasul, Ken Shirriff, Kenneth Mitchner, Kenta Yonekura, Konrad Magnusson, Konstantin Lopuhin, @lahwran, @lekaha, @liyongsea, Lucas Adams, @makseq, Mandeep Singh, @manipopopo, Mark Amery, Memo Akten, Michael Heilman, Michael Peteuil, Nathan Daly, Nicolas Fauchereau, @ninotoshi, Olav Nymoen, @panmari, @papelita1234, Pedro Lopes, Pranav Sailesh Mani, RJ Ryan, Rob Culliton, Robert DiPietro, @ronrest, Sam Abrahams, Sarath Shekkizhar, Scott Graham, Sebastian Raschka, Sung Kim, Surya Bhupatiraju, Syed Ahmed, Till Hoffmann, @timsl, @urimend, @vesnica, Vlad Frolov, Vlad Zagorodniy, Wei-Ting Kuo, Wenjian Huang, William Dmitri Breaden Madden, Wladimir Schmidt, Yuan Tang, Yuwen Yan, Yuxin Wu, Yuya Kusakabe, @zhongzyd, @znah.
Illia Polosukhin5c9bc512016-04-18 17:56:51 -0800385
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800386We are also grateful to all who filed issues or helped resolve them, asked and
387answered questions, and were part of inspiring discussions.
Illia Polosukhin5c9bc512016-04-18 17:56:51 -0800388
389
Eugene Brevdo56f1d642016-03-10 17:18:30 -0800390# Release 0.7.1
391
392## Bug Fixes and Other Changes
393
394* Added gfile.Open and gfile.Copy, used by input_data.py.
395* Fixed Saver bug when MakeDirs tried to create empty directory.
396* GPU Pip wheels are built with cuda 7.5 and cudnn-v4, making them
397 required for the binary releases. Lower versions of cuda/cudnn can
398 be supported by installing from sources and setting the options
399 during ./configure
400* Fix dataset encoding example for Python3 (@danijar)
401* Fix PIP installation by not packaging protobuf as part of wheel,
402 require protobuf 3.0.0b2.
403* Fix Mac pip installation of numpy by requiring pip >= 1.10.1.
404* Improvements and fixes to Docker image.
405
406
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800407# Release 0.7.0
Vijay Vasudevan10e62dc2015-12-11 23:03:16 -0800408
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800409## Major Features and Improvements
410
411* Allow using any installed Cuda >= 7.0 and cuDNN >= R2, and add support
412 for cuDNN R4
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800413* Added a `contrib/` directory for unsupported or experimental features,
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800414 including higher level `layers` module
415* Added an easy way to add and dynamically load user-defined ops
416* Built out a good suite of tests, things should break less!
417* Added `MetaGraphDef` which makes it easier to save graphs with metadata
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800418* Added assignments for "Deep Learning with TensorFlow" udacity course
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800419
420
421## Bug Fixes and Other Changes
422
423* Added a versioning framework for `GraphDef`s to ensure compatibility
424* Enforced Python 3 compatibility
425* Internal changes now show up as sensibly separated commits
426* Open-sourced the doc generator
427* Un-fork Eigen
428* Simplified the `BUILD` files and cleaned up C++ headers
429* TensorFlow can now be used as a submodule in another bazel build
430* New ops (e.g., `*fft`, `*_matrix_solve`)
431* Support for more data types in many ops
432* Performance improvements
433* Various bugfixes
434* Documentation fixes and improvements
435
436
437## Breaking Changes to the API
Vijay Vasudevan10e62dc2015-12-11 23:03:16 -0800438
439* `AdjustContrast` kernel deprecated, new kernel `AdjustContrastv2` takes and
440 outputs float only. `adjust_contrast` now takes all data types.
441* `adjust_brightness`'s `delta` argument is now always assumed to be in `[0,1]`
442 (as is the norm for images in floating point formats), independent of the
443 data type of the input image.
444* The image processing ops do not take `min` and `max` inputs any more, casting
445 safety is handled by `saturate_cast`, which makes sure over- and underflows
446 are handled before casting to data types with smaller ranges.
Geoffrey Irvingcbff45c2016-01-12 08:06:56 -0800447* For C++ API users: `IsLegacyScalar` and `IsLegacyVector` are now gone from
448 `TensorShapeUtils` since TensorFlow is scalar strict within Google (for
449 example, the shape argument to `tf.reshape` can't be a scalar anymore). The
450 open source release was already scalar strict, so outside Google `IsScalar`
451 and `IsVector` are exact replacements.
Josh Levenbergdb7478e2016-01-20 14:54:50 -0800452* The following files are being removed from `tensorflow/core/public/`:
453 * `env.h` -> `../platform/env.h`
454 * `status.h` -> `../lib/core/status.h`
455 * `tensor.h` -> `../framework/tensor.h`
456 * `tensor_shape.h` -> `../framework/tensor_shape.h`
457 * `partial_tensor_shape.h` -> `../framework/partial_tensor_shape.h`
458 * `tensorflow_server.h` deleted
Geoffrey Irving56437752016-01-25 09:43:13 -0800459* For C++ API users: `TensorShape::ShortDebugString` has been renamed to
460 `DebugString`, and the previous `DebugString` behavior is gone (it was
461 needlessly verbose and produced a confusing empty string for scalars).
Manjunath Kudlurc2722a12016-01-27 13:24:50 -0800462* `GraphOptions.skip_common_subexpression_elimination` has been removed. All
463 graph optimizer options are now specified via
464 `GraphOptions.OptimizerOptions`.
Geoffrey Irving18297122016-02-10 11:48:34 -0800465* `ASSERT_OK` / `EXPECT_OK` macros conflicted with external projects, so they
466 were renamed `TF_ASSERT_OK`, `TF_EXPECT_OK`. The existing macros are
467 currently maintained for short-term compatibility but will be removed.
Eugene Brevdofea55e12016-01-27 14:54:54 -0800468* The non-public `nn.rnn` and the various `nn.seq2seq` methods now return
469 just the final state instead of the list of all states.
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800470* `tf.scatter_update` now no longer guarantees that lexicographically largest
471 index be used for update when duplicate entries exist.
Geoffrey Irving3e33d442016-02-08 12:02:44 -0800472* `tf.image.random_crop(image, [height, width])` is now
473 `tf.random_crop(image, [height, width, depth])`, and `tf.random_crop` works
474 for any rank (not just 3-D images). The C++ `RandomCrop` op has been replaced
475 with pure Python.
Geoffrey Irving18297122016-02-10 11:48:34 -0800476* Renamed `tf.test.GetTempDir` and `tf.test.IsBuiltWithCuda` to
477 `tf.test.get_temp_dir` and `tf.test.is_built_with_cuda` for PEP-8
478 compatibility.
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800479* `parse_example`'s interface has changed, the old interface is accessible in
480 `legacy_parse_example` (same for related functions).
481* New `Variable`s are not added to the same collection several times even if
482 a list with duplicates is passed to the constructor.
Josh Levenberg02dff6d2016-01-07 18:37:54 -0800483* The Python API will now properly set the `list` member of `AttrValue` in
484 constructed `GraphDef` messages for empty lists. The serialization of some
485 graphs will change, but the change is both forwards and backwards compatible.
486 It will break tests that compare a generated `GraphDef` to a golden serialized
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800487 `GraphDef` (which is discouraged).
488
489
490## Thanks to our Contributors
491
492This release contains contributions from many people at Google, as well as:
493
494Akiomi Kamakura, Alex Vig, Alexander Rosenberg Johansen, Andre Cruz, Arun Ahuja,
495Bart Coppens, Bernardo Pires, Carl Vondrick, Cesar Salgado, Chen Yu,
496Christian Jauvin, Damien Aymeric, Dan Vanderkam, Denny Britz, Dongjoon Hyun,
497Eren Güven, Erik Erwitt, Fabrizio Milo, G. Hussain Chinoy, Jim Fleming,
498Joao Felipe Santos, Jonas Meinertz Hansen, Joshi Rekha, Julian Viereck,
499Keiji Ariyama, Kenton Lee, Krishna Sankar, Kristina Chodorow, Linchao Zhu,
500Lukas Krecan, Mark Borgerding, Mark Daoust, Moussa Taifi,
501Nathan Howell, Naveen Sundar Govindarajulu, Nick Sweeting, Niklas Riekenbrauck,
502Olivier Grisel, Patrick Christ, Povilas Liubauskas, Rainer Wasserfuhr,
503Romain Thouvenin, Sagan Bolliger, Sam Abrahams, Taehoon Kim, Timothy J Laurent,
504Vlad Zavidovych, Yangqing Jia, Yi-Lin Juang, Yuxin Wu, Zachary Lipton,
505Zero Chen, Alan Wu, @brchiu, @emmjaykay, @jalammar, @Mandar-Shinde,
506@nsipplswezey, @ninotoshi, @panmari, @prolearner and @rizzomichaelg.
507
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800508We are also grateful to all who filed issues or helped resolve them, asked and
509answered questions, and were part of inspiring discussions.
Josh Levenberg02dff6d2016-01-07 18:37:54 -0800510
Geoffrey Irvingcbff45c2016-01-12 08:06:56 -0800511
Vijay Vasudevan2c3738d2015-12-08 14:55:13 -0800512# Release 0.6.0
513
514## Major Features and Improvements
515
516* Python 3.3+ support via changes to python codebase and ability
517 to specify python version via ./configure.
518
519* Some improvements to GPU performance and memory usage:
520 [convnet benchmarks](https://github.com/soumith/convnet-benchmarks/issues/66)
521 roughly equivalent with native cudnn v2 performance. Improvements mostly due
522 to moving to 32-bit indices, faster shuffling kernels. More improvements to
523 come in later releases.
524
525
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800526## Bug Fixes
Vijay Vasudevan2c3738d2015-12-08 14:55:13 -0800527
528* Lots of fixes to documentation and tutorials, many contributed
529 by the public.
530
531* 271 closed issues on github issues.
532
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800533## Backwards-Incompatible Changes
Vijay Vasudevan2c3738d2015-12-08 14:55:13 -0800534
Geoffrey Irving18297122016-02-10 11:48:34 -0800535* `tf.nn.fixed_unigram_candidate_sampler` changed its default 'distortion'
Vijay Vasudevan2c3738d2015-12-08 14:55:13 -0800536 attribute from 0.0 to 1.0. This was a bug in the original release
537 that is now fixed.
538
Vijay Vasudevanddd4aaf2015-12-08 09:58:59 -0800539# Release 0.5.0
540
541Initial release of TensorFlow.