cl_plot¶
cl_plot [OPTIONS] COMMAND [ARGS]...
scripts for plotting data from the command line.
Options
VALUE OPTIONS:
-
-c
,
--config
<PATH>
¶ path of config file to load
-
-ca
,
--configalias
<TEXT>
¶ store config in alias section. use to store multiple settings for same command
-
-oc
,
--outconfig
<PATH>
¶ path of config file to write/update
FLAGS (DEFAULT TRUE):
-
--inputalias
,
--no-inputalias
¶
if true uses -ca for loading settings
- Default
True
HELP:
-
--version
¶
Show the version and exit.
- Default
False
Commands
-
bar
dataf should be a tsv or csv with the…
-
heatmap
def plot_heatmap(fig, ax, data, colormap,…
-
histo
plot histogram bar plot
-
scatter
arguments for x_vals and y_vals are a…
-
box
create boxplot from data files.
-
violin
create violinplot from data files.
-
previewpal
create plot color palettes and formatted rgbs
-
colors
create plot color palettes and formatted rgbs
bar¶
cl_plot bar [OPTIONS] DATAF
dataf should be a tsv or csv with the following format: xaxis label, series1 ,series2, etc.. category1, 0,0,… category2, 0,0,… etc…,…
arguments:
dataf: data file to plot
Arguments
-
DATAF
¶
Required argument
Options
VALUE OPTIONS:
-
-alpha
<FLOAT>
¶ transparency for background
- Default
0.5
-
-axes
<TEXT>
¶ enter as xname,xmin,xmax,yname,ymin,ymax - default usesmin and max of data enter xmin etc to maintain autoscale
- Default
X,0,10,Y,0,ymax
-
-background
<PATH>
¶ background image for graph area
-
-bg
<TEXT>
¶ background color
- Default
white
-
-bottom
<FLOAT>
¶ use with polar to set bottom of y-axis same units as axes
- Default
0.0
-
-brng
<FLOATS>
¶ range within axes limits that bars are plotted
- Default
0 1
-
-bwidth
<FLOAT>
¶ relative width of bars
- Default
0.8
-
-colors
<COLORS>
¶ cmap name or space seperated list of rgb tuples 0,0,0 120,120,120 etc. if fewer than # series picks .from gradient includes ru_colors: ‘blu’, ‘org’, ‘pur’, ‘red’, ‘blg’, ‘mag’, ‘brn’, ‘grn’, ‘yel’, ‘ggr’, ‘dark’, ‘med’, ‘light’, ‘xlight’
- Default
viridis
-
-comment
<TEXT>
¶ regex “^[{}].*” indicating comment line indicator
- Default
#
-
-dpi
<INTEGER>
¶ image dpi
- Default
200
-
-drange
<INTS>
¶ index range for data series, if None gets all
-
-ecolors
<COLORS>
¶ marker edge colors
- Default
viridis
-
-epositions
<FLOATS>
¶ if cmap is a list positions are the mapping pointselse positions are the sample points used to remap
-
-estep
<INTEGER>
¶ steps for color map
-
-ew
<FLOATS>
¶ bar edge width
- Default
0
-
-fcol
<FLOAT>
¶ colormap position for first color
- Default
0.0
-
-fg
<TEXT>
¶ foreground color
- Default
black
-
-format
<TEXT>
¶ output file format for default naming (overridden by outf)
- Default
.png
-
-height
<FLOAT>
¶ image height
- Default
5.0
-
-labels
<TEXTS>
¶ input custom series labels, by default uses file name and index or –header option
-
-labelweight
<CHOICE>
¶ text weight for axes labels
- Default
ultralight
- Options
ultralight | light | normal | regular | book | medium | roman | semibold | demibold | demi | bold | heavy | extra bold | black
-
-outf
<TEXT>
¶ graph output file (defaults to basename of first dataf)
-
-positions
<FLOATS>
¶ if cmap is a list positions are the mapping points else positions are the sample points used to remap
-
-rwidth
<FLOAT>
¶ relative width of bar clusters
- Default
0.95
-
-step
<INTEGER>
¶ steps for color map
-
-width
<FLOAT>
¶ image width
- Default
5.0
-
-xlabels
<TEXTS>
¶ input custom xaxis labels, by default uses file name androw number or –xheader option
-
-xrotate
<CHOICE>
¶ orientation of x-axis labels
- Default
auto
- Options
auto | horiz | vert | a | h | v
-
-xticks
<INTEGER>
¶ number of x-ticks/gridlines
-
-y_vals
<INTS>
¶ index for yvals
- Default
-1
-
-yticks
<INTEGER>
¶ number of y-ticks/gridlines
FLAGS (DEFAULT TRUE):
-
--polar0
,
--no-polar0
¶
plot center of first bar at xmin
- Default
True
-
--polarauto
,
--no-polarauto
¶
ignore x-axis min,max and plot 0-360
- Default
True
-
--xgrid
,
--no-xgrid
¶
plot x grid lines
- Default
True
-
--ygrid
,
--no-ygrid
¶
plot y grid lines
- Default
True
FLAGS (DEFAULT FALSE):
-
--areaonly
,
--no-areaonly
¶
only plot plot area, no legend or axes, for use as background
- Default
False
-
--front
,
--no-front
¶
plot background in front of data
- Default
False
-
--header
,
--no-header
¶
indicates that data has a header row to get series labels (overridden by labels)
- Default
False
-
--legend
,
--no-legend
¶
include legend in plot
- Default
False
-
--polar
,
--no-polar
¶
plot on polar axes
- Default
False
-
--rows
,
--no-rows
¶
get data rows instead of columns
- Default
False
-
--stacked
,
--no-stacked
¶
make stacked bars
- Default
False
-
--ticklines
,
--no-ticklines
¶
plot tick lines
- Default
False
-
--weatherfile
,
--no-weatherfile
¶
input files will be read as weather files: 0 month, 1 day, 2 hour, 3 dirnorn, 4 difhoriz, 5 globhoriz, 6 skycover
- Default
False
-
--xheader
,
--no-xheader
¶
indicates that data has a header column to get x-axis labels (overridden by xlabels)
- Default
False
-
--ylog
,
--no-ylog
¶
plot y on log scale
- Default
False
HELP:
-
-opts
,
--opts
¶
check parsed options
- Default
False
-
--debug
¶
show traceback on exceptions
- Default
False
heatmap¶
cl_plot heatmap [OPTIONS] DATAF
def plot_heatmap(fig, ax, data, colormap, vmin=None, vmax=None, DST=False, ticks=None, labels=None, **kwargs)
Arguments
-
DATAF
¶
Required argument
Options
VALUE OPTIONS:
-
-alpha
<FLOAT>
¶ transparency for background
- Default
0.5
-
-background
<PATH>
¶ background image for graph area
-
-bg
<TEXT>
¶ background color
- Default
white
-
-colors
<COLORS>
¶ cmap name or space seperated list of rgb tuples 0,0,0 120,120,120 etc. if fewer than # series picks .from gradient includes ru_colors: ‘blu’, ‘org’, ‘pur’, ‘red’, ‘blg’, ‘mag’, ‘brn’, ‘grn’, ‘yel’, ‘ggr’, ‘dark’, ‘med’, ‘light’, ‘xlight’
- Default
viridis
-
-comment
<TEXT>
¶ regex “^[{}].*” indicating comment line indicator
- Default
#
-
-dpi
<INTEGER>
¶ image dpi
- Default
200
-
-dpy
<INTEGER>
¶ days per year (x axis shape)
- Default
365
-
-drange
<INTS>
¶ index range for data series, if None gets all
-
-fcol
<FLOAT>
¶ colormap position for first color
- Default
0.0
-
-fg
<TEXT>
¶ foreground color
- Default
black
-
-format
<TEXT>
¶ output file format for default naming (overridden by outf)
- Default
.png
-
-gridc
<FLOAT>
¶ opacity of gridlines (color is bg)
- Default
0.5
-
-height
<FLOAT>
¶ image height
- Default
5.0
-
-hpd
<INTEGER>
¶ hours per day (y axis shape)
- Default
24
-
-labels
<TEXTS>
¶ labels for legend
-
-labelweight
<CHOICE>
¶ text weight for axes labels
- Default
ultralight
- Options
ultralight | light | normal | regular | book | medium | roman | semibold | demibold | demi | bold | heavy | extra bold | black
-
-lw
<FLOAT>
¶ lineweight of grid around cells (try .5)
- Default
0.5
-
-outf
<TEXT>
¶ graph output file (defaults to basename of first dataf)
-
-plotidx
<INTEGER>
¶ column idx of data to plot
- Default
-1
-
-positions
<FLOATS>
¶ if cmap is a list positions are the mapping points else positions are the sample points used to remap
-
-pph
<INTEGER>
¶ data points per hour in annual data
- Default
1
-
-sh
<INTEGER>
¶ start hour (24 hour time)
- Default
0
-
-step
<INTEGER>
¶ steps for color map
-
-ticks
<FLOATS>
¶ locations for legend labels (must be same # of items)
-
-vmax
<FLOAT>
¶ scale max
-
-vmin
<FLOAT>
¶ scale max
-
-width
<FLOAT>
¶ image width
- Default
5.0
-
-xrotate
<CHOICE>
¶ orientation of x-axis labels
- Default
auto
- Options
auto | horiz | vert | a | h | v
FLAGS (DEFAULT FALSE):
-
--areaonly
,
--no-areaonly
¶
only plot plot area, no legend or axes, for use as background
- Default
False
-
--dst
,
--no-dst
¶
shift data for DST
- Default
False
-
--front
,
--no-front
¶
plot background in front of data
- Default
False
-
--legend
,
--no-legend
¶
include legend in plot
- Default
False
-
--ticklines
,
--no-ticklines
¶
plot tick lines
- Default
False
-
--weatherfile
,
--no-weatherfile
¶
input files will be read as weather files: 0 month, 1 day, 2 hour, 3 dirnorn, 4 difhoriz, 5 globhoriz, 6 skycover
- Default
False
HELP:
-
-opts
,
--opts
¶
check parsed options
- Default
False
-
--debug
¶
show traceback on exceptions
- Default
False
histo¶
cl_plot histo [OPTIONS] DATAF
plot histogram bar plot
Arguments
-
DATAF
¶
Required argument
Options
VALUE OPTIONS:
-
-alpha
<FLOAT>
¶ transparency for background
- Default
0.5
-
-autobin
<TEXT>
¶ see numpy.histogram_bin_edges for options1 2 3 4:12:2 14:16 = 1,2,3,4,6,8,10,14,15
- Default
auto
-
-axes
<TEXT>
¶ enter as xname,xmin,xmax,yname,ymin,ymax - default usesmin and max of data enter xmin etc to maintain autoscale
- Default
X,0,1,Y,0,ymax
-
-background
<PATH>
¶ background image for graph area
-
-bg
<TEXT>
¶ background color
- Default
white
-
-bins
<FLOATS>
¶ bins can be ‘auto’ an integer or a sequence1 2 3 4:12:2 14:16 = 1,2,3,4,6,8,10,14,15
-
-bottom
<FLOAT>
¶ use with polar to set bottom of y-axis same units as axes
- Default
0.0
-
-brange
<FLOATS>
¶ defaults to min and max
-
-bwidth
<FLOAT>
¶ relative width of bars
- Default
0.8
-
-colors
<COLORS>
¶ cmap name or space seperated list of rgb tuples 0,0,0 120,120,120 etc. if fewer than # series picks .from gradient includes ru_colors: ‘blu’, ‘org’, ‘pur’, ‘red’, ‘blg’, ‘mag’, ‘brn’, ‘grn’, ‘yel’, ‘ggr’, ‘dark’, ‘med’, ‘light’, ‘xlight’
- Default
viridis
-
-comment
<TEXT>
¶ regex “^[{}].*” indicating comment line indicator
- Default
#
-
-dpi
<INTEGER>
¶ image dpi
- Default
200
-
-drange
<INTS>
¶ index range for data series, if None gets all
-
-ecolors
<COLORS>
¶ marker edge colors
- Default
viridis
-
-epositions
<FLOATS>
¶ if cmap is a list positions are the mapping pointselse positions are the sample points used to remap
-
-estep
<INTEGER>
¶ steps for color map
-
-fcol
<FLOAT>
¶ colormap position for first color
- Default
0.0
-
-fg
<TEXT>
¶ foreground color
- Default
black
-
-format
<TEXT>
¶ output file format for default naming (overridden by outf)
- Default
.png
-
-height
<FLOAT>
¶ image height
- Default
5.0
-
-labels
<TEXTS>
¶ input custom series labels, by default uses file name and index or –header option
-
-labelweight
<CHOICE>
¶ text weight for axes labels
- Default
ultralight
- Options
ultralight | light | normal | regular | book | medium | roman | semibold | demibold | demi | bold | heavy | extra bold | black
-
-outf
<TEXT>
¶ graph output file (defaults to basename of first dataf)
-
-positions
<FLOATS>
¶ if cmap is a list positions are the mapping points else positions are the sample points used to remap
-
-rwidth
<FLOAT>
¶ relative width of bars
- Default
0.95
-
-step
<INTEGER>
¶ steps for color map
-
-weights
<INTS INTS,INTS>
¶ index for weights (if given, must be 1:1 match with y_vals)
-
-width
<FLOAT>
¶ image width
- Default
5.0
-
-xlabels
<TEXTS>
¶ input custom xaxis labels, by default uses file name androw number or –xheader option
-
-xrotate
<CHOICE>
¶ orientation of x-axis labels
- Default
auto
- Options
auto | horiz | vert | a | h | v
-
-xticks
<INTEGER>
¶ number of x-ticks/gridlines
-
-y_vals
<INTS INTS,INTS>
¶ index for yvals
- Default
-1
-
-yticks
<INTEGER>
¶ number of y-ticks/gridlines
FLAGS (DEFAULT TRUE):
-
--xgrid
,
--no-xgrid
¶
plot x grid lines
- Default
True
-
--ygrid
,
--no-ygrid
¶
plot y grid lines
- Default
True
FLAGS (DEFAULT FALSE):
-
--areaonly
,
--no-areaonly
¶
only plot plot area, no legend or axes, for use as background
- Default
False
-
--density
,
--no-density
¶
plot as probability density (area sums to 1)
- Default
False
-
--front
,
--no-front
¶
plot background in front of data
- Default
False
-
--header
,
--no-header
¶
indicates that data has a header row to get series labels (overridden by labels)
- Default
False
-
--legend
,
--no-legend
¶
include legend in plot
- Default
False
-
--polar
,
--no-polar
¶
plot on polar axes
- Default
False
-
--rows
,
--no-rows
¶
get data rows instead of columns
- Default
False
-
--stacked
,
--no-stacked
¶
make stacked bars
- Default
False
-
--tails
,
--no-tails
¶
include values below and above range in first and last bin(requires -brange)
- Default
False
-
--ticklines
,
--no-ticklines
¶
plot tick lines
- Default
False
-
--weatherfile
,
--no-weatherfile
¶
input files will be read as weather files: 0 month, 1 day, 2 hour, 3 dirnorn, 4 difhoriz, 5 globhoriz, 6 skycover
- Default
False
-
--xheader
,
--no-xheader
¶
indicates that data has a header column to get x-axis labels (overridden by xlabels)
- Default
False
-
--ylog
,
--no-ylog
¶
plot y on log scale
- Default
False
HELP:
-
-opts
,
--opts
¶
check parsed options
- Default
False
-
--debug
¶
show traceback on exceptions
- Default
False
scatter¶
cl_plot scatter [OPTIONS] DATAF
arguments for x_vals and y_vals are a space seperated list of indices or index pairs. A single number is applied to all files, a comma seperated pair: i,j gets the jth column from the ith file. if a tuple x_val is given all y_data will share, else x will be index value from each file. for y_val entry a single number will grab from all files, a comma pair gets one column of data. use the argument -rows to get data by rows instead.
Arguments
-
DATAF
¶
Required argument
Options
VALUE OPTIONS:
-
-alpha
<FLOAT>
¶ transparency for background
- Default
0.5
-
-area
<INTS INTS,INTS>
¶ give as single value (fills to y-min) or 2 values (fills between) order given should match y_vals. colors match line colors, but use the -falpha option
-
-autox
<FLOATS>
¶ auto assign xvals between min,max from axes
-
-axes
<TEXT>
¶ enter as xname,xmin,xmax,yname,ymin,ymax - default usesmin and max of data enter xmin etc to maintain autoscale
- Default
X,xmin,xmax,Y,ymin,ymax
-
-axes2
<TEXT>
¶ enter as ymin,ymax - default usesmin and max of data from y2
- Default
y,ymin,ymax
-
-background
<PATH>
¶ background image for graph area
-
-bg
<TEXT>
¶ background color
- Default
white
-
-bottom
<FLOAT>
¶ use with polar to set bottom of y-axis same units as axes
- Default
0.0
-
-c_vals
<INTS INTS,INTS>
¶ optional index for color vals
-
-cmax
<FLOAT>
¶ scale max for color
-
-cmin
<FLOAT>
¶ scale min for color
-
-colors
<COLORS>
¶ cmap name or space seperated list of rgb tuples 0,0,0 120,120,120 etc. if fewer than # series picks .from gradient includes ru_colors: ‘blu’, ‘org’, ‘pur’, ‘red’, ‘blg’, ‘mag’, ‘brn’, ‘grn’, ‘yel’, ‘ggr’, ‘dark’, ‘med’, ‘light’, ‘xlight’
- Default
viridis
-
-comment
<TEXT>
¶ regex “^[{}].*” indicating comment line indicator
- Default
#
-
-criteria
<TEXT>
¶ plot markers based on criteria (either x=VAL or y=VAL)assumes single solution
-
-dpi
<INTEGER>
¶ image dpi
- Default
200
-
-drange
<INTS>
¶ index range for data series, if None gets all
-
-ecolors
<COLORS>
¶ marker edge colors
- Default
viridis
-
-epositions
<FLOATS>
¶ if cmap is a list positions are the mapping pointselse positions are the sample points used to remap
-
-estep
<INTEGER>
¶ steps for color map
-
-falpha
<FLOAT>
¶ alpha for -area(s)
- Default
0.5
-
-fcol
<FLOAT>
¶ colormap position for first color
- Default
0.0
-
-fg
<TEXT>
¶ foreground color
- Default
black
-
-format
<TEXT>
¶ output file format for default naming (overridden by outf)
- Default
.png
-
-height
<FLOAT>
¶ image height
- Default
5.0
-
-labels
<TEXTS>
¶ input custom series labels, by default uses file name and index or –header option
-
-labelweight
<CHOICE>
¶ text weight for axes labels
- Default
ultralight
- Options
ultralight | light | normal | regular | book | medium | roman | semibold | demibold | demi | bold | heavy | extra bold | black
-
-lw
<FLOATS>
¶ line weight if fewer than # series uses last
- Default
2
-
-m_vals
<INTS INTS,INTS>
¶ optional index for marker size vals, only uses 1 index values should be prescaled to marker size output
-
-mew
<FLOATS>
¶ marker edge width
- Default
0
-
-mmax
<FLOAT>
¶ max for marker size
-
-mmin
<FLOAT>
¶ min for marker size
-
-mrk
<TEXT>
¶ marker style if fewer than # series loops
- Default
o
-
-ms
<FLOATS>
¶ marker size if fewer than # series uses last
- Default
2
-
-outf
<TEXT>
¶ graph output file (defaults to basename of first dataf)
-
-pery
<INTEGER>
¶ label y-axis by percentile with N bins
-
-positions
<FLOATS>
¶ if cmap is a list positions are the mapping points else positions are the sample points used to remap
-
-step
<INTEGER>
¶ steps for color map
-
-weax
<INTS>
¶ use months as x-axis (8760 data) give idx for month andday ex: 1 2 for epw 0 1 for weawhen using –weatherfile use 0 1 for both
-
-width
<FLOAT>
¶ image width
- Default
5.0
-
-x_vals
<INTS INTS,INTS>
¶ index for xvals
- Default
0,0
-
-xrotate
<CHOICE>
¶ orientation of x-axis labels
- Default
auto
- Options
auto | horiz | vert | a | h | v
-
-xticks
<INTEGER>
¶ number of x-ticks/gridlines
-
-y2
<INTS>
¶ idx positions (order from -y_vals) to plot on secondary y-axis
-
-y_vals
<INTS INTS,INTS>
¶ index for yvals
- Default
-1
-
-yticks
<INTEGER>
¶ number of y-ticks/gridlines
FLAGS (DEFAULT TRUE):
-
--polarauto
,
--no-polarauto
¶
ignore x-axis min,max and plot 0-360
- Default
True
-
--xgrid
,
--no-xgrid
¶
plot x grid lines
- Default
True
-
--ygrid
,
--no-ygrid
¶
plot y grid lines
- Default
True
FLAGS (DEFAULT FALSE):
-
--areaonly
,
--no-areaonly
¶
only plot plot area, no legend or axes, for use as background
- Default
False
-
--diagonal
,
--no-diagonal
¶
add diagonal gridline
- Default
False
-
--flipxy
,
--no-flipxy
¶
plot x on vertical axis
- Default
False
-
--front
,
--no-front
¶
plot background in front of data
- Default
False
-
--header
,
--no-header
¶
indicates that data has a header row to get series labels (overridden by labels)
- Default
False
-
--legend
,
--no-legend
¶
include legend in plot
- Default
False
-
--matchxy
,
--no-matchxy
¶
use same range for x and y
- Default
False
-
--polar
,
--no-polar
¶
plot on polar axes
- Default
False
-
--reverse
,
--no-reverse
¶
reverse order of y data (sometimes useful with -autox)
- Default
False
-
--rows
,
--no-rows
¶
get data rows instead of columns
- Default
False
-
--ticklines
,
--no-ticklines
¶
plot tick lines
- Default
False
-
--weatherfile
,
--no-weatherfile
¶
input files will be read as weather files: 0 month, 1 day, 2 hour, 3 dirnorn, 4 difhoriz, 5 globhoriz, 6 skycover
- Default
False
-
--xlog
,
--no-xlog
¶
plot x on log scale
- Default
False
-
--ylog
,
--no-ylog
¶
plot y on log scale
- Default
False
HELP:
-
-opts
,
--opts
¶
check parsed options
- Default
False
-
--debug
¶
show traceback on exceptions
- Default
False
box¶
cl_plot box [OPTIONS] DATAF
create boxplot from data files.
Arguments
-
DATAF
¶
Required argument
Options
VALUE OPTIONS:
-
-alpha
<FLOAT>
¶ transparency for background
- Default
0.5
-
-axes
<TEXT>
¶ enter as xname,xmin,xmax,yname,ymin,ymax - default usesmin and max of data enter xmin etc to maintain autoscale
- Default
X,0,1,Y,0,ymax
-
-background
<PATH>
¶ background image for graph area
-
-bg
<TEXT>
¶ background color
- Default
white
-
-clw
<FLOAT>
¶ linewidth for median line
- Default
1.0
-
-colors
<COLORS>
¶ cmap name or space seperated list of rgb tuples 0,0,0 120,120,120 etc. if fewer than # series picks .from gradient includes ru_colors: ‘blu’, ‘org’, ‘pur’, ‘red’, ‘blg’, ‘mag’, ‘brn’, ‘grn’, ‘yel’, ‘ggr’, ‘dark’, ‘med’, ‘light’, ‘xlight’
- Default
viridis
-
-comment
<TEXT>
¶ regex “^[{}].*” indicating comment line indicator
- Default
#
-
-dpi
<INTEGER>
¶ image dpi
- Default
200
-
-drange
<INTS>
¶ index range for data series, if None gets all
-
-fcol
<FLOAT>
¶ colormap position for first color
- Default
0.0
-
-fg
<TEXT>
¶ foreground color
- Default
black
-
-fillalpha
<FLOAT>
¶ alpha for fill color (matches line color)
- Default
1.0
-
-format
<TEXT>
¶ output file format for default naming (overridden by outf)
- Default
.png
-
-height
<FLOAT>
¶ image height
- Default
5.0
-
-labels
<TEXTS>
¶ input custom x-axis labels, by default uses file name and index or –header option
-
-labelweight
<CHOICE>
¶ text weight for axes labels
- Default
ultralight
- Options
ultralight | light | normal | regular | book | medium | roman | semibold | demibold | demi | bold | heavy | extra bold | black
-
-lw
<FLOAT>
¶ linewidth for box and whiskers
- Default
1.0
-
-mark
<TEXT>
¶ mark for flyers
- Default
x
-
-mew
<FLOAT>
¶ edge weight for flyers
- Default
0.5
-
-ms
<FLOAT>
¶ size for flyers
- Default
3.0
-
-outf
<TEXT>
¶ graph output file (defaults to basename of first dataf)
-
-positions
<FLOATS>
¶ if cmap is a list positions are the mapping points else positions are the sample points used to remap
-
-rwidth
<FLOAT>
¶ relative width of boxs
- Default
0.95
-
-series
<INTEGER>
¶ number of series to plot data in
- Default
1
-
-step
<INTEGER>
¶ steps for color map
-
-whis
<FLOATS>
¶ adapted from matplotlib documentation: As a single number,determines the reach of the whiskers to the beyond the first and third quartiles. In other words, where IQR is the interquartile range (Q3-Q1), the upper whisker will extend to last datum less than Q3 + whis*IQR). Similarly, the lower whisker will extend to the first datum greater than Q1 - whis*IQR. Beyond the whiskers, data are considered outliers and are plotted as individual points. As two numbers, set this to an ascending sequence of percentile (e.g., [5, 95]) to set the whiskers at specific percentiles of the data. ignored if –no-fliers
- Default
1.5
-
-width
<FLOAT>
¶ image width
- Default
5.0
-
-xlabels
<TEXTS>
¶ input custom xaxis labels, by default uses file name androw number or –xheader option
-
-xrotate
<CHOICE>
¶ orientation of x-axis labels
- Default
auto
- Options
auto | horiz | vert | a | h | v
-
-y_vals
<INTS INTS,INTS>
¶ index for yvals
- Default
-1
-
-yticks
<INTEGER>
¶ number of y-ticks/gridlines
FLAGS (DEFAULT TRUE):
-
--clbg
,
--no-clbg
¶
median line uses -bg
- Default
True
-
--fliers
,
--no-fliers
¶
plot notch for 95% confidence interval
- Default
True
FLAGS (DEFAULT FALSE):
-
--areaonly
,
--no-areaonly
¶
only plot plot area, no legend or axes, for use as background
- Default
False
-
--front
,
--no-front
¶
plot background in front of data
- Default
False
-
--header
,
--no-header
¶
indicates that data has a header row to get series labels (overridden by labels)
- Default
False
-
--inline
,
--no-inline
¶
keep boxes inline
- Default
False
-
--legend
,
--no-legend
¶
include legend in plot
- Default
False
-
--mean
,
--median
¶
plot mean line or median line
- Default
False
-
--notch
,
--no-notch
¶
plot notch for 95% confidence interval
- Default
False
-
--rows
,
--no-rows
¶
get data rows instead of columns
- Default
False
-
--ticklines
,
--no-ticklines
¶
plot tick lines
- Default
False
-
--weatherfile
,
--no-weatherfile
¶
input files will be read as weather files: 0 month, 1 day, 2 hour, 3 dirnorn, 4 difhoriz, 5 globhoriz, 6 skycover
- Default
False
-
--xgrid
,
--no-xgrid
¶
plot x grid lines
- Default
False
-
--xheader
,
--no-xheader
¶
indicates that data has a header column to get x-axis labels (overridden by xlabels)
- Default
False
-
--ygrid
,
--no-ygrid
¶
plot y grid lines
- Default
False
-
--ylog
,
--no-ylog
¶
plot y on log scale
- Default
False
HELP:
-
-opts
,
--opts
¶
check parsed options
- Default
False
-
--debug
¶
show traceback on exceptions
- Default
False
violin¶
cl_plot violin [OPTIONS] DATAF
create violinplot from data files.
Arguments
-
DATAF
¶
Required argument
Options
VALUE OPTIONS:
-
-alpha
<FLOAT>
¶ transparency for background
- Default
0.5
-
-axes
<TEXT>
¶ enter as xname,xmin,xmax,yname,ymin,ymax - default usesmin and max of data enter xmin etc to maintain autoscale
- Default
X,0,1,Y,ymin,ymax
-
-background
<PATH>
¶ background image for graph area
-
-bg
<TEXT>
¶ background color
- Default
white
-
-clw
<FLOAT>
¶ linewidth for median line
- Default
1.0
-
-colors
<COLORS>
¶ cmap name or space seperated list of rgb tuples 0,0,0 120,120,120 etc. if fewer than # series picks .from gradient includes ru_colors: ‘blu’, ‘org’, ‘pur’, ‘red’, ‘blg’, ‘mag’, ‘brn’, ‘grn’, ‘yel’, ‘ggr’, ‘dark’, ‘med’, ‘light’, ‘xlight’
- Default
viridis
-
-comment
<TEXT>
¶ regex “^[{}].*” indicating comment line indicator
- Default
#
-
-conf
<FLOAT>
¶ plot confidence interval on data
-
-confm
<FLOAT>
¶ plot confidence interval on mean of data
-
-dpi
<INTEGER>
¶ image dpi
- Default
200
-
-drange
<INTS>
¶ index range for data series, if None gets all
-
-fcol
<FLOAT>
¶ colormap position for first color
- Default
0.0
-
-fg
<TEXT>
¶ foreground color
- Default
black
-
-fillalpha
<FLOAT>
¶ alpha for fill color (matches line color)
- Default
0.5
-
-format
<TEXT>
¶ output file format for default naming (overridden by outf)
- Default
.png
-
-height
<FLOAT>
¶ image height
- Default
5.0
-
-kernelwidth
,
-kw
<FLOAT>
¶ scale factor to apply to kernel bandwidth selector (1 uses scotts rule)
- Default
0.5
-
-labels
<TEXTS>
¶ input custom x-axis labels, by default uses file name and index or –header option
-
-labelweight
<CHOICE>
¶ text weight for axes labels
- Default
ultralight
- Options
ultralight | light | normal | regular | book | medium | roman | semibold | demibold | demi | bold | heavy | extra bold | black
-
-lw
<FLOAT>
¶ linewidth for extrema and vertical line
- Default
1.0
-
-outf
<TEXT>
¶ graph output file (defaults to basename of first dataf)
-
-positions
<FLOATS>
¶ if cmap is a list positions are the mapping points else positions are the sample points used to remap
-
-rwidth
<FLOAT>
¶ relative width of boxs
- Default
0.95
-
-series
<INTEGER>
¶ number of series to pl ot data in
- Default
1
-
-step
<INTEGER>
¶ steps for color map
-
-weightlimit
<FLOAT>
¶ exclude values below weight limit from plot (useful to remove artificial whiskers)
- Default
0.0
-
-weights
<INTS INTS,INTS>
¶ index for weights (if given, must be 1:1 match with y_vals)
-
-width
<FLOAT>
¶ image width
- Default
5.0
-
-xlabels
<TEXTS>
¶ input custom xaxis labels, by default uses file name androw number or –xheader option
-
-xrotate
<CHOICE>
¶ orientation of x-axis labels
- Default
auto
- Options
auto | horiz | vert | a | h | v
-
-y_vals
<INTS INTS,INTS>
¶ index for yvals
- Default
-1
-
-yticks
<INTEGER>
¶ number of y-ticks/gridlines
FLAGS (DEFAULT TRUE):
-
--clbg
,
--no-clbg
¶
median line uses -bg
- Default
True
-
--median
,
--no-median
¶
plot median line
- Default
True
FLAGS (DEFAULT FALSE):
-
--areaonly
,
--no-areaonly
¶
only plot plot area, no legend or axes, for use as background
- Default
False
-
--fliers
,
--no-fliers
¶
plot outliers as fliers
- Default
False
-
--front
,
--no-front
¶
plot background in front of data
- Default
False
-
--header
,
--no-header
¶
indicates that data has a header row to get series labels (overridden by labels)
- Default
False
-
--inline
,
--no-inline
¶
keep violins inline
- Default
False
-
--legend
,
--no-legend
¶
include legend in plot
- Default
False
-
--mean
,
--no-mean
¶
plot mean dot
- Default
False
-
--rows
,
--no-rows
¶
get data rows instead of columns
- Default
False
-
--ticklines
,
--no-ticklines
¶
plot tick lines
- Default
False
-
--weatherfile
,
--no-weatherfile
¶
input files will be read as weather files: 0 month, 1 day, 2 hour, 3 dirnorn, 4 difhoriz, 5 globhoriz, 6 skycover
- Default
False
-
--xgrid
,
--no-xgrid
¶
plot x grid lines
- Default
False
-
--xheader
,
--no-xheader
¶
indicates that data has a header column to get x-axis labels (overridden by xlabels)
- Default
False
-
--ygrid
,
--no-ygrid
¶
plot y grid lines
- Default
False
-
--ylog
,
--no-ylog
¶
plot y on log scale
- Default
False
HELP:
-
-opts
,
--opts
¶
check parsed options
- Default
False
-
--debug
¶
show traceback on exceptions
- Default
False
previewpal¶
cl_plot previewpal [OPTIONS]
create plot color palettes and formatted rgbs
Options
VALUE OPTIONS:
-
-colors
<COLORS>
¶ cmap name or space seperated list of rgb tuples 0,0,0 120,120,120 etc. if fewer than # series picks .from gradient includes ru_colors: ‘blu’, ‘org’, ‘pur’, ‘red’, ‘blg’, ‘mag’, ‘brn’, ‘grn’, ‘yel’, ‘ggr’, ‘dark’, ‘med’, ‘light’, ‘xlight’
- Default
viridis
-
-fcol
<FLOAT>
¶ colormap position for first color
- Default
0.0
-
-n
<INTEGER>
¶ number of series to draw from colormap
- Default
4
-
-outf
<TEXT>
¶ - Default
previewpal.png
-
-positions
<FLOATS>
¶ if cmap is a list positions are the mapping points else positions are the sample points used to remap
-
-step
<INTEGER>
¶ steps for color map
FLAGS (DEFAULT FALSE):
-
--colorbar
,
--series
¶
whether to preview colorbar (continuous) or series (category) scale)
- Default
False
HELP:
-
-opts
,
--opts
¶
check parsed options
- Default
False
-
--debug
¶
show traceback on exceptions
- Default
False
colors¶
cl_plot colors [OPTIONS]
create plot color palettes and formatted rgbs
Options
VALUE OPTIONS:
-
-colors
<COLORS>
¶ cmap name or space seperated list of rgb tuples 0,0,0 120,120,120 etc. if fewer than # series picks .from gradient includes ru_colors: ‘blu’, ‘org’, ‘pur’, ‘red’, ‘blg’, ‘mag’, ‘brn’, ‘grn’, ‘yel’, ‘ggr’, ‘dark’, ‘med’, ‘light’, ‘xlight’
- Default
viridis
-
-fcol
<FLOAT>
¶ colormap position for first color
- Default
0.0
-
-mpal
<TEXT>
¶ matplotlib palette to print r,g,b vals
-
-mpaldiv
<INTEGER>
¶ number of segments
- Default
10
-
-outf
<TEXT>
¶ output file
-
-positions
<FLOATS>
¶ if cmap is a list positions are the mapping points else positions are the sample points used to remap
-
-step
<INTEGER>
¶ steps for color map
FLAGS (DEFAULT TRUE):
-
--rgb
,
--no-tgb
¶
print rgb values for radutil
- Default
True
-
--ru
,
--mat
¶
plot radutil colors (–mat plots matplotlib)
- Default
True
FLAGS (DEFAULT FALSE):
-
--radf
,
--no-radf
¶
print rgb values on 0-1 scale
- Default
False
HELP:
-
-opts
,
--opts
¶
check parsed options
- Default
False
-
--debug
¶
show traceback on exceptions
- Default
False