ChartDirector Ver 4.1 (Ruby Edition)

Multi-Color Gantt Chart




This example demonstrates a multi-color gantt chart with milestone symbols.

The bars in this chart come from a multi-color box-whisker layer created using XYChart.addBoxWhiskerLayer2. The scatter symbols come from scatter layers created using XYChart.addScatterLayer.

In this example, a data series is used to specify the task number of the bars. This allows multiple bars to associated with the same task. The task numbers act as the x-coordinates of the bars and are set to the box-whisker layer using Layer.setXData. Another data series is used to specify the colors of the bars. This allows the bars to have different colors.

Source Code Listing

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

class ColorganttController < ApplicationController

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

    #
    # Render and deliver the chart
    #
    def getchart()
        # The tasks for the gantt chart
        labels = ["Market Research", "Define Specifications", "Overall Archiecture",
            "Project Planning", "Detail Design", "Software Development", "Test Plan",
            "Testing and QA", "User Documentation"]

        # The task index, start date, end date and color for each bar
        taskNo = [0, 0, 1, 2, 3, 4, 5, 6, 6, 7, 8, 8]
        startDate = [Time.mktime(2004, 8, 16), Time.mktime(2004, 10, 4), Time.mktime(2004,
            8, 30), Time.mktime(2004, 9, 13), Time.mktime(2004, 9, 20), Time.mktime(2004,
            9, 27), Time.mktime(2004, 10, 4), Time.mktime(2004, 10, 4), Time.mktime(2004,
            10, 25), Time.mktime(2004, 11, 1), Time.mktime(2004, 10, 18), Time.mktime(
            2004, 11, 8)]
        endDate = [Time.mktime(2004, 8, 30), Time.mktime(2004, 10, 18), Time.mktime(2004,
            9, 13), Time.mktime(2004, 9, 27), Time.mktime(2004, 10, 4), Time.mktime(2004,
            10, 11), Time.mktime(2004, 11, 8), Time.mktime(2004, 10, 18), Time.mktime(
            2004, 11, 8), Time.mktime(2004, 11, 22), Time.mktime(2004, 11, 1),
            Time.mktime(2004, 11, 22)]
        colors = [0x00cc00, 0x00cc00, 0x00cc00, 0x0000cc, 0x0000cc, 0xcc0000, 0xcc0000,
            0x0000cc, 0xcc0000, 0xcc0000, 0x00cc00, 0xcc0000]

        # Create a XYChart object of size 620 x 325 pixels. Set background color to light
        # red (0xffcccc), with 1 pixel 3D border effect.
        c = ChartDirector::XYChart.new(620, 325, 0xffcccc, 0x000000, 1)

        # Add a title to the chart using 15 points Times Bold Itatic font, with white
        # (ffffff) text on a dark red (800000) background
        c.addTitle("Mutli-Color Gantt Chart Demo", "timesbi.ttf", 15, 0xffffff
            ).setBackground(0x800000)

        # Set the plotarea at (140, 55) and of size 460 x 200 pixels. Use alternative
        # white/grey background. Enable both horizontal and vertical grids by setting
        # their colors to grey (c0c0c0). Set vertical major grid (represents month
        # boundaries) 2 pixels in width
        c.setPlotArea(140, 55, 460, 200, 0xffffff, 0xeeeeee, ChartDirector::LineColor,
            0xc0c0c0, 0xc0c0c0).setGridWidth(2, 1, 1, 1)

        # swap the x and y axes to create a horziontal box-whisker chart
        c.swapXY()

        # Set the y-axis scale to be date scale from Aug 16, 2004 to Nov 22, 2004, with
        # ticks every 7 days (1 week)
        c.yAxis().setDateScale(Time.mktime(2004, 8, 16), Time.mktime(2004, 11, 22),
            86400 * 7)

        # Set multi-style axis label formatting. Month labels are in Arial Bold font in
        # "mmm d" format. Weekly labels just show the day of month and use minor tick (by
        # using '-' as first character of format string).
        c.yAxis().setMultiFormat(ChartDirector::StartOfMonthFilter(),
            "<*font=arialbd.ttf*>{value|mmm d}", ChartDirector::StartOfDayFilter(),
            "-{value|d}")

        # Set the y-axis to shown on the top (right + swapXY = top)
        c.setYAxisOnRight()

        # Set the labels on the x axis
        c.xAxis().setLabels(labels)

        # Reverse the x-axis scale so that it points downwards.
        c.xAxis().setReverse()

        # Set the horizontal ticks and grid lines to be between the bars
        c.xAxis().setTickOffset(0.5)

        # Add some symbols to the chart to represent milestones. The symbols are added
        # using scatter layers. We need to specify the task index, date, name, symbol
        # shape, size and color.
        c.addScatterLayer([1], [Time.mktime(2004, 9, 13)], "Milestone 1",
            ChartDirector::Cross2Shape(), 13, 0xffff00)
        c.addScatterLayer([3], [Time.mktime(2004, 10, 4)], "Milestone 2",
            ChartDirector::StarShape(5), 15, 0xff00ff)
        c.addScatterLayer([5], [Time.mktime(2004, 11, 8)], "Milestone 3",
            ChartDirector::TriangleSymbol, 13, 0xff9933)

        # Add a multi-color box-whisker layer to represent the gantt bars
        layer = c.addBoxWhiskerLayer2(startDate, endDate, nil, nil, nil, colors)
        layer.setXData(taskNo)
        layer.setBorderColor(ChartDirector::SameAsMainColor)

        # Divide the plot area height ( = 200 in this chart) by the number of tasks to get
        # the height of each slot. Use 80% of that as the bar height.
        layer.setDataWidth((200 * 4 / 5 / (labels.length)).to_i)

        # Add a legend box at (140, 265) - bottom of the plot area. Use 8 pts Arial Bold
        # as the font with auto-grid layout. Set the width to the same width as the plot
        # area. Set the backgorund to grey (dddddd).
        legendBox = c.addLegend2(140, 265, ChartDirector::AutoGrid, "arialbd.ttf", 8)
        legendBox.setWidth(461)
        legendBox.setBackground(0xdddddd)

        # The keys for the scatter layers (milestone symbols) will automatically be added
        # to the legend box. We just need to add keys to show the meanings of the bar
        # colors.
        legendBox.addKey("Market Team", 0x00cc00)
        legendBox.addKey("Planning Team", 0x0000cc)
        legendBox.addKey("Development Team", 0xcc0000)

        # 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.rhtml
