diff --git a/.travis.yml b/.travis.yml index 2bf6a1e54..63cda3d39 100644 --- a/.travis.yml +++ b/.travis.yml @@ -26,7 +26,7 @@ env: # Backward Compatibility in insured for release less than 1 year old. # https://pypi.org/project/tensorflow/#history matrix: - - _TF_VERSION=2.0.0b1 + - _TF_VERSION=2.0.0-rc1 # - _TF_VERSION=1.12.0 # Remove on Oct 22, 2019 # - _TF_VERSION=1.11.0 # Remove on Sep 28, 2019 # - _TF_VERSION=1.10.1 # Remove on Aug 24, 2019 @@ -63,7 +63,7 @@ matrix: install: - | if [[ -v _DOC_AND_YAPF_TEST ]]; then - pip install tensorflow==2.0.0b1 + pip install tensorflow==2.0.0-rc1 pip install yapf pip install -e .[doc] else @@ -101,7 +101,7 @@ deploy: on: tags: true python: '3.6' - condition: '$_TF_VERSION = 2.0.0b1' + condition: '$_TF_VERSION = 2.0.0-rc1' # condition: '$_TF_VERSION = 1.11.0' # Documentation: https://docs.travis-ci.com/user/deployment/releases/ @@ -115,5 +115,5 @@ deploy: on: tags: true python: '3.6' - condition: '$_TF_VERSION = 2.0.0b1' + condition: '$_TF_VERSION = 2.0.0-rc1' # condition: '$_TF_VERSION = 1.11.0' diff --git a/CHANGELOG.md b/CHANGELOG.md index 5b9ffdf79..19f75fb10 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -79,32 +79,37 @@ To release a new version, please update the changelog as followed: ### Deprecated ### Fixed -- RNN updates: remove warnings, fix if seq_len=0, unitest (#PR 1033) -- BN updates: fix BatchNorm1d for 2D data, refactored (#PR 1040) ### Removed ### Security ### Contributors -- @ChrisWu1997: #1040 -## [2.2.1] +## [2.2.0] - 2019-09-13 + +TensorLayer 2.2.0 is a maintenance release. +It contains numerous API improvement and bug fixes. +This release is compatible with TensorFlow 2 RC1. ### Added - Support nested layer customization (#PR 1015) - Support string dtype in InputLayer (#PR 1017) - Support Dynamic RNN in RNN (#PR 1023) - Add ResNet50 static model (#PR 1030) -_ Add performance test code in static model (#PR 1041) +- Add performance test code in static model (#PR 1041) ### Changed - `SpatialTransform2dAffine` auto `in_channels` -- support TensorFlow 2.0.0-beta1 +- support TensorFlow 2.0.0-rc1 - Update model weights property, now returns its copy (#PR 1010) +### Fixed +- RNN updates: remove warnings, fix if seq_len=0, unitest (#PR 1033) +- BN updates: fix BatchNorm1d for 2D data, refactored (#PR 1040) + ### Dependencies Update ### Deprecated @@ -127,7 +132,8 @@ _ Add performance test code in static model (#PR 1041) ### Contributors - @zsdonghao -- @ChrisWu1997: #1010 #1015 #1025 #1030 +- @luomai +- @ChrisWu1997: #1010 #1015 #1025 #1030 #1040 - @warshallrho: #1017 #1021 #1026 #1029 #1032 #1041 - @ArnoldLIULJ: #1023 - @JingqingZ: #1023 @@ -202,15 +208,12 @@ A maintain release. - @warshallrho: #PR966 - @zsdonghao: #931 - @yd-yin: #963 -<<<<<<< HEAD - @Tokarev-TT-33: # 995 - @initial-h: # 995 - @quantumiracle: #995 - @Officium: #995 -======= - @1FengL: #958 - @dvklopfenstein: #971 ->>>>>>> 560dbb8a17963023a3b1d59a79e1c2752530114a ## [2.0.0] - 2019-05-04 @@ -563,7 +566,7 @@ To many PR for this update, please check [here](https://github.com/tensorlayer/t @zsdonghao @luomai @DEKHTIARJonathan [Unreleased]: https://github.com/tensorlayer/tensorlayer/compare/2.0....master -[2.1.1]: https://github.com/tensorlayer/tensorlayer/compare/2.1.1...2.1.1 +[2.2.0]: https://github.com/tensorlayer/tensorlayer/compare/2.2.0...2.2.0 [2.1.0]: https://github.com/tensorlayer/tensorlayer/compare/2.1.0...2.1.0 [2.0.2]: https://github.com/tensorlayer/tensorlayer/compare/2.0.2...2.0.2 [2.0.1]: https://github.com/tensorlayer/tensorlayer/compare/2.0.1...2.0.1 diff --git a/README.md b/README.md index c6751ea76..87ef86315 100644 --- a/README.md +++ b/README.md @@ -34,7 +34,10 @@
-TensorLayer is a novel TensorFlow-based deep learning and reinforcement learning library designed for researchers and engineers. It provides a large collection of customizable neural layers / functions that are key to build real-world AI applications. TensorLayer is awarded the 2017 Best Open Source Software by the [ACM Multimedia Society](https://twitter.com/ImperialDSI/status/923928895325442049). +TensorLayer is a novel TensorFlow-based deep learning and reinforcement learning library designed for researchers and engineers. It provides an extensive collection of customizable neural layers to build complex AI models. TensorLayer is awarded the 2017 Best Open Source Software by the [ACM Multimedia Society](https://twitter.com/ImperialDSI/status/923928895325442049). +TensorLayer can also be found at [iHub](https://code.ihub.org.cn/projects/328) and [Gitee](https://gitee.com/organizations/TensorLayer). + +# News 🔥📰🔥 Reinforcement Learning Model Zoos: [Low-level APIs for Research](https://github.com/tensorlayer/tensorlayer/tree/master/examples/reinforcement_learning) and [High-level APIs for Production](https://github.com/tensorlayer/RLzoo) @@ -42,37 +45,32 @@ TensorLayer is a novel TensorFlow-based deep learning and reinforcement learning 🔥📰🔥 [NNoM](https://github.com/majianjia/nnom): Run TensorLayer quantized models on the **MCU** (e.g., STM32) (Coming Soon) - # Features -As deep learning practitioners, we have been looking for a library that can address various development - purposes. This library is easy to adopt by providing diverse examples, tutorials and pre-trained models. -Also, it allow users to easily fine-tune TensorFlow; while being suitable for production deployment. TensorLayer aims to satisfy all these purposes. It has three key features: +TensorLayer is a new deep learning library designed with simplicity, flexibility and high-performance in mind. -- ***Simplicity*** : TensorLayer lifts the low-level dataflow interface of TensorFlow to *high-level* layers / models. It is very easy to learn through the rich [example codes](https://github.com/tensorlayer/awesome-tensorlayer) contributed by a wide community. -- ***Flexibility*** : TensorLayer APIs are transparent: it does not mask TensorFlow from users; but leaving massive hooks that help *low-level tuning* and *deep customization*. -- ***Zero-cost Abstraction*** : TensorLayer can achieve the *full power* of TensorFlow. The following table shows the training speeds of [VGG16](http://www.robots.ox.ac.uk/~vgg/research/very_deep/) using TensorLayer and native TensorFlow on a TITAN Xp. +- ***Simplicity*** : TensorLayer has a high-level layer/model abstraction which is effortless to learn. You can learn how deep learning can benefit your AI tasks in minutes through the massive [examples](https://github.com/tensorlayer/awesome-tensorlayer). +- ***Flexibility*** : TensorLayer APIs are transparent and flexible, inspired by the emerging PyTorch library. Compared to the Keras abstraction, TensorLayer makes it much easier to build and train complex AI models. +- ***Zero-cost Abstraction*** : Though simple to use, TensorLayer does not require you to make any compromise in the performance of TensorFlow (Check the following benchmark section for more details). - | Mode | Lib | Data Format | Max GPU Memory Usage(MB) |Max CPU Memory Usage(MB) | Avg CPU Memory Usage(MB) | Runtime (sec) | - | :-------: | :-------------: | :-----------: | :-----------------: | :-----------------: | :-----------------: | :-----------: | - | AutoGraph | TensorFlow 2.0 | channel last | 11833 | 2161 | 2136 | 74 | - | | Tensorlayer 2.0 | channel last | 11833 | 2187 | 2169 | 76 | - | Graph | Keras | channel last | 8677 | 2580 | 2576 | 101 | - | Eager | TensorFlow 2.0 | channel last | 8723 | 2052 | 2024 | 97 | - | | TensorLayer 2.0 | channel last | 8723 | 2010 | 2007 | 95 | +TensorLayer is NOT yet another library in the TensorFlow world. Other wrappers like Keras and TFLearn +hide many powerful features of TensorFlow and provide little support for writing custom, complex AI models. Inspired by PyTorch, TensorLayer APIs are simple, flexible and most importantly, pythonic. +TensorLayer has a fast-growing community. It has been used by researchers and engineers all over the world, including those from Peking University, +Imperial College London, UC Berkeley, Carnegie Mellon University, Stanford University, and companies like Google, Microsoft, Alibaba, Tencent, Xiaomi, and Bloomberg. +# Multilingual documents -TensorLayer stands at a unique spot in the library landscape. Other wrapper libraries like Keras and TFLearn also provide high-level abstractions. They, however, often -hide the underlying engine from users, which make them hard to customize -and fine-tune. On the contrary, TensorLayer APIs are generally lightweight, flexible and transparent. -Users often find it easy to start with the examples and tutorials, and then dive -into TensorFlow seamlessly. In addition, TensorLayer does not create library lock-in through native supports for importing components from Keras. +TensorLayer has extensive documentation for both beginners and professionals. The documentation is available in +both English and Chinese. -TensorLayer has a fast growing usage among top researchers and engineers, from universities like Peking University, -Imperial College London, UC Berkeley, Carnegie Mellon University, Stanford University, and -University of Technology of Compiegne (UTC), and companies like Google, Microsoft, Alibaba, Tencent, Xiaomi, and Bloomberg. +[![English Documentation](https://img.shields.io/badge/documentation-english-blue.svg)](https://tensorlayer.readthedocs.io/) +[![Chinese Documentation](https://img.shields.io/badge/documentation-%E4%B8%AD%E6%96%87-blue.svg)](https://tensorlayercn.readthedocs.io/) +[![Chinese Book](https://img.shields.io/badge/book-%E4%B8%AD%E6%96%87-blue.svg)](http://www.broadview.com.cn/book/5059/) + +If you want to try the experimental features on the the master branch, you can find the latest document +[here](https://tensorlayer.readthedocs.io/en/latest/). -# Tutorials and Real-World Applications +# Extensive examples You can find a large collection of tutorials, examples and real-world applications using TensorLayer within [examples](examples/) or through the following space: @@ -82,73 +80,42 @@ You can find a large collection of tutorials, examples and real-world applicatio -# Documentation - -TensorLayer has extensive documentation for both beginners and professionals. The documentation is available in -both English and Chinese. Please click the following icons to find the documents you need: - -[![English Documentation](https://img.shields.io/badge/documentation-english-blue.svg)](https://tensorlayer.readthedocs.io/) -[![Chinese Documentation](https://img.shields.io/badge/documentation-%E4%B8%AD%E6%96%87-blue.svg)](https://tensorlayercn.readthedocs.io/) -[![Chinese Book](https://img.shields.io/badge/book-%E4%B8%AD%E6%96%87-blue.svg)](http://www.broadview.com.cn/book/5059/) - -If you want to try the experimental features on the the master branch, you can find the latest document -[here](https://tensorlayer.readthedocs.io/en/latest/). - -# Install +# Installing TensorLayer is easy -For latest code for TensorLayer 2.0, please build from the source. TensorLayer 2.0 has pre-requisites including TensorFlow 2, numpy, and others. For GPU support, CUDA and cuDNN are required. +TensorLayer 2.0 relies on TensorFlow, numpy, and others. To use GPUs, CUDA and cuDNN are required. Install TensorFlow: ```bash -pip3 install tensorflow-gpu==2.0.0-beta1 # specific version (YOU SHOULD INSTALL THIS ONE NOW) -pip3 install tensorflow-gpu # GPU version +pip3 install tensorflow-gpu==2.0.0-rc1 # TensorFlow GPU (version 2.0 RC1) pip3 install tensorflow # CPU version ``` -Install the stable version of TensorLayer: +Install the stable release of TensorLayer: ```bash pip3 install tensorlayer ``` -Install the latest version of TensorLayer: +Install the unstable development version of TensorLayer: ```bash pip3 install git+https://github.com/tensorlayer/tensorlayer.git -or -pip3 install https://github.com/tensorlayer/tensorlayer/archive/master.zip ``` -For developers, you should clone the folder to your local machine and put it along with your project scripts. - +If you want to install the additional dependencies, you can also run ```bash -git clone https://github.com/tensorlayer/tensorlayer.git -``` - -If you want install TensorLayer 1.X, the simplest way to install TensorLayer 1.X is to use the **Py**thon **P**ackage **I**ndex (PyPI): - -```bash -# for last stable version of TensorLayer 1.X -pip3 install --upgrade tensorlayer==1.X - -# for latest release candidate of TensorLayer 1.X -pip3 install --upgrade --pre tensorlayer - -# if you want to install the additional dependencies, you can also run pip3 install --upgrade tensorlayer[all] # all additional dependencies pip3 install --upgrade tensorlayer[extra] # only the `extra` dependencies pip3 install --upgrade tensorlayer[contrib_loggers] # only the `contrib_loggers` dependencies ``` - +# Benchmark + +The following table shows the training speeds of [VGG16](http://www.robots.ox.ac.uk/~vgg/research/very_deep/) using TensorLayer and native TensorFlow on a TITAN Xp. + +| Mode | Lib | Data Format | Max GPU Memory Usage(MB) |Max CPU Memory Usage(MB) | Avg CPU Memory Usage(MB) | Runtime (sec) | +| :-------: | :-------------: | :-----------: | :-----------------: | :-----------------: | :-----------------: | :-----------: | +| AutoGraph | TensorFlow 2.0 | channel last | 11833 | 2161 | 2136 | 74 | +| | Tensorlayer 2.0 | channel last | 11833 | 2187 | 2169 | 76 | +| Graph | Keras | channel last | 8677 | 2580 | 2576 | 101 | +| Eager | TensorFlow 2.0 | channel last | 8723 | 2052 | 2024 | 97 | +| | TensorLayer 2.0 | channel last | 8723 | 2010 | 2007 | 95 | + # Contribute Please read the [Contributor Guideline](CONTRIBUTING.md) before submitting your PRs. @@ -201,4 +180,4 @@ If you use TensorLayer for any projects, please cite this paper： # License -TensorLayer is released under the Apache 2.0 license. We also host TensorLayer on [iHub](https://code.ihub.org.cn/projects/328) and [Gitee](https://gitee.com/organizations/TensorLayer). +TensorLayer is released under the Apache 2.0 license.