SWE.3 Detailed Design¶

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

Codelinks example¶

Using C language.

Implementation: AdaptiveCruiseModule struct IMPL_ACC_MODULE

local-url: ../c/acc#L9;

remote-url: src/c/acc.c#L9;

implements: SWREQ_004, SWREQ_005, SWREQ_006, SWREQ_007

Implementation: LaneKeepingModule struct IMPL_LKA_MODULE

local-url: ../c/lane_keeping#L9;

remote-url: src/c/lane_keeping.c#L9;

implements: SWREQ_001, SWREQ_002, SWREQ_003

Implementation: detect_lane_markings IMPL_LKA_DETECT

local-url: ../c/lane_keeping#L16;

remote-url: src/c/lane_keeping.c#L16;

implements: SWREQ_001

Implementation: measure_radar_distance IMPL_ACC_DISTANCE

local-url: ../c/acc#L17;

remote-url: src/c/acc.c#L17;

implements: SWREQ_004

Implementation: check_lane_deviation IMPL_LKA_DEVIATION

local-url: ../c/lane_keeping#L27;

remote-url: src/c/lane_keeping.c#L27;

implements: SWREQ_002

Implementation: adjust_speed IMPL_ACC_SPEED

local-url: ../c/acc#L28;

remote-url: src/c/acc.c#L28;

implements: SWREQ_005, SWREQ_013

Implementation: evaluate_collision_risk IMPL_ACC_RISK

local-url: ../c/acc#L39;

remote-url: src/c/acc.c#L39;

implements: SWREQ_006, SWREQ_007

Implementation: apply_steering_correction IMPL_LKA_CORRECTION

local-url: ../c/lane_keeping#L39;

remote-url: src/c/lane_keeping.c#L39;

implements: SWREQ_003

Automodule example¶

Using Python language.

class automotive_adas.AdaptiveCruiseControl[source]¶

Bases: object

Implementation: Radar-Based Distance Measurement IMPL_004

signature: AdaptiveCruiseControl

links outgoing: SWARCH_002, SWREQ_004

Measures distance to the vehicle ahead using radar.

adjust_speed(target_speed)[source]¶

Implementation: Adaptive Speed Limits IMPL_006

signature: adjust_speed

links outgoing: SWARCH_002, SWREQ_013

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

measure_distance(radar_data)[source]¶

Implementation: Speed Control Integration IMPL_005

signature: measure_distance

links outgoing: SWARCH_002, SWREQ_005

Adjusts vehicle speed dynamically based on radar measurements.

class automotive_adas.BlindSpotMonitor[source]¶

Bases: object

Implementation: Blind Spot Sensor Fusion IMPL_016

status: open

signature: BlindSpotMonitor

links outgoing: SWARCH_008, SWREQ_022

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

evaluate_lane_change(zones, turn_signal)[source]¶

Implementation: Lane Change Intent Arbitration IMPL_018

status: open

signature: evaluate_lane_change

links outgoing: SWARCH_008, SWREQ_023

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

update_zone_occupancy(radar_tracks, camera_detections)[source]¶

Implementation: Blind Spot Zone Update IMPL_017

status: open

signature: update_zone_occupancy

links outgoing: SWARCH_008, SWREQ_022

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

class automotive_adas.CollisionAvoidance[source]¶

Bases: object

Implementation: Collision Risk Estimation IMPL_007

signature: CollisionAvoidance

links outgoing: SWARCH_003, SWREQ_006

Predicts collision risk using real-time sensor data.

apply_emergency_braking()[source]¶

Implementation: Emergency Brake Activation IMPL_009

signature: apply_emergency_braking

links outgoing: SWARCH_003, SWREQ_007

Activates emergency braking when a collision is imminent.

detect_collision_risk(sensor_data)[source]¶

Implementation: Multi-Object Tracking IMPL_008

signature: detect_collision_risk

links outgoing: SWARCH_003, SWREQ_015

Tracks multiple objects to assess potential collision risks.

class automotive_adas.DrowsinessMonitor[source]¶

Bases: object

Implementation: Driver Drowsiness Monitor IMPL_019

status: open

signature: DrowsinessMonitor

links outgoing: SWARCH_009, SWREQ_024

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

DROWSY_THRESHOLD = 0.6¶

estimate_eye_state(frame)[source]¶

Implementation: Eye Aspect Ratio Estimation IMPL_020

status: open

signature: estimate_eye_state

links outgoing: SWARCH_009, SWREQ_024

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

update(frame)[source]¶

Implementation: Drowsiness Score Aggregation IMPL_021

status: open

signature: update

links outgoing: SWARCH_009, SWREQ_025

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

class automotive_adas.LaneDetection[source]¶

Bases: object

Implementation: Lane Marking Detection Algorithm IMPL_001

signature: LaneDetection

links outgoing: SWARCH_001, SWREQ_001

Implements the lane marking detection algorithm using camera inputs.

apply_steering_correction(lane_data)[source]¶

Implementation: Steering Correction Algorithm IMPL_003

signature: apply_steering_correction

links outgoing: SWARCH_001, SWREQ_003

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

detect_lane_markings(camera_feed)[source]¶

Implementation: Lane Deviation Warning IMPL_002

signature: detect_lane_markings

links outgoing: SWARCH_001, SWREQ_002

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

class automotive_adas.ParkingAssist[source]¶

Bases: object

Implementation: Automated Parking Assist IMPL_022

status: open

signature: ParkingAssist

links outgoing: SWARCH_010, SWREQ_026

Detects available parking slots and plans a park trajectory.

MIN_PARALLEL_LENGTH = 5.0¶

MIN_PERPENDICULAR_WIDTH = 2.4¶

detect_slot(ultrasonic_readings, slot_kind)[source]¶

Implementation: Parking Slot Recognition IMPL_023

status: open

signature: detect_slot

links outgoing: SWARCH_010, SWREQ_026

Returns the first slot whose dimensions clear the configured minimum.

plan_trajectory(slot)[source]¶

Implementation: Park Trajectory Planning IMPL_024

status: open

signature: plan_trajectory

links outgoing: SWARCH_010, SWREQ_027

Returns a list of waypoints leading into the chosen slot.

class automotive_adas.PedestrianDetection[source]¶

Bases: object

Implementation: Pedestrian Detection Algorithm IMPL_010

signature: PedestrianDetection

links outgoing: SWARCH_004, SWREQ_008

Detects pedestrians using a sensor fusion approach.

alert_driver()[source]¶

Implementation: Pedestrian Alert System IMPL_012

signature: alert_driver

links outgoing: SWARCH_005, SWREQ_009

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

detect_pedestrians(sensor_data)[source]¶

Implementation: Pedestrian Path Prediction IMPL_011

signature: detect_pedestrians

links outgoing: SWARCH_004, SWREQ_017

Predicts the movement of detected pedestrians.

initiate_emergency_brake()[source]¶

Implementation: Emergency Braking for Pedestrians IMPL_013

signature: initiate_emergency_brake

links outgoing: SWARCH_006, SWREQ_010

Applies emergency braking to prevent collisions with pedestrians.

class automotive_adas.TrafficSignRecognition[source]¶

Bases: object

Implementation: Speed Limit Sign Detection IMPL_014

status: closed

signature: TrafficSignRecognition

links outgoing: SWARCH_007, SWREQ_021

Detects posted speed limit signs from front camera input.

detect_speed_limit(camera_feed)[source]¶

Implementation: Speed Limit Publication IMPL_015

status: closed

signature: detect_speed_limit

links outgoing: SWARCH_007, SWREQ_021

Extracts and returns the recognized speed limit for downstream consumers.