Package: COTAN 2.13.1

Galfrè Silvia Giulia

COTAN: COexpression Tables ANalysis

Statistical and computational method to analyze the co-expression of gene pairs at single cell level. It provides the foundation for single-cell gene interactome analysis. The basic idea is studying the zero UMI counts' distribution instead of focusing on positive counts; this is done with a generalized contingency tables framework. COTAN can effectively assess the correlated or anti-correlated expression of gene pairs. It provides a numerical index related to the correlation and an approximate p-value for the associated independence test. COTAN can also evaluate whether single genes are differentially expressed, scoring them with a newly defined global differentiation index. Moreover, this approach provides ways to plot and cluster genes according to their co-expression pattern with other genes, effectively helping the study of gene interactions and becoming a new tool to identify cell-identity marker genes.

Authors:Galfrè Silvia Giulia [aut, cre], Morandin Francesco [aut], Fantozzi Marco [aut], Pietrosanto Marco [aut], Puttini Daniel [aut], Priami Corrado [aut], Cremisi Federico [aut], Helmer-Citterich Manuela [aut]

COTAN_2.13.1.tar.gz
COTAN_2.13.1.zip(r-4.7)COTAN_2.13.1.zip(r-4.6)COTAN_2.13.1.zip(r-4.5)
COTAN_2.13.1.tgz(r-4.6-any)COTAN_2.13.1.tgz(r-4.5-any)
COTAN_2.13.1.tar.gz(r-4.7-any)COTAN_2.13.1.tar.gz(r-4.6-any)
COTAN_2.13.1.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
card.svg |card.png
COTAN/json (API)
NEWS

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

Bug tracker:https://github.com/seriph78/cotan/issues

Datasets:

On BioConductor:COTAN-2.13.0(bioc 3.24)COTAN-2.12.0(bioc 3.23)

systemsbiologytranscriptomicsgeneexpressionsinglecelldifferentialexpressionclusteringgpu

8.42 score 17 stars 130 scripts 460 downloads 149 exports 217 dependencies

Last updated from:c968e6997a. Checks:8 NOTE, 2 OK. Indexed: yes.

TargetResultTimeFilesSyslog
bioc-checksNOTE262
linux-devel-x86_64NOTE1227
source / vignettesOK683
linux-release-x86_64NOTE1157
macos-release-arm64NOTE780
macos-oldrel-arm64NOTE810
windows-develNOTE1089
windows-releaseNOTE1358
windows-oldrelNOTE1260
wasm-releaseOK232

Exports:addClusterizationaddClusterizationCoexaddConditionaddElementToMetaDatasetasClusterizationautomaticCOTANObjectCreationcalculateCoexcalculateGcalculateGDIcalculateGDIGivenCorrcalculateGenesCEcalculateLikelihoodOfObservedcalculatePartialCoexcalculatePDIcalculatePValuecalculateReducedDataMatrixcalculateScalculateThresholdShiftToUniformitycanUseTorchcellsHeatmapPlotcellSizePlotcellsUMAPPlotcellsUniformClusteringcheckClusterUniformitycheckersToDFcheckObjIsUniformcleancleanPlotsclusterGeneContingencyTablesclustersDeltaExpressionclustersMarkersHeatmapPlotclustersSummaryDataclustersSummaryPlotclustersTreePlotconditionsFromNamescontingencyTablesconvertFromSingleCellExperimentconvertToSingleCellExperimentCOTANdatasetTagsDEAOnClustersdfToCheckersdistancesBetweenClustersdropCellsCoexdropClusterizationdropConditiondropGenesCellsdropGenesCoexECDPlotestablishGenesClustersestimateDispersionNuBisectionestimateDispersionViaSolverestimateLambdaLinearestimateNuLinearestimateNuLinearByClusterestimatorsAreReadyexpectedContingencyTablesexpectedContingencyTablesNNexpectedPartialContingencyTablesexpectedPartialContingencyTablesNNfactorToVectorfindClustersMarkersfindFullyExpressedGenesfindFullyExpressingCellsflagNotFullyExpressedGenesflagNotFullyExpressingCellsfromClustersListGDIPlotgenesCoexSpacegeneSetEnrichmentgenesHeatmapPlotgenesPercentagePlotgenesSizePlotgetAllConditionsgetCellsgetCellsCoexgetCellsSizegetCheckerThresholdgetClusterizationDatagetClusterizationNamegetClusterizationsgetClustersgetClustersCoexgetColorsVectorgetColumnFromDFgetConditiongetConditionNamegetDataMatrixgetDimsgetDispersiongetFullyExpressedGenesgetFullyExpressingCellsgetGDIgetGenesgetGenesCoexgetGenesSizegetLambdagetLogNormDatagetMetadataCellsgetMetadataDatasetgetMetadataElementgetMetadataGenesgetMugetNormalizedDatagetNugetNumCellsgetNumExpressedGenesgetNumGenesgetNumOfExpressingCellsgetNuNormDatagetProbabilityOfZerogetRawDatagetSelectedGenesgetZeroOneProjgroupByClustersgroupByClustersListheatmapPlotinitializeMetaDatasetisCoexAvailablelogFoldChangeOnClusterslogThismat2vec_rfastmergeClustersmergeUniformCellsClustersmitochondrialPercentagePlotmultiMergeClustersniceFactorLevelsnormalizeNameAndLabelsobservedContingencyTablesobservedContingencyTablesYYobservedPartialContingencyTablesobservedPartialContingencyTablesYYplotThemeproceedToCoexpValueFromDEAreorderClusterizationscatterPlotscreePlotsetColumnInDFsetDispersionsetLambdasetLoggingFilesetLoggingLevelsetNushiftCheckerThresholdsstoreGDItoClustersListUMAPPlotvec2mat_rfast

