Skip to content

Latest commit

History

26 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

scAED

Single Cell Active Enhancer Database (scAED)

We have developed the first active enhancer database at single‑cell resolution for both normal and disease conditions, named the Single Cell Active Enhancer Database (scAED).


Table of Contents

Overview

scAED catalogs active enhancers at single‑cell resolution across normal and disease conditions, linking enhancers, transcription factors (TFs), promoters, and target genes in an interactive R Shiny application.

Figure_1

Interface

The database is implemented as an R Shiny web application, offering:

  • Diagram view of enhancer–promoter–gene relationships
  • Data tables listing chromosomal locations, enhancer IDs, coordinates, distances to nearest genes, and bound transcription factors

scAED InterfaceFigure 1. Overview of the scAED interface.

Using the Enhancers Tab

The Enhancers tab lets you explore enhancer data with these filters:

  • Organ: e.g., Brain, Pancreas
  • State: Healthy or Diseased
  • Age: Sample age
  • Sex: Male or Female
  • Region: Genomic region
  • Output Image Format: JPG, PNG

Below the filters, set:

  • Dimensions (inches)
  • Resolution (DPI: 72–300)

Click Submit to generate plots.

a. Total Enhancer Count

  • Cell Count per Cell Type: Bar plot showing number of cells by type.
  • Enhancer Count per Cell Type: Bar plot showing number of enhancers per cell type.

Total Enhancer CountFigure 2.1: Total Enhancer Count Tool.

b. Cell Type Table

Lists cell types alongside enhancer counts. Downloadable in CSV format.

Cell Type TableFigure 2.2: Cell Type Table.

c. Enhancer Table

Select a cell type to view enhancers:

ColumnDescription
Enhancer IDe.g., En0100050273
Enhancer Namee.g., chr1_10867180_10867323
Chromosomee.g., chr1
Start / EndGenomic coordinates
% CellsPercentage of cells containing the enhancer
DirectionalityBidirectional if applicable
Gene SymbolsAffected genes with strand (e.g., RRX1(+); GORAB(+))
Cell LineExperimental cell line
Distance to GeneDistance from nearest gene
Transcription FactorBound transcription factors

Default view: 20 entries (expandable to 100). Download as CSV.

Enhancer TableFigure 2.3: Enhancer Table.

d. Overlapping Enhancers

Explore enhancers overlapping a specified genomic region by cell type and region.

Overlaps EnhancersFigure 2.4: Overlapping Enhancers.

Search Engine

The Search Engine tab provides four global search options:

a. Chromosomal Position Search

Specify chromosome, start, and end positions to retrieve enhancers.

Chromosomal Position SearchFigure 3.1: Chromosomal Position Query.

b. Gene Search

Search by gene name or ID to find associated enhancers.

Gene SearchFigure 3.2: Gene Search.

c. Transcription Factor Search

Input TF identifiers to find regulated enhancers.

Transcription Factor SearchFigure 3.3: Transcription Factor Search.

d. Enhancer ID Search

Enter unique enhancer IDs to retrieve detailed information.

Enhancer ID SearchFigure 3.4: Enhancer ID Search.

The repository includes all scripts in a clear sequential workflow, as listed below in the table:

