ambling 0.0.1

data/lib/ambling_helper.rb

@@ -0,0 +1,83 @@
+# Generates chart object tag with given url to fetch the xml data.
+# See README for more information
+
+module Ambling #:nodoc
+  module Helper #:nodoc
+    class AmblingHelperError < StandardError #:nodoc
+    end
+    
+    CHART_PATH = "/amcharts" unless defined? CHART_PATH
+                        
+    # Generates chart object tag with given url to fetch the xml data.
+    # See Ambling for examples
+    # Chart Options:
+    # * <tt>:width</tt> - The width of the chart
+    # * <tt>:height</tt> - The height of the chart
+    # * <tt>:swf_path</tt> - The path that contains the chart.swf.  Defaults to /amcharts
+    # * <tt>:flash_version</tt> - Supported flash version.  Defaults to 8
+    # * <tt>:background_color</tt> - The chart background color.  Defaults to '#FFFFFF'
+    # * <tt>:preloader_color</tt> - The color of the preloading text.  Defaults to '#000000'
+    # * <tt>:express_install</tt> - Use the swfobject express install if the browser does not have flash installed. Defaults to true
+    # * <tt>:id</tt> - The id of the DOM element that will be replaced
+    # * <tt>:settings_file</tt> - The path to the xml settings file (could be url)
+    # * <tt>:chart_settings</tt> - Inline xml settings.  Use one of settings_file and chart_settings
+    # * <tt>:swf_params</tt> - Hash of params to be set on SWFObject (with so.addParam()).
+    # * <tt>:additional_chart_settings</tt> - More inline xml settings.
+    # * <tt>:data_file</tt> - The path to the xml data file (could be url)
+    # * <tt>:chart_data</tt> - Inline xml data.  Use one of data_file and chart_data
+    def ambling_chart(chart_type, chart_options = {}, &block)
+      options = { :width              => "400",
+                  :height             => "300",
+                  :swf_path           => CHART_PATH,
+                  :flash_version      => "8",
+                  :background_color   => "#FFFFFF",
+                  :preloader_color    => "#000000",
+                  :express_install    => true,
+                  :id                 => "ambling_chart"
+                }.merge!(chart_options)
+      script = "var so = new SWFObject('#{options[:swf_path]}/am#{chart_type}.swf', " +
+                                      "'swf_#{options[:id]}', '#{options[:width]}', '#{options[:height]}', " +
+                                      "'#{options[:flash_version]}', '#{options[:background_color]}');"
+      script << "so.addVariable('path', '#{options[:swf_path]}/');"
+      script << "so.useExpressInstall('#{options[:swf_path]}/expressinstall.swf');" if options[:express_install]
+      
+      script << add_variable(options, :settings_file, true)
+      script << add_variable(options, :chart_settings)
+      script << add_variable(options, :chart_id) # this is needed for controlling charts with JS
+      script << add_variable(options, :additional_chart_settings)
+      
+      script << add_variable(options, :data_file, true)
+      script << add_variable(options, :chart_data)
+      
+      script << add_variable(options, :preloader_color)
+      
+      script << add_swf_params(options, :swf_params, true)
+      
+      script << "so.write('#{options[:id]}');"
+      html = yield
+      content_tag('div', html, :id => options[:id]) + javascript_tag(script)
+    end
+    
+    private
+
+    # Add variable to swfobject
+    def add_variable(options, key, escape=false)
+      return "" unless options[key]
+      stresc = options[key].gsub('"', "%22")
+      val = escape ? "escape('#{stresc}')" : "'#{stresc}'"
+      "so.addVariable('#{key}', #{val});"
+    end
+
+    # Add parameters in params[key] to SWFObject
+    def add_swf_params(options, key, escape=false)
+      return "" unless options[key]
+      res = ""
+      options[key].each_pair do |key, val|
+        stresc = val.gsub('"', "%22")
+        val = escape ? "escape('#{stresc}')" : "'#{stresc}'"
+        res << "so.addParam('#{key}', #{val});"
+      end
+      res
+    end
+  end
+end

data/test/base_test.rb

@@ -0,0 +1,54 @@
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+
+require 'rubygems'
+require 'test/unit'
+require 'ambling'
+require 'test_helper'
+
+class BaseTest < Test::Unit::TestCase
+  include TestHelper
+  
+  def setup
+    super
+    @settings_hash = {:type => 'column', :column => {:type => 'atype', :width => '*'}}
+    @settings = Ambling::Column::Settings.new @settings_hash
+    
+    @advanced_settings = read_and_strip_xml_file "advanced_settings.xml"
+    
+  end
+  
+  def test_to_xml
+    assert_equal "<settings><type>column</type><column><type>atype</type><width>*</width></column></settings>",
+      @settings.to_xml
+    
+    assert_equal "<column><type>column</type></column>",
+      Ambling::Column::Settings::Column.new(:type => 'column').to_xml
+      
+    column_settings = Ambling::Column::Settings.new(
+        :column => {
+          :type => "stacked", :width => 90, :data_labels => "{total}"
+        },
+        :grid => {
+          :category => {:alpha => 0}, :value => {:alpha => 10}
+        },
+        :values => {
+          :category => {:enabled => false}
+        },
+        :plot_area => {
+          :margins => {:left => 40, :top => 40, :right => 200, :bottom => 100}
+        },
+        :legend => {
+          :enabled => true, :x => 150, :y => 100, :width => 80, :border_alpha => 100, :max_columns => 1, :text_size => 8
+        },
+        :labels => {
+          :label => [
+            {:x => 20, :y => 5, :text => "<![CDATA[<b>Bold Label</b>]]>",
+              :text_size => 16, :text_color => '#A0A0A0'},
+            {:x => 180, :y => 5, :text => "Plain"}
+          ]
+        }
+    )
+    assert_equal @advanced_settings, column_settings.to_xml
+  end
+end

