{point, linechart} docs

Line Charts

===========

The syntax for linecharts is:

    DRAW LINECHART

        [ [ WITH ]

              common_chart_options ]

2D Line Charts

--------------

All 2D Line Chart series must have at least two columns: `x` and `y`. A 2D Line

Chart will draw one line connecting all (x, y) points for each series. 

The type of the x column can be any of `String`, `DateTime`, `Numeric`. The type

of the y column can be any of  `String`, `DateTime`, `Numeric`.

#### Parameters:

<table>

  <tr>

    <th>x <i>(mandatory)</i></th>

    <td>

      the x axis value, type can be any of `String`, `DateTime`, `Numeric`

    </td>

  </tr>

  <tr>

    <th>y <i>(mandatory)</i></th>

    <td>

      the y axis value, type can be any of `String`, `DateTime`, `Numeric`

    </td>

  </tr>

  <tr>

    <th>series <i>(optional)</i></th>

    <td>

      if set, each series will be displayed as a separate line

    </td>

  </tr>

  <tr>

    <th>linestyle <i>(optional)</i></th>

    <td>

      the line style, valid values are `solid` and `none`. default: `solid`

    </td>

  </tr>

  <tr>

    <th>linewidth <i>(optional)</i></th>

    <td>

      the line width in pixel. default: 2

    </td>

  </tr>

  <tr>

    <th>pointstyle <i>(optional)</i></th>

    <td>

      the poiny style, valid values are `circle` and `none`. default: `none`

    </td>

  </tr>

  <tr>

    <th>pointsize <i>(optional)</i></th>

    <td>

      the line width in pixel. default: 4

    </td>

  </tr>

  <tr>

    <th>label <i>(optional)</i></th>

    <td>

      a label to be displayed above each point

    </td>

  </tr>

  <tr>

    <th>color <i>(optional)</i></th>

    <td>

      the line/point color (hex value, eg. #ff0000)

    </td>

  </tr>

</table>

Examples

--------

#### Multi-Series Line Chart:

<img src="/img/examples_lines_with_points.png" width="800" />

    IMPORT TABLE city_temperatures

       FROM 'csv:examples/data/city_temperatures.csv?headers=true';

    DRAW LINECHART WITH

       AXIS LEFT

       AXIS BOTTOM

       LEGEND TOP LEFT INSIDE;

    SELECT

       city AS series,

       month AS x,

       temperature AS y,

       "Avg. Temperatures in " + month + " in " + city + ": " + temperature as label,

       "circle" as pointstyle

       FROM city_temperatures;

#### Lines with labels:

<img src="/img/examples_lines_with_labels.png" width="800" />

    IMPORT TABLE city_temperatures

       FROM 'csv:examples/data/city_temperatures.csv?headers=true';

    DRAW LINECHART WITH

       AXIS LEFT

       AXIS BOTTOM

       LABELS

       YDOMAIN -10, 40

       LEGEND TOP LEFT INSIDE;

    SELECT city AS series, month AS x, temperature AS y, temperature + "°C" as label, "circle" as pointstyle

       FROM city_temperatures

       WHERE city = "Berlin";

Point Charts

===========

The syntax for pointcharts is:

    DRAW POINTCHART

        [ [ WITH ]

              common_chart_options ]

2D Point Charts

---------------

All 2D Point Chart series must have at least two columns: `x` and `y`. A 3D Point

Chart will draw one point at (x, y) for each input row.

The type of the x column can be any of `String`, `DateTime`, `Numeric`. The type

of the y column can be any of  `String`, `DateTime`, `Numeric`.

#### Parameters:

<table>

  <tr>

    <th>x <i>(mandatory)</i></th>

    <td>

      the x axis value, type can be any of `String`, `DateTime`, `Numeric`

    </td>

  </tr>

  <tr>

    <th>y <i>(mandatory)</i></th>

    <td>

      the y axis value, type can be any of `String`, `DateTime`, `Numeric`

    </td>

  </tr>

  <tr>

    <th>series <i>(optional)</i></th>

    <td>

      if set, each series will be displayed as a distinct collection of points

      (i.e. in a different color)

    </td>

  </tr>

  <tr>

    <th>pointstyle <i>(optional)</i></th>

    <td>

      the poiny style, valid values are `circle` and `none`. default: `none`

    </td>

  </tr>

  <tr>

    <th>pointsize <i>(optional)</i></th>

    <td>

      the line width in pixel. default: 4

    </td>

  </tr>

  <tr>

    <th>label <i>(optional)</i></th>

    <td>

      a label to be displayed above each point

    </td>

  </tr>

  <tr>

    <th>color <i>(optional)</i></th>

    <td>

      the line/point color (hex value, eg. #ff0000)

    </td>

  </tr>

</table>

3D Point Charts

---------------

All 3D Point Chart series must have at least three columns: `x`, `y` and `z`.

A 3D Point Chart will draw one point at (x, y) with size z for each input row.

The type of the x column can be any of `String`, `DateTime`, `Numeric`.

The type of the y column can be any of  `String`, `DateTime`, `Numeric`. The

type of the z column must be `Numeric`.

#### Parameters:

<table>

  <tr>

    <th>x <i>(mandatory)</i></th>

    <td>

      the x axis value, type can be any of `String`, `DateTime`, `Numeric`

    </td>

  </tr>

  <tr>

    <th>y <i>(mandatory)</i></th>

    <td>

      the y axis value, type can be any of `String`, `DateTime`, `Numeric`

    </td>

  </tr>

  <tr>

    <th>z <i>(mandatory)</i></th>

    <td>

      the point size, type must be `Numeric`

    </td>

  </tr>

  <tr>

    <th>series <i>(optional)</i></th>

    <td>

      if set, each series will be displayed as a distinct collection of points

      (i.e. in a different color)

    </td>

  </tr>

  <tr>

    <th>pointstyle <i>(optional)</i></th>

    <td>

      the poiny style, valid values are `circle` and `none`. default: `none`

    </td>

  </tr>

  <tr>

    <th>label <i>(optional)</i></th>

    <td>

      a label to be displayed above each point

    </td>

  </tr>

  <tr>

    <th>color <i>(optional)</i></th>

    <td>

      the line/point color (hex value, eg. #ff0000)

    </td>

  </tr>

</table>

Examples

--------

#### 2D Point Chart:

<img src="/img/examples_simple_scatter.png" width="800" />

    IMPORT TABLE example_data

       FROM 'csv:examples/data/point_example.csv?headers=true';

    DRAW POINTCHART WITH

       AXIS BOTTOM

       AXIS LEFT

       AXIS TOP

       AXIS RIGHT

       GRID HORIZONTAL VERTICAL;

    SELECT series AS series, x AS x, y AS y

       FROM example_data;

#### 3D Point Chart with Labels:

<img src="/img/examples_pointchart_with_labels.png" width="800" />

    IMPORT TABLE example_data

       FROM 'csv:examples/data/point_example.csv?headers=true';

    DRAW POINTCHART WITH

       AXIS BOTTOM

       AXIS LEFT

       AXIS TOP

       AXIS RIGHT

       YDOMAIN -40, 60

       LABELS;

    SELECT series AS series, x AS x, y AS y, z as z, z as label

       FROM example_data;

      #  url: "/query_language/reference"

      -

        title: "Line Charts"

        url: "/query_language/reference"

        url: "/chartsql/linecharts"

        file: "chartsql_linecharts"

      -

        title: "Point Charts"

        url: "/query_language/reference"

        url: "/chartsql/pointcharts"

        file: "chartsql_pointcharts"

      -

        title: "Area Charts"

        url: "/query_language/reference"