blob: 6087390c9c714bf800245433826e984a7e2187c7 [file] [log] [blame] [view]
Derek Murray4e69ce82017-04-11 10:31:27 -08001# Changes since the last release
2
3## Major Features and Improvements
4* Added `tf.Session.make_callable()`, which provides a lower overhead means of running a similar step multiple times.
Jonathan Hseue8082d52017-04-20 09:34:42 -08005* Added ibverbs-based RDMA support to contrib (courtesy @junshi15 from Yahoo).
Eugene Brevdoe8482ab2017-04-21 16:34:59 -08006* `RNNCell` objects now subclass `tf.layers._Layer`. The strictness described
7 in the TensorFlow 1.1 release is gone: The first time an RNNCell is used,
8 it caches its scope. All future uses of the RNNCell will reuse variables from
9 that same scope. This is a breaking change from the behavior of RNNCells
10 in TensorFlow versions <= 1.0.1. TensorFlow 1.1 had checks in place to
11 ensure old code works correctly with the new semantics; this version
12 allows more flexible uses of RNNCell but can lead to subtle errors if
13 using code meant for TensorFlow <= 1.0.1. For example, writing:
14 `MultiRNNCell([lstm] * 5)` will now build a 5-layer LSTM stack where each
15 layer shares the **same** parameters. To get 5 layers each with their own
16 parameters, write: `MultiRNNCell([LSTMCell(...) for _ in range(5)])`.
17 If at all unsure, first test your code with TF 1.1; ensure it raises no
18 errors, and then upgrade to TF 1.2.
Derek Murray4e69ce82017-04-11 10:31:27 -080019
20
A. Unique TensorFlowerccbc8992017-04-04 16:10:08 -080021# Release 1.1.0
22
23## Major Features and Improvements
24* Added Java API support for Windows.
25* Added `tf.spectral` module. Moved existing FFT ops to `tf.spectral` while
26 keeping an alias in the old location (`tf.*`).
27* Added 1D, 2D and 3D Fourier transform ops for real signals to `tf.spectral`.
28* Added a `tf.bincount` function.
29* Added Keras 2 API to contrib.
30* Added a new lightweight queue-like object - `RecordInput`.
31* Added `tf.contrib.image.compose_transforms` function.
32* Bring `tf.estimator.*` into the API. Non-deprecated functionality from `tf.contrib.learn.Estimator` is moved to `tf.estimator.Estimator` with cosmetic changes.
33* Docker images: TF images on gcr.io and Docker Hub are upgraded to ubuntu:16.04.
34* Added the following features to TensorFlow Debugger (tfdbg):
35 * Ability to inspect Python source file against TF ops and tensors (command `print_source` / `ps`)
36 * New navigation bar in Curses-based UI
37 * NodeStepper (command `invoke_stepper`) now uses intermediate tensor dumps. It also uses `TensorHandles` as direct feeds during successive `cont` calls for improved performance and reduced memory consumption.
Rohan Jaind0697152017-04-07 08:29:08 -080038* Initial release of installation guides for Java, C, and Go.
A. Unique TensorFlowerccbc8992017-04-04 16:10:08 -080039
40## Deprecations
41
42* TensorFlow 1.1.0 will be the last time we release a binary with Mac GPU support. Going forward, we will stop testing on Mac GPU systems. We continue to welcome patches that maintain Mac GPU support, and we will try to keep the Mac GPU build working.
43
44## Changes to contrib APIs
45* The behavior of RNNCells is now stricter due to the transition towards making RNNCells act more like Keras layers.
46 * If an RNNCell is used twice in two different variable scopes, an error is raised describing how to avoid this behavior.
47 * If an RNNCell is used in a variable scope with existing conflicting variables, an error is raised showing that the RNNCell must be constructed with argument `reuse=True`.
48* Deprecated contrib/distributions `pmf`, `pdf`, `log_pmf`, `log_pdf`.
49* Moved `bayesflow.special_math` to distributions.
50* `tf.contrib.tensor_forest.python.tensor_forest.RandomForestDeviceAssigner` removed.
51* Changed some MVN classes and parameters:
52 * `tf.contrib.distributions.MultivariateNormalFull` replaced by `tf.contrib.distributions.MultivariateNormalTriL`.
53 * `tf.contrib.distributions.MultivariateNormalCholesky` replaced by `tf.contrib.distributions.MultivariateNormalTriL`
54 * `tf.contrib.distributions.MultivariateNormalDiagWithSoftplusStDev` replaced
55 by `tf.contrib.distributions.MultivariateNormalDiagWithSoftplusScale`
56 * `tf.contrib.distributions.MultivariateNormalDiag` arguments changed from `mu`, `diag_stddev` to `log`, `scale_diag`.
57 * `tf.contrib.distributions.MultivariateNormalDiagPlusVDVT` removed.
58 * `tf.contrib.distributions.MultivariateNormalDiagPlusLowRank` added.
59
60## Bug Fixes and Other Changes
61* Java: Support for loading models exported using the SavedModel API (courtesy @EronWright).
62* Go: Added support for incremental graph execution.
63* Fix a bug in the WALS solver when single-threaded.
64* Added support for integer sparse feature values in `tf.contrib.layers.sparse_column_with_keys`.
65* Fixed `tf.set_random_seed(0)` to be deterministic for all ops.
66* Stability improvements for the GCS file system support.
67* Improved TensorForest performance.
68* Added support for multiple filename globs in `tf.matching_files`.
69* `LogMessage` now includes a timestamp as beginning of a message.
70* Added MultiBox person detector example standalone binary.
71* Android demo: Makefile build functionality added to build.gradle to fully support building TensorFlow demo in Android on Windows.
72* Android demo: read MultiBox priors from txt file rather than protobuf.
73* Added colocation constraints to `StagingArea`.
74* `sparse_matmul_op` reenabled for Android builds.
75* Restrict weights rank to be the same as the broadcast target, to avoid ambiguity on broadcast rules.
76* Upgraded libxsmm to 1.7.1 and applied other changes for performance and memory usage.
77* Fixed bfloat16 integration of LIBXSMM sparse mat-mul.
78* Improved performance and reduce memory usage by allowing ops to forward input buffers to output buffers and perform computations in-place.
79* Improved the performance of CPU assignment for strings.
80* Speed up matrix * vector multiplication and matrix * matrix with unknown shapes.
81* C API: Graph imports now support input remapping, control dependencies, and returning imported nodes (see `TF_GraphImportGraphDefWithReturnOutputs()`)
82* Multiple C++ API updates.
83* Multiple TensorBoard updates including:
84 * Users can now view image summaries at various sampled steps (instead of just the last step).
85 * Bugs involving switching runs as well as the image dashboard are fixed.
86 * Removed data download links from TensorBoard.
87 * TensorBoard uses a relative data directory, for easier embedding.
88 * TensorBoard automatically ignores outliers for domain calculation, and formats proportional values consistently.
89* Multiple tfdbg bug fixes:
90 * Fixed Windows compatibility issues.
91 * Command history now persists across runs.
Rohan Jaind0697152017-04-07 08:29:08 -080092 * Bug fix in graph validation related to `tf.while_loops`.
93* Java Maven fixes for bugs with Windows installation.
A. Unique TensorFlowerccbc8992017-04-04 16:10:08 -080094
95## Thanks to our Contributors
96
97This release contains contributions from many people at Google, as well as:
98
99A. Besir Kurtulmus, Adal Chiriliuc, @akash, Alec-Desouza, Alex Rothberg, Alex
Rohan Jaind0697152017-04-07 08:29:08 -0800100Sergeev, Alexander Heinecke, Allen Guo, Andreas Madsen, Ankesh Anand, Anton
A. Unique TensorFlowerccbc8992017-04-04 16:10:08 -0800101Loss, @Aravind, @Arie, Ashutosh Das, AuréLien Geron, Bairen Yi, @bakunyo, Ben
Rohan Jaind0697152017-04-07 08:29:08 -0800102Visser, Brady Zhou, Calpa Liu, Changming Sun, Chih Cheng Liang, Christopher
103Berner, Clark Zinzow, @Conchylicultor, Dan Ellis, Dan J, Dan Jarvis, Daniel
104Ylitalo, Darren Garvey, David Norman, David Truong, @DavidNorman, Dimitar
105Pavlov, Dmitry Persiyanov, @Eddie, @elirex, Erfan Noury, Eron Wright, Evgeny
106Mazovetskiy, Fabrizio (Misto) Milo, @fanlu, Fisher Coder, Florian Courtial,
107Franck Dernoncourt, Gagan Goel, Gao, Xiang, @Gautam, Gefu Tang, @guilherme,
108@guschmue, Hannah Provenza, Hans Pabst, @hartb, Hsiao Yi, Huazuo Gao, Igor
109ChorążEwicz, Ivan Smirnov, Jakub Kolodziejczyk, Jason Gavris, Jason Morton, Jay
110Young, Jayaram Bobba, Jeremy Sawruk, Jiaming Liu, Jihun Choi, @jiqiu, Joan Thibault,
111John C F, Jojy George Varghese, Jon Malmaud, Julian Berman, Julian Niedermeier,
112Junpeng Lao, Kai Sasaki, @Kankroc, Karl Lessard, Kyle Bostelmann, @Lezcano, Li
113Yi, Luo Yun, @lurker, Mahmoud-Abuzaina, Mandeep Singh, Marek Kolodziej, Mark
114Szepieniec, Martial Hue, Medhat Omr, Memo Akten, Michael Gharbi, MichaëL Defferrard,
115Milan Straka, @MircoT, @mlucool, Muammar Ibn Faisal, Nayana Thorat, @nghiattran,
116Nicholas Connor, Nikolaas Steenbergen, Niraj Patel, Niranjan Hasabnis, @Panmari,
117Pavel Bulanov, Philip Pries Henningsen, Philipp Jund, @polonez, Prayag Verma, Rahul
118Kavi, Raphael Gontijo Lopes, @rasbt, Raven Iqqe, Reid Pryzant, Richard Shin, Rizwan
119Asif, Russell Kaplan, Ryo Asakura, RüDiger Busche, Saisai Shao, Sam Abrahams, @sanosay,
120Sean Papay, @seaotterman, @selay01, Shaurya Sharma, Sriram Narayanamoorthy, Stefano
121Probst, @taknevski, @tbonza, @teldridge11, Tim Anglade, Tomas Reimers, Tomer Gafner,
122Valentin Iovene, Vamsi Sripathi, Viktor Malyi, Vit Stepanovs, Vivek Rane, Vlad Firoiu,
123@wangg12, @will, Xiaoyu Tao, Yaroslav Bulatov, Yi Liu, Yuan (Terry) Tang, @Yufeng,
124Yuming Wang, Yuxin Wu, Zafar Takhirov, Ziming Dong
A. Unique TensorFlowerccbc8992017-04-04 16:10:08 -0800125
126We are also grateful to all who filed issues or helped resolve them, asked and
127answered questions, and were part of inspiring discussions.
128
129
Martin Wickebc456e32017-03-23 12:31:16 -0800130# Release 1.0.1
131
132## Bug Fixes and Other Changes
133* Change GraphConstructor to not increase the version when importing, but instead take the min of all versions.
134* Google Cloud Storage fixes.
135* Removed `tf.core` and `tf.python` modules from the API. These were never intended to be exposed. Please use the same objects through top-level `tf` module instead.
136
Benoit Steiner639b4e72017-02-08 09:25:09 -0800137# Release 1.0.0
138
139## Major Features and Improvements
140* XLA (experimental): initial release of [XLA](https://www.tensorflow.org/versions/master/experimental/xla/), a domain-specific compiler for TensorFlow graphs, that targets CPUs and GPUs.
141* TensorFlow Debugger (tfdbg): command-line interface and API.
142* New python 3 docker images added.
143* Made pip packages pypi compliant. TensorFlow can now be installed by `pip
144 install tensorflow` command.
145* Several python API calls have been changed to resemble NumPy more closely.
146* Android: person detection + tracking demo implementing Scalable Object
147 Detection using Deep Neural Networks.
148* New (experimental) [Java API](https://github.com/tensorflow/tensorflow/tree/master/tensorflow/java).
149* Add new Android image stylization demo based on "A Learned Representation For Artistic Style", and add YOLO object detector support.
A. Unique TensorFlower79228c72016-10-19 16:25:46 -0800150
151## Breaking Changes to the API
Benoit Steiner639b4e72017-02-08 09:25:09 -0800152To help you upgrade your existing TensorFlow Python code to match the API changes below, we have prepared a [conversion script](https://github.com/tensorflow/tensorflow/tree/master/tensorflow/tools/compatibility).
153* TensorFlow/models have been moved to a separate github repository.
Andrew Sellefcc39232016-11-22 10:04:37 -0800154* Division and modulus operators (/, //, %) now match Python (flooring)
Andrew Sellef0a6d1e2016-12-13 16:01:12 -0800155 semantics. This applies to `tf.div` and `tf.mod` as well. To obtain forced
156 integer truncation based behaviors you can use `tf.truncatediv`
157 and `tf.truncatemod`.
158* `tf.divide()` is now the recommended division function. `tf.div()` will
159 remain, but its semantics do not respond to Python 3 or `from future`
160 mechanisms.
161* tf.reverse() now takes indices of axes to be reversed. E.g.
162 `tf.reverse(a, [True, False, True])` must now be written as
163 `tf.reverse(a, [0, 2])`. `tf.reverse_v2()` will remain until 1.0 final.
164* `tf.mul`, `tf.sub` and `tf.neg` are deprecated in favor of `tf.multiply`,
165 `tf.subtract` and `tf.negative`.
A. Unique TensorFlower44977ae2016-12-15 18:36:06 -0800166* `tf.pack` and `tf.unpack` are deprecated in favor of `tf.stack` and
167 `tf.unstack`.
168* `TensorArray.pack` and `TensorArray.unpack` are getting deprecated in favor of
169 `TensorArray.stack` and `TensorArray.unstack`.
Andrew Sellef0a6d1e2016-12-13 16:01:12 -0800170* The following Python functions have had their arguments changed to use `axis`
171 when referring to specific dimensions. We have kept the old keyword arguments
172 for compatibility currently, but we will be removing them well before the
173 final 1.0.
174 * `tf.argmax`: `dimension` becomes `axis`
175 * `tf.argmin`: `dimension` becomes `axis`
176 * `tf.count_nonzero`: `reduction_indices` becomes `axis`
177 * `tf.expand_dims`: `dim` becomes `axis`
178 * `tf.reduce_all`: `reduction_indices` becomes `axis`
179 * `tf.reduce_any`: `reduction_indices` becomes `axis`
180 * `tf.reduce_join`: `reduction_indices` becomes `axis`
181 * `tf.reduce_logsumexp`: `reduction_indices` becomes `axis`
182 * `tf.reduce_max`: `reduction_indices` becomes `axis`
183 * `tf.reduce_mean`: `reduction_indices` becomes `axis`
184 * `tf.reduce_min`: `reduction_indices` becomes `axis`
185 * `tf.reduce_prod`: `reduction_indices` becomes `axis`
186 * `tf.reduce_sum`: `reduction_indices` becomes `axis`
187 * `tf.reverse_sequence`: `batch_dim` becomes `batch_axis`, `seq_dim` becomes `seq_axis`
188 * `tf.sparse_concat`: `concat_dim` becomes `axis`
189 * `tf.sparse_reduce_sum`: `reduction_axes` becomes `axis`
190 * `tf.sparse_reduce_sum_sparse`: `reduction_axes` becomes `axis`
191 * `tf.sparse_split`: `split_dim` becomes `axis`
192* `tf.listdiff` has been renamed to `tf.setdiff1d` to match NumPy naming.
193* `tf.inv` has been renamed to be `tf.reciprocal` (component-wise reciprocal)
194 to avoid confusion with `np.inv` which is matrix inversion
195* tf.round now uses banker's rounding (round to even) semantics to match NumPy.
196* `tf.split` now takes arguments in a reversed order and with different
197 keywords. In particular, we now match NumPy order as
198 `tf.split(value, num_or_size_splits, axis)`.
199* `tf.sparse_split` now takes arguments in reversed order and with different
200 keywords. In particular we now match NumPy order as
201 `tf.sparse_split(sp_input, num_split, axis)`. NOTE: we have temporarily
202 made `tf.sparse_split` require keyword arguments.
Benoit Steiner639b4e72017-02-08 09:25:09 -0800203* `tf.concat` now takes arguments in reversed order and with different keywords. In particular we now match NumPy order as `tf.concat(values, axis, name)`.
204* `tf.image.decode_jpeg` by default uses the faster DCT method, sacrificing
Vijay Vasudevanfebdc1d2016-12-19 21:04:00 -0800205 a little fidelity for improved speed. One can revert to the old
Benoit Steiner639b4e72017-02-08 09:25:09 -0800206 behavior by specifying the attribute `dct_method='INTEGER_ACCURATE'`.
A. Unique TensorFloweredb095c2016-12-20 14:37:03 -0800207* `tf.complex_abs` has been removed from the Python interface. `tf.abs`
208 supports complex tensors and should be used instead.
A. Unique TensorFlowerfac4a352017-01-20 13:14:02 -0800209* In the C++ API (in tensorflow/cc), Input, Output, etc. have moved
210 from the tensorflow::ops namespace to tensorflow.
Benoit Steiner639b4e72017-02-08 09:25:09 -0800211* Template.`var_scope` property renamed to `.variable_scope`
212* SyncReplicasOptimizer is removed and SyncReplicasOptimizerV2 renamed to SyncReplicasOptimizer.
213* `tf.zeros_initializer()` and `tf.ones_initializer()` now return a callable
214 that must be called with initializer arguments, in your code replace
215 `tf.zeros_initializer` with `tf.zeros_initializer()`.
216* `SparseTensor.shape` has been renamed to `SparseTensor.dense_shape`. Same for
217 `SparseTensorValue.shape`.
218* Replace tf.scalar_summary, tf.histogram_summary, tf.audio_summary, tf.image_summary with tf.summary.scalar, tf.summary.histogram, tf.summary.audio, tf.summary.image, respectively. The new summary ops take name rather than tag as their first argument, meaning summary ops now respect TensorFlow name scopes.
219* Replace tf.train.SummaryWriter and tf.train.SummaryWriterCache with tf.summary.FileWriter and tf.summary.FileWriterCache.
220* Removes RegisterShape from public API. Use C++ shape function registration
221 instead.
222* Deprecated `_ref` dtypes from the python API.
223* In the C++ API (in tensorflow/cc), Input, Output, etc. have moved
224 from the tensorflow::ops namespace to tensorflow.
225* Change arg order for `{softmax,sparse_softmax,sigmoid}_cross_entropy_with_logits` to be (labels, predictions), and force use of named args.
A. Unique TensorFlowerccbc8992017-04-04 16:10:08 -0800226* tf.nn.rnn_cell.* and most functions in tf.nn.rnn.* (with the exception of dynamic_rnn and raw_rnn) are temporarily in tf.contrib.rnn. They will be moved back into core for TF 1.2.
Martin Wickebc456e32017-03-23 12:31:16 -0800227* `tf.nn.sampled_softmax_loss` and `tf.nn.nce_loss` have both changed their API such that you need to switch the `inputs, labels` to `labels, inputs` parameters.
228* The shape keyword argument of the `SparseTensor` constructor changes its name to `dense_shape` between Tensorflow 0.12 and Tensorflow 1.0.
Benoit Steiner639b4e72017-02-08 09:25:09 -0800229
230## Bug Fixes and Other Changes
Andrew Harp3e975ea2017-03-01 17:59:22 -0800231* Numerous C++ API updates.
Benoit Steiner639b4e72017-02-08 09:25:09 -0800232* New op: `parallel_stack`.
233* Introducing common tf io compression options constants for
234 RecordReader/RecordWriter.
235* Add `sparse_column_with_vocabulary_file`, to specify a feature column that
236 transform string features to IDs, where the mapping is defined by a vocabulary
237 file.
238* Added `index_to_string_table` which returns a lookup table that maps indices to
239 strings.
240* Add `string_to_index_table`, which returns a lookup table that matches strings
241 to indices.
242* Add a `ParallelForWithWorkerId` function.
243* Add `string_to_index_table`, which returns a lookup table that matches strings
244 to indices.
245* Support restore session from checkpoint files in v2 in `contrib/session_bundle`.
246* Added a tf.contrib.image.rotate function for arbitrary angles.
247* Added `tf.contrib.framework.filter_variables` as a convenience function to
248 filter lists of variables based on regular expressions.
249* `make_template()` takes an optional `custom_getter_ param`.
250* Added comment about how existing directories are handled by
251 `recursive_create_dir`.
252* Added an op for QR factorizations.
253* Divides and mods in Python API now use flooring (Python) semantics.
254* Android: pre-built libs are now built nightly.
255* Android: cmake/gradle build for TensorFlow Inference library under
256 `contrib/android/cmake`
257* Android: Much more robust Session initialization code.
258* Android: TF stats now exposed directly in demo and log when debug mode is
259 active
260* Android: new/better README.md documentation
261* saved_model is available as `tf.saved_model`.
262* Empty op is now stateful.
263* Improve speed of scatter_update on the cpu for ASSIGN operations.
264* Change `reduce_join` to treat `reduction_indices` in the same way as other `reduce_` ops.
265* Move `TensorForestEstimator` to `contrib/tensor_forest`.
266* Enable compiler optimizations by default and allow configuration in configure.
267* `tf.divide` now honors the name field.
268* Make metrics weight broadcasting more strict.
269* Add new queue-like `StagingArea` and new ops: `stage` and `unstage`.
Andrew Harp3e975ea2017-03-01 17:59:22 -0800270* Enable inplace update ops for strings on CPU. Speed up string concat.
Benoit Steiner639b4e72017-02-08 09:25:09 -0800271
272## Thanks to our Contributors
273
274This release contains contributions from many people at Google, as well as:
275
276Aaron Hu, Abhishek Aggarwal, Adam Michael, Adriano Carmezim, @AfirSraftGarrier,
277Alexander Novikov, Alexander Rosenberg Johansen, Andrew Gibiansky, Andrew Hundt,
278Anish Shah, Anton Loss, @b0noI, @BoyuanJiang, Carl Thomé, Chad Kennedy, Comic
279Chang, Connor Braa, Daniel N. Lang, Daniel Trebbien,
280@danielgordon10, Darcy Liu, Darren Garvey, Dmitri Lapin, Eron Wright, Evan
281Cofer, Fabrizio Milo, Finbarr Timbers, Franck Dernoncourt, Garrett Smith,
282@guschmue, Hao Wei, Henrik Holst, Huazuo Gao, @Ian, @Issac, Jacob Israel,
283Jangsoo Park, Jin Kim, Jingtian Peng, John Pope, Kye Bostelmann, Liangliang He,
284Ling Zhang, Luheng He, Luke Iwanski, @lvli, Michael Basilyan, Mihir Patel,
285Mikalai Drabovich, Morten Just, @newge, Nick Butlin, Nishant Shukla,
286Pengfei Ni, Przemyslaw Tredak, @rasbt, @Ronny, Rudolf Rosa, @RustingSword,
287Sam Abrahams, Sam Putnam, @SeongAhJo, Shi Jiaxin, @skavulya, Steffen MüLler,
288@TheUSER123, @tiriplicamihai, @vhasanov, Victor Costan, Vit Stepanovs,
289Wangda Tan, Wenjian Huang, Xingdong Zuo, Yaroslav Bulatov, Yota Toyama,
290Yuan (Terry) Tang, Yuxin Wu
291
292We are also grateful to all who filed issues or helped resolve them, asked and
293answered questions, and were part of inspiring discussions.
294
Andrew Harp1cb96892016-12-08 20:05:49 -0800295
296# Release 0.12.0
297
298## Major Features and Improvements
299
300* TensorFlow now builds and runs on Microsoft Windows (tested on Windows 10,
301 Windows 7, and Windows Server 2016). Supported languages include Python (via a
302 pip package) and C++. CUDA 8.0 and cuDNN 5.1 are supported for GPU
303 acceleration. Known limitations include: It is not currently possible to load
304 a custom op library. The GCS and HDFS file systems are not currently
305 supported. The following ops are not currently implemented:
Martin Wicke2e4869a2016-12-14 15:46:53 -0800306 Dequantize, QuantizeAndDequantize, QuantizedAvgPool,
Andrew Harp1cb96892016-12-08 20:05:49 -0800307 QuantizedBatchNomWithGlobalNormalization, QuantizedBiasAdd, QuantizedConcat,
308 QuantizedConv2D, QuantizedMatmul, QuantizedMaxPool,
309 QuantizeDownAndShrinkRange, QuantizedRelu, QuantizedRelu6, QuantizedReshape,
310 QuantizeV2, RequantizationRange, and Requantize.
311* Go: Experimental API in Go to create and execute graphs
312 (https://godoc.org/github.com/tensorflow/tensorflow/tensorflow/go)
313* New checkpoint format becomes the default in `tf.train.Saver`. Old V1
314 checkpoints continue to be readable; controlled by the `write_version`
315 argument, `tf.train.Saver` now by default writes out in the new V2
316 format. It significantly reduces the peak memory required and latency
317 incurred during restore.
318* Added a new library for library of matrix-free (iterative) solvers for linear
319 equations, linear least-squares, eigenvalues and singular values in
320 tensorflow/contrib/solvers. Initial version has lanczos bidiagonalization,
321 conjugate gradients and CGLS.
322* Added gradients for `matrix_solve_ls` and `self_adjoint_eig`.
323* Large cleanup to add second order gradient for ops with C++ gradients and
324 improve existing gradients such that most ops can now be differentiated
325 multiple times.
326* Added a solver for ordinary differential equations,
327 `tf.contrib.integrate.odeint`.
328* New contrib module for tensors with named axes, `tf.contrib.labeled_tensor`.
329* Visualization of embeddings in TensorBoard.
330
331## Breaking Changes to the API
332
A. Unique TensorFlower79228c72016-10-19 16:25:46 -0800333* `BusAdjacency` enum replaced with a protocol buffer `DeviceLocality`. PCI bus
Benoit Steiner639b4e72017-02-08 09:25:09 -0800334 indexing now starts from 1 instead of 0, and `bus_id==0` is used where
335 previously `BUS_ANY` was used.
Jonathan Hseu879e0ac2016-11-04 11:53:50 -0800336* `Env::FileExists` and `FileSystem::FileExists` now return a tensorflow::Status
Vijay Vasudevan93a975e2017-02-17 17:05:49 -0800337 instead of a bool. Any callers to this function can be converted to a bool
Jonathan Hseu879e0ac2016-11-04 11:53:50 -0800338 by adding .ok() to the call.
Asim Shankare580e722016-11-09 08:21:50 -0800339* The C API type `TF_SessionWithGraph` has been renamed to `TF_Session`,
340 indicating its preferred use in language bindings for TensorFlow.
341 What was previously `TF_Session` has been renamed to `TF_DeprecatedSession`.
Benoit Steiner639b4e72017-02-08 09:25:09 -0800342* Renamed `TF_Port` to `TF_Output` in the C API.
Andrew Harp1cb96892016-12-08 20:05:49 -0800343* Removes RegisterShape from public API. Use C++ shape function registration instead.
344 indexing now starts from 1 instead of 0, and `bus_id==0` is used where
345 previously `BUS_ANY` was used.
Eugene Brevdo7a7c1eb2016-11-29 09:38:37 -0800346* Most RNN cells and RNN functions now use different variable scopes to be
347 consistent with layers (`tf.contrib.layers`). This means old checkpoints
348 written using this code will not load after this change without providing
349 `Saver` a list of variable renames. Examples of variable scope changes
350 include `RNN` -> `rnn` in `tf.nn.rnn`, `tf.nn.dynamic_rnn` and moving from
351 `Linear/Matrix` -> `weights` and `Linear/Bias` -> `biases` in most RNN cells.
A. Unique TensorFlowerfe558b02016-11-30 11:51:57 -0800352* Deprecated tf.select op. tf.where should be used instead.
Martin Wickea7cd5f62016-12-14 15:22:55 -0800353* `SparseTensor.shape` has been renamed to `SparseTensor.dense_shape`. Same for
354 `SparseTensorValue.shape`.
Andrew Harp1cb96892016-12-08 20:05:49 -0800355* `Env::FileExists` and `FileSystem::FileExists` now return a
Vijay Vasudevan93a975e2017-02-17 17:05:49 -0800356 `tensorflow::Status` instead of a bool. Any callers to this function can be
Andrew Harp1cb96892016-12-08 20:05:49 -0800357 converted to a bool by adding `.ok()` to the call.
358* C API: Type `TF_SessionWithGraph` has been renamed to `TF_Session`, indicating
359 its preferred use in language bindings for TensorFlow. What was previously
360 `TF_Session` has been renamed to `TF_DeprecatedSession`.
361* C API: Renamed `TF_Port` to `TF_Output`.
362* C API: The caller retains ownership of `TF_Tensor` objects provided to
363 `TF_Run`, `TF_SessionRun`, `TF_SetAttrTensor` etc.
364* Renamed `tf.image.per_image_whitening()` to
365 `tf.image.per_image_standardization()`
366* Move Summary protobuf constructors to `tf.summary` submodule.
367* Deprecate `histogram_summary`, `audio_summary`, `scalar_summary`,
368 `image_summary`, `merge_summary`, and `merge_all_summaries`.
369* Combined `batch_*` and regular version of linear algebra and FFT ops. The
370 regular op now handles batches as well. All `batch_*` Python interfaces were
371 removed.
372* `tf.all_variables`, `tf.VARIABLES` and `tf.initialize_all_variables` renamed
373 to `tf.global_variables`, `tf.GLOBAL_VARIABLES` and
374 `tf.global_variables_initializer` respectively.
A. Unique TensorFlower46d2c282017-01-02 22:19:48 -0800375* `tf.zeros_initializer()` and `tf.ones_initializer()` now return a callable
376 that must be called with initializer arguments, in your code replace
Benoit Steiner639b4e72017-02-08 09:25:09 -0800377 `tf.zeros_initializer` with `tf.zeros_initializer()`
Andrew Harp1cb96892016-12-08 20:05:49 -0800378
379## Bug Fixes and Other Changes
380
381* Use threadsafe version of `lgamma` function.
382* Fix `tf.sqrt` handling of negative arguments.
383* Fixed bug causing incorrect number of threads to be used for multi-threaded
384 benchmarks.
385* Performance optimizations for `batch_matmul` on multi-core CPUs.
386* Improve trace, `matrix_set_diag`, `matrix_diag_part` and their gradients to
387 work for rectangular matrices.
388* Support for SVD of complex valued matrices.
389
390
391## Thanks to our Contributors
392
393This release contains contributions from many people at Google, as well as:
394
395@a7744hsc, Abhi Agg, @admcrae, Adriano Carmezim, Aki Sukegawa, Alex Kendall,
396Alexander Rosenberg Johansen, @amcrae, Amlan Kar, Andre Simpelo, Andreas Eberle,
397Andrew Hundt, Arnaud Lenglet, @b0noI, Balachander Ramachandran, Ben Barsdell,
398Ben Guidarelli, Benjamin Mularczyk, Burness Duan, @c0g, Changming Sun,
399@chanis, Corey Wharton, Dan J, Daniel Trebbien, Darren Garvey, David Brailovsky,
400David Jones, Di Zeng, @DjangoPeng, Dr. Kashif Rasul, @drag0, Fabrizio (Misto)
401Milo, FabríCio Ceschin, @fp, @Ghedeon, @guschmue, Gökçen Eraslan, Haosdent
402Huang, Haroen Viaene, Harold Cooper, Henrik Holst, @hoangmit, Ivan Ukhov, Javier
403Dehesa, Jingtian Peng, Jithin Odattu, Joan Pastor, Johan Mathe, Johannes Mayer,
404Jongwook Choi, Justus Schwabedal, Kai Wolf, Kamil Hryniewicz, Kamran Amini,
405Karen Brems, Karl Lattimer, @kborer, Ken Shirriff, Kevin Rose, Larissa Laich,
406Laurent Mazare, Leonard Lee, Liang-Chi Hsieh, Liangliang He, Luke Iwanski,
407Marek Kolodziej, Moustafa Alzantot, @MrQianjinsi, @nagachika, Neil Han, Nick
408Meehan, Niels Ole Salscheider, Nikhil Mishra, @nschuc, Ondrej Skopek, OndřEj
409Filip, @OscarDPan, Pablo Moyano, Przemyslaw Tredak, @qitaishui, @Quarazy,
410@raix852, Philipp Helo, Sam Abrahams, @SriramRamesh, Till Hoffmann, Tushar Soni,
411@tvn, @tyfkda, Uwe Schmidt, Victor Villas, Vit Stepanovs, Vladislav Gubarev,
412@wujingyue, Xuesong Yang, Yi Liu, Yilei Yang, @youyou3, Yuan (Terry) Tang,
413Yuming Wang, Zafar Takhirov, @zhongyuk, Ziming Dong, @guotong1988
414
415We are also grateful to all who filed issues or helped resolve them, asked and
416answered questions, and were part of inspiring discussions.
A. Unique TensorFlower79228c72016-10-19 16:25:46 -0800417
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800418# Release 0.11.0
Vijay Vasudevan2d0d1262016-08-08 14:06:20 -0800419
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800420## Major Features and Improvements
Vijay Vasudevan2d0d1262016-08-08 14:06:20 -0800421
Vijay Vasudevan818993c2016-11-03 17:07:01 -0800422* CUDA 8 support.
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800423* cuDNN 5 support.
424* HDFS Support.
425* Adds Fused LSTM support via cuDNN 5 in `tensorflow/contrib/cudnn_rnn`.
426* Improved support for NumPy style basic slicing including non-1 strides,
427 ellipses, newaxis, and negative indices. For example complicated expressions
428 like `foo[1, 2:4, tf.newaxis, ..., :-3:-1, :]` are now supported. In addition
429 we have preliminary (non-broadcasting) support for sliced assignment to
430 variables. In particular one can write `var[1:3].assign([1,11,111])`.
431* 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.
432* Introducing `core/util/tensor_bundle` module: a module to efficiently
433 serialize/deserialize tensors to disk. Will be used in TF's new checkpoint
434 format.
435* Added tf.svd for computing the singular value decomposition (SVD) of dense
436 matrices or batches of matrices (CPU only).
437* Added gradients for eigenvalues and eigenvectors computed using
438 `self_adjoint_eig` or `self_adjoint_eigvals`.
439* Eliminated `batch_*` methods for most linear algebra and FFT ops and promoted
440 the non-batch version of the ops to handle batches of matrices.
441* Tracing/timeline support for distributed runtime (no GPU profiler yet).
442* C API gives access to inferred shapes with `TF_GraphGetTensorNumDims` and
443 `TF_GraphGetTensorShape`.
444* Shape functions for core ops have moved to C++ via
445 `REGISTER_OP(...).SetShapeFn(...)`. Python shape inference RegisterShape calls
446 use the C++ shape functions with `common_shapes.call_cpp_shape_fn`. A future
447 release will remove `RegisterShape` from python.
448
449
450## Bug Fixes and Other Changes
451
452* Documentation now includes operator overloads on Tensor and Variable.
453* `tensorflow.__git_version__` now allows users to identify the version of the
454 code that TensorFlow was compiled with. We also have
455 `tensorflow.__git_compiler__` which identifies the compiler used to compile
456 TensorFlow's core.
457* Improved multi-threaded performance of `batch_matmul`.
Eugene Brevdo21e1cc72016-08-11 21:45:39 -0800458* LSTMCell, BasicLSTMCell, and MultiRNNCell constructors now default to
459 `state_is_tuple=True`. For a quick fix while transitioning to the new
460 default, simply pass the argument `state_is_tuple=False`.
Vijay Vasudevan2d0d1262016-08-08 14:06:20 -0800461* DeviceFactory's AddDevices and CreateDevices functions now return
462 a Status instead of void.
A. Unique TensorFlower84cefad2016-08-12 07:06:13 -0800463* Int32 elements of list(type) arguments are no longer placed in host memory by
464 default. If necessary, a list(type) argument to a kernel can be placed in host
465 memory using a HostMemory annotation.
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800466* `uniform_unit_scaling_initializer()` no longer takes a `full_shape` arg,
467 instead relying on the partition info passed to the initializer function when
468 it's called.
469* The NodeDef protocol message is now defined in its own file `node_def.proto`
470 `instead of graph.proto`.
471* `ops.NoGradient` was renamed `ops.NotDifferentiable`. `ops.NoGradient` will
Vijay Vasudevan612bae72016-09-09 11:03:09 -0800472 be removed soon.
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800473* `dot.h` / DotGraph was removed (it was an early analysis tool prior
Vijay Vasudevan269bfee2016-09-21 21:41:19 -0800474 to TensorBoard, no longer that useful). It remains in history
475 should someone find the code useful.
Vijay Vasudevan914625a2016-09-23 13:51:34 -0800476* re2 / regexp.h was removed from being a public interface of TF.
477 Should users need regular expressions, they should depend on the RE2
478 library directly rather than via TensorFlow.
Dan Manée5bcf542016-05-16 13:39:34 -0800479
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800480## Thanks to our Contributors
481
482This release contains contributions from many people at Google, as well as:
483
484Abid K, @afshinrahimi, @AidanGG, Ajay Rao, Aki Sukegawa, Alex Rothberg,
485Alexander Rosenberg Johansen, Andrew Gibiansky, Andrew Thomas, @Appleholic,
486Bastiaan Quast, Ben Dilday, Bofu Chen, Brandon Amos, Bryon Gloden, Cissp®,
487@chanis, Chenyang Liu, Corey Wharton, Daeyun Shin, Daniel Julius Lasiman, Daniel
488Waterworth, Danijar Hafner, Darren Garvey, Denis Gorbachev, @DjangoPeng,
489Egor-Krivov, Elia Palme, Eric Platon, Fabrizio Milo, Gaetan Semet,
490Georg Nebehay, Gu Wang, Gustav Larsson, @haosdent, Harold Cooper, Hw-Zz,
491@ichuang, Igor Babuschkin, Igor Macedo Quintanilha, Ilya Edrenkin, @ironhead,
492Jakub Kolodziejczyk, Jennifer Guo, Jihun Choi, Jonas Rauber, Josh Bleecher
493Snyder, @jpangburn, Jules Gagnon-Marchand, Karen Brems, @kborer, Kirill Bobyrev,
494Laurent Mazare, Longqi Yang, Malith Yapa, Maniteja Nandana, Martin Englund,
495Matthias Winkelmann, @mecab, Mu-Ik Jeon, Nand Dalal, Niels Ole Salscheider,
496Nikhil Mishra, Park Jiin, Pieter De Rijk, @raix852, Ritwik Gupta, Sahil Sharma,
Patrick Nguyenc5ab3dd2016-10-20 12:09:18 -0800497Sangheum Hwang, @SergejsRk, Shinichiro Hamaji, Simon Denel, @Steve, @suiyuan2009,
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800498Tiago Jorge, Tijmen Tieleman, @tvn, @tyfkda, Wang Yang, Wei-Ting Kuo, Wenjian
499Huang, Yan Chen, @YenChenLin, Yuan (Terry) Tang, Yuncheng Li, Yunfeng Wang, Zack
500Polizzi, @zhongzyd, Ziming Dong, @perhapszzy
501
502We are also grateful to all who filed issues or helped resolve them, asked and
503answered questions, and were part of inspiring discussions.
504
A. Unique TensorFlowerabe9ab32016-07-31 22:07:30 -0800505# Release 0.10.0
A. Unique TensorFlower533d8912016-06-30 12:10:50 -0800506
A. Unique TensorFlowerabe9ab32016-07-31 22:07:30 -0800507## Major Features and Improvements
508
509* Added support for C++ shape inference
510* Added graph-construction C API
511* Major revision to the graph-construction C++ API
512* Support makefile build for iOS
513* Added Mac GPU support
514* Full version of TF-Slim available as `tf.contrib.slim`
515* Added k-Means clustering and WALS matrix factorization
516
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800517## Bug Fixes and Other Changes
A. Unique TensorFlowerabe9ab32016-07-31 22:07:30 -0800518
519* Allow gradient computation for scalar values.
520* Performance improvements for gRPC
521* Improved support for fp16
522* New high-level ops in tf.contrib.{layers,metrics}
523* New features for TensorBoard, such as shape display, exponential smoothing
524* Faster and more stable Google Cloud Storage (GCS) filesystem support
525* Support for zlib compression and decompression for TFRecordReader and TFRecordWriter
526* Support for reading (animated) GIFs
527* Improved support for SparseTensor
528* Added support for more probability distributions (Dirichlet, Beta, Bernoulli, etc.)
529* Added Python interfaces to reset resource containers.
530* Many bugfixes and performance improvements
531* Many documentation fixes
532
533## Thanks to our Contributors
534
535This release contains contributions from many people at Google, as well as:
536
537Alex 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
538
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800539We are also grateful to all who filed issues or helped resolve them, asked and
540answered questions, and were part of inspiring discussions.
Vijay Vasudevan490afa92016-06-21 09:18:06 -0800541
542# Release 0.9.0
543
544## Major Features and Improvements
545
546* Python 3.5 support and binaries
547* Added iOS support
548* Added support for processing on GPUs on MacOS
549* Added makefile for better cross-platform build support (C API only)
550* fp16 support and improved complex128 support for many ops
551* Higher level functionality in contrib.{layers,losses,metrics,learn}
552* More features to Tensorboard
553* Improved support for string embedding and sparse features
554* The RNN api is finally "official" (see, e.g., `tf.nn.dynamic_rnn`,
555 `tf.nn.rnn`, and the classes in `tf.nn.rnn_cell`).
556* TensorBoard now has an Audio Dashboard, with associated audio summaries.
557
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800558## Bug Fixes and Other Changes
Vijay Vasudevan490afa92016-06-21 09:18:06 -0800559
560* Turned on CuDNN Autotune.
561* Added support for using third-party Python optimization algorithms (contrib.opt).
562* Google Cloud Storage filesystem support.
563* HDF5 support
564* Add support for 3d convolutions and pooling.
565* Update gRPC release to 0.14.
566* Eigen version upgrade.
567* Switch to eigen thread pool
568* `tf.nn.moments()` now accepts a `shift` argument. Shifting by a good estimate
569 of the mean improves numerical stability. Also changes the behavior of the
570 `shift` argument to `tf.nn.sufficient_statistics()`.
571* Performance improvements
572* Many bugfixes
573* Many documentation fixes
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800574* TensorBoard fixes: graphs with only one data point, Nan values,
575 reload button and auto-reload, tooltips in scalar charts, run
Vijay Vasudevan490afa92016-06-21 09:18:06 -0800576 filtering, stable colors
577* Tensorboard graph visualizer now supports run metadata. Clicking on nodes
578 while viewing a stats for a particular run will show runtime statistics, such
579 as memory or compute usage. Unused nodes will be faded out.
580
581## Thanks to our Contributors
582
583This release contains contributions from many people at Google, as well as:
584
A. Unique TensorFlowerabe9ab32016-07-31 22:07:30 -0800585Aaron 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 -0800586
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800587We are also grateful to all who filed issues or helped resolve them, asked and
588answered questions, and were part of inspiring discussions.
Vijay Vasudevan490afa92016-06-21 09:18:06 -0800589
Illia Polosukhin5c9bc512016-04-18 17:56:51 -0800590# Release 0.8.0
591
592## Major Features and Improvements
593
594* Added a distributed runtime using GRPC
595* Move skflow to `contrib/learn`
596* Better linear optimizer in `contrib/linear_optimizer`
597* Random forest implementation in `contrib/tensor_forest`
598* CTC loss and decoders in `contrib/ctc`
599* Basic support for `half` data type
600* Better support for loading user ops (see examples in `contrib/`)
601* Allow use of (non-blocking) Eigen threadpool with `TENSORFLOW_USE_EIGEN_THREADPOOL` define
602* Add an extension mechanism for adding network file system support
603* TensorBoard displays metadata stats (running time, memory usage and device used) and tensor shapes
604
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800605## Bug Fixes and Other Changes
Illia Polosukhin5c9bc512016-04-18 17:56:51 -0800606
607* Utility for inspecting checkpoints
608* Basic tracing and timeline support
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800609* Allow building against cuDNN 5 (not incl. RNN/LSTM support)
Illia Polosukhin5c9bc512016-04-18 17:56:51 -0800610* Added instructions and binaries for ProtoBuf library with fast serialization and without 64MB limit
611* Added special functions
Dan Mané54a71782016-09-09 16:07:46 -0800612* `bool`-strictness: Tensors have to be explicitly compared to `None`
Illia Polosukhin5c9bc512016-04-18 17:56:51 -0800613* Shape strictness: all fed values must have a shape that is compatible with the tensor they are replacing
614* Exposed `tf.while_loop` (deprecated `control_flow_ops.While`)
615* run() now takes RunOptions and RunMetadata, which enable timing stats
616* Fixed lots of potential overflow problems in op kernels
617* Various performance improvements, especially for RNNs and convolutions
618* Many bugfixes
619* Nightly builds, tutorial tests, many test improvements
620* New examples: transfer learning and deepdream ipython notebook
621* Added tutorials, many documentation fixes.
622
623## Thanks to our Contributors
624
625This release contains contributions from many people at Google, as well as:
626
A. Unique TensorFlowerabe9ab32016-07-31 22:07:30 -0800627Abhinav 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 -0800628
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800629We are also grateful to all who filed issues or helped resolve them, asked and
630answered questions, and were part of inspiring discussions.
Illia Polosukhin5c9bc512016-04-18 17:56:51 -0800631
632
Eugene Brevdo56f1d642016-03-10 17:18:30 -0800633# Release 0.7.1
634
635## Bug Fixes and Other Changes
636
637* Added gfile.Open and gfile.Copy, used by input_data.py.
638* Fixed Saver bug when MakeDirs tried to create empty directory.
639* GPU Pip wheels are built with cuda 7.5 and cudnn-v4, making them
640 required for the binary releases. Lower versions of cuda/cudnn can
641 be supported by installing from sources and setting the options
642 during ./configure
643* Fix dataset encoding example for Python3 (@danijar)
644* Fix PIP installation by not packaging protobuf as part of wheel,
645 require protobuf 3.0.0b2.
646* Fix Mac pip installation of numpy by requiring pip >= 1.10.1.
647* Improvements and fixes to Docker image.
648
649
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800650# Release 0.7.0
Vijay Vasudevan10e62dc2015-12-11 23:03:16 -0800651
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800652## Major Features and Improvements
653
654* Allow using any installed Cuda >= 7.0 and cuDNN >= R2, and add support
655 for cuDNN R4
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800656* Added a `contrib/` directory for unsupported or experimental features,
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800657 including higher level `layers` module
658* Added an easy way to add and dynamically load user-defined ops
659* Built out a good suite of tests, things should break less!
660* Added `MetaGraphDef` which makes it easier to save graphs with metadata
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800661* Added assignments for "Deep Learning with TensorFlow" udacity course
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800662
663
664## Bug Fixes and Other Changes
665
666* Added a versioning framework for `GraphDef`s to ensure compatibility
667* Enforced Python 3 compatibility
668* Internal changes now show up as sensibly separated commits
669* Open-sourced the doc generator
670* Un-fork Eigen
671* Simplified the `BUILD` files and cleaned up C++ headers
672* TensorFlow can now be used as a submodule in another bazel build
673* New ops (e.g., `*fft`, `*_matrix_solve`)
674* Support for more data types in many ops
675* Performance improvements
676* Various bugfixes
677* Documentation fixes and improvements
678
679
680## Breaking Changes to the API
Vijay Vasudevan10e62dc2015-12-11 23:03:16 -0800681
682* `AdjustContrast` kernel deprecated, new kernel `AdjustContrastv2` takes and
683 outputs float only. `adjust_contrast` now takes all data types.
684* `adjust_brightness`'s `delta` argument is now always assumed to be in `[0,1]`
685 (as is the norm for images in floating point formats), independent of the
686 data type of the input image.
687* The image processing ops do not take `min` and `max` inputs any more, casting
688 safety is handled by `saturate_cast`, which makes sure over- and underflows
689 are handled before casting to data types with smaller ranges.
Geoffrey Irvingcbff45c2016-01-12 08:06:56 -0800690* For C++ API users: `IsLegacyScalar` and `IsLegacyVector` are now gone from
691 `TensorShapeUtils` since TensorFlow is scalar strict within Google (for
692 example, the shape argument to `tf.reshape` can't be a scalar anymore). The
693 open source release was already scalar strict, so outside Google `IsScalar`
694 and `IsVector` are exact replacements.
Josh Levenbergdb7478e2016-01-20 14:54:50 -0800695* The following files are being removed from `tensorflow/core/public/`:
696 * `env.h` -> `../platform/env.h`
697 * `status.h` -> `../lib/core/status.h`
698 * `tensor.h` -> `../framework/tensor.h`
699 * `tensor_shape.h` -> `../framework/tensor_shape.h`
700 * `partial_tensor_shape.h` -> `../framework/partial_tensor_shape.h`
701 * `tensorflow_server.h` deleted
Geoffrey Irving56437752016-01-25 09:43:13 -0800702* For C++ API users: `TensorShape::ShortDebugString` has been renamed to
703 `DebugString`, and the previous `DebugString` behavior is gone (it was
704 needlessly verbose and produced a confusing empty string for scalars).
Manjunath Kudlurc2722a12016-01-27 13:24:50 -0800705* `GraphOptions.skip_common_subexpression_elimination` has been removed. All
706 graph optimizer options are now specified via
707 `GraphOptions.OptimizerOptions`.
Geoffrey Irving18297122016-02-10 11:48:34 -0800708* `ASSERT_OK` / `EXPECT_OK` macros conflicted with external projects, so they
709 were renamed `TF_ASSERT_OK`, `TF_EXPECT_OK`. The existing macros are
710 currently maintained for short-term compatibility but will be removed.
Eugene Brevdofea55e12016-01-27 14:54:54 -0800711* The non-public `nn.rnn` and the various `nn.seq2seq` methods now return
712 just the final state instead of the list of all states.
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800713* `tf.scatter_update` now no longer guarantees that lexicographically largest
714 index be used for update when duplicate entries exist.
Geoffrey Irving3e33d442016-02-08 12:02:44 -0800715* `tf.image.random_crop(image, [height, width])` is now
716 `tf.random_crop(image, [height, width, depth])`, and `tf.random_crop` works
717 for any rank (not just 3-D images). The C++ `RandomCrop` op has been replaced
718 with pure Python.
Geoffrey Irving18297122016-02-10 11:48:34 -0800719* Renamed `tf.test.GetTempDir` and `tf.test.IsBuiltWithCuda` to
720 `tf.test.get_temp_dir` and `tf.test.is_built_with_cuda` for PEP-8
721 compatibility.
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800722* `parse_example`'s interface has changed, the old interface is accessible in
723 `legacy_parse_example` (same for related functions).
724* New `Variable`s are not added to the same collection several times even if
725 a list with duplicates is passed to the constructor.
Josh Levenberg02dff6d2016-01-07 18:37:54 -0800726* The Python API will now properly set the `list` member of `AttrValue` in
727 constructed `GraphDef` messages for empty lists. The serialization of some
728 graphs will change, but the change is both forwards and backwards compatible.
729 It will break tests that compare a generated `GraphDef` to a golden serialized
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800730 `GraphDef` (which is discouraged).
731
732
733## Thanks to our Contributors
734
735This release contains contributions from many people at Google, as well as:
736
737Akiomi Kamakura, Alex Vig, Alexander Rosenberg Johansen, Andre Cruz, Arun Ahuja,
738Bart Coppens, Bernardo Pires, Carl Vondrick, Cesar Salgado, Chen Yu,
739Christian Jauvin, Damien Aymeric, Dan Vanderkam, Denny Britz, Dongjoon Hyun,
740Eren Güven, Erik Erwitt, Fabrizio Milo, G. Hussain Chinoy, Jim Fleming,
741Joao Felipe Santos, Jonas Meinertz Hansen, Joshi Rekha, Julian Viereck,
742Keiji Ariyama, Kenton Lee, Krishna Sankar, Kristina Chodorow, Linchao Zhu,
743Lukas Krecan, Mark Borgerding, Mark Daoust, Moussa Taifi,
744Nathan Howell, Naveen Sundar Govindarajulu, Nick Sweeting, Niklas Riekenbrauck,
745Olivier Grisel, Patrick Christ, Povilas Liubauskas, Rainer Wasserfuhr,
746Romain Thouvenin, Sagan Bolliger, Sam Abrahams, Taehoon Kim, Timothy J Laurent,
747Vlad Zavidovych, Yangqing Jia, Yi-Lin Juang, Yuxin Wu, Zachary Lipton,
748Zero Chen, Alan Wu, @brchiu, @emmjaykay, @jalammar, @Mandar-Shinde,
749@nsipplswezey, @ninotoshi, @panmari, @prolearner and @rizzomichaelg.
750
A. Unique TensorFloweredaf3b32016-10-10 10:26:22 -0800751We are also grateful to all who filed issues or helped resolve them, asked and
752answered questions, and were part of inspiring discussions.
Josh Levenberg02dff6d2016-01-07 18:37:54 -0800753
Geoffrey Irvingcbff45c2016-01-12 08:06:56 -0800754
Vijay Vasudevan2c3738d2015-12-08 14:55:13 -0800755# Release 0.6.0
756
757## Major Features and Improvements
758
759* Python 3.3+ support via changes to python codebase and ability
760 to specify python version via ./configure.
761
762* Some improvements to GPU performance and memory usage:
763 [convnet benchmarks](https://github.com/soumith/convnet-benchmarks/issues/66)
764 roughly equivalent with native cudnn v2 performance. Improvements mostly due
765 to moving to 32-bit indices, faster shuffling kernels. More improvements to
766 come in later releases.
767
768
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800769## Bug Fixes
Vijay Vasudevan2c3738d2015-12-08 14:55:13 -0800770
771* Lots of fixes to documentation and tutorials, many contributed
772 by the public.
773
774* 271 closed issues on github issues.
775
Vijay Vasudevanfe056f02016-02-17 11:42:30 -0800776## Backwards-Incompatible Changes
Vijay Vasudevan2c3738d2015-12-08 14:55:13 -0800777
Geoffrey Irving18297122016-02-10 11:48:34 -0800778* `tf.nn.fixed_unigram_candidate_sampler` changed its default 'distortion'
Vijay Vasudevan2c3738d2015-12-08 14:55:13 -0800779 attribute from 0.0 to 1.0. This was a bug in the original release
780 that is now fixed.
781
Vijay Vasudevanddd4aaf2015-12-08 09:58:59 -0800782# Release 0.5.0
783
784Initial release of TensorFlow.