************* Migrating to Charts 3.0 ********************

[danielgindi]

Many have asked about how to migrate to Charts 3.0. So everything will be in the release notes soon as there will be a release, but I will write those down here for now:

---

This is a major release, with a few breaking changes. So please pay attention.

Updates:

• x-indexes are dead. Intoducing: x-values. Each entry now has an x and a y.
• Pie/radar charts do not have a concept of X index anymore
• Unified XAxis/YAxis features and experience.
• Unified formatter interfaces for axes.
• New formatter for y values, not inheriting from NSNumberFormatter anymore, to have dataSet and viewport information to take better formatting decisions.
• Major refactoring of the Highlight mechanism.
• Refactored marker mechanism
• Refactored legend entry mechanism
• Each dataset can now set its own legend form/size/etc.
• More demos
• Some classes have been renamed, keeping the namespaced name only in ObjC (using Swift 2.2 objc(...) feature, and the change of a major version update)
• FillFormatter now has a block representation using FillFormatter.withblock(...)
• Same goes for all Default formatters too.
• No more saveToCameraRoll(). Since Xcode 8.0 it causes "privacy" issues with Apple Review, you have to add the photo albums privacy key to your Info.plist for that.
• Moved to Swift 3.0. Make sure your project conforms to Swift 3.0.
• Many minor bug fixes and improvements

Breaking changes / how to migrate:

• All dataset constructors have changed - they do not take an array of x-indices anymore.
• All entry constructors have changed - they take in an X and a Y.
• Pie and Radar chart entries now have their own classes. So exchange the Entry classes withPieChartDataEntry/RadarChartDataEntry
• If you have any old startAtZeroEnabled calls - these have been deprecated for a long time. Replace them with axisMinimum.
• If you are using formatters:
  • Replace any chart.valueFormatter = formatter with chart.valueFormatter = ChartDefaultValueFormatter(formatter: formatter) or chart.valueFormatter = [[ChartDefaultValueFormatter alloc] initWithFormatter:formatter];
  • Replace any axis.valueFormatter = formatter with axis.valueFormatter = ChartDefaultAxisValueFormatter(formatter: formatter) or axis.valueFormatter = [[ChartDefaultAxisValueFormatter alloc] initWithFormatter:formatter];
• In general, all functions that accepted x-indices before, now accept an x-value, so you might have to adjust the names a little bit.
• Where ChartViewDelegate is implemented, update the chartValueSelected interface
• Replace drawSliceTextEnabled with drawEntryLabelsEnabled
• If you have a custom scatter shape - implement an IShapeRenderer, and put your rendering code in there
• If you have a custom marker - consider subclassing MarkerView/MarkerImage or implementing IMarker. There are more options than before now...
• If you have used barSpace before, move to using barWidth
• If you used saveToCameraRoll(), replace with UIImageWriteToSavedPhotosAlbum(chart.getChartImage(trasparent: false), nil, nil, nil)
• Some classes have been renamed for a cleaner look. They do not contain the "Chart" prefix anymore. That's for Swift only, where there are namespaces. In ObjC the names stayed the same for the sake of namespacing, using Swift 2.2's feature of @objc(name). If your compiler yells that a class does not exist, try to remove the Chart from its name. This should rarely happen, as we've chosen only the classes that are rarely instantiated by the user.

[githubkiven]

@danielgindi Support cocoapods?

[whatya]

@danielgindi can i still copy those classes to my project like before?

[danielgindi]

Not yet in Cocoapods. As I've said it's not released yet.

[danielgindi]

Yes you can copy it the classes like before. However it's more comfortable to drag the xcodeproj to the project. It's not recommended to drag the sources themselves, as this will make updating Chrats in your project more difficult.

[Huang-Libo]

@danielgindi
Thanks for great job!

Now I have a issue, I notice that x-indexes are dead:

- x-indexes are dead. Intoducing: x-values. Each entry now has an x and a y.
- In general, all functions that accepted x-indices before, now accept an x-value,   
   so you might have to adjust the names a little bit.

Then how can I show string(for example, a date string) on xAxis rather than float number(like 1.0, 2.0 ...)?

Answer by Daniel:

Get the NSTimeInterval of a date, NSTimeInterval is actually a double. Then Use formatter to custom it.

[jayvenn]

Can't wait for the release! 👍

[Carielle]

@danielgindi Since I updated to XCode 8.0, my project won't build because I have Charts installed via cocoapods and it's still using a legacy version of Swift. How soon can we expect a release of Charts 3.0, or what can I do to resolve these errors in the meantime? Thanks for all your efforts.

[pmairoldi]

Point your podfile to master branch instead of a version for now

[Carielle]

@petester42 Thanks for the tip, however, I can't seem to get it to work. Changed my podfile to pod 'Charts', :git => 'https://github.com/danielgindi/Charts.git', :branch => 'master' and ran pod install. The output looked like this:

But then I still got the "Use Legacy Swift Language Version" error when I tried to run the project:

