ChartDirector 6.0 (Ruby Edition)

4 Quadrant Chart




This example demonstrates 4 quadrant charts in which the x-axis and y-axis meet at the origin at the center of the plot area.

By default, ChartDirector puts the axes at the border of the plot area. This avoids the axis labels and the chart contents from overlapping and making the chart hard to read.

In some cases, it may be desirable to have one or both axes to intersect with the zero point of the other axis, where the zero point can be inside the plot area. In ChartDirector, these kinds of axis configurations may be set up with XYChart.setAxisAtOrigin.

This example also demonstrates using PlotArea.set4QBgColor to specify 4 background colors for the 4 quadrants.

Source Code Listing

[Ruby On Rails Version - Controller] app/controllers/fourq_controller.rb
require("chartdirector")

class FourqController < ApplicationController

    def index()
        @title = "4 Quadrant Chart"
        @ctrl_file = File.expand_path(__FILE__)
        @noOfCharts = 1
        render :template => "templates/chartview"
    end

    #
    # Render and deliver the chart
    #
    def getchart()
        # XY points for the scatter chart
        dataX0 = [10, 15, 6, -12, 14, -8, 13, -13, 16, 12, 10.5]
        dataY0 = [130, 150, 80, 110, -110, -105, -130, 115, -170, 125, 125]

        dataX1 = [6, 7, -4, 3.5, 7, 8, -9, -10, -12, 11, 8]
        dataY1 = [65, -40, -40, 45, -70, -80, 80, 10, -100, 105, 60]

        dataX2 = [-10, -12, 11, 8, 6, 12, -4, 3.5, 7, 8, -9]
        dataY2 = [65, -80, -40, 45, -70, -80, 80, 90, -100, 105, 60]

        # Create a XYChart object of size 600 x 300 pixels, with a light blue (ccccff) background, a
        # black border, and 1 pixel 3D border effect
        c = ChartDirector::XYChart.new(600, 480, 0xccccff, 0x000000, 1)

        # Add a title box to the chart using 16pt Arial Bold Italic font, with white text on deep
        # blue background
        c.addTitle("Four Quadrant Chart Demonstration", "arialbi.ttf", 16, 0xffffff).setBackground(
            0x000080)

        # Set the plotarea at (20, 60) and of size 560 x 360 pixels, with grey (808080) border, and
        # light grey (c0c0c0) horizontal and vertical grid lines. Set 4 quadrant coloring, where the
        # colors of the quadrants alternate between lighter and deeper grey (dddddd/eeeeee)
        c.setPlotArea(20, 60, 560, 360, -1, -1, 0x808080, 0xc0c0c0, 0xc0c0c0).set4QBgColor(0xdddddd,
            0xeeeeee, 0xdddddd, 0xeeeeee)

        # Set 4 quadrant mode, with both x and y axes symetrical around the origin
        c.setAxisAtOrigin(ChartDirector::XYAxisAtOrigin,
            ChartDirector::XAxisSymmetric + ChartDirector::YAxisSymmetric)

        # Add a legend box at (300, 460) (bottom center of the chart) with horizontal layout. Use
        # 8pt Arial Bold font.
        legendBox = c.addLegend(300, 460, false, "arialbd.ttf", 8)
        legendBox.setAlignment(ChartDirector::BottomCenter)

        # Set legend box background to light grey (dddddd) with a black border
        legendBox.setBackground(0xdddddd, 0)

        # Set left/right margin to 20 pixels and top/bottom margin to 5 pixels
        legendBox.setMargin2(20, 20, 5, 5)

        # Add a titles to axes
        c.xAxis().setTitle("Alpha Index")
        c.yAxis().setTitle("Beta Index")

        # Set axes width to 2 pixels
        c.xAxis().setWidth(2)
        c.yAxis().setWidth(2)

        # Add scatter layer, using 15 pixels red (ff33333) X shape symbols
        c.addScatterLayer(dataX0, dataY0, "Group A", ChartDirector::Cross2Shape(), 15, 0xff3333)

        # Add scatter layer, using 15 pixels green (33ff33) 6-sided polygon symbols
        c.addScatterLayer(dataX1, dataY1, "Group B", ChartDirector::PolygonShape(6), 15, 0x33ff33)

        # Add scatter layer, using 15 pixels blue (3333ff) triangle symbols
        c.addScatterLayer(dataX2, dataY2, "Group C", ChartDirector::TriangleSymbol, 15, 0x3333ff)

        # Output the chart
        send_data(c.makeChart2(ChartDirector::PNG), :type => "image/png", :disposition => "inline")

    end

