| pktools 2.6.7 Processing Kernel for geospatial data

pkstatascii

program to calculate basic statistics from text file

## SYNOPSIS

`Usage: pkstatascii -i input [-c column]*`

``

`Options: [-size] [-rnd number [-dist function] [-rnda value -rndb value]] [-mean] [-median] [-var] [-skew] [-stdev] [-sum] [-mm] [-min] [-max] [-hist [-nbin value] [-rel] [-kde]] [-hist2d [-nbin value] [-rel] [-kde]] [-cor] [-rmse] [-reg] [-regerr]`

`Advanced options: [-srcmin value] [-srcmax value] [-fs separator] [-r startrow [-r endrow]] [-o [-t]] [–comment character]`

``

# Description

The utility pkstatascii calculates basic statistics of a data series in a text file.

# Options

- use either `-short` or `--long` options (both `--long=value` and `--long value` are supported)
- short option `-h` shows basic options only, long option `--help` shows all options

  short | long | type | default | description
  --- | --- | --- | --- | ---
  i | input | std::string |  | name of the input text file
  c | column | int | 0 | column nr, starting from 0
  size | size | bool | false | sample size
  rnd | rnd | unsigned int | 0 | generate random numbers
  dist | dist | std::string | gaussian | distribution for generating random numbers, see http://www.gn/software/gsl/manual/gsl-ref_toc.html#TOC320 (only uniform and Gaussian supported yet)
  rnda | rnda | double | 0 | first parameter for random distribution (mean value in case of Gaussian)
  rndb | rndb | double | 1 | second parameter for random distribution (standard deviation in case of Gaussian)
  mean | mean | bool | false | calculate median
  median | median | bool | false | calculate median
  var | var | bool | false | calculate variance
  stdev | stdev | bool | false | calculate standard deviation
  skew | skewness | bool | false | calculate skewness
  kurt | kurtosis | bool | false | calculate kurtosis
  sum | sum | bool | false | calculate sum of column
  mm | minmax | bool | false | calculate minimum and maximum value
  min | min | bool | false | calculate minimum value
  max | max | bool | false | calculate maximum value
  hist | hist | bool | false | calculate histogram
  nbin | nbin | short |  | number of bins to calculate histogram
  rel | relative | bool | false | use percentiles for histogram to calculate histogram
  kde | kde | bool | false | Use Kernel density estimation when producing histogram. The standard deviation is estimated based on Silverman's rule of thumb
  hist2d | hist2d | bool | false | calculate 2-dimensional histogram based on two columns
  cor | correlation | bool | false | calculate Pearson produc-moment correlation coefficient between two columns (defined by -c <col1> -c <col2>
  rmse | rmse | bool | false | calculate root mean square error between two columns (defined by -c <col1> -c <col2>
  reg | regression | bool | false | calculate linear regression between two columns and get correlation coefficient (defined by -c <col1> -c <col2>
  regerr | regerr | bool | false | calculate linear regression between two columns and get root mean square error (defined by -c <col1> -c <col2>
  src_min | src_min | double |  | start reading source from this minimum value
  src_max | src_max | double |  | stop reading source from this maximum value
  fs | fs | char |  | field separator.
  r | range | int | 0 | rows to start/end reading. Use -r 1 -r 10 to read first 10 rows where first row is header. Use 0 to read all rows with no header.
  o | output | bool | false | output the selected columns
  t | transpose | bool | false | transpose input ascii vector (use in combination with –output)
  comment | comment | char | # | comment character

Usage: pkstatascii -i input [-c column]*