Dependencies:abindaskpassassertthatassortheadbase64encbeachmatBHBiobaseBiocGenericsBiocManagerBiocParallelBiocSingularBiocStylebitbit64bitopsbookdownbslibcachemcaToolscirclizeclicliprclueclustercodetoolscolorspacecommonmarkComplexHeatmapconflictedcowplotcpp11crayoncrosstalkcurldata.tableDelayedArraydeldirdendextenddigestdistributionaldoParalleldotCall64dplyrdqrngevaluatefarverfastDummiesfastmapfitdistrplusFNNfontawesomeforeachformatRfsfutile.loggerfutile.optionsfuturefuture.applygenericsGenomicRangesGEOqueryGetoptLongggdistggplot2ggrepelggridgesggthemesGlobalOptionsglobalsgluegoftestgplotsgridExtragtablegtoolsherehighrhmshtmltoolshtmlwidgetshttpuvhttrhttr2icaigraphIRangesirlbaisobanditeratorsjquerylibjsonliteKernSmoothknitrlabelinglambda.rlaterlatticelazyevallifecyclelimmalistenvlmtestmagrittrMASSMatrixMatrixGenericsmatrixStatsmemoisemimeminiUInlmenumDerivopensslotelparallelDistparallellypatchworkpbapplypillarpkgconfigplotlyplyrpngpolyclipprettyunitsprogressprogressrpromisesproxypurrrquadprogR.methodsS3R.ooR.utilsR6RANNrappdirsRColorBrewerRcppRcppAnnoyRcppArmadilloRcppEigenRcppHNSWRcppParallelRcppProgressRcppTOMLreadrrentrezreshape2reticulateRfastrjsonrlangrmarkdownROCRrprojrootRSpectrarsvdRtsnervestS4ArraysS4VectorsS7sassScaledMatrixscalesscattermoresctransformselectrSeqinfoSeuratSeuratObjectshapeshinySingleCellExperimentsitmosnowsourcetoolsspspamSparseArrayspatstat.dataspatstat.explorespatstat.geomspatstat.randomspatstat.sparsespatstat.univarspatstat.utilsstatmodstringistringrSummarizedExperimentsurvivalsystensortibbletidyrtidyselecttinytextzdbutf8uwotvctrsviridisviridisLitevroomwithrxfunXMLxml2xtableXVectoryamlzeallotziggzoo

Guided tutorial to datasets cleaning using COTAN

Silvia Giulia Galfrè, Marco Fantozzi

Rendered fromCleaning_GuidedTutorial.Rmdusingknitr::rmarkdownon May 20 2026.

Last update: 2026-03-19
Started: 2026-03-11

Guided tutorial to Differential Expression Analysis using COTAN

Silvia Giulia Galfrè, Marco Fantozzi

