d^(bdZddlZddlZddlmZddlmZddlm Z m Z dZ Gdd eZ dS) z!Here is defined the CArray class.N)Atom)Array)correct_byteorderSizeTypez1.1cBeZdZdZdZ d fd ZdZdZd ZxZ S) CArraya This class represents homogeneous datasets in an HDF5 file. The difference between a CArray and a normal Array (see :ref:`ArrayClassDescr`), from which it inherits, is that a CArray has a chunked layout and, as a consequence, it supports compression. You can use datasets of this class to easily save or load arrays to or from disk, with compression support included. CArray includes all the instance variables and methods of Array. Only those with different behavior are mentioned here. Parameters ---------- parentnode The parent :class:`Group` object. .. versionchanged:: 3.0 Renamed from *parentNode* to *parentnode*. name : str The name of this node in its parent group. atom An `Atom` instance representing the *type* and *shape* of the atomic objects to be saved. shape The shape of the new array. title A description for this node (it sets the ``TITLE`` HDF5 attribute on disk). filters An instance of the `Filters` class that provides information about the desired I/O filters to be applied during the life of this object. 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 dimensionality of `chunkshape` must be the same as that of `shape`. If ``None``, a sensible value is calculated (which is recommended). byteorder The byteorder of the data *on disk*, specified as 'little' or 'big'. If this is not specified, the byteorder is that of the platform. 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 Examples -------- See below a small example of the use of the `CArray` class. The code is available in ``examples/carray1.py``:: import numpy as np import tables as tb fileName = 'carray1.h5' shape = (200, 300) atom = tb.UInt8Atom() filters = tb.Filters(complevel=5, complib='zlib') h5f = tb.open_file(fileName, 'w') ca = h5f.create_carray(h5f.root, 'carray', atom, shape, filters=filters) # Fill a hyperslab in ``ca``. ca[10:60, 20:70] = np.ones((50, 50)) h5f.close() # Re-open a read another hyperslab h5f = tb.open_file(fileName) print(h5f) print(h5f.root.carray[8:12, 18:22]) h5f.close() The output for the previous script is something like:: carray1.h5 (File) '' Last modif.: 'Thu Apr 12 10:15:38 2007' Object Tree: / (RootGroup) '' /carray (CArray(200, 300), shuffle, zlib(5)) '' [[0 0 0 0] [0 0 0 0] [0 0 1 1] [0 0 1 1]] CARRAYNTc 0||_ d|_ d|_ d|_ |dux|_} ||_ d|_ ||_ d|_ d|_ d|_ d|_ d|_ d|_ d|_ d|_ d|_ | rWt#|t$st'dt)|z|t'd t+|}n-#t,$r t-dt)|zwxYwt+d|D|_| t+|}n-#t,$r t-dt)|zwxYwt/|t/|krt'd |d |d t1|d krt'd t+d|D|_t3t4|||| ||| | dS)NTFzHatom parameter should be an instance of tables.Atom and you passed a %s.z"you must specify a non-empty shapez8`shape` parameter must be a sequence and you passed a %sc34K|]}t|VdSNr.0ss -lib/python3.11/site-packages/tables/carray.py z"CArray.__init__..s(::qx{{::::::z=`chunkshape` parameter must be a sequence and you passed a %sz the shape (z) and chunkshape (z) ranks must be equal.rz1chunkshape parameter cannot have zero-dimensions.c34K|]}t|VdSrrrs rrz"CArray.__init__..s(*K*K18A;;*K*K*K*K*K*Kr)atomshapeextdim _v_version_v_new _v_new_title _v_convert _v_chunkshape_start_stop_step _nrowsread_startb_stopb_row_initlistarr isinstancer ValueErrortypetuple TypeErrorlenminsuperr__init__) self parentnodenamerrtitlefilters chunkshape byteorder_log track_timesnew __class__s rr1zCArray.__init__{s    , 5/ ,, c?!&D'H 5 5 2G . / 2 M *  LdD)) - "D!%d",---} !EFFF Ee  E E E!68@@ @$$TZ000rct|_|j+|||j|jj|_||_|j )t|jj tj |_ | |j|_n%#t $r|dwxYw|jS)z)Create a new array in file (common part).Nr)flush) obversionrr_calc_chunkshaperowsizersize_calc_nrowsinbuf nrowsinbufr8rr+sys_create_carrayr _v_objectid Exceptionclose)r2 expectedrowss rr>zCArray._g_create_commons$   %!%!6!6dlDIN"<" !.ty~s}MMDN  $2243DEED      JJQJ      s B))"C c ||||\}}}|j} t|j} t t |||| | <|j} d|jD}d|_t|||j | |||| }t |||| zD]n}||| zz}||kr|}t||||| <||z |z}|| z}|| | kr| | }| t||||<od|_tj|jt|j jz}||fS)z2Private part of Leaf.copy() for each kind of leaf.c0g|]}td|dS)rr)slice)rdims r z-CArray._g_copy_with_stats..s$999s%3""999rF)rrr5r6r7r9T)dtype)_process_range_readmaindimlistrr.rangerHrr rrQ __getitem__r,npprodrrF)r2groupr4startstopstepr5r6r7r9kwargsrVrrHslicesobjectstart2stop2start3stop3nbytess r_g_copy_with_statszCArray._g_copy_with_statss#66udDIId,TZ  U5$5566g_ 99dj999 t$)5#W!###E4 ):;; C CFTJ..Et||#FE488F7Oun-FZ'EuW~%%g$(#3#3E&MM#B#BF6%< 8444ty~Er)NNr NNNTT) __name__ __module__ __qualname____doc__ _c_classidr1r@r>rh __classcell__)r<s@rr r sddNJ#'#',0(, NBNBNBNBNBNB`111   6' ' ' ' ' ' ' rr ) rlrInumpyrZrrarrayrutilsrrrCr rrrss'' ........  E E E E E UE E E E E r