CDF Perl Reference Manual Version 3.2, October 12, 2007 Space Physics Data Facility NASA / Goddard Space Flight Center Copyright © 2007 Space Physics Data Facility NASA/Goddard Space Flight Center Greenbelt, Maryland 20771 (U.S.A.) This software may be copied or redistributed as long as it is not sold for profit, but it can be incorporated into any other substantive product with or without modifications for profit or non-profit. If the software is modified, it must include the following notices: - The software is not the original (for protection of the original author’s reputations from any problems introduced by others) - Change history (e.g. date, functionality, etc.) This Copyright notice must be reproduced on each copy made. This software is provided as is without any express or implied warranties whatsoever. Internet - [email protected] Contents 1 Compiling............................................................................................................... 1 1.1 How to use the Perl-CDF package ....................................................................................................................1 2 Programming Interface ........................................................................................ 3 2.1 Item Referencing................................................................................................................................................3 2.2 Passing Arguments.............................................................................................................................................3 2.3 CDF Status Constants ........................................................................................................................................4 2.4 CDF Formats......................................................................................................................................................4 2.5 CDF Data Types.................................................................................................................................................4 2.6 Data Encodings ..................................................................................................................................................5 2.7 Data Decodings..................................................................................................................................................6 2.8 Variable Majorities ............................................................................................................................................7 2.9 Record/Dimension Variances.............................................................................................................................7 2.10 Compressions.....................................................................................................................................................8 2.11 Sparseness ..........................................................................................................................................................9 2.11.1 Sparse Records...........................................................................................................................................9 2.11.2 Sparse Arrays .............................................................................................................................................9 2.12 Attribute Scopes.................................................................................................................................................9 2.13 Read-Only Modes ..............................................................................................................................................9 2.14 zModes.............................................................................................................................................................10 2.15 -0.0 to 0.0 Modes .............................................................................................................................................10 2.16 Operational Limits ...........................................................................................................................................10 2.17 Limits of Names and Other Character Strings .................................................................................................10 2.18 Backward File Compatibility with CDF 2.7 ....................................................................................................11 2.19 Checksum.........................................................................................................................................................12 3 Standard Interface .............................................................................................. 15 3.1 CDFattrCreate ..................................................................................................................................................15 3.1.1 Example(s) ...............................................................................................................................................16 3.2 CDFattrEntryInquire ........................................................................................................................................16 3.2.1 Example(s) ...............................................................................................................................................17 3.3 CDFattrGet.......................................................................................................................................................18 3.3.1 Example(s) ...............................................................................................................................................18 3.4 CDFattrInquire.................................................................................................................................................19 3.4.1 Example(s) ...............................................................................................................................................20 3.5 CDFattrNum.....................................................................................................................................................20 3.5.1 Example(s) ...............................................................................................................................................21 3.6 CDFattrPut .......................................................................................................................................................21 3.6.1 Example(s) ...............................................................................................................................................22 3.7 CDFattrRename ...............................................................................................................................................23 3.7.1 Example(s) ...............................................................................................................................................23 3.8 CDFclose..........................................................................................................................................................23 3.8.1 Example(s) ...............................................................................................................................................24 3.9 CDFcreate ........................................................................................................................................................24 3.9.1 Example(s) ...............................................................................................................................................25 3.10 CDFdelete ........................................................................................................................................................26 3.10.1 Example(s) ...............................................................................................................................................26 3.11 CDFdoc............................................................................................................................................................26 3.11.1 Example(s) ...............................................................................................................................................27 3.12 CDFerror..........................................................................................................................................................27 3.12.1 Example(s) ...............................................................................................................................................28 3.13 CDFgetChecksum ............................................................................................................................................28 3.13.1 Example(s) ...............................................................................................................................................28 3.14 CDFinquire.......................................................................................................................................................29 3.14.1 Example(s) ...............................................................................................................................................30 3.15 CDFopen..........................................................................................................................................................30