APEXPRIT's picture
Upload folder using huggingface_hub
59f824e verified
Raw History Blame
4.97 kB
"""Configuration objects for the deception analysis system.
This module centralizes path, feature extraction, model, and temporal analysis
settings so downstream components can share a consistent configuration surface.
"""
from __future__ import annotations
from dataclasses import dataclass, field
from pathlib import Path
from typing import Tuple
@dataclass(frozen=True)
class ProjectConfig:
"""Filesystem paths used throughout the project.
Attributes:
root_dir: Root directory for the project repository.
src_dir: Source package directory.
data_dir: Directory containing datasets and samples.
sample_data_dir: Directory containing small sample inputs.
model_dir: Directory for serialized model artifacts.
results_dir: Directory for metrics, reports, and predictions.
docs_dir: Documentation directory.
notebooks_dir: Exploratory notebooks directory.
demo_dir: Demo application directory.
"""
root_dir: Path = field(default_factory=lambda: Path(__file__).resolve().parents[2])
src_dir: Path = field(init=False)
data_dir: Path = field(init=False)
sample_data_dir: Path = field(init=False)
model_dir: Path = field(init=False)
results_dir: Path = field(init=False)
docs_dir: Path = field(init=False)
notebooks_dir: Path = field(init=False)
demo_dir: Path = field(init=False)
def __post_init__(self) -> None:
"""Derive project paths from the configured root directory."""
object.__setattr__(self, "src_dir", self.root_dir / "src")
object.__setattr__(self, "data_dir", self.root_dir / "data")
object.__setattr__(self, "sample_data_dir", self.root_dir / "data" / "sample")
object.__setattr__(self, "model_dir", self.root_dir / "models")
object.__setattr__(self, "results_dir", self.root_dir / "results")
object.__setattr__(self, "docs_dir", self.root_dir / "docs")
object.__setattr__(self, "notebooks_dir", self.root_dir / "notebooks")
object.__setattr__(self, "demo_dir", self.root_dir / "demo")
@dataclass(frozen=True)
class FeatureConfig:
"""Facial and behavioral feature extraction parameters."""
fps: float = 30.0
eye_openness_threshold: float = 0.22
mouth_openness_threshold: float = 0.35
eyebrow_tension_threshold: float = 0.18
gaze_shift_threshold: float = 0.15
head_pose_threshold_degrees: float = 20.0
blink_duration_threshold_frames: int = 3
micro_expression_window_frames: int = 15
landmark_smoothing_alpha: float = 0.6
min_face_detection_confidence: float = 0.6
min_face_tracking_confidence: float = 0.5
face_mesh_refine_landmarks: bool = True
@dataclass(frozen=True)
class AudioConfig:
"""Audio feature extraction parameters for speech analysis."""
sample_rate: int = 22050
hop_length: int = 512
n_fft: int = 2048
n_mfcc: int = 13
n_mels: int = 128
fmin: float = 50.0
fmax: float = 8000.0
trim_top_db: int = 30
silence_threshold_db: float = -40.0
pitch_floor_hz: float = 75.0
pitch_ceiling_hz: float = 600.0
jitter_window_seconds: float = 0.04
speaking_rate_window_seconds: float = 2.0
@dataclass(frozen=True)
class ModelConfig:
"""Machine learning model and calibration parameters."""
n_estimators: int = 200
learning_rate: float = 0.1
max_depth: int = 5
min_samples_split: int = 4
min_samples_leaf: int = 2
subsample: float = 0.9
random_state: int = 42
validation_size: float = 0.2
calibration_method: str = "isotonic"
cross_validation_folds: int = 5
class_weight_strategy: str = "balanced"
decision_threshold: float = 0.5
@dataclass(frozen=True)
class TemporalConfig:
"""Temporal analysis parameters for deception probability trajectories."""
window_size: int = 30
spike_threshold: float = 0.7
min_suspicious_duration: int = 10
smoothing_window: int = 5
baseline_window_size: int = 60
subject_adaptation_rate: float = 0.15
cooldown_frames: int = 15
trend_slope_threshold: float = 0.02
aggregation_percentiles: Tuple[int, int, int] = (50, 75, 90)
@dataclass(frozen=True)
class AppConfig:
"""Combined configuration object for the full system."""
project: ProjectConfig = field(default_factory=ProjectConfig)
features: FeatureConfig = field(default_factory=FeatureConfig)
audio: AudioConfig = field(default_factory=AudioConfig)
model: ModelConfig = field(default_factory=ModelConfig)
temporal: TemporalConfig = field(default_factory=TemporalConfig)
def get_default_config() -> AppConfig:
"""Return the default combined configuration for the project.
Returns:
AppConfig: A fully populated immutable configuration object.
"""
return AppConfig()