AstroKit

🌟 Current Version (BETA): 0.1.0

⚠️ AstroKit is currently under development.
Please use it with caution. Feedback and suggestions are very welcome — feel free to contact me at zhurui675@gmail.com. The first stable release (version 1.0.0) will be available soon (expected in late 2025).

🏁 Quick Start

AstroKit is a Python package for astronomical data analysis (hodgepodge 😁), developed by Rui Zhu. It provides:

1. Photometric data preprocessing — including photometric redshift estimation, extinction correction, and more.
2. Wrappers for classical astronomical software — such as GALFIT(M), STILTS, EAZY, and SExtractor.
3. A collection of useful functions developed for and inspired by my own research.
4. More features and documents are on the way!

✨ To install:

• step 1: pip install

pip install astrokit

• step 2: write your own config file
  create a new file named .astrokit_config.yaml in your home directory. Here is an example (also in the .astrokit_config_template.yaml file):

# software directory
PATH_SEX:  # SExtractor program file directory
  /opt/homebrew/Cellar/sextractor/2.28.0/share/sextractor
PATH_EAZY:  # EAZY program file directory
  /Users/rui/Applications/eazy-photoz

# Quick Directory
DIR_DOWNLOAD:  # Default save file path
  /Users/rui/Downloads
DIR_DATA:  # local data root directory. Astrokit will search datasets in this directory
  /Users/rui/Data

• step 3: Enjoy it!
  

import astrokit as ak

🔔 Tip: Because a lot of dependencies are required, it is recommended to use Miniconda to create a new environment and install AstroKit in it. All required packages are listed in the requirement.txt file.

# Create a new conda environment
conda create -n astro python=3.13
# Activate the environment
conda activate astro
# Install Required packages
pip install -r requirements.txt
# Install AstroKit
pip install astrokit

📖 Documentation

Read the full documentation at astrokit.readthedocs.io. The documentation is still under construction, and the API may change in the future.

📜 License

This project is licensed under the terms of the MIT license. See the LICENSE file for details.

📚 Citation

If you use AstroKit in your research, please consider citing it using the following BibTeX entry:

(ADS)

@INPROCEEDINGS{2025zndo..15321579Z,
       author = {{Zhu}, Rui},
        title = "{AstroKit: A Python Package for Astronomical Data Analysis}",
    booktitle = {Zenodo software},
         year = 2025,
       volume = {153},
        month = may,
    publisher = {Zenodo},
          eid = {15321579},
        pages = {15321579},
          doi = {10.5281/zenodo.15321579},
       adsurl = {https://ui.adsabs.harvard.edu/abs/2025zndo..15321579Z},
      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}

(Zenodo Software DOI)

@software{zhu_2025_15323376,
  author       = {Zhu, Rui},
  title        = {AstroKit: A Python Package for Astronomical Data
                   Analysis
                  },
  month        = may,
  year         = 2025,
  publisher    = {Zenodo},
  version      = {0.1.0},
  doi          = {10.5281/zenodo.15323376},
  url          = {https://doi.org/10.5281/zenodo.15323376},
}

🤝 Acknowledgements

This project makes use of code and Data from the following projects:

Data Cite

(astrokit.datasets.data)

• eazy_filters: Copied from the EAZY Code
• templates:
  1. lephare
  2. sdss

Code Cite

(astrokit.externals)

• HSC_pdr3/: Copied from hsc-gitlab
• sfdmap.py Copied from sfdmap2

(astrokit.ML)

• d2l.py: Modified from https://github.com/d2l-ai