# xan hist ```txt Print horizontal histograms for the given CSV file with each row representing a bar in the graph. This command is often used with the `frequency` or `bins` commands: $ xan freq -s username tweets.csv | xan hist $ xan bins -s retweet_count,like_count tweets.csv | xan hist Else, this command expects a CSV file with the following columns: - "field" (optional): the name of a histogram to print - "value": a single bar's label - "count": a single bar's represented numerical value You can always customize those column names through the -f/--field, -l/--label and -v/--value flags respectively. Usage: xan hist [options] [] xan hist --help hist options: --name Name of the represented field when no field column is present. [default: unknown]. -f, --field Name of the field column. I.e. the one containing the represented value (remember this command can print several histograms). [default: field]. -l, --label Name of the label column. I.e. the one containing the label for a single bar of the histogram. [default: value]. -v, --value Name of the count column. I.e. the one containing the value for each bar. [default: count]. -B, --bar-size Size of the bar characters between "small", "medium" and "large". [default: medium]. --cols Width of the graph in terminal columns, i.e. characters. Defaults to using all your terminal's width or 80 if terminal's size cannot be found (i.e. when piping to file). Can also be given as a ratio of the terminal's width e.g. "0.5". -R, --rainbow Alternating colors for the bars. -m, --domain-max If "max" max bar length will be scaled to the max bar value. If "sum", max bar length will be scaled to the sum of bar values (i.e. sum of bar lengths will be 100%). Can also be an absolute numerical value, to clamp the bars or make sure different histograms are represented using the same scale. [default: max] -c, --category Name of the categorical column that will be used to assign distinct colors per category. Incompatible with -R, --rainbow. --color When to color the output using ANSI escape codes. Use `auto` for automatic detection, `never` to disable colors completely and `always` to force colors, even when the output could not handle them. [default: auto] -P, --hide-percent Don't show percentages. -u, --unit Value unit. -D, --dates Set to indicate your values are dates (supporting year, year-month or year-month-day). This will sort the bars by date, and add missing dates. -G, --compress-gaps If given, will compress gaps of minimum consecutive entries set to 0 and replace it with an ellipsis. --scale Apply a scale to the values. Can be one of "lin", "log", "log2", "log10" or "log(custom_base)" like "log(2.5)". [default: lin] Common options: -h, --help Display this message -n, --no-headers When set, the file will be considered as having no headers. -d, --delimiter The field delimiter for reading CSV data. Must be a single character. ```