README.md

AmCharts

This is a Native Objective C wrapper for the AmCharts javascript charting library. Both OS X (10.9+) and iOS (7.1+) are supported.

Screenshot

Getting Started

1. Clone this repo
2. In your project Add the freshly cloned 'AmChartsLibrary.xcodeproj' to your workspace. Adding an Existing Project to a Workspace

OS X

3. Add a link to the AmCharts.framework by selecting your target > General Pane > Linked Frameworks and Libraries
4. In "Build Phases" add the AmCharts.framework as a target dependency
5. Add a new "Copy Files Build Phase"
6. Set the destination to "Frameworks"
7. Add the AmCharts.framework

You can now start generating charts in your app!

iOS

3. Add a link to the libAmChartsMobile.a by selecting your target > General Pane > Linked Frameworks and Libraries
4. Under "Build Settings" add -ObjC to "other linker flags"
5. Under "Build Phases" add AmChartsMobile to the target dependencies
6. Add a new "Copy Files Build Phase"
7. Set Destination to "Resources" and add the "AmChartResources.bundle"

Generating Charts

Once the AmChart framework or library is included in your project. Generating a chart is very simple. Import the framework

#import <AmCharts/AmCharts.h>

if you are building an iOS app use this instead:

#import <AmChartsMobile/AmCharts.h>

Add an AmChartView (inherits from Webview) or AmMobileChartView (inherits from UIView) to your window.

Here are some examples of common charts.

Pie Chart

AmPieChart *pieChart = [[AmPieChart alloc] init];
pieChart.type = @"pie";
pieChart.theme = @"none";
NSMutableArray *dataProvider = [[NSMutableArray alloc] init];
[dataProvider addObject:@{@"country" : @"Lithuania", @"litres" : @(501.9)}];
[dataProvider addObject:@{@"country" : @"Czech Republic", @"litres" : @(301.9)}];
[dataProvider addObject:@{@"country" : @"Ireland", @"litres" : @(201.1)}];
pieChart.dataProvider = dataProvider;

pieChart.valueField = @"litres";
pieChart.titleField = @"country";

// where self.chartView references an AmChartView *
[self.chartView setChart:pieChart];
[self.chartView drawChart];

Bar Chart

This code:

AmSerialChart *chart = [[AmSerialChart alloc] init];
chart.type = @"serial";
chart.dataProvider = [@[@{@"year" : @"2005", @"income" : @"23.5"},
                       @{@"year" : @"2006", @"income" : @"26.2"},
                        @{@"year" : @"2007", @"income" : @"30.1"},
                        @{@"year" : @"2008", @"income" : @"32.0"},
                        @{@"year" : @"2009", @"income" : @"31.6"},
                        @{@"year" : @"2010", @"income" : @"33.4"},
                        @{@"year" : @"2011", @"income" : @"34.3"},
                        @{@"year" : @"2012", @"income" : @"34.9"},
                        @{@"year" : @"2013", @"income" : @"35.7"}] mutableCopy];
chart.categoryField = @"year";
//chart.rotate = YES;
chart.categoryAxis.gridPosition = @"start";
chart.categoryAxis.axisColor = @"#DADADA";
AmValueAxis *valAxis = [[AmValueAxis alloc] init];
valAxis.axisAlpha = @(0.2);
chart.valueAxes = [@[valAxis] mutableCopy];
chart.balloon = nil;
AmGraph *graph = [[AmGraph alloc] init];
graph.type = @"column";
graph.title = @"Income";
graph.valueField = @"income";
graph.lineAlpha = @(0);
graph.fillColors = @"#ADD981";
graph.fillAlphas = @(0.8);
graph.balloonText = @"[[title]] in [[category]]:<b>[[value]]</b>";
chart.graphs = [@[graph] mutableCopy];

[self.chartView setChart:chart];
[self.chartView drawChart];

produces this bar chart:

World Map

This code:

AmMap *map = [[AmMap alloc] init];
map.type = @"map";
map.theme = @"none";
map.pathToImages = @"ammap/images/";

AmMapData *mapData = [[AmMapData alloc] init];
mapData.map = @"worldLow";
mapData.getAreasFromMap = true;

map.mapDataProvider = mapData;

AmAreasSettings *areaSettings = [[AmAreasSettings alloc] init];
areaSettings.autoZoom = true;
areaSettings.selectedColor = @"#CC0000";

AmSmallMap *smallMap = [[AmSmallMap alloc] init];

map.smallMap = smallMap;

[self.chartView setChart:map];
[self.chartView drawChart];

produces this map:

Questions

This repo contains both a Mac and iOS example app. You can check how they are set up to make sure that your own project is configured properly. The AmChart website has extensive documentation as well as numerous tutorials. If you find a bug in this wrapper library, send me a pull request with a fix, or at the very least do some detective work first before opening up an issue.

Legal

The source for AmChartsLibrary (the objective-c wrapper) is released under the MIT license. The original AmCharts javascript core is maintained under a separate license. Check http://www.amcharts.com/online-store/ for further information.