特征

在上一节介绍了输入数据包括MaxCompute表、csv文件、hdfs文件、OSS文件等，表或文件的一列对应一个特征。

在数据中可以有一个或者多个label字段，而特征比较丰富，支持的类型包括IdFeature，RawFeature，TagFeature，SequenceFeature, ComboFeature.

各种特征共用字段

input_names: 输入的字段，根据特征需要，可以设置1个或者多个
feature_name: 特征名称，如果没有设置，默认使用input_names[0]作为feature_name

如果有多个特征使用同一个input_name，则需要设置不同的feature_name, 否则会导致命名冲突

feature_config:{
 features {
   input_names: "uid"
   feature_type: IdFeature
   embedding_dim: 32
   hash_bucket_size: 100000
 }

 features {
   feature_name: "combo_uid_category"
   input_names: "uid"
   input_names: "category"
   feature_type: ComboFeature
   embedding_dim: 32
   hash_bucket_size: 1000000
 }
}

max_partitions: 当hash_bucket_size或者num_buckets较大(>=1e+7)时, 建议设置max_partitions >= parameter server number, 让参数在parameter server上分布更加均匀, 防止某个ps通信和计算过载.
shared_names: 其它输入的数据列，复用这个config，仅仅适用于只有一个input_names的特征，不适用于有多个input_names的特征，如ComboFeature.

IdFeature: 离散值特征/ID类特征

离散型特征，例如手机品牌、item_id、user_id、年龄段、星座等，一般在表里面存储的类型一般是string或者bigint。

其中embedding_dim 的计算方法可以参考：
```
embedding\_dim=8+x^{0.25}
```

其中，x 为不同特征取值的个数

hash_bucket_size: hash bucket的大小。适用于category_id, user_id等

对于user_id等规模比较大的，hash冲突影响比较小的特征，

hash\_bucket\_size  = \frac{number\_user\_ids}{ratio},      建议：ratio \in [10,100];

对于星座等规模比较小的，hash冲突影响比较大的

hash\_bucket\_size = number\_xingzuo\_ids * ratio,    建议 ratio \in [5,10]

num_buckets: buckets number, 仅仅当输入是integer类型时，可以使用num_buckets
vocab_list: 指定词表，适合取值比较少可以枚举的特征，如星期，月份，星座等
vocab_file: 使用文件指定词表，用于指定比较大的词表。
- 格式: 每行一个单词
- 路径: 在提交tf任务到pai集群的时候，可以把词典文件存储在oss中。
NOTE: hash_bucket_size, num_buckets, vocab_list, vocab_file只能指定其中之一，不能同时指定

RawFeature：连续值特征

连续值类特征可以先使用分箱组件+进行离散化，可以进行等频/等距/自动离散化，变成离散值。推荐使用分箱组件得到分箱信息表，在训练时可以通过"-Dboundary_table odps://project_name/tables/boundary_info"导入boundary_info表，省去在config中写入boundaries的操作。

DROP table if exists boundary_info;
PAI -name binning
-project algo_public
-DinputTableName=train_data
-DoutputTableName=boundary_info
-DselectedColNames=col1,col2,col3,col4,col5
-DnDivide=20;

pai -name easy_rec_ext -project algo_public
 -Dconfig=oss://easyrec/config/MultiTower/dwd_avazu_ctr_deepmodel_ext.config
 -Dcmd=train
 -Dtables='odps://pai_online_project/tables/dwd_avazu_ctr_deepmodel_train,odps://pai_online_project/tables/dwd_avazu_ctr_deepmodel_test'
 -Dboundary_table='odps://pai_online_project/tables/boundary_info'
 -Dcluster='{"ps":{"count":1, "cpu":1000}, "worker" : {"count":3, "cpu":1000, "gpu":100, "memory":40000}}'
 -Darn=acs:ram::xxx:role/xxx
 -Dbuckets=oss://easyrec/
 -DossHost=oss-cn-beijing-internal.aliyuncs.com
 -Dwith_evaluator=1;

