Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
99 changes: 99 additions & 0 deletions doc/fluid/beginners_guide/basics/index_en.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
##########################
Basic Deep Learning Models
##########################

This section collects six documents arranging from the simplest to the most challenging, which will guide you through the basic deep learning tasks in PaddlePaddle.

The documentation in this chapter covers a lot of deep learning basics and how to implement them with PaddlePaddle. See the instructions below for how to use:


Overview
======================

The book you are reading is an "interactive" e-book - each chapter can be run in a Jupyter Notebook.

.. toctree::
:titlesonly:

image_classification/index_en.md
word2vec/index_en.md
recommender_system/index_en.md
understand_sentiment/index_en.md
label_semantic_roles/index_en.md
machine_translation/index_en.md


We packaged Jupyter, PaddlePaddle, and various dependency softwares into a Docker image. It frees you from installing these softwares by yourself, and you only need to just install Docker. For various Linux versions, please refer to https://www.docker.com . If you use docker on `Windows <https://www.docker.com/docker-windows>`_ or `Mac <https://www.docker.com/docker-mac>`_ , consider `allocate more Memory and CPU resources to Docker <http://stackoverflow.com/a/39720010/724872>`_ .


Instructions
======================


This book assumes you are performing CPU training by default. If you want to use GPU training, the steps will vary slightly. Please refer to "GPU Training" below.





CPU training
>>>>>>>>>>>>

Just run these in shell:

.. code-block:: shell

docker run -d -p 8888:8888 paddlepaddle/book

It downloads the Docker image for running books from DockerHub.com.
To read and edit this book on-line, please visit http://localhost:8888 in your browser.

If the Internet connection to DockerHub.com is compromised, try our spare docker image named docker.paddlepaddlehub.com:

::

docker run -d -p 8888:8888 docker.paddlepaddlehub.com/book


GPU training
>>>>>>>>>>>>>

To ensure that the GPU driver works properly in the image, we recommend running the image with `nvidia docker <https://github.com/NVIDIA/nvidia-docker>`_ . Please install nvidia-docker first, then run:


::

nvidia-docker run -d -p 8888:8888 paddlepaddle/book:latest-gpu


Or use a image source in China to run:

::

nvidia-docker run -d -p 8888:8888 docker.paddlepaddlehub.com/book:latest-gpu


modify the following codes

.. code-block:: python

use_cuda = False


into :

.. code-block:: python

use_cuda = True



Contribute to Book
===================

We highly appreciate your original contributions of new chapters to Book! Just Pull Requests of your contributions to the sub-directory in :code:`pending` . When this chapter is endorsed, we'll gladly move it to the root directory.


For writing, running, debugging, you need to install `shell <https://github.com/PaddlePaddle/book/blob/develop/.tools/convert-markdown-into-ipynb-and-test.sh>`_ to generate Docker image。

**Please Note:** We also provide `English Readme <https://github.com/PaddlePaddle/book/blob/develop/README.md>`_ for PaddlePaddle book
1 change: 1 addition & 0 deletions doc/fluid/beginners_guide/basics/word2vec/index_en.md
2 changes: 2 additions & 0 deletions doc/fluid/beginners_guide/index_en.rst
Original file line number Diff line number Diff line change
Expand Up @@ -24,4 +24,6 @@ If you have been armed with certain level of deep learning knowledge, and it hap
:hidden:

install/index_en.rst
quick_start/index_en.rst
basics/index_en.rst
programming_guide/programming_guide_en.md
1 change: 1 addition & 0 deletions doc/fluid/beginners_guide/quick_start/fit_a_line/README.md
13 changes: 13 additions & 0 deletions doc/fluid/beginners_guide/quick_start/index_en.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
##############
Quick Start
##############

Welcome to Quick Start!

This section will tutor you to invent your won models of classical *linear Regression* and *Handwritten Digits Recognition* tasks in PaddlePaddle Fluid. The following tutorials provide details on model definition, training, and inference in a friendly manner based on real-life datasets:

.. toctree::
:titlesonly:

fit_a_line/README.md
recognize_digits/README.md