Skip to main content

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-py codifies the assumption that a FCIOConfig record must be available and skips all previous records on opening
  • reading of zstd or gzip compressed files is possible using suprocesses. This requires zstd or gzip to be available. If a file ends in .zst or .gz respectively and the compression parameter 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)

Source distribution for fcio 0.9.4
File Size Uploaded
fcio-0.9.4.tar.gz 159.7 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for fcio 0.9.4
File
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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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

Release history Release notifications | RSS feed

This release

0.9.4 This release

15 release files

0.9.3

15 release files

0.9.2

15 release files

0.9.1

15 release files

0.9.0

15 release files

0.7.8

11 release files

0.7.7

11 release files

0.7.6

11 release files

0.7.5

11 release files

0.7.4

11 release files

0.7.3

11 release files

0.7.1

1 release file

0.7.0

1 release file

0.6.3

1 release file

0.6.1

1 release file

0.6.0

1 release file

0.5.0

1 release file

0.4.13

1 release file

0.4.12

1 release file

0.4.11

1 release file

0.4.10

1 release file

0.4.9

1 release file

0.4.8

1 release file

0.4.7

1 release file

0.4.6

1 release file

0.4.5

1 release file

0.4.2

1 release file

0.4.1

1 release file

0.4.0

1 release file

0.3.0

1 release file

0.2.5

1 release file

0.2.2

1 release file

0.2.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page