data/test/data_test.rb

@@ -0,0 +1,82 @@
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+
+require 'rubygems'
+require 'test/unit/xml'
+require 'ambling'
+require 'test_helper'
+
+class DataTest < Test::Unit::TestCase    
+  include TestHelper
+  
+  def setup
+    super
+    @simple_chart_xml = read_and_strip_xml_file "simple_chart_data.xml"
+    @advanced_chart_xml = read_and_strip_xml_file "advanced_chart_data.xml"
+    @simple_pie_xml = read_and_strip_xml_file "simple_pie_data.xml"
+  end
+  
+  
+  def test_line_column_chart_to_xml
+    simple_chart = Ambling::Data::LineChart.new
+    simple_chart.message = "Test Broadcast"
+    simple_chart.series = [10,20,30]
+    simple_chart.graphs << Ambling::Data::LineGraph.new([100,200,300])
+    
+    assert_xml_equal @simple_chart_xml, simple_chart.to_xml,
+      "Expected |#{@simple_chart_xml}| but was |#{simple_chart.to_xml}|"
+    
+    simple_chart = Ambling::Data::ColumnChart.new
+    simple_chart.message = Ambling::Data::Message.new "Test Broadcast"
+    simple_chart.series.values << Ambling::Data::Value.new(10, :xid => 1)
+    simple_chart.series << 20
+    simple_chart.series.push Ambling::Data::Value.new(30, :xid => 3)
+    
+    graph = Ambling::Data::ColumnGraph.new
+    graph.values << Ambling::Data::Value.new(100, :xid => 1)
+    graph << 200
+    graph << Ambling::Data::Value.new(300, :xid => 3)
+    
+    simple_chart.graphs << graph
+
+    assert_xml_equal @simple_chart_xml, simple_chart.to_xml,
+      "Expected |#{@simple_chart_xml}| but was |#{simple_chart.to_xml}|"
+    
+    advanced_chart = Ambling::Data::LineChart.new
+    advanced_chart.message = Ambling::Data::Message.new "Advanced Broadcast", {:bg_color => '#CCCCCC'}
+    
+    advanced_chart.series << Ambling::Data::Value.new(1, :xid => 100, :bg_color => '#000000')
+    advanced_chart.series << Ambling::Data::Value.new(2, :xid => 101, :bg_color => '#FFFFFF')
+    
+    advanced_chart.graphs << Ambling::Data::LineGraph.new([], :gid => "test_gid", :title => "test_title")
+    advanced_chart.graphs.last << Ambling::Data::Value.new(1000, :xid => 1, :color => '#AAAAAA', :url => "http://yp.to")
+    advanced_chart.graphs.last << Ambling::Data::Value.new(2000, :xid => 2, :color => '#BBBBBB', :start => 5)
+    
+    # puts advanced_chart.to_xml
+    
+    assert_xml_equal @advanced_chart_xml, advanced_chart.to_xml,
+      "Expected |#{@advanced_chart_xml}| but was |#{advanced_chart.to_xml}|"
+    
+  end
+  
+  def test_pie_to_xml
+    simple_pie = Ambling::Data::Pie.new
+    simple_pie.message = "Pie Broadcast"
+    simple_pie << Ambling::Data::Slice.new(50, :title => "One Slice")
+    simple_pie.slices << Ambling::Data::Slice.new(25, :title => "Two Slice", :url => "http://two.foo")
+    
+    assert_xml_equal @simple_pie_xml, simple_pie.to_xml,
+      "Expected |#{@simple_pie_xml}| but was |#{simple_pie.to_xml}|"
+  end
+  
+  def test_xy_to_xml
+    simple_xy = Ambling::Data::XyChart.new
+    simple_xy.graphs << Ambling::Data::XyGraph.new
+    simple_xy.graphs.last << Ambling::Data::Point.new(:x => 1, :y => 10, :value => 100)
+    simple_xy.graphs.last << Ambling::Data::Point.new(:x => 2, :y => 20, :value => 200)
+    
+    assert_xml_equal @simple_xy_xml, simple_xy.to_xml,
+      "Expected |#{@simple_xy_xml}| but was |#{simple_xy.to_xml}|"
+  end
+
+end

data/test/generator_test.rb

