stl-toolbox

Visualizing and quantifying movement from pre-recorded videos: The spectral time-lapse (STL) algorithm

https://github.com/cmadan/stl-toolbox

Science Score: 41.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 2 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.7%) to scientific vocabulary
Last synced: 10 months ago · JSON representation ·

Repository

Visualizing and quantifying movement from pre-recorded videos: The spectral time-lapse (STL) algorithm

Basic Info
  • Host: GitHub
  • Owner: cMadan
  • License: gpl-2.0
  • Language: Matlab
  • Default Branch: master
  • Size: 1.54 MB
Statistics
  • Stars: 5
  • Watchers: 1
  • Forks: 1
  • Open Issues: 0
  • Releases: 0
Created about 11 years ago · Last pushed about 9 years ago
Metadata Files
Readme License Citation

README.md

Spectral time-lapse (STL) Toolbox

Description

The spectral time-lapse (STL) algorithm is designed to be a simple and efficient technique for analyzing and presenting both spatial and temporal information of animal movements within a two-dimensional image representation. The STL algorithm re-codes an animal's position at every time point with a time-specific color, and overlaid it over a reference frame of the video, to produce a summary image. It additionally incorporates automated motion tracking, such that the animal's position can be extracted and summary statistics such as path length and duration can be calculated, as well as instantaneous velocity and acceleration. This toolbox implements the STL algorithm as a MATLAB toolbox and allows for a large degree of end-user control and flexibility.

More Information

The STL algorithm is described in detail here:

Madan CR and Spetch ML. Visualizing and quantifying movement from pre-recorded videos: The spectral time-lapse (STL) algorithm. F1000Research 2014, 3:19 (doi: 10.12688/f1000research.3-19.v1) http://f1000research.com/articles/3-19/v1

The published version of the toolbox is also available on Zenodo:

ZENODO: Spectral time-lapse (STL) Toolbox. doi: 10.5281/zenodo.7663 https://zenodo.org/record/7663

Illustration of the STL algorithm and examples of images at each stage

STL algorithm workflow

Example output

```

data = stltool('S-Video201107181132.avi');

Processing video file "S-Video201107181132.avi" Reading from raw video (46 Frames) .............................................. Video is being sampled at one position per 1.00 seconds (1.0 pps) Checking frames for motion (46 Frames) .............................................. Colorizing frames (25 Frames) ......................... Calculating spectral timelapse (STL) image STL generated ("STLS-Video201107181132.tif") STL summarizes 25.02 seconds of video Processing video file "S-Video201107181132.avi" Reading from raw video (228 Frames) .................................................................................................................................................................................................................................... Video is being sampled at one position per 0.20 seconds (5.0 pps) Checking frames for motion (228 Frames) .................................................................................................................................................................................................................................... Detecting path Path calculated ("STLpathS-Video201107181132.tif") Total path length measured at 6.1424 m Total path took 25.43 s Velocity-acceleration plot generated ("STLvelS-Video201107181132.pdf") ans = config: [1x1 struct] fname: 'S-Video20110718_1132.avi' framesPathKept: 127 framesPathSampled: 228 framesSTLKept: 25 framesSTLSampled: 46 pathLength: 6.1424 pathTime: 25.4251 ppsPath: 4.9951 ppsSTL: 0.9990 trackXY: [127x2 double] velAcc: [1x125 double] velVel: [1x126 double] vidCDepth: 1 vidFPS: 29.9704 vidHeight: 480 vidWidth: 640 ```

Owner

  • Name: Christopher Madan
  • Login: cMadan
  • Kind: user
  • Company: University of Nottingham

Assistant Professor in Psychology

Citation (CITATION)

# Citation details for stl-toolbox

## APA

Madan, C. R., & Spetch M. L. (2014). Visualizing and quantifying movement from pre-recorded videos: The spectral time-lapse (STL) algorithm. F1000Research 3, 9. doi: 10.12688/f1000research.3-19.v1

## BiBTeX

@article{MadaSpet2014,
  author    = {Christopher R Madan and Marcia L Spetch},
  title     = {Visualizing and quantifying movement from pre-recorded videos: The spectral time-lapse ({STL}) algorithm},
  journal   = {F1000Research}
  year      = {2014},
  volume    = {3},
  pages     = {9},
  doi       = {10.12688/f1000research.3-19.v1},
}

GitHub Events

Total
Last Year

Committers

Last synced: about 1 year ago

All Time
  • Total Commits: 8
  • Total Committers: 2
  • Avg Commits per committer: 4.0
  • Development Distribution Score (DDS): 0.25
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Christopher Madan c****n@g****m 6
cmadan c****n 2

Issues and Pull Requests

Last synced: about 1 year ago

All Time
  • Total issues: 0
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 0
  • Total pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels