pyegcdb 0.1.0a1__tar.gz

pyegcdb-0.1.0a1/LICENSE

@@ -0,0 +1,14 @@
+Copyright (C) 2026 Dóra Tarczay-Nehéz
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.

pyegcdb-0.1.0a1/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: pyegcdb
+Version: 0.1.0a1
+Summary: Python client for the Extragalactic Cepheid Database of the Konkoly Observatory
+Author-email: Dóra Tarczay-Nehéz <tarczaynehez.dora@csfk.org>
+License: GNU GPLv3
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: astropy>=5.0.0
+Dynamic: license-file
+
+# pyegcdb
+
+`pyegcdb` is the official Python client for the **Konkoly Cepheid Database**. It provides astronomers and researchers with a seamless interface to query light curves and stellar catalog data directly within a Python environment.
+
+## Installation
+
+You can install the package directly from PyPI:
+
+```bash
+pip install pyegcdb
+```
+
+
+## Quick Start
+
+To begin using the library, initialize the client and fetch data by the star's name:
+
+```python
+from pyegcdb import KonkolyCepheids
+
+# 1. Initialize the client
+db = KonkolyCepheids()
+
+# 2. Fetch light curve data for a specific star
+star_name = "OGLE LMC-SC1 14252"
+lc_df = db.load_datapoints(identifier=star_name, bands=['B'])
+
+# 3. Preview the results
+if not lc_df.empty:
+    print(lc_df.head())
+```
+
+
+
+
+
+## Key Features
+
+* **Light Curve Retrieval:** Easily download raw photometric time-series data for specific Cepheids.
+* **Catalog Querying:** Perform advanced searches based on galaxy, variable type, or perform a Cone Search (RA/Dec).
+* **Smart Filtering:** Built-in deduplication logic that prioritizes the most recent publication data.
+
+
+## Citation
+If you use `pyegcdb` in your research, please cite our relevant work:
+
+```bibtex
+@INPROCEEDINGS{2020svos.conf..115T,
+       author = {{Tarczay-Neh{\'e}z}, D. and {Szabados}, L. and {Dencs}, Z.},
+        title = "{Cepheids Near and Far}",
+     keywords = {Stars: variables: Cepheids, Astronomical databases: miscellaneous, Galaxies: statistics, Stars: statistics, Galaxy: stellar content, (Cosmology:) distance scale},
+    booktitle = {Stars and their Variability Observed from Space},
+         year = 2020,
+       editor = {{Neiner}, C. and {Weiss}, W.~W. and {Baade}, D. and {Griffin}, R.~E. and {Lovekin}, C.~C. and {Moffat}, A.~F.~J.},
+        month = jan,
+        pages = {115-118},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2020svos.conf..115T},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+
+
+@INPROCEEDINGS{2022eas..conf..420T,
+       author = {{Tarczay-Neh{\'e}z}, D{\'o}ra and {Dencs}, Zolt{\'a}n and {Szabados}, L{\'a}szl{\'o} and {Moln{\'a}r}, L{\'a}szl{\'o}},
+        title = "{Extragalactic Cepheid Database}",
+    booktitle = {EAS2022, European Astronomical Society Annual Meeting},
+         year = 2022,
+        month = jul,
+          eid = {420},
+        pages = {420},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2022eas..conf..420T},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+
+
+```
+
+
+## License
+This software is released under the [GNU GPLv3] license.

pyegcdb-0.1.0a1/README.md

