Skip to content

Releases: eobermuhlner/csv2chart

Release 0.0.1

12 Jun 09:00
Compare
Choose a tag to compare
NAME
    csv2chart - create chart from csv file

SYNOPSIS
    csv2chart [options] [csv-files]

DESCRIPTION
   Options may be set in the command line, as comments in the csv file or in a properties file with the same basename as the csv file.
   Command line options are prefixed with --.
   Options in the csv file can be specified in comments at the top of the file, prefixed with 'csv2chart.'.
   Example: 
       # csv2chart.title=Sales - Sections
       # csv2chart.chart=pie
   Options in properties files are specified without prefix.
   Example: 
       title=Sales - Sections
       chart=pie

OPTIONS
    --properties filename
        Loads the specified properties file.

    --property key=value
        Set the specified property.

    --data-colors name
        Color scheme to render data.
        Supported schemes: wheel, random
        Default: wheel
        In properties files and csv comments this value can be set by using the key 'data-colors'.

    --format format
        Format of output chart files.
        Supported formats: svg, png, jpg
        Default: svg
        In properties files and csv comments this value can be set by using the key 'out.format'.

    --height pixels
        The height of the generated charts in pixels.
        Default: 600
        In properties files and csv comments this value can be set by using the key 'out.height'.

    --locale locale
        The locale used for formatting values.
        The format is: language_country
        For example: en_US for US english.
        Default: system locale
        In properties files and csv comments this value can be set by using the key 'locale'.

    --out-dir path
        The output directory.
        Default: same directory as the input file
        In properties files and csv comments this value can be set by using the key 'out.dir'.

    --out-postfix text
        Postfix for output chart files.
        Default: ''
        In properties files and csv comments this value can be set by using the key 'out.postfix'.

    --out-prefix text
        Prefix for output chart files.
        Default: ''
        In properties files and csv comments this value can be set by using the key 'out.prefix'.

    --theme name
        Color theme.
        Supported themes: light, dark, lightSolarized, darkSolarized
        Default: light
        In properties files and csv comments this value can be set by using the key 'theme'.

    --width pixels
        The width of the generated charts in pixels.
        Default: 800
        In properties files and csv comments this value can be set by using the key 'out.width'.


PROPERTIES
   The following properties can be set in the properties file or as comments in the input files.

   chart
        The chart type to generate.
        Supported types: auto, bar, line, xyline, pie, bubble, scatter, heat
        Default: auto

   color.axis.label
        Color of the axis labels.

   color.axis.line
        Color of the axis line.

   color.background
        Color of the background.

   color.grid.band
        Color of the grid band.

   color.grid.line
        Color of the grid lines.

   color.label
        Color of the text labels.

   color.legend
        Color of the legend.

   color.subtitle
        Color of the subtitle.

   color.title
        Color of the title.

   data-color-alpha
        Alpha value of data colors.
        Supported values: 0.0 - 1.0
        Default: 0.8

   data-color-brightness
        Brightness of data colors.
        Supported values: 0.0 - 1.0
        Default: 0.9

   data-color-saturation
        Saturation of data colors.
        Supported values: 0.0 - 1.0
        Default: 0.7

   data-colors
        Color scheme to render data.
        Supported schemes: wheel, random
        Default: wheel

   legend
        Shows a legend for the value categories where necessary.
        Default: Dynamically determined (generally true)

   locale
        The locale used for formatting values.
        The format is: language_country
        For example: en_US for US english.
        Default: system locale

   matrix-x-values
        Specifies whether the first row of matrix values is used as values on the x-axis.
        Default: true

   matrix-y-values
        Specifies whether the first row of matrix values is used as values on the x-axis.
        Default: true

   out.dir
        The output directory.
        Default: same directory as the input file

   out.format
        Format of output chart files.
        Supported formats: svg, png, jpg
        Default: svg

   out.height
        The height of the generated charts in pixels.
        Default: 600

   out.postfix
        Postfix for output chart files.
        Default: ''

   out.prefix
        Prefix for output chart files.
        Default: ''

   out.width
        The width of the generated charts in pixels.
        Default: 800

   scale-default-color
        Default color of the color scale used for non-existing values.

   scale-max-color
        Maximum color of the color scale as a hex value (RRGGBB).

   scale-max-value
        Maximum value of the color scale.

   scale-mid-color
        Mid color of the color scale as a hex value (RRGGBB).

   scale-mid-value
        Mid value of the color scale.

   scale-min-color
        Minimum color of the color scale as a hex value (RRGGBB).

   scale-min-value
        Minimum value of the color scale.

   subtitle
        Text to appear as sub title in the chart.
        Default: none

   theme
        Color theme.
        Supported themes: light, dark, lightSolarized, darkSolarized
        Default: light

   title
        Text to appear as title in the chart.
        Default: basename of the input file

   value-labels
        Labels appear next to the values where possible.
        Default: Dynamically determined by the parameter 'value-labels-threshold'

   value-labels-threshold
        Threshold of value labels count to switch from a separate legend to value labels.
        Default: 5

   visible.domain.axis.line
        Controls whether the domain axis is visible.

   visible.domain.grid.line
        Controls whether the domain grid line is visible.

   visible.range.axis.line
        Controls whether the range axis is visible.

   visible.range.grid.line
        Controls whether the range grid line is visible.

   x-axis
        Text to appear as label on the x-axis.

   y-axis
        Text to appear as label on the y-axis.

   z-axis
        Text to appear as label on the z-axis.