基础概念
在tensorflow的官方文档是这样介绍Dataset数据对象的：
Dataset可以用来表示输入管道元素集合（张量的嵌套结构）和“逻辑计划“对这些元素的转换操作。在Dataset中元素可以是向量，元组或字典等形式。
另外，Dataset需要配合另外一个类Iterator进行使用，Iterator对象是一个迭代器，可以对Dataset中的元素进行迭代提取。
看个简单的示例：
#创建一个Dataset对象
dataset = tf.data.Dataset.from_tensor_slices([1,2,3,4,5,6,7,8,9])
#创建一个迭代器
iterator = dataset.make_one_shot_iterator()
#get_next()函数可以帮助我们从迭代器中获取元素
element = iterator.get_next()
#遍历迭代器，获取所有元素
with tf.Session() as sess:
for i in range(9):
print(sess.run(element))以上打印结果为：1 2 3 4 5 6 7 8 9
Dataset方法
1.from_tensor_slices
from_tensor_slices用于创建dataset,其元素是给定张量的切片的元素。
函数形式：from_tensor_slices（tensors）
参数tensors:张量的嵌套结构,每个都在第0维中具有相同的大小。
具体例子
#创建切片形式的dataset
dataset = tf.data.Dataset.from_tensor_slices([1,2,3,4,5,6,7,8,9])
#创建一个迭代器
iterator = dataset.make_one_shot_iterator()
#get_next()函数可以帮助我们从迭代器中获取元素
element = iterator.get_next()
#遍历迭代器，获取所有元素
with tf.Session() as sess:
for i in range(3):
print(sess.run(element))以上代码运行结果：1 2 3
2.from_tensors
创建一个Dataset包含给定张量的单个元素。
函数形式：from_tensors（tensors）
参数tensors:张量的嵌套结构。
具体例子
dataset = tf.data.Dataset.from_tensors([1,2,3,4,5,6,7,8,9])
iterator = concat_dataset.make_one_shot_iterator()
element = iterator.get_next()
with tf.Session() as sess:
for i in range(1):
print(sess.run(element))以上代码运行结果：[1,2,3,4,5,6,7,8,9]
即from_tensors是将tensors作为一个整体进行操纵，而from_tensor_slices可以操纵tensors里面的元素。
3.from_generator
创建Dataset由其生成元素的元素generator。
函数形式：from_generator(generator,output_types,output_shapes=None,args=None)
参数generator:一个可调用对象，它返回支持该iter()协议的对象 。如果args未指定，generator则不得参数; 否则它必须采取与有值一样多的参数args。
参数output_types：tf.DType对应于由元素生成的元素的每个组件的对象的嵌套结构generator。
参数output_shapes:tf.TensorShape 对应于由元素生成的元素的每个组件的对象 的嵌套结构generator
参数args:tf.Tensor将被计算并将generator作为NumPy数组参数传递的对象元组。
具体例子
#定义一个生成器
def data_generator():
dataset = np.array(range(9))
for i in dataset:
yield i
#接收生成器，并生产dataset数据结构
dataset = tf.data.Dataset.from_generator(data_generator, (tf.int32))
iterator = concat_dataset.make_one_shot_iterator()
element = iterator.get_next()
with tf.Session() as sess:
for i in range(3):
print(sess.run(element))以上代码运行结果：0 1 2
4.batch
batch可以将数据集的连续元素合成批次。
函数形式：batch(batch_size,drop_remainder=False)
参数batch_size:表示要在单个批次中合并的此数据集的连续元素个数。
参数drop_remainder：表示在少于batch_size元素的情况下是否应删除最后一批 ; 默认是不删除。
具体例子：
#创建一个Dataset对象
dataset = tf.data.Dataset.from_tensor_slices([1,2,3,4,5,6,7,8,9])
'''合成批次'''
dataset=dataset.batch(3)
#创建一个迭代器
iterator = dataset.make_one_shot_iterator()
#get_next()函数可以帮助我们从迭代器中获取元素
element = iterator.get_next()
#遍历迭代器，获取所有元素
with tf.Session() as sess:
for i in range(9):
print(sess.run(element))以上代码运行结果为：
[1 2 3]
[4 5 6]
[7 8 9]
即把目标对象合成3个批次，返回的对象是传入Dataset对象。
5.concatenate
concatenate可以将两个Dataset对象进行合并或连接.
函数形式：concatenate(dataset)
参数dataset:表示需要传入的dataset对象。
具体例子：
#创建dataset对象
dataset_a=tf.data.Dataset.from_tensor_slices([1,2,3])
dataset_b=tf.data.Dataset.from_tensor_slices([4,5,6])
#合并dataset
concat_dataset=dataset_a.concatenate(dataset_b)
iterator = concat_dataset.make_one_shot_iterator()
element = iterator.get_next()
with tf.Session() as sess:
for i in range(6):
print(sess.run(element))以上代码运行结果：1 2 3 4 5 6
6.filter
filter可以对传入的dataset数据进行条件过滤.
函数形式：filter(predicate)
参数predicate:条件过滤函数
具体例子
dataset = tf.data.Dataset.from_tensor_slices([1,2,3,4,5,6,7,8,9])
#对dataset内的数据进行条件过滤
dataset=dataset.filter(lambda x:x>3)
iterator = dataset.make_one_shot_iterator()
element = iterator.get_next()
with tf.Session() as sess:
for i in range(6):
print(sess.run(element))以上代码运行结果：4 5 6 7 8 9
7.map
map可以将map_func函数映射到数据集
函数形式：flat_map(map_func，num_parallel_calls=None)
参数map_func:映射函数
参数num_parallel_calls：表示要并行处理的数字元素。如果未指定，将按顺序处理元素。
具体例子
dataset = tf.data.Dataset.from_tensor_slices([1,2,3,4,5,6,7,8,9])
#进行map操作
dataset=dataset.map(lambda x:x+1)
iterator = dataset.make_one_shot_iterator()
element = iterator.get_next()
with tf.Session() as sess:
for i in range(6):
print(sess.run(element))以上代码运行结果：2 3 4 5 6 7
8.flat_map
flat_map可以将map_func函数映射到数据集（与map不同的是flat_map传入的数据必须是一个dataset）。
函数形式：flat_map(map_func)
参数map_func:映射函数
具体例子
dataset = tf.data.Dataset.from_tensor_slices([1,2,3,4,5,6,7,8,9])
#进行flat_map操作
dataset=dataset.flat_map(lambda x:tf.data.Dataset.from_tensor_slices(x+[1]))
iterator = dataset.make_one_shot_iterator()
element = iterator.get_next()
with tf.Session() as sess:
for i in range(6):
print(sess.run(element))以上代码运行结果：2 3 4 5 6 7
9.make_one_shot_iterator
创建Iterator用于枚举此数据集的元素。（可自动初始化）
函数形式：make_one_shot_iterator()
具体例子
dataset = tf.data.Dataset.from_tensor_slices([1,2,3,4,5,6,7,8,9])
iterator = dataset.make_one_shot_iterator()
element = iterator.get_next()
with tf.Session() as sess:
for i in range(6):
print(sess.run(element))10.make_initializable_iterator
创建Iterator用于枚举此数据集的元素。(使用此函数前需先进行迭代器的初始化操作)
函数形式：make_initializable_iterator(shared_name=None)
参数shared_name:(可选）如果非空，则返回的迭代器将在给定名称下共享同一设备的多个会话（例如，使用远程服务器时）
具体例子
dataset = tf.data.Dataset.from_tensor_slices([1,2,3,4,5,6,7,8,9])
iterator = dataset.make_initializable_iterator()
element = iterator.get_next()
with tf.Session() as sess:
#对迭代器进行初始化操作
sess.run(iterator.initializer)
for i in range(5):
print(sess.run(element))11.padded_batch
将数据集的连续元素组合到填充批次中,此转换将输入数据集的多个连续元素组合为单个元素。
函数形式：padded_batch(batch_size,padded_shapes,padding_values=None,drop_remainder=False)
参数batch_size：表示要在单个批次中合并的此数据集的连续元素数。
参数padded_shapes：嵌套结构tf.TensorShape或 tf.int64类似矢量张量的对象，表示在批处理之前应填充每个输入元素的相应组件的形状。任何未知的尺寸（例如，tf.Dimension(None)在一个tf.TensorShape或-1类似张量的物体中）将被填充到每个批次中该尺寸的最大尺寸。
参数padding_values:(可选）标量形状的嵌套结构 tf.Tensor，表示用于各个组件的填充值。默认值0用于数字类型，空字符串用于字符串类型。
参数drop_remainder:(可选）一个tf.bool标量tf.Tensor，表示在少于batch_size元素的情况下是否应删除最后一批 ; 默认行为是不删除较小的批处理。
具体例子
dataset = tf.data.Dataset.from_tensor_slices([1,2,3,4,5,6,7,8,9])
dataset=dataset.padded_batch(2,padded_shapes=[])
iterator = dataset.make_one_shot_iterator()
element = iterator.get_next()
with tf.Session() as sess:
for i in range(6):
print(sess.run(element))以上代码运行结果：
[1 2]
[3 4]
12.repeat
重复此数据集count次数
函数形式：repeat(count=None)
参数count:(可选）表示数据集应重复的次数。默认行为（如果count是None或-1）是无限期重复的数据集。
具体例子
dataset = tf.data.Dataset.from_tensor_slices([1,2,3,4,5,6,7,8,9])
#无限次重复dataset数据集
dataset=dataset.repeat()
iterator = dataset.make_one_shot_iterator()
element = iterator.get_next()
with tf.Session() as sess:
for i in range(30，35):
print(sess.run(element))以上代码运行结果： 1 2 3 4 5
13.shard
将Dataset分割成num_shards个子数据集。这个函数在分布式训练中非常有用，它允许每个设备读取唯一子集。
函数形式：shard( num_shards,index)
参数num_shards:表示并行运行的分片数。
参数index:表示工人索引。
14.shuffle
随机混洗数据集的元素。
函数形式：shuffle(buffer_size,seed=None,reshuffle_each_iteration=None)
参数buffer_size:表示新数据集将从中采样的数据集中的元素数。
参数seed:(可选）表示将用于创建分布的随机种子。
参数reshuffle_each_iteration:(可选）一个布尔值，如果为true，则表示每次迭代时都应对数据集进行伪随机重组。（默认为True。）
具体例子
dataset = tf.data.Dataset.from_tensor_slices([1,2,3,4,5,6,7,8,9])
#随机混洗数据
dataset=dataset.shuffle(3)
iterator = dataset.make_one_shot_iterator()
element = iterator.get_next()
with tf.Session() as sess:
for i in range(30，35):
print(sess.run(element))以上代码运行结果：3 2 4
15.skip
生成一个跳过count元素的数据集。
函数形式：skip(count)
参数count:表示应跳过以形成新数据集的此数据集的元素数。如果count大于此数据集的大小，则新数据集将不包含任何元素。如果count 为-1，则跳过整个数据集。
具体例子
dataset = tf.data.Dataset.from_tensor_slices([1,2,3,4,5,6,7,8,9])
#跳过前5个元素
dataset=dataset.skip(5)
iterator = dataset.make_one_shot_iterator()
element = iterator.get_next()
with tf.Session() as sess:
for i in range(30，35):
print(sess.run(element))以上代码运行结果： 6 7 8
16.take
提取前count个元素形成性数据集
函数形式：take(count)
参数count:表示应该用于形成新数据集的此数据集的元素数。如果count为-1，或者count大于此数据集的大小，则新数据集将包含此数据集的所有元素。
具体例子
dataset = tf.data.Dataset.from_tensor_slices([1,2,2,3,4,5,6,7,8,9])
#提取前5个元素形成新数据
dataset=dataset.take(5)
iterator = dataset.make_one_shot_iterator()
element = iterator.get_next()
with tf.Session() as sess:
for i in range(30，35):
print(sess.run(element))以上代码运行结果： 1 2 2
17.zip
将给定数据集压缩在一起
函数形式：zip（datasets）
参数datesets:数据集的嵌套结构。
具体例子
dataset_a=tf.data.Dataset.from_tensor_slices([1,2,3])
dataset_b=tf.data.Dataset.from_tensor_slices([2,6,8])
zip_dataset=tf.data.Dataset.zip((dataset_a,dataset_b))
iterator = dataset.make_one_shot_iterator()
element = iterator.get_next()
with tf.Session() as sess:
for i in range(30，35):
print(sess.run(element))以上代码运行结果：
(1, 2)
(2, 6)
(3, 8)
到这里Dataset中大部分方法 都在这里做了初步的解释，当然这些方法的配合使用才能够在建模过程中发挥大作用。
更多信息可查看tensorflow官方文档
https://www.tensorflow.org/api_docs/python/tf/data/Dataset