Package: PIUMA 1.9.0

Mattia Chiesa

PIUMA: Phenotypes Identification Using Mapper from topological data Analysis

The PIUMA package offers a tidy pipeline of Topological Data Analysis frameworks to identify and characterize communities in high and heterogeneous dimensional data.

Authors:Mattia Chiesa [aut, cre], Arianna Dagliati [aut], Alessia Gerbasi [aut], Giuseppe Albi [aut], Laura Ballarini [aut], Luca Piacentini [aut], Carlo Leonardi [aut]

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

# Install 'PIUMA' in R:

install.packages('PIUMA', repos = c('https://bioc.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/bioinfomonzino/piuma/issues

Datasets:

df_test_proj - A dataset to test the 'dfToProjection' and 'dfToDistance' funtions of 'PIUMA' package.
tda_test_data - A TDAobj to test the 'PIUMA' package.
vascEC_meta - Example datasets for PIUMA package
vascEC_norm - We tested PIUMA on a subset of the single-cell RNA Sequencing dataset (GSE:GSE193346 generated and published by Feng et al. (2022) on Nature Communication to demonstrate that distinct transcriptional profiles are present in specific cell types of each heart chambers, which were attributed to have roles in cardiac development. In this tutorial, our aim will be to exploit PIUMA for identifying sub-population of vascular endothelial cells, which can be associated with specific heart developmental stages. The original dataset consisted of three layers of heterogeneity: cell type, stage and zone (i.e., heart chamber). Our testing dataset was obtained by subsetting vascular endothelial cells (cell type) by Seurat object, extracting raw counts and metadata. Thus, we filtered low expressed genes and normalized data by DaMiRseq

On BioConductor:PIUMA-1.9.0(bioc 3.24)PIUMA-1.8.0(bioc 3.23)

clustering graphandnetwork dimensionreduction network classification

5.18 score 5 stars 3 scripts 33 exports 95 dependencies

Last updated from:c00b5d7982. Checks:1 WARNING, 9 OK. Indexed: yes.

Target	Result	Time
bioc-checks	WARNING	220
linux-devel-x86_64	OK	369
source / vignettes	OK	346
linux-release-x86_64	OK	397
macos-release-arm64	OK	171
macos-oldrel-arm64	OK	187
windows-devel	OK	253
windows-release	OK	257
windows-oldrel	OK	308
wasm-release	OK	235

Exports:autoClusterMapper checkNetEntropy checkScaleFreeModel dfToDistance dfToProjection getClusters getComp getDfMapper getDistMat getGraph getJacc getMetrics getNodeDataMat getOrigData getOutcome getOutcomeFact getScaledData jaccardMatrix makeTDAobj makeTDAobjFromSE mapperCore predict_mapper_class setComp setDfMapper setDistMat setGraph setJacc setNodeDataMat setOrigData setOutcome setOutcomeFact setScaledData tdaDfEnrichment

Dependencies:abind askpass backports base64enc Biobase BiocGenerics bslib cachem checkmate cli cluster colorspace cpp11 data.table dbscan DelayedArray digest evaluate farver fastmap fontawesome foreign Formula fs generics GenomicRanges ggplot2 glue gridExtra gtable here highr Hmisc htmlTable htmltools htmlwidgets igraph IRanges isoband jquerylib jsonlite kernlab knitr labeling lattice lifecycle magrittr MASS Matrix MatrixGenerics matrixStats memoise mgcv mime nlme nnet openssl patchwork permute pkgconfig png R6 rappdirs RColorBrewer Rcpp RcppEigen RcppTOML reticulate rlang rmarkdown rpart rprojroot RSpectra rstudioapi S4Arrays S4Vectors S7 sass scales Seqinfo SparseArray stringi stringr SummarizedExperiment sys tinytex tsne umap vctrs vegan viridisLite withr xfun XVector yaml

The PIUMA package - Phenotypes Identification Using Mapper from topological data Analysis

Rendered fromPIUMA_vignette.Rmdusingknitr::rmarkdown

Last update: 2025-12-31
Started: 2024-03-22

Topology-based Clustering in Seurat

Rendered fromVignetteSeurat.Rmdusingknitr::rmarkdown

Last update: 2025-12-31
Started: 2025-12-31

Citation

Development and contributors

Readme and manuals

Help Manual

Help page	Topics
Automatic Clustering of a Mapper Graph by Predicted Geometry (with kNN tie-break)	autoClusterMapper
Compute the Network Entropy	checkNetEntropy
Assessment of Scale-Free model fitting	checkScaleFreeModel
A dataset to test the 'dfToProjection' and 'dfToDistance' funtions of 'PIUMA' package.	df_test_proj
Compute the Distance Matrix from TDAobj	dfToDistance
Data projection using a Dimensionality Reduction Method	dfToProjection
Getter method for the 'clustering' slot of a TDAobj object.	getClusters getClusters,PIUMA-getClusters getClusters,TDAobj-method
Getter method for the 'comp' slot of a TDAobj object.	getComp getComp,PIUMA-getComp getComp,TDAobj-method
Getter method for the 'dfMapper' slot of a TDAobj object.	getDfMapper getDfMapper,PIUMA-getDfMapper getDfMapper,TDAobj-method
Getter method for the 'dist_mat' slot of a TDAobj object.	getDistMat getDistMat,PIUMA-getDistMat getDistMat,TDAobj-method
Getter method for the 'graph' slot of a TDAobj object.	getGraph getGraph,PIUMA-getGraph getGraph,TDAobj-method
Getter method for the 'jacc' slot of a TDAobj object.	getJacc getJacc,PIUMA-getJacc getJacc,TDAobj-method
Getter method for the 'metrics' slot under 'graph' of a TDAobj object.	getMetric,PIUMA-getMetrics getMetrics getMetrics,TDAobj-method
Getter method for the 'node_data_mat' slot of a TDAobj object.	getNodeDataMat getNodeDataMat,PIUMA-getNodeDataMat getNodeDataMat,TDAobj-method
Getter method for the 'orig_data' slot of a TDAobj object.	getOrigData getOrigData,PIUMA-getOrigData getOrigData,TDAobj-method
Getter method for the 'outcome' slot of a TDAobj object.	getOutcome getOutcome,PIUMA-getOutcome getOutcome,TDAobj-method
Getter method for the 'outcomeFact' slot of a TDAobj object.	getOutcomeFact getOutcomeFact,PIUMA-getOutcomeFact getOutcomeFact,TDAobj-method
Getter method for the 'scaled_data' slot of a TDAobj object.	getScaledData getScaledData,PIUMA-getScaledData getScaledData,TDAobj-method
Compute the Matrix of Jaccard Indexes	jaccardMatrix
Import data and generate the TDAobj object	makeTDAobj
Import SummarizedExperiment data and generate the TDAobj object	makeTDAobjFromSE
Implement the TDA Mapper algorithm on TDAobj	mapperCore
PIUMA: Phenotypes Identification Using Mapper from topological data Analysis	PIUMA
Predict Mapper Graph Geometry (lightweight)	predict_mapper_class
Setter method for the 'comp' slot of a TDAobj object.	setComp setComp,PIUMA-setComp setComp,TDAobj-method
Setter method for the 'dfMapper' slot of a TDAobj object.	setDfMapper setDfMapper,PIUMA-setDfMapper setDfMapper,TDAobj-method
Setter method for the 'dist_mat' slot of a TDAobj object.	setDistMat setDistMat,PIUMA-setDistMat setDistMat,TDAobj-method
Setter method for the 'graph' slot of a TDAobj object.	setGraph setGraph,PIUMA-setGraph setGraph,TDAobj-method
Setter method for the 'jacc' slot of a TDAobj object.	setJacc setJacc,PIUMA-setJacc setJacc,TDAobj-method
Setter method for the 'node_data_mat' slot of a TDAobj object.	setNodeDataMat setNodeDataMat,PIUMA-setNodeDataMat setNodeDataMat,TDAobj-method
Setter method for the 'orig_data' slot of a TDAobj object.	setOrigData setOrigData,PIUMA-setOrigData setOrigData,TDAobj-method
Setter method for the 'outcome' slot of a TDAobj object.	setOutcome setOutcome,PIUMA-setOutcome setOutcome,TDAobj-method
Setter method for the 'outcomeFact' slot of a TDAobj object.	setOutcomeFact setOutcomeFact,PIUMA-setOutcomeFact setOutcomeFact,TDAobj-method
Setter method for the 'scaled_data' slot of a TDAobj object.	setScaledData setScaledData,PIUMA-setScaledData setScaledData,TDAobj-method
A TDAobj to test the 'PIUMA' package.	tda_test_data
Add information to TDAobj	tdaDfEnrichment
The object 'TDAobj'	TDAobj-class
Example datasets for PIUMA package	vascEC_meta
We tested PIUMA on a subset of the single-cell RNA Sequencing dataset (GSE:GSE193346 generated and published by Feng et al. (2022) on Nature Communication to demonstrate that distinct transcriptional profiles are present in specific cell types of each heart chambers, which were attributed to have roles in cardiac development. In this tutorial, our aim will be to exploit PIUMA for identifying sub-population of vascular endothelial cells, which can be associated with specific heart developmental stages. The original dataset consisted of three layers of heterogeneity: cell type, stage and zone (i.e., heart chamber). Our testing dataset was obtained by subsetting vascular endothelial cells (cell type) by Seurat object, extracting raw counts and metadata. Thus, we filtered low expressed genes and normalized data by DaMiRseq	vascEC_norm