diff --git a/README.md b/README.md new file mode 100644 index 00000000..e70221d2 --- /dev/null +++ b/README.md @@ -0,0 +1,255 @@ +# PJM/IA – Police Interview Emotion Analysis System + +## Overview + +PJM/IA is an intelligent support platform designed to assist criminal investigators during interviews and interrogations through multimodal emotion analysis. + +The system combines multiple Artificial Intelligence approaches to analyze emotional behavior from: + +- Facial expressions (FER – Facial Emotion Recognition) +- Voice tone (SER – Speech Emotion Recognition) +- Natural language sentiment analysis + +In addition to emotion analysis, the platform automates the administrative workflow associated with interviews by generating official reports automatically and producing annotated multimedia evidence. + +--- + +## Main Features + +### Emotion Recognition + +- Facial Emotion Recognition (FER) +- Speech Emotion Recognition (SER) +- Sentiment Analysis using NLP + +### Automatic Documentation + +- Automatic generation of: + - Complaint Reports + - Witness Examination Reports + - Defendant Interrogation Reports +- Automatic PDF report generation +- Automatic transcription of interview audio into text + +### Multimedia Processing + +- Video analysis +- Audio analysis +- Live camera streaming analysis + +### Evidence Generation + +- Annotated interview videos +- Emotion timeline tracking every 10 seconds +- Structured interview archive system + +--- + +# System Architecture + +The application is divided into modular components: + +| Module | Description | +|---|---| +| FER | Facial expression emotion recognition | +| SER | Voice emotion analysis | +| NLP | Sentiment analysis from speech transcription | +| Document Engine | Automatic report generation | +| Streaming Engine | Real-time camera processing | + +--- + +# Supported Inputs + +## Video Formats + +- `.mp4` +- `.avi` +- `.mov` + +## Audio Formats + +- `.mp3` +- `.wav` +- `.ogg` + +--- + +# Technical Requirements + +| Component | Minimum | Recommended | +|---|---|---| +| RAM | 8GB | 16GB | +| Operating System | Windows XP | Windows 10+ | +| Camera | USB Camera | USB Camera | +| Microphone | USB Microphone | USB Microphone | +| Storage | 5GB | SSD Recommended | + +--- + +# Installation + +## Windows Installation + +Run: + +```bash +PJM_IA_Installer.exe +``` + +Follow the installation wizard until completion. + +The installer will: + +- Install the application +- Create the required directories +- Generate a desktop shortcut + +--- + +# Authentication + +Default credentials for testing purposes: + +```txt +Username: kl3z +Password: 12345 +``` + +--- + +# Usage + +## 1. Load Subject Information + +The investigator must first load: + +- Citizen Card (CC) +or +- Military Registration Sheet (FM) + +This information is mandatory. + +--- + +## 2. Configure Interview Metadata + +Optional metadata: + +- Interviewer +- Date +- Time +- Location +- City + +--- + +## 3. Choose Analysis Mode + +### Video Analysis + +Processes prerecorded interrogation videos. + +### Audio Analysis + +Processes audio recordings. + +### Live Streaming + +Processes live camera input in real-time. + +Press: + +```txt +Q +``` + +to stop recording. + +--- + +# Generated Output + +After processing, the system generates: + +- Official PJM Word reports +- PDF summary report +- Full interview transcription +- Emotion analysis reports +- Annotated video files + +All files are stored automatically in: + +```txt +/Corpus/__