mirror of https://github.com/azaion/detections.git synced 2026-04-22 22:56:31 +00:00

Files

T

Oleksandr Bezdieniezhnykh 1fe9425aa8 [AZ-172] Update documentation for distributed architecture, add Update Docs step to workflow

- Update module docs: main, inference, ai_config, loader_http_client
- Add new module doc: media_hash
- Update component docs: inference_pipeline, api
- Update system-flows (F2, F3) and data_parameters
- Add Task Mode to document skill for incremental doc updates
- Insert Step 11 (Update Docs) in existing-code flow, renumber 11-13 to 12-14

Made-with: Cursor

2026-03-31 17:25:58 +03:00

2.3 KiB

Raw Blame History

Module: ai_config

Purpose

Data class holding all AI recognition configuration parameters, with factory method for deserialization from dict format.

Public Interface

Class: AIRecognitionConfig

Fields

Field	Type	Default	Description
`frame_period_recognition`	int	4	Process every Nth frame in video
`frame_recognition_seconds`	double	2.0	Minimum seconds between valid video annotations
`probability_threshold`	double	0.25	Minimum detection confidence
`tracking_distance_confidence`	double	0.0	Distance threshold for tracking (model-width units)
`tracking_probability_increase`	double	0.0	Required confidence increase for tracking update
`tracking_intersection_threshold`	double	0.6	IoU threshold for overlapping detection removal
`model_batch_size`	int	1	Batch size for inference
`big_image_tile_overlap_percent`	int	20	Tile overlap percentage for large image splitting
`altitude`	double	400	Camera altitude in meters
`focal_length`	double	24	Camera focal length in mm
`sensor_width`	double	23.5	Camera sensor width in mm

Methods

Method	Signature	Description
`from_dict`	`(dict data) -> AIRecognitionConfig`	Static cdef; deserializes from Python dict

Internal Logic

from_dict applies defaults for missing keys using full descriptive key names.

Removed: paths field and file_data field were removed as part of the distributed architecture shift (AZ-174). Media paths are now resolved via the Annotations service API, not passed in config. from_msgpack() was also removed as it was unused.

Dependencies

External: none
Internal: none (leaf module)

Consumers

inference — creates config from dict, uses all fields for frame selection, detection filtering, image tiling, and tracking

Data Models

AIRecognitionConfig — the sole data class

Configuration

Camera/altitude parameters (altitude, focal_length, sensor_width) are used for ground sampling distance calculation in aerial image processing.

External Integrations

None.

Security