@@ -0,0 +1,98 @@
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+
+require 'test/unit'
+require 'rubygems'
+require 'ambling/utils'
+
+class GeneratorTest < Test::Unit::TestCase
+  
+  def setup
+    begin
+      Ambling::Column::Settings
+    rescue
+      g = Ambling::Utils::SettingsGenerator.new
+      Object.module_eval g.generate(:column, File.read(File.join(File.dirname(__FILE__), "xmls", "simple.xml")))
+    end
+    
+    @settings_hash = {:one => 111, :subsettings => {:type => 'atype', :width => '*'},
+                      :graphs => {:graph => {:gid => 1, :type => 'column'}}}
+    @settings = Ambling::Column::Settings.new @settings_hash
+  end
+  
+  def test_settings_generator
+    const = Ambling::Column::Settings
+    assert_not_nil const
+    top_attrs = const.const_get :VALUES
+    assert_not_nil top_attrs
+    assert_equal [:one, :blank, :subsettings, :graphs], top_attrs
+    subattrs = const.const_get :ATTRIBUTES rescue nil
+    assert_nil subattrs
+    
+    inst = const.new
+    assert inst.respond_to?(:to_xml)
+    assert inst.respond_to?(:build_xml)
+    
+    subconst = const.const_get :Subsettings
+    assert_not_nil subconst
+    subvalues = subconst.const_get :VALUES
+    assert_not_nil subvalues
+    assert_equal [:type, :width], subvalues
+    subattrs = subconst.const_get :ATTRIBUTES rescue nil
+    assert_nil subattrs
+    
+    subinst = subconst.new
+    assert subinst.respond_to?(:to_xml)
+    assert subinst.respond_to?(:build_xml)
+    
+    graphs = const.const_get :Graphs
+    assert_not_nil graphs
+    subvalues = graphs.const_get :VALUES
+    assert_not_nil subvalues
+    assert_equal [:graph], subvalues
+    
+    subattrs = graphs.const_get :ATTRIBUTES rescue nil
+    assert_nil subattrs
+    
+    graph = graphs.const_get :Graph
+    assert_not_nil graph
+    subvalues = graph.const_get :VALUES
+    assert_not_nil subvalues
+    assert_equal [:type, :title], subvalues
+    
+    subattrs = graph.const_get :ATTRIBUTES
+    assert_not_nil subattrs
+    assert_equal [:gid], subattrs
+    
+    subinst = graph.new
+    assert subinst.respond_to?(:to_xml)
+    assert subinst.respond_to?(:build_xml)
+    
+    
+  end
+  
+  def test_initialize
+    assert_equal @settings_hash[:one], @settings.one
+    assert_nil @settings.blank
+    
+    assert_equal @settings_hash[:subsettings][:type], @settings.subsettings.type
+    assert_equal @settings_hash[:subsettings][:width], @settings.subsettings.width
+    assert_equal @settings_hash[:graphs][:graph][:gid], @settings.graphs.graph.gid
+    assert_equal @settings_hash[:graphs][:graph][:type], @settings.graphs.graph.type
+    
+    begin
+      Ambling::Column::Settings.new(:bogus => 1)
+      fail "Bogus variable initialization!"
+    rescue NoMethodError
+      # all is well
+    end
+    
+    begin
+      Ambling::Column::Settings.new(:one => 1, :bogus_subsettings => {:type => 1})
+      fail "Bogus subsetting initialization!"
+    rescue NameError
+      # all is well
+    end
+  end
+  
+end

data/test/test_helper.rb

@@ -0,0 +1,7 @@
+module TestHelper
+  # UGH!  test/unit/xml can't handle a newline in the file
+  # I tried REXML::Document.new(source, :compress_whitespace => :all) but that didn't work either
+  def read_and_strip_xml_file(filename)
+    File.read(File.join(File.dirname(__FILE__), "xmls", filename)).gsub(/>\s+</,"><")
+  end
+end

data/test/xmls/advanced_chart_data.xml

@@ -0,0 +1,13 @@
+<chart>
+  <message bg_color="#CCCCCC"><![CDATA[Advanced Broadcast]]></message>
+  <series>
+    <value xid="100" bg_color="#000000">1</value>
+    <value xid="101" bg_color="#FFFFFF">2</value>
+  </series>
+  <graphs>
+    <graph gid="test_gid" title="test_title">
+      <value xid="1" color="#AAAAAA" url="http://yp.to">1000</value>
+      <value xid="2" color="#BBBBBB" start="5">2000</value>
+    </graph>
+  </graphs>
+</chart>

data/test/xmls/advanced_settings.xml

@@ -0,0 +1,51 @@
+<settings>
+  <column>
+    <type>stacked</type>
+    <width>90</width>
+    <data_labels>{total}</data_labels>
+  </column>
+  <plot_area>
+    <margins>
+      <left>40</left>
+      <top>40</top>
+      <right>200</right>
+      <bottom>100</bottom>
+    </margins>
+  </plot_area>
+  <grid>
+    <category>
+      <alpha>0</alpha>
+    </category>
+    <value>
+      <alpha>10</alpha>
+    </value>
+  </grid>
+  <values>
+    <category>
+      <enabled>false</enabled>
+    </category>
+  </values>
+  <legend>
+    <enabled>true</enabled>
+    <x>150</x>
+    <y>100</y>
+    <width>80</width>
+    <max_columns>1</max_columns>
+    <border_alpha>100</border_alpha>
+    <text_size>8</text_size>
+  </legend>
+  <labels>
+    <label>
+      <x>20</x>
+      <y>5</y>
+      <text_color>#A0A0A0</text_color>
+      <text_size>16</text_size>
+      <text>&lt;![CDATA[&lt;b&gt;Bold Label&lt;/b&gt;]]&gt;</text>
+    </label>
+    <label>
+      <x>180</x>
+      <y>5</y>
+      <text>Plain</text>
+    </label>
+  </labels>
+</settings>

data/test/xmls/amcolumn_settings.xml

