https://github.com/andrewrosss/snip-tsv

Crop tabular data files
https://github.com/andrewrosss/snip-tsv

cli csv plot tsv

Last synced: 1 day ago
JSON representation

Crop tabular data files

• Host: GitHub
• URL: https://github.com/andrewrosss/snip-tsv
• Owner: andrewrosss
• License: mit
• Created: 2022-02-27T10:30:04.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-03-22T05:04:29.000Z (over 2 years ago)
• Last Synced: 2024-08-10T09:58:03.691Z (about 2 months ago)
• Topics: cli, csv, plot, tsv
• Language: Python
• Homepage:
• Size: 50.8 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# snip-tsv

Crop tabular data files

## Installation

```bash

pip install snip-tsv

```

## Usage

```text

$ snip -h

usage: snip [-h] [-v] [-H] [-d DELIMITER] [-o OUT_FILE] [-x PLOT_X]

            [-y PLOT_Y] [-s START] [-e END] [-c COL]

            [-p PICK | -r OMIT]

            in_file

positional arguments:

  in_file               Input data file. (default: -)

optional arguments:

  -h, --help            show this help message and exit

  -v, --version         show program's version number and exit

  -H, --header          When set assume the first row to be a

                        header row. By default, no header row is

                        assumed.

  -d DELIMITER, --delimiter DELIMITER

                        The delimiter used in the input data file.

                        (default: '\t')

  -o OUT_FILE, --out-file OUT_FILE

                        File to write the results to (either an

                        image or TSV file. If not provided, a

                        matplotlib plot is shown when plotting, and

                        data is written to stdout when cropping.

                        (default: -)

plot options:

  -x PLOT_X, --plot-x PLOT_X

                        Column to use on the x-axis. A 0-indexed

                        integer or a column heading string.

                        (default: 0)

  -y PLOT_Y, --plot-y PLOT_Y

                        Column to use on the y-axis. A 0-indexed

                        integer or a column heading string.

                        (default: 1)

crop options:

  -s START, --start START

                        Start value to use for cropping

                        (inclusive). If the column is numeric then

                        the row with column entry closest to the

                        given value is used.

  -e END, --end END     End value to use for cropping (exclusive).

                        If the column is numeric then the row with

                        column entry closest to the given value is

                        used. To specify a numeric value relative

                        to --crop-start use the syntax ':'.

                        Omit this flag to crop from --crop-start to

                        the end of the file.

  -c COL, --col COL     Column to search in for --crop-

                        start/--crop-end values. A 0-indexed

                        integer or a column heading string.

                        (default: 0)

  -p PICK, --pick PICK  Comma separated list of columns to keep. If

                        specified, only columns in this list will

                        appear in the generated output. Columns can

                        either be column heading strings or

                        0-indexed integers (intermixing is

                        allowed). By default all columns are

                        retained.

  -r OMIT, --omit OMIT  Comma separated list of columns to omit. If

                        specified, columns in this list will be

                        removed from the generated output. Columns

                        can either be column heading strings or

                        0-indexed integers (intermixing is

                        allowed).

```