uproot.create

Defined in uproot.writing.writable on line 47.

uproot.writing.writable.create(file_path: str | Path | IO, **options)
Parameters:

  • file_path (str, pathlib.Path or file-like object) – The filesystem path of the file to open or an open file.

  • options – See below.

Opens a local file for writing. Like ROOT’s "CREATE" option, this function raises an error (FileExistsError) if a file already exists at file_path.

Returns a uproot.WritableDirectory.

Options (type; default):

  • initial_directory_bytes (int; 256): The number of bytes to allocate for new directories so that TKeys can be added to them without needing immediate rewriting of the block.

  • initial_streamers_bytes (int; 1024): The number of bytes to allocate for a new list of streamers so that streamers can be added to it without needing immediate rewriting

  • uuid_function (callable; uuid.uuid1): Function to create the file’s UUID and/or any directory’s UUID.

  • compression (uproot.compression.Compression or None; uproot.ZLIB(1)): Compression algorithm and level for new objects added to the file. Can be updated after creating the uproot.WritableFile.

See uproot.WritableFile for details on these options.

Additional options are passed as storage_options to the fsspec filesystem