Skip to content

DROMA01/.github

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 

Repository files navigation

DROMA

Drug Response Omics association MAp (DROMA, ε“ηŽ›)

Website GitHub Stars License: MPL-2.0 R Python DOI

DROMA Logo

🌐 Official Website

Visit the DROMA website at: https://droma01.github.io/

Explore the interactive web interface with comprehensive documentation, component details, and live examples.

πŸ“‹ Table of Contents

🌟 Overview

DROMA is a comprehensive precision oncology platform that integrates the world's largest collection of drug response and multi-omics datasets. It bridges the gap between cancer pharmacogenomics data and actionable insights through advanced analytics, AI-powered tools, and user-friendly interfaces.

πŸš€ Key Highlights

  • πŸ—„οΈ Massive Dataset: 18 projects with 2,600+ samples and 56,000+ drugs - the world's largest open-source integrated drug sensitivity dataset
  • 🧬 Multi-Omics Support: mRNA, CNV, mutations, methylation, proteomics, and more
  • πŸ₯ Diverse Model Systems: Cell lines, PDOs (Patient-Derived Organoids), PDXs (Patient-Derived Xenografts), and PDCs (Patient-Derived Cells)
  • πŸ€– AI-Powered: Natural language interactions via MCP (Model Context Protocol) server
  • πŸ“Š Advanced Analytics: Meta-analysis, biomarker discovery, and statistical modeling
  • 🌐 Web Interface: Interactive Shiny application for intuitive analysis

πŸ—οΈ DROMA Ecosystem

The DROMA platform consists of interconnected components that work together to provide a complete drug response analysis solution:

DROMA Architecture

πŸ“Š Data Infrastructure

DROMA_DB - Database Foundation

  • Purpose: SQLite database creation and management
  • Features: Project-oriented structure, efficient querying, optimized indexing
  • Content: 20 projects with comprehensive omics and drug response data
  • Integration: Foundation for all other DROMA components

DROMA_Set - Data Management

  • Purpose: R package for multi-project data management and analysis
  • Features: S4 classes (DromaSet, MultiDromaSet), cross-project comparisons, sample overlap detection
  • Key Classes:
    • DromaSet: Single-project analysis
    • MultiDromaSet: Cross-project comparisons
  • Capabilities: Flexible data loading, metadata management, database connectivity

πŸ”¬ Analysis Engine

DROMA_R - Advanced Analytics

  • Purpose: Statistical analysis and visualization for drug-omics associations
  • Features: Meta-analysis, batch processing, comprehensive visualization
  • Methods: Spearman correlation, Wilcoxon tests, Cliff's Delta effect sizes
  • Outputs: Forest plots, volcano plots, comparison visualizations
  • Performance: Z-score normalization, parallel processing support

🌐 User Interfaces

DROMA_Web - Web Application

  • Purpose: Interactive Shiny web interface
  • Features: Real-time analysis, dynamic visualization, user-friendly interface
  • Modules: Drug feature analysis, batch analysis, drug-omics pairing
  • Access: Browser-based, no installation required

DROMA_MCP - AI Interface

  • Purpose: Model Context Protocol server for natural language interactions
  • Features: AI assistant integration, natural language queries, automated analysis
  • Capabilities: Dataset management, data loading, database exploration
  • Integration: Works with ChatGPT, Claude, and other AI assistants

πŸš€ Future Components

  • DROMA_AI: Multi-agent systems for automated analysis and hypothesis generation
  • DROMA_Augur: Machine learning models for drug response prediction
  • DROMA_py: Python implementation for broader accessibility

πŸ“ˆ Database Statistics

Our comprehensive database includes:

Metric Count Description
Projects 20 Independent research datasets
Samples 2,600+ Unique biological samples
Drugs 56,000+ Unique chemical compounds
Model Systems 4 types Cell lines, PDOs, PDXs, Clinical

πŸ“Š Project Distribution

Project Distribution
Data Types

