WebDigg

LR+FTRL算法原理以及工程化实现

作者: 青烟雨后
发布日期: 2019-11-23

前言

在实际项目或者刷竞赛的时候，经常会遇到训练数据非常大导致一些算法实际上不能操作的问题。比如在广告行业中，因为DSP的请求数据量特别大，一个星期的数据往往有上百G，这种级别的数据在训练的时候，直接套用一些算法框架是没办法训练的，基本上在特征工程的阶段就一筹莫展。通常采用采样、截断的方式获取更小的数据集，或者使用大数据集群的方式进行训练，但是这两种方式在作者看来目前存在两个问题：

采样数据或者截断数据的方式，非常的依赖前期的数据分析以及经验。
大数据集群的方式，目前spark原生支持的机器学习模型比较少；使用第三方的算法模型的话，需要spark集群的2.3以上；而且spark训练出来的模型往往比较复杂，实际线上运行的时候，对内存以及QPS的压力比较大。

我自己以前在刷竞赛的时候，看到别人使用过FM+FTRL的模型实现了一个CTR算法，印象很深。自己使用的是DNN+Embedding的方式做的一个算法模型，从理论上看embedding肯定比one-hot encoder的方式更加先进且能真实反馈特征数据的相关性，但是实际效果看对方的FM_FRTL得到的AUC比我高近一个百分点，而且可以在10G的数据上一个多小时跑完，而我的DNN+Embedding算法，因为没有GPU主机，跑一次需要十二个小时，严重影响了调参的积极性，这也是我非常想掌握FTRL的出发点。

更重要的是，考虑到刷竞赛与实际算法是否可工程化的的角度，FTRL结合LR或者FM是一个非常好的方向，比Top1开源的代码使用了PCA、NLP处理特征以及多个模型stacking的技巧，更具有学习或者借鉴的价值。

本文主要根据谷歌给出的FTRL理论论文，以及FTRL+LR的工程化实现论文，从理论到工程化实现LR+FTRL的开发，任一后端开发人员都能根据文末给出的python代码，简单的开发就能实现一个简单、高性能、高可靠的CTR预测模型。

LR

关键概念点：

logistic distribution
几率
对数几率
损失函数
参数估计
误差计算
随机梯度下降

LR数学原理

LR(logistic regression model)是一种分类模型，我们通常都知道：

$LR = Line Regression + sigmod \tag{1}$

但是对其实际的数学原理却不是很了解。logistics regression中的logistic指的是统计学中的logistic distribution:

标准logistic分布密度函数与分布函数

可以说LR是线性回归模型通过logistic的分布函数，将预测结果映射到概率空间，进而预测不同分类的概率，其概率由条件概率P(Y

X)表示。

LR模型既可以做二分类也可以做多分类，因为从事的是广告、营销行业的模型预估，本文只针对 二分类的LR模型 (binary logistic regression model)做原理讲解以及模型工程化实现。

二分类的LR模型是如下条件概率的分布：

$P(Y=1|X) = \frac{exp(wx +b)}{1+exp(wx + b)} \tag{2}$

$P(Y=0|X) = \frac{1}{1+exp(wx + b)} \tag{3}$

几率：如果一个事件发生的概率是p，那么该事件发生的几率是发生的概率/不发生的概率:

$odds = \frac{p}{1-p} \tag{4}$

对数几率：对几率取对数。

$logit(p) = log(odds) = log(\frac{p}{1-p}) \tag{5}$

代入公式(2)和公式(3)得到:

$\log{\frac{P(Y=1|X)}{1-P(Y=1|X)}} = w * x \tag{6}$

可以看出LR也可以认为是用线性回归模型的预测结果来预测事件发生的对数几率。

LR有很多优点，比如：