feature_config:{
  features {
    input_names: "ctr"
    feature_type: RawFeature
    embedding_dim: 8
  }
}

分箱组件使用方法见：机器学习组件也可以手动导入分箱信息。如下：

feature_config:{
  features {
    input_names: "ctr"
    feature_type: RawFeature
    boundaries: [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0]
    embedding_dim: 8
  }
}

boundaries: 分桶的值，通过一个数组来设置。如果通过"-Dboundary_table"导入分箱表，则无需写入，程序会自动导入到pipeline.config中。
embedding_dim: 如果设置了boundaries，则需要配置embedding dimension。
如果没有设置boundaries，在deepfm算法的wide端会被忽略

这里同样支持embedding特征，如"0.233|0.123|0.023|2.123|0.233|0.123|0.023|2.123"

feature_config:{
  features {
    input_names: "pic_emb"
    feature_type: RawFeature
    separator: '|'
    raw_input_dim: 8
  }
}

raw_input_dim: 指定embedding特征的维度

还支持多个embedding特征的聚合操作，如"0.23|-0.123|0.923|-2.123;2.3|0|0|12.33;0|-1.23|0.023|0.32"

feature_config:{
  features {
    input_names: "pic_emb"
    feature_type: RawFeature
    separator: '|'
    raw_input_dim: 4
    seq_multi_sep: ";"
    combiner: "max"
  }
}

seq_multi_sep: 指定多个embedding序列的分隔符
combiner: 指定多个embedding序列的聚合方式，可选值：min, max, mean, sum

上面例子聚合之后的结果为："2.3|0|0.923|12.33"

TagFeature

有多个tag的情况下，tag之前使用分隔符进行分隔。

tags字段可以用于描述商品的多个属性

feature_config:{
  features : {
     input_names: 'properties'
     feature_type: TagFeature
     separator: '|'
     hash_bucket_size: 100000
     embedding_dim: 24
  }
}

separator: 分割符，默认为'|'
hash_bucket_size: hash分桶大小，配置策略和IdFeature类似
num_buckets: 针对输入是整数的情况, 如6|20|32，可以配置num_buckets，配置为最大值
embedding_dim: embedding的dimension，和IdFeature类似

我们同样支持有权重的tag特征，如"体育:0.3|娱乐:0.2|军事:0.5"：

feature_config:{
  features : {
     input_names: 'tag_kvs'
     feature_type: TagFeature
     separator: '|'
     kv_separator: ':'
     hash_bucket_size: 100000
     embedding_dim: 24
  }
}

或"体育|娱乐|军事"和"0.3|0.2|0.5"的输入形式:

feature_config:{
  features : {
     input_names: 'tags'
     input_names: 'tag_scores'
     feature_type: TagFeature
     separator: '|'
     hash_bucket_size: 100000
     embedding_dim: 24
  }
}

NOTE:

如果使用csv文件进行存储，那么多个tag之间采用列内分隔符进行分隔，例如: csv的列之间一般用逗号(,)分隔，那么可采用竖线(|)作为多个tag之间的分隔符。
weights: tags对应的权重列，在表里面一般采用string类型存储。
weights的数目必须要和tag的数目一致，并且使用列内分隔符进行分隔。

SequenceFeature：行为序列类特征

feature_config:{
  features {
    input_names: "play_sequence"
    feature_type: SequenceFeature
    sub_feature_type: IdFeature
    embedding_dim: 32
    hash_bucket_size: 100000
  }
}

embedding_dim: embedding的dimension
hash_bucket_size: 同离散值特征
sub_feature_type: 用于描述序列特征里子特征的类型，目前支持 IdFeature 和 RawFeature 两种形式，默认为 IdFeature
NOTE：SequenceFeature一般用在DIN算法或者BST算法里面。

在模型中可支持对序列特征使用Target Attention（DIN)，方法如下：