πŸ₯ Model System Coverage

  • Cell Lines (11 projects): CCLE, GDSC1, GDSC2, CTRP1, CTRP2, gCSI, NCI60, FIMM, GRAY, Prism, UHNBreast
  • PDOs (5 projects): UMPDO1, UMPDO2, UMPDO3, HKPDO, LICOB
  • PDCs (2 projects): PDTXBreast, Tavor
  • PDXs (1 project): Xeva
  • Clinical (1 project): CTR-DB (under development)

πŸš€ Quick Start

1. Database Setup

# Install DROMA.Set
devtools::install_github("mugpeng/DROMA_Set")

# Download data from Zenodo
# https://zenodo.org/records/15742800

# Connect database
library(DROMA.Set)
# Connect to your DROMA database
connectDROMADatabase("path/to/your/droma.sqlite")

# List available projects
projects <- listDROMAProjects()
print(projects)

2. Basic Analysis

# Load dataset
gCSI <- createDromaSetFromDatabase("gCSI", "droma.sqlite")

# Load molecular profiles with normalization
gCSI <- loadMolecularProfilesNormalized(gCSI, 
                                       molecular_type = "mRNA", 
                                       features = "ABCB1")

# Load drug response
gCSI <- loadTreatmentResponseNormalized(gCSI, drugs = "Paclitaxel")

# Analyze drug-gene association
library(DROMA.R)
result <- analyzeDrugOmicPair(gCSI, "mRNA", "ABCB1", "Paclitaxel")

3. AI-Powered Analysis

# Install DROMA MCP
pip install droma-mcp

# Start AI server
droma-mcp run --db-path droma.sqlite

# Use with AI assistants
"Load CCLE dataset and analyze BRCA1 expression vs Tamoxifen response"

4. Web Interface

Visit our interactive web application for browser-based analysis (contact for access).

πŸ› οΈ Installation

Prerequisites

  • R β‰₯ 4.0.0
  • Python β‰₯ 3.10 (for DROMA_MCP)
  • SQLite database

Core Components

# Install DROMA packages
devtools::install_github("mugpeng/DROMA_Set")
devtools::install_github("mugpeng/DROMA_R")
# Install AI interface
pip install droma-mcp

Data Download

# Download from Zenodo (15.5 GB)
wget https://zenodo.org/records/15742800/files/droma.sqlite
unzip droma-data.zip

πŸ“š Documentation

Each component has comprehensive documentation:

πŸ–₯️ Official Website

Visit https://droma01.github.io/ for the complete DROMA experience:

🌟 Website Features

  • Interactive Homepage: Animated DNA visualizations and ecosystem overview
  • Component Documentation: Detailed information about each DROMA module
  • Live Code Examples: Copy-to-clipboard functionality for quick setup
  • Responsive Design: Optimized for desktop, tablet, and mobile devices
  • Professional Theme: Scientific color palette with modern animations

πŸ“± User Experience

  • No Installation Required: Access DROMA information instantly in your browser
  • Quick Navigation: Jump between components, documentation, and examples
  • Mobile-Friendly: Full functionality on all device sizes
  • Fast Loading: Optimized performance with modern web technologies

πŸ”— Direct Links

  • Component Details: Deep-dive into DROMA_DB, DROMA_Set, DROMA_R, DROMA_Web, and DROMA_MCP
  • Installation Guides: Step-by-step setup instructions for each component
  • GitHub Integration: Direct links to all source repositories
  • Data Access: Links to Zenodo datasets and documentation

🎯 Use Cases

πŸ”¬ Biomarker Discovery

  • Identify genes associated with drug sensitivity across multiple datasets
  • Perform meta-analysis to strengthen statistical power
  • Validate findings across different model systems

πŸ’Š Drug Repurposing

  • Explore drug response patterns across cancer types
  • Identify compounds with similar response profiles
  • Predict drug efficacy in new contexts

πŸ₯ Precision Medicine

  • Analyze patient-derived models (PDOs, PDXs)
  • Correlate molecular profiles with treatment outcomes
  • Develop personalized treatment strategies

