dataloader各项参数详解
在学习某一神经网络框架时，数据流总是能帮助大家更好地理解整个模型的运行逻辑/顺序，而其中Dataloader的作用在某些时候更是至关重要的。
笔者将自己的学习到的关于dataloader的创建，作用尽可能详细地记录下来以方便日后回顾，也欢迎各位匹配指正。
一句话概括
Dataloader本质是一个迭代器对象，也就是可以通过
for batch_idx,batch_dict in dataloader 来提取数据集，提取的数量由batch_size 参数决定,得到这一batch的数据后，就可以喂入网络开始训练或者推理了。
在迭代的过程中，dataloader会自动调用dataset中的__getitem__ 函数，以获取一帧数据(item)
dataloader的初始化
以openpcdet框架下的dataloader初始化为例:
#in pcdet/datasets/__init__.py dataloader = DataLoader( dataset, batch_size=batch_size, pin_memory=True, num_workers=workers, shuffle=(sampler is None) and training, collate_fn=dataset.collate_batch, #将一个list的sample组成一个mini-batch的函数 drop_last=False, sampler=sampler, timeout=0 )下面结合pytorch官方文档来详细解释每个参数的意义
1. dataset (Dataset) – dataset from which to load the data.
即自定义的数据集，非常重要，因为dataloader会调用dataset的一些重载函数(e.g. __getitem__ && __len__ )
2. batch_size (int, optional) – how many samples per batch to load(default: 1).
-
pin_memory(bool, optional) – If
True, the data loader will copy Tensors into device/CUDA pinned memory before returning them. If your data elementsare a custom type, or yourcollate_fnreturns a batch that is a custom type,see the example below.当设置为True时，将会在返回**
batch之前将batch**数据复制到固定的内存区域，这样在GPU训练过程中，数据从内存到GPU的复制可以使用异步的方式进行，从而提高数据读取的效率。通常情况下，当使用GPU训练模型时，数据读取会成为整个训练过程的瓶颈之一。使用**
pin_memory**可以将数据在CPU和GPU之间进行传输时的复制时间减少，从而提高数据加载的速度，加速训练过程。需要注意的是，使用**
pin_memory会占用更多的内存空间，因此在内存资源紧张的情况下，需要谨慎使用。同时，在某些情况下（例如数据集比较小的情况下），使用pin_memory**并不会带来明显的加速效果。 -
num_workers (int, optional) – how many subprocesses to use for dataloading.
0means that the data will be loaded in the main process.(default:0)这也是一个很有意思的参数，按照官方的说法，
num_workers用于设置数据加载过程中使用的子进程数。其默认值为**0**，即在主进程中进行数据加载，而不使用额外的子进程。
下面说一下个人的理解，在初始化dataloader对象时，会根据num_workers创建子线程用于加载数据(主线程数+子线程数=num_workers)。每个worker或者说线程都有自己负责的dataset范围（下面统称worker）
每当迭代dataloader对象时，工人们(workers)就开始干活了：将数据从数据源（如硬盘）加载到内存（数据加载），当一个worker读取(调用__getitem__)到足够的数据（看你在dataset中怎么定义一个item了）后，会将这些数据封装成一个 (即一帧),并将其放到该worker独有的内存队列中。
要注意的是，每次迭代时，worker会尽可能地读数据，直到自己的队列被填满。
当所有workers的队列都被填满时，一个名为sampler的线程将会被创建，它的作用就是收集各workers队列中队首的 ，把他们放到一个各线程共享内存的缓冲队列中，并调用collate_fn函数来将batch_size个 整合，最后返回给迭代的输出。
这时候大家肯定会有点疑惑，那当迭代到后期时，需要读取的样本都已经在队列中了,是不是意味着这时候工人们已经在休息了？根据chatgpt的回答：是的！下面以一张图来帮助大家理解
![关于num_worker的一些个人理解]()
-
collate_fn (Callable, optional) – merges a list of samples to form a mini-batch of Tensor(s). Used when using batched loading from a map-style dataset.
整合多个样本到一个batch时需要调用的函数，当__getitem__返回的不是tensor而是字典之类时，需要进行collate_fn的重载，同时可以进行数据的进一步处理以满足pytorch的输入要求
比如在openpcdet框架的poinpillar中，__getitem__返回的是一个包含标注信息、点云信息、图像信息等的data_dict字典，这时候就需要调用自定义的collate_fn来进行打包
在poinpillar中该函数为:
@staticmethod def collate_batch(batch_list, _unused=False): """ 由于训练集中不同的点云的gt框个数不同，需要重写collate_batch函数， 将不同item的boxes和labels等key放入list，返回batch_size的数据 """ # defaultdict创建一个带有默认返回值的字典，当key不存在时，返回默认值，list默认返回一个空 data_dict = defaultdict(list) # 把batch里面的每个sample按照key-value合并 for cur_sample in batch_list: for key, val in cur_sample.items(): data_dict[key].append(val) batch_size = len(batch_list) ret = {} # 将合并后的key内的value进行拼接，先获取最大值，构造空矩阵，不足的部分补0 # 因为pytorch要求输入数据维度一致 for key, val in data_dict.items(): try: # voxels: optional (num_voxels, max_points_per_voxel, 3 + C) # voxel_coords: optional (num_voxels, 3) # voxel_num_points: optional (num_voxels) if key in ['voxels', 'voxel_num_points']: ret[key] = np.concatenate(val, axis=0) elif key in ['points', 'voxel_coords']: coors = [] for i, coor in enumerate(val): #在每个坐标前面加上序号 e.g. shape (N, 4) -> (N, 5) [20, 30, 40, 0.4] -> [i, 20, 30, 40, 0.4] # 在scatter起到作用，因为这时候（生成伪图像）就是分batch操作了，需要根据batch_idx 即 下面函数的 # constant_values 来区分voxel属于哪一帧 coor_pad = np.pad(coor, ((0, 0), (1, 0)), mode='constant', constant_values=i) """((0,0),(1,0))在二维数组array第一维（此处便是行）前面填充0行，最后面填充0行；在二维数组array第二维（此处便是列）前面填充1列，最后面填充0列mode='constant'表示指定填充的参数constant_values=i 表示第一维填充i """ coors.append(coor_pad) ret[key] = np.concatenate(coors, axis=0) # （B, N, 5) -> (B*N, 5) elif key in ['gt_boxes']: # 获取一个batch中所有帧中3D box最大的数量 max_gt = max([len(x) for x in val]) # 构造空的box3d矩阵（B, N, 7） batch_gt_boxes3d = np.zeros((batch_size, max_gt, val[0].shape[-1]), dtype=np.float32) for k in range(batch_size): batch_gt_boxes3d[k, :val[k].__len__(), :] = val[k] ret[key] = batch_gt_boxes3d # gt_boxes2d同gt_boxes elif key in ['gt_boxes2d']: max_boxes = 0 max_boxes = max([len(x) for x in val]) batch_boxes2d = np.zeros((batch_size, max_boxes, val[0].shape[-1]), dtype=np.float32) for k in range(batch_size): if val[k].size > 0:batch_boxes2d[k, :val[k].__len__(), :] = val[k] ret[key] = batch_boxes2d elif key in ["images", "depth_maps"]: # Get largest image size (H, W) max_h = 0 max_w = 0 for image in val: max_h = max(max_h, image.shape[0]) max_w = max(max_w, image.shape[1]) # Change size of images images = [] for image in val: pad_h = common_utils.get_pad_params(desired_size=max_h, cur_size=image.shape[0]) pad_w = common_utils.get_pad_params(desired_size=max_w, cur_size=image.shape[1]) pad_width = (pad_h, pad_w) # Pad with nan, to be replaced later in the pipeline. pad_value = np.nan if key == "images":pad_width = (pad_h, pad_w, (0, 0)) elif key == "depth_maps":pad_width = (pad_h, pad_w) image_pad = np.pad(image, pad_width=pad_width, mode='constant', constant_values=pad_value) images.append(image_pad) ret[key] = np.stack(images, axis=0) else: ret[key] = np.stack(val, axis=0) except: print('Error in collate_batch: key=%s' % key) raise TypeError ret['batch_size'] = batch_size return ret-
sampler (Sampler or Iterable, optional) – defines the strategy to draw samples from the dataset. Can be any
Iterablewith__len__implemented. If specified,shufflemust not be specified.sampler的主要作用是控制样本的采样顺序，并提供样本的索引。在默认情况下，dataloader使用的是SequentialSampler，它按照数据集的顺序依次提取样本，但在某些情况下，我们可能需要自定义采样顺序。比如说想从队尾提取数据。
比如，当我们处理非常大的数据集时，为了提高训练效率，可能需要对数据进行分布式采样，这时候就需要使用DistributedSampler。DistributedSampler会将数据集划分成多个子集，每个子集分配给不同的进程进行采样。在这种情况下，如果使用默认的SequentialSampler，可能会导致各个进程采样到相同的数据，从而降低训练效率。
此外，还有一些自定义的sampler，比如随机采样器（RandomSampler）和加权采样器（WeightedRandomSampler），它们可以按照不同的采样策略对数据集进行采样，从而满足不同的训练需求。
因此，根据不同的训练需求，我们可能需要自定义sampler来控制数据的采样顺序。 -
待续
免责声明：
① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的，并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据，供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。
② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341
