σ ΎχXc@@sΒdZddlmZddlZddlZddlZddlmZmZm Z m Z m Z ddl m Z ddl mZdd lmZmZmZmZmZmZmZdd lmZmZd „Zd „Zd „Zd„ZeƒZeƒZd„Z de!fd„ƒYZ"de!fd„ƒYZ#de"fd„ƒYZ$de fd„ƒYZ%de fd„ƒYZ&defd„ƒYZ'de'efd„ƒYZ(de!fd„ƒYZ)dS( sJ Implements operations common to all high-level objects (File, etc.). i(tabsolute_importN(tMappingtMutableMappingtKeysViewt ValuesViewt ItemsViewi(tfspath(tfsencodei(th5dth5ith5rth5pth5fth5tth5s(tphilt with_philcC@sRtFtjjt|ƒƒ}tjj|ƒrDtjt|ƒƒSt SWdQXdS(s@ Determine if a file is valid HDF5 (False if it doesn't exist). N( RtostpathtabspathRtisfileR tis_hdf5RtFalse(tfname((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyR"s cC@s©tt|tjƒr,tjdtjƒSt|tjƒrQtjdtjƒSt|ƒtkrstjdtƒSt|ƒt j kr›tjdt j ƒSdSWdQXdS(s± Attempt to guess an appropriate dtype for the object, returning None if nothing is appropriate (or if it should be left up the the array constructor to figure out) treftvlenN( Rt isinstanceR tRegionReferenceR t special_dtypet Referencettypetbytestsixt text_typetNone(tdata((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt guess_dtype,scC@sEtjtjƒ}tjtjƒ}|jtjƒ|j|ƒ|S(s# Default link access property list (R tcreatet LINK_ACCESSt FILE_ACCESStset_fclose_degreeR t CLOSE_STRONGtset_elink_fapl(tlapltfapl((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt default_lapl>s  cC@s#tjtjƒ}|jtƒ|S(s% Default link creation property list (R R%t LINK_CREATEtset_create_intermediate_grouptTrue(tlcpl((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt default_lcplGs cC@s#|jƒjƒtjkrtStS(s) Check if an object's dataspace is empty (t get_spacetget_simple_extent_typeRtNULLR0R(tobj((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pytis_empty_dataspaceQstCommonStateObjectcB@sAeZdZed„ƒZed„ƒZdd„Zd„ZRS(s  Mixin class that allows sharing information between objects which reside in the same HDF5 file. Requires that the host class have a ".id" attribute which returns a low-level ObjectID subclass. Also implements Unicode operations. cC@stS(sI Fetch the link access property list appropriate for this object (tdlapl(tself((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt_laplbscC@stS(sK Fetch the link creation property list appropriate for this object (tdlcpl(R:((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt_lcplhsc@s¦‡fd†}|dkr)|r%dSdSt|tƒrDtj}nHy|jdƒ}tj}Wn)tk r‹|jdƒ}tj}nX|r’|||ƒfS|S(sG Encode a name according to the current file settings. Returns name, or 2-tuple (name, lcpl) if lcpl is True - Binary strings are always passed as-is, h5t.CSET_ASCII - Unicode strings are encoded utf8, h5t.CSET_UTF8 If name is None, returns either None or (None, None) appropriately. c@s ˆjjƒ}|j|ƒ|S(s3 Create an appropriate link creation property list (R=tcopytset_char_encoding(tcodingR1(R:(s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pytget_lcplxs tasciitutf8N(NN(R"RRR t CSET_ASCIItencodetUnicodeEncodeErrort CSET_UTF8(R:tnameR1RAR@((R:s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt_ens      cC@s9|dkrdSy|jdƒSWntk r4nX|S(s΄ Decode a name according to the current file settings. - Try to decode utf8 - Failing that, return the byte string If name is None, returns None. RCN(R"tdecodetUnicodeDecodeError(R:RH((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt_ds  N( t__name__t __module__t__doc__tpropertyR;R=R"RIRL(((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyR8Xs  !t _RegionProxycB@s8eZdZd„Zed„ƒZd„Zd„ZRS(s  Proxy object which handles region references. To create a new region reference (datasets only), use slicing syntax: >>> newref = obj.regionref[0:10:2] To determine the target dataset shape from an existing reference: >>> shape = obj.regionref.shape(existingref) where may be any object in the file. To determine the shape of the selection in use on the target dataset: >>> selection_shape = obj.regionref.selection(existingref) cC@s|j|_dS(N(tid(R:R6((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt__init__΄scC@stt|jtjƒs$tdƒ‚nddlm}|j|jj|d|jƒ}t j |jdt j |jƒS(Ns.Region references can only be made to datasetsi(t selectionstdsidt.( RRRRt DatasetIDt TypeErrortRTtselecttshapeR R%tDATASET_REGION(R:targsRTt selection((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt __getitem__·s !cC@s-t!tj||jƒ}|jSWdQXdS(s= Get the shape of the target dataspace referred to by *ref*. N(RR t get_regionRRR[(R:Rtsid((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyR[ΏscC@sCt7ddlm}tj||jƒ}|j|ƒSWdQXdS(sN Get the shape of the target dataspace selection referred to by *ref* i(RTN(RRYRTR R`RRt guess_shape(R:RRTRa((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyR^Εs(RMRNRORSRR_R[R^(((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyRQ‘s   tHLObjectcB@sμeZdZeed„ƒƒZeed„ƒƒZeed„ƒƒZeed„ƒƒZeed„ƒƒZ eed„ƒƒZ eed„ƒƒZ ed„ƒZ ed „ƒZ ed „ƒZed „ƒZd „ZeZRS( s: Base class for high-level interface objects. cC@s ddlm}|j|jƒS(s4 Return a File instance associated with this object i(tfiles(RYRdtFileRR(R:Rd((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pytfileΤscC@s|jtj|jƒƒS(s: Return the full name of this object. None if anonymous. (RLR tget_nameRR(R:((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyRHΫscC@s5|jdkrtdƒ‚n|jtj|jƒS(s­Return the parent group of this object. This is always equivalent to obj.file[posixpath.dirname(obj.name)]. ValueError if this object is anonymous. s*Parent of an anonymous object is undefinedN(RHR"t ValueErrorRft posixpathtdirname(R:((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pytparentαscC@s|jS(s2 Low-level identifier appropriate for this object (t_id(R:((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyRRνscC@stj|jdtjƒS(s+ An (opaque) HDF5 reference to this object RV(R R%RRtOBJECT(R:((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyRσscC@s t|ƒS(szCreate a region reference (Datasets only). The syntax is regionref[]. For example, dset.regionref[...] creates a region reference in which the whole dataset is selected. Can also be used to determine the shape of the referenced dataset (via .shape property), or the shape of the selection (via the .selection property). (RQ(R:((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt regionrefωs cC@sddlm}|j|ƒS(s$ Attributes attached to this object i(tattrs(RYRotAttributeManager(R:Ro((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyRoscC@s ||_dS(s3 Setup this object, given its low-level identifier N(Rl(R:toid((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyRSscC@s t|jƒS(N(thashRR(R:((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt__hash__scC@s#t|dƒr|j|jkStS(NRR(thasattrRRR(R:tother((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt__eq__scC@s|j|ƒ S(N(Rv(R:Ru((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt__ne__scC@stt|jƒSWdQXdS(N(RtboolRR(R:((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt__bool__!s(RMRNRORPRRfRHRkRRRRnRoRSRsRvRwRyt __nonzero__(((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyRcΞs*   tValuesViewHDF5cB@s eZdZd„Zd„ZRS(sΗ Wraps e.g. a Group or AttributeManager to provide a value view. Note that __contains__ will have poor performance as it has to scan all the links or attributes. cC@sEt9x-|jD]"}||jj|ƒkrtSqWtSWdQXdS(N(Rt_mappingtgetR0R(R:tvaluetkey((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt __contains__:s cc@s6t*x"|jD]}|jj|ƒVqWWdQXdS(N(RR|R}(R:R((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt__iter__As(RMRNROR€R(((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyR{1s t ItemsViewHDF5cB@s eZdZd„Zd„ZRS(sN Wraps e.g. a Group or AttributeManager to provide an items view. cC@sFt:|\}}||jkr8||jj|ƒkStSWdQXdS(N(RR|R}R(R:titemRtval((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyR€Ms  cc@s<t0x(|jD]}||jj|ƒfVqWWdQXdS(N(RR|R}(R:R((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyRTs(RMRNROR€R(((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyR‚Gs t MappingHDF5cB@sbeZdZejrEd„Zd„Zd„Zd„Zd„Z nd„Zd„Zd„ZRS( s  Wraps a Group, AttributeManager or DimensionManager object to provide an immutable mapping interface. We don't inherit directly from MutableMapping because certain subclasses, for example DimensionManager, are read-only. cC@stt|ƒSWdQXdS(s$ Get a list containing member names N(Rtlist(R:((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pytkeysdscC@s1t%g|D]}|j|ƒ^qSWdQXdS(s& Get a list containing member objects N(RR}(R:tx((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pytvaluesiscc@s#x|D]}|j|ƒVqWdS(s% Get an iterator over member objects N(R}(R:Rˆ((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt itervaluesns c C@s7t+g|D]}||j|ƒf^qSWdQXdS(s6 Get a list of tuples containing (name, object) pairs N(RR}(R:Rˆ((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pytitemssscc@s)x"|D]}||j|ƒfVqWdS(s+ Get an iterator over (name, object) pairs N(R}(R:Rˆ((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt iteritemsxs cC@s t|ƒS(s# Get a view object on member names (R(R:((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyR‡~scC@s t|ƒS(s% Get a view object on member objects (R{(R:((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyR‰‚scC@s t|ƒS(s# Get a view object on member items (R‚(R:((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyR‹†s( RMRNROR tPY2R‡R‰RŠR‹RŒ(((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyR…Zs        tMutableMappingHDF5cB@seZdZRS(s£ Wraps a Group or AttributeManager object to provide a mutable mapping interface, in contrast to the read-only mapping of MappingHDF5. (RMRNRO(((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyRŽ‹stEmptycB@s/eZdZdZd„Zd„Zd„ZRS(sΟ Proxy object to represent empty/null dataspaces (a.k.a H5S_NULL). This can have an associated dtype, but has no shape or data. This is not the same as an array with shape (0,). cC@s ||_dS(N(tdtype(R:R((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyRS scC@s)t|tƒr%|j|jkr%tStS(N(RRRR0R(R:Ru((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyRv£s!cC@sdj|jƒS(NsEmpty(dtype={0!r})(tformatR(R:((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt__repr__¨sN(RMRNROR"R[RSRvR’(((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyR–s   (*ROt __future__RRiRR t collectionsRRRRRtcompatRRRYRR R R R R Rt_objectsRRRR$R-R2R9R<R7tobjectR8RQRcR{R‚R…RŽR(((s+/tmp/pip-build-isqEY4/h5py/h5py/_hl/base.pyt s0   (4     I-c1