ó \c@@s÷dZddlmZddlZddlZddlmZddlmZm Z ddl Z ddl m Z m Z ddlmZd d lmZmZmZmZmZmZd d lmZd d lmZejƒjZejdd !ZeZeejƒj kre!Zniej"d6ej#d6Z$e%d„e j&e$ƒDƒƒZ'd„Z(d„Z)id„d6d„d6d„d6d„d6e(d6e)d6Z*d„Z+d„Z,d„Z-d „Z.ed!„Z/ded"„Z1d#efd$„ƒYZ2dS(%s: Implements high-level support for HDF5 file objects. i(tabsolute_importN(twarni(tfilename_decodetfilename_encode(tphilt with_phil(tGroupi(th5th5fth5pth5ith5fdt_objects(tversion(tH5pyDeprecationWarningitearliesttlatestcc@s!|]\}}||fVqdS(N((t.0txty((s-lib/python2.7/site-packages/h5py/_hl/files.pys 'scK@s6ddl}|jd|jjƒƒ|j|dS(Nitinfo(tmpi4pyt setdefaulttMPItInfot set_fapl_mpio(tplisttkwargsR((s-lib/python2.7/site-packages/h5py/_hl/files.pyt_set_fapl_mpio*s cK@s |jtj|jdƒƒdS(Ntfileobj(tset_fileobj_driverR tfileobj_drivertget(RR((s-lib/python2.7/site-packages/h5py/_hl/files.pyt_set_fapl_fileobj0scK@s |j|S(N(t set_fapl_sec2(RR((s-lib/python2.7/site-packages/h5py/_hl/files.pyt5stsec2cK@s |j|S(N(tset_fapl_stdio(RR((s-lib/python2.7/site-packages/h5py/_hl/files.pyR#6ststdiocK@s |j|S(N(t set_fapl_core(RR((s-lib/python2.7/site-packages/h5py/_hl/files.pyR#7stcorecK@s|jd|jƒ|S(Nt memb_fapl(tset_fapl_familytcopy(RR((s-lib/python2.7/site-packages/h5py/_hl/files.pyR#8s  tfamilytmpioRcC@s|t| NoneType The function to set the fapl to use your custom driver. N(t_drivers(tnametset_fapl((s-lib/python2.7/site-packages/h5py/_hl/files.pytregister_driverAs cC@s t|=dS(snUnregister a custom driver. Parameters ---------- name : str The name of the driver. N(R.(R/((s-lib/python2.7/site-packages/h5py/_hl/files.pytunregister_driverNscC@s ttƒS(sFReturn a frozenset of the names of all of the registered drivers. (t frozensetR.(((s-lib/python2.7/site-packages/h5py/_hl/files.pytregistered_driversYsc K@s‡tjtjƒ}|d k rY|tkr@t|}tj}qld„|Dƒ\}}ntjtj}}|j||ƒt |j ƒƒ} |d k r§|| dhsiiitwindowstwin32s8'{key}' is an invalid keyword argument for this functiontkeysUnknown driver type "%s"N(R tcreatet FILE_ACCESStNoneR5Rt LIBVER_LATESTtLIBVER_EARLIESTtset_libver_boundstlistt get_cachet set_cachetsystplatformtformattnexttitert TypeErrorR.tKeyErrort ValueError( tdrivertlibvert rdcc_nslotst rdcc_nbytestrdcc_w0tkwdsRtlowthightcache_settingstmsgR0((s-lib/python2.7/site-packages/h5py/_hl/files.pyt make_fapl_s8           '   cC@sS|rItjtjƒ}|jtjtjBƒ|jtjtjBƒnd}|S(s& Set up a file creation property list N(R R9t FILE_CREATEtset_link_creation_ordertCRT_ORDER_TRACKEDtCRT_ORDER_INDEXEDtset_attr_creation_orderR;(t track_orderR((s-lib/python2.7/site-packages/h5py/_hl/files.pyt make_fcpl‰sc C@sÔ|d k rŽ|dkr'tdƒ‚nyt|ƒ}Wn#ttfk r\tdƒ‚nX|d kr~tjtjƒ}n|j|ƒn|dkrÚtj }|r¿t r¿|tj O}ntj ||d|ƒ}n|dkrtj |tj d|ƒ}ne|dkr4tj|tjd|d|ƒ}n5|d krdtj|tjd|d|ƒ}n|d krÇytj |tj d|ƒ}Wqitk rÃtj|tjd|d|ƒ}qiXn¢|d kr]ytj |tj d|ƒ}Wqitk rYytj |tj d|ƒ}WqZtk rUtj|tjd|d|ƒ}qZXqiXn td ƒ‚yP|d k r¸|jƒ}|jƒ|kr¸td ||jƒfƒ‚q¸nWn|jƒ‚nX|S(sR Get a new FileID by opening or creating a file. Also validates mode argument.trsr+s5User block may only be specified when creating a files"User block size must be an integertfaplsw-Rtfcpltwtas/Invalid mode; must be one of r, r+, w, w-, x, asGRequested userblock size (%d) does not match that of existing file (%d)N(R\sr+(sw-R(R;RItintRGR R9RUt set_userblockRt ACC_RDONLYt swmr_supportt ACC_SWMR_READtopentACC_RDWRtACC_EXCLt ACC_TRUNCtIOErrortget_create_plistt get_userblocktclose( R/tmodetuserblock_sizeR]R^tswmrtflagstfidt existing_fcpl((s-lib/python2.7/site-packages/h5py/_hl/files.pytmake_fid–sX        $ $  (   ,   & tFilec B@speZdZed„ƒZeed„ƒƒZeed„ƒƒZeed„ƒƒZeed„ƒƒZ eed„ƒƒZ eed„ƒƒZ e rÛe dkrÛeed „ƒƒZejed „ƒƒZner ed „ƒZejed„ƒƒZnddddeddddd„ Zd„Zd„Zed„ƒZed„ƒZed„ƒZRS(s& Represents an HDF5 file. cC@s2ddlm}t|j|dƒSWdQXdS(s$ Attributes attached to this object i(tattrst/N(tRvRtAttributeManager(tselfRv((s-lib/python2.7/site-packages/h5py/_hl/files.pyRvÙscC@sttj|jƒƒS(sFile name on disk(RRtget_nametid(Rz((s-lib/python2.7/site-packages/h5py/_hl/files.pytfilenameâscC@suidtj6dtj6dtj6dtj6dtj6dtj6dtj6dtj6}|j |j j ƒj ƒd ƒS( s,Low-level HDF5 file driver used to open fileR$R&R(R,R6R-tmpiposixRtunknown( R tSEC2tSTDIOtCOREtFAMILYtWINDOWStMPIOtMPIPOSIXRR R|tget_access_plistt get_driver(Rztdrivers((s-lib/python2.7/site-packages/h5py/_hl/files.pyRJès        cC@s*idtj6dtj6j|jjƒƒS(s Python mode used to open file R\sr+(RRcRgR R|t get_intent(Rz((s-lib/python2.7/site-packages/h5py/_hl/files.pyRnös cC@stdtƒ|jS(s"File ID (backwards compatibility) s2File.fid has been deprecated. Use File.id instead.(RRR|(Rz((s-lib/python2.7/site-packages/h5py/_hl/files.pyRrýscC@s)|jjƒjƒ}td„|DƒƒS(s/File format version bounds (2-tuple: low, high)cs@s|]}t|VqdS(N(t libver_dict_r(RR((s-lib/python2.7/site-packages/h5py/_hl/files.pys s(R|R‡tget_libver_boundsttuple(Rztbounds((s-lib/python2.7/site-packages/h5py/_hl/files.pyRKscC@s|jjƒ}|jƒS(s User block size (in bytes) (R|RkRl(RzR^((s-lib/python2.7/site-packages/h5py/_hl/files.pyRo siii cC@s |jjƒS(s( Set/get MPI-IO atomic mode (R|tget_mpi_atomicity(Rz((s-lib/python2.7/site-packages/h5py/_hl/files.pytatomicscC@s|jj|ƒdS(N(R|tset_mpi_atomicity(Rztvalue((s-lib/python2.7/site-packages/h5py/_hl/files.pyRscC@s|jS(s- Controls single-writer multiple-reader mode (t _swmr_mode(Rz((s-lib/python2.7/site-packages/h5py/_hl/files.pyt swmr_mode$scC@s/|r|jjƒt|_n tdƒ‚dS(Ns4It is not possible to forcibly switch SWMR mode off.(R|tstart_swmr_writetTrueR“RI(RzR’((s-lib/python2.7/site-packages/h5py/_hl/files.pyR”)s  c  K@sž|rt rtdƒ‚nt|tjƒrMttj|ƒ} WdQXn=t|dƒrÞt|dƒrÞ|dkr†tdƒ‚nd}| j d|ƒ|kr³tdƒ‚n| j d|ƒt |ƒj dd ƒ}n t|ƒ}| dkrtjƒj} ntJt||||| | } t|||| d td | ƒd |ƒ} WdQXtrŠt|_|rŠ|d krŠt|_qŠntj|| ƒdS(s= Create a new file object. See the h5py user guide for a detailed explanation of the options. name Name of the file on disk, or file-like object. Note: for files created with the 'core' driver, HDF5 still requires this be non-empty. mode r Readonly, file must exist r+ Read/write, file must exist w Create file, truncate if exists w- or x Create file, fail if exists a Read/write if exists, create otherwise (default) driver Name of the driver to use. Legal values are None (default, recommended), 'core', 'sec2', 'stdio', 'mpio'. libver Library version bounds. Currently only the strings 'earliest' and 'latest' are defined. userblock Desired size of user block. Only allowed when creating a new file (mode w, w- or x). swmr Open the file in SWMR read mode. Only used when mode = 'r'. rdcc_nbytes Total size of the raw data chunk cache in bytes. The default size is 1024**2 (1 MB) per dataset. rdcc_w0 The chunk preemption policy for all datasets. This must be between 0 and 1 inclusive and indicates the weighting according to which chunks which have been fully read or written are penalized when determining which chunks to flush from cache. A value of 0 means fully read or written chunks are treated no differently than other chunks (the preemption is strictly LRU) while a value of 1 means fully read or written chunks are always preempted before other chunks. If your application only reads or writes data once, this can be safely set to 1. Otherwise, this should be set lower depending on how often you re-read or re-write the same data. The default value is 0.75. rdcc_nslots The number of chunk slots in the raw data chunk cache for this file. Increasing this value reduces the number of cache collisions, but slightly increases the memory used. Due to the hashing strategy, this value should ideally be a prime number. As a rule of thumb, this value should be at least 10 times the number of chunks that can fit in rdcc_nbytes bytes. For maximum performance, this value should be set approximately 100 times that number of chunks. The default value is 521. track_order Track dataset/group/attribute creation order under root group if True. If None use global default h5.get_config().track_order. Additional keywords Passed on to the selected file driver. sEThe SWMR feature is not available in this version of the HDF5 libraryNtreadtseekRs;Driver must be 'fileobj' for file-like object if specified.sQInvalid value of 'fileobj' argument; must equal to file-like object if specified.tASCIItreplaceR^RZRpR\(NR(RdRIt isinstanceR tObjectIDRR t get_file_idthasattrR;R tupdatetreprtencodeRRt get_configRZRTRtR[tFalseR“R–Rt__init__(RzR/RnRJRKRoRpRLRMRNRZRORrR]((s-lib/python2.7/site-packages/h5py/_hl/files.pyR¤3s4=      cC@s2t&|jjr(tj|jtjƒ}tj|jtjƒ}g|D]*}tj|ƒj|jjkrK|^qK}g|D]*}tj|ƒj|jjkr‚|^q‚}x+|D]#}x|jrÛtj|ƒqÂWq¹Wx+|D]#}x|jr tj|ƒqðWqçW|jj ƒt j ƒnWdQXdS(s2 Close the file. All open objects become invalid N( RR|tvalidRt get_obj_idstOBJ_FILER Rtdec_refRmR tnonlocal_close(Rztid_listt file_listRtid_((s-lib/python2.7/site-packages/h5py/_hl/files.pyRm“s 77     cC@s!ttj|jƒWdQXdS(s5 Tell the HDF5 library to flush its buffers. N(RRtflushR|(Rz((s-lib/python2.7/site-packages/h5py/_hl/files.pyR­­scC@s|S(N((Rz((s-lib/python2.7/site-packages/h5py/_hl/files.pyt __enter__³scG@s|jr|jƒndS(N(R|Rm(Rztargs((s-lib/python2.7/site-packages/h5py/_hl/files.pyt__exit__·s cC@sx|jsd}nL|j}t|tƒr?|jddƒ}ndtjj|ƒ|jf}t j rt|j dƒS|S(Nututf8Ršu( R|R}R›tbytestdecodetostpathtbasenameRntsixtPY2R¡(RzR\R}((s-lib/python2.7/site-packages/h5py/_hl/files.pyt__repr__¼s      (iii N(t__name__t __module__t__doc__tpropertyRvRR}RJRnRrRKRotmpit hdf5_versionRtsetterRdR”R;R£R¤RmR­R®R°R¹(((s-lib/python2.7/site-packages/h5py/_hl/files.pyRuÓs@      ]  (3R¼t __future__RRBR´twarningsRtcompatRRR·tbaseRRtgroupRRxRRR R R R R t h5py_warningsRR¢R¾thdf5_version_tupleR¿R£Rdtswmr_min_hdf5_versionR–R=R<R5tdictt iteritemsR‹RR!R.R1R2R4RTR[R;RtRu(((s-lib/python2.7/site-packages/h5py/_hl/files.pyt sD   .          * =