### Command line interface

## alcf plot

alcf plot - plot lidar data

Usage: `alcf plot <plot_type> <input> <output> [<options>] [<plot_options>]`

Arguments:

- `plot_type`: plot type (see Plot types below)
- `input`: input filename or directory
- `output`: output filename or directory
- `options`: see Options below
- `plot_options`: Plot type specific options. See Plot options below.

Plot types:

- `backscatter`: plot backscatter
- `backscatter_hist`: plot backscatter histogram
- `backscatter_sd_hist`: plot backscatter standard deviation histogram
- `cloud_occurrence`: plot cloud occurrence

Options:

- `dpi: <value>`: Resolution in dots per inch (DPI). Default: `300`.
- `--grid`: plot grid
- `height: <value>`: Plot height (inches). Default: `5` if `plot_type` is `cloud_occurrence` or `backscatter_hist` else `4`.
- `subcolumn: <value>`: Model subcolumn to plot. Default: `0`.
- `title: <value>`: Plot title.
- `width: <value>`: Plot width (inches). Default: `5` if `plot_type` is `cloud_occurrence` or `backscatter_hist` else `10`.

Plot command options:

- `backscatter`:
  - `--lr`: plot lidar ratio (LR)
  - `--plot_cloud_mask`: plot cloud mask
  - `sigma: <value>`: Suppress backscatter less than a number of standard deviations from the mean backscatter (real). Default: `3`.
  - `vlim: { <min> <max }`. Value limits (10^6 m-1.sr-1). Default: `{ 10 2000 }`.
  - `vlog: <value>`: Plot values on logarithmic scale: `true` of `false`. Default: `true`.
- `backscatter_hist`:
  - `vlim: { <min> <max }`. Value limits (%) or `none` for auto. If `none` and `vlog` is `none`, `min` is set to 1e-3 if less or equal to zero. Default: `none`.
  - `--vlog`: use logarithmic scale for values
  - `xlim: { <min> <max> }`. x axis limits (10^6 m-1.sr-1) or `none` for automatic. Default: `none`.
  - `zlim: { <min> <max> }`. z axis limits (m) or `none` for automatic. Default: `none`.
- `backscatter_sd_hist`:
  - `xlim: { <min> <max> }`. x axis limits (10^6 m-1.sr-1) or `none` for automatic. Default: `none`.
  - `zlim: { <min> <max> }`. z axis limits (%) or `none` for automatic. Default: `none`.
- `cloud_occurrence`:
  - `colors: { <value>... }`: Line colors. Default: `{ #0084c8 #dc0000 #009100 #ffc022 #ba00ff }`
  - `linestyle`: { ... }`: Line style (`solid`, `dashed`, `dotted`). Default: `solid`.
  - `labels: { <value>... }`: Line labels. Default: `none`.
  - `lw: <value>`: Line width. Default: `1`.
  - `xlim: { <min> <max> }`: x axis limits (%). Default: `{ 0 100 }`.
  - `zlim: { <min> <max> }`: z axis limits (m). Default: `{ 0 15 }`.