Pairfq

Sync paired-end FASTA/Q files and keep singleton reads

Build Status	Github Version

BASIC USAGE

There is a standalone script in the 'scripts' directory that has no dependencies and will work with Perl version 5.6 or newer. This script has fewer features (mainly, it lacks the indexing function for working with large data) than the main application but it may be useful in an environment where installing libraries is not convenient. Obtaining this version can be done with curl:

curl -sL git.io/pairfq_lite > pairfq_lite

You can then make the script executable and check the usage:

chmod +x pairfq_lite
./pairfq_lite -h

Alternatively, you can use this version without storing it locally.

curl -sL git.io/pairfq_lite | perl -

The above command will show the options. To see a specific subcommand menu, for example the makepairs command, just type that subcommand with no options.

curl -sL git.io/pairfq_lite | perl - makepairs

For a full explanation of all commands, please see the Support and Documenation section below.

INSTALLATION

The following command will install Pairfq on a Mac or Linux system (note that this requires git):

curl -sL cpanmin.us | perl - git://github.com/sestaton/Pairfq.git

Alternatively, download the latest release and run the following command in the top directory:

perl Makefile.PL

If any Perl dependencies are listed after running this command, install them through the CPAN shell or any method you like (see the installing dependencies page for instructions). Then build and install the package.

perl Makefile.PL
make 
make test
make install

The last command is optional, you can put the program in a custom location or use it in place.

TYPICAL USAGE CASES

See the Pairfq wiki for examples with each method.

SUPPORT AND DOCUMENTATION

After installation, you can find documentation for Pairfq with the perldoc command.

perldoc pairfq

The documentation can also be accessed by specifying the manual option with pairfq -m or pairfq --man. The pairfq program will also print a diagnostic help message when executed with no arguments. In addition, there is extensive documentation on the Pairfq wiki online.

ISSUES

Report any issues or feature requests at the Pairfq issue tracker.

ATTRIBUTION

This project uses the readfq library written by Heng Li. The readfq code has been modified for error handling and to parse the comment line in the Casava header.

LICENSE

The MIT License should included with the project. If not, it can be found at: http://opensource.org/licenses/mit-license.php

Copyright (C) 2013-2022 S. Evan Staton