csvstack

Type:command
Package:prepDATA/1.1 — Conversion, Transformation and Plotting of Basic Data Files
Namespace:&type1

Description

Stack up the rows from multiple CSV files, optionally adding a grouping value.

Usage

csvstack {options}
Bash equivalent: csvstack {options}
usage: csvstack [-h] [-d DELIMITER] [-t] [-q QUOTECHAR] [-u {0,1,2,3}] [-b]
[-p ESCAPECHAR] [-z FIELD_SIZE_LIMIT] [-e ENCODING] [-S] [-H]
[-K SKIP_LINES] [-v] [-l] [–zero] [-V] [-g GROUPS]
[-n GROUP_NAME] [–filenames]
FILE [FILE …]
.
Stack up the rows from multiple CSV files, optionally adding a grouping value.
.
positional arguments:
FILE The CSV file(s) to operate on. If omitted, will accept
input on STDIN.
.
optional arguments:
-h, –help show this help message and exit
-d DELIMITER, –delimiter DELIMITER
Delimiting character of the input CSV file.
-t, –tabs Specify that the input CSV file is delimited with
tabs. Overrides “-d”.
-q QUOTECHAR, –quotechar QUOTECHAR
Character used to quote strings in the input CSV file.
-u {0,1,2,3}, –quoting {0,1,2,3}
Quoting style used in the input CSV file. 0 = Quote
Minimal, 1 = Quote All, 2 = Quote Non-numeric, 3 =
Quote None.
-b, –no-doublequote Whether or not double quotes are doubled in the input
CSV file.
-p ESCAPECHAR, –escapechar ESCAPECHAR
Character used to escape the delimiter if –quoting 3
(“Quote None”) is specified and to escape the
QUOTECHAR if –no-doublequote is specified.
-z FIELD_SIZE_LIMIT, –maxfieldsize FIELD_SIZE_LIMIT
Maximum length of a single field in the input CSV
file.
-e ENCODING, –encoding ENCODING
Specify the encoding of the input CSV file.
-S, –skipinitialspace
Ignore whitespace immediately following the delimiter.
-H, –no-header-row Specify that the input CSV file has no header row.
Will create default headers (a,b,c,…).
-K SKIP_LINES, –skip-lines SKIP_LINES
Specify the number of initial lines to skip (e.g.
comments, copyright notices, empty rows).
-v, –verbose Print detailed tracebacks when errors occur.
-l, –linenumbers Insert a column of line numbers at the front of the
output. Useful when piping to grep or as a simple
primary key.
–zero When interpreting or displaying column numbers, use
zero-based numbering instead of the default 1-based
numbering.
-V, –version Display version information and exit.
-g GROUPS, –groups GROUPS
A comma-separated list of values to add as “grouping
factors”, one for each CSV being stacked. These will
be added to the stacked CSV as a new column. You may
specify a name for the grouping column using the -n
flag.
-n GROUP_NAME, –group-name GROUP_NAME
A name for the grouping column, e.g. “year”. Only used
when also specifying -g.
–filenames Use the filename of each input file as its grouping
value. When specified, -g will be ignored.