feature_groups: {
  group_name: 'user'
  feature_names: 'user_id'
  feature_names: 'cms_segid'
  feature_names: 'cms_group_id'
  feature_names: 'age_level'
  feature_names: 'pvalue_level'
  feature_names: 'shopping_level'
  feature_names: 'occupation'
  feature_names: 'new_user_class_level'
  wide_deep:DEEP
  sequence_features: {
    group_name: "seq_fea"
    allow_key_search: true
    need_key_feature:true
    allow_key_transform:false
    transform_dnn:false
    seq_att_map: {
      key: "brand"
      key: "cate_id"
      hist_seq: "tag_brand_list"
      hist_seq: "tag_category_list"
      aux_hist_seq: "time_stamp_list"
    }
  }
}

sequence_features: 序列特征组的名称
seq_att_map: target attention模块, 具体细节可以参考排序里的 DIN 模型
- key: target item相关的特征, 包括id和side info(如brand, category, ctr)等
- hist_seq: 用户行为id序列和side info序列, 需要和key一一对应
- aux_hist_seq: 如果某个side info序列和 key 对应不上, 可以放在aux_hist_seq里面
allow_key_search: 当 key 对应的特征没有在 feature_groups 里面时，需要设置为 true, 将会复用对应特征的 embedding.
need_key_feature : 默认为 true, 指过完 target attention 之后的特征会和 key 对应的特征 concat 之后返回。设置为 false 时，将会只返回过完 target attention 之后的特征。
allow_key_transform: 默认为 false, 指 key 和 hist_seq 需一一对应，其对应的 embedding_dim 也需要相等
- 如不相等, 可以设置 allow_key_transform 为 true, 将key的embedding_dim映射到和 hist_seq 相同
  
  默认处理方式为 padding, 当设置 transform_dnn 为 true 时，使用 dnn 的方式映射。
NOTE: SequenceFeature一般放在 user 组里面.
TextCNN特征聚合(Sequence Combiner) 特征配置模块支持使用TextCNN算子对序列特征进行embedding聚合，示例:

feature_configs: {
  input_names: 'title'
  feature_type: SequenceFeature
  separator: ' '
  embedding_dim: 32
  hash_bucket_size: 10000
  sequence_combiner: {
    text_cnn: {
      filter_sizes: [2, 3, 4]
      num_filters: [16, 8, 8]
    }
  }
}

num_filters: 卷积核个数列表
filter_sizes: 卷积核步长列表

TextCNN网络是2014年提出的用来做文本分类的卷积神经网络，由于其结构简单、效果好，在文本分类、推荐等NLP领域应用广泛。从直观上理解，TextCNN通过一维卷积来获取句子中`N gram`的特征表示。在推荐模型中，可以用TextCNN网络来提取文本类型的特征。

ComboFeature：组合特征

对输入的离散值进行组合, 如age + sex:

feature_config:{
  features {
      input_names: ["age", "sex"]
      feature_name: "combo_age_sex"
      feature_type: ComboFeature
      embedding_dim: 16
      hash_bucket_size: 1000
  }
}

input_names: 需要组合的特征名，数量>=2, 来自data_config.input_fields.input_name
embedding_dim: embedding的维度，同IdFeature
hash_bucket_size: hash bucket的大小
combo_join_sep: 连接多个特征的分隔符, 如age是20, sex是'F', combo_join_sep是'X', 那么产生的特征是'20_X_F'
combo_input_seps: 分隔符数组, 对应每个输入(input_names)的分隔符, 如果不需要分割, 填空字符串''; 如果所有的输入都不需要分割, 可以不设置

ExprFeature：表达式特征

对数值型特征进行比较运算，如判断当前用户年龄是否>18，男嘉宾年龄是否符合女嘉宾年龄需求等。将表达式特征放在EasyRec中，一方面减少模型io，另一方面保证离在线一致。