Rendered fromDiffExprAnalysis_GuidedTutorial.Rmdusingknitr::rmarkdownon May 20 2026.

Last update: 2026-03-19
Started: 2026-03-15

Guided tutorial to genes' clustering using COTAN

Silvia Giulia Galfrè, Marco Fantozzi

Rendered fromGenesClustering_GuidedTutorial.Rmdusingknitr::rmarkdownon May 20 2026.

Last update: 2026-03-15
Started: 2026-03-11

Guided tutorial to Uniform Transcript cells' clustering using COTAN

Silvia Giulia Galfrè, Marco Fantozzi

Rendered fromUniformClustering_GuidedTutorial.Rmdusingknitr::rmarkdownon May 20 2026.

Last update: 2026-03-19
Started: 2026-03-11

Readme and manuals

Help Manual

Help pageTopics
_Clusters_ utilitiesasClusterization ClustersList fromClustersList groupByClusters groupByClustersList mergeClusters multiMergeClusters toClustersList
Data class conversionsConversions convertFromSingleCellExperiment convertToSingleCellExperiment
Handle legacy 'scCOTAN'-class and related symmetric matrix <-> vector conversionsclustersDeltaExpression COTAN_coerce_to_scCOTAN COTAN_Legacy mat2vec_rfast scCOTAN-class scCotan_coerce_to_COTAN vec2mat_rfast
'COTAN' shortcutsautomaticCOTANObjectCreation COTAN COTAN_ObjectCreation proceedToCoex proceedToCoex,COTAN-method
The 'COTAN' classCOTAN-class
Data-setsDatasets ERCCraw raw.dataset test.dataset test.dataset.clusters1 test.dataset.clusters2 vignette.cells.origin vignette.merge.clusters vignette.split.clusters
'getColorsVector'getColorsVector
Calculations of genes statisticscalculateGDI calculateGDIGivenCorr calculateGDIGivenS calculateGenesCE calculatePDI calculatePValue establishGenesClusters genesCoexSpace GenesStatistics getGDI getGDI,COTAN-method storeGDI storeGDI,COTAN-method
Calculating the COEX matrix for genes and cellscalculateCoex calculateCoex,COTAN-method calculateG calculateLikelihoodOfObserved calculateMu calculatePartialCoex calculateReducedDataMatrix calculateS CalculatingCOEX contingencyTables dropCellsCoex dropCellsCoex,COTAN-method dropGenesCoex dropGenesCoex,COTAN-method expectedContingencyTables expectedContingencyTablesNN expectedPartialContingencyTables expectedPartialContingencyTablesNN getCellsCoex getCellsCoex,COTAN-method getDataMatrix getGenesCoex getGenesCoex,COTAN-method getMu getSelectedGenes isCoexAvailable isCoexAvailable,COTAN-method observedContingencyTables observedContingencyTablesYY observedPartialContingencyTables observedPartialContingencyTablesYY
Handling _meta-data_ in 'COTAN' objectsaddElementToMetaDataset addElementToMetaDataset,COTAN-method datasetTags getColumnFromDF getDims getDims,COTAN-method getMetadataCells getMetadataCells,COTAN-method getMetadataDataset getMetadataDataset,COTAN-method getMetadataElement getMetadataElement,COTAN-method getMetadataGenes getMetadataGenes,COTAN-method getMetaInfoRow HandleMetaData initializeMetaDataset initializeMetaDataset,COTAN-method setColumnInDF updateMetaInfo
Handle names and factors' levelsconditionsFromNames factorToVector handleNamesSubsets HandleStrings isEmptyName niceFactorLevels
Handling cells' _clusterization_ and related functionsaddClusterization addClusterization,COTAN-method addClusterizationCoex addClusterizationCoex,COTAN-method cellsUMAPPlot clusterGeneContingencyTables clustersMarkersHeatmapPlot clustersSummaryData clustersSummaryPlot clustersTreePlot DEAOnClusters distancesBetweenClusters dropClusterization dropClusterization,COTAN-method estimateNuLinearByCluster estimateNuLinearByCluster,COTAN-method findClustersMarkers geneSetEnrichment getClusterizationData getClusterizationData,COTAN-method getClusterizationName getClusterizationName,COTAN-method getClusterizations getClusterizations,COTAN-method getClusters getClustersCoex getClustersCoex,COTAN-method HandlingClusterizations logFoldChangeOnClusters pValueFromDEA reorderClusterization UMAPPlot
Handling cells' _conditions_ and related functionsaddCondition addCondition,COTAN-method dropCondition dropCondition,COTAN-method getAllConditions getAllConditions,COTAN-method getCondition getCondition,COTAN-method getConditionName getConditionName,COTAN-method HandlingConditions normalizeNameAndLabels
Heatmap PlotscellsHeatmapPlot genesHeatmapPlot heatmapPlot HeatmapPlots plotTheme singleHeatmapDF
Installing 'torch' 'R' library (on 'WSL-Linux')Installing_torch
Logging in the 'COTAN' packageLoggingFunctions logThis setLoggingFile setLoggingLevel
Handling Multi-Core and GPU environmentscanUseTorch handleMultiCore MultiThreading
Numeric UtilitiescalcDist dispersionBisection dispersionNewton funProbZero nuBisection NumericUtilities parallelDispersionBisection parallelDispersionNewton parallelNuBisection
Estimation of the 'COTAN' model's parametersestimateDispersionBisection estimateDispersionNuBisection estimateDispersionNuBisection,COTAN-method estimateDispersionNuNlminb estimateDispersionNuNlminb,COTAN-method estimateDispersionViaSolver estimateDispersionViaSolver,COTAN-method estimateLambdaLinear estimateLambdaLinear,COTAN-method estimateNuBisection estimateNuBisection,COTAN-method estimateNuLinear estimateNuLinear,COTAN-method estimatorsAreReady getDispersion getDispersion,COTAN-method getLambda getLambda,COTAN-method getLogNormData getNormalizedData getNu getNu,COTAN-method getNuNormData getProbabilityOfZero ParametersEstimations
Raw data cleaningcellSizePlot clean clean,COTAN-method cleanPlots dropGenesCells dropGenesCells,COTAN-method ECDPlot findFullyExpressedGenes findFullyExpressedGenes,COTAN-method findFullyExpressingCells findFullyExpressingCells,COTAN-method flagNotFullyExpressedGenes flagNotFullyExpressedGenes,COTAN-method flagNotFullyExpressingCells flagNotFullyExpressingCells,COTAN-method genesPercentagePlot genesSizePlot getFullyExpressedGenes getFullyExpressedGenes,COTAN-method getFullyExpressingCells getFullyExpressingCells,COTAN-method mitochondrialPercentagePlot RawDataCleaning scatterPlot screePlot setDispersion setDispersion,COTAN-method setLambda setLambda,COTAN-method setNu setNu,COTAN-method
Raw data 'COTAN' accessorsgetCells getCells,COTAN-method getCellsSize getCellsSize,COTAN-method getGenes getGenes,COTAN-method getGenesSize getGenesSize,COTAN-method getNumCells getNumCells,COTAN-method getNumExpressedGenes getNumExpressedGenes,COTAN-method getNumGenes getNumGenes,COTAN-method getNumOfExpressingCells getNumOfExpressingCells,COTAN-method getRawData getRawData,COTAN-method getZeroOneProj getZeroOneProj,COTAN-method RawDataGetters
Uniform ClusterscellsUniformClustering checkClusterUniformity GDIPlot mergeUniformCellsClusters UniformClusters
Definition of the *Transcript Uniformity Checker* classesAdvancedGDIUniformityCheck-class BaseUniformityCheck-class calculateThresholdShiftToUniformity calculateThresholdShiftToUniformity,AdvancedGDIUniformityCheck-method calculateThresholdShiftToUniformity,SimpleGDIUniformityCheck-method checkersToDF checkObjIsUniform checkObjIsUniform,AdvancedGDIUniformityCheck-method checkObjIsUniform,SimpleGDIUniformityCheck-method dfToCheckers GDICheck-class getCheckerThreshold getCheckerThreshold,AdvancedGDIUniformityCheck-method getCheckerThreshold,SimpleGDIUniformityCheck-method shiftCheckerThresholds shiftCheckerThresholds,AdvancedGDIUniformityCheck,numeric-method shiftCheckerThresholds,SimpleGDIUniformityCheck,numeric-method SimpleGDIUniformityCheck-class UniformTranscriptCheckers