Any more helpful hints?

[HenryAlkire]

@Carielle To install Charts 3.0.0 before it is compatible with CocoaPods, remove the old Charts from your pod file and your project, and then download the Charts.xcodeproj file from this github page.

Then open your target project in XCode and drag the Charts.xcodeproj file from the directory it downloaded to into your project in the XCode interface.

After that, add Charts.framework in the "Embedded Binary" section of your project's General Settings.

[liuxuan30]

@ALL do check #1291 for swift 2.3 & 3.0 issues

[Huang-Libo]

Point out a mistake in Migrating description ：
If you are using formatters:

• Replace any chart.valueFormatter = formatter with chart.valueFormatter = ChartDefaultValueFormatter(formatter: formatter) or chart.valueFormatter = [[ChartDefaultValueValueFormatter alloc] initWithFormatter:formatter];
• Replace any axis.valueFormatter = formatter with axis.valueFormatter = ChartDefaultAxisValueFormatter(formatter: formatter) or axis.valueFormatter = [[ChartDefaultAxisValueValueFormatter alloc] initWithFormatter:formatter];

[rrecio]

I'm getting the same as @Carielle, will try what @HenryAlkire said

[pmairoldi]

What branch are you using?

[liuxuan30]

@rrecio It can't be.. I fixed this like a few days ago.

[rrecio]

I was using regular cocoapod setup: pod 'Charts'

To fix it I removed the Podfile entry and linked Charts.framework manually as @Henry explained

Enviado do meu iPhone

Em 20 de set de 2016, às 21:59, Xuan notifications@github.com escreveu:

@rrecio It can't be.. I fixed this like a few days ago.

—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub, or mute the thread.

[StevenMasini]

Any idea about when it will be available on Cocoapods ?

[nightshiftdev]

How do I upgrade Charts to work with Xcode 8.0 and Swift 3.0 using Carthage?

When I run "carthage update", it's still pulling Charts 2.3.0. My Cartfile is configured to use the latest version.

Cartfile:

github "danielgindi/Charts"

Command line:

$carthage update
*** Cloning Charts
*** Cloning Result
*** Cloning realm-cocoa
*** Checking out Charts at "v2.3.0"

[anishparajuli555]

@danielgindi
It would be great if you include this features..As this features are supposed to be in major of the library ...especially in High Charts:

1. line graph with different markers shape
   Query : How to draw square shaped markers in line graph. #1405

2. Able to add custom view in specific locations in x-axis.Customization of background colors is missing in major of the views.
   Query: Add a custom view in x-axis? #1416

[pmairoldi]

