From ffdcbab238e20f61c4b9f0c6451ebdabc9565b21 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?G=C3=B6ktu=C4=9F=20Karaka=C5=9Fl=C4=B1?=
<20567087+goktug97@users.noreply.github.com>
Date: Thu, 2 Jan 2020 19:50:02 +0300
Subject: [PATCH] add documentation
---
README.md | 506 ++++++++++++++++++++++++++++++++++++++++-
dwa.gif | Bin 0 -> 12369736 bytes
examples/demo.c | 85 ++++---
examples/demo.py | 1 +
img/dynamic_window.jpg | Bin 0 -> 22900 bytes
src/dwa.c | 23 +-
6 files changed, 566 insertions(+), 49 deletions(-)
create mode 100644 dwa.gif
create mode 100644 img/dynamic_window.jpg
diff --git a/README.md b/README.md
index 7a576ca..c0b400c 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,509 @@
Dynamic Window Approach
===================================
-### License
+2D Dynamic Window Approach [[1]](#ref1) Motion Planning algorithm written in C with Python Bindings.
+
+
+
+
+**Table of Contents**
+
+- [Dynamic Window Approach](#dynamic-window-approach)
+ - [Requirements](#requirements)
+ - [Python](#python)
+ - [C Libraries (Optional for the Demo)](#c-libraries-optional-for-the-demo)
+ - [Installation](#installation)
+ - [Compile and Install C Library](#compile-and-install-c-library)
+ - [Install Python Bindings](#install-python-bindings)
+ - [PyPI](#pypi)
+ - [Source](#source)
+ - [Usage](#usage)
+ - [Documentation](#documentation)
+ - [Structs and Classes](#structs-and-classes)
+ - [Rect](#rect)
+ - [Config](#config)
+ - [Velocity](#velocity)
+ - [Point](#point)
+ - [PointCloud](#pointcloud)
+ - [Pose](#pose)
+ - [DynamicWindow](#dynamicwindow)
+ - [Functions](#functions)
+ - [planning](#planning)
+ - [createDynamicWindow](#createdynamicwindow)
+ - [freeDynamicWindow](#freedynamicwindow)
+ - [motion](#motion)
+ - [calculateVelocityCost](#calculatevelocitycost)
+ - [calculateHeadingCost](#calculateheadingcost)
+ - [calculateClearanceCost](#calculateclearancecost)
+ - [createPointCloud](#createpointcloud)
+ - [freePointCloud](#freepointcloud)
+ - [References](#references)
+ - [License](#license)
+
+
+
+## Requirements
+
+### Python
+
+* Python >= 3.6
+* cython
+* numpy
+* cv2 (Optional for the demo)
+
+### C Libraries (Optional for the Demo)
+
+* SDL
+* OpenGL
+
+## Installation
+
+You can directly install Python bindings without compiling the library.
+
+### Compile and Install C Library
+
+```bash
+git clone https://github.com/goktug97/DynamicWindowApproach
+cd DynamicWindowApproach
+mkdir build
+cd build
+cmake ..
+make
+make install
+# Optional: Build Demo
+make demo
+```
+
+### Install Python Bindings
+
+#### PyPI
+
+```bash
+pip3 install dynamic-window-approach --user
+```
+
+#### Source
+
+```bash
+git clone https://github.com/goktug97/DynamicWindowApproach
+cd DynamicWindowApproach
+python3 setup.py install --user
+```
+
+## Usage
+
+- Only function you need to run to plan the next move is the
+[planning](#planning) function. Rest of the code for both C and
+Python examples are just to create simulation environment and GUI.
+The 2 examples that you can find in
+[examples](https://github.com/goktug97/DynamicWindowApproach/blob/master/examples/)
+folder is the same demo but implemented using different libraries for
+visualization.
+
+- The Python example uses OpenCV and you can run it by executing `python3 demo.py`
+in the examples folder.
+
+- The C example uses OpenGL and SDL and you can run it by executing `./demo` in
+bin folder. The bin folder is created after the compile so if you didn't
+compile the demo while installing the library. Go to `build` directory and run
+`make demo`.
+
+- There is also a web application demo in
+a different repository which can be find at [DWA Web
+Demo](https://github.com/goktug97/DWAWebDemo).
+
+## Documentation
+
+While the [planning](#planning) function is the only function that a user needs
+to call for the planning, all of the functions are exposed to the user
+for both C and Python for no reasons.
+
+### Structs and Classes
+If you are using Python bindings, you don't need to use any of these
+classes except [Config](#config). The functions accept built-in or
+numpy types. The functions create required classes inside for easy
+usage. For example a snippet from the [planning](#planning) function;
+
+``` cython
+cdef float x, y, yaw, v , w, gx, gy
+cdef PointCloud _point_cloud = PointCloud(point_cloud)
+x, y, yaw = pose
+v, w = velocity
+gx, gy = goal
+cdef Pose _pose = Pose(Point(x, y), yaw)
+cdef Velocity _velocity = Velocity(v, w)
+cdef Point _goal = Point(gx, gy)
+```
+
+- Structs are for C
+- Classes are for Python
+
+#### Rect
+
+- *struct* Rect
+
+ * Given center of the robot is (0, 0)
+ * **Parameters**:
+ - **xmin** - floating-point minimum x-coordinate of the robot.
+ - **ymin** - floating-point minimum y-coordinate of the robot.
+ - **xmax** - floating-point maximum x-coordinate of the robot.
+ - **ymax** - floating-point maximum y-coordinate of the robot.
+
+#### Config
+
+- *struct* Config
+
+ * **Parameters**:
+ - **maxSpeed** - floating-point maximum linear speed robot can reach [m/s]
+ - **minSpeed** - floating-point minimum linea speed robot can fall [m/s]
+ - **maxYawrate** - floating-point maximum angular spped robot can reach [yaw/s]
+ - **maxAccel** - floating-point maximum linear acceleration robot can reach [m/ss]
+ - **maxdYawrate** - floating-point maximum angular acceleration robot can reach [yaw/ss]
+ - **velocityResolution** - floating-point linear speed resolution [m/s]
+ - **yawrateResolution** - floating-point angular speed resolution [m/s]
+ - **dt** - floating-point time change [s]
+ - **predictTime** - floating-point simulation time [s]
+ - **heading** - floating-point heading cost weight
+ - **clearance** - floating-point clearance cost weight
+ - **velocity** - floating-point velocity cost weight
+ - **base** - [Rect](#rect)
+
+- *class* Config
+
+ ``` python
+ Config(float max_speed, float min_speed,
+ float max_yawrate, float max_accel, float max_dyawrate,
+ float velocity_resolution, float yawrate_resolution, float dt,
+ float predict_time, float heading, float clearance, float velocity,
+ list base)
+ ```
+
+#### Velocity
+
+- *struct* Velocity
+
+ * **Parameters**:
+ - **linearVelocity** - floating-point linear velocity of the robot [m/s]
+ - **angularVelocity** - floating-point angular velocity of the robot [yaw/s]
+
+- *class* Velocity
+
+ ``` python
+ Velocity(float linear_velocity, float angular_velocity)
+ ```
+
+#### Point
+
+- *struct* Point
+
+ * **Parameters**:
+ - **x** – floating-point x-coordinate of the point.
+ - **y** – floating-point y-coordinate of the point.
+
+- *class* Point
+
+ ``` python
+ Point(float x, float y)
+ ```
+
+#### PointCloud
+
+- *struct* PointCloud
+
+ * int **size**
+ - Number of points.
+ * Point ***points**
+ - Array of [points](#point).
+
+- *class* PointCloud
+
+ ``` python
+ PointCloud(np.ndarray[np.float32_t, ndim=2] point_cloud)
+ ```
+
+#### Pose
+
+- *struct* Pose
+ * Point **point**
+ - Coordinate of the robot.
+ * float **yaw**
+ - Angle of the robot.
+
+- *class* Pose
+
+ ``` python
+ Pose(Point point, float yaw)
+ ```
+
+#### DynamicWindow
+
+- *struct* DynamicWindow
+ * int **nPossibleV**:
+ - Number of linear velocities in the Dynamic Window.
+ * float ***possibleV**:
+ - Array of linear velocities with resolution of [Config.velocityResolution](#config)
+ * int **nPossibleW**:
+ - Number of angular velocities in the Dynamic Window
+ * float ***possibleW**:
+ - Array of angular velocities with resolution of [Config.yawrateResolution](#config)
+
+- *class* DynamicWindow
+
+ ```python
+ DynamicWindow(tuple velocity, Config config)
+ ```
+
+### Functions
+
+#### planning
+
+Calculates best linear and angular velocities given the state. Only
+required function to use this library.
+
+- C
+
+ ``` c++
+ Velocity planning (Pose pose, Velocity velocity, Point goal, PointCloud *pointCloud, Config config);
+ ```
+
+ * **Parameters:**
+ - **pose:** [Pose](#pose)
+ - **velocity:** [Velocity](#velocity)
+ - **goal:** [Point](#point)
+ - **pointCloud:** [PointCloud](#pointcloud)
+ - **config:** [Config](#config)
+
+- Python
+
+ ``` python
+ linear_velocity, angular_velocity = planning(pose, velocity, goal, point_cloud, config)
+ ```
+
+ * **Parameters:**
+ - **pose:** tuple: (x, y, yaw)
+ - **velocity:** tuple: (Linear Velocity, Angular Velocity)
+ - **goal:** tuple: (x, y)
+ - **point_cloud:** Numpy Array of shape (N, 2) and type np.float32
+ - **config:** [Config](#config)
+
+#### createDynamicWindow
+
+Given robot configuration and current velocities, calculates [DynamicWindow](#dynamicwindow).
+The memory is allocated dynamically inside of the function and must be freed using
+[freeDynamicWindow](#freedynamicwindow) function.
+
+- C
+
+ ``` c++
+ void createDynamicWindow(Velocity velocity, Config config, DynamicWindow **dynamicWindow);
+ ```
+
+ * **Parameters:**
+ - **velocity:** [Velocity](#velocity)
+ - **config:** [Config](#config)
+ - **dynamicWindow:** [DynamicWindow](#dynamicwindow)
+
+- Python
+
+ [DynamicWindow](#dynamicwindow) class is used to create a DynamicWindow instance.
+
+ ``` python
+ dw = dwa.DynamicWindow(velocity, config):
+ print(dw.possible_v, dw.possible_w)
+ ```
+
+ * **Parameters:**
+ - **velocity:** tuple: (Linear Velocity, Angular Velocity)
+ - **config:** [Config](#config) class
+
+[Dynamic Window [2]](https://raw.githubusercontent.com/goktug97/DynamicWindowApproach/master/img/dynamic_window.jpg)
+
+#### freeDynamicWindow
+
+Free dynamically allocated memory.
+
+- C
+
+ ``` c++
+ void freeDynamicWindow(DynamicWindow *dynamicWindow);
+ ```
+
+ * **Parameters:**
+ - **dynamicWindow:** [DynamicWindow](#dynamicwindow)
+
+- Python
+
+ Handled by the [DynamicWindow](#dynamicwindow) class. See below.
+
+ ``` python
+ def __dealloc__(self):
+ if self.thisptr is not NULL:
+ cdwa.freeDynamicWindow(self.thisptr)
+
+ ```
+
+#### motion
+
+Given current position and velocities, calculates next position after
+given dt using differential drive motion model. Can be used to
+simulate motion in a simulated environment.
+
+- C
+
+ ``` c++
+ Pose motion(Pose pose, Velocity velocity, float dt);
+ ```
+
+ * **Parameters:**
+ - **pose:** [Pose](#pose)
+ - **velocity:** [Velocity](#velocity)
+ - **dt:** float (seconds)
+
+- Python
+
+ ``` python
+ x, y, yaw = motion(pose, velocity, dt)
+ ```
+
+ * **Parameters:**
+ - **pose:** tuple: (x, y, yaw)
+ - **velocity:** tuple: (Linear Velocity, Angular Velocity)
+
+#### calculateVelocityCost
+
+- C
+
+ ``` c++
+ float calculateVelocityCost(Velocity velocity, Config config);
+ ```
+
+ * **Parameters:**
+ - **velocity:** [Velocity](#velocity)
+ - **config:** [Config](#config)
+
+- Python
+
+ ``` python
+ velocity_cost = calculate_velocity_cost(velocity, config)
+ ```
+
+ * **Parameters:**
+ - **velocity:** tuple: (Linear Velocity, Angular Velocity)
+ - **config:** [Config](#config)
+
+#### calculateHeadingCost
+
+- C
+
+ ``` c++
+ float calculateHeadingCost(Pose pose, Point goal);
+ ```
+
+ * **Parameters:**
+ - **pose:** [Pose](#pose)
+ - **goal:** [Point](#point)
+
+- Python
+
+ ``` python
+ heading_cost = calculate_heading_cost(pose, goal)
+ ```
+
+ * **Parameters:**
+ - **pose:** tuple: (x, y, yaw)
+ - **goal:** tuple: (x, y)
+
+#### calculateClearanceCost
+
+- C
+
+ ``` c++
+ float calculateClearanceCost(Pose pose, Velocity velocity, PointCloud *pointCloud, Config config);
+ ```
+
+ * **Parameters:**
+ - **pose:** [Pose](#pose)
+ - **velocity:** [Velocity](#velocity)
+ - **pointCloud:** [PointCloud](#pointcloud)
+ - **config:** [Config](#config)
+
+- Python
+
+ ``` python
+ def calculate_clearance_cost(pose, velocity, point_cloud, config):
+ ```
+
+ * **Parameters:**
+ - **pose:** tuple: (x, y, yaw)
+ - **velocity:** tuple: (Linear Velocity, Angular Velocity)
+ - **point_cloud:** Numpy Array of shape (N, 2) and type np.float32
+ - **config:** [Config](#config)
+
+#### createPointCloud
+
+Given a size, creates a [PointCloud](#pointcloud). Must be freed using [freePointCloud](#freepointcloud).
+
+- C
+
+ ``` c++
+ PointCloud* createPointCloud(int size);
+ ```
+
+ ``` c++
+ for (int i = 0; i < pointCloud->size; ++i) {
+ pointCloud->points[i].x = 0.0
+ pointCloud->points[i].y = 0.0
+ }
+ ```
+
+ * **Parameters:**
+ - **size:** int
+
+- Python
+
+ [PointCloud](#pointcloud) class is used to create a PointCloud instance. All
+ functions in python accepts numpy array instead of PointCloud instance. The
+ PointCloud instance is created inside of the function.
+
+ ``` python
+ size = 600
+ point_cloud = np.zeros((size, 2), dtype=np.float32)
+ point_cloud = dwa.PointCloud(point_cloud)
+ ```
+
+#### freePointCloud
+
+- C
+
+ ``` c++
+ void freePointCloud(PointCloud* pointCloud);
+ ```
+
+ * **Parameters:**
+ - **pointCloud:** [PointCloud](#pointcloud)
+
+- Python
+
+ Handled by the [PointCloud](#pointcloud) class. See below.
+
+ ``` python
+ def __dealloc__(self):
+ if self.thisptr is not NULL:
+ cdwa.freePointCloud(self.thisptr)
+ ```
+
+## References
+
+
+
+1. D. Fox, W. Burgard and S. Thrun, "The dynamic window approach to
+collision avoidance," in IEEE Robotics & Automation Magazine, vol. 4,
+no. 1, pp. 23-33, March 1997. doi: 10.1109/100.580977 URL:
+http://ieeexplore.ieee.org/stamp/stamp.jsp?tp=&arnumber=580977&isnumber=12589
+
+
+
+2. http://ais.informatik.uni-freiburg.de/teaching/ss19/robotics/slides/19-pathplanning-long.pdf
+
+## License
MIT License.
diff --git a/dwa.gif b/dwa.gif
new file mode 100644
index 0000000000000000000000000000000000000000..a519b5e971b3c15c41e6544fb781f459b0122021
GIT binary patch
literal 12369736
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