@@ -0,0 +1,81 @@
+# pyegcdb
+
+`pyegcdb` is the official Python client for the **Konkoly Cepheid Database**. It provides astronomers and researchers with a seamless interface to query light curves and stellar catalog data directly within a Python environment.
+
+## Installation
+
+You can install the package directly from PyPI:
+
+```bash
+pip install pyegcdb
+```
+
+
+## Quick Start
+
+To begin using the library, initialize the client and fetch data by the star's name:
+
+```python
+from pyegcdb import KonkolyCepheids
+
+# 1. Initialize the client
+db = KonkolyCepheids()
+
+# 2. Fetch light curve data for a specific star
+star_name = "OGLE LMC-SC1 14252"
+lc_df = db.load_datapoints(identifier=star_name, bands=['B'])
+
+# 3. Preview the results
+if not lc_df.empty:
+    print(lc_df.head())
+```
+
+
+
+
+
+## Key Features
+
+* **Light Curve Retrieval:** Easily download raw photometric time-series data for specific Cepheids.
+* **Catalog Querying:** Perform advanced searches based on galaxy, variable type, or perform a Cone Search (RA/Dec).
+* **Smart Filtering:** Built-in deduplication logic that prioritizes the most recent publication data.
+
+
+## Citation
+If you use `pyegcdb` in your research, please cite our relevant work:
+
+```bibtex
+@INPROCEEDINGS{2020svos.conf..115T,
+       author = {{Tarczay-Neh{\'e}z}, D. and {Szabados}, L. and {Dencs}, Z.},
+        title = "{Cepheids Near and Far}",
+     keywords = {Stars: variables: Cepheids, Astronomical databases: miscellaneous, Galaxies: statistics, Stars: statistics, Galaxy: stellar content, (Cosmology:) distance scale},
+    booktitle = {Stars and their Variability Observed from Space},
+         year = 2020,
+       editor = {{Neiner}, C. and {Weiss}, W.~W. and {Baade}, D. and {Griffin}, R.~E. and {Lovekin}, C.~C. and {Moffat}, A.~F.~J.},
+        month = jan,
+        pages = {115-118},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2020svos.conf..115T},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+
+
+@INPROCEEDINGS{2022eas..conf..420T,
+       author = {{Tarczay-Neh{\'e}z}, D{\'o}ra and {Dencs}, Zolt{\'a}n and {Szabados}, L{\'a}szl{\'o} and {Moln{\'a}r}, L{\'a}szl{\'o}},
+        title = "{Extragalactic Cepheid Database}",
+    booktitle = {EAS2022, European Astronomical Society Annual Meeting},
+         year = 2022,
+        month = jul,
+          eid = {420},
+        pages = {420},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2022eas..conf..420T},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+
+
+```
+
+
+## License
+This software is released under the [GNU GPLv3] license.

pyegcdb-0.1.0a1/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyegcdb"
+version = "0.1.0a1"
+description = "Python client for the Extragalactic Cepheid Database of the Konkoly Observatory"
+readme = "README.md"
+authors = [
+    { name = "Dóra Tarczay-Nehéz", email = "tarczaynehez.dora@csfk.org" }
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Science/Research",
+    "Topic :: Scientific/Engineering :: Astronomy"
+]
+requires-python = ">=3.8"
+dependencies = [
+    "requests>=2.28.0",
+    "pandas>=1.5.0",
+    "astropy>=5.0.0"  # For astronomical things
+]
+
+license = {text = "GNU GPLv3"}
+
+[tool.setuptools.packages.find]
+where = ["src"] 

pyegcdb-0.1.0a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pyegcdb-0.1.0a1/src/pyegcdb/__init__.py

@@ -0,0 +1 @@
+from .core import KonkolyCepheids

pyegcdb-0.1.0a1/src/pyegcdb/core.py

