Protocol to track single-cell-derived clones using DNA barcoding combined with single-cell RNA sequencing Authors: Hee Jin Shin, Sahil Sharma, Sarah Kronheim, May Cheung, Long V. Nguyen Published: 2025 ABSTRACT SummaryClonal fitness and plasticity drive tumor heterogeneity contributing to disease progression and treatment resistance. Here, we provide a protocol to track the clonal outputs from uniquely marked cells. We describe steps for constructing and validating lentiviral DNA barcode libraries. We then detail procedures for single-cell RNA sequencing. This approach links clonal growth activity with transcriptomic profiles and enables permanent cellular labeling to track clonal dynamics in various model systems, which can provide insight into molecular processes underlying clone function.For complete details on the use and execution of this protocol, please refer to Nguyen et al.1 Before you begin Tumors consist of heterogenous cell populations where certain cellular clones, due to their high proliferative activity, contribute disproportionately to tumor growth.2,3,4,5 The identification and molecular characterization of these clones is crucial to devise new approaches to target these populations specifically. Single-cell RNA sequencing (scRNAseq) has enabled the study of tumor transcriptional landscapes at single cell resolution; however, it does not inherently allow tracking of clonal dynamics over time. Combining DNA barcoding with scRNAseq simultaneously enables the tracking of clonal growth within tumors and the association of these clones with their single cell transcriptomic profiles. The protocol below describes how to construct, validate and apply a lentiviral-based DNA barcode library to track the clonal outputs from single and uniquely marked cells and to associate these with their single cell transcriptomic profiles obtained from scRNAseq. Innovation Clone size quantification and comparison between samples and sequencing batches can be an inherent challenge of using sequencing-based readout for clonal analysis. Our approach allows for the quantification of clone size in absolute cell number. Use of spike-in controls allows for normalization of clone size based on sequence read count between multiplexed samples and even between different sequencing runs. Furthermore, these spike-in controls allow for the sensitivity and specificity of clone detection to be calculated to enable more accurate interpretation of clonal tracking analyses. While preserving the quantitative aspects of this approach, clonal growth activity can be associated with single cell transcriptomic profiles to provide molecular insight into clone function. This protocol can be applied to a wide range of studies from clonal dynamics in tumors to lineage tracking of stem and progenitor cells in normal tissues. We have recently published a study that used this protocol to characterize the heterogeneity of clonal fitness and transcriptional plasticity of human breast cancer single-cell-derived clones in patient-derived tumor xenograft models.1 Key resources table REAGENT or RESOURCESOURCEIDENTIFIERBacterial and virus strainspLARRY-EGFP plasmidRodriguez-Fraticelli et al.6 and Weinreb et al.7RRID: Addgene_140025psPAX2 plasmidDidier Trono labRRID:Addgene_12260pMD2.G plasmidDidier Trono labRRID:Addgene_12259ElectroMAX DH10B cellsInvitrogen Life TechnologiesCat # 18290-015Chemicals, peptides, and recombinant proteinsLipofectamine 3000 reagentInvitrogenCat # L3000001Q5 high-fidelity DNA polymeraseNew England BiolabsCat # M0491SLenti-X concentratorTakara BioCat # 631232Glycogen, RNA gradeThermo ScientificCat # R05513 M sodium acetate solution, pH 5.2Thermo ScientificCat # R1181EthanolCommercial AlcoholsCat # P016EAANCritical commercial assaysQIAEX II gel extraction kitQIAGENCat # 20021PicoPure DNA extraction kitApplied BiosystemsCat # KIT0103prepGEM Universal DNA extraction KitForenteQ LimitedCat # PUN0500IDT for Illumina UD indexesIlluminaCat # 20091654KAPA library quantification kitRocheCat # 07960140001/KK4824QIAGEN plasmid mini kitQIAGENCat # 12123Qubit 1X dsDNA high sensitivity (HS) assay kitsInvitrogenCat # Q33230Deposited dataBulk RNA sequencing raw count matriceshttps://doi.org/10.5281/zenodo.10978989RawCounts.csvBulk RNA sequencing normalized count matriceshttps://doi.org/10.5281/zenodo.10978989LogCPMNormCounts.csvscRNAseq MetaCell processed count matrixhttps://doi.org/10.5281/zenodo.10978989mat.pdx_LN_v2_filt.RdascRNAseq MetaCell partitionshttps://doi.org/10.5281/zenodo.10978989mc.pdx_LN_v2_filt.Rdamc2d.pdx_LN_v2_filt.RdascRNAseq Seurat processed count matrices for 4 patient-derived tumor xenograft modelshttps://doi.org/10.5281/zenodo.10978989STG139.rdsSTG201.rdsAB040.rdsIC07.rdsExperimental models: cell linesHEK293T cellsATCCCRL-11268MDA-MB-231 cellsATCCHTB-26OligonucleotidesBarcode sequence FWD:5′phos – TCGACAGACTGNNATCNNGATSSAAANNGGTNNAACNNTGTAAAACGACGGCCAGTGAGT – 3′Integrated DNA TechnologiesN/ABarcode sequence REV:5′phos-CTAGACTCACTGGCCGTCGTTTTACANNGTTNNACCNNTTTSSATCNNGATNNCAGTCTG-3′Integrated DNA TechnologiesN/AStaggered Primers with vector specific sequences in boldPair 1 FWD primer: 5′-TCGTCGGCAGCGTCAGATGTGTATAAGAGACAGTAGAAGGCACAGGTCGACAG-3′Integrated DNA TechnologiesN/APair 1 REV primer: 5′-GTCTCGTGGGCTCGGAGATGTGTATAAGAGACAGGTCTAGACTCACTGGCCGTC-3′Integrated DNA TechnologiesN/APair 2 FWD primer: 5′-TCGTCGGCAGCGTCAGATGTGTATAAGAGACAGGCAACTAGAAGGCACAGGTC-3′Integrated DNA TechnologiesN/APair 2 REV primer: 5′-GTCTCGTGGGCTCGGAGATGTGTATAAGAGACAGGACTCACTGGCCGTCGTTTT-3′Integrated DNA TechnologiesN/APair 3 FWD primer: 5′-TCGTCGGCAGCGTCAGATGTGTATAAGAGACAGCAACTAGAAGGCACAGGTCG-3′Integrated DNA TechnologiesN/APair 3 REV primer: 5′-GTCTCGTGGGCTCGGAGATGTGTATAAGAGACAGAGACTCACTGGCCGTCGTTT-3′Integrated DNA TechnologiesN/AForward primer for Sanger sequencing: 5′-ATGACACCTACTCAGACAATGC-3′Integrated DNA TechnologiesN/ASoftware and algorithmsMetaCell version 0.3.7Baran et al.8https://tanaylab.github.io/metacell/Seurat version 5.1.0Satija et al.9https://satijalab.org/seurat/Custom codeThis protocolhttps://github.com/lvnguyen-lab/Barcode-protocolRStudio version 2023.12.0+369Posit Software, PBChttps://posit.co/download/rstudio-desktop/FastQC version 0.11.9Andrews10N/ACutadapt version 1.10Martin11N/A10x Genomics Cell Ranger version 7.0.1Zheng et al.12https://www.10xgenomics.com/Clustree version 0.5.1Zappia and Oshlack13https://github.com/lazappi/clustreescDblFinder version 1.18.0Germain et al.14https://github.com/plger/scDblFinderdittoSeq version 1.16.0Bunis et al.15https://github.com/dtm2451/dittoSeqOtherNunc square bioassay dishesThermo Fisher ScientificCat # 240835LB agarWISENT INCCat # 800-011-LG10X TBE bufferWISENT INCCat # 880-545-CLAgarose D1-LEWISENT INCCat # 800-015-EGXbaI digestion enzymeNew England BiolabsCat # R0145TSalI-HF digestion enzymeNew England BiolabsCat # R3138S10X rCutSmart digestion bufferNew England BiolabsCat # B6004ST4 DNA ligase with reaction bufferNew England BiolabsCat # M0202SElectroLigaseNew England BiolabsCat # M0369GlycerolBioShop CanadaCAS # 56-81-5Dulbecco’s modified Eagle’s medium 1X (DMEM)WISENT INCCat # 319-005-CLFetal bovine serum (FBS)GibcoCat # 1248302010X TBE buffer, liquidWISENT INCCat # 880-545 CLNuclease free waterVWRCat # SH30538.02Ampicillin solution 0.1 g/mLWISENT INCCat # 450-110 XLGlycerol for bacterial stockMilliporeSigmaCat # G2025 REAGENT or RESOURCESOURCEIDENTIFIERBacterial and virus strainspLARRY-EGFP plasmidRodriguez-Fraticelli et al.6 and Weinreb et al.7RRID: Addgene_140025psPAX2 plasmidDidier Trono labRRID:Addgene_12260pMD2.G plasmidDidier Trono labRRID:Addgene_12259ElectroMAX DH10B cellsInvitrogen Life TechnologiesCat # 18290-015Chemicals, peptides, and recombinant proteinsLipofectamine 3000 reagentInvitrogenCat # L3000001Q5 high-fidelity DNA polymeraseNew England BiolabsCat # M0491SLenti-X concentratorTakara BioCat # 631232Glycogen, RNA gradeThermo ScientificCat # R05513 M sodium acetate solution, pH 5.2Thermo ScientificCat # R1181EthanolCommercial AlcoholsCat # P016EAANCritical commercial assaysQIAEX II gel extraction kitQIAGENCat # 20021PicoPure DNA extraction kitApplied BiosystemsCat # KIT0103prepGEM Universal DNA extraction KitForenteQ LimitedCat # PUN0500IDT for Illumina UD indexesIlluminaCat # 20091654KAPA library quantification kitRocheCat # 07960140001/KK4824QIAGEN plasmid mini kitQIAGENCat # 12123Qubit 1X dsDNA high sensitivity (HS) assay kitsInvitrogenCat # Q33230Deposited dataBulk RNA sequencing raw count matriceshttps://doi.org/10.5281/zenodo.10978989RawCounts.csvBulk RNA sequencing normalized count matriceshttps://doi.org/10.5281/zenodo.10978989LogCPMNormCounts.csvscRNAseq MetaCell processed count matrixhttps://doi.org/10.5281/zenodo.10978989mat.pdx_LN_v2_filt.RdascRNAseq MetaCell partitionshttps://doi.org/10.5281/zenodo.10978989mc.pdx_LN_v2_filt.Rdamc2d.pdx_LN_v2_filt.RdascRNAseq Seurat processed count matrices for 4 patient-derived tumor xenograft modelshttps://doi.org/10.5281/zenodo.10978989STG139.rdsSTG201.rdsAB040.rdsIC07.rdsExperimental models: cell linesHEK293T cellsATCCCRL-11268MDA-MB-231 cellsATCCHTB-26OligonucleotidesBarcode sequence FWD:5′phos – TCGACAGACTGNNATCNNGATSSAAANNGGTNNAACNNTGTAAAACGACGGCCAGTGAGT – 3′Integrated DNA TechnologiesN/ABarcode sequence REV:5′phos-CTAGACTCACTGGCCGTCGTTTTACANNGTTNNACCNNTTTSSATCNNGATNNCAGTCTG-3′Integrated DNA TechnologiesN/AStaggered Primers with vector specific sequences in boldPair 1 FWD primer: 5′-TCGTCGGCAGCGTCAGATGTGTATAAGAGACAGTAGAAGGCACAGGTCGACAG-3′Integrated DNA TechnologiesN/APair 1 REV primer: 5′-GTCTCGTGGGCTCGGAGATGTGTATAAGAGACAGGTCTAGACTCACTGGCCGTC-3′Integrated DNA TechnologiesN/APair 2 FWD primer: 5′-TCGTCGGCAGCGTCAGATGTGTATAAGAGACAGGCAACTAGAAGGCACAGGTC-3′Integrated DNA TechnologiesN/APair 2 REV primer: 5′-GTCTCGTGGGCTCGGAGATGTGTATAAGAGACAGGACTCACTGGCCGTCGTTTT-3′Integrated DNA TechnologiesN/APair 3 FWD primer: 5′-TCGTCGGCAGCGTCAGATGTGTATAAGAGACAGCAACTAGAAGGCACAGGTCG-3′Integrated DNA TechnologiesN/APair 3 REV primer: 5′-GTCTCGTGGGCTCGGAGATGTGTATAAGAGACAGAGACTCACTGGCCGTCGTTT-3′Integrated DNA TechnologiesN/AForward primer for Sanger sequencing: 5′-ATGACACCTACTCAGACAATGC-3′Integrated DNA TechnologiesN/ASoftware and algorithmsMetaCell version 0.3.7Baran et al.8https://tanaylab.github.io/metacell/Seurat version 5.1.0Satija et al.9https://satijalab.org/seurat/Custom codeThis protocolhttps://github.com/lvnguyen-lab/Barcode-protocolRStudio version 2023.12.0+369Posit Software, PBChttps://posit.co/download/rstudio-desktop/FastQC version 0.11.9Andrews10N/ACutadapt version 1.10Martin11N/A10x Genomics Cell Ranger version 7.0.1Zheng et al.12https://www.10xgenomics.com/Clustree version 0.5.1Zappia and Oshlack13https://github.com/lazappi/clustreescDblFinder version 1.18.0Germain et al.14https://github.com/plger/scDblFinderdittoSeq version 1.16.0Bunis et al.15https://github.com/dtm2451/dittoSeqOtherNunc square bioassay dishesThermo Fisher ScientificCat # 240835LB agarWISENT INCCat # 800-011-LG10X TBE bufferWISENT INCCat # 880-545-CLAgarose D1-LEWISENT INCCat # 800-015-EGXbaI digestion enzymeNew England BiolabsCat # R0145TSalI-HF digestion enzymeNew England BiolabsCat # R3138S10X rCutSmart digestion bufferNew England BiolabsCat # B6004ST4 DNA ligase with reaction bufferNew England BiolabsCat # M0202SElectroLigaseNew England BiolabsCat # M0369GlycerolBioShop CanadaCAS # 56-81-5Dulbecco’s modified Eagle’s medium 1X (DMEM)WISENT INCCat # 319-005-CLFetal bovine serum (FBS)GibcoCat # 1248302010X TBE buffer, liquidWISENT INCCat # 880-545 CLNuclease free waterVWRCat # SH30538.02Ampicillin solution 0.1 g/mLWISENT INCCat # 450-110 XLGlycerol for bacterial stockMilliporeSigmaCat # G2025 Materials and equipment Cell culture medium: Supplemented DMEMReagentFinal concentrationAmountDulbecco’s Modified Eagle Medium (DMEM)N/A450 mLFetal bovine serum (FBS)10%50 mLTotalN/A500 mL Note: Storage conditions: 4°C, up to 4 weeks. Cell culture medium: Supplemented DMEMReagentFinal concentrationAmountDulbecco’s Modified Eagle Medium (DMEM)N/A450 mLFetal bovine serum (FBS)10%50 mLTotalN/A500 mL Cell culture medium: Supplemented DMEM Note: Storage conditions: 4°C, up to 4 weeks. Step-by-step method details Constructing the DNA barcode library and validating barcode diversity Timing: 6–7 days Timing: 6–7 days This major step describes a step-by-step protocol for preparing and ligating DNA barcode oligonucleotides into a lentiviral vector pLARRY-EGFP to generate a plasmid DNA barcode library.1.Prepare DNA oligonucleotides (Integrated DNA Technologies) for ligation into the lentiviral plasmid.Note: This 27 bp semi-random DNA barcode was adapted from a previous design16 to which a 4 bp unique library ID sequence was added (Figure 1). Additional libraries can be created by modifying the 4 bp library ID. This unique library ID allows for multiple libraries to be generated, and when used together, can be sequenced simultaneously and then computationally resolved.CRITICAL: The forward and reverse oligonucleotides should be dual PAGE and HPLC purified with a 5′ phosphorylation modification.a.Anneal the forward and reverse oligonucleotides by first dissolving the oligonucleotides in nuclease-free water to a concentration of 200 μM. Mix 25 μL of each oligonucleotide separately with 25 μL of 1X T4 DNA ligase buffer (1:1 mix; final concentration of T4 DNA ligase buffer should be 0.5X).b.Combine 50 μL of forward and reverse oligonucleotide mix (100 μL in total).c.In a PCR thermocycler, heat the oligonucleotide mixture to 95°C for 5 min, and cool gradually at a rate of 0.5°C per min to reach 10°C.d.Run the annealed oligonucleotides on a 4% agarose-TBE gel (120 V constant).Note: Unannealed oligonucleotides should be run as control to accurately predict the size of annealed oligonucleotides (60 bp). Leave a gap between samples if more than one library is being prepared to avoid cross-contamination.e.Perform gel extraction as per manufacturer’s instructions using the QIAEX II Gel extraction kit (Qiagen) and elute the annealed oligonucleotides into 100 μL nuclease-free water.f.Perform ethanol precipitation of the DNA by adding the following reagents to the 100 μL eluate in the order as indicated in Table 1, then:i.Vortex 3 sec to mix and freeze at −80°C for 16–24 h to precipitate the DNA.Pause point: The reaction can be stored at −80°C for longer, but it is recommended to proceed with the next steps after incubation for 16–24 hrs.ii.The next day, centrifuge at maximum speed (∼18,000 x g) at 4°C for 30 min to obtain a white pellet of the precipitated DNA.iii.Carefully discard the supernatant without disturbing the DNA pellet.iv.Add 1 mL of 70% cold ethanol to wash the pellet.v.Centrifuge again at maximum speed (∼18,000 x g) at 4°C for 10 min.vi.Carefully remove the supernatant completely and let the pellet dry to room air for 5–15 min.Note: Circle around the pellet with a marker pen as the pellet may become invisible when dry.vii.Resuspend the pellet in 20 μL nuclease-free water and store at −20°C.viii.Quantify the DNA using a Qubit fluorometer (Thermo Fisher Scientific) and the Qubit 1X dsDNA high sensitivity assay kit.Note: This step yields approximately 10–15 μg of total DNA.Pause point: The annealed oligonucleotides can be stored at −20°C until ready to proceed.Table 1DNA ethanol precipitationReagentVolumeRemarksGlycogen (5 mg/mL)1 uL50 μg/mL (final)3M Sodium acetate (pH 5.2)10 uL1/10 volumeEthanol (100%)300 uL3 volumesFigure 1Semi-random barcode designSchematic of semi-random barcode oligonucleotide design with restriction sites used for insertion and a barcode ID tag.2.Prepare the pLARRY-EGFP vector (Addgene) for ligation with annealed barcode oligonucleotides as follows:a.Double-digest the pLARRY-EGFP vector using SalI and XbaI restriction endonuclease sites in the 3′ UTR of EGFP as indicated in Table 2.Table 2Restriction digestion reactionReagentAmountVector (pLARRY-EGFP)1 ug10X rCutSmart buffer5 uLSalI1 uLXbaI1 uLWater (nuclease-free)Up to 50 uLb.Incubate the reaction at 37°C for 20 min followed by heat inactivation of enzymes at 65°C for 20 min.Note: Only use 1 μg of plasmid DNA per reaction to achieve complete digestion. Additional reactions can be included and subsequently pooled together to increase the final yield of the digested vector as needed.c.Run the double-digested vector and the following controls on a 0.7% agarose-TBE gel (120 V constant):i.Undigested pLARRY-EGFP plasmid.ii.pLARRY-EGFP plasmid digested with either SalI or XbaI (single cut linearized).d.Perform gel extraction of the double-digested vector using QIAEX II Gel Extraction Kit and elute the DNA into 100 μL nuclease-free water.e.Perform ethanol precipitation of the DNA as described in step 1f in constructing the DNA barcode library and validating barcode diversity.f.Resuspend the double-digested vector in 20 μL of nuclease-free water and quantify the concentration of DNA using a Qubit fluorometer (Thermo Fisher Scientific) and the Qubit 1X dsDNA high sensitivity assay kit.Note: This step should yield approximately 0.2–0.5 μg of total DNA per reaction.Pause point: The double digested vector can be stored at −20°C until ready to proceed.3.Ligate annealed barcode oligonucleotides into 3′ UTR of EGFP in the pLARRY-EGFP vector.a.Prior to ligation, check the purity of the annealed oligonucleotides and the double-digested vector by running the Agilent Bioanalyzer.b.Mix the annealed barcode oligonucleotides with double-digested pLARRY-EGFP vector in a 3:1 molar ratio (10 ng of double-digested vector with 3X molar ratio of annealed oligonucleotides) to a final reaction volume of 10 μL.c.Perform ligation with T4 DNA ligase (New England Biolabs) as indicated in Table 3, then:i.Gently mix by pipetting, spin down and incubate at 16°C for 16–24 hrs.CRITICAL: Do not pause here. After incubation, proceed to the next step.ii.Heat inactivate at 65°C for 10 min and chill on ice.iii.For the ligation step, include a negative control containing the double digested vector without annealed oligonucleotides.Note: The negative control tests the frequency of single digested vector present that can re-circularize even without annealed oligonucleotides.Table 3Ligation reactionReagentAmountAnnealed oligonucleotides: double-digested vector (3:1)10 uL10X T4 DNA ligase buffer2 uLT4 DNA ligase1 uLWaterUp to 20 uL4.Transform the ligated product and negative control into ElectroMAX DH10B electrocompetent cells (Invitrogen) as per manufacturer’s instructions.a.For each transformation reaction, add 1 μl of ligated product per 20 μL of electrocompetent cells and perform electroporation. Prepare control conditions as below:i.Positive control: undigested pLARRY-EGFP plasmid.ii.Negative control: double digested pLARRY-EGFP plasmid with no insert.CRITICAL: Do not discard remaining ligated product as it will be used for additional transformations in following steps.b.Add 1 mL of SOC media to each transformation reaction and incubate at 37°C for 1 h.c.Immediately following incubation for 1 h, plate different volumes of transformed cells (i.e., 50 μL, 100 μL, 150 μL and 200 μL) onto 100 mm LB-agar plates containing 100 μM ampicillin and incubate at 37°C for 20 h.CRITICAL: Do not discard remaining transformed cells (store at 4°C) as they will be pooled with additional transformations for plating on 245 mm × 245 mm square LB-agar plates.d.20 h after plating, examine plate density and proportionally calculate volume for plating on 245 mm × 245 mm square LB-agar plates containing 100 μM ampicillin using the volume that resulted in dense, single colonies on the 100 mm plates.e.Perform 19 additional transformations with the remaining 19 μL of the ligated product to maximize the barcode library diversity.f.Pool all transformation reactions together and plate on an appropriate number of 245 mm × 245 mm square LB-agar plates containing 100 μM ampicillin based on the plating volume determined in steps 4c and 4d in constructing the DNA barcode library and validating barcode diversity. Incubate the plates at 37°C for 20 h.Note: Increasing the number of plates used, and thus the number of bacterial colonies formed will increase the diversity of the barcode library.g.After 20 h incubation, count colonies on a representative section of the square plates to approximate the potential diversity of the barcode library. To prepare a homogenous bacterial mixture and to prepare glycerol stocks:i.Use 100–800 μL of LB broth containing 100 μM ampicillin for each 245 mm × 245 mm square LB-agar plate to facilitate scraping and combining of the colonies.ii.Measure the final volume of the resulting bacterial mixture. Add 1:1 volume of 50% glycerol to the bacterial mixture to prepare glycerol stocks. Gently mix thoroughly, aliquot the glycerol stock into 1 mL cryovials, and store at −80°C.iii.Extract plasmid DNA from each glycerol stock using the QIAGEN Plasmid Mini Kit (Qiagen) according to the manufacturer’s instructions.5.Prepare the plasmid DNA library for DNA amplicon sequencing as described in steps 8–15 in multiplexed barcode DNA amplicon sequencing. Sequence plasmid libraries to a depth of at least 10X the anticipated diversity (e.g., 10 million reads per library for an expected diversity of 1 million unique barcodes).6.Package lentiviruses with HEK293T cells and the barcode library plasmid DNA using the Lipofectamine 3000 kit (Invitrogen) as per manufacturer’s instructions.a.Concentrate lentiviral supernatant with Lenti-X concentrator (Takara Bio).b.Test and calculate lentiviral titer using an appropriate cell line.CRITICAL: It is important to optimize lentiviral transduction conditions to achieve a MOI of less than 0.3 to minimize the likelihood for multiple barcode integrations.7.Validate the diversity of the barcode library by transducing an appropriate cell line (we used MDA-MB-231 cells, a human breast cancer cell line).a.In triplicate, transduce 105 to 106 MDA-MB-231 cells with the lentivirus to target a MOI of less than 0.3.b.Culture the cells for 24 h after transduction and harvest for DNA amplicon sequencing as described in steps 8–15 in multiplexed barcode DNA amplicon sequencing. 1.Prepare DNA oligonucleotides (Integrated DNA Technologies) for ligation into the lentiviral plasmid.Note: This 27 bp semi-random DNA barcode was adapted from a previous design16 to which a 4 bp unique library ID sequence was added (Figure 1). Additional libraries can be created by modifying the 4 bp library ID. This unique library ID allows for multiple libraries to be generated, and when used together, can be sequenced simultaneously and then computationally resolved.CRITICAL: The forward and reverse oligonucleotides should be dual PAGE and HPLC purified with a 5′ phosphorylation modification.a.Anneal the forward and reverse oligonucleotides by first dissolving the oligonucleotides in nuclease-free water to a concentration of 200 μM. Mix 25 μL of each oligonucleotide separately with 25 μL of 1X T4 DNA ligase buffer (1:1 mix; final concentration of T4 DNA ligase buffer should be 0.5X).b.Combine 50 μL of forward and reverse oligonucleotide mix (100 μL in total).c.In a PCR thermocycler, heat the oligonucleotide mixture to 95°C for 5 min, and cool gradually at a rate of 0.5°C per min to reach 10°C.d.Run the annealed oligonucleotides on a 4% agarose-TBE gel (120 V constant).Note: Unannealed oligonucleotides should be run as control to accurately predict the size of annealed oligonucleotides (60 bp). Leave a gap between samples if more than one library is being prepared to avoid cross-contamination.e.Perform gel extraction as per manufacturer’s instructions using the QIAEX II Gel extraction kit (Qiagen) and elute the annealed oligonucleotides into 100 μL nuclease-free water.f.Perform ethanol precipitation of the DNA by adding the following reagents to the 100 μL eluate in the order as indicated in Table 1, then:i.Vortex 3 sec to mix and freeze at −80°C for 16–24 h to precipitate the DNA.Pause point: The reaction can be stored at −80°C for longer, but it is recommended to proceed with the next steps after incubation for 16–24 hrs.ii.The next day, centrifuge at maximum speed (∼18,000 x g) at 4°C for 30 min to obtain a white pellet of the precipitated DNA.iii.Carefully discard the supernatant without disturbing the DNA pellet.iv.Add 1 mL of 70% cold ethanol to wash the pellet.v.Centrifuge again at maximum speed (∼18,000 x g) at 4°C for 10 min.vi.Carefully remove the supernatant completely and let the pellet dry to room air for 5–15 min.Note: Circle around the pellet with a marker pen as the pellet may become invisible when dry.vii.Resuspend the pellet in 20 μL nuclease-free water and store at −20°C.viii.Quantify the DNA using a Qubit fluorometer (Thermo Fisher Scientific) and the Qubit 1X dsDNA high sensitivity assay kit.Note: This step yields approximately 10–15 μg of total DNA.Pause point: The annealed oligonucleotides can be stored at −20°C until ready to proceed.Table 1DNA ethanol precipitationReagentVolumeRemarksGlycogen (5 mg/mL)1 uL50 μg/mL (final)3M Sodium acetate (pH 5.2)10 uL1/10 volumeEthanol (100%)300 uL3 volumesFigure 1Semi-random barcode designSchematic of semi-random barcode oligonucleotide design with restriction sites used for insertion and a barcode ID tag. Prepare DNA oligonucleotides (Integrated DNA Technologies) for ligation into the lentiviral plasmid.Note: This 27 bp semi-random DNA barcode was adapted from a previous design16 to which a 4 bp unique library ID sequence was added (Figure 1). Additional libraries can be created by modifying the 4 bp library ID. This unique library ID allows for multiple libraries to be generated, and when used together, can be sequenced simultaneously and then computationally resolved.CRITICAL: The forward and reverse oligonucleotides should be dual PAGE and HPLC purified with a 5′ phosphorylation modification.a.Anneal the forward and reverse oligonucleotides by first dissolving the oligonucleotides in nuclease-free water to a concentration of 200 μM. Mix 25 μL of each oligonucleotide separately with 25 μL of 1X T4 DNA ligase buffer (1:1 mix; final concentration of T4 DNA ligase buffer should be 0.5X).b.Combine 50 μL of forward and reverse oligonucleotide mix (100 μL in total).c.In a PCR thermocycler, heat the oligonucleotide mixture to 95°C for 5 min, and cool gradually at a rate of 0.5°C per min to reach 10°C.d.Run the annealed oligonucleotides on a 4% agarose-TBE gel (120 V constant).Note: Unannealed oligonucleotides should be run as control to accurately predict the size of annealed oligonucleotides (60 bp). Leave a gap between samples if more than one library is being prepared to avoid cross-contamination.e.Perform gel extraction as per manufacturer’s instructions using the QIAEX II Gel extraction kit (Qiagen) and elute the annealed oligonucleotides into 100 μL nuclease-free water.f.Perform ethanol precipitation of the DNA by adding the following reagents to the 100 μL eluate in the order as indicated in Table 1, then:i.Vortex 3 sec to mix and freeze at −80°C for 16–24 h to precipitate the DNA.Pause point: The reaction can be stored at −80°C for longer, but it is recommended to proceed with the next steps after incubation for 16–24 hrs.ii.The next day, centrifuge at maximum speed (∼18,000 x g) at 4°C for 30 min to obtain a white pellet of the precipitated DNA.iii.Carefully discard the supernatant without disturbing the DNA pellet.iv.Add 1 mL of 70% cold ethanol to wash the pellet.v.Centrifuge again at maximum speed (∼18,000 x g) at 4°C for 10 min.vi.Carefully remove the supernatant completely and let the pellet dry to room air for 5–15 min.Note: Circle around the pellet with a marker pen as the pellet may become invisible when dry.vii.Resuspend the pellet in 20 μL nuclease-free water and store at −20°C.viii.Quantify the DNA using a Qubit fluorometer (Thermo Fisher Scientific) and the Qubit 1X dsDNA high sensitivity assay kit.Note: This step yields approximately 10–15 μg of total DNA.Pause point: The annealed oligonucleotides can be stored at −20°C until ready to proceed.Table 1DNA ethanol precipitationReagentVolumeRemarksGlycogen (5 mg/mL)1 uL50 μg/mL (final)3M Sodium acetate (pH 5.2)10 uL1/10 volumeEthanol (100%)300 uL3 volumesFigure 1Semi-random barcode designSchematic of semi-random barcode oligonucleotide design with restriction sites used for insertion and a barcode ID tag. Note: This 27 bp semi-random DNA barcode was adapted from a previous design16 to which a 4 bp unique library ID sequence was added (Figure 1). Additional libraries can be created by modifying the 4 bp library ID. This unique library ID allows for multiple libraries to be generated, and when used together, can be sequenced simultaneously and then computationally resolved. CRITICAL: The forward and reverse oligonucleotides should be dual PAGE and HPLC purified with a 5′ phosphorylation modification. a.Anneal the forward and reverse oligonucleotides by first dissolving the oligonucleotides in nuclease-free water to a concentration of 200 μM. Mix 25 μL of each oligonucleotide separately with 25 μL of 1X T4 DNA ligase buffer (1:1 mix; final concentration of T4 DNA ligase buffer should be 0.5X). Anneal the forward and reverse oligonucleotides by first dissolving the oligonucleotides in nuclease-free water to a concentration of 200 μM. Mix 25 μL of each oligonucleotide separately with 25 μL of 1X T4 DNA ligase buffer (1:1 mix; final concentration of T4 DNA ligase buffer should be 0.5X). b.Combine 50 μL of forward and reverse oligonucleotide mix (100 μL in total). Combine 50 μL of forward and reverse oligonucleotide mix (100 μL in total). c.In a PCR thermocycler, heat the oligonucleotide mixture to 95°C for 5 min, and cool gradually at a rate of 0.5°C per min to reach 10°C. In a PCR thermocycler, heat the oligonucleotide mixture to 95°C for 5 min, and cool gradually at a rate of 0.5°C per min to reach 10°C. d.Run the annealed oligonucleotides on a 4% agarose-TBE gel (120 V constant).Note: Unannealed oligonucleotides should be run as control to accurately predict the size of annealed oligonucleotides (60 bp). Leave a gap between samples if more than one library is being prepared to avoid cross-contamination. Run the annealed oligonucleotides on a 4% agarose-TBE gel (120 V constant).Note: Unannealed oligonucleotides should be run as control to accurately predict the size of annealed oligonucleotides (60 bp). Leave a gap between samples if more than one library is being prepared to avoid cross-contamination. Note: Unannealed oligonucleotides should be run as control to accurately predict the size of annealed oligonucleotides (60 bp). Leave a gap between samples if more than one library is being prepared to avoid cross-contamination. e.Perform gel extraction as per manufacturer’s instructions using the QIAEX II Gel extraction kit (Qiagen) and elute the annealed oligonucleotides into 100 μL nuclease-free water. Perform gel extraction as per manufacturer’s instructions using the QIAEX II Gel extraction kit (Qiagen) and elute the annealed oligonucleotides into 100 μL nuclease-free water. f.Perform ethanol precipitation of the DNA by adding the following reagents to the 100 μL eluate in the order as indicated in Table 1, then:i.Vortex 3 sec to mix and freeze at −80°C for 16–24 h to precipitate the DNA.Pause point: The reaction can be stored at −80°C for longer, but it is recommended to proceed with the next steps after incubation for 16–24 hrs.ii.The next day, centrifuge at maximum speed (∼18,000 x g) at 4°C for 30 min to obtain a white pellet of the precipitated DNA.iii.Carefully discard the supernatant without disturbing the DNA pellet.iv.Add 1 mL of 70% cold ethanol to wash the pellet.v.Centrifuge again at maximum speed (∼18,000 x g) at 4°C for 10 min.vi.Carefully remove the supernatant completely and let the pellet dry to room air for 5–15 min.Note: Circle around the pellet with a marker pen as the pellet may become invisible when dry.vii.Resuspend the pellet in 20 μL nuclease-free water and store at −20°C.viii.Quantify the DNA using a Qubit fluorometer (Thermo Fisher Scientific) and the Qubit 1X dsDNA high sensitivity assay kit.Note: This step yields approximately 10–15 μg of total DNA.Pause point: The annealed oligonucleotides can be stored at −20°C until ready to proceed.Table 1DNA ethanol precipitationReagentVolumeRemarksGlycogen (5 mg/mL)1 uL50 μg/mL (final)3M Sodium acetate (pH 5.2)10 uL1/10 volumeEthanol (100%)300 uL3 volumes Perform ethanol precipitation of the DNA by adding the following reagents to the 100 μL eluate in the order as indicated in Table 1, then:i.Vortex 3 sec to mix and freeze at −80°C for 16–24 h to precipitate the DNA.Pause point: The reaction can be stored at −80°C for longer, but it is recommended to proceed with the next steps after incubation for 16–24 hrs.ii.The next day, centrifuge at maximum speed (∼18,000 x g) at 4°C for 30 min to obtain a white pellet of the precipitated DNA.iii.Carefully discard the supernatant without disturbing the DNA pellet.iv.Add 1 mL of 70% cold ethanol to wash the pellet.v.Centrifuge again at maximum speed (∼18,000 x g) at 4°C for 10 min.vi.Carefully remove the supernatant completely and let the pellet dry to room air for 5–15 min.Note: Circle around the pellet with a marker pen as the pellet may become invisible when dry.vii.Resuspend the pellet in 20 μL nuclease-free water and store at −20°C.viii.Quantify the DNA using a Qubit fluorometer (Thermo Fisher Scientific) and the Qubit 1X dsDNA high sensitivity assay kit.Note: This step yields approximately 10–15 μg of total DNA.Pause point: The annealed oligonucleotides can be stored at −20°C until ready to proceed.Table 1DNA ethanol precipitationReagentVolumeRemarksGlycogen (5 mg/mL)1 uL50 μg/mL (final)3M Sodium acetate (pH 5.2)10 uL1/10 volumeEthanol (100%)300 uL3 volumes i.Vortex 3 sec to mix and freeze at −80°C for 16–24 h to precipitate the DNA.Pause point: The reaction can be stored at −80°C for longer, but it is recommended to proceed with the next steps after incubation for 16–24 hrs. Vortex 3 sec to mix and freeze at −80°C for 16–24 h to precipitate the DNA.Pause point: The reaction can be stored at −80°C for longer, but it is recommended to proceed with the next steps after incubation for 16–24 hrs. Pause point: The reaction can be stored at −80°C for longer, but it is recommended to proceed with the next steps after incubation for 16–24 hrs. ii.The next day, centrifuge at maximum speed (∼18,000 x g) at 4°C for 30 min to obtain a white pellet of the precipitated DNA. The next day, centrifuge at maximum speed (∼18,000 x g) at 4°C for 30 min to obtain a white pellet of the precipitated DNA. iii.Carefully discard the supernatant without disturbing the DNA pellet. Carefully discard the supernatant without disturbing the DNA pellet. iv.Add 1 mL of 70% cold ethanol to wash the pellet. Add 1 mL of 70% cold ethanol to wash the pellet. v.Centrifuge again at maximum speed (∼18,000 x g) at 4°C for 10 min. Centrifuge again at maximum speed (∼18,000 x g) at 4°C for 10 min. vi.Carefully remove the supernatant completely and let the pellet dry to room air for 5–15 min.Note: Circle around the pellet with a marker pen as the pellet may become invisible when dry. Carefully remove the supernatant completely and let the pellet dry to room air for 5–15 min.Note: Circle around the pellet with a marker pen as the pellet may become invisible when dry. Note: Circle around the pellet with a marker pen as the pellet may become invisible when dry. vii.Resuspend the pellet in 20 μL nuclease-free water and store at −20°C. Resuspend the pellet in 20 μL nuclease-free water and store at −20°C. viii.Quantify the DNA using a Qubit fluorometer (Thermo Fisher Scientific) and the Qubit 1X dsDNA high sensitivity assay kit.Note: This step yields approximately 10–15 μg of total DNA.Pause point: The annealed oligonucleotides can be stored at −20°C until ready to proceed. Quantify the DNA using a Qubit fluorometer (Thermo Fisher Scientific) and the Qubit 1X dsDNA high sensitivity assay kit.Note: This step yields approximately 10–15 μg of total DNA.Pause point: The annealed oligonucleotides can be stored at −20°C until ready to proceed. Note: This step yields approximately 10–15 μg of total DNA. Pause point: The annealed oligonucleotides can be stored at −20°C until ready to proceed. Table 1DNA ethanol precipitationReagentVolumeRemarksGlycogen (5 mg/mL)1 uL50 μg/mL (final)3M Sodium acetate (pH 5.2)10 uL1/10 volumeEthanol (100%)300 uL3 volumes DNA ethanol precipitation Semi-random barcode design Schematic of semi-random barcode oligonucleotide design with restriction sites used for insertion and a barcode ID tag. 2.Prepare the pLARRY-EGFP vector (Addgene) for ligation with annealed barcode oligonucleotides as follows:a.Double-digest the pLARRY-EGFP vector using SalI and XbaI restriction endonuclease sites in the 3′ UTR of EGFP as indicated in Table 2.Table 2Restriction digestion reactionReagentAmountVector (pLARRY-EGFP)1 ug10X rCutSmart buffer5 uLSalI1 uLXbaI1 uLWater (nuclease-free)Up to 50 uLb.Incubate the reaction at 37°C for 20 min followed by heat inactivation of enzymes at 65°C for 20 min.Note: Only use 1 μg of plasmid DNA per reaction to achieve complete digestion. Additional reactions can be included and subsequently pooled together to increase the final yield of the digested vector as needed.c.Run the double-digested vector and the following controls on a 0.7% agarose-TBE gel (120 V constant):i.Undigested pLARRY-EGFP plasmid.ii.pLARRY-EGFP plasmid digested with either SalI or XbaI (single cut linearized).d.Perform gel extraction of the double-digested vector using QIAEX II Gel Extraction Kit and elute the DNA into 100 μL nuclease-free water.e.Perform ethanol precipitation of the DNA as described in step 1f in constructing the DNA barcode library and validating barcode diversity.f.Resuspend the double-digested vector in 20 μL of nuclease-free water and quantify the concentration of DNA using a Qubit fluorometer (Thermo Fisher Scientific) and the Qubit 1X dsDNA high sensitivity assay kit.Note: This step should yield approximately 0.2–0.5 μg of total DNA per reaction.Pause point: The double digested vector can be stored at −20°C until ready to proceed. Prepare the pLARRY-EGFP vector (Addgene) for ligation with annealed barcode oligonucleotides as follows:a.Double-digest the pLARRY-EGFP vector using SalI and XbaI restriction endonuclease sites in the 3′ UTR of EGFP as indicated in Table 2.Table 2Restriction digestion reactionReagentAmountVector (pLARRY-EGFP)1 ug10X rCutSmart buffer5 uLSalI1 uLXbaI1 uLWater (nuclease-free)Up to 50 uLb.Incubate the reaction at 37°C for 20 min followed by heat inactivation of enzymes at 65°C for 20 min.Note: Only use 1 μg of plasmid DNA per reaction to achieve complete digestion. Additional reactions can be included and subsequently pooled together to increase the final yield of the digested vector as needed.c.Run the double-digested vector and the following controls on a 0.7% agarose-TBE gel (120 V constant):i.Undigested pLARRY-EGFP plasmid.ii.pLARRY-EGFP plasmid digested with either SalI or XbaI (single cut linearized).d.Perform gel extraction of the double-digested vector using QIAEX II Gel Extraction Kit and elute the DNA into 100 μL nuclease-free water.e.Perform ethanol precipitation of the DNA as described in step 1f in constructing the DNA barcode library and validating barcode diversity.f.Resuspend the double-digested vector in 20 μL of nuclease-free water and quantify the concentration of DNA using a Qubit fluorometer (Thermo Fisher Scientific) and the Qubit 1X dsDNA high sensitivity assay kit.Note: This step should yield approximately 0.2–0.5 μg of total DNA per reaction.Pause point: The double digested vector can be stored at −20°C until ready to proceed. a.Double-digest the pLARRY-EGFP vector using SalI and XbaI restriction endonuclease sites in the 3′ UTR of EGFP as indicated in Table 2.Table 2Restriction digestion reactionReagentAmountVector (pLARRY-EGFP)1 ug10X rCutSmart buffer5 uLSalI1 uLXbaI1 uLWater (nuclease-free)Up to 50 uL Double-digest the pLARRY-EGFP vector using SalI and XbaI restriction endonuclease sites in the 3′ UTR of EGFP as indicated in Table 2.Table 2Restriction digestion reactionReagentAmountVector (pLARRY-EGFP)1 ug10X rCutSmart buffer5 uLSalI1 uLXbaI1 uLWater (nuclease-free)Up to 50 uL Table 2Restriction digestion reactionReagentAmountVector (pLARRY-EGFP)1 ug10X rCutSmart buffer5 uLSalI1 uLXbaI1 uLWater (nuclease-free)Up to 50 uL Restriction digestion reaction b.Incubate the reaction at 37°C for 20 min followed by heat inactivation of enzymes at 65°C for 20 min.Note: Only use 1 μg of plasmid DNA per reaction to achieve complete digestion. Additional reactions can be included and subsequently pooled together to increase the final yield of the digested vector as needed. Incubate the reaction at 37°C for 20 min followed by heat inactivation of enzymes at 65°C for 20 min.Note: Only use 1 μg of plasmid DNA per reaction to achieve complete digestion. Additional reactions can be included and subsequently pooled together to increase the final yield of the digested vector as needed. Note: Only use 1 μg of plasmid DNA per reaction to achieve complete digestion. Additional reactions can be included and subsequently pooled together to increase the final yield of the digested vector as needed. c.Run the double-digested vector and the following controls on a 0.7% agarose-TBE gel (120 V constant):i.Undigested pLARRY-EGFP plasmid.ii.pLARRY-EGFP plasmid digested with either SalI or XbaI (single cut linearized). Run the double-digested vector and the following controls on a 0.7% agarose-TBE gel (120 V constant):i.Undigested pLARRY-EGFP plasmid.ii.pLARRY-EGFP plasmid digested with either SalI or XbaI (single cut linearized). i.Undigested pLARRY-EGFP plasmid. Undigested pLARRY-EGFP plasmid. ii.pLARRY-EGFP plasmid digested with either SalI or XbaI (single cut linearized). pLARRY-EGFP plasmid digested with either SalI or XbaI (single cut linearized). d.Perform gel extraction of the double-digested vector using QIAEX II Gel Extraction Kit and elute the DNA into 100 μL nuclease-free water. Perform gel extraction of the double-digested vector using QIAEX II Gel Extraction Kit and elute the DNA into 100 μL nuclease-free water. e.Perform ethanol precipitation of the DNA as described in step 1f in constructing the DNA barcode library and validating barcode diversity. Perform ethanol precipitation of the DNA as described in step 1f in constructing the DNA barcode library and validating barcode diversity. f.Resuspend the double-digested vector in 20 μL of nuclease-free water and quantify the concentration of DNA using a Qubit fluorometer (Thermo Fisher Scientific) and the Qubit 1X dsDNA high sensitivity assay kit.Note: This step should yield approximately 0.2–0.5 μg of total DNA per reaction.Pause point: The double digested vector can be stored at −20°C until ready to proceed. Resuspend the double-digested vector in 20 μL of nuclease-free water and quantify the concentration of DNA using a Qubit fluorometer (Thermo Fisher Scientific) and the Qubit 1X dsDNA high sensitivity assay kit.Note: This step should yield approximately 0.2–0.5 μg of total DNA per reaction.Pause point: The double digested vector can be stored at −20°C until ready to proceed. Note: This step should yield approximately 0.2–0.5 μg of total DNA per reaction. Pause point: The double digested vector can be stored at −20°C until ready to proceed. 3.Ligate annealed barcode oligonucleotides into 3′ UTR of EGFP in the pLARRY-EGFP vector.a.Prior to ligation, check the purity of the annealed oligonucleotides and the double-digested vector by running the Agilent Bioanalyzer.b.Mix the annealed barcode oligonucleotides with double-digested pLARRY-EGFP vector in a 3:1 molar ratio (10 ng of double-digested vector with 3X molar ratio of annealed oligonucleotides) to a final reaction volume of 10 μL.c.Perform ligation with T4 DNA ligase (New England Biolabs) as indicated in Table 3, then:i.Gently mix by pipetting, spin down and incubate at 16°C for 16–24 hrs.CRITICAL: Do not pause here. After incubation, proceed to the next step.ii.Heat inactivate at 65°C for 10 min and chill on ice.iii.For the ligation step, include a negative control containing the double digested vector without annealed oligonucleotides.Note: The negative control tests the frequency of single digested vector present that can re-circularize even without annealed oligonucleotides.Table 3Ligation reactionReagentAmountAnnealed oligonucleotides: double-digested vector (3:1)10 uL10X T4 DNA ligase buffer2 uLT4 DNA ligase1 uLWaterUp to 20 uL Ligate annealed barcode oligonucleotides into 3′ UTR of EGFP in the pLARRY-EGFP vector.a.Prior to ligation, check the purity of the annealed oligonucleotides and the double-digested vector by running the Agilent Bioanalyzer.b.Mix the annealed barcode oligonucleotides with double-digested pLARRY-EGFP vector in a 3:1 molar ratio (10 ng of double-digested vector with 3X molar ratio of annealed oligonucleotides) to a final reaction volume of 10 μL.c.Perform ligation with T4 DNA ligase (New England Biolabs) as indicated in Table 3, then:i.Gently mix by pipetting, spin down and incubate at 16°C for 16–24 hrs.CRITICAL: Do not pause here. After incubation, proceed to the next step.ii.Heat inactivate at 65°C for 10 min and chill on ice.iii.For the ligation step, include a negative control containing the double digested vector without annealed oligonucleotides.Note: The negative control tests the frequency of single digested vector present that can re-circularize even without annealed oligonucleotides.Table 3Ligation reactionReagentAmountAnnealed oligonucleotides: double-digested vector (3:1)10 uL10X T4 DNA ligase buffer2 uLT4 DNA ligase1 uLWaterUp to 20 uL a.Prior to ligation, check the purity of the annealed oligonucleotides and the double-digested vector by running the Agilent Bioanalyzer. Prior to ligation, check the purity of the annealed oligonucleotides and the double-digested vector by running the Agilent Bioanalyzer. b.Mix the annealed barcode oligonucleotides with double-digested pLARRY-EGFP vector in a 3:1 molar ratio (10 ng of double-digested vector with 3X molar ratio of annealed oligonucleotides) to a final reaction volume of 10 μL. Mix the annealed barcode oligonucleotides with double-digested pLARRY-EGFP vector in a 3:1 molar ratio (10 ng of double-digested vector with 3X molar ratio of annealed oligonucleotides) to a final reaction volume of 10 μL. c.Perform ligation with T4 DNA ligase (New England Biolabs) as indicated in Table 3, then:i.Gently mix by pipetting, spin down and incubate at 16°C for 16–24 hrs.CRITICAL: Do not pause here. After incubation, proceed to the next step.ii.Heat inactivate at 65°C for 10 min and chill on ice.iii.For the ligation step, include a negative control containing the double digested vector without annealed oligonucleotides.Note: The negative control tests the frequency of single digested vector present that can re-circularize even without annealed oligonucleotides.Table 3Ligation reactionReagentAmountAnnealed oligonucleotides: double-digested vector (3:1)10 uL10X T4 DNA ligase buffer2 uLT4 DNA ligase1 uLWaterUp to 20 uL Perform ligation with T4 DNA ligase (New England Biolabs) as indicated in Table 3, then:i.Gently mix by pipetting, spin down and incubate at 16°C for 16–24 hrs.CRITICAL: Do not pause here. After incubation, proceed to the next step.ii.Heat inactivate at 65°C for 10 min and chill on ice.iii.For the ligation step, include a negative control containing the double digested vector without annealed oligonucleotides.Note: The negative control tests the frequency of single digested vector present that can re-circularize even without annealed oligonucleotides.Table 3Ligation reactionReagentAmountAnnealed oligonucleotides: double-digested vector (3:1)10 uL10X T4 DNA ligase buffer2 uLT4 DNA ligase1 uLWaterUp to 20 uL i.Gently mix by pipetting, spin down and incubate at 16°C for 16–24 hrs.CRITICAL: Do not pause here. After incubation, proceed to the next step. Gently mix by pipetting, spin down and incubate at 16°C for 16–24 hrs.CRITICAL: Do not pause here. After incubation, proceed to the next step. CRITICAL: Do not pause here. After incubation, proceed to the next step. ii.Heat inactivate at 65°C for 10 min and chill on ice. Heat inactivate at 65°C for 10 min and chill on ice. iii.For the ligation step, include a negative control containing the double digested vector without annealed oligonucleotides.Note: The negative control tests the frequency of single digested vector present that can re-circularize even without annealed oligonucleotides. For the ligation step, include a negative control containing the double digested vector without annealed oligonucleotides.Note: The negative control tests the frequency of single digested vector present that can re-circularize even without annealed oligonucleotides. Note: The negative control tests the frequency of single digested vector present that can re-circularize even without annealed oligonucleotides. Table 3Ligation reactionReagentAmountAnnealed oligonucleotides: double-digested vector (3:1)10 uL10X T4 DNA ligase buffer2 uLT4 DNA ligase1 uLWaterUp to 20 uL Ligation reaction 4.Transform the ligated product and negative control into ElectroMAX DH10B electrocompetent cells (Invitrogen) as per manufacturer’s instructions.a.For each transformation reaction, add 1 μl of ligated product per 20 μL of electrocompetent cells and perform electroporation. Prepare control conditions as below:i.Positive control: undigested pLARRY-EGFP plasmid.ii.Negative control: double digested pLARRY-EGFP plasmid with no insert.CRITICAL: Do not discard remaining ligated product as it will be used for additional transformations in following steps.b.Add 1 mL of SOC media to each transformation reaction and incubate at 37°C for 1 h.c.Immediately following incubation for 1 h, plate different volumes of transformed cells (i.e., 50 μL, 100 μL, 150 μL and 200 μL) onto 100 mm LB-agar plates containing 100 μM ampicillin and incubate at 37°C for 20 h.CRITICAL: Do not discard remaining transformed cells (store at 4°C) as they will be pooled with additional transformations for plating on 245 mm × 245 mm square LB-agar plates.d.20 h after plating, examine plate density and proportionally calculate volume for plating on 245 mm × 245 mm square LB-agar plates containing 100 μM ampicillin using the volume that resulted in dense, single colonies on the 100 mm plates.e.Perform 19 additional transformations with the remaining 19 μL of the ligated product to maximize the barcode library diversity.f.Pool all transformation reactions together and plate on an appropriate number of 245 mm × 245 mm square LB-agar plates containing 100 μM ampicillin based on the plating volume determined in steps 4c and 4d in constructing the DNA barcode library and validating barcode diversity. Incubate the plates at 37°C for 20 h.Note: Increasing the number of plates used, and thus the number of bacterial colonies formed will increase the diversity of the barcode library.g.After 20 h incubation, count colonies on a representative section of the square plates to approximate the potential diversity of the barcode library. To prepare a homogenous bacterial mixture and to prepare glycerol stocks:i.Use 100–800 μL of LB broth containing 100 μM ampicillin for each 245 mm × 245 mm square LB-agar plate to facilitate scraping and combining of the colonies.ii.Measure the final volume of the resulting bacterial mixture. Add 1:1 volume of 50% glycerol to the bacterial mixture to prepare glycerol stocks. Gently mix thoroughly, aliquot the glycerol stock into 1 mL cryovials, and store at −80°C.iii.Extract plasmid DNA from each glycerol stock using the QIAGEN Plasmid Mini Kit (Qiagen) according to the manufacturer’s instructions. Transform the ligated product and negative control into ElectroMAX DH10B electrocompetent cells (Invitrogen) as per manufacturer’s instructions.a.For each transformation reaction, add 1 μl of ligated product per 20 μL of electrocompetent cells and perform electroporation. Prepare control conditions as below:i.Positive control: undigested pLARRY-EGFP plasmid.ii.Negative control: double digested pLARRY-EGFP plasmid with no insert.CRITICAL: Do not discard remaining ligated product as it will be used for additional transformations in following steps.b.Add 1 mL of SOC media to each transformation reaction and incubate at 37°C for 1 h.c.Immediately following incubation for 1 h, plate different volumes of transformed cells (i.e., 50 μL, 100 μL, 150 μL and 200 μL) onto 100 mm LB-agar plates containing 100 μM ampicillin and incubate at 37°C for 20 h.CRITICAL: Do not discard remaining transformed cells (store at 4°C) as they will be pooled with additional transformations for plating on 245 mm × 245 mm square LB-agar plates.d.20 h after plating, examine plate density and proportionally calculate volume for plating on 245 mm × 245 mm square LB-agar plates containing 100 μM ampicillin using the volume that resulted in dense, single colonies on the 100 mm plates.e.Perform 19 additional transformations with the remaining 19 μL of the ligated product to maximize the barcode library diversity.f.Pool all transformation reactions together and plate on an appropriate number of 245 mm × 245 mm square LB-agar plates containing 100 μM ampicillin based on the plating volume determined in steps 4c and 4d in constructing the DNA barcode library and validating barcode diversity. Incubate the plates at 37°C for 20 h.Note: Increasing the number of plates used, and thus the number of bacterial colonies formed will increase the diversity of the barcode library.g.After 20 h incubation, count colonies on a representative section of the square plates to approximate the potential diversity of the barcode library. To prepare a homogenous bacterial mixture and to prepare glycerol stocks:i.Use 100–800 μL of LB broth containing 100 μM ampicillin for each 245 mm × 245 mm square LB-agar plate to facilitate scraping and combining of the colonies.ii.Measure the final volume of the resulting bacterial mixture. Add 1:1 volume of 50% glycerol to the bacterial mixture to prepare glycerol stocks. Gently mix thoroughly, aliquot the glycerol stock into 1 mL cryovials, and store at −80°C.iii.Extract plasmid DNA from each glycerol stock using the QIAGEN Plasmid Mini Kit (Qiagen) according to the manufacturer’s instructions. a.For each transformation reaction, add 1 μl of ligated product per 20 μL of electrocompetent cells and perform electroporation. Prepare control conditions as below:i.Positive control: undigested pLARRY-EGFP plasmid.ii.Negative control: double digested pLARRY-EGFP plasmid with no insert.CRITICAL: Do not discard remaining ligated product as it will be used for additional transformations in following steps. For each transformation reaction, add 1 μl of ligated product per 20 μL of electrocompetent cells and perform electroporation. Prepare control conditions as below:i.Positive control: undigested pLARRY-EGFP plasmid.ii.Negative control: double digested pLARRY-EGFP plasmid with no insert.CRITICAL: Do not discard remaining ligated product as it will be used for additional transformations in following steps. i.Positive control: undigested pLARRY-EGFP plasmid. Positive control: undigested pLARRY-EGFP plasmid. ii.Negative control: double digested pLARRY-EGFP plasmid with no insert.CRITICAL: Do not discard remaining ligated product as it will be used for additional transformations in following steps. Negative control: double digested pLARRY-EGFP plasmid with no insert.CRITICAL: Do not discard remaining ligated product as it will be used for additional transformations in following steps. CRITICAL: Do not discard remaining ligated product as it will be used for additional transformations in following steps. b.Add 1 mL of SOC media to each transformation reaction and incubate at 37°C for 1 h. Add 1 mL of SOC media to each transformation reaction and incubate at 37°C for 1 h. c.Immediately following incubation for 1 h, plate different volumes of transformed cells (i.e., 50 μL, 100 μL, 150 μL and 200 μL) onto 100 mm LB-agar plates containing 100 μM ampicillin and incubate at 37°C for 20 h.CRITICAL: Do not discard remaining transformed cells (store at 4°C) as they will be pooled with additional transformations for plating on 245 mm × 245 mm square LB-agar plates. Immediately following incubation for 1 h, plate different volumes of transformed cells (i.e., 50 μL, 100 μL, 150 μL and 200 μL) onto 100 mm LB-agar plates containing 100 μM ampicillin and incubate at 37°C for 20 h.CRITICAL: Do not discard remaining transformed cells (store at 4°C) as they will be pooled with additional transformations for plating on 245 mm × 245 mm square LB-agar plates. CRITICAL: Do not discard remaining transformed cells (store at 4°C) as they will be pooled with additional transformations for plating on 245 mm × 245 mm square LB-agar plates. d.20 h after plating, examine plate density and proportionally calculate volume for plating on 245 mm × 245 mm square LB-agar plates containing 100 μM ampicillin using the volume that resulted in dense, single colonies on the 100 mm plates. 20 h after plating, examine plate density and proportionally calculate volume for plating on 245 mm × 245 mm square LB-agar plates containing 100 μM ampicillin using the volume that resulted in dense, single colonies on the 100 mm plates. e.Perform 19 additional transformations with the remaining 19 μL of the ligated product to maximize the barcode library diversity. Perform 19 additional transformations with the remaining 19 μL of the ligated product to maximize the barcode library diversity. f.Pool all transformation reactions together and plate on an appropriate number of 245 mm × 245 mm square LB-agar plates containing 100 μM ampicillin based on the plating volume determined in steps 4c and 4d in constructing the DNA barcode library and validating barcode diversity. Incubate the plates at 37°C for 20 h.Note: Increasing the number of plates used, and thus the number of bacterial colonies formed will increase the diversity of the barcode library. Pool all transformation reactions together and plate on an appropriate number of 245 mm × 245 mm square LB-agar plates containing 100 μM ampicillin based on the plating volume determined in steps 4c and 4d in constructing the DNA barcode library and validating barcode diversity. Incubate the plates at 37°C for 20 h.Note: Increasing the number of plates used, and thus the number of bacterial colonies formed will increase the diversity of the barcode library. Note: Increasing the number of plates used, and thus the number of bacterial colonies formed will increase the diversity of the barcode library. g.After 20 h incubation, count colonies on a representative section of the square plates to approximate the potential diversity of the barcode library. To prepare a homogenous bacterial mixture and to prepare glycerol stocks:i.Use 100–800 μL of LB broth containing 100 μM ampicillin for each 245 mm × 245 mm square LB-agar plate to facilitate scraping and combining of the colonies.ii.Measure the final volume of the resulting bacterial mixture. Add 1:1 volume of 50% glycerol to the bacterial mixture to prepare glycerol stocks. Gently mix thoroughly, aliquot the glycerol stock into 1 mL cryovials, and store at −80°C.iii.Extract plasmid DNA from each glycerol stock using the QIAGEN Plasmid Mini Kit (Qiagen) according to the manufacturer’s instructions. After 20 h incubation, count colonies on a representative section of the square plates to approximate the potential diversity of the barcode library. To prepare a homogenous bacterial mixture and to prepare glycerol stocks:i.Use 100–800 μL of LB broth containing 100 μM ampicillin for each 245 mm × 245 mm square LB-agar plate to facilitate scraping and combining of the colonies.ii.Measure the final volume of the resulting bacterial mixture. Add 1:1 volume of 50% glycerol to the bacterial mixture to prepare glycerol stocks. Gently mix thoroughly, aliquot the glycerol stock into 1 mL cryovials, and store at −80°C.iii.Extract plasmid DNA from each glycerol stock using the QIAGEN Plasmid Mini Kit (Qiagen) according to the manufacturer’s instructions. i.Use 100–800 μL of LB broth containing 100 μM ampicillin for each 245 mm × 245 mm square LB-agar plate to facilitate scraping and combining of the colonies. Use 100–800 μL of LB broth containing 100 μM ampicillin for each 245 mm × 245 mm square LB-agar plate to facilitate scraping and combining of the colonies. ii.Measure the final volume of the resulting bacterial mixture. Add 1:1 volume of 50% glycerol to the bacterial mixture to prepare glycerol stocks. Gently mix thoroughly, aliquot the glycerol stock into 1 mL cryovials, and store at −80°C. Measure the final volume of the resulting bacterial mixture. Add 1:1 volume of 50% glycerol to the bacterial mixture to prepare glycerol stocks. Gently mix thoroughly, aliquot the glycerol stock into 1 mL cryovials, and store at −80°C. iii.Extract plasmid DNA from each glycerol stock using the QIAGEN Plasmid Mini Kit (Qiagen) according to the manufacturer’s instructions. Extract plasmid DNA from each glycerol stock using the QIAGEN Plasmid Mini Kit (Qiagen) according to the manufacturer’s instructions. 5.Prepare the plasmid DNA library for DNA amplicon sequencing as described in steps 8–15 in multiplexed barcode DNA amplicon sequencing. Sequence plasmid libraries to a depth of at least 10X the anticipated diversity (e.g., 10 million reads per library for an expected diversity of 1 million unique barcodes). Prepare the plasmid DNA library for DNA amplicon sequencing as described in steps 8–15 in multiplexed barcode DNA amplicon sequencing. Sequence plasmid libraries to a depth of at least 10X the anticipated diversity (e.g., 10 million reads per library for an expected diversity of 1 million unique barcodes). 6.Package lentiviruses with HEK293T cells and the barcode library plasmid DNA using the Lipofectamine 3000 kit (Invitrogen) as per manufacturer’s instructions.a.Concentrate lentiviral supernatant with Lenti-X concentrator (Takara Bio).b.Test and calculate lentiviral titer using an appropriate cell line. Package lentiviruses with HEK293T cells and the barcode library plasmid DNA using the Lipofectamine 3000 kit (Invitrogen) as per manufacturer’s instructions.a.Concentrate lentiviral supernatant with Lenti-X concentrator (Takara Bio).b.Test and calculate lentiviral titer using an appropriate cell line. a.Concentrate lentiviral supernatant with Lenti-X concentrator (Takara Bio). Concentrate lentiviral supernatant with Lenti-X concentrator (Takara Bio). b.Test and calculate lentiviral titer using an appropriate cell line. Test and calculate lentiviral titer using an appropriate cell line. CRITICAL: It is important to optimize lentiviral transduction conditions to achieve a MOI of less than 0.3 to minimize the likelihood for multiple barcode integrations. 7.Validate the diversity of the barcode library by transducing an appropriate cell line (we used MDA-MB-231 cells, a human breast cancer cell line).a.In triplicate, transduce 105 to 106 MDA-MB-231 cells with the lentivirus to target a MOI of less than 0.3.b.Culture the cells for 24 h after transduction and harvest for DNA amplicon sequencing as described in steps 8–15 in multiplexed barcode DNA amplicon sequencing. Validate the diversity of the barcode library by transducing an appropriate cell line (we used MDA-MB-231 cells, a human breast cancer cell line).a.In triplicate, transduce 105 to 106 MDA-MB-231 cells with the lentivirus to target a MOI of less than 0.3.b.Culture the cells for 24 h after transduction and harvest for DNA amplicon sequencing as described in steps 8–15 in multiplexed barcode DNA amplicon sequencing. a.In triplicate, transduce 105 to 106 MDA-MB-231 cells with the lentivirus to target a MOI of less than 0.3. In triplicate, transduce 105 to 106 MDA-MB-231 cells with the lentivirus to target a MOI of less than 0.3. b.Culture the cells for 24 h after transduction and harvest for DNA amplicon sequencing as described in steps 8–15 in multiplexed barcode DNA amplicon sequencing. Culture the cells for 24 h after transduction and harvest for DNA amplicon sequencing as described in steps 8–15 in multiplexed barcode DNA amplicon sequencing. Multiplexed barcode DNA amplicon sequencing Timing: 1–2 days Timing: 1–2 days This major step describes the preparation of plasmid DNA or barcoded cells for DNA amplicon sequencing.8.If starting from cells, extract and purify genomic DNA (gDNA) from the cells (maximum of 2 × 105 cells per sample using the prepGEM Universal DNA extraction kit (ForenteQ Limited) or PicoPure DNA extraction kit (Thermo Fisher). Ethanol precipitate the purified genomic DNA as described in step 1f in constructing the DNA barcode library and validating barcode diversity. If starting from plasmid DNA, use 50 ng DNA per sample, which can be used directly without ethanol precipitation.9.Perform PCR to amplify the barcode sequence of interest with primers that contain the i7 and i5 linker sequence compatible with Illumina sequencing (see key resources table for information on primers).a.Carry out PCR #1 (Tables 4 and 5) to amplify each sample using one of the three staggered primer sets to increase the diversity of nucleotides represented in a given sequencing cycle to improve cluster recognition and reduce the amount of PhiX spike-in DNA required.Table 4PCR #1 reactionReagentAmountFinal concentrationDNA template50 ng2 ng/uLQ5 DNA polymerase0.25 uLN/A10 μM FWD primer1.25 uL0.5 uM10 μM REV primer1.25 uL0.5 uM5X Q5 buffer5 uL1X10 mM dNTPs0.5 uL0.2 mMNuclease-free waterUp to 25 uLN/ATable 5PCR #1 cycling conditionsStepsTemperatureTimeCyclesInitial denaturation98 °C30 sec1Denaturation98 °C10 sec25Annealing67 °Ca30 secExtension72 °C30 minFinal extension72 °C5 min1Hold10 °CInfiniteaAnnealing temperature can vary based on the primer design.Note: Use one primer set per sample. Evenly distribute the 3 primer sets across the samples per sequencing batch.10.Top up the 25 μL product from PCR #1 up to 100 μL with nuclease-free water and ethanol precipitate as described in step 1f in constructing the DNA barcode library and validating barcode diversity. Resuspend precipitated DNA in 15 μL nuclease-free water.11.Perform PCR #2 (Tables 6 and 7) to multiplex the samples with Illumina unique dual indexes.Table 6PCR #2 reactionReagentAmountFinal concentrationDNA template1.5 μL of PCR #1 productN/AQ5 high-fidelity DNA polymerase0.25 uLN/AIDT for Illumina UD Indexes2.5 uL1 uM5X Q5 buffer5 uL1x10 mM dNTPs0.5 uL0.2 mMNuclease-free waterUp to 25 uLN/ATable 7PCR #2 cycling conditionsStepsTemperatureTimeCyclesInitial denaturation98 °C30 sec1Denaturation98 °C10 sec5Annealing62 °C30 secExtension72 °C30 minFinal extension72 °C5 min1Hold10 °CInfiniteNote: Each well or sample should include a unique pair of indexes for multiplexing; choose indexes for each based on the Illumina pooling guide.12.Run PCR #2 product on a 1.5% agarose gel (120 V constant).13.Gel extract and ethanol precipitate each PCR product as described in step 1f in constructing the DNA barcode library and validating barcode diversity and resuspend in 15 μL nuclease-free water.14.Quantify the PCR product by qPCR using the KAPA library quantification kit (Roche) as per manufacturer’s instructions. Perform qPCR (in triplicate) using 3 dilutions (1/104, 1/105 and 1/106).15.Pool together each multiplexed library in equimolar ratio and sequence on the Illumina MiSeq or other sequencing platform using 2×75 bp paired-end sequencing with at least 10% PhiX spike-in.Note: We recommend a sequencing depth of 1 million reads per experimental sample expected to contain hundreds to thousands of barcodes. For validation of the barcode library diversity, we recommend at least 10X read depth based on number of unique barcodes expected (i.e., at least 10 million reads for an expected library diversity of 1 million barcodes).CRITICAL: 10% PhiX spike-in was used on the Illumina MiSeq platform. Other sequencing platforms may require a larger amount up to 25%. It is recommended to review this requirement with your sequencing center. 8.If starting from cells, extract and purify genomic DNA (gDNA) from the cells (maximum of 2 × 105 cells per sample using the prepGEM Universal DNA extraction kit (ForenteQ Limited) or PicoPure DNA extraction kit (Thermo Fisher). Ethanol precipitate the purified genomic DNA as described in step 1f in constructing the DNA barcode library and validating barcode diversity. If starting from plasmid DNA, use 50 ng DNA per sample, which can be used directly without ethanol precipitation. If starting from cells, extract and purify genomic DNA (gDNA) from the cells (maximum of 2 × 105 cells per sample using the prepGEM Universal DNA extraction kit (ForenteQ Limited) or PicoPure DNA extraction kit (Thermo Fisher). Ethanol precipitate the purified genomic DNA as described in step 1f in constructing the DNA barcode library and validating barcode diversity. If starting from plasmid DNA, use 50 ng DNA per sample, which can be used directly without ethanol precipitation. 9.Perform PCR to amplify the barcode sequence of interest with primers that contain the i7 and i5 linker sequence compatible with Illumina sequencing (see key resources table for information on primers).a.Carry out PCR #1 (Tables 4 and 5) to amplify each sample using one of the three staggered primer sets to increase the diversity of nucleotides represented in a given sequencing cycle to improve cluster recognition and reduce the amount of PhiX spike-in DNA required.Table 4PCR #1 reactionReagentAmountFinal concentrationDNA template50 ng2 ng/uLQ5 DNA polymerase0.25 uLN/A10 μM FWD primer1.25 uL0.5 uM10 μM REV primer1.25 uL0.5 uM5X Q5 buffer5 uL1X10 mM dNTPs0.5 uL0.2 mMNuclease-free waterUp to 25 uLN/ATable 5PCR #1 cycling conditionsStepsTemperatureTimeCyclesInitial denaturation98 °C30 sec1Denaturation98 °C10 sec25Annealing67 °Ca30 secExtension72 °C30 minFinal extension72 °C5 min1Hold10 °CInfiniteaAnnealing temperature can vary based on the primer design. Perform PCR to amplify the barcode sequence of interest with primers that contain the i7 and i5 linker sequence compatible with Illumina sequencing (see key resources table for information on primers).a.Carry out PCR #1 (Tables 4 and 5) to amplify each sample using one of the three staggered primer sets to increase the diversity of nucleotides represented in a given sequencing cycle to improve cluster recognition and reduce the amount of PhiX spike-in DNA required.Table 4PCR #1 reactionReagentAmountFinal concentrationDNA template50 ng2 ng/uLQ5 DNA polymerase0.25 uLN/A10 μM FWD primer1.25 uL0.5 uM10 μM REV primer1.25 uL0.5 uM5X Q5 buffer5 uL1X10 mM dNTPs0.5 uL0.2 mMNuclease-free waterUp to 25 uLN/ATable 5PCR #1 cycling conditionsStepsTemperatureTimeCyclesInitial denaturation98 °C30 sec1Denaturation98 °C10 sec25Annealing67 °Ca30 secExtension72 °C30 minFinal extension72 °C5 min1Hold10 °CInfiniteaAnnealing temperature can vary based on the primer design. a.Carry out PCR #1 (Tables 4 and 5) to amplify each sample using one of the three staggered primer sets to increase the diversity of nucleotides represented in a given sequencing cycle to improve cluster recognition and reduce the amount of PhiX spike-in DNA required.Table 4PCR #1 reactionReagentAmountFinal concentrationDNA template50 ng2 ng/uLQ5 DNA polymerase0.25 uLN/A10 μM FWD primer1.25 uL0.5 uM10 μM REV primer1.25 uL0.5 uM5X Q5 buffer5 uL1X10 mM dNTPs0.5 uL0.2 mMNuclease-free waterUp to 25 uLN/ATable 5PCR #1 cycling conditionsStepsTemperatureTimeCyclesInitial denaturation98 °C30 sec1Denaturation98 °C10 sec25Annealing67 °Ca30 secExtension72 °C30 minFinal extension72 °C5 min1Hold10 °CInfiniteaAnnealing temperature can vary based on the primer design. Carry out PCR #1 (Tables 4 and 5) to amplify each sample using one of the three staggered primer sets to increase the diversity of nucleotides represented in a given sequencing cycle to improve cluster recognition and reduce the amount of PhiX spike-in DNA required.Table 4PCR #1 reactionReagentAmountFinal concentrationDNA template50 ng2 ng/uLQ5 DNA polymerase0.25 uLN/A10 μM FWD primer1.25 uL0.5 uM10 μM REV primer1.25 uL0.5 uM5X Q5 buffer5 uL1X10 mM dNTPs0.5 uL0.2 mMNuclease-free waterUp to 25 uLN/ATable 5PCR #1 cycling conditionsStepsTemperatureTimeCyclesInitial denaturation98 °C30 sec1Denaturation98 °C10 sec25Annealing67 °Ca30 secExtension72 °C30 minFinal extension72 °C5 min1Hold10 °CInfiniteaAnnealing temperature can vary based on the primer design. Table 4PCR #1 reactionReagentAmountFinal concentrationDNA template50 ng2 ng/uLQ5 DNA polymerase0.25 uLN/A10 μM FWD primer1.25 uL0.5 uM10 μM REV primer1.25 uL0.5 uM5X Q5 buffer5 uL1X10 mM dNTPs0.5 uL0.2 mMNuclease-free waterUp to 25 uLN/A PCR #1 reaction Table 5PCR #1 cycling conditionsStepsTemperatureTimeCyclesInitial denaturation98 °C30 sec1Denaturation98 °C10 sec25Annealing67 °Ca30 secExtension72 °C30 minFinal extension72 °C5 min1Hold10 °CInfiniteaAnnealing temperature can vary based on the primer design. PCR #1 cycling conditions Annealing temperature can vary based on the primer design. Note: Use one primer set per sample. Evenly distribute the 3 primer sets across the samples per sequencing batch. 10.Top up the 25 μL product from PCR #1 up to 100 μL with nuclease-free water and ethanol precipitate as described in step 1f in constructing the DNA barcode library and validating barcode diversity. Resuspend precipitated DNA in 15 μL nuclease-free water. Top up the 25 μL product from PCR #1 up to 100 μL with nuclease-free water and ethanol precipitate as described in step 1f in constructing the DNA barcode library and validating barcode diversity. Resuspend precipitated DNA in 15 μL nuclease-free water. 11.Perform PCR #2 (Tables 6 and 7) to multiplex the samples with Illumina unique dual indexes.Table 6PCR #2 reactionReagentAmountFinal concentrationDNA template1.5 μL of PCR #1 productN/AQ5 high-fidelity DNA polymerase0.25 uLN/AIDT for Illumina UD Indexes2.5 uL1 uM5X Q5 buffer5 uL1x10 mM dNTPs0.5 uL0.2 mMNuclease-free waterUp to 25 uLN/ATable 7PCR #2 cycling conditionsStepsTemperatureTimeCyclesInitial denaturation98 °C30 sec1Denaturation98 °C10 sec5Annealing62 °C30 secExtension72 °C30 minFinal extension72 °C5 min1Hold10 °CInfinite Perform PCR #2 (Tables 6 and 7) to multiplex the samples with Illumina unique dual indexes.Table 6PCR #2 reactionReagentAmountFinal concentrationDNA template1.5 μL of PCR #1 productN/AQ5 high-fidelity DNA polymerase0.25 uLN/AIDT for Illumina UD Indexes2.5 uL1 uM5X Q5 buffer5 uL1x10 mM dNTPs0.5 uL0.2 mMNuclease-free waterUp to 25 uLN/ATable 7PCR #2 cycling conditionsStepsTemperatureTimeCyclesInitial denaturation98 °C30 sec1Denaturation98 °C10 sec5Annealing62 °C30 secExtension72 °C30 minFinal extension72 °C5 min1Hold10 °CInfinite Table 6PCR #2 reactionReagentAmountFinal concentrationDNA template1.5 μL of PCR #1 productN/AQ5 high-fidelity DNA polymerase0.25 uLN/AIDT for Illumina UD Indexes2.5 uL1 uM5X Q5 buffer5 uL1x10 mM dNTPs0.5 uL0.2 mMNuclease-free waterUp to 25 uLN/A PCR #2 reaction Table 7PCR #2 cycling conditionsStepsTemperatureTimeCyclesInitial denaturation98 °C30 sec1Denaturation98 °C10 sec5Annealing62 °C30 secExtension72 °C30 minFinal extension72 °C5 min1Hold10 °CInfinite PCR #2 cycling conditions Note: Each well or sample should include a unique pair of indexes for multiplexing; choose indexes for each based on the Illumina pooling guide. 12.Run PCR #2 product on a 1.5% agarose gel (120 V constant). Run PCR #2 product on a 1.5% agarose gel (120 V constant). 13.Gel extract and ethanol precipitate each PCR product as described in step 1f in constructing the DNA barcode library and validating barcode diversity and resuspend in 15 μL nuclease-free water. Gel extract and ethanol precipitate each PCR product as described in step 1f in constructing the DNA barcode library and validating barcode diversity and resuspend in 15 μL nuclease-free water. 14.Quantify the PCR product by qPCR using the KAPA library quantification kit (Roche) as per manufacturer’s instructions. Perform qPCR (in triplicate) using 3 dilutions (1/104, 1/105 and 1/106). Quantify the PCR product by qPCR using the KAPA library quantification kit (Roche) as per manufacturer’s instructions. Perform qPCR (in triplicate) using 3 dilutions (1/104, 1/105 and 1/106). 15.Pool together each multiplexed library in equimolar ratio and sequence on the Illumina MiSeq or other sequencing platform using 2×75 bp paired-end sequencing with at least 10% PhiX spike-in. Pool together each multiplexed library in equimolar ratio and sequence on the Illumina MiSeq or other sequencing platform using 2×75 bp paired-end sequencing with at least 10% PhiX spike-in. Note: We recommend a sequencing depth of 1 million reads per experimental sample expected to contain hundreds to thousands of barcodes. For validation of the barcode library diversity, we recommend at least 10X read depth based on number of unique barcodes expected (i.e., at least 10 million reads for an expected library diversity of 1 million barcodes). CRITICAL: 10% PhiX spike-in was used on the Illumina MiSeq platform. Other sequencing platforms may require a larger amount up to 25%. It is recommended to review this requirement with your sequencing center. Preparing spike-in controls for clone size normalization Timing: 2 weeks Timing: 2 weeks This major step describes the preparation and validation of spike-in controls for multiplexed DNA amplicon sequencing.Note: Spike-in controls should be generated using a separate barcode library with a unique 4 bp library ID.16.Clone the spike-in control barcode oligonucleotides into pLARRY-EGFP as described in steps 1–3 in constructing the DNA barcode library and validating barcode diversity.17.Perform electroporation for transformation of plasmid DNA into ElectroMAX DH10B electrocompetent cells as described in steps 4a-4b in constructing the DNA barcode library and validating barcode diversity.18.Pick single colonies using a sterile pipette tip, inoculate in 5 mL of LB broth with 100 μM ampicillin and grow at 37°C for 16–20 h for expansion and plasmid DNA extraction.a.Extract plasmid DNA using the QIAGEN Plasmid Mini Kit (Qiagen) according to the manufacturer’s instructions.b.Quantify DNA concentration using the Qubit fluorometer and the Qubit 1X dsDNA high sensitivity assay kit.CRITICAL: Pick at least twice the number of colonies as the number of desired spike-in controls (i.e., if 6 controls desired, pick 12 colonies) to be able to choose the barcode clones with the greatest edit distance from each other.Pause point: Freeze DNA at −20°C until use.19.Submit an aliquot of each mini-prep product for Sanger sequencing; follow guidelines of the appropriate sequencing center for submission. Forward primer 5′-ATGACACCTACTCAGACAATGC-3′ should be used to sequence the region containing the barcode.20.From the Sanger sequencing results, identify and record the barcode sequence for each control plasmid. Looking at the chromatograph, make a note of and discard any sequences that either do not contain a barcode or contain multiple barcodes.21.Compare all retained barcode sequences and determine their average edit distance from each other. Rank the sequences by decreasing similarity and use the most diverse sequences for the spike-in controls.22.Prepare lentivirus and transduce MDA-MB-231 or an appropriate cell line of choice as described in steps 6–7 in constructing the DNA barcode library and validating barcode diversity.Note: Ensure a MOI of less than 0.1 for this step to further minimize the possibility of multiple integrations which can affect downstream data normalization and quantification steps.23.FACS sort for GFP+ transduced cells, expand in tissue culture and freeze aliquots for future use.24.FACS sort spike-in controls into a 96-well conical bottom PCR plate at different cell numbers corresponding to each control.a.To each well, add known cell numbers of each spike-in control.Note: For example, each well should have: 10 cells with control barcode 1; 20 cells with control barcode 2; 50 cells with control barcode 3; 100 cells with control barcode 4; 500 cells with control barcode 5; and 2,500 cells with control barcode 6.Pause point: Freeze plate at −20°C until ready to proceed with next steps.25.Include 3–6 spike-in control-only samples for each round of multiplexed DNA amplicon sequencing, to establish a standard curve to associate read counts from sequencing with clone size in absolute cell number.Note: These spike-in control-only samples can also be used to estimate the sensitivity and specificity of clone detection and provide a representation of the amount of noise (i.e., unexpected sequence reads) from library preparation and sequencing.26.For spike-in control-only samples, extract gDNA from the cells in each well directly and proceed with multiplexed barcode DNA amplicon sequencing as described in steps 8–15 in multiplexed barcode DNA amplicon sequencing.27.For experimental samples, use the buffer from the gDNA extraction kit to resuspend the cells.Note: Use the 1X BLUE buffer if using the prepGEM Universal DNA extraction kit (ForenteQ), or the Extraction Solution if using the PicoPure DNA extraction kit (Thermo Fisher).a.Resuspend and transfer the contents to a well containing spike-in controls to combine the experimental sample with spike-in controls.b.Proceed with gDNA extraction and multiplexed barcode DNA amplicon sequencing. Note: Spike-in controls should be generated using a separate barcode library with a unique 4 bp library ID. 16.Clone the spike-in control barcode oligonucleotides into pLARRY-EGFP as described in steps 1–3 in constructing the DNA barcode library and validating barcode diversity. Clone the spike-in control barcode oligonucleotides into pLARRY-EGFP as described in steps 1–3 in constructing the DNA barcode library and validating barcode diversity. 17.Perform electroporation for transformation of plasmid DNA into ElectroMAX DH10B electrocompetent cells as described in steps 4a-4b in constructing the DNA barcode library and validating barcode diversity. Perform electroporation for transformation of plasmid DNA into ElectroMAX DH10B electrocompetent cells as described in steps 4a-4b in constructing the DNA barcode library and validating barcode diversity. 18.Pick single colonies using a sterile pipette tip, inoculate in 5 mL of LB broth with 100 μM ampicillin and grow at 37°C for 16–20 h for expansion and plasmid DNA extraction.a.Extract plasmid DNA using the QIAGEN Plasmid Mini Kit (Qiagen) according to the manufacturer’s instructions.b.Quantify DNA concentration using the Qubit fluorometer and the Qubit 1X dsDNA high sensitivity assay kit. Pick single colonies using a sterile pipette tip, inoculate in 5 mL of LB broth with 100 μM ampicillin and grow at 37°C for 16–20 h for expansion and plasmid DNA extraction.a.Extract plasmid DNA using the QIAGEN Plasmid Mini Kit (Qiagen) according to the manufacturer’s instructions.b.Quantify DNA concentration using the Qubit fluorometer and the Qubit 1X dsDNA high sensitivity assay kit. a.Extract plasmid DNA using the QIAGEN Plasmid Mini Kit (Qiagen) according to the manufacturer’s instructions. Extract plasmid DNA using the QIAGEN Plasmid Mini Kit (Qiagen) according to the manufacturer’s instructions. b.Quantify DNA concentration using the Qubit fluorometer and the Qubit 1X dsDNA high sensitivity assay kit. Quantify DNA concentration using the Qubit fluorometer and the Qubit 1X dsDNA high sensitivity assay kit. CRITICAL: Pick at least twice the number of colonies as the number of desired spike-in controls (i.e., if 6 controls desired, pick 12 colonies) to be able to choose the barcode clones with the greatest edit distance from each other. Pause point: Freeze DNA at −20°C until use. 19.Submit an aliquot of each mini-prep product for Sanger sequencing; follow guidelines of the appropriate sequencing center for submission. Forward primer 5′-ATGACACCTACTCAGACAATGC-3′ should be used to sequence the region containing the barcode. Submit an aliquot of each mini-prep product for Sanger sequencing; follow guidelines of the appropriate sequencing center for submission. Forward primer 5′-ATGACACCTACTCAGACAATGC-3′ should be used to sequence the region containing the barcode. 20.From the Sanger sequencing results, identify and record the barcode sequence for each control plasmid. Looking at the chromatograph, make a note of and discard any sequences that either do not contain a barcode or contain multiple barcodes. From the Sanger sequencing results, identify and record the barcode sequence for each control plasmid. Looking at the chromatograph, make a note of and discard any sequences that either do not contain a barcode or contain multiple barcodes. 21.Compare all retained barcode sequences and determine their average edit distance from each other. Rank the sequences by decreasing similarity and use the most diverse sequences for the spike-in controls. Compare all retained barcode sequences and determine their average edit distance from each other. Rank the sequences by decreasing similarity and use the most diverse sequences for the spike-in controls. 22.Prepare lentivirus and transduce MDA-MB-231 or an appropriate cell line of choice as described in steps 6–7 in constructing the DNA barcode library and validating barcode diversity. Prepare lentivirus and transduce MDA-MB-231 or an appropriate cell line of choice as described in steps 6–7 in constructing the DNA barcode library and validating barcode diversity. Note: Ensure a MOI of less than 0.1 for this step to further minimize the possibility of multiple integrations which can affect downstream data normalization and quantification steps. 23.FACS sort for GFP+ transduced cells, expand in tissue culture and freeze aliquots for future use. FACS sort for GFP+ transduced cells, expand in tissue culture and freeze aliquots for future use. 24.FACS sort spike-in controls into a 96-well conical bottom PCR plate at different cell numbers corresponding to each control.a.To each well, add known cell numbers of each spike-in control. FACS sort spike-in controls into a 96-well conical bottom PCR plate at different cell numbers corresponding to each control.a.To each well, add known cell numbers of each spike-in control. a.To each well, add known cell numbers of each spike-in control. To each well, add known cell numbers of each spike-in control. Note: For example, each well should have: 10 cells with control barcode 1; 20 cells with control barcode 2; 50 cells with control barcode 3; 100 cells with control barcode 4; 500 cells with control barcode 5; and 2,500 cells with control barcode 6. Pause point: Freeze plate at −20°C until ready to proceed with next steps. 25.Include 3–6 spike-in control-only samples for each round of multiplexed DNA amplicon sequencing, to establish a standard curve to associate read counts from sequencing with clone size in absolute cell number. Include 3–6 spike-in control-only samples for each round of multiplexed DNA amplicon sequencing, to establish a standard curve to associate read counts from sequencing with clone size in absolute cell number. Note: These spike-in control-only samples can also be used to estimate the sensitivity and specificity of clone detection and provide a representation of the amount of noise (i.e., unexpected sequence reads) from library preparation and sequencing. 26.For spike-in control-only samples, extract gDNA from the cells in each well directly and proceed with multiplexed barcode DNA amplicon sequencing as described in steps 8–15 in multiplexed barcode DNA amplicon sequencing. For spike-in control-only samples, extract gDNA from the cells in each well directly and proceed with multiplexed barcode DNA amplicon sequencing as described in steps 8–15 in multiplexed barcode DNA amplicon sequencing. 27.For experimental samples, use the buffer from the gDNA extraction kit to resuspend the cells.Note: Use the 1X BLUE buffer if using the prepGEM Universal DNA extraction kit (ForenteQ), or the Extraction Solution if using the PicoPure DNA extraction kit (Thermo Fisher).a.Resuspend and transfer the contents to a well containing spike-in controls to combine the experimental sample with spike-in controls.b.Proceed with gDNA extraction and multiplexed barcode DNA amplicon sequencing. For experimental samples, use the buffer from the gDNA extraction kit to resuspend the cells.Note: Use the 1X BLUE buffer if using the prepGEM Universal DNA extraction kit (ForenteQ), or the Extraction Solution if using the PicoPure DNA extraction kit (Thermo Fisher).a.Resuspend and transfer the contents to a well containing spike-in controls to combine the experimental sample with spike-in controls.b.Proceed with gDNA extraction and multiplexed barcode DNA amplicon sequencing. Note: Use the 1X BLUE buffer if using the prepGEM Universal DNA extraction kit (ForenteQ), or the Extraction Solution if using the PicoPure DNA extraction kit (Thermo Fisher). a.Resuspend and transfer the contents to a well containing spike-in controls to combine the experimental sample with spike-in controls. Resuspend and transfer the contents to a well containing spike-in controls to combine the experimental sample with spike-in controls. b.Proceed with gDNA extraction and multiplexed barcode DNA amplicon sequencing. Proceed with gDNA extraction and multiplexed barcode DNA amplicon sequencing. Computational analysis for barcode DNA amplicon sequencing Timing: 2 days Timing: 2 days This major step describes the computational analysis steps using the code available on GitHub (https://github.com/lvnguyen-lab/Barcode-protocol/) for assigning sequence reads to each unique barcode sequence and for calculating the clone size of experimental barcode clones in absolute cell number. It is recommended to use a high-performance computing cluster environment for this analysis. Adjust the custom shell scripts to your computational environment, sequencing file names, and requisite script location. Ensure that the requisite scripts are in the correct location within your environment.28.After sequencing, computationally demultiplex the multiplexed samples into separate FASTQ files based on Illumina Unique Dual (UD) indexes as per Illumina guidelines.29.In the working directory, create a folder named “runs” and a folder named “scripts” as follows:>mkdir runs>mkdir scripts30.In the “scripts” folder, save the following files:a.Pair_amplicon_fastqs.pyb.Levenshtein.shc.Levenshtein_txt.R31.Navigate into the “runs” folder and create a folder for the current analysis, for example:>cd runs>mkdir Analysis132.Navigate into the analysis folder and create a folder named “fastq” with a subfolder named “amplicon” as follows:>cd Analysis1>mkdir -p fastq/amplicon33.Save the demultiplexed Illumina fastq files in the new “amplicon” folder.34.Edit and save the file “amplicon_analysis.sh” in the analysis folder “Analysis1” with the following information:a.The base directory for where this analysis will be run, for example:BASE_DIR=/cluster/projects/nguyengroup/scRNAseqb.The run name for this analysis (this will be a separate folder within the “runs” folder created in step 29 above), for example:RUN_NAME=Analysis1c.Indicate whether the sequencing data is paired or unpaired, for example:TYPE=pairedd.Indicate the Phred base quality score with which to filter the sequencing data. We recommend using a score of 30, as follows:QUALITY=3035.Run the script “amplicon_analysis.sh” as follows:>sbatch amplicon_analysis.sh36.This custom code is used for quality control, to trim, filter and count reads to determine the number of reads for each unique barcode sequence. Barcodes within 1 edit distance are also grouped together.a.This script will output two csv files with sequence and read count for each barcode; one with barcodes within 1 edit distance grouped together and one without grouping.b.The output path will be in the “RUN_NAME” subfolder called “Final_counts” and the naming convention of the output files will have the suffix “_post-Levenshtein.csv” for the grouped output and “pre-Levenshtein.csv” for the ungrouped output.Note: We recommend using the grouped output file to reduce noise from errors of 1 edit distance that can be generated during PCR amplification and sequencing.37.To calculate clone size in absolute cell number for each sequencing run, generate a log-log plot to associate the log (Fractional read value, FRV) with log (cell dose) using all the spike-in controls for all multiplexed samples (Figure 2).CRITICAL: There should be one plot generated per sequencing run.Note:FRV=readcountcorrespondingtoabarcodesequenceofinterestinasinglemultiplexedsamplesumofreadcountsforallspike−incontrolsinasinglemultiplexedsamplea.Using this association plot, calculate clone size for experimentally detected barcode clones (i.e., not spike-in controls) for which the read count from sequencing is known but clone size is not.CRITICAL: This step analyzes the barcode data using absolute clone size. It is not an output of the custom code and will have to be performed manually using the barcode data in the output csv files from step 36 in computational analysis for barcode DNA amplicon sequencing.Note: In the FRV formula the numerator will differ for each unique barcode sequence in the sample. The denominator will be the same for all FRV calculations within a multiplexed sample and therefore allow for normalization between multiplexed samples based on the number of reads represented by the spike-in controls added similarly to each multiplexed sample.Figure 2Clone size quantificationA plot of log10(FRV) vs. cell number to calculate absolute clone size for experimentally detected clones. Each data point represents a single spike-in control (for both spike-in control-only samples, and for experimental samples containing spike-in controls). The plot includes spike-in controls across all samples included in a single multiplexed sequencing run. The correlation equation is used to calculate the size of experimentally detected clones from the FRV. The dashed blue line indicates the correlation between log10(FRV) and cell number. The dotted red line indicates the threshold of clone detection, above which only expected spike-in controls are detected (i.e., no noise). 28.After sequencing, computationally demultiplex the multiplexed samples into separate FASTQ files based on Illumina Unique Dual (UD) indexes as per Illumina guidelines. After sequencing, computationally demultiplex the multiplexed samples into separate FASTQ files based on Illumina Unique Dual (UD) indexes as per Illumina guidelines. 29.In the working directory, create a folder named “runs” and a folder named “scripts” as follows: In the working directory, create a folder named “runs” and a folder named “scripts” as follows: >mkdir runs >mkdir scripts 30.In the “scripts” folder, save the following files:a.Pair_amplicon_fastqs.pyb.Levenshtein.shc.Levenshtein_txt.R In the “scripts” folder, save the following files:a.Pair_amplicon_fastqs.pyb.Levenshtein.shc.Levenshtein_txt.R a.Pair_amplicon_fastqs.py Pair_amplicon_fastqs.py b.Levenshtein.sh Levenshtein.sh c.Levenshtein_txt.R Levenshtein_txt.R 31.Navigate into the “runs” folder and create a folder for the current analysis, for example: Navigate into the “runs” folder and create a folder for the current analysis, for example: >cd runs >mkdir Analysis1 32.Navigate into the analysis folder and create a folder named “fastq” with a subfolder named “amplicon” as follows: Navigate into the analysis folder and create a folder named “fastq” with a subfolder named “amplicon” as follows: >cd Analysis1 >mkdir -p fastq/amplicon 33.Save the demultiplexed Illumina fastq files in the new “amplicon” folder. Save the demultiplexed Illumina fastq files in the new “amplicon” folder. 34.Edit and save the file “amplicon_analysis.sh” in the analysis folder “Analysis1” with the following information:a.The base directory for where this analysis will be run, for example:BASE_DIR=/cluster/projects/nguyengroup/scRNAseqb.The run name for this analysis (this will be a separate folder within the “runs” folder created in step 29 above), for example:RUN_NAME=Analysis1c.Indicate whether the sequencing data is paired or unpaired, for example:TYPE=pairedd.Indicate the Phred base quality score with which to filter the sequencing data. We recommend using a score of 30, as follows:QUALITY=30 Edit and save the file “amplicon_analysis.sh” in the analysis folder “Analysis1” with the following information:a.The base directory for where this analysis will be run, for example:BASE_DIR=/cluster/projects/nguyengroup/scRNAseqb.The run name for this analysis (this will be a separate folder within the “runs” folder created in step 29 above), for example:RUN_NAME=Analysis1c.Indicate whether the sequencing data is paired or unpaired, for example:TYPE=pairedd.Indicate the Phred base quality score with which to filter the sequencing data. We recommend using a score of 30, as follows:QUALITY=30 a.The base directory for where this analysis will be run, for example:BASE_DIR=/cluster/projects/nguyengroup/scRNAseq The base directory for where this analysis will be run, for example:BASE_DIR=/cluster/projects/nguyengroup/scRNAseq BASE_DIR=/cluster/projects/nguyengroup/scRNAseq b.The run name for this analysis (this will be a separate folder within the “runs” folder created in step 29 above), for example:RUN_NAME=Analysis1 The run name for this analysis (this will be a separate folder within the “runs” folder created in step 29 above), for example:RUN_NAME=Analysis1 RUN_NAME=Analysis1 c.Indicate whether the sequencing data is paired or unpaired, for example:TYPE=paired Indicate whether the sequencing data is paired or unpaired, for example:TYPE=paired TYPE=paired d.Indicate the Phred base quality score with which to filter the sequencing data. We recommend using a score of 30, as follows:QUALITY=30 Indicate the Phred base quality score with which to filter the sequencing data. We recommend using a score of 30, as follows:QUALITY=30 QUALITY=30 35.Run the script “amplicon_analysis.sh” as follows: Run the script “amplicon_analysis.sh” as follows: >sbatch amplicon_analysis.sh 36.This custom code is used for quality control, to trim, filter and count reads to determine the number of reads for each unique barcode sequence. Barcodes within 1 edit distance are also grouped together.a.This script will output two csv files with sequence and read count for each barcode; one with barcodes within 1 edit distance grouped together and one without grouping.b.The output path will be in the “RUN_NAME” subfolder called “Final_counts” and the naming convention of the output files will have the suffix “_post-Levenshtein.csv” for the grouped output and “pre-Levenshtein.csv” for the ungrouped output. This custom code is used for quality control, to trim, filter and count reads to determine the number of reads for each unique barcode sequence. Barcodes within 1 edit distance are also grouped together.a.This script will output two csv files with sequence and read count for each barcode; one with barcodes within 1 edit distance grouped together and one without grouping.b.The output path will be in the “RUN_NAME” subfolder called “Final_counts” and the naming convention of the output files will have the suffix “_post-Levenshtein.csv” for the grouped output and “pre-Levenshtein.csv” for the ungrouped output. a.This script will output two csv files with sequence and read count for each barcode; one with barcodes within 1 edit distance grouped together and one without grouping. This script will output two csv files with sequence and read count for each barcode; one with barcodes within 1 edit distance grouped together and one without grouping. b.The output path will be in the “RUN_NAME” subfolder called “Final_counts” and the naming convention of the output files will have the suffix “_post-Levenshtein.csv” for the grouped output and “pre-Levenshtein.csv” for the ungrouped output. The output path will be in the “RUN_NAME” subfolder called “Final_counts” and the naming convention of the output files will have the suffix “_post-Levenshtein.csv” for the grouped output and “pre-Levenshtein.csv” for the ungrouped output. Note: We recommend using the grouped output file to reduce noise from errors of 1 edit distance that can be generated during PCR amplification and sequencing. 37.To calculate clone size in absolute cell number for each sequencing run, generate a log-log plot to associate the log (Fractional read value, FRV) with log (cell dose) using all the spike-in controls for all multiplexed samples (Figure 2).CRITICAL: There should be one plot generated per sequencing run.Note:FRV=readcountcorrespondingtoabarcodesequenceofinterestinasinglemultiplexedsamplesumofreadcountsforallspike−incontrolsinasinglemultiplexedsamplea.Using this association plot, calculate clone size for experimentally detected barcode clones (i.e., not spike-in controls) for which the read count from sequencing is known but clone size is not.CRITICAL: This step analyzes the barcode data using absolute clone size. It is not an output of the custom code and will have to be performed manually using the barcode data in the output csv files from step 36 in computational analysis for barcode DNA amplicon sequencing.Note: In the FRV formula the numerator will differ for each unique barcode sequence in the sample. The denominator will be the same for all FRV calculations within a multiplexed sample and therefore allow for normalization between multiplexed samples based on the number of reads represented by the spike-in controls added similarly to each multiplexed sample.Figure 2Clone size quantificationA plot of log10(FRV) vs. cell number to calculate absolute clone size for experimentally detected clones. Each data point represents a single spike-in control (for both spike-in control-only samples, and for experimental samples containing spike-in controls). The plot includes spike-in controls across all samples included in a single multiplexed sequencing run. The correlation equation is used to calculate the size of experimentally detected clones from the FRV. The dashed blue line indicates the correlation between log10(FRV) and cell number. The dotted red line indicates the threshold of clone detection, above which only expected spike-in controls are detected (i.e., no noise). To calculate clone size in absolute cell number for each sequencing run, generate a log-log plot to associate the log (Fractional read value, FRV) with log (cell dose) using all the spike-in controls for all multiplexed samples (Figure 2).CRITICAL: There should be one plot generated per sequencing run.Note:FRV=readcountcorrespondingtoabarcodesequenceofinterestinasinglemultiplexedsamplesumofreadcountsforallspike−incontrolsinasinglemultiplexedsamplea.Using this association plot, calculate clone size for experimentally detected barcode clones (i.e., not spike-in controls) for which the read count from sequencing is known but clone size is not.CRITICAL: This step analyzes the barcode data using absolute clone size. It is not an output of the custom code and will have to be performed manually using the barcode data in the output csv files from step 36 in computational analysis for barcode DNA amplicon sequencing.Note: In the FRV formula the numerator will differ for each unique barcode sequence in the sample. The denominator will be the same for all FRV calculations within a multiplexed sample and therefore allow for normalization between multiplexed samples based on the number of reads represented by the spike-in controls added similarly to each multiplexed sample.Figure 2Clone size quantificationA plot of log10(FRV) vs. cell number to calculate absolute clone size for experimentally detected clones. Each data point represents a single spike-in control (for both spike-in control-only samples, and for experimental samples containing spike-in controls). The plot includes spike-in controls across all samples included in a single multiplexed sequencing run. The correlation equation is used to calculate the size of experimentally detected clones from the FRV. The dashed blue line indicates the correlation between log10(FRV) and cell number. The dotted red line indicates the threshold of clone detection, above which only expected spike-in controls are detected (i.e., no noise). CRITICAL: There should be one plot generated per sequencing run. a.Using this association plot, calculate clone size for experimentally detected barcode clones (i.e., not spike-in controls) for which the read count from sequencing is known but clone size is not.CRITICAL: This step analyzes the barcode data using absolute clone size. It is not an output of the custom code and will have to be performed manually using the barcode data in the output csv files from step 36 in computational analysis for barcode DNA amplicon sequencing.Note: In the FRV formula the numerator will differ for each unique barcode sequence in the sample. The denominator will be the same for all FRV calculations within a multiplexed sample and therefore allow for normalization between multiplexed samples based on the number of reads represented by the spike-in controls added similarly to each multiplexed sample. Using this association plot, calculate clone size for experimentally detected barcode clones (i.e., not spike-in controls) for which the read count from sequencing is known but clone size is not.CRITICAL: This step analyzes the barcode data using absolute clone size. It is not an output of the custom code and will have to be performed manually using the barcode data in the output csv files from step 36 in computational analysis for barcode DNA amplicon sequencing.Note: In the FRV formula the numerator will differ for each unique barcode sequence in the sample. The denominator will be the same for all FRV calculations within a multiplexed sample and therefore allow for normalization between multiplexed samples based on the number of reads represented by the spike-in controls added similarly to each multiplexed sample. CRITICAL: This step analyzes the barcode data using absolute clone size. It is not an output of the custom code and will have to be performed manually using the barcode data in the output csv files from step 36 in computational analysis for barcode DNA amplicon sequencing. Note: In the FRV formula the numerator will differ for each unique barcode sequence in the sample. The denominator will be the same for all FRV calculations within a multiplexed sample and therefore allow for normalization between multiplexed samples based on the number of reads represented by the spike-in controls added similarly to each multiplexed sample. Clone size quantification A plot of log10(FRV) vs. cell number to calculate absolute clone size for experimentally detected clones. Each data point represents a single spike-in control (for both spike-in control-only samples, and for experimental samples containing spike-in controls). The plot includes spike-in controls across all samples included in a single multiplexed sequencing run. The correlation equation is used to calculate the size of experimentally detected clones from the FRV. The dashed blue line indicates the correlation between log10(FRV) and cell number. The dotted red line indicates the threshold of clone detection, above which only expected spike-in controls are detected (i.e., no noise). Single-cell RNA sequencing and barcode association Timing: 2–3 days Timing: 2–3 days This major step associates the single-cell transcriptomic data with the corresponding cellular DNA barcode using the code available on GitHub (https://github.com/lvnguyen-lab/Barcode-protocol/). It is recommended to use a high-performance computing cluster environment for this analysis. Adjust the custom script to your computational environment, sequencing file names, and requisite script location. Ensure that the requisite scripts are in the correct location within your environment.38.FACS sort a single cell suspension of human tumor cells to exclude DAPI+ cells and to enrich for GFP+ barcoded cells.39.Prepare a library of sorted cells on the 10X Chromium using standard 3′ v3.1 chemistry or 3′ v3.1 HT chemistry to target recovery of 1×04 and 2×104 cells, respectively, prior to sequencing on the Illumina NovaSeq S4 flowcell targeting 2×104 reads per cell.40.Analyze scRNAseq data as per institutional protocol. Use either MetaCell8 (https://tanaylab.github.io/metacell/) or Seurat9,17 (https://satijalab.org/seurat/) for analysis to generate a single cell count matrix.41.In the “scripts” folder created in step 29 in computational analysis for barcode DNA amplicon sequencing, save the following files:a.associate_barcodes_with_10x_cells.Rb.Levenshtein.Rc.fa_csv.R42.In the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing, edit and save the “assoc_bc_steps.sh” file with the following information:a.The base directory for where this analysis will be run (this should be the same as in step 34 in computational analysis for barcode DNA amplicon sequencing), for example:BASE_DIR=/cluster/projects/nguyengroup/scRNAseqb.The run name for this analysis (this should be the same as the “RUN_NAME” in step 34 and the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing), for example:RUN_NAME=Analysis143.Create subfolders in the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing as follows:a.In the “fastq” folder created in step 32 above, create two subfolders named “raw” and “combined” as follows:>cd fastq>mkdir raw>mkdir combinedb.Navigate back to the analysis folder “Analysis1” and create a “metadata” subfolder:>cd ../>mkdir metadata44.Save all scRNAseq fastq files in the newly created “raw” folder.45.Save full cellranger output folders for each sample in the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing.46.Create a metadata csv file with information on all the samples you wish to analyze together. It should be saved in “$BASE_DIR/runs/$RUN_NAME/metadata” with the following structure:PoolBarcodeSequenceSample nameSLX-22131SITTD10ATGCGAATGG-ACAAGTGTCGXenograft1SLX-22131SITTF10CCGGCAACTG-CGGTTTAACAXenograft2CRITICAL: Ensure there is only one metadata csv file in the metadata folder. All samples for the run can be included in this one file. Also ensure that the sample names in the metadata csv file match the names of the Cell Ranger output folders.Note: “Pool” indicates the name of the sequencing batch. “Barcode” indicates the UD index used for sample multiplexing. “Sequence” are the UD index sequences. “Sample name” is the name of the sample submitted for sequencing.47.Run the custom analysis pipeline “assoc_bcs_steps.sh”. This pipeline associates barcodes with the cell ID in the single cell count matrix and includes the following steps:a.Pooling reads for each individual sample from multiple fastq files from sequencing.b.Cutadapt to trim read2 sequences based on expected constant sequences flanking the barcode and also filter for size and quality of the reads.c.Convert fastq files into csv files then tally unique read counts from csv files.d.Create fasta files from the csv files. The fasta files are used for BWA alignment of the original fastq files to the fasta reference, which provides information about cell barcode index. The output for this is a sam file which is used for associating barcode sequences with the cell ID in the single cell count matrix.>sbatch -a 1-4 assoc_bcs_steps.shNote: The “-a 1-4” component of the above command reflects a batch run with the slurm cluster system. The numbers should match the number of samples to be run, with “1-4” corresponding to samples 1 to 4 inclusive in the order of the metadata csv. To only run sample 1 the command would be “-a 1”, to run samples 2 and 4 the command would be “-a 2,4”, and to run all 4 but limit the number of concurrent jobs on the cluster to 2 the command would be “-a 1-4%2”. This script will output 2 csv files per sample. The file name with suffix “_cell_bc_umis_count.csv” contains the number of barcode reads detected in each cell ID in the single cell count matrix. The file name with suffix “_cell_GFP_umis_count.csv” contains the number of GFP reads detected in each cell ID in the single cell count matrix. These output files will be saved in the “report” folder in the working directory. 38.FACS sort a single cell suspension of human tumor cells to exclude DAPI+ cells and to enrich for GFP+ barcoded cells. FACS sort a single cell suspension of human tumor cells to exclude DAPI+ cells and to enrich for GFP+ barcoded cells. 39.Prepare a library of sorted cells on the 10X Chromium using standard 3′ v3.1 chemistry or 3′ v3.1 HT chemistry to target recovery of 1×04 and 2×104 cells, respectively, prior to sequencing on the Illumina NovaSeq S4 flowcell targeting 2×104 reads per cell. Prepare a library of sorted cells on the 10X Chromium using standard 3′ v3.1 chemistry or 3′ v3.1 HT chemistry to target recovery of 1×04 and 2×104 cells, respectively, prior to sequencing on the Illumina NovaSeq S4 flowcell targeting 2×104 reads per cell. 40.Analyze scRNAseq data as per institutional protocol. Use either MetaCell8 (https://tanaylab.github.io/metacell/) or Seurat9,17 (https://satijalab.org/seurat/) for analysis to generate a single cell count matrix. Analyze scRNAseq data as per institutional protocol. Use either MetaCell8 (https://tanaylab.github.io/metacell/) or Seurat9,17 (https://satijalab.org/seurat/) for analysis to generate a single cell count matrix. 41.In the “scripts” folder created in step 29 in computational analysis for barcode DNA amplicon sequencing, save the following files:a.associate_barcodes_with_10x_cells.Rb.Levenshtein.Rc.fa_csv.R In the “scripts” folder created in step 29 in computational analysis for barcode DNA amplicon sequencing, save the following files:a.associate_barcodes_with_10x_cells.Rb.Levenshtein.Rc.fa_csv.R a.associate_barcodes_with_10x_cells.R associate_barcodes_with_10x_cells.R b.Levenshtein.R Levenshtein.R c.fa_csv.R fa_csv.R 42.In the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing, edit and save the “assoc_bc_steps.sh” file with the following information:a.The base directory for where this analysis will be run (this should be the same as in step 34 in computational analysis for barcode DNA amplicon sequencing), for example:BASE_DIR=/cluster/projects/nguyengroup/scRNAseqb.The run name for this analysis (this should be the same as the “RUN_NAME” in step 34 and the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing), for example:RUN_NAME=Analysis1 In the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing, edit and save the “assoc_bc_steps.sh” file with the following information:a.The base directory for where this analysis will be run (this should be the same as in step 34 in computational analysis for barcode DNA amplicon sequencing), for example:BASE_DIR=/cluster/projects/nguyengroup/scRNAseqb.The run name for this analysis (this should be the same as the “RUN_NAME” in step 34 and the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing), for example:RUN_NAME=Analysis1 a.The base directory for where this analysis will be run (this should be the same as in step 34 in computational analysis for barcode DNA amplicon sequencing), for example:BASE_DIR=/cluster/projects/nguyengroup/scRNAseq The base directory for where this analysis will be run (this should be the same as in step 34 in computational analysis for barcode DNA amplicon sequencing), for example:BASE_DIR=/cluster/projects/nguyengroup/scRNAseq BASE_DIR=/cluster/projects/nguyengroup/scRNAseq b.The run name for this analysis (this should be the same as the “RUN_NAME” in step 34 and the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing), for example:RUN_NAME=Analysis1 The run name for this analysis (this should be the same as the “RUN_NAME” in step 34 and the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing), for example:RUN_NAME=Analysis1 RUN_NAME=Analysis1 43.Create subfolders in the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing as follows:a.In the “fastq” folder created in step 32 above, create two subfolders named “raw” and “combined” as follows:>cd fastq>mkdir raw>mkdir combinedb.Navigate back to the analysis folder “Analysis1” and create a “metadata” subfolder:>cd ../>mkdir metadata Create subfolders in the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing as follows:a.In the “fastq” folder created in step 32 above, create two subfolders named “raw” and “combined” as follows:>cd fastq>mkdir raw>mkdir combinedb.Navigate back to the analysis folder “Analysis1” and create a “metadata” subfolder:>cd ../>mkdir metadata a.In the “fastq” folder created in step 32 above, create two subfolders named “raw” and “combined” as follows:>cd fastq>mkdir raw>mkdir combined In the “fastq” folder created in step 32 above, create two subfolders named “raw” and “combined” as follows:>cd fastq>mkdir raw>mkdir combined >cd fastq >mkdir raw >mkdir combined b.Navigate back to the analysis folder “Analysis1” and create a “metadata” subfolder:>cd ../>mkdir metadata Navigate back to the analysis folder “Analysis1” and create a “metadata” subfolder:>cd ../>mkdir metadata >cd ../ >mkdir metadata 44.Save all scRNAseq fastq files in the newly created “raw” folder. Save all scRNAseq fastq files in the newly created “raw” folder. 45.Save full cellranger output folders for each sample in the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing. Save full cellranger output folders for each sample in the analysis folder “Analysis1” created in step 31 in computational analysis for barcode DNA amplicon sequencing. 46.Create a metadata csv file with information on all the samples you wish to analyze together. It should be saved in “$BASE_DIR/runs/$RUN_NAME/metadata” with the following structure: Create a metadata csv file with information on all the samples you wish to analyze together. It should be saved in “$BASE_DIR/runs/$RUN_NAME/metadata” with the following structure: PoolBarcodeSequenceSample nameSLX-22131SITTD10ATGCGAATGG-ACAAGTGTCGXenograft1SLX-22131SITTF10CCGGCAACTG-CGGTTTAACAXenograft2 CRITICAL: Ensure there is only one metadata csv file in the metadata folder. All samples for the run can be included in this one file. Also ensure that the sample names in the metadata csv file match the names of the Cell Ranger output folders. Note: “Pool” indicates the name of the sequencing batch. “Barcode” indicates the UD index used for sample multiplexing. “Sequence” are the UD index sequences. “Sample name” is the name of the sample submitted for sequencing. 47.Run the custom analysis pipeline “assoc_bcs_steps.sh”. This pipeline associates barcodes with the cell ID in the single cell count matrix and includes the following steps:a.Pooling reads for each individual sample from multiple fastq files from sequencing.b.Cutadapt to trim read2 sequences based on expected constant sequences flanking the barcode and also filter for size and quality of the reads.c.Convert fastq files into csv files then tally unique read counts from csv files.d.Create fasta files from the csv files. The fasta files are used for BWA alignment of the original fastq files to the fasta reference, which provides information about cell barcode index. The output for this is a sam file which is used for associating barcode sequences with the cell ID in the single cell count matrix. Run the custom analysis pipeline “assoc_bcs_steps.sh”. This pipeline associates barcodes with the cell ID in the single cell count matrix and includes the following steps:a.Pooling reads for each individual sample from multiple fastq files from sequencing.b.Cutadapt to trim read2 sequences based on expected constant sequences flanking the barcode and also filter for size and quality of the reads.c.Convert fastq files into csv files then tally unique read counts from csv files.d.Create fasta files from the csv files. The fasta files are used for BWA alignment of the original fastq files to the fasta reference, which provides information about cell barcode index. The output for this is a sam file which is used for associating barcode sequences with the cell ID in the single cell count matrix. a.Pooling reads for each individual sample from multiple fastq files from sequencing. Pooling reads for each individual sample from multiple fastq files from sequencing. b.Cutadapt to trim read2 sequences based on expected constant sequences flanking the barcode and also filter for size and quality of the reads. Cutadapt to trim read2 sequences based on expected constant sequences flanking the barcode and also filter for size and quality of the reads. c.Convert fastq files into csv files then tally unique read counts from csv files. Convert fastq files into csv files then tally unique read counts from csv files. d.Create fasta files from the csv files. The fasta files are used for BWA alignment of the original fastq files to the fasta reference, which provides information about cell barcode index. The output for this is a sam file which is used for associating barcode sequences with the cell ID in the single cell count matrix. Create fasta files from the csv files. The fasta files are used for BWA alignment of the original fastq files to the fasta reference, which provides information about cell barcode index. The output for this is a sam file which is used for associating barcode sequences with the cell ID in the single cell count matrix. >sbatch -a 1-4 assoc_bcs_steps.sh Note: The “-a 1-4” component of the above command reflects a batch run with the slurm cluster system. The numbers should match the number of samples to be run, with “1-4” corresponding to samples 1 to 4 inclusive in the order of the metadata csv. To only run sample 1 the command would be “-a 1”, to run samples 2 and 4 the command would be “-a 2,4”, and to run all 4 but limit the number of concurrent jobs on the cluster to 2 the command would be “-a 1-4%2”. This script will output 2 csv files per sample. The file name with suffix “_cell_bc_umis_count.csv” contains the number of barcode reads detected in each cell ID in the single cell count matrix. The file name with suffix “_cell_GFP_umis_count.csv” contains the number of GFP reads detected in each cell ID in the single cell count matrix. These output files will be saved in the “report” folder in the working directory. Expected outcomes The barcode design (Figure 1) has the potential to generate up to 4,194,304 unique barcodes (4N x 2S). Using a lentiviral plasmid, the barcode sequences will be permanently integrated into the genome of the cell and passed down to all subsequent progenies. From a single vial of 1 mL glycerol stock of the barcode library, approximately 30–40 μg of plasmid DNA can be extracted, but this may vary depending on the plate density as well as DNA extraction efficiency. The spike-in controls will be used as a reference point to quantify clone sizes, however, it is critical that each sample analyzed includes the spike-in controls. These controls provide a measure of sensitivity and specificity of barcode clone detection and provide a way to normalize sequence read count to calculate absolute clone sizes between different samples and sequencing runs. Computational analyses will ultimately provide transcriptomic profiles of unique clones by pairing scRNAseq data with barcode clones. Limitations To reduce the incidence of multiple barcode integrations per cell, we recommend a transduction efficiency below 30% (or MOI less than 0.3) for clonal tracking experiments. Without a period of in vitro culture to express GFP to select for transduced cells, this limits the number of clones tracked in subsequent experiments. However, by culturing first, the uniquely barcoded cells divide, and clonal outputs assayed are no longer representative of the activity from a single cell, but rather the sum of multiple cells. This can lead to different biological findings depending on the experimental context. Another limitation is the low capture efficiency inherent in scRNAseq. Barcode clones can only be associated with single cell RNA profiles where a barcode transcript is detected by sequencing. Some barcoded cells may be misclassified as non-barcoded and the clonal tracking data for those cells lost. Lastly, scRNAseq is generally limited to analysis of a few hundred to a few thousand cells per sample (after filtering low quality cells) making small clones with few barcoded cells less likely detected by scRNAseq. Troubleshooting Problem 1 Low viral titers with the pLARRY-EGFP plasmid. Potential solution Ensure that HEK293T cells are healthy and used at a low passage number. Consider obtaining a new vial of HEK293T cells from a reliable source. At the time of transfection, ensure that the cells are in log growth phase. Collect and pool the supernatant at additional time points (e.g., 24, 48 and 72 h after transfection) and concentrate the pooled viral supernatant. Concentration with ultracentrifugation may yield higher titers. Problem 2 Observing a difference in barcode diversity between aliquots of the barcode library. Potential solution Perform plasmid purification of all glycerol stocks for the DNA barcode library together and pool the plasmid to generate a single large barcode plasmid library. Perform DNA amplicon sequencing on this library that will be representative of the single pooled library rather than individual aliquots that may show variably distributed barcode representation. Problem 3 Overgrowth of colonies on large square 245 mm × 245 mm plates. Potential solution Prior to plating, test colony forming efficiency (number of colonies per volume plated) on 100 mm plates. Test different volumes such as 50 μL, 100 μL, and 200 μL. Leave plates at 37°C for 16–24 h and count the number of colonies. Calculate the surface area for each plate to determine the ideal volume for plating onto large square plates. Problem 4 HEK293T cells detach during lentivirus production. Potential solution Use healthy HEK293T cells and consider obtaining a new vial of HEK293T cells from a reliable source. Ensure cells are well-distributed at time of seeding. Consider optimizing the protocol to use solutions such as Poly-L-lysine to coat the plate prior to seeding. Problem 5 Insufficient production of ligated product after insertion of annealed barcode sequence into the double digested pLARRY-EGFP plasmid. Potential solution Replace T4 ligase with ElectroLigase (NEB) and use their recommended protocol for ligation and transformation. The same DH10B ElectroMAX electrocompetent cells can be used for transformation. Problem 6 Difficulty running the computational analysis pipeline. Potential solution We recommend running the computational analysis pipeline on a high-performance computing cluster environment with at least 180 GB memory, and 10 CPU cores, depending on the script being run. This information is included at the top of the custom scripts “amplicon_analysis.sh”, “Levenshtein.sh”, and “assoc_bcs_steps.sh”. Ensure to adjust the custom script based on rules from your local high performance computing cluster environment. Ensure that the requisite scripts are in the correct location within your environment. Ensure that the directory structure is exactly as noted and the fastq and cellranger files are where they should be. If the “Levenshtein_txt.R” script does not finish running in the time allotted by “Levenshtein.sh”, try increasing this time allotment. If the cluster environment has time limits that do not allow the script to finish, downstream analysis can be run on all barcode sequences without grouping sequences within 1 edit distance; these can be found in the “_Pre-Levenshtein.csv” amplicon output. Resource availability Lead contact Further information and requests for resources and reagents should be directed to and will be fulfilled by the lead contact, Long V. Nguyen (long.nguyen@uhn.ca). Technical contact Technical questions on executing this protocol should be directed to and will be answered by the technical contact, Long V. Nguyen (long.nguyen@uhn.ca). Materials availability All unique reagents generated in this study are available from the lead contact with a completed materials transfer agreement. Data and code availability •Custom code used for DNA amplicon sequencing and scRNAseq analysis as reported in this protocol are available on Zenodo: https://doi.org/10.5281/zenodo.17372044 and GitHub: https://github.com/lvnguyen-lab/Barcode-protocol.•Any additional information required to reanalyze the data reported in this paper is available from the lead contact upon request. •Custom code used for DNA amplicon sequencing and scRNAseq analysis as reported in this protocol are available on Zenodo: https://doi.org/10.5281/zenodo.17372044 and GitHub: https://github.com/lvnguyen-lab/Barcode-protocol. Custom code used for DNA amplicon sequencing and scRNAseq analysis as reported in this protocol are available on Zenodo: https://doi.org/10.5281/zenodo.17372044 and GitHub: https://github.com/lvnguyen-lab/Barcode-protocol. •Any additional information required to reanalyze the data reported in this paper is available from the lead contact upon request. Any additional information required to reanalyze the data reported in this paper is available from the lead contact upon request. Acknowledgments L.V.N. is a Hold’em for Life Early Career Professor in Cancer Research in the Temerty Faculty of Medicine, University of Toronto, and was supported by an ESMO Translational Research Fellowship, an ASCO Conquer Cancer Young Investigator Award, a J.P. Bickell Foundation Medical Research Grant, a MOHCCN Clinician-Scientist Award, and the Allan Slaight Breakthrough Fund at The Princess Margaret Cancer Foundation. H.J.S. is supported by an MBP Excellence UTF scholarship from the Department of Medical Biophysics, University of Toronto. S.S. is supported by a Princess Margaret Postdoctoral Fellowship from The Princess Margaret Cancer Foundation and George Knudson Memorial Fellowship Fund. S.K. is supported by a Research Training Award from the Canadian Cancer Society. The graphical abstract and figures were created using Biorender.com. Author contributions L.V.N. conceived the protocol with input from S.K. and M.C. H.J.S. prepared the figures. H.J.S., S.S., S.K., and L.V.N. wrote the manuscript. S.K. and L.V.N. prepared the custom code for analysis. All authors read and approved the manuscript. Declaration of interests The authors declare no competing interests.