Carthage uses the latest release version. If you want 3.0 (which isn't released yet) use github "danielgindi/Charts" "master"

[Rushabh5]

Download Full project using master branch and then drag and drop Charts.xcodeproj and then go to General tab and add Charts.framework under Embedded Binaries after Clean and build so you can see all error are gone just try it. in case you required any help comment it i'll help you. @petester42 @Huang-Libo

[Carielle]

@HenryAlkire I did what you suggested and removed Charts from my podfile and dragged and dropped it manually into my project, and added it as an embedded binary. However, when I try to build the project I keep getting this error:
dyld: Library not loaded: @rpath/libswiftCore.dylib Reason: image not found
It seems to be referenced from the Charts.framework/Charts. Any idea how to solve this issue?

[Carielle]

I solved my own problem - my project is an Objective-C project using the Swift Charts library, so I had to go to Build Settings > Build Options > "Always Embed Swift Standard Libraries" and set it to YES. This replaces the deprecated "Embedded Content Contains Swift" flag.

[bingozb]

@rs10693 Oh, I see! the delegate is valueFormatter...

[Rushabh5]

@bingozb what can you say i don't understand. plz elaborate me.

[hb2708]

@danielgindi i am still not able to install Charts 3.0.0

Following error occurs when run pod install
Analyzing dependencies
[!] Unable to satisfy the following requirements:

• Charts (~> 3.0.0) required by Podfile

None of your spec sources contain a spec satisfying the dependency: Charts (~> 3.0.0).

You have either:

• out-of-date source repos which you can update with pod repo update.
• mistyped the name or version.
• not added the source repo that hosts the Podspec to your Podfile.

Note: as of CocoaPods 1.0, pod repo update does not happen on pod install by default.

Please help does it means that Charts 3.0.0 is not released yet to install by using

or am i missing any step.

[pmairoldi]

3.0 is not yet in cocoapods because it's not final. You can point to the git repo and master to get 3.0 right now

[danielgindi]

We have now released 3.0.0!

[hb2708]

Thats great to know.

But i am a bit worried do we need to update our cocoa pod or it's repository for installing newly released 3.0.0

[pmairoldi]

woot 🎉

[pmairoldi]

@danielgindi you need me to push the pod or you got that covered?

[danielgindi]

Tried, now after a long time, said that the podspec does not validate...

[pmairoldi]

Ya it takes a while. I can do it. You need cocoapods 1.1 to work with Xcode 8/swift 3

[hb2708]

@petester42 @danielgindi
I have
pod --version = 1.1.0

but still the pod install command installs older version.

Analysing dependencies
Downloading dependencies
Installing Charts (2.3.0)

Please guide

[hb2708]

It's working now after updating the master repo of pod thanks for help

[ghost]

Getting such error in Swift 3.0, while implementing Bar Graph using this library.

After resolving above error, it gives next error as shown below.

How do I resolve such error in Swift 3.0?

[AnChiChang]

let chartDataSet = BarChartDataSet(values: dataEntries, label: nil)
let chartData = BarChartData(dataSet: chartDataSet)

about xVals, you have to implement stringForValue.

[ghost]

Thanks. how should I implement stringForValue for xVals.

[HPRaval]

Please provide swift 3 examples

[denebj]

Hello,
I just migrated from the 2 to the 3 (I am using the 3.0.2) and I am running into 2 issues :

• If I have 0 values in my dataset, the bar graph is being shifted , this is weird and I pretty much use the code of the demo samples. Any idea ?

• Is there a way to hide the 0 values a together and just show the values that are > 0 ?

Thank you for the input.

[thierryH91200]

in class BarChartRenderer
in open override func drawValues(context: CGContext)
add line 408

             if !dataSet.isStacked
               {
                   for j in 0 ..< Int(ceil(Double(dataSet.entryCount) * animator.phaseX))
                   {
                       guard let e = dataSet.entryForIndex(j) as? BarChartDataEntry else { continue }
                       
                       let rect = buffer.rects[j]
                       
                       let x = rect.origin.x + rect.size.width / 2.0
                       
                       if !viewPortHandler.isInBoundsRight(x)
                       {
                           break
                       }
                       if !viewPortHandler.isInBoundsY(rect.origin.y)
                           || !viewPortHandler.isInBoundsLeft(x)
                       {
                           continue
                       }
                       
                       let val = e.y
                       if val == 0                            <-----------this line
                       {                                           <-----------this line
                           continue                         <-----------this line
                       }                                          <-----------this line

add a variable if you want
var drawValuesZeroEnabled: Bool { get set }

[denebj]

Thank you Thierry.
So that's fixed :)

I still have the issue of that weird spacing.

So I just created a default bar chart with a 0 value and I still have the issue - I tried to get as close as possible to a simple bar to see what was the issue.

It looks like the demo but a soon as I put a value between 0 and 0.9999 I get that padding.

Here the sample code :

    @IBOutlet var barChartView: BarChartView!

 func viewDidLoad() {
        super.viewDidLoad()
         self.styleChart()
         self.configureChart()
    }

    internal func styleChart() {
        self.barChartView.xAxis.labelPosition = .bottom
        self.barChartView.xAxis.labelCount = 2
    }
    
    internal func configureChart() {
        
        var xValues = [String]()
        var entries: [ChartDataEntry] = Array()

         xValues.append("TEST 5")
         xValues.append("TEST 0")
         entries.append(BarChartDataEntry(x: Double(0), y: Double(5) ))
         entries.append(BarChartDataEntry(x: Double(1), y: Double(0) ))
        
        
        let dataSet = BarChartDataSet(values: entries, label: "")
        dataSet.drawIconsEnabled = false
        dataSet.drawValuesEnabled = true

        let formatter = NumberFormatter()
        formatter.numberStyle = NumberFormatter.Style.decimal
        dataSet.valueFormatter = DefaultValueFormatter(formatter: formatter)

        let barChartData = BarChartData(dataSet: dataSet)
        barChartData.barWidth = 0.2        
         self.barChartView.data = barChartData
    }

Pretty straightforward.

It is a bug ?

Issue with 0 :

No 0 :

Thank you for the help ;)

[Wh1rlw1nd]

Where I can find docs about old API for Charts ? I never used this framework (aside from upgrading it few times) and I have to upgrade from 2.3 to 3.0.4, so old docs would be nice to figure out old code, eg:

[entrySet addObject:[[ChartDataEntry alloc] initWithValue: item.avgSpeed xIndex:index]];

Now, there is no init called initWithValue: xIndex, but rather there is init called:

initWithX: y: , so I am trying to figure out what were old parameters, and how to use new init to achieve the same result...

Also the valuesObjc array is missing now:

//myLineChartView is LineChartView
 NSDate* date = (NSDate*)[myLineChartView.xAxis.valuesObjc objectAtIndex:index];

As I said, I never used this framework, so some help would be appreciated, or at least link to old API docs would be helpful...

[pmairoldi]

I don’t think such resource exists. You can check the legacy/2.3 branch to check the demos and such to compared with other hthe current version.

[CupidLoud]

BarChartData.init(xVals: xVals, dataSets: dataSets) can not work. what is replace it?

[varmakarthik9]

How can I scroll the x value of line chart to the center programatically?