@@ -0,0 +1,328 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Value between [] brackets, for example [#FFFFFF] shows default value which is used if this parameter is not set -->
+<!-- This means, that if you are happy with this value, you can delete this line at all and reduce file size -->
+<!-- value or explanation between () brackets shows the range or type of values you should use for this parameter -->
+<!-- the top left corner has coordinates x = 0, y = 0                                                                -->
+<!-- "!" before x or y position (for example: <x>!20</x>) means that the coordinate will be calculated from the right side or the bottom -->
+<settings> 
+  <type>column</type>                                         <!-- [column] (column / bar) -->
+  <data_type>xml</data_type>                                  <!-- [xml] (xml / csv) -->
+  <csv_separator></csv_separator>                             <!-- [;] (string) csv file data separator (you need it only if you are using csv file for your data) -->     
+  <skip_rows></skip_rows>                                     <!-- [0] (Number) if you are using csv data type, you can set the number of rows which should be skipped here -->
+  <font>Tahoma</font>                                         <!-- [Arial] (font name) use device fonts, such as Arial, Times New Roman, Tahoma, Verdana... -->
+  <text_size></text_size>                                     <!-- [11] (Number) text size of all texts. Every text size can be set individually in the settings below -->
+  <text_color></text_color>                                   <!-- [#000000] (hex color code) main text color. Every text color can be set individually in the settings below-->
+  <decimals_separator></decimals_separator>                   <!-- [,] (string) decimal separator. Note, that this is for displaying data only. Decimals in data xml file must be separated with a dot -->
+  <thousands_separator></thousands_separator>                 <!-- [ ] (string) thousand separator. use "none" if you don't want to separate -->
+  <digits_after_decimal></digits_after_decimal>               <!-- [] (Number) if your value has less digits after decimal then is set here, zeroes will be added -->
+  <redraw></redraw>                                           <!-- [false] (true / false) if your chart's width or height is set in percents, and redraw is set to true, the chart will be redrawn then screen size changes -->
+                                                              <!-- this function is beta, be careful. Legend, buttons labels will not be repositioned if you set your x and y values for these objects -->
+  <reload_data_interval></reload_data_interval>               <!-- [0] (Number) how often data should be reloaded (time in seconds) -->
+  <preloader_on_reload></preloader_on_reload>                 <!-- [false] (true / false) Whether to show preloaded when data or settings are reloaded -->
+  <add_time_stamp></add_time_stamp>                           <!-- [false] (true / false) if true, a unique number will be added every time flash loads data. Mainly this feature is useful if you set reload _data_interval -->
+  <precision></precision>                                     <!-- [2] (Number) shows how many numbers should be shown after comma for calculated values (percents) -->
+  <depth>0</depth>                                            <!-- [0] (Number) the depth of chart and columns (for 3D effect) -->
+  <angle>0</angle>                                            <!-- [30] (0 - 90) angle of chart area and columns (for 3D effect) -->
+  <colors></colors>                                           <!-- [#FF6600,#FCD202,#B0DE09,#0D8ECF,#2A0CD0,#CD0D74,#CC0000,#00CC00,#0000CC,#DDDDDD,#999999,#333333,#990000] Colors of graphs. if the graph color is not set, color from this array will be used -->
+
+    
+  <column>
+    <type></type>                                             <!-- [clustered] (clustered, stacked, 100% stacked, 3d column) -->
+    <width>85</width>                                         <!-- [80] (0 - 100) width of column (in percents)  -->
+    <spacing>0</spacing>                                      <!-- [5] (Number) space between columns of one category axis value, in pixels. Negative values can be used. -->
+    <grow_time>3</grow_time>                                  <!-- [0] (Number) grow time in seconds. Leave 0 to appear instantly -->
+    <grow_effect></grow_effect>                               <!-- [elastic] (elastic, regular, strong) -->
+    <sequenced_grow>true</sequenced_grow>                     <!-- [false] (true / false) whether columns should grow at the same time or one after another -->    
+    <alpha></alpha>                                           <!-- [100] (Number) alpha of all columns -->
+    <border_color></border_color>                             <!-- [#FFFFFF] (hex color code) -->
+    <border_alpha></border_alpha>                             <!-- [0] (Number) -->
+    <data_labels>
+      <![CDATA[]]>                                            <!-- [] ({title} {value} {series} {percents} {start} {difference} {total}) You can format any data label: {title} will be replaced with real title, {value} - with value and so on. You can add your own text or html code too. -->
+    </data_labels>
+    <data_labels_text_color></data_labels_text_color>         <!-- [text_color] (hex color code) --> 
+    <data_labels_text_size></data_labels_text_size>           <!-- [text_size] (Number) -->
+    <data_labels_position></data_labels_position>             <!-- [] (inside, outside, above). This setting is only for clustered chart. --> 
+                                                              <!-- if you set "above" for column chart, the data label will be displayed inside column, rotated  by 90 degrees -->
+    <balloon_text>                                                    
+     <![CDATA[]]>                                             <!-- [] ({title} {value} {series} {percents} {start} {difference} {total}) You can format any data label: {title} will be replaced with real title, {value} - with value and so on. You can add your own text or html code too. -->
+    </balloon_text>    
+    <link_target></link_target>                               <!-- [] (_blank, _top ...) -->
+    <gradient></gradient>                                     <!-- [vertical] (horizontal / vertical) Direction of column gradient. Gradient colors are defined in graph settings below. -->
+    <bullet_offset></bullet_offset>                           <!-- [0] (Number) distance from column / bar to the bullet -->
+    <hover_brightness>30</hover_brightness>                   <!-- [0] (from -255 to 255) The column may darken/lighten when the use rolls over it. The intensity may be set here -->                         
+  </column>
+  
+  <line>                                                      <!-- Here are general settings for "line" graph type. You can set most of these settings for individual lines in graph settings below -->
+    <connect></connect>                                       <!-- [false] (true / false) whether to connect points if data is missing -->
+    <width></width>                                           <!-- [2] (Number) line width -->
+    <alpha></alpha>                                           <!-- [100] (Number) line alpha -->
+    <fill_alpha></fill_alpha>                                 <!-- [0] (Number) fill alpha -->
+    <bullet></bullet>                                         <!-- [] (square, round, square_outlined, round_outlined, square_outline, round_outline, filename.swf) can be used predefined bullets or loaded custom bullets. Leave empty if you don't want to have bullets at all. Outlined bullets use plot area color for outline color -->
+    <bullet_size></bullet_size>                               <!-- [8] (Number) bullet size -->
+    <data_labels>
+       <![CDATA[]]>                                           <!-- [] ({title} {value} {series} {percents} {start} {difference} {total}) You can format any data label: {title} will be replaced with real title, {value} - with value and so on. You can add your own text or html code too. -->
+    </data_labels>
+    <data_labels_text_color></data_labels_text_color>         <!-- [text_color] (hex color code) --> 
+    <data_labels_text_size></data_labels_text_size>           <!-- [text_size] (Number) -->
+    <balloon_text>                                                    
+      <![CDATA[]]>                                            <!-- [] use the same formatting rules as for data labels -->
+    </balloon_text>      
+    <link_target></link_target>                               <!-- [] (_blank, _top ...) -->
+  </line>
+    
+  <background>                                                <!-- BACKGROUND -->
+    <color></color>                                           <!-- [#FFFFFF] (hex color code) Separate color codes with comas for gradient -->
+    <alpha></alpha>                                           <!-- [0] (0 - 100) use 0 if you are using custom swf or jpg for background -->
+    <border_color></border_color>                             <!-- [#000000] (hex color code) -->
+    <border_alpha>15</border_alpha>                           <!-- [0] (0 - 100) -->
+    <file></file>                                             <!-- [] (filename) swf or jpg file of a background. Do not use progressive jpg file, it will be not visible with flash player 7 -->
+                                                              <!-- The chart will look for this file in "path" folder ("path" is set in HTML) -->
+  </background>
+     
+  <plot_area>                                                 <!-- PLOT AREA (the area between axes) -->
+    <color></color>                                           <!-- [#FFFFFF](hex color code) Separate color codes with comas for gradient -->
+    <alpha></alpha>                                           <!-- [0] (0 - 100) if you want it to be different than background color, use bigger than 0 value -->
+    <border_color></border_color>                             <!-- [#000000] (hex color code) -->                                        
+    <border_alpha></border_alpha>                             <!-- [0] (0 - 100) -->                                            
+    <margins>                                                 <!-- plot area margins -->
+      <left>70</left>                                         <!-- [60](Number) --> 
+      <top>60</top>                                           <!-- [60](Number) --> 
+      <right>50</right>                                       <!-- [60](Number) -->
+      <bottom>80</bottom>                                     <!-- [80](Number) -->
+    </margins>
+  </plot_area>
+  
+  <grid>                                                      <!-- GRID -->
+    <category>                                                <!-- category axis grid -->                                                     
+      <color></color>                                         <!-- [#000000] (hex color code) -->
+      <alpha>5</alpha>                                        <!-- [15] (0 - 100) -->
+      <dashed></dashed>                                       <!-- [false](true / false) -->
+      <dash_length></dash_length>                             <!-- [5] (Number) -->
+    </category>
+    <value>                                                   <!-- value axis grid -->      
+      <color></color>                                         <!-- [#000000] (hex color code) -->
+      <alpha>0</alpha>                                        <!-- [15] (0 - 100) -->
+      <dashed></dashed>                                       <!-- [false] (true / false) -->
+      <dash_length></dash_length>                             <!-- [5] (Number) -->
+      <approx_count></approx_count>                           <!-- [10] (Number) approximate number of gridlines -->
+      <fill_color>000000</fill_color>                         <!-- [#FFFFFF] (hex color code) every second area between gridlines will be filled with this color (you will need to set fill_alpha > 0) -->
+      <fill_alpha>5</fill_alpha>                              <!-- [0] (0 - 100) opacity of fill -->
+    </value>
+  </grid>
+  
+  <values>                                                    <!-- VALUES -->
+    <category>                                                <!-- category axis -->
+      <enabled></enabled>                                     <!-- [true] (true / false) -->
+      <frequency>3</frequency>                                <!-- [1] (Number) how often values should be placed -->
+      <start_from></start_from>                               <!-- [1] (Number) you can set series from which category values will be displayed -->
+      <rotate>45</rotate>                                     <!-- [0] (0 - 90) angle of rotation. If you want to rotate by degree from 1 to 89, you must have font.swf file in fonts folder -->      
+      <color></color>                                         <!-- [text_color] (hex color code) -->
+      <text_size></text_size>                                 <!-- [text_size] (Number) -->    
+      <inside></inside>                                       <!-- [false] (true / false) if set to true, axis values will be displayed inside plot area. This setting will not work for values rotated by 1-89 degrees (0 and 90 only) -->      
+    </category>
+    <value>                                                   <!-- value axis -->
+      <enabled>true</enabled>                                 <!-- [true] (true / false) -->
+      <reverse></reverse>                                     <!-- [false] (true / false) whether to reverse this axis values or not. If set to true, values will start from biggest number and will end with a smallest number -->    
+      <min>0</min>                                            <!-- [] (Number) minimum value of this axis. If empty, this value will be calculated automatically. -->
+      <max></max>                                             <!-- [] (Number) maximum value of this axis. If empty, this value will be calculated automatically -->
+      <strict_min_max></strict_min_max>                       <!-- [false] (true / false) by default, if your values are bigger then defined max (or smaller then defined min), max and min is changed so that all the chart would fit to chart area. If you don't want this, set this option to true. -->
+      <frequency></frequency>                                 <!-- [1] (Number) how often values should be placed, 1 - near every gridline, 2 - near every second gridline... -->
+      <rotate></rotate>                                       <!-- [0] (0 - 90) angle of rotation. If you want to rotate by degree from 1 to 89, you must have font.swf file in fonts folder -->
+      <skip_first></skip_first>                               <!-- [true] (true / false) to skip or not first value -->
+      <skip_last></skip_last>                                 <!-- [false] (true / false) to skip or not last value -->
+      <color></color>                                         <!-- [text_color] (hex color code) --> 
+      <text_size></text_size>                                 <!-- [text_size] (Number) -->
+      <unit></unit>                                           <!-- [] (text) -->
+      <unit_position></unit_position>                         <!-- [right] (right / left) -->
+      <integers_only></integers_only>                         <!-- [false] (true / false) if set to true, values with decimals will be omitted -->
+      <inside></inside>                                       <!-- [false] (true / false) if set to true, axis values will be displayed inside plot area. This setting will not work for values rotated by 1-89 degrees (0 and 90 only) -->                   
+    </value>
+  </values>
+  
+  <axes>                                                      <!-- axes -->
+    <category>                                                <!-- category axis -->
+      <color></color>                                         <!-- [#000000] (hex color code) -->
+      <alpha></alpha>                                         <!-- [100] (0 - 100) -->
+      <width>1</width>                                        <!-- [2] (Number) line width, 0 for hairline -->
+      <tick_length></tick_length>                             <!-- [7] (Number) -->
+    </category>
+    <value>                                                   <!-- value axis -->
+      <color></color>                                         <!-- [#000000] (hex color code) -->
+      <alpha></alpha>                                         <!-- [100] (0 - 100) -->
+      <width>1</width>                                        <!-- [2] (Number) line width, 0 for hairline -->
+      <tick_length></tick_length>                             <!-- [7] (Number) -->
+      <logarithmic></logarithmic>                             <!-- [false] (true / false) If set to true, this axis will use logarithmic scale instead of linear -->
+    </value>
+  </axes>  
+  
+  <balloon>                                                   <!-- BALLOON -->
+    <enabled></enabled>                                       <!-- [true] (true / false) -->
+    <color></color>                                           <!-- [] (hex color code) balloon background color. If empty, slightly darker then current column color will be used -->
+    <alpha>85</alpha>                                         <!-- [100] (0 - 100) -->
+    <text_color></text_color>                                 <!-- [#FFFFFF] (hex color code) -->
+    <text_size></text_size>                                   <!-- [text_size] (Number) -->
+    <max_width></max_width>                                   <!-- [220] (Number) The maximum width of a balloon -->
+    <corner_radius></corner_radius>                           <!-- [0] (Number) Corner radius of a balloon. If you set it > 0, the balloon will not display arrow -->
+    <border_width></border_width>                             <!-- [0] (Number) -->
+    <border_alpha></border_alpha>                             <!-- [balloon.alpha] (Number) -->
+    <border_color></border_color>                             <!-- [balloon.color] (hex color code) -->
+  </balloon>
+    
+  <legend>                                                    <!-- LEGEND -->
+    <enabled>false</enabled>                                  <!-- [true] (true / false) -->
+    <x></x>                                                   <!-- [] (Number / Number% / !Number) if empty, will be equal to left margin -->
+    <y></y>                                                   <!-- [] (Number / Number% / !Number) if empty, will be below plot area -->
+    <width></width>                                           <!-- [] (Number / Number%) if empty, will be equal to plot area width -->
+    <max_columns></max_columns>                               <!-- [] (Number) the maximum number of columns in the legend -->    
+    <color></color>                                           <!-- [#FFFFFF] (hex color code) background color. Separate color codes with comas for gradient -->
+    <alpha></alpha>                                           <!-- [0] (0 - 100) background alpha -->
+    <border_color></border_color>                             <!-- [#000000] (hex color code) border color -->
+    <border_alpha></border_alpha>                             <!-- [0] (0 - 100) border alpha -->
+    <text_color></text_color>                                 <!-- [text_color] (hex color code) -->   
+    <text_size></text_size>                                   <!-- [text_size] (Number) -->
+    <spacing></spacing>                                       <!-- [10] (Number) vertical and horizontal gap between legend entries -->
+    <margins></margins>                                       <!-- [0] (Number) legend margins (space between legend border and legend entries, recommended to use only if legend border is visible or background color is different from chart area background color) -->
+    <reverse_order></reverse_order>                           <!-- [false] (true / false) whether to sort legend entries in a reverse order -->        
+    <align></align>                                           <!-- [left] (left / center / right) alignment of legend entries -->
+    <key>                                                     <!-- KEY (the color box near every legend entry) -->
+      <size></size>                                           <!-- [16] (Number) key size-->
+      <border_color></border_color>                           <!-- [] (hex color code) leave empty if you don't want to have border -->
+    </key>
+  </legend>
+  
+  <export_as_image>                                           <!-- export_as_image feature works only on a web server -->
+    <file></file>                                             <!-- [] (filename) if you set filename here, context menu (then user right clicks on flash movie) "Export as image" will appear. This will allow user to export chart as an image. Collected image data will be posted to this file name (use amcolumn/export.php or amcolumn/export.aspx) -->
+    <target></target>                                         <!-- [] (_blank, _top ...) target of a window in which export file must be called -->
+    <x></x>                                                   <!-- [0] (Number / Number% / !Number) x position of "Collecting data" text -->
+    <y></y>                                                   <!-- [] (Number / Number% / !Number) y position of "Collecting data" text. If not set, will be aligned to the bottom of flash movie -->
+    <color></color>                                           <!-- [#BBBB00] (hex color code) background color of "Collecting data" text -->
+    <alpha></alpha>                                           <!-- [0] (0 - 100) background alpha -->
+    <text_color></text_color>                                 <!-- [text_color] (hex color code) -->
+    <text_size></text_size>                                   <!-- [text_size] (Number) -->
+  </export_as_image>
+  
+  <error_messages>                                            <!-- "error_messages" settings will be applied for all error messages except the one which is showed if settings file wasn't found -->
+    <enabled></enabled>                                       <!-- [true] (true / false) -->
+    <x></x>                                                   <!-- [] (Number / Number% / !Number) x position of error message. If not set, will be aligned to the center -->
+    <y></y>                                                   <!-- [] (Number / Number% / !Number) y position of error message. If not set, will be aligned to the center -->
+    <color></color>                                           <!-- [#BBBB00] (hex color code) background color of error message. Separate color codes with comas for gradient -->
+    <alpha></alpha>                                           <!-- [100] (0 - 100) background alpha -->
+    <text_color></text_color>                                 <!-- [#FFFFFF] (hex color code) -->
+    <text_size></text_size>                                   <!-- [text_size] (Number) -->
+  </error_messages>    
+  
+  <strings>
+    <no_data></no_data>                                       <!-- [No data for selected period] (text) if data is missing, this message will be displayed -->
+    <export_as_image></export_as_image>                       <!-- [Export as image] (text) text for right click menu -->
+    <collecting_data></collecting_data>                       <!-- [Collecting data] (text) this text is displayed while exporting chart to an image -->
+  </strings>  
+  
+  
+  <context_menu>                                              <!-- context menu allows you to controll right-click menu items. You can add custom menu items to create custom controls -->                                                              
+                                                              <!-- "function_name" specifies JavaScript function which will be called when user clicks on this menu. You can pass variables, for example: function_name="alert('something')" -->
+                                                              <!-- "title" sets menu item text. Do not use for title: Show all, Zoom in, Zoom out, Print, Settings... -->
+                                                              <!-- you can have any number of custom menus. Uncomment the line below to enable this menu and add apropriate JS function to your html file. -->
+     <!-- <menu function_name="printChart" title="Print chart"></menu> -->
+     
+     <default_items>
+       <zoom>false</zoom>                                     <!-- [true] (true / false) to show or not flash players zoom menu -->
+       <print>false</print>                                   <!-- [true] (true / false) to show or not flash players print menu -->
+     </default_items>
+  </context_menu>  
+  
+  
+  <labels>                                                    <!-- LABELS -->
+                                                              <!-- you can add as many labels as you want -->
+                                                              <!-- labels can also be added in data xml file, using exactly the same structure like it is here -->
+    <label lid="0">
+      <x>10</x>                                               <!-- [0] (Number / Number% / !Number) -->
+      <y>400</y>                                              <!-- [0] (Number / Number% / !Number) -->
+      <rotate>true</rotate>                                   <!-- [false] (true / false) -->
+      <width></width>                                         <!-- [] (Number / Number%) if empty, will stretch from left to right untill label fits -->
+      <align>center</align>                                   <!-- [left] (left / center / right) -->  
+      <text_color></text_color>                               <!-- [text_color] (hex color code) button text color -->
+      <text_size></text_size>                                 <!-- [text_size](Number) button text size -->
+      <text>                                                  <!-- [] (text) html tags may be used (supports <b>, <i>, <u>, <font>, <a href="">, <br/>. Enter text between []: <![CDATA[your <b>bold</b> and <i>italic</i> text]]>-->
+        <![CDATA[<b>Temperature anomaly, C (1950 - 2005)</b>]]>
+      </text>        
+    </label>
+    <label lid="1">
+      <x>0</x> 
+      <y>380</y>
+      <width></width> 
+      <align>right</align>  
+      <text_color></text_color>
+      <text_size>11</text_size>  
+      <text>                   
+        <![CDATA[Source: <a href="http://www.cru.uea.ac.uk/cru/info/warming/" target="_blank"><u>Climatic Research Unit</u></a>]]>
+      </text>        
+    </label>
+  </labels>
+
+  
+  <graphs>                                                     <!-- GRAPHS SETTINGS. These settings can also be specified in data file, as attributes of <graph>, in this case you can delete everything from <graphs> to </graphs> (including) -->
+                                                               <!-- It is recommended to have graph settings here if you don't want to mix data with other params -->
+                                                               <!-- copy <graph>...</graph> (including) as many times as many graphs you have and edit settings individually -->
+                                                               <!-- if graph settings are defined both here and in data file, the ones from data file are used -->
+    <graph gid="1">                                            <!-- if you are using XML data file, graph "gid" must match graph "gid" in data file -->
+      <type>column</type>                                      <!-- [column] (column/line) -->                  
+      <title>Anomaly</title>                                   <!-- [] (graph title) -->
+      <color>B92F2F</color>                                    <!-- [] (hex color code) -->
+      <alpha></alpha>                                          <!-- [column.alpha (line.alpha)] (0 - 100) -->
+      <data_labels>
+        <![CDATA[]]>                                           <!-- [column.data_labels (line.data_labels)] ({title} {value} {series} {percents} {start} {difference} {total}) You can format any data label: {title} will be replaced with real title, {value} - with value and so on. You can add your own text or html code too. -->
+      </data_labels>      
+      <gradient_fill_colors></gradient_fill_colors>            <!-- [] (hex color codes separated by comas) columns can be filled with gradients. Set any number of colors here. Note, that the legend key will be filled with color value, not with gradient. -->
+      <balloon_color></balloon_color>                          <!-- [balloon.color] (hex color code) leave empty to use the same color as graph -->
+      <balloon_alpha></balloon_alpha>                          <!-- [balloon.alpha] (0 - 100) -->      
+      <balloon_text_color></balloon_text_color>                <!-- [balloon.text_color] (hex color code) -->
+      <balloon_text>
+        <![CDATA[Anomaly in {series}: {value}C]]>              <!-- [column(line).balloon.text] ({title} {value} {series} {description} {percents}) You can format any balloon text: {title} will be replaced with real title, {value} - with value and so on. You can add your own text or html code too. -->
+      </balloon_text>       
+      <fill_alpha></fill_alpha>                                <!-- [0] (0 - 100) fill alpha (use it if you want to have area chart) -->
+      <width></width>                                          <!-- [2] (Number) line width -->
+      <bullet></bullet>                                        <!-- [line.bullet] (round, square, round_outlined, square_outline, round_outline, square_outlined, filename) -->            
+      <bullet_size></bullet_size>                              <!-- [line.bullet_size] (Number) bullet size -->
+      <bullet_color></bullet_color>                            <!-- [] (hex color code) bullet color. If not defined, line color is used -->
+      <visible_in_legend></visible_in_legend>                  <!-- [true] (true / false) whether to show legend entry for this graph or not -->
+    </graph>
+
+    <graph gid="2">
+      <type>line</type>                                     
+      <title>Smoothed</title>                               
+      <color></color>                                   
+      <alpha></alpha>
+      <balloon_text>
+        <![CDATA[Anomaly in {series}: {value}C (Smoothed)]]>  <!-- [column(line).balloon.text] ({title} {value} {series} {description} {percents}) You can format any balloon text: {title} will be replaced with real title, {value} - with value and so on. You can add your own text or html code too. -->
+      </balloon_text>                                         
+    </graph>
+  </graphs>
+  
+	<guides>	                                                 <!-- guides are straight lines drawn through all plot area at a give value. Can also be filled with color -->
+	<max_min></max_min>                                        <!-- [false] (true / false) whether to include guides' values when calculating min and max of a chart -->
+	 <guide>                                                   <!-- there can be any number of quides. guides can also be set in data xml file, using the same syntax as here -->
+  	 <behind></behind>                                       <!-- [false] (true / false) whether your guides should appear in front of columns or behind them -->
+	   <start_value></start_value>                             <!-- (number) value at which guide should be placed -->
+	   <end_value></end_value>                                 <!-- (number) if you set value here too, another quide will be drawn. If you set fill alpha > 0, then the area between these quides will be filled with color -->
+	   <title></title>                                         <!-- (string) text which will be displayed near the guide -->
+	   <width></width>                                         <!-- [0] (Number) width of a guide line (0 for hairline) -->
+	   <color></color>                                         <!-- [#000000] (hex color code) color of guide line -->   
+	   <alpha></alpha>                                         <!-- [100] (0 - 100) opacity of guide line -->
+	   <fill_color></fill_color>                               <!-- [guide.color] (hex color code) fill color. If not defined, color of a guide will be used. Separate color codes with comas for gradient -->
+	   <fill_alpha></fill_alpha>                               <!-- [0] (0 - 100) opacity of a fill -->                                  
+	   <inside></inside>                                       <!-- [values.value.inside] whether to place title inside plot area -->
+	   <centered></centered>                                   <!-- [true] (true / false) if you have start and end values defined, title can be placed in the middle between these values. If false, it will be placed near start_value -->
+	   <rotate></rotate>                                       <!-- [values.value.rotate] (0 - 90) angle of rotation of title. -->
+	   <text_size></text_size>                                 <!-- [values.value.text_size] (Number)  -->
+	   <text_color></text_color>                               <!-- [values.value.color] (hex color code) -->
+     <dashed></dashed>                                       <!-- [false] (true / false) -->
+     <dash_length></dash_length>                             <!-- [5] (Number) -->     	   
+	 </guide>  
+	</guides>
+	
+	<!-- DATA can also be set in settings file. Just place data in CSV or XML format between <data></data> -->
+	
+	<!--<data>
+	</data> -->	
+	
+</settings>