Note on Array Ordering

In versions prior to version 5.5, IDL was inconsistent in its handling of array ordering between IDL and C-language routines in the HDF-EOS library. Beginning with IDL 5.5, all data arrays (either input or output) use standard IDL array ordering. Dimension size vectors and dimension name lists are also now in IDL order rather than in C-language order.

Programs written using versions of the IDL HDF-EOS routines prior to IDL version 5.5 may have been created to intentionally compensate for the previous behavior. When used with IDL 5.5 and later versions of the IDL HDF-EOS routines, these programs may generate incorrect results.

Affected routines include:


EOS_SW_DEFDATAFIELD	EOS_GD_DEFFIELD
EOS_SW_DEFGEOFIELD	EOS_GD_DEFTILE
EOS_SW_EXTRACTPERIOD	EOS_GD_READFIELD
EOS_SW_EXTRACTREGION	EOS_GD_READTILE
EOS_SW_PERIODINFO	EOS_GD_REGIONINFO
EOS_SW_READFIELD	EOS_GD_TILEINFO
EOS_SW_REGIONINFO	EOS_GD_WRITEFIELD
EOS_SW_WRITEDATAMETA	EOS_GD_WRITEFIELDMETA
EOS_SW_WRITEFIELD	EOS_GD_WRITETILE
EOS_SW_WRITEGEOMETA

Note
For the EOS_GD_READFIELD, EOS_SW_READFIELD, EOS_GD_WRITEFIELD, and EOS_SW_WRITEFIELD routines, the START, STRIDE, and EDGE keywords should also be specified in the IDL dimension order.

Note
EOS_GD_INQDIMS and EOS_SW_INQDIMS return dimension size and name information without consideration of order.