Installation
Run python3 -m pip install fcio to install from the pypi repository.
Description
fcio-py provides a read-only wrapper around the fcio.c io library used in fc250b based digitizer systems.
The wrapper exposes the fcio.c memory fields as closely as possible to standard c-structs using numpy ndarrays or scalars where applicable.
For convenience all supported fcio records are exposed as iterable properties of the base FCIO class to preselect records of interest.
Usage
Simple code example
The following example opens an fcio file and prints some basic event content to stdout:
from fcio import fcio_open
filename = 'path/to/an/fcio/file'
with fcio_open(filename, extended=True) as io:
print("#evtno run_time utc_unix_sec utc_unix_nsec ntraces bl_mean bl_std")
for event in io.events:
print(f"{event.eventnumber} {event.run_time:.09f} {event.utc_unix_sec} {event.utc_unix_nsec} {event.trace_list.size} {event.fpga_baseline.mean():.1f} {event.fpga_baseline.std():.2f}")
Differences to C usage
fcio-pycodifies the assumption that aFCIOConfigrecord must be available and skips all previous records on opening- reading of zstd or gzip compressed files is possible using suprocesses. This requires
zstdorgzipto be available. If a file ends in.zstor.gzrespectively and thecompressionparameter is default, this will happen automatically.
Development
Development is best done in a local environment, e.g. using venv:
# create local environment:
export MY_ENV=fcio_dev
python3 -m venv $MY_ENV
# activate the environment
source $MY_ENV/bin/activate
This library depends on meson-python/meson as build tool and Cython/numpy to wrap the c-sources. These should be installed automatically wenn running python3 -m build.
To allow a more traditional workflow a thin Makefile is available which wraps the python3 and meson specific commands.
Metadata
Release files for fcio 0.9.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| fcio-0.9.4.tar.gz | 159.7 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| fcio-0.9.4-cp314-cp314t-manylinux_2_28_x86_64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux glibc 2.28+ x86-64 | Details |
| fcio-0.9.4-cp314-cp314t-macosx_11_0_arm64.whl | CPython 3.14 | CPython 3.14 free-threading | macOS 11.0+ ARM64 | Details |
| fcio-0.9.4-cp314-cp314-manylinux_2_28_x86_64.whl | CPython 3.14 | CPython 3.14 | Linux glibc 2.28+ x86-64 | Details |
| fcio-0.9.4-cp314-cp314-macosx_11_0_arm64.whl | CPython 3.14 | CPython 3.14 | macOS 11.0+ ARM64 | Details |
| fcio-0.9.4-cp313-cp313-manylinux_2_28_x86_64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.28+ x86-64 | Details |
| fcio-0.9.4-cp313-cp313-macosx_11_0_arm64.whl | CPython 3.13 | CPython 3.13 | macOS 11.0+ ARM64 | Details |
| fcio-0.9.4-cp312-cp312-manylinux_2_28_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.28+ x86-64 | Details |
| fcio-0.9.4-cp312-cp312-macosx_11_0_arm64.whl | CPython 3.12 | CPython 3.12 | macOS 11.0+ ARM64 | Details |
| fcio-0.9.4-cp311-cp311-manylinux_2_28_x86_64.whl | CPython 3.11 | CPython 3.11 | Linux glibc 2.28+ x86-64 | Details |
| fcio-0.9.4-cp311-cp311-macosx_11_0_arm64.whl | CPython 3.11 | CPython 3.11 | macOS 11.0+ ARM64 | Details |
| fcio-0.9.4-cp310-cp310-manylinux_2_28_x86_64.whl | CPython 3.10 | CPython 3.10 | Linux glibc 2.28+ x86-64 | Details |
| fcio-0.9.4-cp310-cp310-macosx_11_0_arm64.whl | CPython 3.10 | CPython 3.10 | macOS 11.0+ ARM64 | Details |
| fcio-0.9.4-cp39-cp39-manylinux_2_28_x86_64.whl | CPython 3.9 | CPython 3.9 | Linux glibc 2.28+ x86-64 | Details |
| fcio-0.9.4-cp39-cp39-macosx_11_0_arm64.whl | CPython 3.9 | CPython 3.9 | macOS 11.0+ ARM64 | Details |
Total release size: 4.0 MB
Release files / fcio-0.9.4.tar.gz
| Download URL | fcio-0.9.4.tar.gz |
|---|---|
| Size | 159.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ba991f582e29d7eb556c731aa8c8e59a8f53f92c65792a99ff2b75c532834583
|
|
BLAKE2b-256 checksum How to use checksums |
8b3226887d6dfaf781fa47b79672fd01045c11aa62aaf22d32ab75c398d19787
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp314-cp314t-manylinux_2_28_x86_64.whl
| Download URL | fcio-0.9.4-cp314-cp314t-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 287.6 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
d7c0b98634edaab97b9f5f4de0ea50a8aa4a2408f0ec03817325308dd0750a9b
|
|
BLAKE2b-256 checksum How to use checksums |
e44ee7d8bf52bab8fa568539143f06976283bb585d6cf65eafefa1b544819603
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp314-cp314t-macosx_11_0_arm64.whl
| Download URL | fcio-0.9.4-cp314-cp314t-macosx_11_0_arm64.whl |
|---|---|
| Size | 250.8 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
dcc10c639634b1aa3d8cfbd1121575e6ccece27cb4dc0b36ed93a91b93ae3469
|
|
BLAKE2b-256 checksum How to use checksums |
771f524b21a962dcf3a7a3df3ee6eb530d20d78e490ce6855a98d26739167fe3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp314-cp314-manylinux_2_28_x86_64.whl
| Download URL | fcio-0.9.4-cp314-cp314-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 305.4 kB |
| Tags | CPython 3.14 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
5764859698452dd979be6973455802e71cc55d98e6b362ef9444c859263d1329
|
|
BLAKE2b-256 checksum How to use checksums |
39234323d2319a0a7aeff8dd47a7d5516444a7b63c4df765a1c7858a5d9ccfed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | fcio-0.9.4-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 239.1 kB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
6771d244786be56cb4ac9bb0fbb3cc228170fe3d6c0b4c27c891cf4f7f4001ec
|
|
BLAKE2b-256 checksum How to use checksums |
8979bc85da4fb20487dcd7a9414c4d51907c8847223322ae83466b8de2481f41
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp313-cp313-manylinux_2_28_x86_64.whl
| Download URL | fcio-0.9.4-cp313-cp313-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 304.2 kB |
| Tags | CPython 3.13 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
0f33e80c793c48ff46666fda31ce51313bbf29b70e9bdedb3f00b60bbb495b37
|
|
BLAKE2b-256 checksum How to use checksums |
3a235a488f3f6e807913166b249566c28149b5e39d84a7cc58b7b10e95c843b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | fcio-0.9.4-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 239.1 kB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
46eaa59eade7584024f1e2d5d9c77e337b9159a668de55b7f738bdfa44829fbf
|
|
BLAKE2b-256 checksum How to use checksums |
4e4d4baadff18d0e6f4c913f52a50992e48e714709593332221a4410dc6176a7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp312-cp312-manylinux_2_28_x86_64.whl
| Download URL | fcio-0.9.4-cp312-cp312-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 304.9 kB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
2ccba963368fef4ed303debf1b7b13779a5c967313596bb1bf583ffe8a574ed0
|
|
BLAKE2b-256 checksum How to use checksums |
f6eb855a489c0801de404c092444545371a732dac5df9066939031fa28494b60
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | fcio-0.9.4-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 230.9 kB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
2de9e5e45626d615746fd0aaa1f2708b755e57d8c639ccd72b882785c9959e03
|
|
BLAKE2b-256 checksum How to use checksums |
b10dd0ecf4fc6cf191b712552fe29a587e808a2bfb0118f83a71ee65a9f55cdb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp311-cp311-manylinux_2_28_x86_64.whl
| Download URL | fcio-0.9.4-cp311-cp311-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 311.2 kB |
| Tags | CPython 3.11 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
940eed150571aad4441c16797b7e2616a0517d46871e4864fd9d9235b5a0ec7a
|
|
BLAKE2b-256 checksum How to use checksums |
ec64c5d1b1ae4e141c337ce68cb8db72535f19d8702a0d92b6bca595d4adbf21
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | fcio-0.9.4-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 230.8 kB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
9298af16f35282dcfc8fad8c12ce75d111ba8882c680e22e92425ba028467520
|
|
BLAKE2b-256 checksum How to use checksums |
83b252f29defa7474f23536d94c71cfd8f89ee11ad3283a880f745b5e4663283
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp310-cp310-manylinux_2_28_x86_64.whl
| Download URL | fcio-0.9.4-cp310-cp310-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 318.6 kB |
| Tags | CPython 3.10 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
d8235d0cd0184167b3bafeb3d97554c2bb0f23606af6dfe8b894f2e1811e6ce8
|
|
BLAKE2b-256 checksum How to use checksums |
b4a1fff3f7b18467601af95150ad73034eea752af3511fb94fa8c5bd69fb196a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | fcio-0.9.4-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 232.0 kB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
58d9f3a059ac4bcf3d6b12fd5f97224192a7e5815d009bf693541de2d19f4618
|
|
BLAKE2b-256 checksum How to use checksums |
858140c58b52a5bb81fad1ed282949473c7278a5db2eed456bbb4426e86fad38
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp39-cp39-manylinux_2_28_x86_64.whl
| Download URL | fcio-0.9.4-cp39-cp39-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 319.9 kB |
| Tags | CPython 3.9 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
37768f5f038caaa114cd0535167c8acad4f475759768a1f458f2652517505ca3
|
|
BLAKE2b-256 checksum How to use checksums |
6a237b2943de2cccd705202cbaa6b0593907fe6488ae0e28e564eed8352ec414
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency logRelease files / fcio-0.9.4-cp39-cp39-macosx_11_0_arm64.whl
| Download URL | fcio-0.9.4-cp39-cp39-macosx_11_0_arm64.whl |
|---|---|
| Size | 232.5 kB |
| Tags | CPython 3.9 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
d0ef0de944888424323e5a7a36ad341bde57c5a09c2d5353f3e6200f24218ed0
|
|
BLAKE2b-256 checksum How to use checksums |
6656715fb10480a3fbe8c278d784fa1b87cf20e71f157cc4e521dbf96177efe0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.
Transparency log