请教hdf5storage.write()与hdf5storage.writes()函数的具体区别

1. 写入模式：单次单数据 vs 批量多数据 #

• hdf5storage.write() 是单次写入单个数据的工具，每次调用只能把一个变量写入HDF5文件的指定路径。
  实际用法示例：

  import hdf5storage
  import numpy as np
  
  # 单个数组写入到文件的/my_dataset路径下
  single_data = np.arange(10)
  hdf5storage.write(single_data, path='/my_dataset', filename='example.h5')
  

• hdf5storage.writes() 是批量写入多组数据的工具，它接受一个字典作为输入——字典的键是HDF5文件内的路径，对应的值就是要写入的数据，一次调用就能完成多组数据的写入。
  示例：

  # 用字典打包多组数据和对应路径
  data_pack = {
      '/group1/arr1': np.array([1,2,3]),
      '/group2/arr2': np.array([4.5, 5.5, 6.5]),
      '/scalar_val': 100
  }
  # 一次性写入所有数据
  hdf5storage.writes(datadict=data_pack, filename='example.h5')
  

2. 参数核心差异 #

• write() 必须单独指定data（要写入的内容）和path（HDF5内的存储路径），再搭配文件参数（filename或已打开的file对象）。
• writes() 不需要单独传data和path，而是通过datadict这个字典参数统一管理所有要写入的内容和路径，再搭配文件参数即可。

3. 效率区别 #

当需要写入多组数据时，writes() 比多次调用write()更高效——它可以在一次文件会话中完成所有写入操作，减少了重复的文件I/O操作次数，避免不必要的性能开销。

内容的提问来源于stack exchange，提问作者Oguz Ery