# RSeqAn
 SeqAn Headers for R
 

 [![Build Status](https://travis-ci.org/compbiocore/RSeqAn.svg?branch=master)](https://travis-ci.org/compbiocore/RSeqAn) [![codecov](https://codecov.io/gh/compbiocore/RSeqAn/branch/master/graph/badge.svg)](https://codecov.io/gh/compbiocore/RSeqAn) [![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)

 [![Docs](https://img.shields.io/badge/docs-stable-steelblue.svg?style=flat-square)](https://compbiocore.github.io/RSeqAn)
 [![DOI](http://joss.theoj.org/papers/10.21105/joss.01160/status.svg)](https://doi.org/10.21105/joss.01160)

 
 ## Overview

 
 This package provides R with access to [SeqAn v2.4](http://www.seqan.de/) header files. SeqAn is an open source C++ library of efficient algorithms and data structures for the analysis of sequences with the focus on biological data.
 

 ## Usage
 

 RSeqAn can be used via the `LinkingTo:` field in the `DESCRIPTION` field of an R package. Note that the compiler will need to compile as C++14. This can be done in R as `Sys.setenv("PKG_CXXFLAGS"="-std=c++14")`.
 

 For a quick example, see our [introductory vignette](https://compbiocore.github.io/RSeqAn/first_example/). Alternatively you can run the C++ code from the vignette directly by entering
 
 ```r
 Rcpp::sourceCpp(system.file("extdata","first_example.cpp",package="RSeqAn"))
 pattern_search("This is an awesome tutorial to get to know SeqAn!", "tutorial")
 ```
 
 Don't forget to set the C++14 compiler flags if you do this!
 

 ## Installation
 

  * We recommend installing the release version [through Bioconductor](https://bioconductor.org/packages/release/bioc/html/RSeqAn.html), especially if you are running R on Windows. Instructions are provided on their page.

  * Version 1.3.1 can also be installed [through Bioconductor](http://bioconductor.org/packages/devel/bioc/html/RSeqAn.html) (for now, Bioconductor has a separate release cycle), downloaded as [a tagged release](https://github.com/compbiocore/RSeqAn/releases/tag/v1.3.1), or installed with `devtools` by running:

 ```r

 devtools::install_github("compbiocore/RSeqAn", ref="v1.3.1")

 ```

 This version contains `Rcpp::as` and `Rcpp::wrap` functions for `CharString` and is the one submitted to the [Journal of Open Source Software](https://joss.theoj.org/).
 

  * The development version can be installed with `devtools` by running:

 ```r
 devtools::install_github("compbiocore/RSeqAn", ref="devel")
 ```
 This version contains additional wrappers, though we cannot guarantee that they will work for you.

 ## Author
 

 August Guang
 

 ## Release history
 
 See [`NEWS`](/inst/NEWS) for release history.
 

 ## Citation
 

 If you use this package in your work, even if only in auxiliary tools or pipelines please cite:

 Guang, (2019). RSeqAn: Headers and wrappers for the SeqAn library in R. Journal of Open Source Software, 4(34), 1160, https://doi.org/10.21105/joss.01160
 
 Please do not forget to cite SeqAn as well:
 
 Reinert, K., Dadi, T. H., Ehrhardt, M., Hauswedell, H., Mehringer, S., Rahn, R., … Weese, D. (2017). The SeqAn C++ template library for efficient sequence analysis: A resource for programmers. Journal of Biotechnology. https://doi.org/10.1016/j.jbiotec.2017.07.017