If users keep data in tf$Example format, they need to call tf$parse_example
with a proper feature spec. There are two main things that this utility
helps:
Users need to combine parsing spec of features with labels and weights (if
any) since they are all parsed from same tf$Example instance. This utility
combines these specs.
It is difficult to map expected label by a regressor such as dnn_regressor
to corresponding tf$parse_example spec. This utility encodes it by getting
related information from users (key, dtype).
regressor_parse_example_spec(
feature_columns,
label_key,
label_dtype = tf$float32,
label_default = NULL,
label_dimension = 1L,
weight_column = NULL
)An iterable containing all feature columns. All items
should be instances of classes derived from _FeatureColumn.
A string identifying the label. It means tf$Example stores
labels with this key.
A tf$dtype identifies the type of labels. By default it
is tf$float32.
used as label if label_key does not exist in given
tf$Example. By default default_value is none, which means
tf$parse_example will error out if there is any missing label.
Number of regression targets per example. This is the
size of the last dimension of the labels and logits Tensor objects
(typically, these have shape [batch_size, label_dimension]).
A string or a _NumericColumn created by
column_numeric defining feature column representing
weights. It is used to down weight or boost examples during training. It
will be multiplied by the loss of the example. If it is a string, it is
used as a key to fetch weight tensor from the features. If it is a
_NumericColumn, raw tensor is fetched by key weight_column$key, then
weight_column$normalizer_fn is applied on it to get weight tensor.
A dict mapping each feature key to a FixedLenFeature or
VarLenFeature value.
ValueError: If label is used in feature_columns.
ValueError: If weight_column is used in feature_columns.
ValueError: If any of the given feature_columns is not a _FeatureColumn instance.
ValueError: If weight_column is not a _NumericColumn instance.
ValueError: if label_key is NULL.
Other parsing utilities:
classifier_parse_example_spec()