Skip to content

allen-cell-animated/timelapse-colorizer

Repository files navigation

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:

  • Node 18 or higher: https://nodejs.org
  • Python 3 (and optionally, a virtual Python environment)

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/.

Uploading datasets

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 or follow our data preprocessing tutorial for more details on how to load your own datasets.

Development

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