<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/colorgantt.rb
#!/usr/bin/env ruby
require("chartdirector")

# The tasks for the gantt chart
labels = ["Market Research", "Define Specifications", "Overall Archiecture",
    "Project Planning", "Detail Design", "Software Development", "Test Plan",
    "Testing and QA", "User Documentation"]

# The task index, start date, end date and color for each bar
taskNo = [0, 0, 1, 2, 3, 4, 5, 6, 6, 7, 8, 8]
startDate = [Time.mktime(2004, 8, 16), Time.mktime(2004, 10, 4), Time.mktime(2004, 8,
    30), Time.mktime(2004, 9, 13), Time.mktime(2004, 9, 20), Time.mktime(2004, 9, 27
    ), Time.mktime(2004, 10, 4), Time.mktime(2004, 10, 4), Time.mktime(2004, 10, 25),
    Time.mktime(2004, 11, 1), Time.mktime(2004, 10, 18), Time.mktime(2004, 11, 8)]
endDate = [Time.mktime(2004, 8, 30), Time.mktime(2004, 10, 18), Time.mktime(2004, 9,
    13), Time.mktime(2004, 9, 27), Time.mktime(2004, 10, 4), Time.mktime(2004, 10, 11
    ), Time.mktime(2004, 11, 8), Time.mktime(2004, 10, 18), Time.mktime(2004, 11, 8),
    Time.mktime(2004, 11, 22), Time.mktime(2004, 11, 1), Time.mktime(2004, 11, 22)]
colors = [0x00cc00, 0x00cc00, 0x00cc00, 0x0000cc, 0x0000cc, 0xcc0000, 0xcc0000,
    0x0000cc, 0xcc0000, 0xcc0000, 0x00cc00, 0xcc0000]