作为统计模型与机器学习的结合点，具有较好的预测结果以及可解释性。
直接对分类的可能性建模，无需事先假设数据的分布，这就避免了假设分布不准确带来的影响。
不仅预测得到分类，还有分类对应的概率，这对很多需要使用概率辅助决策的任务很有用。
sigmod函数是高阶可导的凸函数，具有很好的数学性质，很多数值优化的算法都可以直接用于求解最优解。

参数估计

损失函数

逻辑回归模型学习时，对于给定的训练集，可以使用极大似然估计法估计模型参数（将权重向量w和输入向量x扩充一位），设：

$\begin{align} P(Y=1|X) &=\pi(x)= \frac{exp(wx +b)}{1+exp(wx + b)} =\frac{exp(wx)}{1+exp(wx)} \tag{7} \end{align}$

$\begin{align} P(Y=0|X) = 1- \pi(x)\ =\frac{1}{1+exp(wx + b)}=\frac{1}{1+exp(wx)} \tag{8} \end {align}$

似然函数是：

$\prod_{i=1}^{n}[\pi(x_i)]^{y_{i}}[1-\pi(x_{i})]^{1-y_{i}}\tag{9}$

对数似然函数：

$\begin{align} L(W) =& \sum_{i=1}^{N}[y_{i}log(\pi(x_{i}))+(1-y_{i})log(1-\pi(x_{i})]))\\ =&\sum_{i=1}^{N}[y_{i}log\frac{\pi(x_{i})}{1-\pi_{x_{i}}}+log(1-\pi(x_{i}))]\\ =&\sum_{i=1}^{N}[y_{i}(wx)-log(1+exp(w*x))] \tag{10}\end{align}$

这样逻辑回归的参数优化问题就变成了以对数似然函数为目标的最优化问题，也就是对公式10求最大值时的参数w；

实际应用中，通常是使用最小化损失函数的概念来寻找最佳参数空间， 所以对公式10取负号以及平均后得到逻辑回归模型的损失函数：

$\begin{align*} l(w) =& -\frac{1}{N}\sum_{i=1}^{N}[y_{i}*log(\pi(x_{i}))+(1-y_{i})*log(1-\pi(x_{i})]))\\ =& -\frac{1}{N}\sum_{i=1}^{N}[y_{i}*(w*x)-log(1+exp(w*x))] \tag{11} \end {align*}$

也就是我们常说的交叉熵损失函数，是一个高阶可导连续凸函数。根据凸函数优化理论，可以使用梯度下降法、牛顿法、trust-region等方法进行优化。

以梯度下降法为例，计算l(w)的梯度为：

$\begin{align*} g_{j} =&\frac{\partial(l(w))}{\partial(w_{j})} \\ =& \frac{1}{N}\sum_{i=1}^{N}-y_{i}*x_{i}^{j} + \frac{exp(w*x)}{1+exp(w*x)}*x_{i}^{j} \\ =& \frac{1}{N}\sum_{i=1}^{N}(\pi(x_{i}) - y_{i}) * x_{i}^{j} \tag{12} \end{align*}$

所以样本第j个参数的优化方式为：

$w^{i+1}_{j} = w^{i}_{j} - a * g_{j}\tag{13}$

所有样本的第j个参数更新方式为：

$w_{j} = w_{j} - \alpha * \frac{1}{N}\sum_{i=1}^{N}(\pi(x_{i})-y_{i})*x_{i}^{j}\tag{14}$

当样本数据里N很大的时候，通常采用的是随机梯度下降法，算法如下所示：

while {
for i in range(0,m):
w_j = w_j + a * g_j
}

随机梯度下降的好处是可以实现分布式并行化，具体计算流程是：

在每次迭代的时候，随机抽样一定比例的样本作为当前迭代的计算样本。
对计算样本中的每一个样本，分别计算不同特征的计算梯度。
通过聚合函数，对所有计算样本的特征的梯度进行累加，得到每一个特征的累积梯度以及损失。
最后根据最新的梯度以及之前的参数，对参数进行更新。
根据更新的参数计算损失函数误差值，如果损失函数误差值达到允许的范围，那么停止迭代，否则重复步骤1。

