/dvs/git/dirty/gitlab-master_av/dw/sdk/samples/waitcondition/intersectionDetector/README.md

Go to the documentation of this file.

# Copyright (c) 2019-2020, NVIDIA CORPORATION.  All rights reserved.

@page dwx_sample_intersection_detector Intersection Detection Sample (WaitNet)
@tableofcontents

@note SW Release Applicability: This sample is available in **NVIDIA DRIVE Software** releases.

@section dwx_sample_intersection_detector_description Description

The Intersection Detection sample demonstrates how to use the NVIDIA® proprietary WaitNet deep neural network (DNN) to detect intersections.
It reads video streams sequentially. For each frame, it detects the
intersection location.

@section dwx_sample_intersection_detector_usage Running the Sample

The command line for the sample is:

    ./sample_intersection_detector --rig=[path/to/rig/file]
                                   --liveCam=[0|1]

where

    --rig=[path/to/rig/file]
        Rig file containing all information about vehicle sensors and calibration.
        Default value with video: path/to/data/samples/waitcondition/rig.json
        Default value with live camera: path/to/data/samples/waitcondition/live_cam_rig.json

    --liveCam=[0|1]
        Use live camera or video file. Takes no effect on x86.
        Need to be set to 1 if passing in a rig with live camera setup.
        To switch the mode, pass `--liveCam=0/1` as the argument.
        Default value: 0

@note The live camera type in rig file is a supported `RCCB` sensor.
See @ref supported_sensors for the list of supported cameras for each platform.
The video type in rig file can be raw or h264.

@subsection dwx_sample_intersection_detector_examples Examples

#### Running the sample with default rig file with video

     ./sample_intersection_detector

#### Running the sample with rig file with live camera

    ./sample_intersection_detector --liveCam=1

@section dwx_sample_intersection_detector_output Output

The sample creates a window, displays the video stream, and overlays the bounding box of the detected intersection.
When the ego car approaches to an intersection, bottom of the visualized bounding box aligns with stop line.
When the ego car is within an intersection, the visualized bounding box covers entire image area.

![Intersection Detector Sample](sample_intersection_detector.png)

@section dwx_sample_intersection_detector_more Additional Information

For more details see @ref waitcondition_mainsection.