@@ -0,0 +1,212 @@
+import requests
+import pandas as pd
+import urllib.parse
+
+class KonkolyCepheids:
+    def __init__(self, base_url="https://cepheids.konkoly.hu/api/v1"):
+        self.base_url = base_url
+        self._band_map = {
+            1: 'magU', 2: 'magB', 3: 'magV', 4: 'magR', 5: 'magI', 6: 'magJ', 7: 'magH', 8: 'magK',
+            9: 'magu', 10: 'magg', 11: 'magr', 12: 'magi', 13: 'magz', 14: 'magG',
+            46: 'magW1', 47: 'magW2', 48: 'magW3', 49: 'magW4'
+        }
+
+    def ping(self) -> bool:
+        url = f"{self.base_url}/ping"
+        try:
+            response = requests.get(url, timeout=5)
+            return response.status_code == 200
+        except requests.exceptions.RequestException:
+            return False
+
+    def query(self, 
+              galaxy: str = None, 
+              var_type: int = None, 
+              ra: str or float = None,
+              dec: str or float = None,
+              radius: float or int = 5,
+              bands: str or list = 'all', 
+              include_period: bool = True) -> pd.DataFrame:
+        """
+        Queries the database with support for galaxy, type, and Cone Search (RA/Dec).
+        Filters out database-level duplicates by keeping the newest publication data.
+        """
+        url = f"{self.base_url}/cepheids"
+        
+        params = {
+            'include_period': str(include_period).lower()
+        }
+        if galaxy:
+            params['galaxy'] = galaxy
+        if var_type:
+            params['type'] = var_type
+            
+        if ra is not None and dec is not None:
+            params['ra'] = str(ra)
+            params['dec'] = str(dec)
+            params['radius'] = float(radius)
+
+        if isinstance(bands, list):
+            params['bands'] = ",".join(bands)
+        else:
+            params['bands'] = bands
+
+        try:
+            response = requests.get(url, params=params, timeout=15)
+            if response.status_code != 200:
+                print(f"❌ Server error: {response.status_code}")
+                return pd.DataFrame()
+
+            json_data = response.json()
+            if json_data.get('status') != 'success' or json_data.get('count', 0) == 0:
+                print("⚠ No records found matching the criteria.")
+                return pd.DataFrame()
+
+            raw_data = json_data['data']
+            flattened_records = []
+
+            for item in raw_data:
+                # Kinyerjük a pozíciókat, hogy meghatározzuk a legfrissebbet (legnagyobb art_id)
+                positions = item.get('positions', [])
+                base2 = [p for p in positions if p.get('base') == 2]
+                
+                latest_pos = None
+                latest_art_id = -1
+                
+                if base2:
+                    # Megkeressük a legfrissebb pozíció rekordot az art_id alapján
+                    latest_pos = sorted(base2, key=lambda x: x.get('art_id', 0) or 0, reverse=True)[0]
+                    latest_art_id = latest_pos.get('art_id', 0) or 0
+
+                record = {
+                    'id': item.get('id'),
+                    'name': item.get('name'),
+                    'galaxy': item.get('galaxy', {}).get('gen_short_name', 'Unknown'),
+                    'type': item.get('types', [{}])[0].get('type') if item.get('types') else None,
+                    'latest_art_id': latest_art_id  # Ezt használjuk majd a drop_duplicates-nél
+                }
+
+                if 'distance_arcsec' in item:
+                    record['distance_arcsec'] = float(item['distance_arcsec'])
+
+                if include_period:
+                    periods = item.get('periods', [])
+                    record['period'] = float(periods[0].get('value')) if periods and periods[0].get('value') else None
+
+                if latest_pos:
+                    record['ra'] = latest_pos.get('ra')
+                    record['dec'] = latest_pos.get('dec')
+                else:
+                    record['ra'] = record['dec'] = None
+
+                if isinstance(bands, list):
+                    for b in bands:
+                        record[f'mag{b}'] = None
+                else:
+                    for b_name in self._band_map.values():
+                        record[b_name] = None
+
+                for mag_obj in item.get('magnitudes', []):
+                    b_id = mag_obj.get('band_type_id')
+                    b_col_name = self._band_map.get(b_id)
+                    if b_col_name:
+                        record[b_col_name] = float(mag_obj.get('value')) if mag_obj.get('value') else None
+
+                flattened_records.append(record)
+
+            df = pd.DataFrame(flattened_records)
+            
+            # --- DUPLIKÁCIÓK TISZTÍTÁSA CIKK-FRISSESSÉG ALAPJÁN ---
+            if not df.empty:
+                # Először a legfrissebb cikkek szerint csökkenőbe rendezünk
+                df = df.sort_values('latest_art_id', ascending=False)
+                
+                # Csillag ID alapján eldobjuk a duplikátumokat, így a legfrissebb (első) marad meg
+                df = df.drop_duplicates(subset=['id'], keep='first')
+                
+                # Ha volt Cone Search, akkor esztétikailag visszaállíthatjuk a távolság szerinti sorrendet
+                if 'distance_arcsec' in df.columns:
+                    df = df.sort_values('distance_arcsec')
+                    
+                # Takarítás: a segéd oszlopot elrejtjük a kutató elől
+                df = df.drop(columns=['latest_art_id']).reset_index(drop=True)
+
+            print(f"✓ Successfully fetched and cleaned {len(df)} unique records (based on latest publication).")
+            return df
+
+        except requests.exceptions.RequestException as e:
+            print(f"❌ Network error: {e}")
+            return pd.DataFrame()
+
+    def load_datapoints(self, identifier: int or str, bands: str or list = 'all') -> pd.DataFrame:
+        """
+        Fetches the raw photometric time-series (light curve) for a specific Cepheid.
+        """
+        safe_identifier = urllib.parse.quote(str(identifier))
+        url = f"{self.base_url}/cepheids/{safe_identifier}/lightcurve"
+
+        params = {}
+        if isinstance(bands, list):
+            params['bands'] = ",".join(bands)
+        else:
+            params['bands'] = bands
+
+        local_band_map = {
+            1: 'U', 2: 'B', 3: 'V', 4: 'R', 5: 'I', 6: 'J', 7: 'H', 8: 'K',
+            9: 'u', 10: 'g', 11: 'r', 12: 'i', 13: 'z', 14: 'G',
+            46: 'W1', 47: 'W2', 48: 'W3', 49: 'W4'
+        }
+
+        try:
+            response = requests.get(url, params=params, timeout=15)
+            
+            #DEBUG: Ha 500-as hiba van, írjuk ki, mit mondott a szerver
+            if response.status_code == 500:
+                print(f"❌ Server error 500! Szerver válasza: {response.text[:500]}")
+                return pd.DataFrame()
+            elif response.status_code != 200:
+                print(f"❌ Server error: {response.status_code}")
+                return pd.DataFrame()
+
+            json_data = response.json()
+            if json_data.get('status') != 'success':
+                print(f"❌ Database error: {json_data.get('message', 'Unknown error')}")
+                return pd.DataFrame()
+
+            server_ceph_id = json_data.get('ceph_id')
+            server_star_name = json_data.get('name')
+            print(f"🎯 Star resolved: Found '{server_star_name}' (Internal EGCDb ID: {server_ceph_id})")
+            
+            raw_points = json_data['data']
+            total_points = json_data.get('count', 0)
+            
+            if total_points == 0:
+                print(f"⚠ Warning: No points found matching the criteria.")
+                return pd.DataFrame()
+
+            print(f"📥 Downloading and parsing {total_points} photometric datapoints...")
+
+            flattened_points = []
+            for pt in raw_points:
+                b_id = pt.get('ceph_mag_conn_id')
+                b_name = local_band_map.get(b_id, f"ID_{b_id}")
+
+                jd_val = pt.get('time_jd') if pt.get('time_jd') is not None else pt.get('HJD_epoch')
+
+                flattened_points.append({
+                    'jd': float(jd_val) if jd_val is not None else None,
+                    'magnitude': float(pt['data']) if pt.get('data') is not None else None,
+                    'error': float(pt['mag_err']) if pt.get('mag_err') is not None else None,
+                    'band': b_name
+                })
+
+            df = pd.DataFrame(flattened_points)
+            if not df.empty and 'jd' in df.columns:
+                df = df.sort_values('jd').reset_index(drop=True)
+                
+            print(f"✓ Light curve loaded successfully into DataFrame.")
+            return df
+
+        except requests.exceptions.RequestException as e:
+            print(f"❌ Network error while fetching light curve: {e}")
+            return pd.DataFrame()

