Writing User guide and use cases section.

1 files changed, 18 insertions, 0 deletions

diff --git a/docs/user_guide/areas_of_interest/vision_cone_filtering.md b/docs/user_guide/areas_of_interest/vision_cone_filtering.md
new file mode 100644
index 0000000..e2b31ea
--- /dev/null
+++ b/docs/user_guide/areas_of_interest/vision_cone_filtering.md
@@ -0,0 +1,18 @@
+Vision cone filtering
+=====================
+
+The AOI3D scene provides cone clipping support in order to select only AOI which are inside vision cone field. 
+
+![Vision cone](../../img/vision_cone.png)
+
+``` python
+# Transform scene into camera referential
+aoi3D_camera = aoi3D_scene.transform(tvec, rmat)
+
+# Get aoi inside vision cone field 
+# The vision cone tip is positionned behind the head
+aoi3D_inside, aoi3D_outside = aoi3D_camera.vision_cone(cone_radius=300, cone_height=150, cone_tip=[0., 0., -20.])
+
+# Keep only aoi inside vision cone field
+aoi3D_scene = aoi3D_scene.copy(exclude=aoi3D_outside.keys())
+```