Cell Browser best practices

Best Practices

Formatting configuration files

• Typically you should keep a maximum of 80-120 characters per line; you can use gqgq in VIM in visual mode to auto format a paragraph into multiple ~80 character lines
• For special characters, please refer to HTML character encoding: https://ascii.cl/htmlcodes.htm

cellbrowser.conf

Put things into cellbrowser-confs repo Commit cellbrowser/desc.conf files(http://genomewiki.ucsc.edu/genecats/index.php/Wrangling_process#Commit_cellbrowser.2Fdesc.conf_files)

git add dataset-name
git commit -m “message”
git push

Naming datasets

Dataset names should be all lowercase, using 4 words or less, and less than 20 characters and separated by hyphens. The names need to be lowercased because the Cell Browser (website) code converts all names lowercase. There are only a few exceptions for early datasets (e.g. adultPancreas).

Layout Coordinates

Capitalize "UMAP" and "tSNE".

Remove extra layout coordinates (e.g. PCA or Harmony) because the cbImportTools export all of the possible layouts and they export only the only the first two coordinates. The CB can only handle two coordinates and so these layouts often look like a clump of cells.

The following two images are examples of PCA plots. For reference, the first image is from the "lung-airway" dataset and the second image is from the "hoc" dataset.

Finding a paper associated with a bioRxiv pub

Sometimes you will have to go back and edit the paper citation for a dataset.

In /hive/data/inside/cells/datasets run

find . -name desc.conf | xargs grep "biorxiv" |grep -v "Strange\|\#" 

Should get results like:
./cbl-dev/desc.conf:biorxiv_url = "https://www.biorxiv.org/content/10.1101/2020.06.30.174391v1 Aldinger et al. 2020. bioRxiv." 

Copy this bit of the URL: 10.1101/2020.06.30.174391

And feed it to the bioRxiv API: curl https://api.biorxiv.org/details/biorxiv/10.1101/2020.06.30.174391

In the response, you should see the word "published" and if it's published, it'll have a doi otherwise it'll just say NA. 

This is referenced from the Cells Redmine To Do #27316.

You could also paste the DOI into doi.org.

Providing the Unit for datasets

unit=""

The unit of the values in the expression matrix. You can ask the author if needed or search the Seurat data slot "normalized". Typical values: "read count/UMI", "log of read count/UMI", "TPM", "log of TPM", "CPM", "FPKM", "RPKM".

desc.conf

title = "First word is capitalized and the rest is all lowercased"

paper_url = “http://www.paper_url.com/xxx Last name et al. Journal. Year.”

biorxiv_url = "https://www.biorxiv.org/content/123/123.full Last name et al. bioRxiv Year."

The additional database links (GSE, Bioproject, SRA accessions, PMID, etc.) can be set to just the number, no author info.

pmid = "12343234" geo_series = "GSE25097" dbgap = "phs000424.v7.p2" arrayexpress = "xxx" sra_study = "xxxx"