allen-cell-animated / timelapse-colorizer

A web-based, time-series visualizer for tracked segmented data.
Other
7 stars 1 forks source link

Timelapse Feature Explorer 🔬🎨

A web-based, time-series visualizer for tracked segmented data.

Description

Timelapse Feature Explorer is a web tool for interacting with and visualizing features in time-series segmented data. You can apply color maps and ranges, switch between features in your dataset, play through your data to observe motion, and view plots showing how feature data change over time!

This project originated from the Allen Institute for Cell Science (AICS) Nuclear Morphogenesis project and is being updated to support broader use cases. View our Issues page for more details about potential future features!

Builds

Stable build: timelapse.allencell.org

Latest (main branch): https://allen-cell-animated.github.io/timelapse-colorizer/

image

Opening New Datasets

Timelapse Feature Explorer-compatible datasets hosted over HTTPS can be loaded directly from the interface! More details can be found in the data format specification.

Click the Load button in the top right to open a URL.

image

Note: If your dataset is hosted via HTTP rather than HTTPS, you'll need to install and run the project locally for security reasons. See below for more help.

Installation

Installing is optional! You can use the hosted version of Timelapse Feature Explorer to access our existing HTTPS-hosted datasets without installing the project.

Prerequisites:

Web tool

Clone the project and navigate to the project's root directory in a terminal window or VSCode. Then run:

npm install
npm run dev

This will start a development server you can access from your browser. By default, the server will be hosted at http://localhost:5173/.

Data preprocessing

Data must be preprocessed to work with Timelapse Feature Explorer. We provide a Python package and example scripts in the colorizer-data GitHub repository.

You can read more about the data format specification here.

Development

See CONTRIBUTING.md for information related to developing the code.