| 1 |
2.003 2025-01-06 |
| 2 |
- add licence information |
| 3 |
|
| 4 |
2.002 2024-12-09 |
| 5 |
- install pdldoc, add repo metadata |
| 6 |
|
| 7 |
2.001 2024-12-03 |
| 8 |
- split out from PDL 2.095 |
| 9 |
|
| 10 |
2.0 2006-03-27 |
| 11 |
|
| 12 |
- New version I've taken over from the previous authors. |
| 13 |
|
| 14 |
- There has been several minor fixes to the old version that I have fixed over the years, |
| 15 |
and I can't remember them all to document here. Any new functionality has been documented, |
| 16 |
however. |
| 17 |
|
| 18 |
- "Chunking" functionality added. This is an internal tiling and compression on the SD |
| 19 |
datasets done by the HDF library. This is on by default, and can be |
| 20 |
inquired/changed through ->Chunking() member function (pass it 0 for off, true for on). |
| 21 |
The actual chunking section automatically determines a tile size for the dataset, but |
| 22 |
this may not be optimal for some datasets. Down the road I'll provide better control of |
| 23 |
this feature. |
| 24 |
|
| 25 |
- I've defuncted several functions that had strange (perhaps French) spellings. The originals |
| 26 |
are still there for the time being, but a future version will come with warnings, and |
| 27 |
finally be removed from the library even further out. |
| 28 |
|
| 29 |
SDgetvariablename -> SDgetvariablenames |
| 30 |
SDgetattribut -> SDgetattribute |
| 31 |
SDgetattributname -> SDgetattributenames |
| 32 |
SDgetdimsizeunlimit -> SDgetunlimiteddimsize |
| 33 |
SDgetdimname -> SDgetdimnames |
| 34 |
Vgetchilds -> Vgetchildren |
| 35 |
VSgetfieldsnames -> VSgetfieldnames |
| 36 |
|
| 37 |
- Umm... I don't like fortran array dim order, so I use C order. This may be a concern for |
| 38 |
you, but I can't verify the problem for everyone since all of my code works fine. |
| 39 |
I generally save things as X, Y, Z in my code (think an image, for instance), and then |
| 40 |
when I open the HDF with image viewers, everything is fine. That's not how HDF saves |
| 41 |
the data, however, so there's a dim reverse in the code for SDget and SDput, but that |
| 42 |
should (theoretically) be transparent to you. NOTE: there is no reformatting of memory |
| 43 |
necessary (it's time consuming, and has been avoided), since the C style dim order |
| 44 |
is how a linear array maps into memory anyways (that's the main reason I like C style |
| 45 |
over fortran). |
| 46 |
If this causes _huge_ problems for you, then maybe I can make the ordering optional and |
| 47 |
you can have it your backwards way if you want :) |
| 48 |
|
| 49 |
- I migrated all of the failure codes to return 'undef' instead of the mix they were returning |
| 50 |
before. This should allow old code to be left alone. |
| 51 |
|
| 52 |
- I migrated all of the perl hashes to anonymous hashes. |
| 53 |
|
| 54 |
- I removed and internally doc'd several places where buffer overflows are possible, and did |
| 55 |
my best shot at making the buffer overflows impossible, using the new constants below. |
| 56 |
NOTE: this is not total elimination of the problem! Look for that in a later version with |
| 57 |
updates perlXS code on those function to use the C constants. |
| 58 |
The constants used in the code are cool with the HDF4.2r1 version, assuming you didn't |
| 59 |
change anything before you compiled the HDF library. The HDF people could theoretically |
| 60 |
change those values at a later point, so they should be read directly from the HDF system |
| 61 |
headers, rather than hard coded in this module. |
| 62 |
|
| 63 |
- I moved the constants over to 'use constant', so instead of using '$PDL::IO::HDF:DFACC_CREATE', |
| 64 |
you now would use : 'PDL::IO::HDF->DFACC_CREATE'. This is how constants work in Perl, so get |
| 65 |
over it and fix your old code that uses things the old way. |
| 66 |
|
| 67 |
- I added a couple of constants (all only usefull for allocating memory internally): |
| 68 |
MAX_NC_NAME => HDF's constant to hold the max name length for an attr/sds/dim |
| 69 |
MAX_VAR_DIMS => HDF's constant to hold the max number of dims for a HDF variable |
| 70 |
VNAMELENMAX => HDF's constant for the max length of VS interface names |
| 71 |
FAIL => HDF's constant failure return code |
| 72 |
|
| 73 |
- I moved all of the tests over to 'use Test', for easier clarity and to get them working again. I |
| 74 |
also modified the tests to clean up their test files when they are no longer needed (some tests |
| 75 |
use outputs from earlier tests). |
| 76 |
|
| 77 |
- I added tests for the SDS chunking features. |
| 78 |
|
| 79 |
0.01 13/02/01 |
| 80 |
- original version |