Bipolar chart API reference

Summary: Documentation about the Bipolar chart including details about all of the options that are available to you. The Bipolar chart is an easy way to represent two sets of data and present them side-by-side. The SVG Bipolar chart also supports stacked and grouped variations.

• Example
• Properties
• Methods
• Custom RGraph events that are available
• Coordinates
• Effects

Example

<script>
    // The Bipolar chart accepts two arrays of data - one for the left side and one for the right.
    left  = [[4,8,6],[4,3,2],[9,8,5]];
    right = [[4,6,5],[3,2,2],[4,5,6]];

    new RGraph.Bipolar({
        id: 'cvs',
        left: left,
        right: right,
        options: {
            //grouping: 'stacked',
            backgroundGridHlines: false,
            backgroundGridBorder: false,
            titleLeftBold: true,
            titleLeftSize: 18,
            titleRightBold: true,
            titleRightSize: 18,
            colors: ['red','blue','green'],
            marginInner:15,
            yaxisLabels: ['Barry', 'John', 'Fred'],
            tooltips: '<b>Results:</b><br/>%{key}',
            tooltipsFormattedKeyLabels: ['8pm','9pm','10pm'],
            titleLeft: '2007',
            titleRight: '2008',
            marginBottom: 45,
            xaxis: false,
            tooltipsCss: {
                fontSize: '16pt',
                textAlign: 'left',
                border: '3px solid black'
            }
        }
    }).draw();
</script>

Properties

You can use these properties to control how the chart appears. You can set them by using the set() method. Eg:

myBipolar.set('name', 'value');

• Background properties
• General axis properties
• X axis properties
• Y axis properties
• Color properties
• Margin properties
• Other label properties
• Title properties
• Shadow properties
• Interactive features properties
• Miscellaneous properties

Background properties

General axis properties

Margin properties

X axis properties

function myFormatter(obj, num)
{
    return num + 'F'; // An example of formatting
}
myGraph.set('xaxisScaleFormatter', myFormatter);

function myFormatter(obj, num)
{
    return num + 'F'; // An example of formatting
}
myGraph.set('xaxisScaleFormatter', myFormatter);

Y axis properties

Color properties

Other label properties

labelsAboveFormatter: function (obj, num)
{
    return '42';
}

<div style="margin-left: 50px; display: inline-block">
    <canvas id="cvs" width="650" height="250"></canvas>
</div>

labelsAboveFormatter: function (obj, num)
{
    return '42';
}

<div style="margin-left: 50px; display: inline-block">
    <canvas id="cvs" width="650" height="250"></canvas>
</div>

Title properties

Shadow properties

Interactive features properties

tooltipsCss: {
    fontFamily: 'Verdana',
    fontSize: '20pt',
    backgroundColor: 'black',
    color: 'white'
}

tooltipsCss: {
    fontFamily: 'Verdana',
    fontSize: '20pt',
    backgroundColor: 'black',
    color: 'white'
}

Miscellaneous properties

Methods

<script>
    obj.canvas.onclick = function (e)
    {
        RGraph.redraw();
    
        var canvas  = e.target,
            obj     = canvas.__object__,
            shape   = obj.getShape(e);

        if (shape) {
            var x      = shape.x,
                y      = shape.y,
                width  = shape.width,
                height = shape.height;
            
            obj.path(
                'b r % % % % s black f red',
                x, y, width, height
            );
        }
    }
</script>

This method can be used to get an appropriate X coordinate for a value when you're doing custom drawing on the chart. It returns an array containing two values - one for each side - and it returns null if the value is out of range.

This method can be used to set an event listener on an object. It operates in a similar way to the jQuery on() function. The first argument is the event that you wish to attach to and the second is the handler function. For example:

bipolar.on('draw', function (obj)
{
    // Put your event code here
});

The exec function is documented here.

Custom RGraph events that are available

Custom RGraph events are events that RGraph fires when certain actions occur. There is a more comprehensive list of these events here . Here's some example code that show you how to add these events to your chart.

• click
• mousemove
• mouseover
• mouseout

There's more documentation about events available here: Summary of events documentation

<script>
    bipolar = new RGraph.Bipolar({
        id: 'cvs',
        left: [8,4,6,3,5,4,8],
        right: [6,4,2,3,5,4,2],
        options: {
        }
    }).draw().on('click', function (e, shape)
    {
        // Add your click event listener code here

    }).on('mousemove', function (e, shape)
    {
        // Add your mousemove event listener code here

    }).on('mouseover', function (e, shape)
    {
        // Add your mouseover event listener code here

    }).on('mouseout', function (obj)
    {
        // Add your mouseout event listener code here
    });
</script>

Coordinates

There are 6 coordinates arrays available to you with the Bipolar chart. These are:

• obj.coords
  This is an array consisting of all of the coordinates for the bars on the chart - both left and right sides. Each bars coordinates (an array that consists of x, y, width and height) are appended to this array.
  
  
• obj.coordsLeft
  Like the obj.coords array but only the left-hand-sides coordinates.
  
  
• obj.coordsRight
  Like the obj.coords array but only the right-hand-sides coordinates.
  
  
• obj.coords2
  This only applies to stacked and grouped charts. Like the obj.coords array this contains all of the charts coordinates (both the left and right sides) but the method of indexing is different. The first index (obj.coords2[0]) contains all of the first stacks/groups coordinates - which may well be multiple bars. So if you have a stack/group that consists of three bars, obj.coords2[0][0] is the first bar in that stack/group (which will be an array of x, y, width and height), obj.coords2[0][1] is the second bar in that stack/group and obj.coords2[0][2] is the third bar in the stack/group. If you're unsure of the structure of these arrays then the console.log() function or the RGraph $p() function will show them to you more clearly.
  
  
• obj.coords2Left
  Like the obj.coords2 array but only the left-hand-sides bars.
  
  
• obj.coords2Right
  Like the obj.coords2 array but only the right-hand-sides bars.
  
  

Animation effects

• The Grow effect (you can see an example in the download archive)
• Wave effect (you can see an example in the download archive)

<script>
    window.onload = (function ()
    {
        /**
        * Optional callback function that's called when the effect is complete
        */
        function myCallback (obj)
        {
            // ...
        }
    
    
        var left  = [4,8,6,3,1,2,5];
        var right = [15,13,18,19,12,16,14];
    
        var bipolar = new RGraph.Bipolar({
            id: 'cvs',
            left: left,
            right: right,
            options: {
                marginCenter: 135,
                titleLeft: 'August 2013',
                titleRight: 'August 2014',
                textSize: 16,
                textColor: '#666',
                yaxisLabels: ['Monday','Tuesday','Wednesday','Thursday','Friday','Saturday','Sunday'],
                colors: ['Gradient(red:red:red:#a00:#a00:#a00:#600:#a00:red:red:red)']
            }
        }).grow({frames: 60}, myCallback);
        //}).wave({frames: 60}, myCallback);
    });
</script>