ogle 🔭
ogle is a Python package designed to simplify the management, retrieval, and interaction with Optical Gravitational Lensing Experiment (OGLE) data. It provides a streamlined interface for astronomers and researchers to handle light-curve data and lensing events.
Features
- Data Retrieval: Automated utilities to fetch data from OGLE databases.
- Format Conversion: Seamlessly convert OGLE-specific data into
astropytables orpandasDataFrames. - Analysis Tools: Functions for processing gravitational lensing light-curves.
- Modern Workflow: Full support for
uv,pip, and type-hinting for high-performance research.
Roadmap & Feature Status
Legend:
- ✅ Completed: Stable and available in the current version.
- 🏗️ In Progress: Actively being developed in the
mainordevbranch.- 📅 Planned: On the radar for future releases.
OGLE I
| Feature | Status | Priority |
|---|---|---|
| Multiple Features | 📅 Planned | Low |
OGLE II
| Feature | Status | Priority |
|---|---|---|
| Basic Data Fetching (ASCII/Text) | ✅ Completed | High |
| Astropy/Pandas Integration | 🏗️ In Progress | High |
| Interactive Light-Curve Plotting | 🏗️ In Progress | Medium |
| Automated Event Classification | 📅 Planned | Medium |
| Cross-matching with Gaia DR3 | 📅 Planned | Low |
| API Support for OGLE-IV Early Warning | 📅 Planned | High |
OGLE III
| Feature | Status | Priority |
|---|---|---|
| Multiple Features | 📅 Planned | Low |
OGLE IV
| Feature | Status | Priority |
|---|---|---|
| Multiple Features | 📅 Planned | Low |
Installation
Install the stable version from PyPI:
pip install ogle
Or, if you prefer using uv:
uv add ogle
Documentation and Usage
All the docs can be found at docs.jjsm.science/ogle
Development
This project is built using the latest Python standards. If you are using this as a template or contributing:
- Clone the repo:
git clone https://github.com/jj-sm/ogle.git cd ogle
- Sync the environment (using uv):
uv sync - Run the test suite:
uv run pytest
License
This project is licensed under the GNU General Public License v3 (GPLv3). This ensures the software remains free and open for the scientific community. See the LICENSE file for details.
Contributing
Contributions make the scientific community stronger!
- Check out the Contributing Guidelines.
- Adhere to the Code of Conduct.
- Open a Feature Request for new ideas.
Citation
If you use ogle in your research or publications, please cite it using the metadata provided in the CITATION.cff file, or click the "Cite this repository" button in the GitHub sidebar.
Maintained by Juan José Sánchez Medina, BSc. Astronomy Student (Pontificia Universidad Católica de Chile)
1 maintainer
Release files for ogle 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ogle-0.1.0.tar.gz | 35.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ogle-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 73.8 kB
Release files / ogle-0.1.0.tar.gz
| Download URL | ogle-0.1.0.tar.gz |
|---|---|
| Size | 35.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d6819c793a4268ac06de290bdafef6a30c3436d8676a02dd6a8cd06b2ee11345
|
|
BLAKE2b-256 checksum How to use checksums |
03bb201bbd3906f7ea1f2ce4caa4d52c9b2191950787e09f7e7061b014e7179c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 6, 2026.
Transparency logRelease files / ogle-0.1.0-py3-none-any.whl
| Download URL | ogle-0.1.0-py3-none-any.whl |
|---|---|
| Size | 38.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
25557d8f713d9215459632c19791de5db50c5593ac480d8971ece2632e28c445
|
|
BLAKE2b-256 checksum How to use checksums |
87f6ffc06759d2141d5dc9917984eb27485650ee1dcf869c2ccdafacc80305a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 6, 2026.
Transparency log
