in src/dataViewBuilder/dataViewBuilder.ts [125:157]
    public withCategory(options: DataViewBuilderCategoryColumnOptions): IDataViewBuilderCategorical {
        let categoryValues = options.values,
            identityFrom = options.identityFrom,
            sourceType = options.source.type;
        let categoryColumn: DataViewCategoryColumn = {
            source: options.source,
            identityFields: options.identityFrom.fields,
            identity: options.identityFrom.identities || [],
            values: categoryValues,
        };
        if (!options.identityFrom.identities) {
            for (let categoryIndex = 0, categoryLength = categoryValues.length;
                categoryIndex < categoryLength;
                categoryIndex++) {
                categoryColumn.identity.push(getScopeIdentity(
                    identityFrom,
                    categoryIndex,
                    categoryValues[categoryIndex],
                    sourceType));
            }
        }
        if (!this.categories) {
            this.categories = [];
        }
        this.categories.push(categoryColumn);
        return this;
    }