cwlVersion: v1.0 class: Workflow requirements: - class: SubworkflowFeatureRequirement - class: ScatterFeatureRequirement - class: StepInputExpressionRequirement - class: InlineJavascriptRequirement - class: MultipleInputFeatureRequirement inputs: # MAIN # 1 | 2 | 3 | 4 # --------------------------------------------------------------- #| indices_folder | control_file | # --------------------------------------------------------------- #| broad_peak | | # --------------------------------------------------------------- #| fastq_file_upstream | fastq_file_downstream | # --------------------------------------------------------------- indices_folder: type: Directory label: "BOWTIE indices folder" doc: "Path to BOWTIE generated indices folder" annotation_file: type: File label: "Annotation file" format: "http://edamontology.org/format_3475" doc: "Tab-separated input annotation file" genome_size: type: string label: "Effective genome size" doc: "MACS2 effective genome size: hs, mm, ce, dm or number, for example 2.7e9" chrom_length: type: File label: "Chromosome length file" format: "http://edamontology.org/format_2330" doc: "Chromosome length file" control_file: type: File? default: null label: "Control BAM file" format: "http://edamontology.org/format_2572" doc: "Control BAM file file for MACS2 peak calling" broad_peak: type: boolean label: "Callpeak broad" doc: "Set to call broad peak for MACS2" fastq_file_upstream: type: File label: "FASTQ upstream input file" format: "http://edamontology.org/format_1930" doc: "Upstream reads data in a FASTQ format, received after paired end sequencing" fastq_file_downstream: type: File label: "FASTQ downstream input file" format: "http://edamontology.org/format_1930" doc: "Downstream reads data in a FASTQ format, received after paired end sequencing" # ADVANCED # 1 | 2 | 3 | 4 # --------------------------------------------------------------- #| exp_fragment_size | force_fragment_size | # --------------------------------------------------------------- #| clip_3p_end | clip_5p_end | # --------------------------------------------------------------- #| remove_duplicates | | # --------------------------------------------------------------- exp_fragment_size: type: int? default: 150 label: "Expected fragment size" doc: "Expected fragment size for MACS2" force_fragment_size: type: boolean? default: false label: "Force fragment size" doc: "Force MACS2 to use exp_fragment_size" clip_3p_end: type: int? default: 0 label: "Clip from 3p end" doc: "Number of bases to clip from the 3p end" clip_5p_end: type: int? default: 0 label: "Clip from 5p end" doc: "Number of bases to clip from the 5p end" remove_duplicates: type: boolean? default: false label: "Remove duplicates" doc: "Calls samtools rmdup to remove duplicates from sortesd BAM file" # SYSTEM DEPENDENT threads: type: int? default: 2 doc: "Number of threads for those steps that support multithreading" label: "Number of threads" outputs: bigwig: type: File format: "http://edamontology.org/format_3006" label: "BigWig file" doc: "Generated BigWig file" outputSource: bam_to_bigwig/bigwig_file fastx_statistics_upstream: type: File label: "FASTQ upstream statistics" format: "http://edamontology.org/format_2330" doc: "fastx_quality_stats generated upstream FASTQ quality statistics file" outputSource: fastx_quality_stats_upstream/statistics_file fastx_statistics_downstream: type: File label: "FASTQ downstream statistics" format: "http://edamontology.org/format_2330" doc: "fastx_quality_stats generated downstream FASTQ quality statistics file" outputSource: fastx_quality_stats_downstream/statistics_file bowtie_log: type: File label: "BOWTIE alignment log" format: "http://edamontology.org/format_2330" doc: "BOWTIE generated alignment log" outputSource: bowtie_aligner/log_file iaintersect_log: type: File label: "Island intersect log" format: "http://edamontology.org/format_3475" doc: "Iaintersect generated log" outputSource: island_intersect/log_file iaintersect_result: type: File label: "Island intersect results" format: "http://edamontology.org/format_3475" doc: "Iaintersect generated results" outputSource: island_intersect/result_file atdp_log: type: File label: "ATDP log" format: "http://edamontology.org/format_3475" doc: "Average Tag Density generated log" outputSource: average_tag_density/log_file atdp_result: type: File label: "ATDP results" format: "http://edamontology.org/format_3475" doc: "Average Tag Density generated results" outputSource: average_tag_density/result_file samtools_rmdup_log: type: File label: "Remove duplicates log" format: "http://edamontology.org/format_2330" doc: "Samtools rmdup generated log" outputSource: samtools_rmdup/rmdup_log bambai_pair: type: File format: "http://edamontology.org/format_2572" label: "Coordinate sorted BAM alignment file (+index BAI)" doc: "Coordinate sorted BAM file and BAI index file" outputSource: samtools_sort_index_after_rmdup/bam_bai_pair macs2_called_peaks: type: File? label: "Called peaks" format: "http://edamontology.org/format_3468" doc: "XLS file to include information about called peaks" outputSource: macs2_callpeak/peak_xls_file macs2_narrow_peaks: type: File? label: "Narrow peaks" format: "http://edamontology.org/format_3613" doc: "Contains the peak locations together with peak summit, pvalue and qvalue" outputSource: macs2_callpeak/narrow_peak_file macs2_broad_peaks: type: File? label: "Broad peaks" format: "http://edamontology.org/format_3614" doc: "Contains the peak locations together with peak summit, pvalue and qvalue" outputSource: macs2_callpeak/broad_peak_file macs2_peak_summits: type: File? label: "Peak summits" format: "http://edamontology.org/format_3003" doc: "Contains the peak summits locations for every peaks" outputSource: macs2_callpeak/peak_summits_file macs2_moder_r: type: File? label: "MACS2 generated R script" format: "http://edamontology.org/format_2330" doc: "R script to produce a PDF image about the model based on your data" outputSource: macs2_callpeak/moder_r_file macs2_gapped_peak: type: File? label: "Gapped peak" format: "http://edamontology.org/format_3586" doc: "Contains both the broad region and narrow peaks" outputSource: macs2_callpeak/gapped_peak_file macs2_log: type: File? label: "MACS2 log" format: "http://edamontology.org/format_2330" doc: "MACS2 output log" outputSource: macs2_callpeak/macs_log get_stat_log: type: File? label: "Bowtie & Samtools Rmdup combined log" format: "http://edamontology.org/format_2330" doc: "Processed and combined Bowtie aligner and Samtools rmdup log" outputSource: get_stat/output_file get_stat_formatted_log: type: File? label: "Bowtie & Samtools Rmdup combined formatted log" format: "http://edamontology.org/format_3475" doc: "Processed and combined Bowtie aligner and Samtools rmdup formatted log" outputSource: get_stat/formatted_output_file macs2_fragment_stat: type: File? label: "FRAGMENT, FRAGMENTE, ISLANDS" format: "http://edamontology.org/format_2330" doc: "fragment, calculated fragment, islands count from MACS2 results" outputSource: macs2_callpeak/macs2_stat_file preseq_estimates: type: File? label: "Preseq estimates" format: "http://edamontology.org/format_3475" doc: "Preseq estimated results" outputSource: preseq/estimates_file steps: extract_fastq_upstream: run: ../tools/extract-fastq.cwl in: compressed_file: fastq_file_upstream out: [fastq_file] extract_fastq_downstream: run: ../tools/extract-fastq.cwl in: compressed_file: fastq_file_downstream out: [fastq_file] fastx_quality_stats_upstream: run: ../tools/fastx-quality-stats.cwl in: input_file: extract_fastq_upstream/fastq_file out: [statistics_file] fastx_quality_stats_downstream: run: ../tools/fastx-quality-stats.cwl in: input_file: extract_fastq_downstream/fastq_file out: [statistics_file] bowtie_aligner: run: ../tools/bowtie-alignreads.cwl in: upstream_filelist: extract_fastq_upstream/fastq_file downstream_filelist: extract_fastq_downstream/fastq_file indices_folder: indices_folder clip_3p_end: clip_3p_end clip_5p_end: clip_5p_end v: default: 3 m: default: 1 best: default: true strata: default: true sam: default: true threads: threads q: default: true X: default: 2000 out: [sam_file, log_file] samtools_sort_index: run: ../tools/samtools-sort-index.cwl in: sort_input: bowtie_aligner/sam_file threads: threads out: [bam_bai_pair] preseq: run: ../tools/preseq-lc-extrap.cwl in: bam_file: samtools_sort_index/bam_bai_pair pe_mode: default: true out: [estimates_file] samtools_rmdup: run: ../tools/samtools-rmdup.cwl in: trigger: remove_duplicates bam_file: samtools_sort_index/bam_bai_pair out: [rmdup_output, rmdup_log] samtools_sort_index_after_rmdup: run: ../tools/samtools-sort-index.cwl in: trigger: remove_duplicates sort_input: samtools_rmdup/rmdup_output threads: threads out: [bam_bai_pair] macs2_callpeak: run: ../tools/macs2-callpeak-biowardrobe-only.cwl in: treatment_file: samtools_sort_index_after_rmdup/bam_bai_pair control_file: control_file nolambda: source: control_file valueFrom: $(!self) genome_size: genome_size mfold: default: "4 40" verbose: default: 3 nomodel: force_fragment_size extsize: exp_fragment_size bw: exp_fragment_size broad: broad_peak call_summits: source: broad_peak valueFrom: $(!self) keep_dup: default: auto q_value: default: 0.05 format_mode: default: BAMPE buffer_size: default: 10000 out: - peak_xls_file - narrow_peak_file - peak_summits_file - broad_peak_file - moder_r_file - gapped_peak_file - treat_pileup_bdg_file - control_lambda_bdg_file - macs_log - macs2_stat_file - macs2_fragments_calculated bam_to_bigwig: run: ../tools/bam-bedgraph-bigwig.cwl in: bam_file: samtools_sort_index_after_rmdup/bam_bai_pair chrom_length_file: chrom_length mapped_reads_number: get_stat/mapped_reads pairchip: default: true out: [bigwig_file] get_stat: run: ../tools/python-get-stat-chipseq.cwl in: bowtie_log: bowtie_aligner/log_file rmdup_log: samtools_rmdup/rmdup_log out: - output_file - mapped_reads - formatted_output_file island_intersect: run: ../tools/iaintersect.cwl in: input_filename: macs2_callpeak/peak_xls_file annotation_filename: annotation_file promoter_bp: default: 1000 out: [result_file, log_file] average_tag_density: run: ../tools/atdp.cwl in: input_file: samtools_sort_index_after_rmdup/bam_bai_pair annotation_filename: annotation_file fragmentsize_bp: macs2_callpeak/macs2_fragments_calculated avd_window_bp: default: 5000 avd_smooth_bp: default: 50 ignore_chr: default: chrM double_chr: default: "chrX chrY" avd_heat_window_bp: default: 200 mapped_reads: get_stat/mapped_reads out: [result_file, log_file] $namespaces: s: http://schema.org/ $schemas: - https://github.com/schemaorg/schemaorg/raw/main/data/releases/11.01/schemaorg-current-http.rdf s:name: "chipseq-pe" s:downloadUrl: https://github.com/Barski-lab/workflows/blob/master/workflows/chipseq-pe.cwl s:codeRepository: https://github.com/Barski-lab/workflows s:license: http://www.apache.org/licenses/LICENSE-2.0 s:isPartOf: class: s:CreativeWork s:name: Common Workflow Language s:url: http://commonwl.org/ s:creator: - class: s:Organization s:legalName: "Cincinnati Children's Hospital Medical Center" s:location: - class: s:PostalAddress s:addressCountry: "USA" s:addressLocality: "Cincinnati" s:addressRegion: "OH" s:postalCode: "45229" s:streetAddress: "3333 Burnet Ave" s:telephone: "+1(513)636-4200" s:logo: "https://www.cincinnatichildrens.org/-/media/cincinnati%20childrens/global%20shared/childrens-logo-new.png" s:department: - class: s:Organization s:legalName: "Allergy and Immunology" s:department: - class: s:Organization s:legalName: "Barski Research Lab" s:member: - class: s:Person s:name: Michael Kotliar s:email: mailto:michael.kotliar@cchmc.org s:sameAs: - id: http://orcid.org/0000-0002-6486-3898 doc: > Runs ChIP-Seq BioWardrobe basic analysis with paired-end input data files. s:about: | Runs ChIP-Seq BioWardrobe basic analysis with paired-end input data (upstream and downstream FASTQ file). In outputs it returns coordinate sorted BAM file alongside with index BAI file, quality statistics for both the input FASTQ files, reads coverage in a form of BigWig file, peaks calling data in a form of narrowPeak or broadPeak files, islands with the assigned nearest genes and region type, data for average tag density plot (on the base of BAM file). Workflow starts with running fastx_quality_stats (steps fastx_quality_stats_upstream and fastx_quality_stats_downstream) from FASTX-Toolkit to calculate quality statistics for both upstream and downstream input FASTQ files. At the same time Bowtie is used to align reads from input FASTQ files to reference genome (Step bowtie_aligner). The output of this step is unsorted SAM file which is being sorted and indexed by samtools sort and samtools index (Step samtools_sort_index). Depending on workflow’s input parameters indexed and sorted BAM file could be processed by samtools rmdup (Step samtools_rmdup) to remove all possible read duplicates. In a case when removing duplicates is not necessary the step returns original input BAM and BAI files without any processing. If the duplicates were removed the following step (Step samtools_sort_index_after_rmdup) reruns samtools sort and samtools index with BAM and BAI files, if not - the step returns original unchanged input files. Right after that macs2 callpeak performs peak calling (Step macs2_callpeak). On the base of returned outputs the next step (Step macs2_island_count) calculates the number of islands and estimated fragment size. If the last one is less that 80 (hardcoded in a workflow) macs2 callpeak is rerun again with forced fixed fragment size value (Step macs2_callpeak_forced). If at the very beginning it was set in workflow input parameters to force run peak calling with fixed fragment size, this step is skipped and the original peak calling results are saved. In the next step workflow again calculates the number of islands and estimated fragment size (Step macs2_island_count_forced) for the data obtained from macs2_callpeak_forced step. If the last one was skipped the results from macs2_island_count_forced step are equal to the ones obtained from macs2_island_count step. Next step (Step macs2_stat) is used to define which of the islands and estimated fragment size should be used in workflow output: either from macs2_island_count step or from macs2_island_count_forced step. If input trigger of this step is set to True it means that macs2_callpeak_forced step was run and it returned different from macs2_callpeak step results, so macs2_stat step should return [fragments_new, fragments_old, islands_new], if trigger is False the step returns [fragments_old, fragments_old, islands_old], where sufix "old" defines results obtained from macs2_island_count step and sufix "new" - from macs2_island_count_forced step. The following two steps (Step bamtools_stats and bam_to_bigwig) are used to calculate coverage on the base of input BAM file and save it in BigWig format. For that purpose bamtools stats returns the number of mapped reads number which is then used as scaling factor by bedtools genomecov when it performs coverage calculation and saves it in BED format. The last one is then being sorted and converted to BigWig format by bedGraphToBigWig tool from UCSC utilities. Step get_stat is used to return a text file with statistics in a form of [TOTAL, ALIGNED, SUPRESSED, USED] reads count. Step island_intersect assigns genes and regions to the islands obtained from macs2_callpeak_forced. Step average_tag_density is used to calculate data for average tag density plot on the base of BAM file.