Skip to content

feder-observatory/stellarphot

Repository files navigation

A Python Package for Transforming Stellar Photometry

Powered by Astropy Badge GitHub Workflow badge pre-commit.ci status codecov DOI

Stellarphot provides a Python package and accompanying Jupyter notebooks to allow you to turn reduced astronomical images of point sources (e.g. stars) into calibrated astronomical photometry, with a focus on variable star and exoplanet transit observations. Specifically:

  • If you have reduced astronomical images as FITS files but haven't obtained photometry yet, stellarphot can perform aperture photometry on your images.
  • If you already have aperture photometry for a field, stellarphot can
    • calculate relative flux (like AstroImageJ), and/or
    • calculate calibrated magnitudes by transforming to a catalog (e.g. APASS DR9)
  • If you are working with exoplanet transit observations, stellarphot can turns the photometry into exoplanet transit light curves (see installation notes below).

Installation

You can install stellarphot with either pip or conda. If you are interested in stellarphot for exoplanet transit light curves, conda is recommended at the moment because of an issue with installing one of the dependencies.

  • Install with conda using

    conda install -c conda-forge stellarphot reducer
    pip install astronbs
    

    If you are interested in exoplanet light curve fitting, also install batman using

    conda install -c conda-forge batman-package
    
  • Install with pip using

    pip install stellarphot reducer astronbs
    

    or if you are interested in exoplanet light curve fitting you should instead use:

    pip install stellarphot[exo_fitting] reducer astronbs
    

Getting started with stellarphot

  1. Start Jupyterlab from the command line: jupyter lab
  2. Once JupyterLab opens in your web browser, open the Launcher (see Figure below)
  3. Click on the notebook you want (see Figure below) and follow the instructions in the notebook. Any output files will show up in the file browser

stellarphot-screenshot

Questions?

Feel free to contact @mwcraig with your questions about using stellarphot.

Contributors

Matt Craig
Matt Craig

🐛 💻 🎨 🤔 🚧 🧑‍🏫 🔬 👀 ⚠️
Juan Cabanela
Juan Cabanela

🐛 💻 🎨 🤔 🚧 👀 📖
madelyn914
madelyn914

🤔 📓
Abby
Abby

📓
MDeRung2021
MDeRung2021

🐛 📓
Tanner Weyer
Tanner Weyer

💻 👀 📓
Emily Watson
Emily Watson

🐛 📓
Adam Kline
Adam Kline

💻 📓
Elias Holte
Elias Holte

💻
P. L. Lim
P. L. Lim

🚧
clkotnik
clkotnik

🤔
Paige Meyer
Paige Meyer

📖
stottsco
stottsco

💻
Add your contributions

License

This project is Copyright (c) 2019-2024 The Stellarphot Team and licensed under the terms of the BSD 3-Clause license. This package is based upon the Astropy package template which is licensed under the BSD 3-clause license.