draft API docs for BWA and strelka

1 files changed, 24 insertions, 3 deletions

diff --git a/tools/strelka.nix b/tools/strelka.nix
index 9a8f1aa..1cf8961 100644
--- a/tools/strelka.nix
+++ b/tools/strelka.nix
@@ -4,21 +4,42 @@ with bionix;
 with types;
 
 {
+  /* Calls somatic variants
+  Type: callSomatic :: {...} -> {tumour, normal} -> somatic results
+  */
   callSomatic = callBionixE ./strelka-callSomatic.nix;
+  /* Calls variants
+  Type: call :: {...} -> [input] -> results
+  */
   call = callBionixE ./strelka-call.nix;
-  variants = drv: stage {
+  /* Extract VCF file from results
+  Type: variants :: results -> vcf
+  */
+  variants =
+    # result of call
+    drv: stage {
     name = "strelka-call-variants";
     buildCommand = ''
       ln -s ${drv}/variants/variants.vcf.gz $out
     '';
     passthru.filetype = filetype.gz (filetype.vcf {ref=ref;});
   };
-  indels = drv: stage {
+  /* Extract indels from somatic results
+  Type: indels :: somatic results -> vcf
+  */
+  indels =
+    # result of callSomatic
+    drv: stage {
     name = "strelka-callVariants-indels";
     buildCommand = "ln -s ${drv}/variants/somatic.indels.vcf.gz $out";
     passthru.filetype = filetype.gz (filetype.vcf {ref = ref;});
   };
-  snvs = drv: stage {
+  /* Extract SNVs from somatic results
+  Type: snvs :: somatic results -> vcf
+  */
+  snvs =
+    # result of callSomatic
+    drv: stage {
     name = "strelka-callVariants-snvs";
     buildCommand = "ln -s ${drv}/variants/somatic.snvs.vcf.gz $out";
     passthru.filetype = filetype.gz (filetype.vcf {ref = ref;});