ALCF-PLOT(1)

NAME
alcf-plot - Plot lidar data.

SYNOPSIS
alcf plot <plot_type> [<options>] [<plot_options>] [--] <input> <output>

DESCRIPTION
Arguments following -- are treated as literal strings. Use this delimiter if the input or output file names might otherwise be interpreted as non-strings, e.g. purely numerical file names.

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 from alcf lidar output on time-height axes.

backscatter_hist
    Plot backscatter histogram from alcf stats output on backscatter-height axes.

backscatter_sd_hist
    Plot backscatter standard deviation histogram from alcf stats output.

cbh Plot cloud base height distribution from alcf stats output.

cl  Plot model cloud area fraction from alcf lidar output on time-height axes.

cli Plot model mass fraction of cloud ice from alcf lidar output on time-height axes.

cloud_occurrence
    Plot cloud occurrence by height from alcf stats output.

clw Plot model mass fraction of cloud liquid water from alcf lidar output on time-height axes.

clw+cli
    Plot model mass fraction of cloud liquid water and ice from alcf lidar output on time-height axes.

GENERAL 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.

render: <value>
    Render profiles anti-aliased (antialiased) or standard (standard). Standard is more suitable for short time intervals. Default: antialiased.

BACKSCATTER OPTIONS

lr: <value>
    Plot effective lidar ratio. Default: true.

cloud_mask: <value>
    Plot cloud mask. Default: true.

remove_bmol: <value>
    Remove molecular backscatter (observed data have to be coupled with model data via the couple option of alcf lidar). Default: true.

sigma: <value>
    Remove of number of standard deviations of backscatter from the mean backscatter (real). Default: 5.

vlim: { <min> <max }
    Value limits (10^-6 m-1.sr-1). Default: { 0.1 200 }.

vlog: <value>
    Plot values on logarithmic scale: true of false. Default: true.

BACKSCATTER_HIST OPTIONS

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 OPTIONS

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.

CL OPTIONS

vlim: { <min> <max> }
    Value limits (%). Default: { 0 100 }.

vlog: <value>
    Plot values on logarithmic scale: true of false. Default: false.

zres: <zres>
    Height resolution (m). Default: 50.

CLI, CLW, AND CLW+CLI OPTIONS

vlim: { <min> <max> }
    Value limits (g/kg). Default: { 1e-3 1 }.

vlog: <value>
    Plot values on logarithmic scale: true of false. Default: true.

zres: <zres>
    Height resolution (m). Default: 50.

CBH AND CLOUD_OCCURRENCE OPTIONS

colors: { <value>... }
    Line colors. Default: { #0084c8 #dc0000 #009100 #ffc022 #ba00ff }

linestyle: { <value> ... }
    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 }.

EXAMPLES
Plot backscatter from processed Vaisala CL51 data in alcf_cl51_lidar and store the output in the directory alcf_cl51_backscatter.

    alcf plot backscatter alcf_cl51_lidar alcf_cl51_backscatter

COPYRIGHT
Copyright © 2019–2024 Peter Kuma, Adrian J. McDonald, Olaf Morgenstern, Richard Querel, Israel Silber and Connor J. Flynn.

BUG REPORTING
Report bugs to Peter Kuma (peter@peterkuma.net).

SEE ALSO
alcf(1), alcf-auto(1), alcf-calibrate(1), alcf-compare(1), alcf-convert(1), alcf-download(1), alcf-lidar(1), alcf-model(1), alcf-simulate(1), alcf-stats(1)