导入pyhdf时遇numpy.core.multiarray导入失败及版本兼容问题

问题描述 #

使用hdfeos提供的pyhdf代码读取HDF文件时，导入pyhdf.SD模块触发以下错误：

• RuntimeError：模块编译时依赖的numpy API版本为0x10，但当前numpy版本为0xf
• 后续引发ImportError：numpy.core.multiarray导入失败

已尝试升级numpy和pyhdf，但问题未解决。

解决方案 #

1. 安装与pyhdf兼容的numpy版本 #

pyhdf作为编译型扩展包，对numpy的API版本有严格依赖。错误中0x10对应numpy 1.24及以上版本，0xf对应numpy 1.23及以下版本。可尝试安装指定版本的numpy并重装pyhdf：

• 适配旧版numpy：

  pip install numpy==1.23.5
  pip install --force-reinstall pyhdf
  

• 适配新版numpy：

  pip install numpy==1.24.3
  pip install --force-reinstall pyhdf
  

2. 通过conda安装pyhdf #

conda生态下的pyhdf包会自动适配当前环境的依赖版本，避免API不兼容问题：

conda install -c conda-forge pyhdf

3. 从源码编译pyhdf #

如果预编译包无法适配当前环境，可手动编译源码以匹配本地numpy版本：

1. 卸载现有pyhdf：

   pip uninstall -y pyhdf
   

2. 安装编译依赖：

   pip install numpy cython
   

3. 下载pyhdf源码（从官方渠道获取），进入源码目录后执行：

   python setup.py install
   

4. 替代方案：使用其他库读取HDF文件 #

若pyhdf的兼容性问题无法解决，可尝试以下替代库：

• HDF5文件：使用h5py

  import h5py
  import numpy as np
  
  with h5py.File('你的HDF文件路径.hdf', 'r') as f:
      print("文件内数据集列表：", list(f.keys()))
      target_data = f['目标数据集名称'][:]
  

• HDF4文件：使用netCDF4

  from netCDF4 import Dataset
  
  ds = Dataset('你的HDF文件路径.hdf', 'r')
  print("文件内变量列表：", list(ds.variables.keys()))
  target_data = ds.variables['目标变量名称'][:]
  ds.close()
  

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