Awesome

Neuro Symbolic Video Search with Temporal Logic (NSVS-TL)

Table of Contents

• TL;DR
• Abstract
• Installation Guide
• System Setup and Execution Guide
• Running the System
• Citation

TL;DR

This paper introduces a neuro-symbolic video search framework that marries the capabilities of neural networks for frame-by-frame perception with the structured reasoning of temporal logic. This hybrid approach allows for advanced querying of massive video datasets, such as those from YouTube, autonomous vehicles, and security systems. By separating the tasks of perception and temporal reasoning, our method overcomes the limitations of current video-language models in accurately localizing specific scenes within lengthy videos. This innovation not only enhances the precision of video searches but also facilitates the handling of complex queries that require understanding the temporal relationships between events in video content.

Abstract

System Overview

The input query --- "Find the I'm Flying scene from Titanic" --- is first decomposed into semantically meaningful atomic propositions such as man hugging woman, ship on the sea, and kiss from a high-level user query. SOTA vision and vision-language models are then employed to annotate the existence of these atomic propositions in each video frame. Subsequently, we construct a probabilistic automaton that models the video's temporal evolution based on the list of per-frame atomic propositions detected in the video. Finally, we evaluate when and where this automaton satisfies the user's query. We do this by expressing it in a formal specification language that incorporates temporal logic. The TL equivalent of the above query is ALWAYS ($\Box$) man hugging woman UNTIL ($\mathsf{U}$) ship on the sea UNTIL ($\mathsf{U}$) kiss. Formal verification techniques are utilized on the automaton to retrieve scenes that satisfy the TL specification.

Installation Guide

Prerequisites
No need to worry about the prerequisites below if you are using a UT Swarm Lab cluster.

• CUDA Driver: Version 11.8.0 or higher
• Docker: Nvidia Driver Development Environment Setup

1. Clone this repository.
2. Navigate to the makefile and modify the user input section.
   • For example: CODE_PATH := /home/repos/Neuro-Symbolic-Video-Search-Temporal-Logic/
3. Execute make pull_docker_image
4. Execute make build_docker_image
5. Execute make run_docker_container_gpu
   • Note: If you are a developer: make run_dev_docker_container_gpu
6. Execute make exec_docker_container
7. Inside the container, navigate to /opt/Neuro-Symbolic-Video-Search-Temporal-Logic
8. Inside the container, execute bash install.sh
   • Note: If you are a developer: bash install.sh dev

Development Inside the Container Enjoy your development environment inside the container!

Please avoid stopping and removing the container, as you will need to reinstall the dependencies. If the container is stopped or removed, repeat steps 5 to 8.

System Setup and Execution Guide

Configuration Management

This system utilizes the Hydra Python package to manage configurations effectively. Ensure you configure the system correctly to use it as intended.

Example Configurations

We provide default configurations for different use cases:

1. Real-Video Configuration - real_video.yaml
2. TLV Dataset Configuration - tlv_dataset.yaml

Required Configuration Fields

Update the following fields in your configuration file based on your specific needs:

• save_result_dir: Directory to save the results
• video_file_path: Path to the video file
• ltl_formula: LTL formula specifications
• proposition_set: Set of propositions

Running the System

To launch the system, execute the main.py script from the ns_vfs directory. You will need to specify which configuration to use by setting the config_name parameter.

Example Command

To run the system with the real_video configuration:

python3 main.py +config_name=real_video

Connect with Me

Citation

If you find this repo useful, please cite our paper:

@inproceedings{Choi_2024_ECCV,
  author={Choi, Minkyu and Goel, Harsh and Omama, Mohammad and Yang, Yunhao and Shah, Sahil and Chinchali, Sandeep},
  title={Towards Neuro-Symbolic Video Understanding},
  booktitle={Proceedings of the European Conference on Computer Vision (ECCV)},
  month={September},
  year={2024}
}