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.2.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.2-py3-none-any.whl (11.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: oasnap_reader-0.3.2.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.2.tar.gz
Algorithm Hash digest
SHA256 8f91524efbcaf6340f38e6d9ba26b88c878a5a3609a5b4fd1412b264cda0fe08
MD5 4e5ae222733f32e153d417b7b5aa93fe
BLAKE2b-256 16e42d1011cbd40c2f98244d3d950daa8f7d9f9bdd97e4bc9d2257fed454ccfa

See more details on using hashes here.

File details

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

File metadata

  • Download URL: oasnap_reader-0.3.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6f4fe0430db602bb3ad6ac91aea6d3e83c22d80a9b376cbea14ec02f7c88a1a4
MD5 49330dd49a1d7af0ac9d2958f632a720
BLAKE2b-256 8ac444d9fdc69d4c34521f649c61348f7776f9f9d170396896ade8bdb47c1f54

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