Skip to main content

oasnap-reader

Read a full OpenAlex snapshot and convert it to a reduced dataset for analysis.

The reduced dataset filters out paratext records and extracts bibliographic fields, topic classifications, authorship, and citation data into a compact format suitable for large-scale analysis.

Full conversion time depends on available hardware. The full conversion with >2000 files took ~2 hours with 24 workers and sufficient RAM.

Install

pip install oasnap-reader

Usage

from pathlib import Path
from oasnap_reader.reader import ReadGZ

reader = ReadGZ(
    in_path=Path("/data/openalex/works"),
    out_path=Path("/data/reduced"),
)
reader.read_all()

in_path should point to the root of the OpenAlex works snapshot directory. Output is one gzip-compressed JSONL file per input file, written to out_path.

Documentation

See the full documentation including usage options and API reference at the project docs site.

Development

git clone https://gitlab.gwdg.de/mpigea/dt/oasnap-reader
cd oasnap-reader
uv sync --dev

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

oasnap_reader-0.3.3.tar.gz (9.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

oasnap_reader-0.3.3-py3-none-any.whl (11.2 kB view details)

Uploaded Python 3

File details

Details for the file oasnap_reader-0.3.3.tar.gz.

File metadata

  • Download URL: oasnap_reader-0.3.3.tar.gz
  • Upload date:
  • Size: 9.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for oasnap_reader-0.3.3.tar.gz
Algorithm Hash digest
SHA256 b1f2ade2b90b27782451ec927cbab22d64c3ec235d266e9845212dd746074347
MD5 558085638cf316f0f373e4b619af95d9
BLAKE2b-256 d78005c3c9be26b4de29877191b78d1f1456367f25a608f900bd524e3f4cc2d5

See more details on using hashes here.

File details

Details for the file oasnap_reader-0.3.3-py3-none-any.whl.

File metadata

  • Download URL: oasnap_reader-0.3.3-py3-none-any.whl
  • Upload date:
  • Size: 11.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for oasnap_reader-0.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 4d06b1d3272f9dd8972c425250221d3f43be3d3be4c171a409739abdab356f08
MD5 a13cec5025df2ea75df262c4a206deb4
BLAKE2b-256 95bcf5d19f75e279362a8a1871ed9909896affa43b48c3b9ac14994b3608d66f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page