| 1 | package App::colsummary ; | ||
| 2 | our $VERSION = '0.060' ; | ||
| 3 | our $DATE = '2021-07-10T16:12+09:00' ; | ||
| 4 | |||
| 5 | =encoding utf8 | ||
| 6 | |||
| 7 | =head1 NAME | ||
| 8 | |||
| 9 | App::colsummary | ||
| 10 | |||
| 11 | =head1 SYNOPSIS | ||
| 12 | |||
| 13 | This module provides a Unix-like command `F<colsummary>'. | ||
| 14 | |||
| 15 | =head1 DESCRIPTION | ||
| 16 | |||
| 17 | colsummary | ||
| 18 | |||
| 19 | $0 | ||
| 20 | データファイル(TSV形式、一行目はヘッダ)について、各列の有用な情報を出力する。 | ||
| 21 | |||
| 22 | 出力項目: | ||
| 23 | 1. 列番号 ; 白 | ||
| 24 | 2. 異なり数(各列に異なる値が何個出現したか) ; 明るい緑 | ||
| 25 | 3. 平均値 ( -m で平均値の出力は抑制可能) ; 青 | ||
| 26 | 4. 列名 (ヘッダから取り出す) ; 黄色 | ||
| 27 | 5. 値の範囲 ; 明るい白 | ||
| 28 | 6. 値の頻出ランキング ; 暗い白 | ||
| 29 | 7. 頻出上位と下位についての出現回数 ; 明るい緑 | ||
| 30 | 8. 値の文字列長の範囲 ; 青 | ||
| 31 | |||
| 32 | [オプション] : | ||
| 33 | |||
| 34 | (入力オプション) | ||
| 35 | -= ; 入力の最初の行が列名の並びと仮定。この指定をしない場合は列名は連番になる。 | ||
| 36 | -i STR : 区切り文字をタブ文字ではなくて、 str に変更。 | ||
| 37 | -v N ; 各セルの値の長さを指定文字数に制限する。(列名には適用されない。) | ||
| 38 | -s ; 各セルの末尾の空白を除去。-u0としない限り半角空白だけで無くて全角空白も除去。 | ||
| 39 | -u 0 ; utf-8 として処理する通常の処理をせず、バイト単位の処理となる。 | ||
| 40 | -z ; 入力は gzip 圧縮されていることを仮定。 | ||
| 41 | -\# REGEX ; 除外する値の正規表現の指定。 '^部分正規表現$' のような指定の仕方をよく使うことになるだろう。 | ||
| 42 | -@ N : N 秒ごとに,何行を読んだかを報告する。 Report how many have read every N seconds. | ||
| 43 | |||
| 44 | -R 0 ; 改行区切りが\r\nであっても何もオプション指定せずに対処しているが、不具合があれば使う。 | ||
| 45 | |||
| 46 | (出力オブション) | ||
| 47 | -0 0 : 出力の変数の名前の並びを出力しない。 | ||
| 48 | -g N ; 具体的な値を何個表示させるか指定する。未指定なら6。 | ||
| 49 | -j : 出力の各列の名前を日本語で出力する。 | ||
| 50 | -m 0 ; 平均値を表示しない。(平均値は strtod を使っている。) | ||
| 51 | -r str : 範囲を表す記号(未指定なら"~"の1文字)。-r ".." などと指定する。(rはRangeのつもり。) | ||
| 52 | -c str : 範囲を示す表示を複数を束ねるときに使う記号。未指定なら"|"。-c ','などとする。 | ||
| 53 | |||
| 54 | --help : この $0 のヘルプメッセージを出す。 perldoc -t $0 | cat でもほぼ同じ。 | ||
| 55 | --help opt : オプションのみのヘルプを出す。opt以外でも options と先頭が1文字以上一致すれば良い。 | ||
| 56 | |||
| 57 | =head1 SEE ALSO | ||
| 58 | |||
| 59 | |||
| 60 | =cut | ||
| 61 | |||
| 62 | 1 ; |