PyIRD: A Python-Based Data Reduction Pipeline for Subaru/IRD and REACH

PyIRD: A Python-Based Data Reduction Pipeline for Subaru/IRD and REACH - Published in JOSS (2026)

https://github.com/prvjapan/pyird

Science Score: 89.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 1 DOI reference(s) in JOSS metadata
  • Academic publication links
    Links to: joss.theoj.org, zenodo.org
  • Committers with academic emails
    2 of 5 committers (40.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software
Last synced: about 1 month ago · JSON representation

Repository

Python pipeline for infrared detectors, and/or IRD/REACH

Basic Info
Statistics
  • Stars: 8
  • Watchers: 2
  • Forks: 2
  • Open Issues: 5
  • Releases: 8
Created almost 5 years ago · Last pushed about 1 month ago
Metadata Files
Readme Contributing License

README.md

PyIRD

License: MIT Version PyPI Version Run pytest DeepWiki<!-- DeepWiki badge generated by https://deepwiki.ryoppippi.com/ --> status

PyIRD is a Python-based pipeline for reducing spectroscopic data obtained with IRD and REACH on the Subaru Telescope. It is designed to process raw images into one-dimensional spectra in a semi-automatic manner. Unlike traditional methods, it does not rely on IRAF (Tody et al. 1986, 1993), a software traditionally used for astronomical data reduction. This approach simplifies the workflow while maintaining efficiency and accuracy. Additionally, the pipeline includes an updated method for removing readout noise patterns from raw images, enabling efficient extraction of spectra even for faint targets such as brown dwarfs.

Read the docs or deepwiki for PyIRD.

Install

pip install pyird

or

git clone https://github.com/prvjapan/pyird.git cd pyird pip install .

Examples

PyIRD is designed to perform data reduction semi-automatically by following a general workflow for high-dispersion spectroscopic data reduction (e.g., readout noise subtraction, flat fielding, aperture extraction, wavelength calibration, and normalization).

See the following examples how to create 1D spectra from raw data. - pyird/examples/python/IRD_stream.py -- for IRD data; read the docs for the detailed explanation. - pyird/examples/python/REACH_stream.py -- for REACH data; basically the same as IRD_stream.py, but with the variable inst set to REACH instead.

The raw data for IRD_stream.py can be downloaded from the Zenodo repository.

License

PyIRD is publicly available under the MIT license. For developers, please read CONTRIBUTING.md.

Owner

  • Name: prvjapan
  • Login: prvjapan
  • Kind: organization
  • Location: Japan

REACH/IRD repositories in Japan

JOSS Publication

PyIRD: A Python-Based Data Reduction Pipeline for Subaru/IRD and REACH
Published
January 17, 2026
Volume 11, Issue 117, Page 9126
Authors
Yui Kasagi ORCID
Institute of Space and Astronautical Science, Japan Aerospace Exploration Agency, 3-1-1 Yoshinodai, Chuo-ku, Sagamihara, Kanagawa, 252-5210, Japan
Hajime Kawahara ORCID
Institute of Space and Astronautical Science, Japan Aerospace Exploration Agency, 3-1-1 Yoshinodai, Chuo-ku, Sagamihara, Kanagawa, 252-5210, Japan, Department of Astronomy, Graduate School of Science, The University of Tokyo, 7-3-1 Hongo, Bunkyo-ku, Tokyo 113-0033, Japan
Ziying Gu
Department of Astronomy, Graduate School of Science, The University of Tokyo, 7-3-1 Hongo, Bunkyo-ku, Tokyo 113-0033, Japan
Teruyuki Hirano ORCID
Astrobiology Center, 2-21-1 Osawa, Mitaka, Tokyo 181-8588, Japan, Astronomical Science Program, The Graduate University for Advanced Studies, SOKENDAI, 2-21-1 Osawa, Mitaka, Tokyo 181-8588, Japan, National Astronomical Observatory of Japan, 2-21-1 Osawa, Mitaka, Tokyo 181-8588, Japan
Takayuki Kotani ORCID
Astrobiology Center, 2-21-1 Osawa, Mitaka, Tokyo 181-8588, Japan, Astronomical Science Program, The Graduate University for Advanced Studies, SOKENDAI, 2-21-1 Osawa, Mitaka, Tokyo 181-8588, Japan, National Astronomical Observatory of Japan, 2-21-1 Osawa, Mitaka, Tokyo 181-8588, Japan
Masayuki Kuzuhara ORCID
Astrobiology Center, 2-21-1 Osawa, Mitaka, Tokyo 181-8588, Japan, National Astronomical Observatory of Japan, 2-21-1 Osawa, Mitaka, Tokyo 181-8588, Japan
Kento Masuda ORCID
Department of Earth and Space Science, Osaka University, Toyonaka, Osaka 560-0043, Japan
Editor
Arfon Smith ORCID
Tags
astronomy spectroscopy

GitHub Events

Total
  • Release event: 2
  • Delete event: 31
  • Member event: 1
  • Pull request event: 42
  • Issues event: 11
  • Issue comment event: 38
  • Push event: 62
  • Pull request review comment event: 4
  • Pull request review event: 7
  • Create event: 21
Last Year
  • Release event: 2
  • Delete event: 20
  • Member event: 1
  • Pull request event: 21
  • Issues event: 9
  • Issue comment event: 25
  • Push event: 27
  • Pull request review comment event: 4
  • Pull request review event: 7
  • Create event: 11

Committers

Last synced: about 1 month ago

All Time
  • Total Commits: 327
  • Total Committers: 5
  • Avg Commits per committer: 65.4
  • Development Distribution Score (DDS): 0.468
Past Year
  • Commits: 35
  • Committers: 2
  • Avg Commits per committer: 17.5
  • Development Distribution Score (DDS): 0.057
Top Committers
Name Email Commits
Hajime Kawahara d****t@g****m 174
Yui Kasagi y****i@g****p 94
Yui Kasagi k****6@g****m 51
ZiyingGu 1****u 5
Kento Masuda k****a@d****p 3
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: about 1 month ago

All Time
  • Total issues: 10
  • Total pull requests: 34
  • Average time to close issues: over 1 year
  • Average time to close pull requests: 8 days
  • Total issue authors: 2
  • Total pull request authors: 2
  • Average comments per issue: 2.4
  • Average comments per pull request: 1.15
  • Merged pull requests: 28
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 4
  • Pull requests: 12
  • Average time to close issues: 18 days
  • Average time to close pull requests: 1 day
  • Issue authors: 1
  • Pull request authors: 2
  • Average comments per issue: 0.75
  • Average comments per pull request: 0.92
  • Merged pull requests: 11
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • HajimeKawahara (8)
  • YuiKasagi (2)
Pull Request Authors
  • YuiKasagi (30)
  • HajimeKawahara (4)
Top Labels
Issue Labels
enhancement (3) bug (2) refactoring (1) good first issue (1)
Pull Request Labels
bug (7) enhancement (5) refactoring (5)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 42 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 6
  • Total maintainers: 2
pypi.org: pyird

Python pipeline for infrared detectors, and/or IRD/REACH

  • Versions: 6
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 42 Last month
Rankings
Dependent packages count: 6.6%
Average: 20.1%
Downloads: 23.0%
Dependent repos count: 30.6%
Maintainers (2)
Last synced: about 2 months ago

Dependencies

.github/workflows/main.yml actions
  • EnricoMi/publish-unit-test-result-action v1 composite
  • actions/checkout v2 composite
  • actions/download-artifact v2 composite
  • actions/setup-python v2 composite
  • actions/upload-artifact v2 composite
setup.py pypi
.github/workflows/draft-pdf.yml actions
  • actions/checkout v4 composite
  • actions/upload-artifact v4 composite
  • openjournals/openjournals-draft-action master composite
pyproject.toml pypi