# HG changeset patch # User pjbriggs # Date 1429695246 14400 # Node ID 82df5af2995fc0ad4f67170d96afa6a5af578ad5 # Parent 695d61decd06afcb9ce14a4db4c8606608f53c91 Renamed from "ceasbw..." to "ceas...". diff -r 695d61decd06 -r 82df5af2995f README.markdown --- a/README.markdown Tue Apr 21 10:56:47 2015 -0400 +++ b/README.markdown Wed Apr 22 05:34:06 2015 -0400 @@ -1,18 +1,22 @@ -CEASbw -====== +CEAS +==== -XML and wrapper script for the Cistrome version of the CEAS package, which can be -used to annotate intervals and scores with genome features. +XML and wrapper script for the CEAS package, which can be used to annotate intervals +and scores with genome features. -In addition to the `ceas` program, the Cistrome version of the package includes the -`ceasBW` program which can handle +This tool uses the Cistrome version of the package, which provides two versions of +the `ceas` program: in addition to the `ceas` program (the same as that available +from the main CEAS website), it also includes the `ceasBW` program (which can handle +bigwig input). The tool assumes that the `ceas` and `ceasBW` programs are on the Galaxy user's -path. The official CEAS website is at +path. + +The official CEAS website is at: -the Cistrome version can be found via +The Cistrome version can be found via diff -r 695d61decd06 -r 82df5af2995f ceas_wrapper.sh --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/ceas_wrapper.sh Wed Apr 22 05:34:06 2015 -0400 @@ -0,0 +1,90 @@ +#!/bin/sh -e +# +# Wrapper script to run CEAS as a Galaxy tool +# +# This runs the Cistrome versions of CEAS, which provides two executables: +# - ceas (same as the "official" version) +# - ceasBW (modified version that accepts a bigwig file as input) +# +# Usage: ceas_wrapper.sh $BED_IN $GDB_IN $EXTRA_BED_IN $LOG_OUT $PDF_OUT $XLS_OUT $DBKEY +# +# Process command line +echo $* +BED_IN=$1 +GDB_IN=$2 +EXTRA_BED_IN=$3 +LOG_OUT=$4 +PDF_OUT=$5 +XLS_OUT=$6 +# +# Collect remaining args +CEAS=ceas +OPTIONS= +while [ ! -z "$7" ] ; do + if [ "$7" == "--bigwig" ] ; then + CEAS=ceasBW + fi + if [ "$7" == "--length" ] ; then + chrom_sizes=$8 + if [ ! -f "$chrom_sizes" ] ; then + echo "ERROR no file $chrom_sizes" >&2 + echo "Please update your Galaxy instance to include this file" + exit 1 + fi + fi + OPTIONS="$OPTIONS $7" + shift +done +# +# Convenience variables for local files +base_name="ceas" +log_file=${base_name}.log +r_script=${base_name}.R +pdf_report=${base_name}.pdf +xls_file=${base_name}.xls +# +# Get CEAS version +echo Running $CEAS +$CEAS --version >$log_file 2>/dev/null +# +# Construct and run CEAS command line +ceas_cmd="$CEAS --name $base_name $OPTIONS -g $GDB_IN -b $BED_IN" +if [ "$EXTRA_BED_IN" != "None" ] ; then + ceas_cmd="$ceas_cmd -e $EXTRA_BED_IN" +fi +echo "Running $ceas_cmd" +$ceas_cmd >>$log_file 2>&1 +# +# Move outputs to final destination +if [ -e $log_file ] ; then + echo "Moving $log_file to $LOG_OUT" + /bin/mv $log_file $LOG_OUT +else + echo ERROR failed to make log file >&2 + exit 1 +fi +if [ -e $xls_file ] ; then + echo "Moving $xls_file to $XLS_OUT" + /bin/mv $xls_file $XLS_OUT +else + echo ERROR failed to generate XLS file >&2 + exit 1 +fi +# +# Run the R script to generate the PDF report +if [ -e $r_script ] ; then + echo "Running $r_script to generate $pdf_report" + R --vanilla < $r_script + if [ -e $pdf_report ] ; then + echo "Moving $xls_file to $XLS_OUT" + /bin/mv $pdf_report $PDF_OUT + else + echo ERROR failed to generate PDF report >&2 + exit 1 + fi +else + echo ERROR no R script to generate PDF report >&2 + exit 1 +fi +# +# Done diff -r 695d61decd06 -r 82df5af2995f ceas_wrapper.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/ceas_wrapper.xml Wed Apr 22 05:34:06 2015 -0400 @@ -0,0 +1,74 @@ + + + python_mysqldb + bx_python + cistrome_ceas + R + + Annotate intervals and scores with genome features + ceas_wrapper.sh $bed_file $gdb_file $extra_bed_file $log_output $pdf_report $xls_output + #if (str($wig_file.ext) == 'bigwig') + --bigwig $wig_file + --length $GALAXY_DATA_INDEX_DIR/shared/ucsc/chrom/${bed_file.dbkey}.len + # else + --wig $wig_file + #end if + #if (str($span) and int(str($span)) > 0) + --span $span + #end if + --sizes $sizes_lower,$sizes_middle,$sizes_upper + --bisizes $bisizes_lower,$bisizes_upper + --pf-res $profiling_resolution + --rel-dist $relative_distance + + + + + + + + + + + + + + + + + + + + + + + + + +**What it does** + +CEAS (Cis-regulatory Element Annotation System) is a tool for characterizing genome-wide +protein-DNA interaction patterns from ChIP-chip and ChIP-Seq of both sharp and broad +binding factors. It provides statistics on ChIP enrichment at important genome features +such as specific chromosome, promoters, gene bodies, or exons, and infers genes most +likely to be regulated by a binding factor. + +CEAS also enables biologists to visualize the average ChIP enrichment signals over +specific genomic features, allowing continuous and broad ChIP enrichment to be perceived +which might be too subtle to detect from ChIP peaks alone. + +This tool is compatible with the ceasBW version of CEAS from the Cistrome package +obtained from + +https://bitbucket.org/cistrome/cistrome-applications-harvard/overview + +(commit id d8c0751, datestamp 20140929). The CEAS code is under the +published-packages/CEAS/ subdirectory. + +Cistrome data files and documentation can be found at + +http://liulab.dfci.harvard.edu/CEAS/index.html + +The CEAS user manual is available at http://liulab.dfci.harvard.edu/CEAS/usermanual.html + + diff -r 695d61decd06 -r 82df5af2995f ceasbw_wrapper.sh --- a/ceasbw_wrapper.sh Tue Apr 21 10:56:47 2015 -0400 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,85 +0,0 @@ -#!/bin/sh -e -# -# Wrapper script to run CEASbw as a Galaxy tool -# -# Usage: ceasbw_wrapper.sh $BED_IN $GDB_IN $EXTRA_BED_IN $LOG_OUT $PDF_OUT $XLS_OUT $DBKEY -# -# Process command line -echo $* -BED_IN=$1 -GDB_IN=$2 -EXTRA_BED_IN=$3 -LOG_OUT=$4 -PDF_OUT=$5 -XLS_OUT=$6 -# -# Collect remaining args -CEAS=ceas -OPTIONS= -while [ ! -z "$7" ] ; do - if [ "$7" == "--bigwig" ] ; then - CEAS=ceasBW - fi - if [ "$7" == "--length" ] ; then - chrom_sizes=$8 - if [ ! -f "$chrom_sizes" ] ; then - echo "ERROR no file $chrom_sizes, stopping" >&2 - exit 1 - fi - fi - OPTIONS="$OPTIONS $7" - shift -done -# -# Convenience variables for local files -base_name="ceas" -log_file=${base_name}.log -r_script=${base_name}.R -pdf_report=${base_name}.pdf -xls_file=${base_name}.xls -# -# Get CEAS version -echo Running $CEAS -$CEAS --version >$log_file 2>/dev/null -# -# Construct and run CEAS command line -ceas_cmd="$CEAS --name $base_name $OPTIONS -g $GDB_IN -b $BED_IN" -if [ "$EXTRA_BED_IN" != "None" ] ; then - ceas_cmd="$ceas_cmd -e $EXTRA_BED_IN" -fi -echo "Running $ceas_cmd" -$ceas_cmd >>$log_file 2>&1 -# -# Move outputs to final destination -if [ -e $log_file ] ; then - echo "Moving $log_file to $LOG_OUT" - /bin/mv $log_file $LOG_OUT -else - echo ERROR failed to make log file >&2 - exit 1 -fi -if [ -e $xls_file ] ; then - echo "Moving $xls_file to $XLS_OUT" - /bin/mv $xls_file $XLS_OUT -else - echo ERROR failed to generate XLS file >&2 - exit 1 -fi -# -# Run the R script to generate the PDF report -if [ -e $r_script ] ; then - echo "Running $r_script to generate $pdf_report" - R --vanilla < $r_script - if [ -e $pdf_report ] ; then - echo "Moving $xls_file to $XLS_OUT" - /bin/mv $pdf_report $PDF_OUT - else - echo ERROR failed to generate PDF report >&2 - exit 1 - fi -else - echo ERROR no R script to generate PDF report >&2 - exit 1 -fi -# -# Done diff -r 695d61decd06 -r 82df5af2995f ceasbw_wrapper.xml --- a/ceasbw_wrapper.xml Tue Apr 21 10:56:47 2015 -0400 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,74 +0,0 @@ - - - python_mysqldb - bx_python - cistrome_ceas - R - - Annotate intervals and scores with genome features (cistrome CEAS) - ceasbw_wrapper.sh $bed_file $gdb_file $extra_bed_file $log_output $pdf_report $xls_output - #if (str($wig_file.ext) == 'bigwig') - --bigwig $wig_file - --length $GALAXY_DATA_INDEX_DIR/shared/ucsc/chrom/${bed_file.dbkey}.len - # else - --wig $wig_file - #end if - #if (str($span) and int(str($span)) > 0) - --span $span - #end if - --sizes $sizes_lower,$sizes_middle,$sizes_upper - --bisizes $bisizes_lower,$bisizes_upper - --pf-res $profiling_resolution - --rel-dist $relative_distance - - - - - - - - - - - - - - - - - - - - - - - - - -**What it does** - -CEAS (Cis-regulatory Element Annotation System) is a tool for characterizing genome-wide -protein-DNA interaction patterns from ChIP-chip and ChIP-Seq of both sharp and broad -binding factors. It provides statistics on ChIP enrichment at important genome features -such as specific chromosome, promoters, gene bodies, or exons, and infers genes most -likely to be regulated by a binding factor. - -CEAS also enables biologists to visualize the average ChIP enrichment signals over -specific genomic features, allowing continuous and broad ChIP enrichment to be perceived -which might be too subtle to detect from ChIP peaks alone. - -This tool is compatible with the ceasBW version of CEAS from the Cistrome package -obtained from - -https://bitbucket.org/cistrome/cistrome-applications-harvard/overview - -(commit id d8c0751, datestamp 20140929). The CEAS code is under the -published-packages/CEAS/ subdirectory. - -Cistrome data files and documentation can be found at - -http://liulab.dfci.harvard.edu/CEAS/index.html - -The CEAS user manual is available at http://liulab.dfci.harvard.edu/CEAS/usermanual.html - -