Welcome to Angstrom’s documentation!#

Angstrom is a Python library for phase-based motion amplification in videos. It uses complex steerable pyramids to decompose video frames and amplify subtle motion by manipulating phase coefficients.

Installation#

Install Angstrom using pip:

pip install angstrom

Quick Start#

Here’s a simple example of how to use Angstrom for motion amplification:

from angstrom.core.motion_amplifier import MotionAmplifier

# Initialize the motion amplifier
amplifier = MotionAmplifier()

# Process a video with motion amplification
amplifier.process_video(
    input_path="input_video.mp4",
    output_path="amplified_video.mp4",
    amplification_factor=10,
    frequency_range=(0.1, 2.0)  # Hz
)

Features#

  • Phase-based motion amplification: Uses complex steerable pyramids for accurate motion detection

  • Temporal filtering: Apply bandpass filters to target specific motion frequencies

  • GPU acceleration: Leverages PyTorch for efficient computation

  • Multiple output formats: Support for various video formats

  • Configurable parameters: Fine-tune amplification factors and frequency ranges

Indices and tables#