data_config {
    input_fields {
      input_name: 'user_age'
      input_type: INT32
    }
    input_fields {
      input_name: 'user_start_age'
      input_type: INT32
    }
    input_fields {
      input_name: 'user_start_age'
      input_type: INT32
    }
    input_fields {
      input_name: 'user_end_age'
      input_type: INT32
    }
    input_fields {
      input_name: 'guest_age'
      input_type: INT32
    }
  ...
}
feature_config:{
    features {
     feature_name: "age_satisfy1"
     input_names: "user_age"
     feature_type: ExprFeature
     expression: "user_age>=18"
   }
   features {
     feature_name: "age_satisfy2"
     input_names: "user_start_age"
     input_names: "user_end_age"
     input_names: "guest_age"
     feature_type: ExprFeature
     expression: "(guest_age>=user_start_age) & (guest_age<=user_end_age)"
   }
   features {
     feature_name: "age_satisfy3"
     input_names: "user_age"
     input_names: "guest_age"
     feature_type: ExprFeature
     expression: "user_age==guest_age"
   }
   features {
     feature_name: "age_satisfy4"
     input_names: "user_age"
     input_names: "user_start_age"
     feature_type: ExprFeature
     expression: "(age_level>=user_start_age) | (user_age>=18)"
   }
}

feature_names: 特征名
input_names: 参与计算的特征名来自data_config.input_fields.input_name
expression: 表达式。
- 目前支持"<", "<=", "==", ">", "<=", "+", "-", "*", "/", "&" , "|"运算符。
- 当前版本未定义"&","|"的符号优先级，建议使用括号保证优先级。
- customized normalization: "tf.math.log1p(user_age) / 10.0"

EmbeddingVariable

Key Value Hash, 减少hash冲突, 支持特征准入和特征淘汰。

model_config {
  model_class: "MultiTower"
  ...
  ev_params {
    filter_freq: 2
  }
}

配置方式:
- feature_config单独配置ev_params
- model_config里面统一配置ev_params
ev_params : EVParams
- filter_freq: 频次过滤, 低频特征噪声大,过滤噪声让模型更鲁棒
- steps_to_live: 特征淘汰, 淘汰过期特征,防止模型过大
Note: 仅在安装PAI-TF/DeepRec时可用

特征选择

对输入层使用变分dropout计算特征重要性，根据重要性排名进行特征选择。

rank模型中配置相应字段：

model_config {
  model_class: 'MultiTower'
  ...
  variational_dropout{
      regularization_lambda:0.01
      embedding_wise_variational_dropout:false
  }
  ...
}

regularization_lambda: 变分dropout层的正则化系数设置
embedding_wise_variational_dropout: 变分dropout层维度是否为embedding维度（true：embedding维度；false：feature维度；默认false）
启动训练

查看特征重要性:

pai -name easy_rec_ext
  -Dcmd='custom'
  -DentryFile='easy_rec/python/tools/feature_selection.py'
  -Dextra_params='--config_path oss://{oss_bucket}/EasyRec/deploy/fea_sel/${bizdate}/pipeline.config --output_dir oss://{oss_bucket}/EasyRec/deploy/fea_sel/${bizdate}/output --topk 1000 --visualize'
  -Dbuckets='oss://{oss_bucket}/'
  -Darn='acs:ram::xxx:role/aliyunodpspaidefaultrole'
  -DossHost='oss-{region}-internal.aliyuncs.com';

extra_params:
- config_path: EasyRec config path
- output_dir: 输出目录
- topk: 输出top_k重要的特征
- visualize: 输出重要性可视化的图
- fg_path: RTP-FG json配置文件, 可选
arn: rolearn to access oss.
version: EasyRec version, 默认stable
res_project: EasyRec部署的project, 默认algo_public

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feature.rst

feature.rst

特征

各种特征共用字段

IdFeature: 离散值特征/ID类特征

RawFeature：连续值特征

TagFeature

NOTE:

SequenceFeature：行为序列类特征

ComboFeature：组合特征

ExprFeature：表达式特征

EmbeddingVariable

特征选择

分隔符

列间分隔符

列内分隔符

Files

feature.rst

Latest commit

History

feature.rst

File metadata and controls

特征

各种特征共用字段

IdFeature: 离散值特征/ID类特征

RawFeature：连续值特征

TagFeature

NOTE:

SequenceFeature：行为序列类特征

ComboFeature：组合特征

ExprFeature：表达式特征

EmbeddingVariable

特征选择

分隔符

列间分隔符

列内分隔符