工程化实现思路

主要是需要实现参数更新计算以及损失函数计算。

FTRL

算法原理

参数权重更新

FTRL算法权重更新公式为： $\begin{align*} W^{t+1} &= \operatorname*{argmin}_{W}\{G^{(1:t)}W + \lambda_{1}||W||_{1} + \frac{1}{2}\lambda_{2}||W||_{2}^2 + \frac{1}{2}\sum_{s=1}^{t}\sigma^{(s)}||W-W^{(s)}||_{2}^{2}\}\\ &= \operatorname{argmin}_{W}\{(G^{(1:t)}-\sum_{s=1}^{t}\sigma^{(s)}W^{(s)})W + \lambda_{1}||W||_{1} + \frac{1}{2}(\lambda_2 + \sum_{s=1}^{t}\sigma^{(s)})||W||_2^2+\frac{1}{2}\sum_{s=1}^{t}\sigma^{(s)}||W^{(s)}||_{2}^{2}\} \tag{15} \end{align*}$

由于 $\frac{1}{2}\sum_{s=1}^{t}\sigma^{(s)}||W^{(s)}||_{2}^{2}$ 相对于W来说是一个常数，并且令 :

$Z^{(t)} = G^{(1:t)} - \sum_{s=1}^{t}\sigma^{(s)}W^{(s)}$

公式15等价于：

$\begin{align*} W^{t+1} &= \operatorname{argmin}_{W}\{Z^{(t)}W + \lambda_{1}||W||_{1} + \frac{1}{2}(\lambda_2 + \sum_{s=1}^{t}\sigma^{(s)})||W||_2 \tag{16} \end{align*}$

针对特征权重的各个维度将其拆解成N个单独的标量最小化问题：

$\operatorname{min}_{W_{i}\in{R}}\{Z_{i}^{(t)}*w_{i} + \lambda_{1}|w_{i}|+\frac{1}{2}（\lambda_{2}+\sum_{s=1}^{t}\sigma^{(s)})w_{i}^{2}\}\tag{17}$

公式17是一个无约束的非平滑参数优化问题，其中第二项 $||w_{i}||$ 在 $w_{i}$ 处不可导。假设 $w_{i}^{*}$ 是其最优解，并且定义 $\xi\in{\partial|w_{i}^{*}|}$ 是 $|w_{i}|$ 在 $w_{i}^{*}$ 的次导数 ，那么有：

