isgri 0.7.0__tar.gz → 0.7.2__tar.gz

{isgri-0.7.0 → isgri-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: isgri
-Version: 0.7.0
+Version: 0.7.2
 Summary: Python package for INTEGRAL IBIS/ISGRI lightcurve analysis
 Author: Dominik Patryk Pacholski
 License: MIT
@@ -26,6 +26,7 @@ Query catalogs directly from the terminal:
 - Interactive and direct query modes
 - Filter by time, position, quality, revolution
 - Export results to FITS/CSV or SWID lists
+- Update catalogs with new science windows from archive
 
 ### SCW Catalog Query
 Query INTEGRAL Science Window catalogs with a fluent Python API:
@@ -33,6 +34,13 @@ Query INTEGRAL Science Window catalogs with a fluent Python API:
 - Calculate detector offsets
 - Export results to any auto detectable astropy table extension or in table aligned data for any other extension
 
+### Catalog Builder
+Build and update INTEGRAL/ISGRI science window catalogs:
+- Automatic discovery of new science windows in archive
+- Parallel processing of quality metrics
+- Optional light curve caching
+- Incremental catalog updates
+
 ### Light Curve Analysis
 Extract and analyze ISGRI light curves:
 - Load from file paths or SWID/source lookup
@@ -60,6 +68,9 @@ isgri config-set --archive /path/to/archive --catalog ~/data/scw_catalog.fits --
 # View current config
 isgri config
 
+# Update catalog from archive
+isgri update
+
 # Interactive catalog query
 isgri query
 # query> time
@@ -109,6 +120,51 @@ swids = cat.get_swids()
 print(f"Found {len(results)} observations")
 ```
 
+### Build/Update SCW Catalog
+
+#### Command Line
+
+```bash
+# Update catalog using configured paths
+isgri update
+
+# Update with custom paths
+isgri update --archive /anita/archivio/ --catalog ~/data/catalog.fits 
+
+# Enable light curve caching (15-1000 keV, 1s bins)
+isgri update --cache ~/data/lightcurves/
+
+# Limit CPU cores for parallel processing
+isgri update --cores 4
+```
+
+#### Python API
+
+```python
+from isgri.catalog import CatalogBuilder
+
+# Create builder instance
+builder = CatalogBuilder(
+    archive_path="/path/to/archive",
+    catalog_path="scw_catalog.fits",
+    lightcurve_cache="/path/to/cache",  # optional
+    n_cores=8
+)
+
+# Update catalog with new science windows
+builder.update_catalog()
+
+# Find all science windows in archive
+swids, paths = builder.find_scws()
+print(f"Found {len(swids)} science windows")
+```
+
+The builder:
+- Scans archive for new ScWs not in catalog
+- Computes quality metrics (raw, sigma-clipped, GTI-filtered chi-squared)
+- Processes in parallel by revolution
+- Optionally caches 1s light curves (15-1000 keV)
+
 ### Analyze Light Curves
 
 ```python

{isgri-0.7.0 → isgri-0.7.2}/README.md

@@ -9,6 +9,7 @@ Query catalogs directly from the terminal:
 - Interactive and direct query modes
 - Filter by time, position, quality, revolution
 - Export results to FITS/CSV or SWID lists
+- Update catalogs with new science windows from archive
 
 ### SCW Catalog Query
 Query INTEGRAL Science Window catalogs with a fluent Python API:
@@ -16,6 +17,13 @@ Query INTEGRAL Science Window catalogs with a fluent Python API:
 - Calculate detector offsets
 - Export results to any auto detectable astropy table extension or in table aligned data for any other extension
 
+### Catalog Builder
+Build and update INTEGRAL/ISGRI science window catalogs:
+- Automatic discovery of new science windows in archive
+- Parallel processing of quality metrics
+- Optional light curve caching
+- Incremental catalog updates
+
 ### Light Curve Analysis
 Extract and analyze ISGRI light curves:
 - Load from file paths or SWID/source lookup
@@ -43,6 +51,9 @@ isgri config-set --archive /path/to/archive --catalog ~/data/scw_catalog.fits --
 # View current config
 isgri config
 
+# Update catalog from archive
+isgri update
+
 # Interactive catalog query
 isgri query
 # query> time
@@ -92,6 +103,51 @@ swids = cat.get_swids()
 print(f"Found {len(results)} observations")
 ```
 
+### Build/Update SCW Catalog
+
+#### Command Line
+
+```bash
+# Update catalog using configured paths
+isgri update
+
+# Update with custom paths
+isgri update --archive /anita/archivio/ --catalog ~/data/catalog.fits 
+
+# Enable light curve caching (15-1000 keV, 1s bins)
+isgri update --cache ~/data/lightcurves/
+
+# Limit CPU cores for parallel processing
+isgri update --cores 4
+```
+
+#### Python API
+
+```python
+from isgri.catalog import CatalogBuilder
+
+# Create builder instance
+builder = CatalogBuilder(
+    archive_path="/path/to/archive",
+    catalog_path="scw_catalog.fits",
+    lightcurve_cache="/path/to/cache",  # optional
+    n_cores=8
+)
+
+# Update catalog with new science windows
+builder.update_catalog()
+
+# Find all science windows in archive
+swids, paths = builder.find_scws()
+print(f"Found {len(swids)} science windows")
+```
+
+The builder:
+- Scans archive for new ScWs not in catalog
+- Computes quality metrics (raw, sigma-clipped, GTI-filtered chi-squared)
+- Processes in parallel by revolution
+- Optionally caches 1s light curves (15-1000 keV)
+
 ### Analyze Light Curves
 
 ```python