Docs: Release, Readme, Perception Visualizer

Author: natashadsouza

README.md

@@ -29,8 +29,6 @@ For business and partnership, please visit [our website](http://apollo.auto).
 4. [Installation](#installation)
 5. [Documents](#documents)
 
-
-
 ## Getting Started
 
 Apollo 5.0 is loaded with new modules and features, but needs to be calibrated and configured perfectly before you take it for a spin. Please review the prerequisites and installation steps in detail to ensure that you are well equipped to build and launch Apollo. You could also check out Apollo's architecture overview for a greater understanding on Apollo's core technology and platform. 
@@ -220,6 +218,7 @@ The car now has 360-degree visibility, along with upgraded perception deep learn
 
 * Software: 
 
+    * [Data Pipeline](https://github.com/ApolloAuto/apollo/tree/master/modules/tools/fuel_proxy)
     * Perception
     * Planning
     * Control

RELEASE.md

@@ -1,3 +1,23 @@
+# Release 5.0
+
+Apollo 5.0 is an effort to support volume production for Geo-Fenced Autonomous Driving. The car now has 360-degree visibility, along with upgraded perception deep learning model to handle the changing conditions of complex road scenarios, making the car more secure and aware. Scenario-based planning has been enhanced to support additional scenarios like pull over and crossing bare intersections. 
+
+## Major Features And Improvements
+* Brand new Data Pipeline Service
+    * Vehicle Calibration
+* New Perception algorithms
+* Sensor Calibration Service
+* Scenario - Based Planning with a new planning algorithm, Open Space Planner and new scenarios supported
+    * Intersection - STOP Sign, Traffic Light, Bare Intersection
+    * Park - Valet, Pull Over
+* Map Data Verification tool
+* Prediction Evaluators
+* Simulation web platform - Dreamland
+    * Scenario Editor
+
+## Autonomous Drive Capabilities
+Vehicles with this version can drive autonomously in complex urban road conditions including both residential and downtown areas. **BE CAUTIOUS WHEN DRIVING AUTONOMOUSLY, ESPECIALLY AT NIGHT OR IN POOR VISION ENVIRONMENT. URBAN DRIVING INVOLVES NAVIGATING HIGH RISK ZONES LIKE SCHOOLS, PLEASE TEST APOLLO 5.0 WITH THE SUPPORT FROM APOLLO ENGINEERING TEAM, PLEASE AVOID DRIVING THE VEHICLE ON THE HIGHWAY OR AT SPEEDS THAT ARE ABOVE OUR SUPPORTED THRESHOLD**.
+
 # Release 3.5
 
 Apollo 3.5 is capable of navigating through complex driving scenarios such as residential and downtown areas. With 360-degree visibility and upgraded perception algorithms to handle the changing conditions of urban roads, the car is more secure and aware.

docs/howto/how_to_run_perception_module_on_your_local_computer.md

@@ -4,41 +4,49 @@ The perception module requires Nvidia GPU and CUDA installed to run the percepti
 
 We provide a step-by-step instruction on running perception module with Nvidia GPU as below:
 1. Get into the docker container via: 
-
-```bash
-$APOLLO_HOME/docker/scripts/dev_start.sh
-$APOLLO_HOME/docker/scripts/dev_into.sh
-```
+    ```bash
+    $APOLLO_HOME/docker/scripts/dev_start.sh
+    $APOLLO_HOME/docker/scripts/dev_into.sh
+    ```
 2. Build Apollo
-```bash
-./apollo.sh build_opt_gpu
-```
+    ```bash
+    ./apollo.sh build_opt_gpu
+    ```
 3. Run bootstrap.sh
-```bash
-bootstrap.sh
-```
+    ```bash
+    bootstrap.sh
+    ```
 4. Launch Dreamview from your web browser by typing following address
 http://localhost:8888/
 
 5. Select your car and map using the dropdowm options in the top right corner in Dreamview
 
 6. Select the transform button in Dreamview or type the following command in your terminal
-```bash
-cyber_launch start /apollo/modules/transform/launch/static_transform.launch
-```
+    ```bash
+    cyber_launch start /apollo/modules/transform/launch/static_transform.launch
+    ```
 7. If the image is compressed, launch the image decompression module
-```
-cyber_launch start /apollo/modules/tools/image_decompress/launch/image_decompress.launch
-```
+    ```
+    cyber_launch start modules/drivers/tools/image_decompress/launch/image_decompress.launch
+    ```
 
 8. Launch the perception modules
-```
-cyber_launch start /apollo/modules/perception/production/launch/perception_all.launch
-```
-
-9. Play your recorded bag
-```
-cyber_recorder play -f /apollo/data/bag/anybag -r 0.2
-```
+
+    - If you want to launch all modules 
+    ```
+    cyber_launch start /apollo/modules/perception/production/launch/perception_all.launch
+    ```
+
+    - If you want to test camera-based obstacle and lane detection
+    ```
+    cyber_launch start /apollo/modules/perception/production/launch/perception_camera.launch
+    ```
+
+9. If you want to visualize camera-based results overlaid on the captured image and in bird view, mark `enable_visualization: true` in `modules/perception/production/conf/perception/camera/fusion_camera_detection_component`
+
+10. Play your recorded bag
+    ```
+    cyber_recorder play -f /apollo/data/bag/anybag -r 0.2
+    ```
 
 Please note that the Nvidia driver should be installed appropriately even if the perception module is running in Caffe CPU_ONLY mode (i.e., using `./apollo.sh build` or `./apollo.sh build_opt` to build the perception module). Please see the detailed instruction of perception module in [the perception README](https://github.com/ApolloAuto/apollo/blob/master/modules/perception/README.md).

docs/specs/perception_apollo_5.0.md

@@ -101,3 +101,5 @@ The input of Planning and Control modules will be quite different with that of t
 
 The world coordinate system is used as ego-coordinate in 3D where the rear center axle is an origin.
 
+If you want to try our perception modules and their associated visualizer, please refer to the [following document](https://github.com/ApolloAuto/apollo/blob/master/docs/howto/how_to_run_perception_module_on_your_local_computer.md)
+