{ "_id": "6a155a64acfb0bcc41d5f202", "Package": "CellProgramMapper", "Type": "Package", "Title": "Map Single Cells to Reference Gene Expression Programs", "Version": "1.0.0", "Date": "2026-01-26", "Authors@R": "c(\nperson(\"Zaoqu\", \"Liu\", email = \"liuzaoqu@163.com\", role = c(\"aut\", \"cre\"),\ncomment = c(ORCID = \"0000-0002-0452-742X\"))\n)", "Description": "Maps single-cell RNA sequencing data to reference gene\nexpression programs (GEPs) using non-negative matrix\nfactorization. Enables cell type annotation and state\ncharacterization by projecting query cells onto pre-built or\ncustom reference programs. Includes tools for building\nconsensus references from multiple datasets. Features C++\naccelerated NNLS solvers and built-in machine learning models\nfor cell type prediction.", "License": "MIT + file LICENSE", "URL": "https://github.com/Zaoqu-Liu/CellProgramMapper,\nhttps://zaoqu-liu.github.io/CellProgramMapper/", "BugReports": "https://github.com/Zaoqu-Liu/CellProgramMapper/issues", "Encoding": "UTF-8", "Roxygen": "list(markdown = TRUE)", "RoxygenNote": "7.3.3", "VignetteBuilder": "knitr", "Config/testthat/edition": "3", "NeedsCompilation": "yes", "Config/pak/sysreqs": "libssl-dev", "Repository": "https://zaoqu-liu.r-universe.dev", "Date/Publication": "2026-01-26 05:56:10 UTC", "RemoteUrl": "https://github.com/Zaoqu-Liu/CellProgramMapper", "RemoteRef": "main", "RemoteSha": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "Packaged": { "Date": "2026-05-26 08:24:32 UTC", "User": "root" }, "Author": "Zaoqu Liu [aut, cre] (ORCID: )", "Maintainer": "Zaoqu Liu ", "MD5sum": "63973725073251462ff2ce34d16c6f6a", "_user": "zaoqu-liu", "_type": "src", "_file": "CellProgramMapper_1.0.0.tar.gz", "_fileid": "35264d8a331843502dd7fbe0ee511e49548efea30aede3f688f9ae6c5bb1f2f9", "_filesize": 1523595, "_sha256": "35264d8a331843502dd7fbe0ee511e49548efea30aede3f688f9ae6c5bb1f2f9", "_created": "2026-05-26T08:24:32.000Z", "_published": "2026-05-26T08:31:32.495Z", "_distro": "noble", "_jobs": [ { "job": 77835545342, "time": 210, "config": "linux-devel-arm64", "r": "4.7.0", "check": "OK", "artifact": "7212316002" }, { "job": 77835545362, "time": 236, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "7212324014" }, { "job": 77835545349, "time": 203, "config": "linux-release-arm64", "r": "4.6.0", "check": "OK", "artifact": "7212313792" }, { "job": 77835545463, "time": 212, "config": "linux-release-x86_64", "r": "4.6.0", "check": "OK", "artifact": "7212316728" }, { "job": 77835545383, "time": 104, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "OK", "artifact": "7212282575" }, { "job": 77835545435, "time": 293, "config": "macos-oldrel-x86_64", "r": "4.5.3", "check": "OK", "artifact": "7212342142" }, { "job": 77835545516, "time": 108, "config": "macos-release-arm64", "r": "4.6.0", "check": "OK", "artifact": "7212283772" }, { "job": 77835545446, "time": 361, "config": "macos-release-x86_64", "r": "4.6.0", "check": "OK", "artifact": "7212365050" }, { "job": 77834829188, "time": 278, "config": "source", "r": "4.6.0", "check": "OK", "artifact": "7212247600" }, { "job": 77835545309, "time": 168, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "7212302719" }, { "job": 77835545316, "time": 191, "config": "windows-devel", "r": "4.7.0", "check": "OK", "artifact": "7212309984" }, { "job": 77835545356, "time": 190, "config": "windows-oldrel", "r": "4.5.3", "check": "OK", "artifact": "7212309956" }, { "job": 77835545305, "time": 192, "config": "windows-release", "r": "4.6.0", "check": "OK", "artifact": "7212311229" } ], "_buildurl": "https://github.com/r-universe/zaoqu-liu/actions/runs/26440892292", "_status": "success", "_host": "GitHub-Actions", "_upstream": "https://github.com/Zaoqu-Liu/CellProgramMapper", "_commit": { "id": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "author": "Zaoqu-Liu ", "committer": "Zaoqu-Liu ", "message": "fix: 深度修复三个关键问题 + 科学准确性改进\n\n修复问题:\n1. Score 计算失败 - 修复 data.frame 初始化时 rownames 为空导致的 0 行问题\n2. 路径展开失败 - 在所有文件操作函数中添加 path.expand() 处理 ~ 路径\n3. Python 依赖 - 为 TCAT.V1 等参考提供纯 R 内置模型替代 Python sklearn\n\n科学准确性修复:\n- 新增 sklearn_standardize() 函数，使用 population SD (ddof=0, 除以 n)\n- 修复 R scale() 与 sklearn StandardScaler 的不一致问题\n (R 使用 n-1 分母，sklearn 使用 n 分母)\n- 确保 lineage 预测结果与 Python 实现数值一致\n\n新增测试:\n- sklearn_standardize 与 sklearn StandardScaler 行为一致性验证\n- 边界情况处理 (常量列、单行矩阵)\n- compute_scores 空矩阵和无行名处理\n- ensure_dir 路径展开验证\n\n测试结果: 247 PASS, 0 FAIL\n", "time": 1769406970 }, "_maintainer": { "name": "Zaoqu Liu", "email": "liuzaoqu@163.com", "login": "zaoqu-liu", "orcid": "0000-0002-0452-742X", "description": "AI4S", "uuid": 68080738 }, "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 4.0.0", "role": "Depends" }, { "package": "Rcpp", "role": "LinkingTo" }, { "package": "RcppArmadillo", "role": "LinkingTo" }, { "package": "Rcpp", "version": ">= 1.0.0", "role": "Imports" }, { "package": "Matrix", "role": "Imports" }, { "package": "methods", "role": "Imports" }, { "package": "stats", "role": "Imports" }, { "package": "utils", "role": "Imports" }, { "package": "curl", "role": "Imports" }, { "package": "yaml", "role": "Imports" }, { "package": "future", "role": "Imports" }, { "package": "future.apply", "role": "Imports" }, { "package": "data.table", "role": "Imports" }, { "package": "rappdirs", "role": "Imports" }, { "package": "tools", "role": "Imports" }, { "package": "jsonlite", "role": "Imports" }, { "package": "Seurat", "version": ">= 4.0.0", "role": "Suggests" }, { "package": "SeuratObject", "version": ">= 4.0.0", "role": "Suggests" }, { "package": "testthat", "version": ">= 3.0.0", "role": "Suggests" }, { "package": "knitr", "role": "Suggests" }, { "package": "rmarkdown", "role": "Suggests" }, { "package": "ggplot2", "role": "Suggests" }, { "package": "pheatmap", "role": "Suggests" }, { "package": "reshape2", "role": "Suggests" }, { "package": "anndata", "role": "Suggests" }, { "package": "hdf5r", "role": "Suggests" }, { "package": "reticulate", "role": "Suggests" } ], "_owner": "zaoqu-liu", "_selfowned": true, "_usedby": 0, "_updates": [ { "week": "2026-05", "n": 14 } ], "_tags": [], "_stars": 1, "_contributors": [ { "user": "zaoqu-liu", "count": 14, "uuid": 68080738 } ], "_userbio": { "uuid": 68080738, "type": "user", "name": "LIU Zaoqu", "description": "AI4S" }, "_downloads": { "count": 0, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/CellProgramMapper" }, "_devurl": "https://github.com/zaoqu-liu/cellprogrammapper", "_pkgdown": "https://zaoqu-liu.github.io/CellProgramMapper/", "_searchresults": 12, "_topics": [ "openblas", "cpp", "openmp" ], "_rbuild": "4.6.0", "_assets": [ "extra/CellProgramMapper.html", "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/readme.html", "extra/readme.md", "manual.pdf" ], "_cranurl": false, "_exports": [ "add_results_to_seurat", "available_references", "BuildConsensusReference", "CellProgramMapper", "compute_scores", "create_score_data", "create_score_definition", "download_reference", "get_lineage_probabilities", "get_scores", "get_usage", "list_builtin_models", "load_counts", "load_reference", "read_df_from_npz", "read_npz", "save_results" ], "_help": [ { "page": "add_results_to_seurat", "title": "Add Results to Seurat Object", "topics": [ "add_results_to_seurat" ] }, { "page": "available_references", "title": "List Available Pre-built References", "topics": [ "available_references" ] }, { "page": "BuildConsensusReference", "title": "Build Consensus Reference from Multiple cNMF Results", "topics": [ "BuildConsensusReference" ] }, { "page": "CellProgramMapper", "title": "Map Single Cells to Reference Gene Expression Programs", "topics": [ "CellProgramMapper" ] }, { "page": "compute_scores", "title": "Compute Add-on Scores", "topics": [ "compute_scores" ] }, { "page": "consensus", "title": "Build Consensus Reference from Multiple cNMF Results", "topics": [ "consensus" ] }, { "page": "create_score_data", "title": "Create Score Data Structure", "topics": [ "create_score_data" ] }, { "page": "create_score_definition", "title": "Create Custom Score Definition", "topics": [ "create_score_definition" ] }, { "page": "download_reference", "title": "Download Reference to Cache", "topics": [ "download_reference" ] }, { "page": "get_lineage_probabilities", "title": "Get Lineage Probabilities", "topics": [ "get_lineage_probabilities" ] }, { "page": "get_scores", "title": "Extract Scores from Result", "topics": [ "get_scores" ] }, { "page": "get_usage", "title": "Extract Usage Matrix from Result", "topics": [ "get_usage" ] }, { "page": "io", "title": "Data Input/Output Functions", "topics": [ "io" ] }, { "page": "list_builtin_models", "title": "List Available Built-in Models", "topics": [ "list_builtin_models" ] }, { "page": "load_counts", "title": "Load Counts Matrix from Various Formats", "topics": [ "load_counts" ] }, { "page": "load_reference", "title": "Load Reference Spectra", "topics": [ "load_reference" ] }, { "page": "mapper", "title": "CellProgramMapper - Main Function", "topics": [ "mapper" ] }, { "page": "print.CellProgramMapperResult", "title": "Print Method for CellProgramMapperResult", "topics": [ "print.CellProgramMapperResult" ] }, { "page": "read_df_from_npz", "title": "Read DataFrame from NPZ File", "topics": [ "read_df_from_npz" ] }, { "page": "read_npz", "title": "Read NumPy .npz File", "topics": [ "read_npz" ] }, { "page": "reference", "title": "Reference Management Functions", "topics": [ "reference" ] }, { "page": "save_results", "title": "Save Results to Files", "topics": [ "save_results" ] }, { "page": "scoring", "title": "Scoring Functions", "topics": [ "scoring" ] }, { "page": "summary.CellProgramMapperResult", "title": "Summary Method for CellProgramMapperResult", "topics": [ "summary.CellProgramMapperResult" ] } ], "_readme": "https://github.com/Zaoqu-Liu/CellProgramMapper/raw/main/README.md", "_rundeps": [ "codetools", "curl", "data.table", "digest", "future", "future.apply", "globals", "jsonlite", "lattice", "listenv", "Matrix", "parallelly", "rappdirs", "Rcpp", "RcppArmadillo", "yaml" ], "_sysdeps": [ { "shlib": "liblapack", "package": "libopenblas0-pthread", "source": "openblas", "version": "0.3.26+ds-1ubuntu0.1", "name": "openblas", "homepage": "https://www.openblas.net/", "description": "Optimized BLAS (linear algebra) library (shared lib, pthread)" }, { "shlib": "libblas", "package": "libopenblas0-pthread", "source": "openblas", "version": "0.3.26+ds-1ubuntu0.1", "name": "openblas", "homepage": "https://www.openblas.net/", "description": "Optimized BLAS (linear algebra) library (shared lib, pthread)" }, { "shlib": "libstdc++", "package": "libstdc++6", "source": "gcc", "version": "14.2.0-4ubuntu2~24.04.1", "name": "c++", "homepage": "http://gcc.gnu.org/", "description": "GNU Standard C++ Library v3" }, { "shlib": "libgomp", "package": "libgomp1", "source": "gcc", "version": "14.2.0-4ubuntu2~24.04.1", "name": "openmp", "homepage": "http://gcc.gnu.org/", "description": "GCC OpenMP (GOMP) support library" } ], "_vignettes": [ { "source": "custom-reference.Rmd", "filename": "custom-reference.html", "title": "Building Custom References", "author": "Zaoqu Liu", "engine": "knitr::rmarkdown", "headings": [ "Introduction", "Reference Format", "File Format", "Method 1: From cNMF Results", "Running cNMF", "Loading cNMF Results", "Method 2: Building Consensus Reference", "Method 3: Manual Construction", "From Known Gene Signatures", "From Expression Data", "Validating Custom References", "Quality Checks", "Visualize Reference", "Saving References", "As TSV File", "With Metadata", "Using Custom References", "Best Practices", "Reference Construction", "Gene Overlap", "Recommendations", "Troubleshooting", "Low Gene Overlap", "All-Zero Usage", "High Reconstruction Error", "Session Info" ], "created": "2026-01-26 04:08:58", "modified": "2026-01-26 04:08:58", "commits": 1 }, { "source": "algorithm.Rmd", "filename": "algorithm.html", "title": "Mathematical Framework and Algorithm", "author": "Zaoqu Liu", "engine": "knitr::rmarkdown", "headings": [ "Introduction", "Problem Formulation", "Non-Negative Matrix Factorization (NMF)", "Projection Problem", "Cell-wise Decomposition", "NNLS Problem", "Standard Form", "KKT Conditions", "Data Preprocessing", "Scaling", "Why Not Center?", "Usage Normalization", "Computational Complexity", "Visualization of the Algorithm", "Example: Geometric Interpretation", "Summary", "References", "Session Info" ], "created": "2026-01-26 04:08:58", "modified": "2026-01-26 04:19:48", "commits": 2 }, { "source": "nnls-solver.Rmd", "filename": "nnls-solver.html", "title": "NNLS Solver Implementation Details", "author": "Zaoqu Liu", "engine": "knitr::rmarkdown", "headings": [ "Overview", "The NNLS Problem", "Active Set Method (Lawson-Hanson)", "Algorithm Description", "Convergence Properties", "Implementation", "Coordinate Descent Method", "Advantages", "Comparison", "Benchmark", "Choosing a Solver", "Numerical Considerations", "Tolerance Parameter", "Maximum Iterations", "Division by Zero Protection", "Session Info" ], "created": "2026-01-26 04:08:58", "modified": "2026-01-26 04:19:48", "commits": 2 }, { "source": "quickstart.Rmd", "filename": "quickstart.html", "title": "Quick Start Guide", "author": "Zaoqu Liu", "engine": "knitr::rmarkdown", "headings": [ "Introduction", "Installation", "Quick Example", "Available References", "Input Formats", "Working with Results", "Access Usage Matrix", "Access Scores", "Save Results", "Demonstration with Simulated Data", "Performance Tips", "Next Steps", "Session Info" ], "created": "2026-01-26 03:28:32", "modified": "2026-01-26 04:19:48", "commits": 3 }, { "source": "visualization.Rmd", "filename": "visualization.html", "title": "Visualization Guide", "author": "Zaoqu Liu", "engine": "knitr::rmarkdown", "headings": [ "Introduction", "Load Example Data", "Simulated Example Data", "Usage Matrix Heatmap", "Program Activity on UMAP", "Score Distributions", "Violin Plots", "Ridge Plot", "Program Correlation Analysis", "Correlation Heatmap", "Network Visualization", "Publication-Ready Figures", "Combined Panel Figure", "Saving High-Resolution Figures", "Integration with Seurat", "Tips for Effective Visualization", "Session Info" ], "created": "2026-01-26 04:08:58", "modified": "2026-01-26 04:08:58", "commits": 1 } ], "_score": 3.4771212547196626, "_indexed": true, "_nocasepkg": "cellprogrammapper", "_universes": [ "zaoqu-liu" ], "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "1.0.0", "date": "2026-05-26T08:27:50.000Z", "distro": "noble", "arch": "aarch64", "commit": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "fileid": "4c75c47b73a9d2054c09f2c3e994254bc6c78059d96e5be6e7a6f15846696ebf", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/zaoqu-liu/actions/runs/26440892292" }, { "r": "4.7.0", "os": "linux", "version": "1.0.0", "date": "2026-05-26T08:28:14.000Z", "distro": "noble", "arch": "x86_64", "commit": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "fileid": "e464e44451b6a81745481df1f7f923d46b459540745b00ba65d0fc12892d79a1", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/zaoqu-liu/actions/runs/26440892292" }, { "r": "4.6.0", "os": "linux", "version": "1.0.0", "date": "2026-05-26T08:27:48.000Z", "distro": "noble", "arch": "aarch64", "commit": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "fileid": "c80e65fe4cdb95a36e6ee4f1c9e347ead40caeef37d067e4c08c06c9b266ea32", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/zaoqu-liu/actions/runs/26440892292" }, { "r": "4.6.0", "os": "linux", "version": "1.0.0", "date": "2026-05-26T08:27:52.000Z", "distro": "noble", "arch": "x86_64", "commit": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "fileid": "64525d1de60feb7b33199d19056a5bb6bf1c59c1a3b2043e78c1c77c6c841386", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/zaoqu-liu/actions/runs/26440892292" }, { "r": "4.5.3", "os": "mac", "version": "1.0.0", "date": "2026-05-26T08:26:26.000Z", "arch": "aarch64", "commit": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "fileid": "33ff6eab3f906a1589c6b70e6a4940e468dc93d7e1e5afe0af2d1ed7f2cdfe03", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/zaoqu-liu/actions/runs/26440892292" }, { "r": "4.5.3", "os": "mac", "version": "1.0.0", "date": "2026-05-26T08:28:14.000Z", "arch": "x86_64", "commit": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "fileid": "34866a740a5ee88dc8e246b4f3256f05f4eecb91e1528f8b4f6d4acd7792db27", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/zaoqu-liu/actions/runs/26440892292" }, { "r": "4.6.0", "os": "mac", "version": "1.0.0", "date": "2026-05-26T08:26:27.000Z", "arch": "aarch64", "commit": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "fileid": "e6669361b7d8122348a306f1770eac0e1733c2198b255249ff8025ea14186625", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/zaoqu-liu/actions/runs/26440892292" }, { "r": "4.6.0", "os": "mac", "version": "1.0.0", "date": "2026-05-26T08:28:31.000Z", "arch": "x86_64", "commit": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "fileid": "6b83aff90da35e95ea4a96d3dbc2fca812482e358e8528e29f64886638f92edc", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/zaoqu-liu/actions/runs/26440892292" }, { "r": "4.6.0", "os": "wasm", "version": "1.0.0", "date": "2026-05-26T08:27:46.000Z", "arch": "emscripten", "commit": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "fileid": "0f53b24daed40cd7245f765f8f9fcdac86a370283f140faa28f6aab33f80bdce", "status": "success", "buildurl": "https://github.com/r-universe/zaoqu-liu/actions/runs/26440892292" }, { "r": "4.7.0", "os": "win", "version": "1.0.0", "date": "2026-05-26T08:26:41.000Z", "arch": "x86_64", "commit": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "fileid": "b9ceb31674cb93e125483d650c2ddaf1d0d6519a38eba1a8b9a77d7f3b64c581", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/zaoqu-liu/actions/runs/26440892292" }, { "r": "4.5.3", "os": "win", "version": "1.0.0", "date": "2026-05-26T08:26:50.000Z", "arch": "x86_64", "commit": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "fileid": "9045747f37d5bba89fc7e4ad1531bf5588201035a4e31985e1050d625047fe0d", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/zaoqu-liu/actions/runs/26440892292" }, { "r": "4.6.0", "os": "win", "version": "1.0.0", "date": "2026-05-26T08:26:50.000Z", "arch": "x86_64", "commit": "aa7f0ba8d09dcdb7958f65f4fd9c35cbdd4fcd44", "fileid": "0f1a4a8e38710b3a8dc8f659463093042713fb949c60d240c213134d80617e0d", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/zaoqu-liu/actions/runs/26440892292" } ] }