从 NetCDF 4.3.17 开始,在读取结构数组的成员时,实现Variable.read()
和差异很大,既不遵守 API 文档。Variable.read(Section)
下面我介绍一个解决方法。
为了说明,假设我有以下内容:
Structure {
int foo;
:_Unsigned = "true";
int bar;
:_Unsigned = "true";
} example(24);
这是一个以结构命名的 24 元素数组example
,每个结构包含两个成员,foo
并且bar
. 让我们假设我得到了对foo
成员的引用,如下所示:
final Variable fooVariable = netcdfFile.findVariable("/blah/example.foo");
如果我调用fooVariable.read()
,API 文档说我将取回第一个值,因为foo
它是数组中元素的结构的一部分。这不是发生的事情;相反,该库实际上做了一些巧妙的读取,并将foo
所有结构中的成员作为单个foo
值数组返回。这是我想要的行为。
不幸的是,该fooVariable.read(Section)
实现没有像那样聪明的代码fooVariable.read()
,而是编写为抛出一个UnsupportedOperationException
. (由于没有添加检查,代码甚至没有走那么远,抛出 anInvalidRangeException
因为它认为给定Section
的无效。这很遗憾,因为(一旦添加检查以避免)来自实现InvalidRangeException
的聪明代码在一行中仅插入一个方法参数Variable.read()
同样适用!Variable.read(Section)
使用Variable.read()
我的巧妙代码创建了一个解决此问题的方法,允许调用者请求包含任何变量的数组的一部分。如果变量是数组中结构的成员,则仅读取该成员的子范围,从而有效地创建具有与结构成员fooVariable.read(Section)
相同行为的方法的另一个版本:fooVariable.read()
/**
* Reads an array of data from the provided NetCDF variable. If the variable is a member of a structure, that member is read
* from all the structures in the array and returned as a single array containing that member from each structure.
* @param variable The NetCDF variable to read.
* @param section The section indicating the element of the array to read
* @param indexEnd The ending source index, exclusive, or -1 if all available values should be read.
* @return An array representing the requested range of values read for the given variable.
* @throws IOException if there is an error reading the data.
*/
public static Array readArray(final Variable variable, final Section section) throws IOException, InvalidRangeException {
if (variable.isMemberOfStructure()) { //if the variable is member of a structure
final Structure parentStructure = variable.getParentStructure().select(variable.getShortName()); //select just the member variable
final ArrayStructure arrayStructure = (ArrayStructure) parentStructure.read(section); //read the array of structures
return arrayStructure.extractMemberArray(arrayStructure.findMember(variable.getShortName())); //extract just the member into an array
} else { //if the variable is not a member of a structure
return variable.read(section); //just read the section directly from the variable
}
}
我通过Unidata NetCDF Support报告了这个问题(现在标识为 NRW-974703)。起初我被告知这些方法不适用于 HDF5,仅适用于 Unidata 自己的 NetCDF 文件格式。(这是完全不正确的。)然后我被告知我不了解 Java NetCDF API(尽管从上一个答案中我质疑谁完全缺乏对 Unidata 库的了解)。在追踪到具体问题代码并提供上述解决方法后,我尚未收到 Unidata 的回复。