Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this Page

Table of Contents
excludeOlder Versions|Additional Resources|Related Links|Related Information


This is a Transform type Snap that converts numeric fields into categoricalfields. There are two available splitting options: splitting by values and binning.

Input and Output

Expected input

  • First input view: A document that contains numeric fields.
  • Second input view: A document that contains data statistics computed by the Profile Snap.

Expected outputA document that contains categorical fields.

Expected upstream Snaps:

  • First input view: A Snap that has a document output view. Example: CSV Generator Snap.
  • Second input view: A sequence of File Reader and JSON Parser Snaps. These Snaps read the data statistics computed by the Profile Snap in another pipeline.

Expected downstream Snaps: A Snap that has a document input view. Example: the Aggregate Snap, or a combination of JSON Formatter and File Writer.



Configuring Accounts

Accounts are not used with this Snap.

Configuring Views


This Snap has exactly two document input views, the Data input view and the Profile input view.

OutputThis Snap has exactly one document output view.
ErrorThis Snap has at most one document error view.



Limitations and Known Issues



Snap Settings

LabelRequired. The name for the Snap. Modify this to be more specific, especially if there are more than one of the same Snap in the pipeline.

The preferences for fields and encoding methods. For each policy, select the input field with categorical values, the encoding method, and the result field.


Required. The field that must be transformed. This is a suggestible property that lists all available fields in the input documents.

Default value: None


Required. The type of transformation to be performed on the selected field. Two options are available:

  • Split by Values: Splitting the data into ranges specified by the Splits/Bins property. Each range is replaced with the text specified in the Prefix/Values property.
  • Binning: Splitting the data into equally-sized ranges based on the number of items specified in the Prefix/Values property. If you specify a prefix value in the Prefix/Values property, you must specify the number of bins in the Splits/Bins property.

Default value: Split by Values


Categorical values to be used to replace original numeric values. You can specify either a prefix or multiple values in this property. For example, if the prefix is "group", the values will be "group_1", "group_2" and so on. In case of specifying values, use comma "," to separate them.

Default value: None


The values to be entered into this property depends on the selection you made in the Rule property.

  • Split by Values: This setting must contain a list of split points. "2,4,6,8,10" is the same as "2,4,...,10".
  • Binning: This property specifies the number of bins into which you want to divide the input data range.

Default value: None

Result field

Required. The result field that must be used in the output map. If the Result field is the same as Field, the values are overwritten. If the Result field does not exist in the original input document, a new field is added. 

Default value: None

Multiexcerpt include macro
nameSnap Execution
pageAnaplan Read

Multiexcerpt include macro
pageAnaplan Read


Converting Numeric Data into Categorical Values

This pipeline demonstrates how you can use the Numeric to Categorical Snap to convert numeric fields into categorical fields.

Download this pipeline.

titleUnderstanding the Pipeline

In this example, the CSV Generator Snap contains sample data with numeric fields. The Copy Snap duplicates the data flow and feeds it into the Numeric to Categorical and Profile Snaps. The Profile Snap generates input data statistics and feeds them into the Numeric to Categorical Snap. The Numeric to Categorical Snap then converts the numeric values in the fields of your choice into categorical values, based on the splitting method you select.

Enter the following data into the CSV Generator Snap:

First, we need to convert values in $experience into numeric values. We do this using a Type Converter Snap with the Auto check box selected.

We want to categorize employees based on their years of experience into "junior", "senior", and "principal". We choose Binning in the Rule property to ensure that the data ranges after splitting are equally spaced.

The Numeric to Categorical Snap contains the following settings:

The Profile Snap computes the min and max values in the input data, which is required by Binning.

As you can see, $experience contains min and max values, which are 1 and 22 respectively.

The preview output of the Numeric to Categorical Snap is shown below. This Snap adds one field to the output.

  • $level: This field displays categories of employees based on their years of experience.


patterns*.slp, *.zip

Excerpt Include
ML Data Preparation Snap Pack
ML Data Preparation Snap Pack