#!/usr/bin/env perl

use strict;
use warnings;
use utf8;

use App::Sandy;

# PODNAME: Sandy
# ABSTRACT: A straightforward and complete next-generation sequencing read simulator

our $VERSION = '0.20'; # VERSION

my $app = App::Sandy->new;
$app->run;

__END__

=pod

=encoding UTF-8

=head1 NAME

Sandy - A straightforward and complete next-generation sequencing read simulator

=head1 VERSION

version 0.20

=head1 SYNOPSIS

 $ sandy <command> ...

=head1 DESCRIPTION

B<Sandy> is a bioinformatic tool that provides a simple engine to generate
single-end/paired-end reads from a given fasta file. Many next-generation
sequencing analyses rely on hypothetical models and principles that are
not precisely satisfied in practice. Simulated data, which provides positive
controls, would be a perfect way to overcome these difficulties. Here, we
present Sandy, a straightforward, easy to use, fast, complete set of tools
to generate synthetic second and third-generation sequencing reads. Sandy
simulates whole genome sequencing, whole exome sequencing, RNAseq reads.
Sandy presents also several features to the users manipulate the data, as
well as well-organized database containing the ‘true’ information (based on
the generated data) of the reads position into the genome, gene and transcript
expression, sequencing errors, and the sequencing coverage. One of the most
impressive features of Sandy is the power to simulate polymorphisms as snvs,
indels and structural variations (e.g. gene duplication, retro-duplication,
gene-fusion) along with the sequencing reads - with no need of further processing
steps. Sandy can be used therefore for benchmarking results of a variety of
pipelines in the genomics or transcriptomics, as well as in generating new
hypotheses and helping in the best designing of sequencing projects, possibly
optimizing time and costs.

=head1 INSTALLATION

B<Sandy> was designed for Linux based distributions. If you are working with another
type of operating system, such as macOS, Windows, try to use our docker image.
For more details, see L<docker/README.md|https://github.com/galantelab/sandy/blob/master/docker/README.md>
file.

=head2 PREREQUISITES

Along with B<Perl>, you must have B<zlib>, B<gcc> and B<make> packages installed:

=over 4

=item Debian/Ubuntu

 % apt-get install perl zlib1g-dev gcc make

=item CentOS/Fedora

 % yum install perl zlib gcc make

=item Archlinux

 % pacman -S perl zlib gcc make

=back

B<Sandy> uses the B<Comprehensive Perl Archive Network>, L<CPAN|https://www.cpan.org/>, as its
package manager, which allows a good control over all dependencies needed.
If you have Perl installed, then you may have the B<cpan> command utility. At the first run, cpan
will interactively configure your environment and mirror. In doubt, just confirm the default options
presented. After this, install cpanminus:

 % cpan -i App::cpanminus

App::cpanminus will provide the B<cpanm> utility, which has the capability of install not only
Sandy, but also all its dependencies recursively.

=head2 INSTALLING

Finally install B<Sandy>:

 % cpanm App::Sandy

For more details, see L<INSTALL|https://github.com/galantelab/sandy/blob/master/INSTALL> file

=head1 ACKNOWLEDGMENTS

=over 4

=item Coordination for the Improvement of Higher Level Personnel - L<CAPES|http://www.capes.gov.br/>

=item Teaching and Research Institute from Sírio-Libanês Hospital - L<Group of Bioinformatics|https://www.bioinfo.mochsl.org.br/>

=back

=head1 AUTHORS

=over 4

=item *

Thiago L. A. Miller <tmiller@mochsl.org.br>

=item *

J. Leonel Buzzo <lbuzzo@mochsl.org.br>

=item *

Felipe R. C. dos Santos <fsantos@mochsl.org.br>

=item *

Helena B. Conceição <hconceicao@mochsl.org.br>

=item *

Gabriela Guardia <gguardia@mochsl.org.br>

=item *

Fernanda Orpinelli <forpinelli@mochsl.org.br>

=item *

Pedro A. F. Galante <pgalante@mochsl.org.br>

=back

=head1 COPYRIGHT AND LICENSE

This software is Copyright (c) 2018 by Teaching and Research Institute from Sírio-Libanês Hospital.

This is free software, licensed under:

  The GNU General Public License, Version 3, June 2007

=cut
