Method create_carray

tables/file.py:1239–1372

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`). na

(
        self,
        where: Group | str,
        name: str,
        atom: Atom | None = None,
        shape: tuple[int, ...] | None = None,
        title: str = "",
        filters: Filters | None = None,
        chunkshape: int | tuple[int, ...] | None = None,
        byteorder: str | None = None,
        createparents: bool = False,
        obj: np.ndarray | None = None,
        track_times: bool = True,
    )

        )

    def create_carray(
        self,
        where: Group | str,
        name: str,
        atom: Atom | None = None,
        shape: tuple[int, ...] | None = None,
        title: str = "",
        filters: Filters | None = None,
        chunkshape: int | tuple[int, ...] | None = None,
        byteorder: str | None = None,
        createparents: bool = False,
        obj: np.ndarray | None = None,
        track_times: bool = True,
    ) -> CArray:
        """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