<!--
{
  "availability" : [
    "iOS: 16.0.0 -",
    "iPadOS: 16.0.0 -",
    "macCatalyst: 16.0.0 -",
    "macOS: 13.0.0 -",
    "tvOS: 16.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 11.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CreateMLComponents",
  "identifier" : "/documentation/CreateMLComponents/SupervisedTabularEstimator",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "Create ML Components"
    ],
    "preciseIdentifier" : "s:18CreateMLComponents26SupervisedTabularEstimatorP"
  },
  "title" : "SupervisedTabularEstimator"
}
-->

# SupervisedTabularEstimator

A tabular estimator that creates a transformer by fitting to a data set in a data frame.

```
protocol SupervisedTabularEstimator<Transformer, Annotation>
```

## Topics

### Reading and writing

[`func read(from: URL) throws -> Self.Transformer`](/documentation/CreateMLComponents/SupervisedTabularEstimator/read(from:))

Reads the encoded transformer from a file.

[`func write(Self.Transformer, to: URL, overwrite: Bool) throws`](/documentation/CreateMLComponents/SupervisedTabularEstimator/write(_:to:overwrite:))

Writes the encoded transformer to a file.

[`associatedtype Annotation`](/documentation/CreateMLComponents/SupervisedTabularEstimator/Annotation)

The annotation type.

[`var annotationColumnID: ColumnID<Self.Annotation>`](/documentation/CreateMLComponents/SupervisedTabularEstimator/annotationColumnID)

The annotation column identifier.

[`associatedtype Transformer : TabularTransformer`](/documentation/CreateMLComponents/SupervisedTabularEstimator/Transformer)

The transformer type created by this estimator.

### Appending

[`func appending(_:)`](/documentation/CreateMLComponents/SupervisedTabularEstimator/appending(_:))

Composes this supervised tabular estimator with another supervised tabular estimator.

### Fitting

[`func fitted(to: DataFrame, validateOn: DataFrame?, eventHandler: EventHandler?) async throws -> Self.Transformer`](/documentation/CreateMLComponents/SupervisedTabularEstimator/fitted(to:validateOn:eventHandler:))

Fits a transformer to a data frame

[`func fitted(to: DataFrame, validateOn: DataFrame?) async throws -> Self.Transformer`](/documentation/CreateMLComponents/SupervisedTabularEstimator/fitted(to:validateOn:))

### Encoding and decoding

[`func encode(Self.Transformer, to: inout any EstimatorEncoder) throws`](/documentation/CreateMLComponents/SupervisedTabularEstimator/encode(_:to:))

Encodes a fitted transformer.

[`func decode(from: inout any EstimatorDecoder) throws -> Self.Transformer`](/documentation/CreateMLComponents/SupervisedTabularEstimator/decode(from:))

Decodes a previously fitted transformer.

## Relationships

### Conforming Types

[`BoostedTreeRegressor`](/documentation/CreateMLComponents/BoostedTreeRegressor)

[`PreprocessingSupervisedTabularEstimator`](/documentation/CreateMLComponents/PreprocessingSupervisedTabularEstimator)

[`PreprocessingUpdatableSupervisedTabularEstimator`](/documentation/CreateMLComponents/PreprocessingUpdatableSupervisedTabularEstimator)

[`BoostedTreeClassifier`](/documentation/CreateMLComponents/BoostedTreeClassifier)

[`TabularEstimatorToSupervisedAdaptor`](/documentation/CreateMLComponents/TabularEstimatorToSupervisedAdaptor)

[`UpdatableTabularEstimatorToSupervisedAdaptor`](/documentation/CreateMLComponents/UpdatableTabularEstimatorToSupervisedAdaptor)

[`AnnotatedFeatureProvider`](/documentation/CreateMLComponents/AnnotatedFeatureProvider)

### Inherited By

[`UpdatableSupervisedTabularEstimator`](/documentation/CreateMLComponents/UpdatableSupervisedTabularEstimator)

---

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)