Step (script)InputOutputPurpose
Step_1.1_Extract_BAM_AT_SC.pyPooled ATAC-seq BAM file (atac_possorted_bam.bam)Barcode text files per cell type (e.g., cell_type_name.txt)Per-barcode BAM files organized by cell typeFilters reads from pooled BAM based on barcodes to create individual per-cell BAM files.
Step_1.2_Sorting_IndeNo.shEach per-barcode BAM fileSorted BAM files (coordinate-sorted and name-sorted) with indexesUses samtools to sort and index BAM files for downstream peak calling and footprinting.
Step_2a_Genrich.shStep_2b_Genrich.shName-sorted BAM filesNarrowPeak files per cell barcodeRuns Genrich to call accessible chromatin peaks from each BAM file in parallel batches.
Step_3_Filter_narrowPeak_files.pyGenerated narrowPeak filesFiltered peak filesCleans peak files for quality or region-based filtering before footprinting.
Step_4_ATACorrect.shBAM files, peak files, genome reference, blacklist regionsCorrected bigWig signal files per barcodeUses TOBIAS ATACorrect to correct Tn5 insertion bias in ATAC-seq signals.
Step_5_ScoreBigwig.shCorrected bigWig files, narrowPeak filesFootprint score bigWig filesRuns TOBIAS FootprintScores to identify potential TF footprints in accessible regions.
Step_6_BINDetect.shFootprint score files, motif files (e.g. JASPAR), genome FASTA, peak filesBINDetect results per barcode (motif binding predictions)Uses TOBIAS BINDetect to infer motif binding activity per cell type/barcode.
Step_7.1_Renaming_bindetect_results_with_cell_name.pyBINDetect result filesRenamed results with standardized or cell-specific namesRenames outputs to include cell names for clarity in aggregation and interpretation.
Step_7.2_Find_Copy_all_bed_files_to_bound_output.shAll BINDetect output directories containing *_bound.bed filesCopies of bound.bed files in a unified output folderGathers all final predicted bound motif files for summary or visualization.
Step_7.3_Merge_ALL_bound.bed_files_into_one_named_after_the_directory.shMultiple *_bound.bed files in each BINDetect output directorySingle merged BED file per directoryConcatenates per-cell bound.bed files into one merged BED per directory.
Step_7.4_Copy_All_Merged-Bed_Files.shMerged BED files from all directoriesCopies of all merged BED files in a centralized destination directoryCollects all merged BEDs into a single folder for integration analysis.
Step_7.5_Enhancers_Intersect_with_ED.pyMerged BED files; Enhancer annotation BED file(s)Intersection result files (overlaps between predicted bound regions and enhancers)Uses bedtools intersect (contextual assumption) to identify overlaps between binding sites and known enhancers.
Step_7.6_Enhancer_Overlaps_Summary.pyIntersection output files from Step 7.5Summarized counts or tables reporting enhancer overlaps per cell/typeAggregates intersection results into summary tables for visualization or statistical interpretation.

Definition

  • atac_possorted_bam.bam: This is the pooled ATAC-seq BAM file output by the 10x Cell Ranger pipeline, containing all reads from all cells, position-sorted across the genome.
  • Barcode: A unique nucleotide sequence assigned to each cell during single-cell sequencing, enabling identification and separation of reads per cell.
  • Coordinate-sorted BAM file: BAM file sorted by genomic coordinates (chromosome and position). Necessary for downstream tools like peak callers or visualization software that require position-ordered input.
  • Name-sorted BAM file: BAM file sorted by read names instead of genomic coordinates. Required by some tools (e.g. Genrich) that operate based on read pairs or read groupings.
  • NarrowPeak files: Standard output format from peak callers (e.g. Genrich) representing regions of accessible chromatin (peaks) with associated scores and statistics.
  • Filtered peak files: NarrowPeak files that have undergone additional filtering based on quality metrics or genomic regions to remove low-confidence or irrelevant peaks.
  • Corrected bigWig signal files: Continuous signal tracks (bigWig format) produced after correcting ATAC-seq signals for Tn5 transposase insertion bias using tools like TOBIAS ATACorrect.
  • Footprint score bigWig files: bigWig files containing footprinting scores, indicating potential transcription factor (TF) binding footprints within accessible chromatin regions.
  • BINDetect results: Output from TOBIAS BINDetect containing predicted TF binding sites per motif, including bound and unbound regions along with binding scores.
  • bound.bed files: BED files listing genomic coordinates of predicted bound TF motifs, indicating where a motif is likely bound by a TF in the analyzed sample.
  • Single merged BED file: A concatenated BED file combining multiple bound.bed files within a directory to represent all predicted TF binding events for that cell type or condition.
  • Summarized counts or tables reporting enhancer overlaps: Tables that report the number of TF binding sites overlapping known enhancer regions, summarizing these intersections per cell type for further interpretation or visualization.

License

No licence

About

We have developed the first active enhancer database at single-cell resolution for both normal and disease conditions, named the Single Cell Active Enhancer Database (scAED).

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages