DataMap

DataMap is a Ruby library that represents information in maps and generate them as lots of image types, using RMagick.

The value associated to each country is mapped into one of the value ranges. Each value range has an associated color, so the country is painted with that color.

Visit the project page in Github!

Features

• You can generate maps in any image format, size and quality you want. The output formats are the same as those supported by RMagick. The image size string is the same format as RMagick, also.
• Besides bitmap formats, the map can be generated in SVG, ready to be shown in your browser or opened in Inkscape
• To identify each country, the country codes in ISO 3166-1 are used
• You can choose any color palette or map template
• Support to internationalization
• The value ranges can de generated using a log function (in any base) or a linear function. If desired, you can set your own value ranges
• Legend can be shown or not
• Possibility to add Javascript files to make your maps dynamic. Event attributes with function calls can be added to each country with just one method call
• And tons of other features that are covered only in the documentation

Instalation

You get the code by Git:

git clone git://github.com/caiosba/DataMap.git

Run the tests by:

ruby test/world_map_test.rb

Documentation

You can view it here. You can also generate it using RDoc.

Example

For the following code...

    require 'data_map'

    m = DataMap::WorldMap.new
    
    m.data = {
            "us" => 250,
            "br" => 1254,
            "ar" => 957,
            "pt" => 15,
            "es" => 110,
            "fr" => 1398,
            "au" => 341
    }
    
    m.title = "Example"
    
    m.make_ranges_log
    m.make_colors
    m.map_values
    m.make_legend
    m.save_file "map.png", :size => '800x600>', :quality => 80
	

You will achieve the following image:

You can also pass some arguments in the constructor.
The example below uses another color palette and do not generates a legend.
For the output image, we choose another quality, format and size. The size string and formats are the same as RMagick. And aso outputs the image as SVG.
We can use a linear function to define the range.

    require 'data_map'

    m = DataMap::WorldMap.new(
      :data => {
            "us" => 250,
            "br" => 1254,
            "ar" => 957,
            "pt" => 15,
            "es" => 110,
            "fr" => 1398,
            "au" => 341
    	}, 
      :palette => 'palettes/ubuntu.color'
    )
    
    m.title = "Example 2"
    
    m.make_ranges_linear
    m.make_colors
    m.map_values
    m.save_file "map.jpg", :size => '640x480', :quality => 90
    m.save_file "map.svg"
	

You will achieve the following JPG image:

And the map in SVG.

For all possibilities, please see the documentation.

There is also an example inside the code. You can see it in example.rb.