end

[Ruby On Rails Version - View] app/views/templates/chartview.html.erb
<html>
<body style="margin:5px 0px 0px 5px">

<!-- Title -->
<div style="font-size:18pt; font-family:verdana; font-weight:bold">
    <%= @title %>
</div>
<hr style="border:solid 1px #000080" />

<!-- Source Code Listing Link -->
<div style="font-size:9pt; font-family:verdana; margin-bottom:1.5em">
    <%= link_to "Source Code Listing", 
        :controller => "cddemo", :action => "viewsource",
        :ctrl_file => @ctrl_file, :view_file => File.expand_path(__FILE__) %>
</div>

<!-- Create one or more IMG tags to display the demo chart(s) -->
<% 0.upto(@noOfCharts - 1) do |i| %>
    <img src="<%= url_for(:action => "getchart", :img => i) %>">
<% end %>

</body>
</html>

[Command Line Version] rubydemo/fourq.rb
#!/usr/bin/env ruby
require("chartdirector")

# XY points for the scatter chart
dataX0 = [10, 15, 6, -12, 14, -8, 13, -13, 16, 12, 10.5]
dataY0 = [130, 150, 80, 110, -110, -105, -130, 115, -170, 125, 125]

dataX1 = [6, 7, -4, 3.5, 7, 8, -9, -10, -12, 11, 8]
dataY1 = [65, -40, -40, 45, -70, -80, 80, 10, -100, 105, 60]

dataX2 = [-10, -12, 11, 8, 6, 12, -4, 3.5, 7, 8, -9]
dataY2 = [65, -80, -40, 45, -70, -80, 80, 90, -100, 105, 60]

# Create a XYChart object of size 600 x 300 pixels, with a light blue (ccccff) background, a black
# border, and 1 pixel 3D border effect
c = ChartDirector::XYChart.new(600, 480, 0xccccff, 0x000000, 1)

# Add a title box to the chart using 16pt Arial Bold Italic font, with white text on deep blue
# background
c.addTitle("Four Quadrant Chart Demonstration", "arialbi.ttf", 16, 0xffffff).setBackground(0x000080)

# Set the plotarea at (20, 60) and of size 560 x 360 pixels, with grey (808080) border, and light
# grey (c0c0c0) horizontal and vertical grid lines. Set 4 quadrant coloring, where the colors of the
# quadrants alternate between lighter and deeper grey (dddddd/eeeeee)
c.setPlotArea(20, 60, 560, 360, -1, -1, 0x808080, 0xc0c0c0, 0xc0c0c0).set4QBgColor(0xdddddd,
    0xeeeeee, 0xdddddd, 0xeeeeee)

# Set 4 quadrant mode, with both x and y axes symetrical around the origin
c.setAxisAtOrigin(ChartDirector::XYAxisAtOrigin,
    ChartDirector::XAxisSymmetric + ChartDirector::YAxisSymmetric)

# Add a legend box at (300, 460) (bottom center of the chart) with horizontal layout. Use 8pt Arial
# Bold font.
legendBox = c.addLegend(300, 460, false, "arialbd.ttf", 8)
legendBox.setAlignment(ChartDirector::BottomCenter)

# Set legend box background to light grey (dddddd) with a black border
legendBox.setBackground(0xdddddd, 0)

# Set left/right margin to 20 pixels and top/bottom margin to 5 pixels
legendBox.setMargin2(20, 20, 5, 5)

# Add a titles to axes
c.xAxis().setTitle("Alpha Index")
c.yAxis().setTitle("Beta Index")

# Set axes width to 2 pixels
c.xAxis().setWidth(2)
c.yAxis().setWidth(2)

# Add scatter layer, using 15 pixels red (ff33333) X shape symbols
c.addScatterLayer(dataX0, dataY0, "Group A", ChartDirector::Cross2Shape(), 15, 0xff3333)

# Add scatter layer, using 15 pixels green (33ff33) 6-sided polygon symbols
c.addScatterLayer(dataX1, dataY1, "Group B", ChartDirector::PolygonShape(6), 15, 0x33ff33)

# Add scatter layer, using 15 pixels blue (3333ff) triangle symbols
c.addScatterLayer(dataX2, dataY2, "Group C", ChartDirector::TriangleSymbol, 15, 0x3333ff)

# Output the chart
c.makeChart("fourq.png")