$\partial|w_{i}^{*}| = \left\{ \begin{array}{ftrl} &\{-1<\xi<1\} &if&w_{i}^{*}=0 \\ &{1}&if&w_{i}^{*}>0\\ &{-1}&if&w_{i}^{*}<0 \end{array}\tag{18} \right.$

对公式17进行求导，并等于0，有：

$Z_{i}^{(t)} + \lambda_{1}\xi+(\lambda_{2}+\sum_{s=1}^{t}\sigma^{(s)})w_{i}=0\tag{19}$

由于 $\lambda_{1},\lambda_{2}$ 大于0，针对公式19分三种情况：

当 $|Z_{i}^{(t)}|<\lambda_{1}$ 的时候：
如果 $w_{i}^{*}=0$ ，由公式19可以得到 $\xi=-Z_{i}^{(t)}/\lambda_{1}$ , 符合公式18的条件1.
如果 $w_{i}^{*}>0$ ，有公式18得到 $\xi=1$ ，那么 $Z_{i}^{(t)} + \lambda_{1}+(\lambda_{2}+\sum_{s=1}^{t}\sigma^{(s)})w_{i}> Z_{i}^{(t)} + \lambda_{1}>0$ ， 不满足公式19.
如果 $w_{i}^{*}<0$ ，有公式18得到 $\xi=-1$ ，那么 $Z_{i}^{(t)} -\lambda_{1}+(\lambda_{2}+\sum_{s=1}^{t}\sigma^{(s)})w_{i}< Z_{i}^{(t)} -\lambda_{1}<0$ ， 不满足公式19.
所以当 $|Z_{i}^{(t)}|<\lambda_{1}$ 的时候， $w_{i}^{*}=0$ 。
当 $Z_{i}^{(t)}>\lambda_{1}$ 的时候：
如果 $w_{i}^{*}=0$ ，由公式19可以得到 $\xi=-Z_{i}^{(t)}/\lambda_{1}<-1$ , 不符合符合公式18 。
如果 $w_{i}^{*}>0$ ，有公式18得到$\xi=1 $\xi=1$ ，那么 $Z_{i}^{(t)} + \lambda_{1}+(\lambda_{2}+\sum_{s=1}^{t}\sigma^{(s)})w_{i}> Z_{i}^{(t)} + \lambda_{1}>0$ ， 不满足公式19.
如果 $w_{i}^{*}<0$ ，有公式18得到 $\xi=-1$ ，那么 $Z_{i}^{(t)} -\lambda_{1}+(\lambda_{2}+\sum_{s=1}^{t}\sigma^{(s)})w_{i}=0$ ，所以有： $w_{i}^{*}=-(\lambda_{2}+\sum_{s=1}^{t}\sigma^{(s)})^{-1}*(Z_{i}^{(t)} -\lambda_{1})$
当 $Z_{i}^{(t)}<-\lambda_{1}$ 的时候：
如果 $w_{i}^{*}=0$ ，由公式19可以得到 $\xi=-Z_{i}^{(t)}/\lambda_{1}<-1$ , 不符合符合公式18 。
如果 $w_{i}^{*}>0$ ，有公式18得到 $\xi=1$ ，那么 $Z_{i}^{(t)} + \lambda_{1}+(\lambda_{2}+\sum_{s=1}^{t}\sigma^{(s)})w_{i}$ ，所以有： $w_{i}^{*}=-(\lambda_{2}+\sum_{s=1}^{t}\sigma^{(s)})^{-1}*(Z_{i}^{(t)} + \lambda_{1})$
如果 $w_{i}^{*}<0$ ，有公式18得到$\xi=-1$ $\xi=-1$ ，那么 $Z_{i}^{(t)} - \lambda_{1}+(\lambda_{2}+\sum_{s=1}^{t}\sigma^{(s)})w_{i}<Z_{i}^{(t)} - \lambda_{1}<-2\lambda_{1}<0$ ， 不满足公式19.

综合上面的分析，可以得到FTRL特征权重各个维度更新的公式为：

$w_{i}^{(t+1)} = \left\{ \begin{array}{ftrl} &0 &if&|z_{i}^{(t)}|<\lambda_{1} \\ &-(\lambda_{2}+\sum_{s=1}^{t}\sigma{(s)})(z_{i}^{(t)}-\lambda_{1}*sign(z_{i}^{(t)}))&otherwise\\ \end{array}\tag{20} \right.$

per-coordinate learning rates

在FTRL中，每个维度的学习率都是单独考虑的。标准的OGD理论对每一个样本都是使用的相同的学习率: $\eta_{t}=\frac{1}{\sqrt{t}}$ 。

一个简单的思维推理就能证明这种情况并不一定是最理想的：假如我们每一轮扔十个硬币，然后使用LR去预估i个硬币正面朝上的概率： $P(heads|coin_{i})$ 。假设使用相同的学习率 $\eta_{t}=\frac{1}{\sqrt{n_{t,i}}}$ ，其中 $n_{t,i}$ 是 $coin_{i}$ 正面朝上的次数。如果 $coin_{i}$ 比 $coin_{j}$ 正面的次数更多，那么 $coin_{i}$ 的学习率应该比 $coin_{j}$ 下降的更快，表现为 $coin_{i}$ 具有更多的数据。 $coin_{j}$ 的学习率保持的比较高，意味着对 $coin_{j}$ 的新数据更敏感。

从另一个方面说，如果 $coin_{i}$ 从没有投出正面，但是我们依旧在调低 $coin_{i}$ 的学习率，这明显是不合理的。

因此，至少对于某些问题而言， 使用per-coordinate learning rates是有好处的 。谷歌使用以下的公式计算per-coordinate learning rates：

$\eta_{t,i}=\frac{\alpha}{\beta+\sqrt{\sum_{s=1}^{t}(g_{i}^{(s)})^{2}}}\tag{21}$

其中 $g_{i}^{(s)}$ 是第s个样本计算的梯度向量 $g^{s}$ 中 $i^{th}$ coordinate gradient。

谷歌经验表面， $\alpha$ 通常是要调节的， $\beta$ 取1就好，且在使用了per-coordinate learning rates之后，AUCLoss下降了11.2%，对于谷歌的广告系统而言，1%的AUCLoss降低就被认为是很好的优化了。

工程实现思路

工程化实现伪代码

谷歌给出了FTRL的工程化算法伪码，其中 $\sigma^{(1:t)}=\sum_{s=1}^{t}\sigma{(s)}=\frac{1}{\eta_{i}^{(t)}}=\frac{\beta+\sqrt{\sum_{s=1}^{t}(g_{i}^{(s)})^{2}}}{\alpha}$

$\begin{align*} \hline &\Large{\text{Algorithm1 Per-Cordinate FTRL-Proximal with $L_{1}$ and}}\\ &\Large{\text{$L_2$ Regularization for Logistic Regression}}\\ \hline &\large{\text{# With per-cordinate learning rates of Eq.(2)}}\\ &\large\bold{Input:}\text{parameters $\alpha$,$\beta$,$\lambda_{1}$,$\lambda_{2}$}\\ &\text{$\forall{i}\in\{1,.....,d\}$,initialize $z_{i}=0$ and $n_{i}=0$}\\ &\bold{for}\text{ t=1 $\bold{to}$ T } \bold{do}\\ &\space\space\space\space\text{Recieve feature vector $x_{t}$ and let $I=\{i|x_{i}\neq{0}\}$}\\ &\space\space\space\space\text{For $i\in{I}$ compute}\\ &\space\space\space\space\space\space\space\space{w_{t,i}=\left\{ \begin{array}{fm} &0 &\text{if $|z_{i}|$ < $\lambda_{1}$}\\ &-(\frac{\beta+\sqrt{n_{i}}}{\alpha}+\lambda_{2})^{-1}(z_{i}-sgn(z_{i})\lambda_{1}) &\text{otherwise.}\\ \end{array} \right.}\\ &\space\space\space\space\text{Predict $P_t = \sigma(x_{t}*w)$ using the $w_{t,i}$ compute above} \\ &\space\space\space\space\text{Observe label $y_{t}\in\{0,1\}$}\\ &\space\space\space\space\text{$\bold{for}$ all $i\in{I}$ do}\\ &\space\space\space\space\space\space\space\space\text{$g_{i}=(p_{t}-y_{t})x_{i}$ #gradient of loss w.r.t. $w_{i}$}\\ &\space\space\space\space\space\space\space\space\text{$\sigma_{i}=\frac{1}{\alpha}(\sqrt{n_{i}+g_{i}^2}-\sqrt{n_{i}})$ # equal $\frac{1}{\eta_{t,i}}-\frac{1}{\eta_{t-1,i}}$}\\ &\space\space\space\space\space\space\space\space\text{$z_{i}\leftarrow{z_{i}}+g_{i}-\sigma_{i}\omega_{t,i}$}\\ &\space\space\space\space\space\space\space\space\text{$n_{i}\leftarrow{n_{i}}+g_{i}^2$}\\ &\space\space\space\space\text{$\bold{end\space{for}}$}\\ &\text{$\bold{end\space{for}}$}\\ \hline \end{align*}$

其它谷歌实现的FTRL工程化技巧

Per-coordinate learning rate
原理如前面所述，从统计学上讲就是有效数据越多，数据可信度越高，学习率就越低，优化效果明显。
probabilistic feature inclusion
每一个特征根据泊松分布，以一定的概率p被保存，。
使用布隆过滤器，当特征数出现次数大于一个阈值的时候保存。
Encoding Values with Fewer Bits：减少存储weight参数占用的内存。
训练数据子采样
正样本正常采样。
负样本按照r比例采样，在训练的时候对每一个样本乘以$\frac{1}{r}$的权重弥补负样本的损失。

LR+FTRL工程化实现

根据前面的学习，可以使用LR作为基本学习器，使用FTRL作为在线最优化的方法来获取LR的权重系数，从而达到在不损失精度的前提下获得稀疏解的目标。

工程化实现的几个核心点是：

梯度计算代码
损失函数计算代码
权重更新计算代码

算法代码实现如下所示，这里只给出了核心部分代码，主要做了以下优化:

修复原代码更新梯度时候的逻辑错误。
支持pypy3加速，5.6G的训练数据，使用Mac单机可以9分钟跑完一个模型，一个epoch之后的logloss结果为0.3916；这对于刷竞赛或者实际工程中模型训练已经是比较理想的性能了。
使用16位浮点数保存权重数据，降低模型文件大小。
使用json保存模型非0参数w,z,n，进一步压缩线上使用的时候占据的内存空间，可以进一步考虑压缩模型文件大小，比如使用bson编码+gzip压缩后保存等。

from datetime import datetime
from csv import DictReader
from math import exp, log, sqrt
import gzip
import random
import json
import argparse

class FTRLProximal(object):
"""
FTRL Proximal engineer project with logistic regression
Reference:
https://static.googleusercontent.com/media/research.google.com/zh-CN//pubs/archive/41159.pdf

"""

def __init__(self, alpha, beta, L1, L2, D,
interaction=False, dropout=1.0,
dayfeature=True,
device_counters=False):

### parameters
self.alpha = alpha
self.beta = beta
self.L1 = L1
self.L2 = L2
self.dayfeature = dayfeature
self.device_counters = device_counters

### feature related parameters
self.D = D
self.interaction = interaction
self.dropout = dropout

### model
self.n = [0.] * D
self.z = [0.] * D
self.w = [0.] * D

def _indices(self, x):
'''
A helper generator that yields the indices in x
The purpose of this generator is to make the following
code a bit cleaner when doing feature interaction.
'''

for i in x:
yield i

if self.interaction:
D = self.D
L = len(x)
for i in range(1, L):  # skip bias term, so we start at 1
for j in range(i + 1, L):
### one-hot encode interactions with hash trick
yield abs(hash(str(x[i]) + '_' + str(x[j]))) % D

def predict(self, x, dropped=None):
"""
use x and computed weight to get predict
:param x:
:param dropped:
:return:
"""
### wTx is the inner product of w and x
wTx = 0.
for j, i in enumerate(self._indices(x)):

if dropped is not None and dropped[j]:
continue

wTx += self.w[i]

if dropped is not None:
wTx /= self.dropout

### bounded sigmoid function, this is the probability estimation
return 1. / (1. + exp(-max(min(wTx, 35.), -35.)))

def update(self, x, y):
"""
update weight and coordinate learning rate based on x and y
:param x:
:param y:
:return:
"""

ind = [i for i in self._indices(x)]

if self.dropout == 1:
dropped = None
else:
dropped = [random.random() > self.dropout for i in range(0, len(ind))]

p = self.predict(x, dropped)

### gradient under logloss
g = p - y

### update z and n
for j, i in enumerate(ind):

### implement dropout as overfitting prevention
if dropped is not None and dropped[j]:
continue

g_i = g * i
sigma = (sqrt(self.n[i] + g_i * g_i) - sqrt(self.n[i])) / self.alpha
self.z[i] += g_i - sigma * self.w[i]
self.n[i] += g_i * g_i

sign = -1. if self.z[i] < 0 else 1.  # get sign of z[i]

### build w on the fly using z and n, hence the name - lazy weights -
if sign * self.z[i] <= self.L1:
### w[i] vanishes due to L1 regularization
self.w[i] = 0.
else:
### apply prediction time L1, L2 regularization to z and get
self.w[i] = (sign * self.L1 - self.z[i]) \
/ ((self.beta + sqrt(self.n[i])) / self.alpha + self.L2)

def save_model(self, save_file):
"""
保存weight数据到本地
:param save_file:
:return:
"""
with open(save_file, "w") as f:
w = {k: v for k, v in enumerate(self.w) if v != 0}
z = {k: v for k, v in enumerate(self.z) if v != 0}
n = {k: v for k, v in enumerate(self.n) if v != 0}
data = {
'w': w,
'z': z,
'n': n
}
json.dump(data, f)

def load_weight(self, model_file, D):
"""
loada weight data
:param model_file:
:return:
"""
with open(model_file, "r") as f:
data = json.load(f)
self.w = data.get('w', [0.] * D)
self.z = data.get('z', [0.] * D)
self.n = data.get('n', [0.] * D)

@staticmethod
def loss(y, y_pred):
"""
log loss for LR model
:param y:
:param y_pred:
:return:
"""
p = max(min(y_pred, 1. - 10e-15), 10e-15)
return -log(p) if y == 1. else -log(1. - p)

def data(f_train, D, dayfilter=None, dayfeature=True, counters=False):
''' GENERATOR: Apply hash-trick to the original csv row
and for simplicity, we one-hot-encode everything

INPUT:
path: path to training or testing file
D: the max index that we can hash to

YIELDS:
ID: id of the instance, mainly useless
x: a list of hashed and one-hot-encoded 'indices'
we only need the index since all values are either 0 or 1
y: y = 1 if we have a click, else we have y = 0
'''

device_ip_counter = {}
device_id_counter = {}

for t, row in enumerate(DictReader(f_train)):
### process id
ID = row['id']
del row['id']

### process clicks
y = 0.
if 'click' in row:
if row['click'] == '1':
y = 1.
del row['click']

### turn hour really into hour, it was originally YYMMDDHH

date = row['hour'][0:6]
row['hour'] = row['hour'][6:]

if dayfilter != None and not date in dayfilter:
continue

if dayfeature:
### extract date
row['wd'] = str(int(date) % 7)
row['wd_hour'] = "%s_%s" % (row['wd'], row['hour'])

if counters:
d_ip = row['device_ip']
d_id = row["device_id"]
try:
device_ip_counter[d_ip] += 1
device_id_counter[d_id] += 1
except KeyError:
device_ip_counter[d_ip] = 1
device_id_counter[d_id] = 1
row["ipc"] = str(min(device_ip_counter[d_ip], 8))
row["idc"] = str(min(device_id_counter[d_id], 8))

### build x
x = [0]  # 0 is the index of the bias term
for key in row:
value = row[key]
### one-hot encode everything with hash trick
index = abs(hash(key + '_' + value)) % D
x.append(index)
yield t, ID, x, y

参考文献

Follow-the-Regularized-Leader and Mirror Descent:Equivalence Theorems and L1 Regularization(Google, FTRL原理论文)
Ad Click Prediction: a View from the Trenches(Google，FTRL工程化文档)
在线最优化求解(冯杨，讲在线最优化算法非常好的一篇文档)
统计学习方法(李航)
spark MLlib机器学习(黄美玲)
机器学习(周航)