40264d0668926b51da94d2ca038dc7349dfc3405 markd Sat Sep 26 07:59:34 2026 -0700 Shorten the Methods sections on the two TSS data pages. refs #35528 Both read like a paper's methods section rather than a track description: 43 lines over four subsections on proCapNet, 35 on encode4ProCap. Cut each to three paragraphs, what the model or assay is, how the files we serve were produced, and where the build is recorded. The subsection headings go with it. Kept every fact a user of the track needs: the window and stride, the MANE Select limit on the contribution scores, the unresolved-sequence handling on hg38, the replicate summing, the six ENCODE accessions and the file manifest. Dropped the detail that belongs to the papers, such as the DeepSHAP scalarization and the loss weighting. The container page keeps no Methods section, which is correct for a page that only points at the two data pages. diff --git src/hg/makeDb/trackDb/human/proCapNet.html src/hg/makeDb/trackDb/human/proCapNet.html index 09390d9a4b9..b6e37bcc9ea 100644 --- src/hg/makeDb/trackDb/human/proCapNet.html +++ src/hg/makeDb/trackDb/human/proCapNet.html @@ -1,229 +1,205 @@
ProCapNet is a neural network trained to predict PRO-cap signal from DNA sequence alone. PRO-cap is a run-on assay that captures the 5' end of each nascent RNA, so it reports the exact base and strand at which RNA polymerase II started transcribing, including at enhancers and at unstable transcripts that RNA-seq and CAGE miss. Six separate models were trained, one on each of six cell lines with ENCODE PRO-cap data.
This track holds two kinds of output from those models:
The predictions are available on GRCh38/hg38 and T2T-CHM13/hs1. The contribution scores are available on GRCh38/hg38 only, because they are computed at MANE Select transcription start sites and MANE is not defined for T2T-CHM13.
Predictions are not measurements: they say what the sequence looks capable of, not what a given cell is doing. The matching experimental data is in the PRO-cap track, available on GRCh38/hg38.
Cell lines are listed in the table on this page, one row each, with a checkbox per data type. Use the Sample class facet to narrow the list, and the Group tracks by buttons to order the browser by sample or by data type.
Each predicted PRO-cap track is an overlay of the two strands: plus strand predictions are drawn upward and minus strand predictions downward. The y axis is the predicted number of PRO-cap reads at that base.
Contribution scores are drawn as a sequence logo when zoomed in far enough to show individual bases: the letter of the reference base is scaled by its score, so a run of tall letters is a motif the model relied on. At lower zoom the same values are drawn as a wiggle. Scores can be negative, meaning the base argued against initiation being placed where it was. Scores exist only in the roughly 2 kb window around each MANE Select transcription start site, about 38.7 Mb of the genome. Everywhere else the track is empty, which is not the same as a score of zero.
Read depth differs between the six PRO-cap experiments the models were trained on, and both predicted signal and contribution scores scale with it, so the y axis is not comparable between cell lines. Tracks are colored by the cell line the model was trained on:
-ProCapNet adapts the BPNet architecture. It reads 2,114 bp of one-hot encoded -sequence and outputs both a base-resolution profile over the central 1,000 bp, -covering both strands as a single softmax so the model can learn strand -asymmetry, and a scalar giving the log total number of initiation events in that -window. Training used ENCODE PRO-cap read alignments in which the first read of -each pair was discarded and only the single 5'-most base of the second read was -kept, merged across replicates and kept separate by strand. Each model was -trained on all PRO-cap peaks in its cell line plus randomly sampled -DNase-hypersensitive sites from the same cell line at a 7:1 peak to background -ratio, with 7-fold cross-validation split by chromosome. Bases that are not -uniquely mappable by 36-mer reads were given zero loss weight during training. -Full details are in Cochran et al., 2024. +ProCapNet adapts the BPNet architecture: it reads 2,114 bp of sequence and +predicts a base-resolution initiation profile over the central 1,000 bp on both +strands, together with the total number of initiation events in that window. One +model was trained per cell line on ENCODE PRO-cap data, using all PRO-cap peaks +in that cell line plus sampled DNase-hypersensitive sites as background, with +7-fold cross-validation split by chromosome. Full details are in Cochran +et al., 2024.
--Genome-wide predictions were generated by the Kundaje lab by applying the model -to every 2,114 bp window at a stride of 250 bp, so each base is the average of -four overlapping predictions, then averaging across the seven cross-validation -models and across the forward and reverse-complemented sequence. On hg38 no -prediction was made where most of a window was unresolved (N) in the reference. +The Kundaje lab generated the genome-wide predictions by applying each model in +2,114 bp windows at a stride of 250 bp, then averaging across the seven +cross-validation models and across the forward and reverse-complemented +sequence. On hg38 no prediction was made where most of a window was unresolved +(N) in the reference. Contribution scores were computed with DeepSHAP, which +contrasts the model's output on the real sequence against its output on 25 +dinucleotide shuffles of it, and were computed only at MANE Select transcription +start sites.
--Scores were computed with DeepSHAP, which estimates each base's contribution by -contrasting the model's output on the real sequence against its output on a set -of reference sequences, here 25 dinucleotide shuffles of the sequence being -scored. Because DeepSHAP needs a single scalar to explain, the base-resolution -profile output was summarized by mean-normalizing the pre-softmax logits and -taking their dot product with the post-softmax profile, which weights each -base's logit by its predicted probability of being used and sums over the -1,000 bp output window and both strands. This is the profile or TSS-positioning -task; ProCapNet can also produce scores for its read-count task, which are not -included in this track. Each scored sequence was run through all seven cross-validation -models and in both orientations, and the scores averaged. -
- -The ProCapNet model implementation is at kundajelab/ProCapNet. The steps that turned the published files into these tracks are recorded in doc/$db/transcriptionStart.txt, the scripts they run are in makeDb/outside/proCapNet, and the track configuration is in trackDb/human/$db/transcriptionStart.ra.
The data can be explored interactively in table format with the Table Browser or the Data Integrator and exported from there to spreadsheet or tab-sep tables. From scripts, the data can be accessed through our API. The API returns one bigWig at a time, so name a single strand of one cell line rather than the container, for example track=proCapNet_K562_pred_pos.
The Files column of the table on this page links each cell line's bigWigs directly, so a single file can be fetched without working out its path.
For automated download and analysis, the genome annotation is stored in bigWig files that can be downloaded from our download server. Predictions are under pred/ and are named for the cell line, the model and the strand, for example K562.proCapNet.pos.bw and K562.proCapNet.neg.bw. Contribution scores, which exist for GRCh38 only, are under contrib/, for example K562.proCapNet-contrib.bw. Individual regions or the whole genome annotation can be obtained using our tool bigWigToBedGraph, which can be compiled from the source code or downloaded as a precompiled binary for your system. Instructions for downloading source code and binaries are on the utilities download page. The tool can also be used to obtain features within a given range, e.g. bigWigToBedGraph http://hgdownload.soe.ucsc.edu/gbdb/$db/proCapNet/pred/K562.proCapNet.pos.bw -chrom=chr21 -start=0 -end=100000000 stdout
The ProCapNet models are on the ENCODE portal as BPNet-model annotations, one per cell line, linked from the Experiment column of the table on this page. Each annotation also holds the trained model, sequence contribution scores and predicted signal over a selected set of regions. The genome-wide predictions shown here are not part of that ENCODE release.
ProCapNet was developed by Kelly Cochran in the Kundaje lab at Stanford University. The genome-wide predictions and contribution scores were generated by Kelly Cochran in collaboration with the GENCODE consortium. Thanks to Kelly Cochran and Anshul Kundaje for making the data available.
Cochran K, Yin M, Mantripragada A, Schreiber J, Marinov GK, Shah SR, Yu H, Lis JT, Kundaje A. Dissecting the cis-regulatory syntax of transcription initiation with deep learning. bioRxiv. 2024 Nov 21;. DOI: 10.1101/2024.05.28.596138; PMID: 38853896; PMC: PMC11160661
Avsec Ž, Weilert M, Shrikumar A, Krueger S, Alexandari A, Dalal K, Fropf R, McAnany C, Gagneur J, Kundaje A et al. Base-resolution models of transcription-factor binding reveal soft motif syntax. Nat Genet. 2021 Mar;53(3):354-366. DOI: 10.1038/s41588-021-00782-6; PMID: 33603233; PMC: PMC8812996
Kwak H, Fuda NJ, Core LJ, Lis JT. Precise maps of RNA polymerase reveal how promoters direct initiation and pausing. Science. 2013 Feb 22;339(6122):950-3. DOI: 10.1126/science.1229386; PMID: 23430654; PMC: PMC3974810