πŸ“Š Comparative Analysis

  • Compare drug responses across cell lines vs patient models
  • Evaluate consistency of biomarkers across studies
  • Integrate multi-omics data for comprehensive insights

🌟 Key Features

πŸ”„ Seamless Integration

All components work together through standardized interfaces and data formats.

⚑ High Performance

  • Optimized SQLite database with indexing
  • Parallel processing for large-scale analysis
  • Memory-efficient data handling

🎨 Rich Visualization

  • Interactive plots and dashboards
  • Publication-ready figures
  • Customizable themes and layouts

πŸ” Flexible Querying

  • Filter by tumor type, data type, or specific features
  • Cross-project sample matching
  • Advanced statistical filtering

πŸ€– AI-Enhanced

  • Natural language queries
  • Automated analysis workflows
  • Intelligent data exploration

πŸ† Impact & Applications

DROMA has been used for:

  • Academic Research: Published in high-impact journals
  • Drug Discovery: Industrial collaborations
  • Clinical Translation: Biomarker validation studies
  • Educational: Training in computational pharmacogenomics

πŸ“ˆ Version History

v0.4 - "Andata"

  • New: DROMA_MCP AI interface
  • Enhanced: Multi-project analysis capabilities
  • Added: Z-score normalization by default
  • Improved: Performance optimizations
DROMA Logo

250620, I attended 11th Macau Symposium on Biomedical Sciences 2025 - 11th Macau Symposium on Biomedical Sciences 2025:

DROMA Logo

v0.3 - Data Expansion

  • Added: In vivo data (Xeva PDX dataset)
  • Total: 20 datasets (11 cell line, 2 PDC, 5 PDO, 1 PDX, 1 clinical)
  • Enhanced: Drug feature analysis modules
  • Improved: Visualization and user experience

250319 UM PhD seminar:

DROMA Logo

v0.2 - Web Interface

  • Launch: Interactive Shiny web application
  • Added: PDO datasets (breast, colon, nasopharyngeal)
  • Enhanced: Data harmonization and annotation
  • Features: Tumor type and data type filtering
DROMA Logo

πŸ“„ Citation

If you use DROMA in your research, please cite:

@article{li2024facilitating,
  title={Facilitating integrative and personalized oncology omics analysis with UCSCXenaShiny},
  author={Li, Shixiang and Peng, Yu and Chen, Miaozun and others},
  journal={Communications Biology},
  volume={7},
  number={1},
  pages={1200},
  year={2024},
  publisher={Nature Publishing Group},
  doi={10.1038/s42003-024-06891-2}
}

🀝 Contributing

We welcome contributions to the DROMA ecosystem!

How to Contribute

  1. Fork the relevant repository
  2. Create a feature branch
  3. Make your changes with tests
  4. Submit a pull request

Areas for Contribution

  • New datasets: Additional cancer pharmacogenomics studies
  • Analysis methods: Novel statistical approaches
  • Visualization: Enhanced plotting functions
  • Documentation: Tutorials and examples
  • Bug reports: Issues and feature requests

πŸ”— Links & Resources

Official Repositories

Data & Resources

  • Data Repository: Zenodo Record
  • Documentation: Component-specific README files
  • Examples: Comprehensive usage examples in each repository

Support & Community

  • Issues: Repository-specific GitHub Issues
  • Discussions: GitHub Discussions
  • Contact: yc47680@um.edu.mo

πŸ“œ License

DROMA is licensed under the Mozilla Public License 2.0 (MPL-2.0). See LICENSE for details.

πŸ™ Acknowledgments

DROMA is developed by the precision oncology research team at the University of Macau. We thank all contributors, collaborators, and the broader cancer research community for their support and feedback.


**🧬 DROMA - Bridging Cancer Pharmacogenomics and AI πŸ’Š**

Empowering precision medicine through comprehensive data integration and intelligent analysis

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors