SimpleChart

SimpleChart is a package developed for our company, with the intent of sharing to the developer community. As you may know, there are already a lot of SwiftUI charting library. This is yet another implementations.

Supported platforms include iOS v13, macOS v10.15, tvOS v13, watchOS v6, macCatalyst v.13. Basically all SwiftUI support platforms are supported.

What makes this package different? SimpleChart provides utility methods for you to create the chartData list, which is the only necessary parameter for all of our charts config object. To use the provided convenience method, import SimpleChart, call SCManager and the associated methods. SCManager is the manager for all methods provided by this package. SCManager is a shared instance and it is a singleton object.

Available Charts:

1. Bar Chart
2. Histogram
3. Line Chart
4. Quad Curve (curved version of line chart)
5. Range Chart (a chart to represent the range of data within the same time period, similar to heart rate range representation in Apple Health app)

Sample:

All convinence method either accept [Double] or [Int] as an input, except for the following methods:

SCManager.getRangeChartData()

This methods accept both [Double] or [Int], as the “lower” and “upper” argument, along with a list of named tuple (lower: [Double], upper: [Double]) or (lower: [Int], upper: [Int]) for the “data” argument.

All customizations will be done in the config object. You may see the initializer for all of the possible customizations. A special case is that the baseZero might be overridden by the initializer if the data input include negative number.

The following are the properties of different config object that can be customized. If you have no need to customize any specific properties, just remove them from the initializers when you create your config object as default arguments have been implemented. IntervalLineWidth and IntervalColor have effects in all X axis line, Y axis line and all interval lines behind the chart.

chartData: [SCBarChartData]
baseZero: Bool = false
showInterval: Bool = false
showXAxis: Bool = false
showYAxis: Bool = false
showYAxisFigure: Bool = false
showLegend: Bool = false
showLabel: Bool = false
intervalColor: Color = .secondary
intervalLineWidth: CGFloat = 0.5
stroke: Bool = false
strokeWidth: CGFloat = 1
color: [Color] = [.primary]
numOfInterval: Int = 3
xLegend: String = ""
yLegend: String = ""
xLegendColor: Color = .primary
yLegendColor: Color = .primary
gradientStart: UnitPoint = .top
gradientEnd: UnitPoint = .bottom
yAxisFigureColor: Color = .secondary
yAxisFigureFontFactor: Double = 0.06667

yAxisFigureFontFactor is a factor to scale the font size according to the chart height, default font size = chart.height/15 .

Features pending to implement:

1. Legend and associated customizations
2. Label for each data points

The above pending features have been included in the config object, but it will not have any effect in the actual chart views. More customizations will be coming and support and pull request are welcome.