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.5.tar.gz (9.7 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.5-py3-none-any.whl (11.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: oasnap_reader-0.3.5.tar.gz
  • Upload date:
  • Size: 9.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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.5.tar.gz
Algorithm Hash digest
SHA256 29413ccf7fdf64caba16daa54ae449a0eaf733acb0c2fecea65741a2ccc9e89b
MD5 20af6cde04951ae90d07dfaab3a37a71
BLAKE2b-256 d3db06fd5939df2545b62887cf6cb4c99606f8f9ef5eb9184c072df77958cbfa

See more details on using hashes here.

File details

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

File metadata

  • Download URL: oasnap_reader-0.3.5-py3-none-any.whl
  • Upload date:
  • Size: 11.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 7a0b4c5d48d43b7485d7fe76c78e75d4f9d5a03db2010f506fb297e7198b5fe0
MD5 916a3d5964f913306b9142bf863ec875
BLAKE2b-256 db06c4f1c0bace6e4289fe73d2d9ef2d8466ee2ec783ed7097a3c3e31d9a9672

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