ORCID-DOI index

ORCID-DOI index#

The orcid_process.py script extracts DOI-author associations from ORCID XML summary files. The output is a CSV index that maps each DOI to the authors who claimed it in their ORCID profile.

Usage#

uv run python -m oc_meta.run.orcid_process \
    -out <output_path> \
    -s <summaries_path> \
    [-t <threshold>]

Parameters#

Parameter	Description
`-out, --output`	Output directory for CSV files
`-s, --summaries`	Directory containing ORCID XML summaries (scanned recursively)
`-t, --threshold`	Number of files to process before saving a CSV chunk (default: 10000)

Input#

The script expects ORCID public data summaries in XML format. These can be downloaded from the ORCID public data file.

The downloaded archive must be extracted before processing:

tar -xzf ORCID_2024_10_summaries.tar.gz -C /path/to/destination/

Each XML file contains an ORCID profile with external identifiers. The script extracts DOIs marked with relationship type “self” (i.e., works authored by the profile owner).

Output#

CSV files with two columns:

Column	Content
`id`	DOI
`value`	Author name and ORCID in format `Surname, Given [0000-0000-0000-0000]`

Multiple authors can be associated with the same DOI if they all claimed it in their profiles.

Example#

uv run python -m oc_meta.run.orcid_process \
    -out ./orcid_index \
    -s ./ORCID_2023_10_summaries \
    -t 50000

This processes all XML files in ORCID_2023_10_summaries and saves a CSV chunk every 50000 files.

Resume support#

The script tracks processed ORCID IDs. If interrupted, it skips already processed files on the next run.