The hardware and bandwidth for this mirror is donated by METANET, the Webhosting and Full Service-Cloud Provider.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]metanet.ch.

malan: MAle Lineage ANalysis

An R package (https://www.r-project.org/) to perform MAle Lineage ANalysis by simulating genealogies backwards and imposing short tandem repeats (STR) mutations forwards. Intended for forensic Y chromosomal STR (Y-STR) haplotype analyses. Numerous analyses are possible, e.g. number of matches and meiotic distance to matches.

Refer to papers mentioned in citation("malan") (DOI’s: https://doi.org/10.1371/journal.pgen.1007028, https://doi.org/10.21105/joss.00684 and https://doi.org/10.1016/j.fsigen.2018.10.004).

Installation

You first need R (https://www.r-project.org/). Then you can install malan from GitHub by using the remotes package (https://CRAN.R-project.org/package=remotes):

# install.packages("remotes")
remotes::install_github("mikldk/malan")

For Mac OS users

Some Mac OSX configurations may have installation problems (for example missing gfortran libraries). In such cases, it may help to use Conda package management system. See also the discussion in issue #14.

Getting started

See documentation included in package (vignettes and manual) at https://mikldk.github.io/malan/. The introduction vignette is available at https://mikldk.github.io/malan/articles/introduction.html.

You can also get an overview of the included vignettes by the following R command:

vignette(package = "malan")

To read a vignette, type:

vignette("introduction", package = "malan")

Running tests

Note that to also install the tests, you need to install the package as follows:

# install.packages("remotes")
remotes::install_github("mikldk/malan", INSTALL_opts="--install-tests")

You can now run the tests:

library(malan)
library(testthat)
test_package('malan')

Contribute, issues, and support

Please use the issue tracker at https://github.com/mikldk/malan/issues if you want to notify us of an issue or need support. If you want to contribute, please either create an issue or make a pull request.

Dependencies

This package depends on R (https://www.r-project.org/) and the following R packages: Rcpp, RcppProgress, RcppArmadillo, igraph, tibble, magrittr, dplyr, and tidygraph.

References

Andersen MM, Balding DJ (2017). How convincing is a matching Y-chromosome profile?. PLoS Genet 13(11): e1007028. https://doi.org/10.1371/journal.pgen.1007028.

Disclaimer

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

License

License: GPL-2.

Badges

The Journal of Open Source Software:

DOI

Zenodo:

DOI

Travis CI:

Travis-CI Build Status

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.