Package: PERCEPTIONx 0.3.0

Jia Ding

PERCEPTIONx: Personalized Drug Response Prediction from Single-Cell Transcriptomics

An R implementation of the PERCEPTION approach (Sinha et al., 2024) for predicting personalized drug response from single-cell tumor transcriptomics. It trains drug-response models on large-scale cell-line screens, predicts sensitivity at clone and patient level, and ships an interactive visualization suite plus a Shiny web application.

Authors:Jia Ding [aut, cre]

PERCEPTIONx_0.3.0.tar.gz
PERCEPTIONx_0.3.0.zip(r-4.7-any)PERCEPTIONx_0.3.0.zip(r-4.6-any)PERCEPTIONx_0.3.0.zip(r-4.5-any)
PERCEPTIONx_0.3.0.tgz(r-4.6-any)PERCEPTIONx_0.3.0.tgz(r-4.5-any)
PERCEPTIONx_0.3.0.tar.gz(r-4.7-any)PERCEPTIONx_0.3.0.tar.gz(r-4.6-any)
PERCEPTIONx_0.3.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
PERCEPTIONx/json (API)

# Install 'PERCEPTIONx' in R:
install.packages('PERCEPTIONx', repos = c('https://wanglabcsu.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/wanglabcsu/perceptionx/issues

Pkgdown/docs site:https://wanglabcsu.github.io

On CRAN:

Conda:

shinysingle-cell

5.03 score 3 stars 20 scripts 44 exports 176 dependencies

Last updated from:15fbc84a04. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK277
source / vignettesOK309
linux-releaseOK274
macos-releaseOK156
macos-oldrelOK146
windows-develOK148
windows-releaseOK186
windows-oldrelOK178
wasm-releaseOK229

Exports:add_mirrorsannotate_clonesbuild_clone_countsbuild_clone_keybuild_on_BULK_v2clone_mean_expressioncompare_performancecor.test_trimmed_v0each_patient_pseudo_bulkexport_plot_cairofdrcorrfeature_ranking_bulkget_cellLine_listget_depmapget_mirrorsget_performanceget_response_matrixget_significant_modelshypergeometric_test_for_twolistslist_mirrorsload_depmapload_modelparse_clone_keysplot_clone_distributionplot_clone_umapplot_clone_viabilityplot_model_performanceplot_model_rocplot_patient_response_panelplot_response_boxplotplot_roc_curveplot_seurat_clusteringplot_tsne_biomarker_viabilityplot_tsne_responsepredict_drugspredict_patientsprepare_datarange01rank_normalization_matreset_mirrorsrun_parallel_feature_ranking_bulkrun_perception_apptrain_modelszscore_viability

Dependencies:abindaskpassbase64encBHbitopsbslibcachemcaretcaToolsclasscliclockclustercodetoolscommonmarkcowplotcpp11crosstalkcurldata.tabledeldirdiagramdigestdotCall64dplyrdqrnge1071evaluatefarverfastDummiesfastmapfitdistrplusFNNfontawesomefontBitstreamVerafontLiberationfontquiverforeachfsfuturefuture.applygdtoolsgenericsggiraphggplot2ggrepelggridgesglmnetglobalsgluegoftestgowergplotsgridExtragtablegtoolshardhatherehighrhtmltoolshtmlwidgetshttpuvhttricaigraphipredirlbaisobanditeratorsjquerylibjsonliteKernSmoothknitrlabelinglaterlatticelavalazyevallifecyclelistenvlmtestlubridatemagrittrMASSMatrixmatrixStatsmemoisemimeminiUIModelMetricsnlmennetnumDerivopensslotelparallellypatchworkpbapplypillarpkgconfigplotlyplyrpngpolyclippROCprodlimprogressrpromisesproxypurrrR6randomForestRANNrappdirsRColorBrewerRcppRcppAnnoyRcppArmadilloRcppEigenRcppHNSWRcppProgressRcppTOMLrecipesreshape2reticulaterlangrmarkdownROCRrpartrprojrootRSpectraRtsneS7sassscalesscattermoresctransformSeuratSeuratObjectshapeshinysitmosourcetoolsspspamsparsevctrsspatstat.dataspatstat.explorespatstat.geomspatstat.randomspatstat.sparsespatstat.univarspatstat.utilsSQUAREMstringistringrsurvivalsyssystemfontstensortibbletidyrtidyselecttimechangetimeDatetinytextzdbutf8uwotvctrsviridisLitewithrxfunxtableyamlzoo

PERCEPTION-shiny User Guide
Contents | 0. Requirements & Launch | 0.1 Requirements | 0.2 Launch | 0.3 Overall Flow | 1. Interface Overview | 2. Data Tab: Loading Data | 2.1 Loading DepMap Reference Data (required for training) | 2.2 Loading Models | 2.3 Uploading an Expression Matrix (patient scRNA-seq) | 2.4 Uploading the Cell-to-Patient Map (Mapping) | 2.5 Uploading Clinical Responses (Response, optional but recommended) | 2.6 Clustering (Seurat) | 3. Train Tab: Training Models (Optional) | 3.1 Parameters | 3.2 Interpreting the Results | 4. Predict Tab: Predicting Viability Scores | 5. Visualize Tab | 5.1 Clone Distribution (stacked bar chart) | 5.2 Clone Viability (lollipop plot) | 5.3 ROC Curve | 5.4 Response Boxplot (responders vs. non-responders) | 5.5 Model Performance | 5.6 Spatial Plots (UMAP / t-SNE) | 5.7 High-Resolution Download | 6. Help Tab | 7. FAQ | 8. Citation & Contact

Last update: 2026-09-19
Started: 2026-08-28

PERCEPTION-shiny 使用教程
目录 | 0. 环境要求与启动 | 0.1 环境要求 | 0.2 启动方式 | 0.3 整体流程 | 1. 界面总览 | 2. Data 模块:加载数据 | 2.1 加载 DepMap 参考数据(训练必需) | 2.2 加载模型 | 2.3 上传表达矩阵(患者 scRNA-seq) | 2.4 上传细胞-患者映射(Mapping) | 2.5 上传临床响应(Response,可选但推荐) | 2.6 聚类分群(Seurat) | 3. Train 模块:训练模型(可选) | 3.1 参数说明 | 3.2 结果解读 | 4. Predict 模块:预测杀伤值 | 5. Visualize 模块:可视化 | 5.1 Clone Distribution(stackplot) | 5.2 Clone Viability(lolliplot) | 5.3 ROC Curve | 5.4 Response Boxplot(R vs NR) | 5.5 Model Performance | 5.6 空间图(UMAP / t-SNE) | 5.7 高清下载 | 6. Help 页 | 7. 常见问题(FAQ) | 8. 引用与联系

Last update: 2026-09-19
Started: 2026-08-28

PERCEPTIONx: Complete Pipeline Tutorial
1. Overview | 2. Minimal Workflow | 2.1 Load the DepMap reference data | 2.2 Load pre-trained models | 2.3 Prepare the clone-level expression data | 2.4 Predict drug sensitivity | 2.4.1 Clone-level prediction | 2.4.2 Patient-level aggregation | 2.5 Visualize | 3. Advanced Topics | 3.1 Train your own models | 3.2 Evaluate model performance | 3.2.1 Aggregation modes | 3.2.2 Pseudo-bulk expression | 3.3 Validate predictions on DepMap cell lines | 3.4 The plotting suite | 3.5 prepare_data() and Seurat clustering | 3.6 The Shiny web application | 3.7 End-to-end pipeline script | 3.8 Agent skills | 4. Citation

Last update: 2026-09-03
Started: 2026-06-16

Readme and manuals

Help Manual

Help pageTopics
Add custom download mirrorsadd_mirrors
Annotate cells with clone IDs via Seurat clusteringannotate_clones
Build clone abundance table from cell-clone mappingbuild_clone_counts
Build a clone key from patient and clone idbuild_clone_key
Build PERCEPTIONx model on bulk expression databuild_on_BULK_v2
Compute clone-level mean expression from single-cell dataclone_mean_expression
Compare performance of multiple trained modelscompare_performance
Fast correlation test (generic)cor.test_trimmed_v0
Compute pseudo-bulk expression for a patienteach_patient_pseudo_bulk
Export plot to file via Cairo deviceexport_plot_cairo
FDR correction for multiple testingfdrcorr
Feature ranking for a single drug using bulk expressionfeature_ranking_bulk
Determine training and test cell-lines for a given drugget_cellLine_list
Get the DepMap datasetget_depmap
Get current download mirrorsget_mirrors
Load performance metrics from a saved model fileget_performance
Get specific drug response data for cell-linesget_response_matrix
Get best performing modelsget_significant_models
Hypergeometric test for gene list overlaphypergeometric_test_for_twolists
List current download mirrorslist_mirrors
Download filtered DepMap dataload_depmap
Load pre-built model of provided drugsload_model
Parse clone keys in "Patient@Clone" formatparse_clone_keys
Plot clone distribution as stacked barplot_clone_distribution
Plot UMAP colored by clone identityplot_clone_umap
Plot clone-level viability (lollipop plot)plot_clone_viability
Plot model performance across datasetsplot_model_performance
Plot validation ROC curves for trained modelsplot_model_roc
Complete patient response visualization pipelineplot_patient_response_panel
Plot predicted vs observed response boxplotplot_response_boxplot
Plot ROC curve with AUC annotationplot_roc_curve
Run Seurat clustering and plot 2D embeddingplot_seurat_clustering
Plot UMAP side-by-side for biomarker and viabilityplot_tsne_biomarker_viability
Plot UMAP with drug response overlayplot_tsne_response
Predict drug response for cells or clonespredict_drugs
Predict drug response at patient levelpredict_patients
Prepare patient data for PERCEPTIONx predictionprepare_data
Change range to 0-1range01
Rank-normalize each column of a matrixrank_normalization_mat
Reset mirrors to defaultreset_mirrors
Parallel feature ranking for multiple drugsrun_parallel_feature_ranking_bulk
Launch PERCEPTIONx Shiny Dashboardrun_perception_app
Train PERCEPTIONx models for multiple drugstrain_models
Z-score scale viability values across patientszscore_viability