d?$dZddlZddlZddlZddlZddlZddlZddlmZddl m Z ddl Z ddl ZddlmZddlmZddlmZdd lmZmZmZmZmZmZmZdd lmZdd lmZmZdd lm Z dd l!m"Z"m#Z#m$Z$m%Z%m&Z&ddl'm(Z(ddl)m*Z*m+Z+ddl,m-Z-m.Z.ddl,m/Z/m0Z0m1Z1ddl2m3Z3ddl4m5Z5ddl6m7Z7ddl8m9Z9ddl:m;Z;ddlZ>ddl?m@Z@ddlmAZAddlBmCZCmDZDddlEmFZFddlGmHZHmIZIdZJgZKGdd ZLeLZMddd!d"d#d$d%ZNgd%ZOd&ZPd'ZQd(ZReeQeRZSeSZTd)ZUeeTeUZVeSZWd*ZXeeWeXZYeYZZd+Z[eeZe[Z\e\Z]d,Z^ee]e^Z_d-Z`d@d/ZaejbZcedeeefecgd0dgd1Zhehd2krd3nd4ZidAd7ZjGd8d9ZkGd:d;elZmGd<d=ZnGd>d?ejoZoejpeMjqdS)BaJCreate PyTables files and the object tree. This module support importing generic HDF5 files, on top of which PyTables files are created, read or extended. If a file exists, an object tree mirroring their hierarchical structure is created in memory. File class offer methods to traverse the tree, as well as to create new nodes. N) defaultdict)Path) hdf5extension)utilsextension) parameters)ClosedFileError FileModeError NodeErrorNoSuchNodeError UndoRedoErrorClosedNodeErrorPerformanceWarning)get_class_by_name) join_path split_path)undoredo) IsDescriptionUInt8Col StringColdescr_from_dtypedtype_from_descr)Filters)NodeNotLoggedMixin)Group RootGroup)TransactionGroupG TransactionGMarkG)Leaf)Array)CArray)EArray)VLArray)Table) linkextension)detect_number_of_cores)lrucacheextension) flavor_ofarray_as_internal)Atom)SoftLink ExternalLinkz2.1cdeZdZdZedZedZdZdZdZ dZ dZ d Z d S) _FileRegistryc^tt|_t|_dSN)rset _name_mapping _handlersselfs +lib/python3.11/site-packages/tables/file.py__init__z_FileRegistry.__init__Ks!(--c*t|jSr2)listr4r6s r8 filenamesz_FileRegistry.filenamesOsD&'''r:c|jSr2)r5r6s r8handlersz_FileRegistry.handlersSs ~r:c*t|jSr2)lenr5r6s r8__len__z_FileRegistry.__len__Xs4>"""r:c||jvSr2)r=r7filenames r8 __contains__z_FileRegistry.__contains__[s4>))r:c|j|j||j|dSr2)r4rEaddr5)r7handlers r8rHz_FileRegistry.add^s= 7+,00999 7#####r:c|j}|j|||j|s|j|=|j|dSr2)rEr4remover5)r7rIrEs r8rKz_FileRegistry.removebs]# 8$++G444!(+ -"8, g&&&&&r:c|j|Sr2)r4rDs r8get_handlers_by_namez"_FileRegistry.get_handlers_by_namejs!(++r:ct|jdk}|rtjdt |j}|D]\}tjd|jz|tjd]|r!tjddSdS)NrzClosing remaining open files:z%s...done )rAr5sysstderrwriter<rEclose)r7are_open_filesr?filehs r8 close_allz_FileRegistry.close_allnsT^,,q0  > J  < = = ='' % %E J  Wu~5 6 6 6 KKMMM J  V $ $ $ $  # J  T " " " " " # #r:N) __name__ __module__ __qualname__r9propertyr=r?rBrFrHrKrMrWr:r8r0r0Js((X(X###***$$$''',,, # # # # #r:r0)MARKCREATEREMOVEMOVEADDATTRDELATTRz1.0/_p_transactions actionlogzt%dzm%dza%dcv|4t|ts!tdt|zdSdS)NzQfilter parameter has to be None or a Filter instance and the passed type is: '%s') isinstancer TypeErrortypefilterss r8 _checkfiltersrpsJ O w ( ( @W &'' ' OOOr:Fc t|d} |j|fd|i||dS#|wxYw)aiAn easy way of copying one PyTables file to another. This function allows you to copy an existing PyTables file named srcfilename to another file called dstfilename. The source file must exist and be readable. The destination file can be overwritten in place if existing by asserting the overwrite argument. This function is a shorthand for the :meth:`File.copy_file` method, which acts on an already opened file. kwargs takes keyword arguments used to customize the copying process. See the documentation of :meth:`File.copy_file` for a description of those arguments. rmode overwriteN) open_file copy_filerT) srcfilename dstfilenamerukwargssrcfilehs r8rwrwsi$3///H;FF)FvFFF s 9A-.)rstrictdefaultrrc tj|}tdkr9|tvr/t d|dt jdtdnvt|D][}|j}|dkr|dkrt d|z|dvr|dkrt d |z|d krt d |z\t|||||fi|S) a Open a PyTables (or generic HDF5) file and return a File object. Parameters ---------- filename : str The name of the file (supports environment variable expansion). It is suggested that file names have any of the .h5, .hdf or .hdf5 extensions, although this is not mandatory. mode : str The mode to open the file. It can be one of the following: * *'r'*: Read-only; no data can be modified. * *'w'*: Write; a new file is created (an existing file with the same name would be deleted). * *'a'*: Append; an existing file is opened for reading and writing, and if the file does not exist it is created. * *'r+'*: It is similar to 'a', but the file must already exist. title : str If the file is to be created, a TITLE string attribute will be set on the root group with the given value. Otherwise, the title will be read from disk, and this will not have any effect. root_uep : str The root User Entry Point. This is a group in the HDF5 hierarchy which will be taken as the starting point to create the object tree. It can be whatever existing group in the file, named by its HDF5 path. If it does not exist, an HDF5ExtError is issued. Use this if you do not want to build the *entire* object tree, but rather only a *subtree* of it. .. versionchanged:: 3.0 The *rootUEP* parameter has been renamed into *root_uep*. filters : Filters An instance of the Filters (see :ref:`FiltersClassDescr`) class that provides information about the desired I/O filters applicable to the leaves that hang directly from the *root group*, unless other filter properties are specified for these leaves. Besides, if you do not specify filter properties for child groups, they will inherit these ones, which will in turn propagate to child nodes. Notes ----- In addition, it recognizes the (lowercase) names of parameters present in :file:`tables/parameters.py` as additional keyword arguments. See :ref:`parameter_files` for a detailed info on the supported parameters. .. note:: If you need to deal with a large number of nodes in an efficient way, please see :ref:`LRUOptim` for more info and advices about the integrated node cache engine. rz The file 'z@' is already opened. Please close it before reopening. HDF5 v.z, FILE_OPEN_POLICY = ''rrzJThe file '%s' is already opened, but not in read-only mode (as requested).)ar+ziThe file '%s' is already opened, but in read-only mode. Please close it before reopening in append mode.wzQThe file '%s' is already opened. Please close it before reopening in write mode.) osfspath_FILE_OPEN_POLICY _open_files ValueErrorrget_hdf5_versionrMrtFile)rErttitleroot_ueprorz filehandleomodes r8rvrvsRzy""HH$$ { " "*HHn=????%%% '(( ( #&::8DD K KJOEs{{u|| <>FGHHH$$# 02:;<<<  ?AIJKKK $x C CF C CCr:cDeZdZdZdZdZdZeZefdZ dS)_NoCachecdSNrr\r6s r8rBz_NoCache.__len__1sqr:cdSNFr\)r7keys r8rFz_NoCache.__contains__4sur:c tgSr2)iterr6s r8__iter__z_NoCache.__iter__7s Bxxr:cdSr2r\)r7rvalues r8 __setitem__z_NoCache.__setitem__:s r:c6||jur|St|r2)_NoCache__markerKeyError)r7rds r8popz _NoCache.pop?s DM ! !Hsmmr:N) rXrYrZrBrFrrobjectrrr\r:r8rr0st   vxxH!r:rc(eZdZfdZfdZxZS) _DictCachec|dkrtd|z||_tdS)NrzInvalid number of slots: %d)rnslotssuperr9)r7r __class__s r8r9z_DictCache.__init__FsC A:::VCDD D  r:ct||jkr"tjd|jztt ||dS)Nzthe dictionary of node cache is exceeding the recommended maximum number (%d); be ready to see PyTables asking for *lots* of memory and possibly slow I/O.)rArwarningswarnrrr)r7rrrs r8rz_DictCache.__setitem__Lsb t99t{ " " M:K!#5  6 6 6 C'''''r:)rXrYrZr9r __classcell__rs@r8rrEsQ (((((((((r:rcreZdZdfd ZdZddZdZdZdZdd Z d Z e d Z ddZ dZxZS) NodeManager@Ncttj|_|dkrt j|}n%|dkrt}nt| }||_ ||_ dSr) rr9weakrefWeakValueDictionaryregistryr) NodeCacherrcache node_factory)r7rrrrs r8r9zNodeManager.__init__Xs 355 A::%/77EE q[[JJEEw''E )r:c||j}||jvrI|j|js|j|=||j|<dS|j||urtd|zdS||j|<dS)Nz6trying to register a node with an existing key: ``%s``) _v_pathnamer _v_isopen RuntimeError)r7noders r8 register_nodezNodeManager.register_nodejs ;"C $-  =%/ AM#&%) c"""s#4//"$: ,M(+++ , ,  ~  ')12333%%'''    r:cg}t|jD]O\}}|js||"d|vr)t |t r|P|D]W}||jvr2tj d|z|j |d|j |XdS)N/_i_zclosed node the cache: ``%s``) r<ritemsrappendrkr!flushrrrr)r7 closed_keyspathrs r8 flush_nodeszNodeManager.flush_nodess t}224455 ! !JD$> !""4((((t##dD))!JJLLL $ $Dtz!! =DEEE tT*** M  d # # # #  $ $r:c|D]x} ||}|jr|jr t|dr|n|~Y#t $rYewxYw#t $rYuwxYwdS)N _f_get_child)r _v__deletinghasattr_g_closerrr) nodepathsrrrs r8 _close_nodeszNodeManager._close_nodess!  H x))~):t^44(  &   D       s" A,:A A)(A), A98A9rgcdsdz|j}|j}fd|D}|||jfd|D}|||jfd|D}|||jfd|D}|||jdS)NrgcFg|]}|rd|v|Sr startswith.0rprefixs r8 z-NodeManager.close_subtree..B   v&& +1+=+= +=+=+=r:c>g|]}||Sr\rrs r8rz-NodeManager.close_subtree..s*CCC$4??6+B+BCCCCr:cFg|]}|rd|v|Srrrs r8rz-NodeManager.close_subtree..rr:c>g|]}||Sr\rrs r8rz-NodeManager.close_subtree..s*FFF$doof.E.EFFFFr:)endswithrrrr)r7rrrpathss ` r8 close_subtreezNodeManager.close_subtrees s## "c\F =    "    %+++DCCC%CCC %+++    %    %...GFFF(FFF %.....r:cP|j}|j}t|}|D]M}||}|jr/||jd|N|r6|\}}|jr||4dSdSr2)rrr<rrrrpopitem)r7rrkeysrrs r8shutdownzNodeManager.shutdowns= E{{  C99S>>D~  T-t444   ((**IC~       r:)rNr2)Trg)rXrYrZr9rrrrrrr staticmethodrrrrrs@r8rrWs))))))$ & & &    B%%% '''     8$$$$\<////:       r:rceZdZdZdZedZejdZejdZedZ e jdZ e jdZ dOd Z dZ dZ dZ dPdZ dQdZ dRdZ dSdZ dTdZ dUdZdVdZdVdZdVdZdZdWdZd ZdXd!Z dYd"Z dZd#ZdXd$Zd[d%Zd[d&Zd[d'Z d[d(Z! d\d)Z"dVd*Z#d[d+Z$d[d,Z%d-Z&d.Z'd]d/Z(d^d0Z)d1Z*d2Z+d3Z,d4Z-d5Z.d6Z/d7Z0d8Z1d9Z2e3d:;fd<Z4d=Z5d[d>Z6d?Z7d@Z8dAZ9dBZ:d[dCZ;d[dDZdGZ?dHZ@dIZAdJZBdKZCdLZDdMZEdNZFd S)_raOThe in-memory representation of a PyTables file. An instance of this class is returned when a PyTables file is opened with the :func:`tables.open_file` function. It offers methods to manipulate (create, rename, delete...) nodes and handle their attributes, as well as methods to traverse the object tree. The *user entry point* to the object tree attached to the HDF5 file is represented in the root_uep attribute. Other attributes are available. File objects support an *Undo/Redo mechanism* which can be enabled with the :meth:`File.enable_undo` method. Once the Undo/Redo mechanism is enabled, explicit *marks* (with an optional unique name) can be set on the state of the database using the :meth:`File.mark` method. There are two implicit marks which are always available: the initial mark (0) and the final mark (-1). Both the identifier of a mark and its name can be used in *undo* and *redo* operations. Hierarchy manipulation operations (node creation, movement and removal) and attribute handling operations (setting and deleting) made after a mark can be undone by using the :meth:`File.undo` method, which returns the database to the state of a past mark. If undo() is not followed by operations that modify the hierarchy or attributes, the :meth:`File.redo` method can be used to return the database to the state of a future mark. Else, future states of the database are forgotten. Note that data handling operations can not be undone nor redone by now. Also, hierarchy manipulation operations on nodes that do not support the Undo/Redo mechanism issue an UndoRedoWarning *before* changing the database. The Undo/Redo mechanism is persistent between sessions and can only be disabled by calling the :meth:`File.disable_undo` method. File objects can also act as context managers when using the with statement introduced in Python 2.5. When exiting a context, the file is automatically closed. Parameters ---------- filename : str The name of the file (supports environment variable expansion). It is suggested that file names have any of the .h5, .hdf or .hdf5 extensions, although this is not mandatory. mode : str The mode to open the file. It can be one of the following: * *'r'*: Read-only; no data can be modified. * *'w'*: Write; a new file is created (an existing file with the same name would be deleted). * *'a'*: Append; an existing file is opened for reading and writing, and if the file does not exist it is created. * *'r+'*: It is similar to 'a', but the file must already exist. title : str If the file is to be created, a TITLE string attribute will be set on the root group with the given value. Otherwise, the title will be read from disk, and this will not have any effect. root_uep : str The root User Entry Point. This is a group in the HDF5 hierarchy which will be taken as the starting point to create the object tree. It can be whatever existing group in the file, named by its HDF5 path. If it does not exist, an HDF5ExtError is issued. Use this if you do not want to build the *entire* object tree, but rather only a *subtree* of it. .. versionchanged:: 3.0 The *rootUEP* parameter has been renamed into *root_uep*. filters : Filters An instance of the Filters (see :ref:`FiltersClassDescr`) class that provides information about the desired I/O filters applicable to the leaves that hang directly from the *root group*, unless other filter properties are specified for these leaves. Besides, if you do not specify filter properties for child groups, they will inherit these ones, which will in turn propagate to child nodes. Notes ----- In addition, it recognizes the (lowercase) names of parameters present in :file:`tables/parameters.py` as additional keyword arguments. See :ref:`parameter_files` for a detailed info on the supported parameters. .. rubric:: File attributes .. attribute:: filename The name of the opened file. .. attribute:: format_version The PyTables version number of this file. .. attribute:: isopen True if the underlying file is open, false otherwise. .. attribute:: mode The mode in which the file was opened. .. attribute:: root The *root* of the object tree hierarchy (a Group instance). .. attribute:: root_uep The UEP (user entry point) group name in the file (see the :func:`open_file` function). .. versionchanged:: 3.0 The *rootUEP* attribute has been renamed into *root_uep*. )rr!LinkUnknownc|jjS)z(The title of the root group in the file.root_v_titler6s r8rz File.titlesy!!r:c||j_dSr2r)r7rs r8rz File.titles" r:c|j`dSr2rr6s r8rz File.titles I   r:c|jjS)zTDefault filter properties for the root group (see :ref:`FiltersClassDescr`).r _v_filtersr6s r8roz File.filterssy##r:c||j_dSr2r)r7ros r8roz File.filterss& r:c|j`dSr2rr6s r8roz File.filterss I r:rrrrgNc Ztj||_ ||_ |dvrt d|zdt jD}d|Drtj dtd|D}| ||dt|d<|dt|d<||_ |j||fi||j}|rt!|t"|_ |d } t%| |_d |_d |_ t,|d |_||||x|_} | |jj|j_|r(|d r | jdt"|s(|jdkrt@|vr|!tEj#|ddS)N)rrrrrzEinvalid mode string ``%s``. Allowed modes are: 'r', 'r+', 'a' and 'w'cli|]1\}}||d.||2S)_)isupperrrkvs r8 z!File.__init__..sN<<<41aYY[[<)*c):):.s% - - -! -A - - -r:z5The use of uppercase keyword parameters is deprecatedc>i|]\}}||Sr\)upperr s r8r z!File.__init__..s&:::41a!''))Q:::r:MAX_NUMEXPR_THREADSMAX_BLOSC_THREADSNODE_CACHE_SLOTS)rFrPYTABLES_SYS_ATTRSPYTABLES_FORMAT_VERSIONrr)$rrrErtrr__dict__rrrDeprecationWarningupdater(params_g_new_v_newrpformat_versionr _node_manager _undoEnabledisopenrrH _open_count_File__get_root_groupr_g_post_init_hook _g_load_childr_v_attrs _g__setattr_trans_group_path enable_undoneset_vml_num_threads) r7rErtrrrorzrnewnode_cache_slotsrs r8r9z File.__init__s (++ * 4 , , ,68<=>> ><<:#6#<#<#>#><<< . -v - - - < M'(: < < <;:6<<>>::: f ' ( 0,B,D,DF( ) % & .*@*B*BF& '   Hd--f---k  < ' " " ""0D  ; ""45(0@AAA"  C  005'JJJ DI    *.)*A'  ?*+ ? ))-~???  tyC'',=,E,E       v&;<=====r:cd||_|dvrd}||_|j}|snt j|jd|_|jsd|_d|_n9t|jts|j d|_t|||||S)a$Returns a Group instance which will act as the root group in the hierarchical tree. If file is opened in "r", "r+" or "a" mode, and the file already exists, this method dynamically builds a python object tree emulating the structure present on file. )NrrgrunknownFutf-8rr)ro) _get_file_id _v_objectidrrr read_f_attrr _isPTFilerkstrdecoder)r7rrror)s r8__get_root_groupzFile.__get_root_group#s ,,.. z ! !H  k J"0"< ";#=#=D & J&/#!& 3S99 J&*&9&@&@&I&I#xu#wOOOOr:cZ|r||S||S)zGet the given `path` or create it if `create` is true. If `create` is true, `path` *must* be a string path and not a node, otherwise a `TypeError`will be raised. ) _create_pathr)r7rcreates r8_get_or_create_pathzFile._get_or_create_pathGs2  '$$T** *==&& &r:c$t|dstd|dkr|jS|j|j}}|dddD]7} ||}n#t $r|||}YnwxYw|}8|S)z|Create the groups needed for the `path` to exist. The group associated with the given `path` is returned. splitz,when creating parents, parent must be a pathrgrN)rrlr create_groupr;rr )r7rparentr<pcompchilds r8r7zFile._create_pathTstW%% LJKK K 3;;9 #y$*; ZZ__QRR(  E 4++E22" 4 4 4$ VU33 4FF sA11B  B Fct|||}t|t|||d|S)azCreate a new group. Parameters ---------- where : str or Group The parent group from which the new group will hang. It can be a path string (for example '/level1/leaf5'), or a Group instance (see :ref:`GroupClassDescr`). name : str The name of the new group. title : str, optional A description for this node (it sets the TITLE HDF5 attribute on disk). filters : Filters An instance of the Filters class (see :ref:`FiltersClassDescr`) that provides information about the desired I/O filters applicable to the leaves that hang directly from this new group (unless other filter properties are specified for these leaves). Besides, if you do not specify filter properties for its child groups, they will inherit these ones. createparents : bool Whether to create the needed groups for the parent path to exist (not done by default). See Also -------- Group : for more information on groups Tr.)r9rpr)r7wherenamerro createparents parentnodes r8r<zFile.create_groupjsJ@--e]CC gZ dG=== =r:'Tc | ~t| tjstd| zt | j|j\} } |.t||j| jkrtd|| }||| }|tdt|t|||||||||  }| | | |S)acCreate a new table with the given name in where location. Parameters ---------- where : str or Group The parent group from which the new table will hang. It can be a path string (for example '/level1/leaf5'), or a Group instance (see :ref:`GroupClassDescr`). name : str The name of the new table. description : Description This is an object that describes the table, i.e. how many columns it has, their names, types, shapes, etc. It can be any of the following: * *A user-defined class*: This should inherit from the IsDescription class (see :ref:`IsDescriptionClassDescr`) where table fields are specified. * *A dictionary*: For example, when you do not know beforehand which structure your table will have). * *A Description instance*: You can use the description attribute of another table to create a new one with the same structure. * *A NumPy dtype*: A completely general structured NumPy dtype. * *A NumPy (structured) array instance*: The dtype of this structured array will be used as the description. Also, in case the array has actual data, it will be injected into the newly created table. .. versionchanged:: 3.0 The *description* parameter can be None (default) if *obj* is provided. In that case the structure of the table is deduced by *obj*. title : str A description for this node (it sets the TITLE HDF5 attribute on disk). filters : Filters An instance of the Filters class (see :ref:`FiltersClassDescr`) that provides information about the desired I/O filters to be applied during the life of this object. expectedrows : int A user estimate of the number of records that will be in the table. If not provided, the default value is EXPECTED_ROWS_TABLE (see :file:`tables/parameters.py`). If you plan to create a bigger table try providing a guess; this will optimize the HDF5 B-Tree creation and management process time and memory used. chunkshape The shape of the data chunk to be read or written in a single HDF5 I/O operation. Filters are applied to those chunks of data. The rank of the chunkshape for tables must be 1. If None, a sensible value is calculated based on the expectedrows parameter (which is recommended). byteorder : str The byteorder of data *on disk*, specified as 'little' or 'big'. If this is not specified, the byteorder is that of the platform, unless you passed an array as the description, in which case its byteorder will be used. createparents : bool Whether to create the needed groups for the parent path to exist (not done by default). obj : python object The recarray to be saved. Accepted types are NumPy record arrays. The *obj* parameter is optional and it can be provided in alternative to the *description* parameter. If both *obj* and *description* are provided they must be consistent with each other. .. versionadded:: 3.0 track_times Whether time data associated with the leaf are recorded (object access time, raw data modification time, metadata change time, object birth time); default True. Semantics of these times depend on their implementation in the HDF5 library: refer to documentation of the H5O_info_t data structure. As of HDF5 1.8.15, only ctime (metadata change time) is implemented. .. versionadded:: 3.4.3 See Also -------- Table : for more information on tables Nzinvalid obj parameter %r)ptparamszSthe desctiption parameter is not consistent with the data type of the obj parameterzinvalid table description: None) descriptionrro expectedrows chunkshape byteorder track_times) rknpndarrayrlrdtyperrr9rrpr&r)r7rArBrHrrorIrJrKrCobjrLdescrrrDptobjs r8 create_tablezFile.create_tables#z ?c2:.. B :S @AAA' DKHHHHE1'$[.2k;;;>AiHH!JKKK$# --e]CC  >?? ?gj$"-U%L!+y"- /// ? LL    r:c |\||tdtjd|j} tj||j| dt |z}n\t |} t|| } ||| jkrtd||j| jkrtd| ||} t| ||||| S) a Create a new array. Parameters ---------- where : str or Group The parent group from which the new array will hang. It can be a path string (for example '/level1/leaf5'), or a Group instance (see :ref:`GroupClassDescr`). name : str The name of the new array obj : python object The array or scalar to be saved. Accepted types are NumPy arrays and scalars, as well as native Python sequences and scalars, provided that values are regular (i.e. they are not like ``[[1,2],2]``) and homogeneous (i.e. all the elements are of the same type). Also, objects that have some of their dimensions equal to 0 are not supported (use an EArray node (see :ref:`EArrayClassDescr`) if you want to store an array with one of its dimensions equal to 0). .. versionchanged:: 3.0 The *Object parameter has been renamed into *obj*.* title : str A description for this node (it sets the TITLE HDF5 attribute on disk). byteorder : str The byteorder of the data *on disk*, specified as 'little' or 'big'. If this is not specified, the byteorder is that of the given object. createparents : bool, optional Whether to create the needed groups for the parent path to exist (not done by default). atom : Atom An Atom (see :ref:`AtomClassDescr`) instance representing the *type* and *shape* of the atomic objects to be saved. .. versionadded:: 3.0 shape : tuple of ints The shape of the stored array. .. versionadded:: 3.0 track_times Whether time data associated with the leaf are recorded (object access time, raw data modification time, metadata change time, object birth time); default True. Semantics of these times depend on their implementation in the HDF5 library: refer to documentation of the H5O_info_t data structure. As of HDF5 1.8.15, only ctime (metadata change time) is implemented. .. versionadded:: 3.4.3 See Also -------- Array : for more information on arrays create_table : for more information on the rest of parameters Nzjif the obj parameter is not specified (or None) then both the atom and shape parametes should be provided.r\)rOr)rObufferstrides*the shape parameter do not match obj.shapeLthe atom parameter is not consistent with the data type of the obj parameter)rPrrKrL) rlrMzerosrOrNrAr*r+shaper9r")r7rArBrPrrKrCatomr[rLdfltflavor_objrDs r8 create_arrayzFile.create_array sD ;|u}!@AAA x$*555jdj)-c%jj:::s^^F%S&11D Udj%8%8 LMMMDJ$*$<$<!EFFF--e]CC ZEY!,... .r:c | t| } t| | } ||| jkrtd| j}||j| jkrtd|t j| j}n||td||| } t|t| ||||||||  }| | |d<|S)a] Create a new chunked array. Parameters ---------- where : str or Group The parent group from which the new array will hang. It can be a path string (for example '/level1/leaf5'), or a Group instance (see :ref:`GroupClassDescr`). name : str The name of the new array atom : Atom An Atom (see :ref:`AtomClassDescr`) instance representing the *type* and *shape* of the atomic objects to be saved. .. versionchanged:: 3.0 The *atom* parameter can be None (default) if *obj* is provided. shape : tuple The shape of the new array. .. versionchanged:: 3.0 The *shape* parameter can be None (default) if *obj* is provided. title : str, optional A description for this node (it sets the TITLE HDF5 attribute on disk). filters : Filters, optional An instance of the Filters class (see :ref:`FiltersClassDescr`) that provides information about the desired I/O filters to be applied during the life of this object. chunkshape : tuple or number or None, optional The shape of the data chunk to be read or written in a single HDF5 I/O operation. Filters are applied to those chunks of data. The dimensionality of chunkshape must be the same as that of shape. If None, a sensible value is calculated (which is recommended). byteorder : str, optional The byteorder of the data *on disk*, specified as 'little' or 'big'. If this is not specified, the byteorder is that of the given object. createparents : bool, optional Whether to create the needed groups for the parent path to exist (not done by default). obj : python object The array or scalar to be saved. Accepted types are NumPy arrays and scalars, as well as native Python sequences and scalars, provided that values are regular (i.e. they are not like ``[[1,2],2]``) and homogeneous (i.e. all the elements are of the same type). Also, objects that have some of their dimensions equal to 0 are not supported. Please use an EArray node (see :ref:`EArrayClassDescr`) if you want to store an array with one of its dimensions equal to 0. The *obj* parameter is optional and it can be provided in alternative to the *atom* and *shape* parameters. If both *obj* and *atom* and/or *shape* are provided they must be consistent with each other. .. versionadded:: 3.0 track_times Whether time data associated with the leaf are recorded (object access time, raw data modification time, metadata change time, object birth time); default True. Semantics of these times depend on their implementation in the HDF5 library: refer to documentation of the H5O_info_t data structure. As of HDF5 1.8.15, only ctime (metadata change time) is implemented. .. versionadded:: 3.4.3 See Also -------- CArray : for more information on chunked arrays NrXzPthe 'atom' parameter is not consistent with the data type of the 'obj' parameterzIthe 'atom' and 'shape' parameters or the 'obj' parameter must be provided)r\r[rrorJrKrL.) r*r+r[rlrOr, from_dtyper9rpr#)r7rArBr\r[rrorJrKrCrPrLr^rDrRs r8 create_carrayzFile.create_carrayish ?s^^F#C00C Uci%7%7 LMMM DJ#)$;$;!GHHHsy11| '(((--e]CC gz4 UG", #.000 ?E#J r:c | t| } t| | } d| jddz}|||krtd|}||j| jkrtd|t j| j}||| }t|t||||||||| |  }| | | |S)aCreate a new enlargeable array. Parameters ---------- where : str or Group The parent group from which the new array will hang. It can be a path string (for example '/level1/leaf5'), or a Group instance (see :ref:`GroupClassDescr`). name : str The name of the new array atom : Atom An Atom (see :ref:`AtomClassDescr`) instance representing the *type* and *shape* of the atomic objects to be saved. .. versionchanged:: 3.0 The *atom* parameter can be None (default) if *obj* is provided. shape : tuple The shape of the new array. One (and only one) of the shape dimensions *must* be 0. The dimension being 0 means that the resulting EArray object can be extended along it. Multiple enlargeable dimensions are not supported right now. .. versionchanged:: 3.0 The *shape* parameter can be None (default) if *obj* is provided. title : str, optional A description for this node (it sets the TITLE HDF5 attribute on disk). expectedrows : int, optional A user estimate about the number of row elements that will be added to the growable dimension in the EArray node. If not provided, the default value is EXPECTED_ROWS_EARRAY (see tables/parameters.py). If you plan to create either a much smaller or a much bigger array try providing a guess; this will optimize the HDF5 B-Tree creation and management process time and the amount of memory used. chunkshape : tuple, numeric, or None, optional The shape of the data chunk to be read or written in a single HDF5 I/O operation. Filters are applied to those chunks of data. The dimensionality of chunkshape must be the same as that of shape (beware: no dimension should be 0 this time!). If None, a sensible value is calculated based on the expectedrows parameter (which is recommended). byteorder : str, optional The byteorder of the data *on disk*, specified as 'little' or 'big'. If this is not specified, the byteorder is that of the platform. createparents : bool, optional Whether to create the needed groups for the parent path to exist (not done by default). obj : python object The array or scalar to be saved. Accepted types are NumPy arrays and scalars, as well as native Python sequences and scalars, provided that values are regular (i.e. they are not like ``[[1,2],2]``) and homogeneous (i.e. all the elements are of the same type). The *obj* parameter is optional and it can be provided in alternative to the *atom* and *shape* parameters. If both *obj* and *atom* and/or *shape* are provided they must be consistent with each other. .. versionadded:: 3.0 track_times Whether time data associated with the leaf are recorded (object access time, raw data modification time, metadata change time, object birth time); default True. Semantics of these times depend on their implementation in the HDF5 library: refer to documentation of the H5O_info_t data structure. As of HDF5 1.8.15, only ctime (metadata change time) is implemented. .. versionadded:: 3.4.3 See Also -------- EArray : for more information on enlargeable arrays NrUrz5the shape parameter is not compatible with obj.shape.rY)r\r[rrorIrJrKrL) r*r+r[rlrOr,rbr9rpr$r)r7rArBr\r[rrorIrJrKrCrPrLr^ earray_shaperDrRs r8 create_earrayzFile.create_earraysl ?s^^F#C00C#)ABB-/L Ul%:%:!2333%DJ#)$;$;!EFFFsy11--e]CC gz4 U&\", #. 000 ? LL    r:c | \t| } t| | } ||j| jkrtd|t j| j}n|t d||| } t|t| ||||||||  }| | | |S)aCreate a new variable-length array. Parameters ---------- where : str or Group The parent group from which the new array will hang. It can be a path string (for example '/level1/leaf5'), or a Group instance (see :ref:`GroupClassDescr`). name : str The name of the new array atom : Atom An Atom (see :ref:`AtomClassDescr`) instance representing the *type* and *shape* of the atomic objects to be saved. .. versionchanged:: 3.0 The *atom* parameter can be None (default) if *obj* is provided. title : str, optional A description for this node (it sets the TITLE HDF5 attribute on disk). filters : Filters An instance of the Filters class (see :ref:`FiltersClassDescr`) that provides information about the desired I/O filters to be applied during the life of this object. expectedrows : int, optional A user estimate about the number of row elements that will be added to the growable dimension in the `VLArray` node. If not provided, the default value is ``EXPECTED_ROWS_VLARRAY`` (see ``tables/parameters.py``). If you plan to create either a much smaller or a much bigger `VLArray` try providing a guess; this will optimize the HDF5 B-Tree creation and management process time and the amount of memory used. .. versionadded:: 3.0 chunkshape : int or tuple of int, optional The shape of the data chunk to be read or written in a single HDF5 I/O operation. Filters are applied to those chunks of data. The dimensionality of chunkshape must be 1. If None, a sensible value is calculated (which is recommended). byteorder : str, optional The byteorder of the data *on disk*, specified as 'little' or 'big'. If this is not specified, the byteorder is that of the platform. createparents : bool, optional Whether to create the needed groups for the parent path to exist (not done by default). obj : python object The array or scalar to be saved. Accepted types are NumPy arrays and scalars, as well as native Python sequences and scalars, provided that values are regular (i.e. they are not like ``[[1,2],2]``) and homogeneous (i.e. all the elements are of the same type). The *obj* parameter is optional and it can be provided in alternative to the *atom* parameter. If both *obj* and *atom* and are provided they must be consistent with each other. .. versionadded:: 3.0 track_times Whether time data associated with the leaf are recorded (object access time, raw data modification time, metadata change time, object birth time); default True. Semantics of these times depend on their implementation in the HDF5 library: refer to documentation of the H5O_info_t data structure. As of HDF5 1.8.15, only ctime (metadata change time) is implemented. .. versionadded:: 3.4.3 See Also -------- VLArray : for more informationon variable-length arrays .. versionchanged:: 3.0 The *expectedsizeinMB* parameter has been replaced by *expectedrows*. NrYzatom parameter cannot be None)r\rrorIrJrKrL) r*r+rOrlr,rbrr9rpr%r)r7rArBr\rrorIrJrKrCrPrLr^rDrRs r8create_vlarrayzFile.create_vlarrayRsn ?s^^F#C00CDJ#)$;$;!EFFF|sy11 \<== =--e]CC g D!%1#-$/ 111 ? LL    r:c||}|||}tj|||||||S)aCreate a hard link. Create a hard link to a `target` node with the given `name` in `where` location. `target` can be a node object or a path string. If `createparents` is true, the intermediate groups required for reaching `where` are created (the default is not doing so). The returned node is a regular `Group` or `Leaf` instance. )rr9r'_g_create_hard_link_g_add_children_names)r7rArBtargetrC targetnoderDs r8create_hard_linkzFile.create_hard_linkse]]6** --e]CC )*dJGGG((***}}Z...r:ct|ts't|dr|j}nt d|||}t |||}||S)a Create a soft link (aka symbolic link) to a `target` node. Create a soft link (aka symbolic link) to a `target` nodewith the given `name` in `where` location. `target` can be a node object or a path string. If `createparents` is true, the intermediate groups required for reaching `where` are created. (the default is not doing so). The returned node is a SoftLink instance. See the SoftLink class (in :ref:`SoftLinkClassDescr`) for more information on soft links. r,`target` has to be a string or a node object)rkr3rrrr9r-rl)r7rArBrmrCrDslinks r8create_soft_linkzFile.create_soft_links &#&& Dv}-- D+ BDDD--e]CC T622((*** r:cdt|ts7t|dr|jjdz|jz}n7t d|ddkrt d|||}t|||}| |S)aCreate an external link. Create an external link to a *target* node with the given *name* in *where* location. *target* can be a node object in another file or a path string in the form 'file:/path/to/node'. If *createparents* is true, the intermediate groups required for reaching *where* are created (the default is not doing so). The returned node is an :class:`ExternalLink` instance. r:rqz:/z/`target` must expressed as 'file:/path/to/node') rkr3r_v_filerErrfindr9r.rl)r7rArBrmrCrDelinks r8create_external_linkzFile.create_external_links&#&& Cv}-- D0369KK BDDD [[  " $ $ACC C--e]CC Zv66((*** r:cr|dkr|jS|j|}| Jd|z|S)Nrgz!unable to instantiate node ``%s``)rrr)r7rrs r8 _get_nodezFile._get_nodesH s??9 !**844!Dx!O r:c |t|trJ||j}t ||pdpd}|j|}nt|ttj frP| dstd|}t ||pdpd}||}ntd||rKt|}t||s,|j}|jj} t#d|d|d| d|S) aGet the node under where with the given name. Parameters ---------- where : str or Node This can be a path string leading to a node or a Node instance (see :ref:`NodeClassDescr`). If no name is specified, that node is returned. .. note:: If where is a Node instance from a different file than the one on which this function is called, the returned node will also be from that other file. name : str, optional If a name is specified, this must be a string with the name of a node under where. In this case the where argument can only lead to a Group (see :ref:`GroupClassDescr`) instance (else a TypeError is raised). The node called name under the group where is returned. classname : str, optional If the classname argument is specified, it must be the name of a class derived from Node (e.g. Table). If the node is found but it is not an instance of that class, a NoSuchNodeError is also raised. If the node to be returned does not exist, a NoSuchNodeError is raised. Please note that hidden nodes are also considered. rrgz'``where`` must start with a slash ('/')z&``where`` must be a string or a node: zcould not find a ``z `` node at ``z``; instead, a ``z`` node has been found there) _check_openrkr _g_check_openrrrwr|r3rMstr_r NameErrorrlrrrXr ) r7rArB classnamebasepathrrclass_ npathname nclassnames r8rz File.get_nodest@  eT " " D    ! ! !(H 4:266=#H=**844DD RW~ . . D##C(( K IJJJH 4:266=#H>>(++DDBBBDD D  :&y11FdF++ : , !^4 &o!yy)))ZZZ9:::  r:cP||S)zmIs the node under `path` visible? If the node does not exist, a NoSuchNodeError is raised. )r _f_isvisibler7rs r8is_visible_nodezFile.is_visible_node\s"}}T""//111r:c`|||}|||dS)aChange the name of the node specified by where and name to newname. Parameters ---------- where, name These arguments work as in :meth:`File.get_node`, referencing the node to be acted upon. newname : str The new name to be assigned to the node (a string). overwrite : bool Whether to recursively remove a node with the same newname if it already exists (not done by default). rBN)r _f_rename)r7rAnewnamerBrurPs r8rzFile.rename_nodefs3 mmEm-- gy)))))r:cd|||}|||||dS)aMove the node specified by where and name to newparent/newname. Parameters ---------- where, name : path These arguments work as in :meth:`File.get_node`, referencing the node to be acted upon. newparent The destination group the node will be moved into (a path name or a Group instance). If it is not specified or None, the current parent group is chosen as the new parent. newname The new name to be assigned to the node in its destination (a string). If it is not specified or None, the current name is chosen as the new name. Notes ----- The other arguments work as in :meth:`Node._f_move`. rN)r_f_move)r7rA newparentrrBrurCrPs r8 move_nodezFile.move_nodeys74mmEm-- Iw =AAAAAr:c |||} | jdkrN|rL|sJ||} | j| jur|jj| f||d|| St d| j|||||fi|S)aCopy the node specified by where and name to newparent/newname. Parameters ---------- where : str These arguments work as in :meth:`File.get_node`, referencing the node to be acted upon. newparent : str or Group The destination group that the node will be copied into (a path name or a Group instance). If not specified or None, the current parent group is chosen as the new parent. newname : str The name to be assigned to the new copy in its destination (a string). If it is not specified or None, the current name is chosen as the new name. name : str These arguments work as in :meth:`File.get_node`, referencing the node to be acted upon. overwrite : bool, optional If True, the destination group will be overwritten if it already exists. Defaults to False. recursive : bool, optional If True, all descendant nodes of srcgroup are recursively copied. Defaults to False. createparents : bool, optional If True, any necessary parents of dstgroup will be created. Defaults to False. kwargs Additional keyword arguments can be used to customize the copying process. See the documentation of :meth:`Group._f_copy` for a description of those arguments. Returns ------- node : Node The newly created copy of the source node (i.e. the destination node). See :meth:`.Node._f_copy` for further details on the semantics of copying nodes. rr)ru recursivez/You cannot copy a root group over the same file)r_v_depthrwr_f_copy_childrenOSError_f_copy) r7rArrrBrurrCrzrPnpobjs r8 copy_nodezFile.copy_nodes`mmEm-- <1   7 MM),,E{%-//* *5JI5>JJBHJJJ EGGGs{9g$iJJBHJJ Jr:c^|||}||dS)aRemove the object node *name* under *where* location. Parameters ---------- where, name These arguments work as in :meth:`File.get_node`, referencing the node to be acted upon. recursive : bool If not supplied or false, the node will be removed only if it has no children; if it does, a NodeError will be raised. If supplied with a true value, the node and all its descendants will be completely removed. rN)r _f_remove)r7rArBrrPs r8 remove_nodezFile.remove_nodes1"mmEm-- i     r:cZ|||}||S)axGet a PyTables attribute from the given node. Parameters ---------- where, name These arguments work as in :meth:`File.get_node`, referencing the node to be acted upon. attrname The name of the attribute to retrieve. If the named attribute does not exist, an AttributeError is raised. r)r _f_getattrr7rAattrnamerBrPs r8 get_node_attrzFile.get_node_attrs+mmEm--~~h'''r:c`|||}|||dS)aCSet a PyTables attribute for the given node. Parameters ---------- where, name These arguments work as in :meth:`File.get_node`, referencing the node to be acted upon. attrname The name of the attribute to set. attrvalue The value of the attribute to set. Any kind of Python object (like strings, ints, floats, lists, tuples, dicts, small NumPy objects ...) can be stored as an attribute. However, if necessary, pickle is automatically used so as to serialize objects that you might want to save. See the :class:`AttributeSet` class for details. Notes ----- If the node already has a large number of attributes, a PerformanceWarning is issued. rN)r _f_setattr)r7rAr attrvaluerBrPs r8 set_node_attrzFile.set_node_attrs32mmEm-- x+++++r:c^|||}||dS)ayDelete a PyTables attribute from the given node. Parameters ---------- where, name These arguments work as in :meth:`File.get_node`, referencing the node to be acted upon. attrname The name of the attribute to delete. If the named attribute does not exist, an AttributeError is raised. rN)r _f_delattrrs r8 del_node_attrzFile.del_node_attrs1mmEm-- x     r:c|||}||}|j|dS)aCopy PyTables attributes from one node to another. Parameters ---------- where, name These arguments work as in :meth:`File.get_node`, referencing the node to be acted upon. dstnode The destination node where the attributes will be copied to. It can be a path string or a Node instance (see :ref:`NodeClassDescr`). rN)rr#r)r7rAdstnoderB srcobject dstobjects r8copy_node_attrszFile.copy_node_attrs&sGMM%dM33 MM'** ""9-----r:c |||}|||j||||fi|dS)amCopy the children of a group into another group. Parameters ---------- srcgroup : str The group to copy from. dstgroup : str The destination group. overwrite : bool, optional If True, the destination group will be overwritten if it already exists. Defaults to False. recursive : bool, optional If True, all descendant nodes of srcgroup are recursively copied. Defaults to False. createparents : bool, optional If True, any necessary parents of dstgroup will be created. Defaults to False. kwargs : dict Additional keyword arguments can be used to customize the copying process. See the documentation of :meth:`Group._f_copy_children` for a description of those arguments. N)r _check_groupr)r7srcgroupdstgrouprurrCrzs r8 copy_childrenzFile.copy_children8sg6==** (###!! iM E E=C E E E E Er:c |t|jt|krt d|dd}|t |jjdd}| dd}|d|j }t| r|st d|d t|fd ||d |} |r$|jj |j|jj|jfd di||dS#|wxYw) aCopy the contents of this file to dstfilename. Parameters ---------- dstfilename : str A path string indicating the name of the destination file. If it already exists, the copy will fail with an IOError, unless the overwrite argument is true. overwrite : bool, optional If true, the destination file will be overwritten if it already exists. In this case, the destination file must be closed, or errors will occur. Defaults to False. kwargs Additional keyword arguments discussed below. Notes ----- Additional keyword arguments may be passed to customize the copying process. For instance, title and filters may be changed, user attributes may be or may not be copied, data may be sub-sampled, stats may be collected, etc. Arguments unknown to nodes are simply ignored. Check the documentation for copying operations of nodes to see which options they support. In addition, it recognizes the names of parameters present in :file:`tables/parameters.py` as additional keyword arguments. See :ref:`parameter_files` for a detailed info on the supported parameters. Copying a file usually has the beneficial side effect of creating a more compact and cleaner version of the original file. z"You cannot copy a file over itselfroNFILTERS copyuserattrsTrzfile ``zA`` already exists; you may want to use the ``overwrite`` argumentr)rtrror)r~rrEresolverrgetattrrr#getris_filervrrrT)r7ryrurzrorrdstfilehs r8rwzFile.copy_fileYsH     & & ( (D,=,=,E,E,G,G G G>?? ?**Y-- ? di0)TBBG ?D99  7DJ//    $ $ & & y 2+222   K!KKCIKK  : "**8=999 'DI &x} O O O O O O NN     HNN    s AE//Fc||}||||S)zReturn a *list* with children nodes hanging from where. This is a list-returning version of :meth:`File.iter_nodes`. )rr _f_list_nodesr7rArgroups r8 list_nodeszFile.list_nodess= e$$ %   ""9---r:c||}||||S)aNIterate over children nodes hanging from where. Parameters ---------- where This argument works as in :meth:`File.get_node`, referencing the node to be acted upon. classname If the name of a class derived from Node (see :ref:`NodeClassDescr`) is supplied, only instances of that class (or subclasses of it) will be returned. Notes ----- The returned nodes are alphanumerically sorted by their name. This is an iterator version of :meth:`File.list_nodes`. )rr _f_iter_nodesrs r8 iter_nodeszFile.iter_nodess=( e$$ %   ""9---r:cT ||dS#t$rYdSwxYw)zIs there a node with that path? Returns True if the file has a node with the given path (a string), False otherwise. TF)rr rs r8rFzFile.__contains__sD  MM$   4   55 s  ''c,|dS)aRecursively iterate over the nodes in the tree. This is equivalent to calling :meth:`File.walk_nodes` with no arguments. Examples -------- :: # Recursively list all the nodes in the object tree. h5file = tables.open_file('vlarray1.h5') print("All nodes in the object tree:") for node in h5file: print(node) rg) walk_nodesr6s r8rz File.__iter__s&s###r:c#Kt|}|tur||Ed{VdS|turL||V||D]}||Ed{VdS||D]}|||Ed{VdS)aRecursively iterate over nodes hanging from where. Parameters ---------- where : str or Group, optional If supplied, the iteration starts from (and includes) this group. It can be a path string or a Group instance (see :ref:`GroupClassDescr`). classname If the name of a class derived from Node (see :ref:`GroupClassDescr`) is supplied, only instances of that class (or subclasses of it) will be returned. Notes ----- This version iterates over the leaves in the same group in order to avoid having a list referencing to them and thus, preventing the LRU cache to remove them after their use. Examples -------- :: # Recursively print all the nodes hanging from '/detector'. print("Nodes hanging from group '/detector':") for node in h5file.walk_nodes('/detector', classname='EArray'): print(node) N)rr walk_groupsrrr)r7rArrrs r8rzFile.walk_nodess @#9-- U??''.. . . . . . . . . . t^^--&& & & &))%00 2 2??51111111111 2 2))%00 = =??5)<<<<<<<<<< = =r:c~||}|||S)aRecursively iterate over groups (not leaves) hanging from where. The where group itself is listed first (preorder), then each of its child groups (following an alphanumerical order) is also traversed, following the same procedure. If where is not supplied, the root group is used. The where argument can be a path string or a Group instance (see :ref:`GroupClassDescr`). )rr_f_walk_groups)r7rArs r8rzFile.walk_groupss; e$$ %   ##%%%r:c2|jstddS)zeCheck the state of the file. If the file is closed, a `ClosedFileError` is raised. zthe file object is closedN)rr r6s r8r~zFile._check_open)s'{ ?!"=>> > ? ?r:c|jdvS)zIs this file writable?)rrrrsr6s r8 _iswritablezFile._iswritable3sy,,,r:cL|stddS)zpCheck whether the file is writable. If the file is not writable, a `FileModeError` is raised. zthe file is not writableN)rr r6s r8_check_writablezFile._check_writable8s1!! < :;; ; < $&& KId&6IIIJJ J K Kr:c8||jS)a"Is the Undo/Redo mechanism enabled? Returns True if the Undo/Redo mechanism has been enabled for this file, False otherwise. Please note that this mechanism is persistent, so a newly opened PyTables file may already have Undo/Redo support enabled. )r~rr6s r8is_undo_enabledzFile.is_undo_enabledGs   r:c2|jstddS)Nz(Undo/Redo feature is currently disabled!)rr r6s r8_check_undo_enabledzFile._check_undo_enabledTs)  L JKK K L Lr:ct|jtdd}|jdt |S)Nz!Transaction information containerTr) FORMATVERSION)rr_trans_group_namer#r$_trans_version)r7tgroups r8_create_transaction_groupzFile._create_transaction_groupXsB" I( /T;;; ##O^DDD r:c>t|t|zd|zdS)NzTransaction number %dTr)r _trans_name)r7troottids r8_create_transactionzFile._create_transaction`s- ;$ #c )t555 5r:c>t|t|zd|zdS)NzMark number %dTr)r _markName)r7transmids r8 _create_markzFile._create_markes, 9s? s "... .r:r) complevelc|jdGddtt}Gfddt}||rt di|_g|_d|_ d|_ d|_ | t}|t|j z|_|j|_|jD]r}|d t&d krY|d d }|j |j|<|j|j|xj d z c_ st/|jjj|_ |jjj|_n#t8$r||}|||j |_||t@|d||_|jt&d tCddfg|xj d z c_ |jd|"|jdt/|j d z |_ |jj#d z |_YnwxYwd|_$dS)aEnable the Undo/Redo mechanism. This operation prepares the database for undoing and redoing modifications in the node hierarchy. This allows :meth:`File.mark`, :meth:`File.undo`, :meth:`File.redo` and other methods to be called. The filters argument, when specified, must be an instance of class Filters (see :ref:`FiltersClassDescr`) and is meant for setting the compression values for the action log. The default is having compression enabled, as the gains in terms of space can be considerable. You may want to disable compression if you want maximum speed for Undo/Redo operations. Calling this method when the Undo/Redo mechanism is already enabled raises an UndoRedoError. MAX_UNDO_PATH_LENGTHceZdZdS)#File.enable_undo..ActionLogN)rXrYrZr\r:r8 ActionLogrs Dr:rc`eZdZedZeddZeddZdS)'File.enable_undo..ActionLogDescr)posrr:)rr]r]N)rXrYrZropcoderarg1arg2)maxundosr8 ActionLogDescrsJX!___F9W!#666D9W!#666DDDr:rz%Undo/Redo feature is already enabled!rrvrrarr-rz Action logrnrTN)%rrr&rr~rr _markers _seqmarkers_nmarks_curtransaction_curmarkrr%rr_transri _actionlog _op_to_coder4rnrowintattrsCURMARK CURACTION _curactionr rrr_action_log_namer3rnrowsr)r7rorrrrowrBrs @r8r&zFile.enable_undojs(+45         7 7 7 7 7 7 7M 7 7 7     ! ! I GHH H    , >]]#455F>!--d2244DK%.DO & &x=K$777v;--g66D*.,DM$'$++CH555LLA%LL 5 =>>DM"o3=DOOU 8 8 8  " " "3355F22,..DK(i(-!!!DO O " "[%8#a&&"$E#F G G G LLA LL   # #A & & &   dk1 - - - q 011DM"o3a7DOOO5 8Z!sFDJ54J5c&||std||`|`|`|`|`|` |` | t}| dd|_dS)aDisable the Undo/Redo mechanism. Disabling the Undo/Redo mechanism leaves the database in the current state and forgets past and future database states. This makes :meth:`File.mark`, :meth:`File.undo`, :meth:`File.redo` and other methods fail with an UndoRedoError. Calling this method when the Undo/Redo mechanism is already disabled raises an UndoRedoError. z&Undo/Redo feature is already disabled!rrFN)r~rr rrrrrrrrrr% _g_remover)r7tnodes r8 disable_undozFile.disable_undos ##%% J HII I  M   M O  L O /00 !$$$"r:cN|||d}nht|tst d|z||jvrt d|z||jdz|j|<| dt|jdz||xjdz c_|jdz|_ |j |j ||j|j|jS)aMMark the state of the database. Creates a mark for the current state of the database. A unique (and immutable) identifier for the mark is returned. An optional name (a string) can be assigned to the mark. Both the identifier of a mark and its name can be used in :meth:`File.undo` and :meth:`File.redo` operations. When the name has already been used for another mark, an UndoRedoError is raised. This method can only be called when the Undo/Redo mechanism has been enabled. Otherwise, an UndoRedoError is raised. Nrz?Only strings are allowed as mark names. You passed object: '%s'z#>??E NN   dma/>> - - i43G2N&NOO!,,,,=1,DL#/  >D   $ $-4:FFKK!IJJ J t99>>7DD YY!^^7D7DD!%&&&4nT&:&: ; II  t99w&&-.2ddDDD!:;; ; V!4!%W!5!5!%W!5!5!7 8 9 9 9 1r:ct|tr|}nqt|tr=||jvr&t |j}t d|z|j|}nt dt|z|S)z:Get an integer markid from a mark sequence number or name.zSThe mark that you have specified has not been found in the internal marker list: %rzMParameter mark can only be an integer or a string, and you passed a type <%s>)rkrr3rsortedr rlrm)r7r markidlmarkerss r8 _get_mark_idzFile._get_mark_idP s dC OFF c " " O4=((!$-00#%)+3%4555]4(FFACG::NOO O r:c`||jdz kr |jjS|dkrdS|j|S)zVGet the action to go. It does not touch the self private attributes rr)rrrr)r7rs r8_get_final_actionzFile._get_final_actionb sA DL1$ $ $?( ( q[[1''r:c |dkr$|j|dz|jdzddd}n|j|j|}tt|D]}|d|tdkr|dkrzt j|tt|d||d| d|d | dnt j |tt|d||d| d|d | dn\|dkr!t|d||_ n5t|d|dz |_ |j dkrd|_ |xj|z c_dS) zAUndo/Redo actions up to final action in the specificed direction.rrNrvrrarutf8r) rrrrArrredo _code_to_oprr4undor)r7 finalaction directionriis r8_doundoz File._doundot s q== a!0C CDTTrTJ I (CDI s9~~&&# )# )A"1%V)<<<q== M$#.c)H2Ea2H.I.I"J"+F"3A"6"="=f"E"E"+F"3A"6"="=f"E"E GGGGM$#.c)H2Ea2H.I.I"J"+F"3A"6"="=f"E"E"+F"3A"6"="=f"E"E GGGGq==$' &(9!(<$=$=DMM$' &(9!(<$=$=$ADM}q((() OOy (OOOG# )# )r:cd|||:|j}|jjj}||jtdkr|dz}n||}| |}||jkrtd|d| | |dz d|j|jj dz kr|xjdz c_t|jjj|j|_dS)a Go to a past state of the database. Returns the database to the state associated with the specified mark. Both the identifier of a mark and its name can be used. If the mark is omitted, the last created mark is used. If there are no past marks, or the specified mark is not older than the current one, an UndoRedoError is raised. This method can only be called when the Undo/Redo mechanism has been enabled. Otherwise, an UndoRedoError is raised. NrarMark ``zD`` is newer than the current mark. Use `redo()` or `goto()` instead.rv)r~rrrcolsrrrrrr rr'rrr)r7r rrr$s r8r#z File.undo s4    """ <]F_)0Fdo&+f*===! &&t,,F,,V44  ( (-GKtt!NOO O  [1_b))) ?T_2Q6 6 6 OOq OODO05doFGG r:c|||j|jjdz krdS| |jdz}n|dkrt |j}||}| |}||jdzkrtd|d| |xjdz c_| |d|j|jdz kr|xjdz c_|j|jjdz kr|jjdz |_dSdS)a Go to a future state of the database. Returns the database to the state associated with the specified mark. Both the identifier of a mark and its name can be used. If the `mark` is omitted, the next created mark is used. If there are no future marks, or the specified mark is not newer than the current one, an UndoRedoError is raised. This method can only be called when the Undo/Redo mechanism has been enabled. Otherwise, an UndoRedoError is raised. rNrvr)zD`` is older than the current mark. Use `redo()` or `goto()` instead.) r~rrrrrrrrrr rr'r7r rr$s r8r!z File.redo sa    """ ?do3a7 7 7 F <=1$DD RZZt|$$D""4((,,V44 1, , ,-GKtt!NOO O  1 [!$$$ =4 sG  &&((( r:c<|jsdS|jdkr|xjdzc_dS|j}|jr^|rJ|jjd|j|jjd|j |j |j t|j jdks$Jdt!|j jzt|j jdks$Jdt!|j jz||jd|_||_t*|dS)z=Flush all the alive leaves in object tree and close the file.Nrrrrz%cached nodes remain after closing: %sz$alive nodes remain after closing: %s)rrrErrrrr$rrrrrrrArr<r _close_filerclearrrKrDs r8rTz File.closeG s{  F  a      !   F=   L!1!1!3!3 L O ! - -i G G G O ! - -k4? K K K  ##%%%4%+,,111 4t)/001211 4%.//1444 3t)2334544   !  4     r:c|S)z)Enter a context and return the same file.r\r6s r8 __enter__zFile.__enter__{ s  r:c.|dS)z"Exit a context and close the file.F)rT)r7exc_infos r8__exit__z File.__exit__ s ur:cP|jsdS tjt|jjtjj d}n#t$rd}YnwxYw|jd|j d|dg}| dD]Y}| ||jd d D]1}|||D]}| |2Zd |d zS) aReturn a short string representation of the object tree. Examples -------- :: >>> import tables >>> f = tables.open_file('tables/tests/Tables_lzo2.h5') >>> print(f) tables/tests/Tables_lzo2.h5 (File) 'Table Benchmark' Last modif.: '...' Object Tree: / (RootGroup) 'Table Benchmark' /tuple0 (Table(100,)lzo(1)) 'This is the table title' /group0 (Group) '' /group0/tuple1 (Table(100,)lzo(1)) 'This is the table title' /group0/group1 (Group) '' /group0/group1/tuple2 (Table(100,)lzo(1)) 'This is the table title' /group0/group1/group2 (Group) '' >>> f.close() seconds)timespeczz (File) z Last modif.: z Object Tree: rgrNrP)rdatetime fromtimestamprrEstatst_mtimetimezoneutc isoformatrrrr _node_kindsrjoin)r7datelinesrkindrs r8__str__z File.__str__ s_0{ #"? &$22T]##((**3X5F5Jii++ D & & &%DDD &M994:99))) "%%c** , ,E LLE $ $ $(, , , OOE488,,DLLD++++, ,yy$&&sA,A88 BBc z|jsdSd|jd|jd|jd|jd|jd g}|dD]Y}|||jd d D]1}| ||D]}||2Zd |d zS) z;Return a detailed string representation of the object tree.r?zFile(filename=z, title=z, mode=z , root_uep=z , filters=rrgrNrP) rrErrtrrorrrIrrJ)r7rLrrMrs r8__repr__z File.__repr__ s{ #"? )T] ) )dj ) )I ) ),0M ) )| ) ) )*%%c** . .E LLE $ $ $(, . . OOE488..DLLD----. .yy$&&r:cp|dz}t|}|jj|jjfD]}t |D]v}||r_||krY||d}t ||}t|d} ||} | | wdS)zrUpdate location information of nodes under `oldpath`. This only affects *already loaded* nodes. rgNr) rArrrr<rrrr|_g_update_location) r7oldpathnewpath oldprefix oldprefix_lenrr nodesuffix newnodepath newnodeppathdescendent_nodes r8_update_node_locationszFile._update_node_locations scM I (.0B0KL E EE KK E E&&y11Eh)6K6K!)-..!9J"+GZ"@"@K#-k#:#:1#=L&*nnX&>&>O#66|DDD  E E Er:rrrrgN)rNF) NrNrENNFNT)NrNFNNT) NNrNNNFNT) NNrNrdNNFNT) NrNNNNFNTF)NNr)NNNFF)NNNFFFr2)FFF)rgNr)GrXrYrZ__doc__rIr[rsetterdeleterror9r r9r7r<rSr`rcrgrirorsrzr|rrrrrrrrrrrrwrrrFrrrr~rrrrrrrrrr&r r r rrr'r#r!r.r0r3rrTr:r=rNrPr[r\r:r8rr/szzz7K ""X" \##\# ]]$$X$  ^''^' _!!_!24'+W>W>W>W>r"P"P"PH ' ' ',;?#(#=#=#=#=JAC0604@Dxxxxt9;388<^.^.^.^.@GI/3?C"&rrrrhGI1515AEssssj<>262604#' nnnn`////*88AAAAF222****&CG16BBBB:CGBG<J<J<J<J|!!!!(((((",,,,8!!!!"....&27$)EEEEBHHHHT . . . .....2   $$$**=*=*=*=X&&&&"???--- <<<KKK ! ! !LLL555 ... #*'A"6"6"6]!]!]!]!~!"!"!"F))))V777r$((($/)/)/)b*H*H*H*H\.8.8.8.8d0$   2!2!2!h  ,',','\'''$EEEEEr:rr]r\)rr^atexitrBrrQrr collectionsrpathlibrnumexprr'numpyrMrrrr exceptionsr r r r r rrrrrrrrrHrrrrrrorrrrrrrrrr leafr!arrayr"carrayr#earrayr$vlarrayr%tabler&r'utilsr(r)r^r*r+r\r,linkr-r.rcompatible_formatsr0rrr"r_trans_group_parentrr%_action_log_parentr_action_log_path _trans_parentr _trans_path _markParentrrr2r3 _shadow_pathrprwrhdf5_version_strtuplemaprr;hdf5_version_tuprrvrdictrrrregisterrWr\r:r8r}sh  ######------------------('''''''''''''>>>>>>>>>>>>>>&&&&&&&&########9999999999))))))00000000(((((((($.#.#.#.#.#.#.#.#dmoo     IHH %I13DEE&9/1ABB!  i {33   Ik9 - -  y66 '''83>2445S"2"8"8"="=a"@"F"Fs"K"KLLMM 09 <