The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

fu-count - A FASTA/FASTQ sequence counter

VERSION

version 1.5.0

SYNOPSIS

  fu-count [options] [FILE1 FILE2 FILE3...]

DESCRIPTION

This program parses a list of FASTA/FASTQ files printing the number of sequences found in each file. Reads both uncompressed and GZipped files. Default output is the filename, tab, sequence count. Can be changed with options.

The table "key" is the absolute path of each input file, but the printed name can be changed with options.

NAME

fu-count - A FASTA/FASTQ sequence counter

PARAMETERS

FILE NAME

-a, --abspath

Print the absolute path of the filename (the absolute path is always the table key, but if relative paths are supplied, they will be printed).

-b, --basename

Print the filename without the path.

-d, --thousandsep

Print reads number with a "," used as thousand separator

OUTPUT FORMAT

Default output format is the filename and reads counts, tab separated. Options formatting either filename (-a, -b) and reads counts (-d) will still work.

-t, --tsv and -c, --csv

Print a tabular output either tab separated (with -t) or comma separated (with -c).

-j, --json

Print full output in JSON format.

-p, --pretty

Same as JSON but in "pretty" format.

-x, --screen

This feature requires Term::ASCIITable. Print an ASCII-art table like:

  .---------------------------------------------------.
  | # | Name                     | Seqs | Gz | Parser |
  +---+--------------------------+------+----+--------+
  | 1 | data/comments.fasta      |    3 |  0 | FASTX  |
  | 2 | data/comments.fastq      |    3 |  0 | FASTQ  |
  | 3 | data/compressed.fasta.gz |    3 |  1 | FASTX  |
  | 4 | data/compressed.fastq.gz |    3 |  1 | FASTQ  |
  '---+--------------------------+------+----+--------'

SORTING

-s, --sortby

Sort by field: 'order' (default, that is the order of the input files as supplied by the user), 'count' (number of sequences), 'name' (filename). By default will be descending for numeric fields, ascending for 'path'. See -r, --reverse.

-r, --reverse

Reverse the sorting order.

OTHER

-f, --fastx

Force FASTX reader also for files ending by .fastq or .fq (by default would use getFastqRead() )

-v, --verbose

Increase verbosity

-h, --help

Display this help page

MODERN ALTERNATIVE

This suite of tools has been superseded by SeqFu, a compiled program providing faster and safer tools for sequence analysis. This suite is maintained for the higher portability of Perl scripts under certain circumstances.

SeqFu is available at https://github.com/telatin/seqfu2, and can be installed with BioConda conda install -c bioconda seqfu

CITING

Telatin A, Fariselli P, Birolo G. SeqFu: A Suite of Utilities for the Robust and Reproducible Manipulation of Sequence Files. Bioengineering 2021, 8, 59. https://doi.org/10.3390/bioengineering8050059

AUTHOR

Andrea Telatin <andrea@telatin.com>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2018-2022 by Andrea Telatin.

This is free software, licensed under:

  The MIT (X11) License