Skip to content

JMarzec/RNAsum_explorer

Repository files navigation

RNAsum Explorer

🧬 Interactive Visualization Dashboard for RNAsum Reports

A modern React-based web application for exploring and interpreting RNA sequencing analysis outputs from RNAsum.

RNAsum Explorer Dashboard Demo

πŸ’‘ The demo above shows: navigating between sections, filtering data tables, and viewing the interactive Circos plot for fusion genes.


✨ Features

πŸ“Š Comprehensive Molecular Profiling

  • Findings Summary β€” Consolidated view of all altered genes with section presence indicators
  • Mutated Genes β€” Tiered variant classifications with expression context
  • Fusion Genes β€” Interactive Circos plot visualization of fusion events
  • Structural Variants β€” Expression profiles for SV-affected genes
  • Copy Number Alterations β€” Gain/loss visualization with Z-scores
  • Immune Markers β€” PD-L1, TMB, and immune infiltration metrics
  • HRD Genes β€” Homologous recombination deficiency gene panel
  • Cancer Genes β€” Oncogene and tumor suppressor expression profiles

πŸ”— Clinical Resources Integration

Direct links to genomic knowledge bases:

πŸ“ Data Management

  • JSON Upload β€” Load custom patient data with built-in schema validation
  • Template Download β€” Get a sample JSON template to structure your data
  • Persistence β€” Uploaded data survives page refreshes via localStorage
  • PDF Export β€” Generate multi-page PDF reports for clinical review

🎨 Modern UI/UX

  • Sticky sidebar navigation for easy section access
  • Responsive design with light/dark mode support
  • Interactive charts and visualizations (Recharts)
  • Searchable and filterable data tables

πŸš€ Quick Start

Prerequisites

  • Node.js 18+ and npm

Installation

# Clone the repository
git clone https://github.com/umccr/rnasum-explorer.git
cd rnasum-explorer

# Install dependencies
npm install

# Start development server
npm run dev

Visit http://localhost:5173 to view the application.


πŸ“¦ Technology Stack

Category Technologies
Framework React 18 + TypeScript
Build Tool Vite
Styling Tailwind CSS + shadcn/ui
Charts Recharts
PDF Export html2canvas + jsPDF
State React Context + localStorage

πŸ“„ Data Format

The application accepts JSON files matching the PatientData schema:

interface PatientData {
  sampleInfo: {
    sampleId: string;
    patientId: string;
    cancerType: string;
    referenceCohort: string;
    analysisDate: string;
    libraryId: string;
    purity: number;      // 0-1
    ploidy: number;
  };
  geneExpressions: GeneExpression[];
  geneFusions: GeneFusion[];
  mutatedGenes: MutatedGene[];
  cnvGenes: CNVGene[];
  drugMatches: DrugMatch[];
  immuneMarkers: ImmuneMarker[];
}

Use the "Download Template" button in the app to get a complete example.


πŸ”¬ About RNAsum

RNAsum is an R package developed by the University of Melbourne Centre for Cancer Research (UMCCR) for integrating whole-genome sequencing (WGS) and whole-transcriptome sequencing (WTS) data from cancer patients.

This dashboard provides a modern, interactive frontend for exploring RNAsum outputs, designed for:

  • Clinical genomics teams
  • Molecular tumor boards
  • Research scientists analyzing cancer transcriptomics

πŸ“š Documentation


🀝 Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.


πŸ“ License

This project is developed by UMCCR. See the original RNAsum repository for licensing information.


Built by Collaborative Centre for Genomic Cancer Medicine

About

🧬 Dashboard for exploring reports from RNAsum, a comprehensive pipeline for analysis WGS and WTS-based cancer patient profiles

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages