<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 10.14.0 -",
    "tvOS: 16.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CreateML",
  "identifier" : "/documentation/CreateML/MLBoostedTreeRegressor",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Create ML"
    ],
    "preciseIdentifier" : "s:8CreateML22MLBoostedTreeRegressorV"
  },
  "title" : "MLBoostedTreeRegressor"
}
-->

# MLBoostedTreeRegressor

A regressor based on a collection of decision trees combined with gradient boosting.

```
struct MLBoostedTreeRegressor
```

## Topics

### Training a boosted tree regressor asynchronously

[`static train(trainingData:targetColumn:featureColumns:parameters:sessionParameters:)`](/documentation/CreateML/MLBoostedTreeRegressor/train(trainingData:targetColumn:featureColumns:parameters:sessionParameters:))

Trains a boosted tree regressor.

[`static makeTrainingSession(trainingData:targetColumn:featureColumns:parameters:sessionParameters:)`](/documentation/CreateML/MLBoostedTreeRegressor/makeTrainingSession(trainingData:targetColumn:featureColumns:parameters:sessionParameters:))

Creates or restores a training session.

[`static func resume(MLTrainingSession<MLBoostedTreeRegressor>) throws -> MLJob<MLBoostedTreeRegressor>`](/documentation/CreateML/MLBoostedTreeRegressor/resume(_:))

Resumes a training session from the last checkpoint if available.

[`static func restoreTrainingSession(sessionParameters: MLTrainingSessionParameters) throws -> MLTrainingSession<MLBoostedTreeRegressor>`](/documentation/CreateML/MLBoostedTreeRegressor/restoreTrainingSession(sessionParameters:))

Restores an existing training session.

### Creating a boosted tree regressor from a checkpoint

[`init(checkpoint: MLCheckpoint) throws`](/documentation/CreateML/MLBoostedTreeRegressor/init(checkpoint:))

Creates a boosted tree regressor  from a checkpoint.

### Training a boosted tree regressor synchronously

[`init(trainingData:targetColumn:featureColumns:parameters:)`](/documentation/CreateML/MLBoostedTreeRegressor/init(trainingData:targetColumn:featureColumns:parameters:))

Creates a boosted tree regressor.

[`var targetColumn: String`](/documentation/CreateML/MLBoostedTreeRegressor/targetColumn)

The name of the column you selected at initialization to define which feature the regressor predicts.

[`var featureColumns: [String]`](/documentation/CreateML/MLBoostedTreeRegressor/featureColumns)

The names of the columns you selected at initialization to train the regressor.

### Evaluating a boosted tree regressor

[`func evaluation(on:)`](/documentation/CreateML/MLBoostedTreeRegressor/evaluation(on:))

Evaluates the classifier on the provided labeled data.

[`var trainingMetrics: MLRegressorMetrics`](/documentation/CreateML/MLBoostedTreeRegressor/trainingMetrics)

Measurements of the regressor’s performance on the training data set.

[`var validationMetrics: MLRegressorMetrics`](/documentation/CreateML/MLBoostedTreeRegressor/validationMetrics)

Measurements of the regressor’s performance on the validation data set.

### Testing a boosted tree regressor

[`func predictions(from:)`](/documentation/CreateML/MLBoostedTreeRegressor/predictions(from:))

Predicts a column of labels for the given testing data.

### Saving a boosted tree regressor

[`func write(to: URL, metadata: MLModelMetadata?) throws`](/documentation/CreateML/MLBoostedTreeRegressor/write(to:metadata:))

Exports a Core ML model file for use in your app.

[`func write(toFile: String, metadata: MLModelMetadata?) throws`](/documentation/CreateML/MLBoostedTreeRegressor/write(toFile:metadata:))

Exports a Core ML model file for use in your app.

### Inspecting a boosted tree regressor

[`var model: MLModel`](/documentation/CreateML/MLBoostedTreeRegressor/model)

The Core ML model.

[`struct ModelParameters`](/documentation/CreateML/MLBoostedTreeRegressor/ModelParameters-swift.struct)

Parameters that affect the process of training a model.

[`let modelParameters: MLBoostedTreeRegressor.ModelParameters`](/documentation/CreateML/MLBoostedTreeRegressor/modelParameters-swift.property)

The underlying parameters used when training the model.

### Describing a boosted tree regressor

[`var description: String`](/documentation/CreateML/MLBoostedTreeRegressor/description)

A text representation of the boosted tree regressor.

[`var debugDescription: String`](/documentation/CreateML/MLBoostedTreeRegressor/debugDescription)

A text representation of the boosted tree regressor that’s suitable for
output during debugging.

[`var playgroundDescription: Any`](/documentation/CreateML/MLBoostedTreeRegressor/playgroundDescription)

A description of the boosted tree regressor shown in a playground.

### Default Implementations

[CustomDebugStringConvertible Implementations](/documentation/CreateML/MLBoostedTreeRegressor/CustomDebugStringConvertible-Implementations)

[CustomPlaygroundDisplayConvertible Implementations](/documentation/CreateML/MLBoostedTreeRegressor/CustomPlaygroundDisplayConvertible-Implementations)

[CustomStringConvertible Implementations](/documentation/CreateML/MLBoostedTreeRegressor/CustomStringConvertible-Implementations)

## Relationships

### Conforms To

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Escapable`](/documentation/Swift/Escapable)

[`Sendable`](/documentation/Swift/Sendable)

[`Copyable`](/documentation/Swift/Copyable)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`CustomPlaygroundDisplayConvertible`](/documentation/Swift/CustomPlaygroundDisplayConvertible)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)