Charts for Swift: Complete Guide with Examples

Introduction to Charts for Swift

Charts is a powerful and flexible open-source library for data visualization on Apple platforms (iOS, tvOS, macOS, watchOS). It is written in Swift and provides a wide range of chart types: from simple line and bar charts to complex combined and bubble charts. The library is a fork of the famous iOS library ios-charts, which in turn was ported from the Java library MPAndroidChart.

Why use Charts?

\n
• Data Visualization: Transforms boring numbers into clear graphs and charts.
\n
• Rich Functionality: Supports animation, interactive interaction (touches, highlighting), legends, axes, data markers, and much more.
\n
• Native Performance: Written in Swift, uses Core Graphics and Core Animation, ensuring smooth operation even with large datasets.
\n
• Easy Integration: Easily installed via Swift Package Manager, CocoaPods, or Carthage.
\n
• Active Community: Regularly updated, has extensive documentation and many examples.
\n

Installing the Charts Library

Charts can be installed using one of three main methods. The recommended method is Swift Package Manager (SPM).

1. Swift Package Manager (SPM) — Recommended Method

\n
1. In Xcode, open your project.
\n
2. Select File → Add Packages...
\n
3. In the search field, enter the repository URL: https://github.com/danielgindi/Charts.git
\n
4. Select the desired version (usually the latest stable one).
\n
5. Click Add Package.
\n
6. Ensure the package is added to your target.
\n

2. CocoaPods

Add to your Podfile:

platform :ios, '13.0'\nuse_frameworks!\n\ntarget 'YourApp' do\n  pod 'Charts'\nend

Then run the command in the terminal:

pod install

3. Carthage

Add to your Cartfile:

github "danielgindi/Charts"

Then run:

carthage update

Quick Start: Creating Your First Chart

Let's create a simple line chart displaying the temperature change over a week.

\n
1. Import the library into your controller:\n

   import UIKit\nimport Charts

   \n
\n
2. Add a View on Storyboard or create it programmatically:\n

   On the storyboard, drag a UIView and change its class to LineChartView in the Identity Inspector. Create an IBOutlet:

   \n

   @IBOutlet weak var lineChartView: LineChartView!

   \n
\n
3. Configure the data:\n

   func setupLineChart() {\n    // 1. Create data points\n    let dataEntries: [ChartDataEntry] = [\n        ChartDataEntry(x: 1.0, y: 20.0),\n        ChartDataEntry(x: 2.0, y: 22.0),\n        ChartDataEntry(x: 3.0, y: 19.0),\n        ChartDataEntry(x: 4.0, y: 25.0),\n        ChartDataEntry(x: 5.0, y: 23.0),\n        ChartDataEntry(x: 6.0, y: 21.0),\n        ChartDataEntry(x: 7.0, y: 26.0)\n    ]\n\n    // 2. Create a data set\n    let lineDataSet = LineChartDataSet(entries: dataEntries, label: "Temperature (°C)")\n    lineDataSet.colors = [.systemBlue] // Line color\n    lineDataSet.circleColors = [.systemRed] // Point color\n    lineDataSet.circleRadius = 4.0\n    lineDataSet.lineWidth = 2.0\n\n    // 3. Create a data object\n    let lineData = LineChartData(dataSet: lineDataSet)\n\n    // 4. Assign data to the chart\n    lineChartView.data = lineData\n\n    // 5. Additional settings\