Bio-FSA-ToPS version 0.01
=========================

The FSA file format is a binary format for storing data produced by fragment analyzers. It belongs to the ABIF file formats developed by Applied Biosystems, Inc. 

This module is developed to convert files in fsa format into the PostScript format.


SYSTEM REQUIREMENTS

    Perl (version 5.8 or higher)


DEPENDENCIES

This module requires these other modules and libraries:

  Bio::Trace::ABIF

This module is available on Comprehensive Perl Archive Network (CPAN, http://www.cpan.org/).


INSTALLATION

To install this toolkit follow the instructions.

First unpack the tarball by typing

    tar -xzf Bio-FSA-ToPS.tar.gz

You will get a directory with the following structure

    Bio-FSA-ToPS/bin
    Bio-FSA-ToPS/share/data/
    Bio-FSA-ToPS/share/exec/
    Bio-FSA-ToPS/share/perl/

To install the module change to share/perl/ and type the following:

   perl Makefile.PL
   make
   make test
   make install


GETTING STARTED

Now, you have installed the module, you can try to convert the sample file under share/data/ to PostScript format. All you have to do is to invoke ./fsa2ps.sh, which is located in the bin sub-directory, with the sample file as follows

    ./fsa2ps.sh -f share/data/sample.fas

Run fsa2ps without parameters to get an usage message describing how to invoke the help.
After successfully converting the sample file, a PostScript file named sample.ps will be generated. You can find the respective sample output under share/data/sample_output.


COPYRIGHT AND LICENCE

This software is free for academic and non-commercial use. Commercial users please contact us at Bernd.Weisshaar@Uni-Bielefeld.DE. You are not allowed to redistribute this software. 

Please cite "Krawczyk et al., Two software toolkits for converting trace and fsa  files to PostScript format" if you use this tool. 

Copyright (C) 2009 Bernd Weisshaar
