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.
Contents:
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