PHATE Analysis

Version: 1.0.0

Commit Hash: e87ad30549438500b746c4ebbe333560733c8bc1

Author: CauldronGO Team

Category: analysis

PHATE (Potential of Heat-diffusion for Affinity-based Trajectory Embedding) for dimensionality reduction

Install with Cauldron get_app
README

PHATE Analysis

Installation

⬇️ Click here to install in Cauldron (requires Cauldron to be running)

Repository: https://github.com/noatgnu/phate-analysis-plugin

Manual installation:

  1. Open Cauldron
  2. Go to Plugins → Install from Repository
  3. Paste: https://github.com/noatgnu/phate-analysis-plugin
  4. Click Install

ID: phate-analysis
Version: 1.0.0
Category: analysis
Author: CauldronGO Team

Description

PHATE (Potential of Heat-diffusion for Affinity-based Trajectory Embedding) for dimensionality reduction

Runtime

  • Environments: python

  • Entrypoint: phate_analysis.py

Inputs

Name Label Type Required Default Visibility
input_file Input File file Yes - Always visible
annotation_file Sample Annotation File file Yes - Always visible
n_components Number of Components number (min: 2, max: 10, step: 1) Yes 2 Always visible
log2 Apply Log2 Transform boolean No false Always visible
cluster_method Clustering Method select (none, kmeans, dbscan) No none Always visible
auto_k Auto-detect Cluster Count boolean No false Visible when cluster_method = kmeans
n_clusters Number of Clusters number (min: 2, max: 20, step: 1) No 5 Visible when cluster_method = kmeans
max_k Max Clusters to Test number (min: 3, max: 30, step: 1) No 10 Visible when auto_k = true
dbscan_eps DBSCAN Epsilon number (min: 0, max: 10, step: 0) No 0.5 Visible when cluster_method = dbscan
dbscan_min_samples DBSCAN Min Samples number (min: 2, max: 50, step: 1) No 5 Visible when cluster_method = dbscan

Input Details

Input File (input_file)

Data matrix file containing samples and measurements

Sample Annotation File (annotation_file)

Annotation file with Sample column specifying which columns to analyze, plus Condition/Batch for grouping

Number of Components (n_components)

Number of PHATE components to compute

Apply Log2 Transform (log2)

Apply log2 transformation to the data before PHATE

Clustering Method (cluster_method)

Method to detect clusters from PHATE embeddings

  • Options: none, kmeans, dbscan

Auto-detect Cluster Count (auto_k)

Automatically determine optimal number of clusters using elbow method

Number of Clusters (n_clusters)

Number of clusters for KMeans clustering (ignored if auto-detect is enabled)

Max Clusters to Test (max_k)

Maximum number of clusters to test for elbow method

DBSCAN Epsilon (dbscan_eps)

Maximum distance between samples for DBSCAN neighborhood

DBSCAN Min Samples (dbscan_min_samples)

Minimum number of samples in a neighborhood for DBSCAN core points

Outputs

Name File Type Format Description
phate_output phate_output.txt data tsv PHATE coordinates for each sample
phate_3d phate_3d.html html html Interactive 3D PHATE visualization (generated when n_components=3)
elbow_plot elbow_plot.html html html Elbow plot for optimal cluster count (generated when auto_k is enabled)

Sample Annotation

This plugin supports sample annotation:

  • Annotation File: annotation_file

Visualizations

This plugin generates 2 plot(s):

PHATE Plot (by Condition) (phate-scatter-condition)

  • Type: scatter
  • Data Source: phate_output
  • Default: Yes
  • Customization Options: 9 available

PHATE Plot (by Cluster) (phate-scatter-cluster)

PHATE scatter plot colored by detected clusters

  • Type: scatter
  • Data Source: phate_output
  • Customization Options: 9 available

Requirements

  • Python Version: >=3.11

Package Dependencies (Inline)

Packages are defined inline in the plugin configuration:

  • numpy>=1.24.0
  • pandas>=2.0.0
  • phate>=1.0.0
  • matplotlib>=3.7.0
  • scikit-learn>=1.3.0
  • plotly>=5.18.0

Note: When you create a custom environment for this plugin, these dependencies will be automatically installed.

Example Data

This plugin includes example data for testing:

  input_file: diann/imputed.data.txt
  annotation_file: diann/annotation.txt
  n_components: 3
  log2: true
  cluster_method: kmeans
  auto_k: true
  max_k: 6

Load example data by clicking the Load Example button in the UI.

Usage

Via UI

  1. Navigate to analysis → PHATE Analysis
  2. Fill in the required inputs
  3. Click Run Analysis

Via Plugin System

const jobId = await pluginService.executePlugin('phate-analysis', {
  // Add parameters here
});