# Create a XYChart object of size 620 x 325 pixels. Set background color to light red
# (0xffcccc), with 1 pixel 3D border effect.
c = ChartDirector::XYChart.new(620, 325, 0xffcccc, 0x000000, 1)

# Add a title to the chart using 15 points Times Bold Itatic font, with white
# (ffffff) text on a dark red (800000) background
c.addTitle("Mutli-Color Gantt Chart Demo", "timesbi.ttf", 15, 0xffffff
    ).setBackground(0x800000)

# Set the plotarea at (140, 55) and of size 460 x 200 pixels. Use alternative
# white/grey background. Enable both horizontal and vertical grids by setting their
# colors to grey (c0c0c0). Set vertical major grid (represents month boundaries) 2
# pixels in width
c.setPlotArea(140, 55, 460, 200, 0xffffff, 0xeeeeee, ChartDirector::LineColor,
    0xc0c0c0, 0xc0c0c0).setGridWidth(2, 1, 1, 1)

# swap the x and y axes to create a horziontal box-whisker chart
c.swapXY()

# Set the y-axis scale to be date scale from Aug 16, 2004 to Nov 22, 2004, with ticks
# every 7 days (1 week)
c.yAxis().setDateScale(Time.mktime(2004, 8, 16), Time.mktime(2004, 11, 22), 86400 * 7
    )

# Set multi-style axis label formatting. Month labels are in Arial Bold font in "mmm
# d" format. Weekly labels just show the day of month and use minor tick (by using
# '-' as first character of format string).
c.yAxis().setMultiFormat(ChartDirector::StartOfMonthFilter(),
    "<*font=arialbd.ttf*>{value|mmm d}", ChartDirector::StartOfDayFilter(),
    "-{value|d}")

# Set the y-axis to shown on the top (right + swapXY = top)
c.setYAxisOnRight()

# Set the labels on the x axis
c.xAxis().setLabels(labels)

# Reverse the x-axis scale so that it points downwards.
c.xAxis().setReverse()

# Set the horizontal ticks and grid lines to be between the bars
c.xAxis().setTickOffset(0.5)

# Add some symbols to the chart to represent milestones. The symbols are added using
# scatter layers. We need to specify the task index, date, name, symbol shape, size
# and color.
c.addScatterLayer([1], [Time.mktime(2004, 9, 13)], "Milestone 1",
    ChartDirector::Cross2Shape(), 13, 0xffff00)
c.addScatterLayer([3], [Time.mktime(2004, 10, 4)], "Milestone 2",
    ChartDirector::StarShape(5), 15, 0xff00ff)
c.addScatterLayer([5], [Time.mktime(2004, 11, 8)], "Milestone 3",
    ChartDirector::TriangleSymbol, 13, 0xff9933)

# Add a multi-color box-whisker layer to represent the gantt bars
layer = c.addBoxWhiskerLayer2(startDate, endDate, nil, nil, nil, colors)
layer.setXData(taskNo)
layer.setBorderColor(ChartDirector::SameAsMainColor)

# Divide the plot area height ( = 200 in this chart) by the number of tasks to get
# the height of each slot. Use 80% of that as the bar height.
layer.setDataWidth((200 * 4 / 5 / (labels.length)).to_i)

# Add a legend box at (140, 265) - bottom of the plot area. Use 8 pts Arial Bold as
# the font with auto-grid layout. Set the width to the same width as the plot area.
# Set the backgorund to grey (dddddd).
legendBox = c.addLegend2(140, 265, ChartDirector::AutoGrid, "arialbd.ttf", 8)
legendBox.setWidth(461)
legendBox.setBackground(0xdddddd)

# The keys for the scatter layers (milestone symbols) will automatically be added to
# the legend box. We just need to add keys to show the meanings of the bar colors.
legendBox.addKey("Market Team", 0x00cc00)
legendBox.addKey("Planning Team", 0x0000cc)
legendBox.addKey("Development Team", 0xcc0000)

# output the chart
c.makeChart("colorgantt.png")