Skip to main content

pyivt

Read Statistics Canada Beyond 20/20 (.ivt) files in Python. Inspect bilingual metadata and export data to Apache Arrow or Parquet.

pyivt is unstable until version 0.1.0. Its public API and output schemas may change between earlier releases.

Install

pip install pyivt

With uv, run uv add pyivt. The package requires Python 3.10 or later.

Open a file and export it

import pyarrow.parquet as pq
import pyivt

ivt = pyivt.open("data.ivt")
print(ivt.metadata.title.en or ivt.metadata.title.fr)

table, members = ivt.to_arrow()
pq.write_table(table, "data.parquet")
members.to_json("data.members.json")

pyivt.open() also accepts bytes or a binary file object. For a download, pass the response bytes.

The table has one label column per dimension and a numeric value column. Keep the JSON with the export to retain native member codes and attributes.

Read metadata

meta = ivt.metadata

print(meta.title.en, meta.title.fr)
for dimension in meta.dimensions:
    print(dimension.name.en, dimension.items)

Use .en or .fr for localized fields. Missing translations are None. You can inspect metadata without exporting cells.

Select members

axis = ivt.layout.slugs[0]
subset, subset_members = ivt.to_arrow({axis: [1]})

Keys are dimension slugs and values are 1-based member codes. An omitted dimension keeps all its rows and leaves out its column. The export does not aggregate values.

Documentation

License

MIT

Acknowledgements

Metadata

Release files for pyivt 0.0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyivt 0.0.6
File Size Uploaded Provenance Actions
pyivt-0.0.6.tar.gz 643.8 kB With provenance Details for pyivt-0.0.6.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for pyivt 0.0.6
File Actions
pyivt-0.0.6-cp310-abi3-win_amd64.whl CPython 3.10 abi3 Windows x86-64 Details for pyivt-0.0.6-cp310-abi3-win_amd64.whl
pyivt-0.0.6-cp310-abi3-manylinux_2_28_x86_64.whl CPython 3.10 abi3 Linux glibc 2.28+ x86-64 Details for pyivt-0.0.6-cp310-abi3-manylinux_2_28_x86_64.whl
pyivt-0.0.6-cp310-abi3-manylinux_2_28_aarch64.whl CPython 3.10 abi3 Linux glibc 2.28+ ARM64 Details for pyivt-0.0.6-cp310-abi3-manylinux_2_28_aarch64.whl
pyivt-0.0.6-cp310-abi3-macosx_11_0_arm64.whl CPython 3.10 abi3 macOS 11.0+ ARM64 Details for pyivt-0.0.6-cp310-abi3-macosx_11_0_arm64.whl
pyivt-0.0.6-cp310-abi3-macosx_10_12_x86_64.whl CPython 3.10 abi3 macOS 10.12+ x86-64 Details for pyivt-0.0.6-cp310-abi3-macosx_10_12_x86_64.whl

Total release size: 10.7 MB

Release files / pyivt-0.0.6.tar.gz

Download URL pyivt-0.0.6.tar.gz
Size 643.8 kB
Tags Source
SHA-256 checksum
How to use checksums
c635d2ece9ecf0c72bbceb9672a3b4f142bfb766d4ec766d723a0f9a642180e1
BLAKE2b-256 checksum
How to use checksums
26a5ab4dd64ce16c939503be8fdabd8ca338b862d663707405dcc69f1f464931
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 3, 2026.

Transparency log

Release files / pyivt-0.0.6-cp310-abi3-win_amd64.whl

Download URL pyivt-0.0.6-cp310-abi3-win_amd64.whl
Size 1.8 MB
Tags CPython 3.10 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
7509a150c9841f2ac2d75fd396453a1d541349532e1a33d259a8a7286203ba8e
BLAKE2b-256 checksum
How to use checksums
191afe49886a167e4386bd445ba6bc82202b65e8aabda9440f1f84a7ad73ddd8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 3, 2026.

Transparency log

Release files / pyivt-0.0.6-cp310-abi3-manylinux_2_28_x86_64.whl

Download URL pyivt-0.0.6-cp310-abi3-manylinux_2_28_x86_64.whl
Size 2.3 MB
Tags CPython 3.10 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
0f17a3d313d8520216a5e2ece9637d0a495d5253343afde8125dd094f00ef75f
BLAKE2b-256 checksum
How to use checksums
feaafbb73dcbf630e7a68963dd9cee8d556affd44a9fed26a00d2b9b71fe76c9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 3, 2026.

Transparency log

Release files / pyivt-0.0.6-cp310-abi3-manylinux_2_28_aarch64.whl

Download URL pyivt-0.0.6-cp310-abi3-manylinux_2_28_aarch64.whl
Size 2.2 MB
Tags CPython 3.10 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
15b94d2b4e26eb604f8577df5b76def8f2a1f7e81cb47156cbfd1ccfd01265c6
BLAKE2b-256 checksum
How to use checksums
1db9f4d37721e7cdde918a4ba073d68a242712a1aa37a1db89ddf4ee71562f91
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 3, 2026.

Transparency log

Release files / pyivt-0.0.6-cp310-abi3-macosx_11_0_arm64.whl

Download URL pyivt-0.0.6-cp310-abi3-macosx_11_0_arm64.whl
Size 1.9 MB
Tags CPython 3.10 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
d93b2a42cc4d4d51c3238b97c12d39fe1ad66d0e2e6e1a3f87e19cd03e11a2f1
BLAKE2b-256 checksum
How to use checksums
f393206118c2b2df914efbda671017b62b628a30f2328279a8caabd3d569f445
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 3, 2026.

Transparency log

Release files / pyivt-0.0.6-cp310-abi3-macosx_10_12_x86_64.whl

Download URL pyivt-0.0.6-cp310-abi3-macosx_10_12_x86_64.whl
Size 2.0 MB
Tags CPython 3.10 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
2e3db756e248de5e4ce79a01d2f061d4b8fa00c83bf3a0033f051c2dd674ccde
BLAKE2b-256 checksum
How to use checksums
664101ddcb2c2cb56d9dd39978fa7f633cefece3ae6dffdd5622d6a481de1dc0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 3, 2026.

Transparency log

Security for pyivt 0.0.6

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.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for pyivt-0.0.6.tar.gz

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 Nov 3, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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