pyegcdb-0.1.0a1/src/pyegcdb.egg-info/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: pyegcdb
+Version: 0.1.0a1
+Summary: Python client for the Extragalactic Cepheid Database of the Konkoly Observatory
+Author-email: Dóra Tarczay-Nehéz <tarczaynehez.dora@csfk.org>
+License: GNU GPLv3
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: astropy>=5.0.0
+Dynamic: license-file
+
+# pyegcdb
+
+`pyegcdb` is the official Python client for the **Konkoly Cepheid Database**. It provides astronomers and researchers with a seamless interface to query light curves and stellar catalog data directly within a Python environment.
+
+## Installation
+
+You can install the package directly from PyPI:
+
+```bash
+pip install pyegcdb
+```
+
+
+## Quick Start
+
+To begin using the library, initialize the client and fetch data by the star's name:
+
+```python
+from pyegcdb import KonkolyCepheids
+
+# 1. Initialize the client
+db = KonkolyCepheids()
+
+# 2. Fetch light curve data for a specific star
+star_name = "OGLE LMC-SC1 14252"
+lc_df = db.load_datapoints(identifier=star_name, bands=['B'])
+
+# 3. Preview the results
+if not lc_df.empty:
+    print(lc_df.head())
+```
+
+
+
+
+
+## Key Features
+
+* **Light Curve Retrieval:** Easily download raw photometric time-series data for specific Cepheids.
+* **Catalog Querying:** Perform advanced searches based on galaxy, variable type, or perform a Cone Search (RA/Dec).
+* **Smart Filtering:** Built-in deduplication logic that prioritizes the most recent publication data.
+
+
+## Citation
+If you use `pyegcdb` in your research, please cite our relevant work:
+
+```bibtex
+@INPROCEEDINGS{2020svos.conf..115T,
+       author = {{Tarczay-Neh{\'e}z}, D. and {Szabados}, L. and {Dencs}, Z.},
+        title = "{Cepheids Near and Far}",
+     keywords = {Stars: variables: Cepheids, Astronomical databases: miscellaneous, Galaxies: statistics, Stars: statistics, Galaxy: stellar content, (Cosmology:) distance scale},
+    booktitle = {Stars and their Variability Observed from Space},
+         year = 2020,
+       editor = {{Neiner}, C. and {Weiss}, W.~W. and {Baade}, D. and {Griffin}, R.~E. and {Lovekin}, C.~C. and {Moffat}, A.~F.~J.},
+        month = jan,
+        pages = {115-118},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2020svos.conf..115T},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+
+
+@INPROCEEDINGS{2022eas..conf..420T,
+       author = {{Tarczay-Neh{\'e}z}, D{\'o}ra and {Dencs}, Zolt{\'a}n and {Szabados}, L{\'a}szl{\'o} and {Moln{\'a}r}, L{\'a}szl{\'o}},
+        title = "{Extragalactic Cepheid Database}",
+    booktitle = {EAS2022, European Astronomical Society Annual Meeting},
+         year = 2022,
+        month = jul,
+          eid = {420},
+        pages = {420},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2022eas..conf..420T},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+
+
+```
+
+
+## License
+This software is released under the [GNU GPLv3] license.

pyegcdb-0.1.0a1/src/pyegcdb.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/pyegcdb/__init__.py
+src/pyegcdb/core.py
+src/pyegcdb.egg-info/PKG-INFO
+src/pyegcdb.egg-info/SOURCES.txt
+src/pyegcdb.egg-info/dependency_links.txt
+src/pyegcdb.egg-info/requires.txt
+src/pyegcdb.egg-info/top_level.txt

pyegcdb-0.1.0a1/src/pyegcdb.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pyegcdb-0.1.0a1/src/pyegcdb.egg-info/requires.txt

@@ -0,0 +1,3 @@
+requests>=2.28.0
+pandas>=1.5.0
+astropy>=5.0.0

pyegcdb-0.1.0a1/src/pyegcdb.egg-info/top_level.txt

@@ -0,0 +1 @@
+pyegcdb