Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Python 3.12 Documentation Status PyPI version GitHub release GitHub Codacy Badge astropy

EclipsingBinaries

EclipsingBinaries is a Python project for faster analysis of eclipsing binary star systems. The package can currently reduce data, find comparison stars from the APASS catalog, calculate and plot O-C values, find the color index and effective temperature, O’Connell effect parameters, download TESS data, download archive data from X-ray to radio (light curves, catalogue magnitudes and spectra from two dozen databases), and perform interactive multi-aperture photometry with auto-suggested, optimized radii.


Documentation

You can find the documentation at this site and any questions can be talked about in the discussions page or in an issue.


OS and Python Versions Stable On

The list of OS’s and Python versions listed below have been tested to be able to build the package on.

  • Macos- 3.12
  • Ubuntu- 3.12
  • Windows- 3.12

The minimum working Python version is 3.12 and as of right now no versions lower work with all aspects of this package.

The GUI uses tkinter, which some Python installs leave out:

  • macOS with Homebrew Python: brew install python-tk@3.12 (match your Python version). The python.org installer already includes it.
  • Windows: the python.org installer includes it as long as "tcl/tk and IDLE" stays checked.
  • Ubuntu/Debian: install the system package before starting the app:
sudo apt install python3-tk

Drag and drop works with both Tk 8.6 and Tk 9. If it can't load (for example an Intel Mac running Tk 9), the app still starts and the Browse buttons work as usual.


Installation and Usage

To install type the following,

pip install EclipsingBinaries

Once installed, in the command line type the following:

EclipsingBinaries

This opens the GUI, which has every program in one window. Programs run in the background with a Cancel button and a status bar, each program remembers the folders and files you used last, and finished runs offer buttons to open the output folder or view the results. File and folder fields accept drag and drop. See Running EclipsingBinaries for details.

To check the version you have,

pip show EclipsingBinaries

this will show numerous things, but you want to look at the version and make sure it is up to date.

If your version is not the most recent version then in order to update type the following,

pip install --upgrade EclipsingBinaries

Pipeline

To use the pipeline functionality type the following:

EB_pipeline -h

This prints every available option. A typical run looks like:

EB_pipeline raw_images/ reduced_images/ --ra 00:28:27.96 --dec 78:57:42.65 --name NSVS_254037 --loc BSUO

The input and output folders and --ra, --dec and --name are required. See the pipeline docs for the rest.


Dependencies

  • python >=3.12
  • astropy>=6.0
  • astroquery>=0.4.6
  • ccdproc>=2.4.0
  • matplotlib>=3.8.0
  • numpy>=1.26
  • pandas>=2.1.1
  • PyAstronomy>=0.18.1
  • scipy>=1.11.2
  • statsmodels>=0.14
  • tqdm>=4.64.1
  • pyia>=1.4
  • photutils>=1.8.0
  • tkinterdnd2>=0.6.1
  • tkinter for the GUI (see the notes above)

pip installs everything except tkinter. pyproject.toml has the authoritative list.


Development

git clone https://github.com/kjkoeller/EclipsingBinaries.git
cd EclipsingBinaries
pip install -e ".[test,docs]"
pytest

The tests run without an internet connection. See the contributing guide for more.


License

EclipsingBinaries is released under the Creative Commons Attribution-NonCommercial 4.0 International license. See LICENSE for the full text.

Metadata

Release files for EclipsingBinaries 5.0.0a24

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for EclipsingBinaries 5.0.0a24
File Size Uploaded Provenance Actions
eclipsingbinaries-5.0.0a24.tar.gz 1.2 MB Without provenance Details for eclipsingbinaries-5.0.0a24.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for EclipsingBinaries 5.0.0a24
File Interpreter ABI Platform Actions
eclipsingbinaries-5.0.0a24-py3-none-any.whl Python 3 none any Details for eclipsingbinaries-5.0.0a24-py3-none-any.whl

Total release size: 2.1 MB

Release files / eclipsingbinaries-5.0.0a24.tar.gz

Download URL eclipsingbinaries-5.0.0a24.tar.gz
Size 1.2 MB
Tags Source
SHA-256 checksum
How to use checksums
5ac50ae09364688f8a1a184e5a182b093ccecf33bc44884547f521b3fedad357
BLAKE2b-256 checksum
How to use checksums
8573a20b50a9b930866182229bd6832b6671fc5c1ebde3f35ef47c4e1d224206
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / eclipsingbinaries-5.0.0a24-py3-none-any.whl

Download URL eclipsingbinaries-5.0.0a24-py3-none-any.whl
Size 985.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
61f025cc12f7ab2385b8fdc32835c4502c6ff6108c20099c8d86b9490a5a6039
BLAKE2b-256 checksum
How to use checksums
3b964dbd1f656ff912ab2831a6125d157a1de21fcdadf906ea10c186137a208d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for EclipsingBinaries 5.0.0a24

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page