https://github.com/axsk/hokusai.jl

A julia package for clustering spatial timeseries, like for example eye-tracking data, based on PCCA+.

https://github.com/axsk/hokusai.jl

Science Score: 26.0%

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

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 2 DOI reference(s) in README
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (9.4%) to scientific vocabulary

Keywords

paper pcca schur zib
Last synced: 5 months ago · JSON representation

Repository

A julia package for clustering spatial timeseries, like for example eye-tracking data, based on PCCA+.

Basic Info
  • Host: GitHub
  • Owner: axsk
  • Language: Jupyter Notebook
  • Default Branch: master
  • Homepage:
  • Size: 87.8 MB
Statistics
  • Stars: 0
  • Watchers: 3
  • Forks: 0
  • Open Issues: 3
  • Releases: 0
Topics
paper pcca schur zib
Created almost 8 years ago · Last pushed almost 6 years ago
Metadata Files
Readme

README.MD

Hokusai.jl

A julia package for clustering spatial timeseries, like for example eye-tracking data, based on PCCA+.

References

  • Bachelor thesis (https://github.com/axsk/bachelor/blob/master/ba.pdf)
  • Spectral Clustering for Non-Reversible Markov Chains (https://doi.org/https://doi.org/10.1007/s40314-018-0697-0)

Installation

Requires Julia 0.6. - Install the package: julia Pkg.clone("https://github.com/axsk/hokusai") - Copy the data file "sallsac_Hokusai.seq" into the packages data directory (~/.julia/v0.6/Hokusai/data). - Test the package: julia Pkg.test("Hokusai")

Basic usage

See the test file

  • data is a DataFrame containing the x-/y-coordinates in the first two columns, the relative time in the third and an identifier for aggregation in the fourth column, allowing clustering of multiple test executions.
  • n denotes the desired number of clusters.
  • tau denotes the timestep used for creating the markov jump process
  • sigma denotes the gaussian mixture standard deviation used for the "spatial coupling".
  • precluster specifies the number of preclusters to generate via kmeans, to improve performance. (use 0 for no preclustering)
  • sort denotes how the final clusters will be ordered. :size sorts by number of fixations in each cluster, and :x by the average horizontal position.
  • method specifies the objective function used in the PCCA+ optimization. Accepted values: :scaling (Weber), :metastability (Deuflhard), :crispness (Röblitz)

cluster returns a HokusaiResult, containing the resulting clustering in the field assignments.

todo

  • think about pi
  • parameter optimization -- automatic tau/gamma -- automatic n (which method in nonreversible case?)

how to choose tau/sigma:

  • we want tau to measure every fixation, -> min fixdur?
  • sigma should seperate different fixations -> mean fixdist?

Owner

  • Name: Alexander
  • Login: axsk
  • Kind: user
  • Location: Berlin
  • Company: Zuse Institute Berlin

Mathematician

GitHub Events

Total
Last Year

Committers

Last synced: 8 months ago

All Time
  • Total Commits: 30
  • Total Committers: 1
  • Avg Commits per committer: 30.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
axsk s****3@g****m 30

Issues and Pull Requests

Last synced: 8 months ago

All Time
  • Total issues: 2
  • Total pull requests: 3
  • Average time to close issues: N/A
  • Average time to close pull requests: 8 days
  • Total issue authors: 1
  • Total pull request authors: 2
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.33
  • Merged pull requests: 2
  • 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
  • axsk (2)
Pull Request Authors
  • axsk (2)
  • lcrofty (1)
Top Labels
Issue Labels
good first issue (1) question (1)
Pull Request Labels