cdflib

CDF ライブラリの直接操作

説明

MATLAB^® は、CDF ライブラリのさまざまな関数に直接アクセスできます。これらの関数を使用すると、データの読み取りと書き込みや、変数、属性、およびエントリの作成を行ったり、CDF ライブラリの他の機能を利用したりすることができます。これらの関数を使用するには、CDF C インターフェイスに関する知識を必要とします。CDF に関するドキュメンテーションは、CDF Web サイトにあります。

MATLAB 関数は、CDF ライブラリの新しい標準インターフェイスの関数に対応しています。多くの場合、MATLAB 関数の構文は、対応する CDF ライブラリ関数の構文と同じです。これらの関数を使用するには、関数名の前にパッケージ名 cdflib を付けなければなりません。たとえば、CDF ライブラリ関数を使用して既存の CDF ファイルを開くには、次の構文を使用します。

cdfid = cdflib.open('example.cdf');

次の表に、MATLAB CDF ライブラリ パッケージのすべての関数をカテゴリ別にグループ分けしてリストします。

ライブラリ情報

cdflib.getConstantNames	Names of Common Data Format (CDF) library constants
cdflib.getConstantValue	Numeric value corresponding to Common Data Format (CDF) library constant
cdflib.getFileBackward	Return current backward compatibility mode setting
cdflib.getLibraryCopyright	Copyright notice of Common Data Format (CDF) library
cdflib.getLibraryVersion	Library version and release information
cdflib.getValidate	Library validation mode
cdflib.setFileBackward	Set backward compatibility mode
cdflib.setValidate	Specify library validation mode

ファイルの操作

cdflib.close	Close Common Data Format (CDF) file
cdflib.create	Create Common Data Format (CDF) file
cdflib.delete	Delete existing Common Data Format (CDF) file
cdflib.getCacheSize	Number of cache buffers used
cdflib.getChecksum	Checksum mode
cdflib.getCompression	Compression settings
cdflib.getCompressionCacheSize	Number of compression cache buffers
cdflib.getCopyright	Copyright notice in Common Data Format (CDF) file
cdflib.getFormat	Format of Common Data Format (CDF) file
cdflib.getMajority	Majority of variables
cdflib.getName	Name of Common Data Format (CDF) file
cdflib.getReadOnlyMode	Read-only mode
cdflib.getStageCacheSize	Number of cache buffers for staging
cdflib.getVersion	Common Data Format (CDF) library version and release information
cdflib.inquire	Basic characteristics of Common Data Format (CDF) file
cdflib.open	Open existing Common Data Format (CDF) file
cdflib.setCacheSize	Specify number of dotCDF cache buffers
cdflib.setChecksum	Specify checksum mode
cdflib.setCompression	Specify compression settings
cdflib.setCompressionCacheSize	Specify number of compression cache buffers
cdflib.setFormat	Specify format of Common Data Format (CDF) file
cdflib.setMajority	Specify majority of variables
cdflib.setReadOnlyMode	Specify read-only mode
cdflib.setStageCacheSize	Specify number of staging cache buffers for Common Data Format (CDF) file

変数

cdflib.closeVar	Close specified variable from multifile format Common Data Format (CDF) file
cdflib.createVar	Create new variable
cdflib.deleteVar	Delete variable
cdflib.deleteVarRecords	Delete range of records from variable
cdflib.getVarAllocRecords	Number of records allocated for variable
cdflib.getVarBlockingFactor	Blocking factor for variable
cdflib.getVarCacheSize	Number of multifile cache buffers
cdflib.getVarCompression	Information about compression used by variable
cdflib.getVarData	Single value from record in variable
cdflib.getVarMaxAllocRecNum	Maximum allocated record number for variable
cdflib.getVarMaxWrittenRecNum	Maximum written record number for variable
cdflib.getVarName	Variable name, given variable number
cdflib.getVarNum	Variable number, given variable name
cdflib.getVarNumRecsWritten	Number of records written to variable
cdflib.getVarPadValue	Pad value for variable
cdflib.getVarRecordData	Entire record for variable
cdflib.getVarReservePercent	Compression reserve percentage for variable
cdflib.getVarSparseRecords	Information about how variable handles sparse records
cdflib.getVarsMaxWrittenRecNum	Maximum written record number for CDF file
cdflib.hyperGetVarData	Read hyperslab of data from variable
cdflib.hyperPutVarData	Write hyperslab of data to variable
cdflib.inquireVar	Information about variable
cdflib.putVarData	Write single value to variable
cdflib.putVarRecordData	Write entire record to variable
cdflib.renameVar	Rename existing variable
cdflib.setVarAllocBlockRecords	Specify range of records to be allocated for variable
cdflib.setVarBlockingFactor	Specify blocking factor for variable
cdflib.setVarCacheSize	Specify number of multi-file cache buffers for variable
cdflib.setVarCompression	Specify compression settings used with variable
cdflib.setVarInitialRecs	Specify initial number of records written to variable
cdflib.setVarPadValue	Specify pad value used with variable
cdflib.setVarReservePercent	Specify reserve percentage for variable
cdflib.setVarSparseRecords	Specify how variable handles sparse records
cdflib.setVarsCacheSize	Specify number of cache buffers used for all variables

属性

cdflib.createAttr	Create attribute
cdflib.deleteAttr	Delete attribute
cdflib.deleteAttrEntry	Delete attribute entry
cdflib.deleteAttrgEntry	Delete entry in global attribute
cdflib.getAttrEntry	Value of entry in attribute with variable scope
cdflib.getAttrMaxEntry	Number of last entry for variable attribute
cdflib.getAttrMaxgEntry	Number of last entry for global attribute
cdflib.getAttrName	Name of attribute, given attribute number
cdflib.getAttrNum	Attribute number, given attribute name
cdflib.getAttrScope	Scope of attribute
cdflib.getAttrgEntry	Value of entry in global attribute
cdflib.getNumAttrEntries	Number of entries for attribute with variable scope
cdflib.getNumAttrgEntries	Number of entries for attribute with global scope
cdflib.getNumAttributes	Number of attributes with variable scope
cdflib.getNumgAttributes	Number of attributes with global scope
cdflib.inquireAttr	Information about attribute
cdflib.inquireAttrEntry	Information about entry in attribute with variable scope
cdflib.inquireAttrgEntry	Information about entry in attribute with global scope
cdflib.putAttrEntry	Write value to entry in attribute with variable scope
cdflib.putAttrgEntry	Write value to entry in attribute with global scope
cdflib.renameAttr	Rename existing attribute

ユーティリティ関数

cdflib.breakdownTT2000	Convert CDF_TIME_TT2000 timestamp to time components
cdflib.computeEpoch	Convert time value to CDF_EPOCH value
cdflib.computeEpoch16	Convert time value to CDF_EPOCH16 value
cdflib.computeTT2000	Convert time components to CDF_TIME_TT2000 timestamp
cdflib.epoch16Breakdown	Convert CDF_EPOCH16 value to time value
cdflib.epochBreakdown	Convert CDF_EPOCH value into time value

制限

• CDF ファイルは ASCII エンコード以外の入力をサポートしません。変数名、属性名、変数値および属性値は 7 ビット ASCII エンコードでなければなりません。ASCII エンコード以外の入力を書き込もうとすると、エラーまたはデータの文字化けが発生します。

参考

cdfread | cdfinfo

トピック

• 低水準関数による CDF ファイルのインポート
• CDF ファイルへのエクスポート