Demo page details

Page source code: swe_3_sw_detailed_design.rst

{% set page="swe_3_sw_detailed_design.rst" %}
{% include "demo_page_header.rst" with context %}

.. _SWE3_Code_Documentation:

SWE.3 Detailed Design
=====================

This document provides the software implementation documentation as per SWE.1 and SWE.2 requirements.

.. automodule:: automotive_adas
   :members:
   :undoc-members:
   :show-inheritance:

SWE.3 Detailed Design

This document provides the software implementation documentation as per SWE.1 and SWE.2 requirements.

class automotive_adas.AdaptiveCruiseControl

Bases: object

Implementation: Radar-Based Distance Measurement IMPL_004

layout: adas signature: AdaptiveCruiseControl links outgoing: SWREQ_004, SWARCH_002

Measures distance to the vehicle ahead using radar.

Status:

adjust_speed(target_speed)

Implementation: Adaptive Speed Limits IMPL_006

layout: adas signature: adjust_speed links outgoing: SWREQ_013, SWARCH_002

Adjusts the speed to maintain legal limits and safe following distances.

Status:

measure_distance(radar_data)

Implementation: Speed Control Integration IMPL_005

layout: adas signature: measure_distance links outgoing: SWREQ_005, SWARCH_002

Adjusts vehicle speed dynamically based on radar measurements.

Status:

class automotive_adas.BlindSpotMonitor

Bases: object

Implementation: Blind Spot Sensor Fusion IMPL_016

status: open layout: adas signature: BlindSpotMonitor links outgoing: SWREQ_022, SWARCH_008

Fuses rear-corner radar and side-camera detections into a per-zone occupancy state.

Status: open

evaluate_lane_change(zones, turn_signal)

Implementation: Lane Change Intent Arbitration IMPL_018

status: open layout: adas signature: evaluate_lane_change links outgoing: SWREQ_023, SWARCH_008

Returns True when the turn signal points at an occupied blind spot zone.

Status: open

update_zone_occupancy(radar_tracks, camera_detections)

Implementation: Blind Spot Zone Update IMPL_017

status: open layout: adas signature: update_zone_occupancy links outgoing: SWREQ_022, SWARCH_008

Returns the occupancy state for the left and right blind spot zones.

Status: open

class automotive_adas.CollisionAvoidance

Bases: object

Implementation: Collision Risk Estimation IMPL_007

layout: adas signature: CollisionAvoidance links outgoing: SWREQ_006, SWARCH_003

Predicts collision risk using real-time sensor data.

Status:

apply_emergency_braking()

Implementation: Emergency Brake Activation IMPL_009

layout: adas signature: apply_emergency_braking links outgoing: SWREQ_007, SWARCH_003

Activates emergency braking when a collision is imminent.

Status:

detect_collision_risk(sensor_data)

Implementation: Multi-Object Tracking IMPL_008

layout: adas signature: detect_collision_risk links outgoing: SWREQ_015, SWARCH_003

Tracks multiple objects to assess potential collision risks.

Status:

class automotive_adas.DrowsinessMonitor

Bases: object

Implementation: Driver Drowsiness Monitor IMPL_019

status: open layout: adas signature: DrowsinessMonitor links outgoing: SWREQ_024, SWARCH_009

Aggregates eye-state observations from the cabin camera into a drowsiness score.

Status: open

DROWSY_THRESHOLD = 0.6

estimate_eye_state(frame)

Implementation: Eye Aspect Ratio Estimation IMPL_020

status: open layout: adas signature: estimate_eye_state links outgoing: SWREQ_024, SWARCH_009

Returns an eye-closed indicator derived from the input frame.

Status: open

update(frame)

Implementation: Drowsiness Score Aggregation IMPL_021

status: open layout: adas signature: update links outgoing: SWREQ_025, SWARCH_009

Updates the smoothed drowsiness score and reports whether an alert should fire.

Status: open

class automotive_adas.LaneDetection

Bases: object

Implementation: Lane Marking Detection Algorithm IMPL_001

layout: adas signature: LaneDetection links outgoing: SWREQ_001, SWARCH_001

Implements the lane marking detection algorithm using camera inputs.

Status:

apply_steering_correction(lane_data)

Implementation: Steering Correction Algorithm IMPL_003

layout: adas signature: apply_steering_correction links outgoing: SWREQ_003, SWARCH_001

Provides corrective steering actions to keep the vehicle within the lane.

Status:

detect_lane_markings(camera_feed)

Implementation: Lane Deviation Warning IMPL_002

layout: adas signature: detect_lane_markings links outgoing: SWREQ_002, SWARCH_001

Analyzes the camera feed to identify lane deviations and trigger warnings.

Status:

class automotive_adas.ParkingAssist

Bases: object

Implementation: Automated Parking Assist IMPL_022

status: open layout: adas signature: ParkingAssist links outgoing: SWREQ_026, SWARCH_010

Detects available parking slots and plans a park trajectory.

Status: open

MIN_PARALLEL_LENGTH = 5.0

MIN_PERPENDICULAR_WIDTH = 2.4

detect_slot(ultrasonic_readings, slot_kind)

Implementation: Parking Slot Recognition IMPL_023

status: open layout: adas signature: detect_slot links outgoing: SWREQ_026, SWARCH_010

Returns the first slot whose dimensions clear the configured minimum.

Status: open

plan_trajectory(slot)

Implementation: Park Trajectory Planning IMPL_024

status: open layout: adas signature: plan_trajectory links outgoing: SWREQ_027, SWARCH_010

Returns a list of waypoints leading into the chosen slot.

Status: open

class automotive_adas.PedestrianDetection

Bases: object

Implementation: Pedestrian Detection Algorithm IMPL_010

layout: adas signature: PedestrianDetection links outgoing: SWREQ_008, SWARCH_004

Detects pedestrians using a sensor fusion approach.

Status:

alert_driver()

Implementation: Pedestrian Alert System IMPL_012

layout: adas signature: alert_driver links outgoing: SWREQ_009, SWARCH_005

Alerts the driver with audio and visual warnings about detected pedestrians.

Status:

detect_pedestrians(sensor_data)

Implementation: Pedestrian Path Prediction IMPL_011

layout: adas signature: detect_pedestrians links outgoing: SWREQ_017, SWARCH_004

Predicts the movement of detected pedestrians.

Status:

initiate_emergency_brake()

Implementation: Emergency Braking for Pedestrians IMPL_013

layout: adas signature: initiate_emergency_brake links outgoing: SWREQ_010, SWARCH_006

Applies emergency braking to prevent collisions with pedestrians.

Status:

class automotive_adas.TrafficSignRecognition

Bases: object

Implementation: Speed Limit Sign Detection IMPL_014

status: closed layout: adas signature: TrafficSignRecognition links outgoing: SWREQ_021, SWARCH_007

Detects posted speed limit signs from front camera input.

Status: closed

detect_speed_limit(camera_feed)

Implementation: Speed Limit Publication IMPL_015

status: closed layout: adas signature: detect_speed_limit links outgoing: SWREQ_021, SWARCH_007

Extracts and returns the recognized speed limit for downstream consumers.

Status: closed