{
  "_id": "6adc6cfc077e75fa285b0ceb",
  "Package": "dsb",
  "Type": "Package",
  "Title": "Normalize & Denoise Droplet Single Cell Protein Data (CITE-Seq)",
  "Version": "2.0.1",
  "Authors@R": "c(person(given = \"Matthew\",\nfamily = \"Mulè\",\nrole = c(\"aut\", \"cre\"),\nemail = \"mattmule@gmail.com\",\ncomment = c(ORCID = \"0000-0001-8457-2716\")),\nperson(given = \"Andrew\",\nfamily = \"Martins\",\nrole = \"aut\",\nemail = \"andrew.martins@nih.gov\",\ncomment = c(ORCID = \"0000-0002-1832-1924\")),\nperson(given = \"John\",\nfamily = \"Tsang\",\nrole = \"pdr\",\nemail = \"john.tsang@nih.gov\",\ncomment = c(ORCID = \"0000-0003-3186-3047\")))",
  "Description": "This lightweight R package provides a method for\nnormalizing and denoising protein expression data from droplet\nbased single cell experiments. Raw protein Unique Molecular\nIndex (UMI) counts from sequencing DNA-conjugated antibody\nderived tags (ADT) in droplets (e.g. 'CITE-seq') have\nsubstantial measurement noise. Our experiments and\ncomputational modeling revealed two major components of this\nnoise: 1) protein-specific noise originating from ambient,\nunbound antibody encapsulated in droplets that can be\naccurately inferred via the expected protein counts detected in\nempty droplets, and 2) droplet/cell-specific noise revealed via\nthe shared variance component associated with isotype antibody\ncontrols and background protein counts in each cell. This\npackage normalizes and removes both of these sources of noise\nfrom raw protein data derived from methods such as 'CITE-seq',\n'REAP-seq', 'ASAP-seq', 'TEA-seq', 'proteogenomic' data from\nthe Mission Bio platform, etc. See the vignette for tutorials\non how to integrate dsb with 'Seurat' and 'Bioconductor' and\nhow to use dsb in 'Python'. Please see our paper Mulè M.P.,\nMartins A.J., and Tsang J.S. Nature Communications 2022\n<https://www.nature.com/articles/s41467-022-29356-8> for more\ndetails on the method.",
  "License": "CC0 | file LICENSE",
  "Encoding": "UTF-8",
  "LazyData": "true",
  "RoxygenNote": "7.3.2",
  "biocViews": "",
  "URL": "https://github.com/niaid/dsb",
  "BugReports": "https://github.com/niaid/dsb/issues",
  "VignetteBuilder": "knitr, rmarkdown",
  "Language": "en-US",
  "Repository": "https://niaid.r-universe.dev",
  "Date/Publication": "2025-11-02 12:25:12 UTC",
  "RemoteUrl": "https://github.com/niaid/dsb",
  "RemoteRef": "HEAD",
  "RemoteSha": "aab21279fe8f96ab480cc27503716410ecca1310",
  "NeedsCompilation": "no",
  "Packaged": {
    "Date": "2026-10-24 08:28:49 UTC",
    "User": "root"
  },
  "Author": "Matthew Mulè [aut, cre] (ORCID:\n<https://orcid.org/0000-0001-8457-2716>),\nAndrew Martins [aut] (ORCID: <https://orcid.org/0000-0002-1832-1924>),\nJohn Tsang [pdr] (ORCID: <https://orcid.org/0000-0003-3186-3047>)",
  "Maintainer": "Matthew Mulè <mattmule@gmail.com>",
  "_user": "niaid",
  "_type": "src",
  "_file": "dsb_2.0.1.tar.gz",
  "_fileid": "https://r2.ropensci.org/574280ca3af37d1f1333215bead439987dc37b02e24b9aff50a2d1f114f85bb1",
  "_filesize": 4130237,
  "_sha256": "574280ca3af37d1f1333215bead439987dc37b02e24b9aff50a2d1f114f85bb1",
  "_expires": "2027-02-01T08:31:55.000Z",
  "_created": "2026-10-24T08:28:49.000Z",
  "_published": "2026-10-24T08:31:56.866Z",
  "_upstream": "https://github.com/niaid/dsb",
  "_status": "success",
  "_maintainer": {
    "name": "Matthew Mulè",
    "email": "mattmule@gmail.com",
    "login": "mattpm",
    "twitter": "@mpmule",
    "description": "",
    "uuid": 15280712,
    "orcid": "0000-0001-8457-2716"
  },
  "_jobs": [
    {
      "job": 120826078756,
      "time": 120,
      "config": "linux-devel-x86_64",
      "r": "4.7.0",
      "check": "OK",
      "artifact": "12554441126"
    },
    {
      "job": 120826078721,
      "time": 130,
      "config": "linux-release-x86_64",
      "r": "4.6.1",
      "check": "OK",
      "artifact": "12554635227"
    },
    {
      "job": 120826078747,
      "time": 147,
      "config": "macos-oldrel-arm64",
      "r": "4.5.3",
      "check": "OK",
      "artifact": "12553789295"
    },
    {
      "job": 120826078761,
      "time": 145,
      "config": "macos-release-arm64",
      "r": "4.6.1",
      "check": "OK",
      "artifact": "12554250966"
    },
    {
      "job": 120825346971,
      "time": 227,
      "config": "source",
      "r": "4.6.1",
      "check": "OK",
      "artifact": "12554520392"
    },
    {
      "job": 120826078675,
      "time": 104,
      "config": "wasm-release",
      "r": "4.6.0",
      "check": "OK",
      "artifact": "12554575500"
    },
    {
      "job": 120826078703,
      "time": 95,
      "config": "windows-devel-x86_64",
      "r": "4.7.0",
      "check": "OK",
      "artifact": "12553403996"
    },
    {
      "job": 120826078727,
      "time": 87,
      "config": "windows-oldrel-x86_64",
      "r": "4.5.3",
      "check": "OK",
      "artifact": "12553784077"
    },
    {
      "job": 120826078750,
      "time": 85,
      "config": "windows-release-x86_64",
      "r": "4.6.1",
      "check": "OK",
      "artifact": "12554235961"
    }
  ],
  "_buildurl": "https://github.com/r-universe/niaid/actions/runs/40077944259",
  "_commit": {
    "id": "aab21279fe8f96ab480cc27503716410ecca1310",
    "author": "MattPM <mattmule@gmail.com>",
    "committer": "MattPM <mattmule@gmail.com>",
    "message": "update comments for submission\n",
    "time": 1762086312
  },
  "_distro": "resolute",
  "_host": "GitHub-Actions",
  "_registered": true,
  "_dependencies": [
    {
      "package": "R",
      "version": ">= 2.10",
      "role": "Depends"
    },
    {
      "package": "magrittr",
      "role": "Imports"
    },
    {
      "package": "limma",
      "role": "Imports"
    },
    {
      "package": "mclust",
      "role": "Imports"
    },
    {
      "package": "stats",
      "role": "Imports"
    },
    {
      "package": "testthat",
      "role": "Suggests"
    },
    {
      "package": "knitr",
      "role": "Suggests"
    },
    {
      "package": "rmarkdown",
      "role": "Suggests"
    },
    {
      "package": "ggplot2",
      "role": "Suggests"
    },
    {
      "package": "cowplot",
      "role": "Suggests"
    },
    {
      "package": "spelling",
      "role": "Suggests"
    }
  ],
  "_owner": "niaid",
  "_selfowned": true,
  "_usedby": 0,
  "_updates": [
    {
      "week": "2025-44",
      "n": 4
    }
  ],
  "_tags": [
    {
      "name": "v2.0.1",
      "date": "2025-11-02"
    }
  ],
  "_topics": [
    "cite-seq",
    "niaid-tsang-lab"
  ],
  "_stars": 73,
  "_contributors": [
    {
      "user": "mattpm",
      "count": 194,
      "uuid": 15280712
    },
    {
      "user": "maxkarlsson",
      "count": 2,
      "uuid": 40792056
    },
    {
      "user": "diegoalexespi",
      "count": 1,
      "uuid": 13153411
    },
    {
      "user": "igordot",
      "count": 1,
      "uuid": 6363505
    },
    {
      "user": "mdmanurung",
      "count": 1,
      "uuid": 10704760
    }
  ],
  "_userbio": {
    "uuid": 8700816,
    "type": "organization",
    "name": "National Institute of Allergy and Infectious Diseases (NIAID)",
    "followers": 142
  },
  "_downloads": {
    "count": 604,
    "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/dsb"
  },
  "_devurl": "https://github.com/niaid/dsb",
  "_searchresults": 210,
  "_rbuild": "4.6.1",
  "_assets": [
    "extra/citation.cff",
    "extra/citation.html",
    "extra/citation.json",
    "extra/citation.txt",
    "extra/contents.json",
    "extra/dsb.html",
    "extra/manual.pdf",
    "extra/NEWS.html",
    "extra/NEWS.txt",
    "extra/readme.html",
    "extra/readme.md",
    "LICENSE"
  ],
  "_homeurl": "https://github.com/niaid/dsb",
  "_realowner": "niaid",
  "_cranurl": true,
  "_releases": [
    {
      "version": "0.1.0",
      "date": "2021-02-08"
    },
    {
      "version": "0.2.0",
      "date": "2021-09-03"
    },
    {
      "version": "0.3.0",
      "date": "2022-01-05"
    },
    {
      "version": "1.0.0",
      "date": "2022-03-14"
    },
    {
      "version": "1.0.1",
      "date": "2022-03-14"
    },
    {
      "version": "1.0.2",
      "date": "2022-05-27"
    },
    {
      "version": "1.0.3",
      "date": "2023-03-18"
    },
    {
      "version": "1.0.4",
      "date": "2024-06-16"
    },
    {
      "version": "2.0.0",
      "date": "2025-04-02"
    },
    {
      "version": "2.0.1",
      "date": "2025-11-02"
    }
  ],
  "_exports": [
    "%>%",
    "DSBNormalizeProtein",
    "ModelNegativeADTnorm"
  ],
  "_datasets": [
    {
      "name": "cells_citeseq_mtx",
      "title": "small example CITE-seq protein dataset for 87 surface protein in 2872 cells",
      "object": "raw_pbmc_mtx_example_87ab_citeseq_Tsang",
      "class": [
        "matrix",
        "array"
      ],
      "fields": [],
      "rows": 87,
      "table": true,
      "tojson": true
    },
    {
      "name": "empty_drop_citeseq_mtx",
      "title": "small example CITE-seq protein dataset for 87 surface protein in 8005 empty droplets",
      "object": "raw_emptydrop_mtx_example_87ab_citeseq_Tsang",
      "class": [
        "matrix",
        "array"
      ],
      "fields": [],
      "rows": 87,
      "table": true,
      "tojson": true
    }
  ],
  "_help": [
    {
      "page": "cells_citeseq_mtx",
      "title": "small example CITE-seq protein dataset for 87 surface protein in 2872 cells",
      "topics": [
        "cells_citeseq_mtx"
      ]
    },
    {
      "page": "DSBNormalizeProtein",
      "title": "DSBNormalizeProtein R function: Normalize single cell antibody derived tag (ADT) protein data. This function corrects for both protein specific and cell to cell technical noise in antibody derived tag (ADT) data. For datasets without access to empty drops use dsb::ModelNegativeADTnorm. See <https://www.nature.com/articles/s41467-022-29356-8> for details of the algorithm.",
      "topics": [
        "DSBNormalizeProtein"
      ]
    },
    {
      "page": "empty_drop_citeseq_mtx",
      "title": "small example CITE-seq protein dataset for 87 surface protein in 8005 empty droplets",
      "topics": [
        "empty_drop_citeseq_mtx"
      ]
    },
    {
      "page": "ModelNegativeADTnorm",
      "title": "ModelNegativeADTnorm R function: Normalize single cell antibody derived tag (ADT) protein data. This function defines the background level for each protein by fitting a 2 component Gaussian mixture after log transformation. Empty Droplet ADT counts are not supplied. The fitted background mean of each protein across all cells is subtracted from the log transformed counts. Note this is distinct from and unrelated to the 2 component mixture used in the second step of `DSBNormalizeProtein` which is fitted to all proteins of each cell. After this background correction step, `ModelNegativeADTnorm` then models and removes technical cell to cell variations using the same step II procedure as in the DSBNormalizeProtein function using identical function arguments. This is a experimental function that performs well in testing and is motivated by our observation in Supplementary Fig 1 in the dsb paper showing that the fitted background mean was concordant with the mean of ambient ADTs in both empty droplets and unstained control cells. We recommend using `ModelNegativeADTnorm` if empty droplets are not available. See <https://www.nature.com/articles/s41467-022-29356-8> for details of the algorithm.",
      "topics": [
        "ModelNegativeADTnorm"
      ]
    }
  ],
  "_readme": "https://github.com/niaid/dsb/raw/HEAD/README.md",
  "_rundeps": [
    "limma",
    "magrittr",
    "mclust",
    "statmod"
  ],
  "_vignettes": [
    {
      "source": "additional_topics.Rmd",
      "filename": "additional_topics.html",
      "title": "Additional Topics - qualtile.clipping - scale.factor - Python and Bioc - multiplexing - multi batch - FAQ",
      "author": "Matt Mulè",
      "engine": "knitr::rmarkdown",
      "headings": [
        "Integrating dsb with Bioconductor ",
        "Using dsb in Python ",
        "Using dsb with data lacking isotype controls ",
        "Using dsb with sample multiplexing experiments ",
        "Advanced usage - return internal stats used by dsb ",
        "outlier clipping with the quantile.clipping argument  ",
        "Using a different background scaling method ",
        "Frequently Asked Questions ",
        "check for outliers in dsb normalized values"
      ],
      "created": "2022-03-02 15:05:09",
      "modified": "2023-03-10 19:32:52",
      "commits": 6
    },
    {
      "source": "end_to_end_workflow.rmd",
      "filename": "end_to_end_workflow.html",
      "title": "End-to-end CITE-seq analysis workflow using dsb for ADT normalization and Seurat for multimodal clustering",
      "author": "Matt Mulè",
      "engine": "knitr::rmarkdown",
      "headings": [
        "Table of Contents",
        "Background and motivation ",
        "Installation and quick overview ",
        "Download public 10X Genomics data ",
        "Step 1 A note on alignment of ADTs ",
        "Step 2 Load RNA and ADT data and define droplet quality control metadata ",
        "Step 3 Quality control cells and background droplets ",
        "Optional step; remove proteins without staining",
        "Step 4 Normalize protein data with the DSBNormalizeProtein Function ",
        "Integrating dsb with Seurat ",
        "Clustering cells based on dsb normalized protein using Seurat  ",
        "dsb derived cluster interpretation ",
        "Weighted Nearest Neighbor multimodal clustering using dsb normalized values with Seurat ",
        "Method 1 -- Seurat WNN default with PCA on dsb normalized protein",
        "Method 2-- Seurat WNN with dsb normalized protein directly without PCA",
        "Some recent publications using dsb ",
        "using other alignment algorithms ",
        "A note on Cell Ranger --expect-cells "
      ],
      "created": "2022-03-14 10:18:23",
      "modified": "2024-06-15 22:52:18",
      "commits": 8
    },
    {
      "source": "fastkm.Rmd",
      "filename": "fastkm.html",
      "title": "Fast normalization for large datasets with or without empty drops",
      "engine": "knitr::rmarkdown",
      "headings": [],
      "created": "2025-04-01 19:46:20",
      "modified": "2025-04-01 19:46:20",
      "commits": 1
    },
    {
      "source": "no_empty_drops.Rmd",
      "filename": "no_empty_drops.html",
      "title": "Normalizing ADTs for datasets without empty droplets with the dsb function ModelNegativeADTnorm",
      "author": "Matt Mulè",
      "engine": "knitr::rmarkdown",
      "headings": [],
      "created": "2022-03-11 17:49:44",
      "modified": "2025-04-02 20:11:35",
      "commits": 7
    },
    {
      "source": "understanding_dsb.Rmd",
      "filename": "understanding_dsb.html",
      "title": "Understanding how the dsb method works",
      "author": "Matt Mulè",
      "engine": "knitr::rmarkdown",
      "headings": [
        "Load example package data",
        "log transform",
        "dsb step 1 removal of ambient noise",
        "dsb step II Part I fitting single cell models to extract background",
        "dsb Part II step II",
        "How can I interpret the dsb values?"
      ],
      "created": "2022-03-02 15:05:09",
      "modified": "2025-11-02 03:57:43",
      "commits": 5
    }
  ],
  "_score": 8.185542154854376,
  "_indexed": true,
  "_nocasepkg": "dsb",
  "_universes": [
    "niaid",
    "mattpm"
  ],
  "_binaries": [
    {
      "r": "4.7.0",
      "os": "linux",
      "version": "2.0.1",
      "date": "2026-10-24T08:30:40.000Z",
      "distro": "resolute",
      "commit": "aab21279fe8f96ab480cc27503716410ecca1310",
      "fileid": "https://r2.ropensci.org/f7f11a618c1d856f314be5a93be4d1d9ec6162d79b8743ae0260a83487e228be",
      "status": "success",
      "check": "OK",
      "buildurl": "https://github.com/r-universe/niaid/actions/runs/40077944259"
    },
    {
      "r": "4.6.1",
      "os": "linux",
      "version": "2.0.1",
      "date": "2026-10-24T08:30:51.000Z",
      "distro": "resolute",
      "commit": "aab21279fe8f96ab480cc27503716410ecca1310",
      "fileid": "https://r2.ropensci.org/3f51e937e9fb6b14d7936f0d2f2a58f17cd2a1b150e9d671dc3910d1ac19e6e8",
      "status": "success",
      "check": "OK",
      "buildurl": "https://github.com/r-universe/niaid/actions/runs/40077944259"
    },
    {
      "r": "4.5.3",
      "os": "mac",
      "version": "2.0.1",
      "date": "2026-10-24T08:30:52.000Z",
      "commit": "aab21279fe8f96ab480cc27503716410ecca1310",
      "fileid": "https://r2.ropensci.org/39841b2bd9f4c2a7c9465acb422b6188bea89cf96891b6b3acc7e16c16bb586f",
      "status": "success",
      "check": "OK",
      "buildurl": "https://github.com/r-universe/niaid/actions/runs/40077944259"
    },
    {
      "r": "4.6.1",
      "os": "mac",
      "version": "2.0.1",
      "date": "2026-10-24T08:30:48.000Z",
      "commit": "aab21279fe8f96ab480cc27503716410ecca1310",
      "fileid": "https://r2.ropensci.org/2787e13f914900eb85f06db865bc94eebb39f19f818ec6d7be10991f0362f291",
      "status": "success",
      "check": "OK",
      "buildurl": "https://github.com/r-universe/niaid/actions/runs/40077944259"
    },
    {
      "r": "4.6.0",
      "os": "wasm",
      "version": "2.0.1",
      "date": "2026-10-24T08:30:46.000Z",
      "commit": "aab21279fe8f96ab480cc27503716410ecca1310",
      "fileid": "https://r2.ropensci.org/20d144917af0631bb39b79680142334c02e3c5fb7578b2e8509d14232895e711",
      "status": "success",
      "buildurl": "https://github.com/r-universe/niaid/actions/runs/40077944259"
    },
    {
      "r": "4.7.0",
      "os": "win",
      "version": "2.0.1",
      "date": "2026-10-24T08:30:05.000Z",
      "commit": "aab21279fe8f96ab480cc27503716410ecca1310",
      "fileid": "https://r2.ropensci.org/7c784ee5858eb432ff11fffba6743ff51b8e759e1193d825feee517e1abbe0af",
      "status": "success",
      "check": "OK",
      "buildurl": "https://github.com/r-universe/niaid/actions/runs/40077944259"
    },
    {
      "r": "4.5.3",
      "os": "win",
      "version": "2.0.1",
      "date": "2026-10-24T08:30:00.000Z",
      "commit": "aab21279fe8f96ab480cc27503716410ecca1310",
      "fileid": "https://r2.ropensci.org/518ec9ef8f0e948966cdd781a173bbcc6b37b5c1191353a6a911020b6c6a7e06",
      "status": "success",
      "check": "OK",
      "buildurl": "https://github.com/r-universe/niaid/actions/runs/40077944259"
    },
    {
      "r": "4.6.1",
      "os": "win",
      "version": "2.0.1",
      "date": "2026-10-24T08:29:57.000Z",
      "commit": "aab21279fe8f96ab480cc27503716410ecca1310",
      "fileid": "https://r2.ropensci.org/ba3a1888cdfadcd596527c337e12c144a6be954e5836874ecec2fdfb8b62b7d5",
      "status": "success",
      "check": "OK",
      "buildurl": "https://github.com/r-universe/niaid/actions/runs/40077944259"
    }
  ]
}