Quick start guide

  1. Start the SeqPlots GUI with seqplots::run() command in R. After successful initiation the web interface should automatically open in your default web browser. If you are web server user just navigate your browser to server address.

    The SeqPlots interface in web browser

  2. Upload some feature (BED or GFF) and track (BigWig or WIG) files. They can be gzip compressed (e.g. file1.bed.gz). Press green “Add files…” button or just drag and drop files into the window. The ready to upload files will show up in upload window, where you select user name, reference genome and optionally add some comments.

    File upload panel

  3. When all is done press blue “Start upload” button. After upload and processing is done the green “SUCCESS” label should show. It means that file is on the registered and ready to use. Occasionally the file might be mot formatted properly or chromosome names might not agree with reference genome. In such case a verbose error will window appears and file as labeled as “ERROR”. For further information please refer to errors chapter.

    File upload progress infoermation

  4. Dismiss upload window and press blue “New plot set” button on side panel. This will bring up file management window. In file management window select at least one file from “Features” tab and either one or more file from “Tracks” file or sequence motif(s). The sequence motifs and tracks can be processed and plotted together.

    File management panel

  5. When you decided which files/motifs to plot it is time to set up the processing options. You can find these in the button of plotting window. For first plot you should do just fine with default options, to learn more check this section.

    Plot set calculation options

  6. After options are set up press blue “Run calculation” button. This will dismiss the file management window and show processing message. Here you can observe the progress of the task and optionally cancel it if no longer required or you forgot to add some very important file to the plot-set (cancel available only in multi process mode).

    Plot set calculation progress window

  7. After some time the calculation will finish (fingers crossed, without the error) and you will be able to see plot set array. In here you can choose which feature-track or feature-motif pairs to plot. Choose one or more checkboxes and press grey “Line plot” button (or hit RETURN from your keyboard). You can also check “Reactive plotting” checkbook in the bottom of “Batch operations and setup” tab - it will automatically apply changes to plots as soon as you changed any plot-related option.

    The plot selection grid

  8. Congratulation! Your First plot is complete, you can see the preview of it on the side panel.

    The plot preview panel

  9. You are able to set up labels, titles, font sizes, legends and many more on side panel tabs, take a look at this chapter.

    Plot settings tabs

  10. By clicking the plot preview you can enlarge it for better view. When everything is ready you can get the plot as PDF by clicking green “Line plot” button just on the top of side panel.

    Average plot example

  11. You can also visualize the signal as a heatmap. Please note that heatmap plotting is possible only for single feature file or files containing exactly the same number of genomic ranges (which will become the rows of heat map). For heatmap you can choose to sort and/or cluster it using k-means. To learn more about heatmaps click here.

    Heatmap settings tab

  12. Similarly to line plot you can grab the heatmap PDF using 'Heatmap' button just on the top of side panel. Just attached to it, there is small button allowing you to get cluster definitions.

    Heatmap example

Session Information

## R version 3.1.1 (2014-07-10)
## Platform: x86_64-apple-darwin10.8.0 (64-bit)
## 
## locale:
## [1] en_US.UTF-8/en_US.UTF-8/en_US.UTF-8/C/en_US.UTF-8/en_US.UTF-8
## 
## attached base packages:
## [1] stats4    stats     graphics  grDevices utils     datasets  methods  
## [8] base     
## 
## other attached packages:
##  [1] BiocStyle_1.3.12                    
##  [2] seqplots_0.99.2                     
##  [3] jpeg_0.1-8                          
##  [4] png_0.1-7                           
##  [5] RSelenium_1.3.1                     
##  [6] XML_3.98-1.1                        
##  [7] caTools_1.17.1                      
##  [8] RJSONIO_1.3-0                       
##  [9] RCurl_1.95-4.3                      
## [10] bitops_1.0-6                        
## [11] BSgenome.Celegans.UCSC.ce10_1.3.1000
## [12] BSgenome_1.33.9                     
## [13] rtracklayer_1.25.16                 
## [14] Biostrings_2.33.14                  
## [15] XVector_0.5.8                       
## [16] GenomicRanges_1.17.42               
## [17] GenomeInfoDb_1.1.20                 
## [18] IRanges_1.99.28                     
## [19] S4Vectors_0.2.4                     
## [20] testthat_0.8.1                      
## [21] BiocGenerics_0.11.5                 
## [22] devtools_1.5                        
## 
## loaded via a namespace (and not attached):
##  [1] BatchJobs_1.3            BBmisc_1.7              
##  [3] BiocParallel_0.99.22     brew_1.0-6              
##  [5] Cairo_1.5-5              checkmate_1.4           
##  [7] class_7.3-11             codetools_0.2-9         
##  [9] DBI_0.3.0                digest_0.6.4            
## [11] evaluate_0.5.5           fail_1.2                
## [13] fields_7.1               foreach_1.4.2           
## [15] formatR_1.0              futile.logger_1.3.7     
## [17] futile.options_1.0.0     GenomicAlignments_1.1.30
## [19] grid_3.1.1               htmltools_0.2.6         
## [21] httpuv_1.3.0             httr_0.5                
## [23] iterators_1.0.7          knitr_1.6.18            
## [25] kohonen_2.0.15           lambda.r_1.1.6          
## [27] maps_2.3-9               markdown_0.7.4          
## [29] MASS_7.3-34              memoise_0.2.1           
## [31] mime_0.1.2               parallel_3.1.1          
## [33] plotrix_3.5-7            Rcpp_0.11.2             
## [35] roxygen2_4.0.2           Rsamtools_1.17.34       
## [37] RSQLite_0.11.4           rstudio_0.98.1028       
## [39] rstudioapi_0.1           sendmailR_1.1-2         
## [41] shiny_0.10.1             spam_1.0-1              
## [43] stringr_0.6.2            tools_3.1.1             
## [45] whisker_0.3-2            xtable_1.7-4            
## [47] zlibbioc_1.11.1