sarek icon indicating copy to clipboard operation
sarek copied to clipboard

Provide typical usage of --tools

Open ameynert opened this issue 2 years ago • 8 comments

Description of feature

The regex for describing how to specify --tools is not easy to understand for non-command line users. Adding some tool combination examples for typical usage would be helpful. Also suggest specifying the exact capitalization for each tool with the tool listing, not just in the regex.

ameynert avatar Nov 16 '22 10:11 ameynert

so something like

example usage:

--tools strelka,snpeff

?

FriederikeHanssen avatar Nov 16 '22 12:11 FriederikeHanssen

Yes, just like that. Some starting point recommendations for e.g. germline vs tumour/normal, WGS or exome would also be useful.

ameynert avatar Nov 16 '22 12:11 ameynert

https://nf-co.re/sarek/3.0.2/usage#which-variant-calling-tool-is-implemented-for-which-data-type we have this table, is this sufficient? We could add a link to the help output of the parameter section. I am a bit hesitant of explicitely recommending a tool without knowing the use case tbh.

FriederikeHanssen avatar Nov 16 '22 12:11 FriederikeHanssen

How about linking to that from the help for --tools?

ameynert avatar Nov 16 '22 12:11 ameynert

:D hah yes just updated my comment. sounds like a good idea 👍

FriederikeHanssen avatar Nov 16 '22 12:11 FriederikeHanssen

Hmmm 🤔 So on the abovementioned table strelka is called "Strelka2", but one is suppose to write --tools strelka on the command line?

Similarly, the command for "GATK Haplotypecaller" is --tools haplotypecaller.

Moreover, it is not clear to me whether one needs to use the capitalization of the names of the tools on the command line as it is done on in the table, that is, the table lists, for instance, FreeBayes but should one write --tools FreeBayes on the command line? (I happen to know that --tools freebayes will work, but will --tools FreeBayes also work?)

asp8200 avatar Jan 26 '23 09:01 asp8200

we should really fix #892, that will help with the spelling of the tools

maxulysse avatar Jan 26 '23 11:01 maxulysse