FelixKrueger / Bismark

A tool to map bisulfite converted sequence reads and determine cytosine methylation states
http://felixkrueger.github.io/Bismark/
GNU General Public License v3.0
366 stars 101 forks source link

Incomplete Documentation regarding expected outputs #653

Closed VasLem closed 4 months ago

VasLem commented 4 months ago

There is nowhere in the website, or the docs, information about the output of each step. I am currently developing a pipeline and I want to know the exact output that I expect from each step. Please update the documentation.

FelixKrueger commented 4 months ago

Hmm, I am not quite sure I agree... The documentation is here: https://felixkrueger.github.io/Bismark/

And here is an example. Is there anything specific you are referring to?

Screenshot 2024-02-15 at 23 07 32
VasLem commented 4 months ago

Hi, thanks for the quick reply. Indeed there exists quite extensive documentation for the files produced by bismark_methylation_extractor, as well as the format of the bam files. However documentation is missing for the outputs of:

Given that the output filenames are pretty much constant, they should be documented somewhere. For example, bismark_genome_preparation is creates a folder Bisulfite_Genome, which then is populated by two subfolders with known names. This information resides only in the code.

FelixKrueger commented 4 months ago

I went had a look at the docs, and decided to add in a few bits and pieces (as well as update some out-of date things...).

Here are some additional notes for the output of Bismark. Here I added a new document for the options of the deduplication part. And finally fleshed out the section for the genome preparation.

Can you take a look and see if you are a bit more happy with this?

VasLem commented 4 months ago

Nice, yes, now it is clear! Thanks for the quick updates! :)

VasLem commented 4 months ago

I noticed that the output files names are also missing from here, can you update that part as well?

FelixKrueger commented 4 months ago

I have added some examples as well now. Good luck!