Debian Codegraph @

Changes

raw
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