浏览代码

first commit

master
chenqingwang 3 年前
当前提交
e96b348706
共有 5 个文件被更改,包括 163 次插入0 次删除
  1. +7
    -0
      defaults
  2. +8
    -0
      inputs
  3. +99
    -0
      readme.md
  4. +29
    -0
      tasks/fastq_screen.wdl
  5. +20
    -0
      workflow.wdl

+ 7
- 0
defaults 查看文件

@@ -0,0 +1,7 @@
{
"cluster_config": "OnDemand bcs.a2.large img-ubuntu-vpc",
"ref_dir": "oss://pgx-reference-data/fastq_screen_reference/",
"fastq_screen_conf": "oss://pgx-reference-data/fastq_screen_reference/fastq_screen.conf",
"disk_size": "300",
"docker": "registry.cn-shanghai.aliyuncs.com/pgx-docker-registry/fastqscreen:0.12.0"
}

+ 8
- 0
inputs 查看文件

@@ -0,0 +1,8 @@
{
"{{ project_name }}.cluster_config": "{{ cluster_config }}",
"{{ project_name }}.ref_dir": "{{ ref_dir }}",
"{{ project_name }}.fastq_screen_conf": "{{ fastq_screen_conf }}",
"{{ project_name }}.read": "{{ read }}",
"{{ project_name }}.disk_size": "{{ disk_size }}",
"{{ project_name }}.docker": "{{ docker }}"
}

+ 99
- 0
readme.md 查看文件

@@ -0,0 +1,99 @@
> Author : Zhihui Li, Qingwang Chen
>
> E-mail:[18210700119@fudan.edu.cn](mailto:18210700119@fudan.edu.cn), [20110700030@fudan.edu.cn](mailto:20110700030@fudan.edu.cn)
>
> Git: <http://choppy.3steps.cn/lizhihui/fastqscreen.git>
>
> Last Updates: 24/12/2021

## 简介

FastQ Screen是通过定量比对到一组参考基因组上的reads比例,验证DNA样品来源的工具。它把把常见的基因组建个索引,然后逐个比对,哪个比对最高,就是哪个污染。当需要确认来源基因组时,需要针对多个基因组进行比对。它通过定量比对到一组参考基因组上的reads比例,验证DNA样品来源的工具。FastQ Screen旨在常规地用作一种质量控制措施和分析DNA来源不确定或具有多种来源的样品。针对多个基因组进行比对对检测污染或鉴定样品互换也是有用的,若不检测,可能导致错误的实验结果。`fastqscreen`是用于 [Choppy-pipe](http://choppy.3steps.cn/) 系统使用的 APP。

## 快速安装及使用

#### Requirements

- Choppy
- Ali-Cloud
- Linux

在终端中输入以下命令即可快速安装本APP。

```bash
# 激活choppy环境
$ source activate choppy (open-choppy-env)

# 第一次安装
$ choppy install chenqingwang/fastqscreen
# 非第一次安装
$ choppy install chenqingwang/fastqscreen -f

# 查询已安装APP
$ choppy apps
```

#### Quick Start

```bash
# 准备 samples.csv 文件
$ choppy samples chenqingwang/fastqscreen-latest > samples.csv
# 准备无默认参数的samples.csv 文件
choppy samples --no-default chenqingwang/fastqscreen-latest > samples.csv

# 提交任务
$ choppy batch chenqingwang/fastqscreen-latest samples.csv -p Your_project_name -l Your_label

# 查询任务运行状况
$ choppy query -L Your_label | grep "status"

# 查询失败任务
$ choppy search -s Failed -p Your_project_name -u chenqingwang --short-format

# 结果文件地址
$ oss://choppy-cromwell-result/test-choppy/Your_project_name/
```



### 任务输出

任务成功结束后,便可以在阿里云相应的OSS端生成相应的结果文件。包括测序原始数据对多个基因组进行比对产生的包含来源基因组信息的`html`、`png`、`txt`文件。

## APP流程概述

​ FastQ Screen把常见的基因组建个索引,然后逐个比对,哪个比对最高,就是哪个污染。是高通量测序分析中常见的工具,用于评估样品是否被其他物种污染,常见的有支原体污染,接头污染等,一般会整合到分析流程中,作为质控的一部分。

## 输出文件说明

运行APP后,

每个sample对应一个文件夹,内部结构如下:

- call-fastq_screen

- <sample_id>_screen.html

- <sample_id>_screen.png

- <sample_id>_screen.txt


## 软件版本及参数

### 软件版本

fastqscreen: 0.12.0


### 使用参数

1. disk_size: 300
2. fastq_screen_reference: oss://pgx-reference-data/fastq_screen_reference/
3. cluster_config: OnDemand bcs.a2.large img-ubuntu-vpc


## 参考文献

[1] Wingett SW and Andrews S. FastQ Screen: A tool for multi-genome mapping and quality control [version 2; peer review: 4 approved]. F1000Research 2018, 7:1338 (https://doi.org/10.12688/f1000research.15931.2)

+ 29
- 0
tasks/fastq_screen.wdl 查看文件

@@ -0,0 +1,29 @@
task fastq_screen {
File read
File ref_dir
File fastq_screen_conf
String docker
String cluster_config
String disk_size

command <<<
set -o pipefail
set -e
nt=$(nproc)
mkdir -p /cromwell_root/tmp
cp -r ${ref_dir} /cromwell_root/tmp/
fastq_screen --aligner bowtie2 --conf ${fastq_screen_conf} --threads $nt --outdir ./ ${read}
>>>

runtime {
docker:docker
cluster: cluster_config
systemDisk: "cloud_ssd 40"
dataDisk: "cloud_ssd " + disk_size + " /cromwell_root/"
}
output {
File png = sub(basename(read), "\\.(fastq|fq)\\.gz$", "_screen.html")
File txt = sub(basename(read), "\\.(fastq|fq)\\.gz$", "_screen.png")
File html = sub(basename(read), "\\.(fastq|fq)\\.gz$", "_screen.txt")
}
}

+ 20
- 0
workflow.wdl 查看文件

@@ -0,0 +1,20 @@
import "./tasks/fastq_screen.wdl" as fastq_screen

workflow {{ project_name }} {
File read
File ref_dir
File fastq_screen_conf
String docker
String cluster_config
String disk_size

call fastq_screen.fastq_screen as fastq_screen {
input:
read=read,
ref_dir=ref_dir,
fastq_screen_conf=fastq_screen_conf,
docker=docker,
disk_size=disk_size,
cluster_config=cluster_config
}
}

正在加载...
取消
保存